Function createArtifact

packages/hosts/mcp/src/tool-server.ts:1903–1943

(input: {
      readonly code: string;
      readonly title?: string;
      readonly description?: string;
      readonly connections?: Readonly<Record<string, string>>;
      readonly artifactId?: string;
    })

     * what is stored, so a pure code tweak doesn't have to restate them.
     */
    const createArtifact = (input: {
      readonly code: string;
      readonly title?: string;
      readonly description?: string;
      readonly connections?: Readonly<Record<string, string>>;
      readonly artifactId?: string;
    }): Effect.Effect<McpToolResult, unknown> =>
      Effect.gen(function* () {
        // An update reads the existing row FIRST, both to carry its title and
        // description forward and to refuse a foreign id before any work. The
        // refusal is `artifact_unavailable` — the same answer `execute-action`
        // gives — so create-artifact cannot be used to probe which ids exist.
        const existing =
          input.artifactId === undefined ? null : yield* loadArtifact(input.artifactId);
        if (input.artifactId !== undefined && !existing) return actionArtifactUnavailableResult();

        const title = input.title ?? existing?.title;
        if (title === undefined) {
          return renderRejectedResult(
            "title is required when creating an artifact. Give it a short human-readable name.",
          );
        }
        // Only an update inherits; a create with no description stores none.
        const description = input.description ?? existing?.description ?? undefined;

        return yield* validateRenderAndSave({
          code: input.code,
          title,
          description,
          connections: input.connections,
          existing,
        });
      }).pipe(
        Effect.withSpan("mcp.host.tool.create_artifact", {
          attributes: {
            "mcp.tool.name": "create-artifact",
            "mcp.artifact.update": input.artifactId !== undefined,
            "mcp.execute.code_length": input.code.length,
          },
        }),
      );

    /**
     * `edit-artifact`: the update path for tweaks, patching the stored source