Function saveAndDeliverArtifact

packages/hosts/mcp/src/tool-server.ts:1599–1631

(input: {
      readonly code: string;
      readonly title: string;
      readonly description?: string;
      readonly existingId?: string;
      readonly bindings?: Readonly<Record<string, ArtifactBinding>>;
      /** Sanitized layout markup from the smoke render, when it produced any. */
      readonly preview?: string | null;
    })

        : Effect.void;

    const saveAndDeliverArtifact = (input: {
      readonly code: string;
      readonly title: string;
      readonly description?: string;
      readonly existingId?: string;
      readonly bindings?: Readonly<Record<string, ArtifactBinding>>;
      /** Sanitized layout markup from the smoke render, when it produced any. */
      readonly preview?: string | null;
    }): Effect.Effect<McpToolResult, unknown> =>
      Effect.gen(function* () {
        if (!artifacts) return artifactsUnavailableResult();
        const saved = yield* artifacts.save({
          ...(input.existingId === undefined ? {} : { id: input.existingId }),
          title: input.title,
          description: input.description ?? null,
          code: input.code,
          ...(input.bindings === undefined ? {} : { bindings: input.bindings }),
          preview: input.preview ?? null,
        });
        yield* notifyArtifactUsage(input.existingId === undefined ? "created" : "updated");
        // Resolve once and report the value actually used, so the span can
        // never disagree with what the client received.
        const delivered = deliverArtifact({
          code: saved.code,
          artifactId: saved.id,
          title: saved.title,
        });
        yield* Effect.annotateCurrentSpan({
          "mcp.artifact.id": saved.id,
          "mcp.artifact.apps_enabled": appsEnabled,
        });
        return delivered;
      });

    /**
     * Whether the client can render an app, resolved at render time.