Method execute

src/tools/artifacts/artifact-tools.ts:51–65

(args: z.infer<typeof CreateArgs>, ctx: ToolContext)

  description = 'Create a new versioned artifact (a self-contained web page, React component, SVG, or doc the user will keep and iterate on). Returns the artifact id. Prefer this over dumping a large standalone file into chat.';
  argsSchema = CreateArgs;
  isReadOnly = false;
  isDestructive = false;

  async execute(args: z.infer<typeof CreateArgs>, ctx: ToolContext): Promise<ToolResult> {
    if (!isArtifactType(args.type)) {
      return { content: `Invalid artifact type "${args.type}". Use one of: ${TYPE_VALUES.join(', ')}.`, isError: true };
    }
    const { manifest, absFile } = await createArtifact(
      ctx.cwd,
      { title: args.title, type: args.type as ArtifactType, content: args.content, note: args.note },
      (p, c) => ctx.transaction.write(p, c),
    );
    ctx.emit({ type: 'progress', message: `Created artifact "${manifest.id}" (v1)` });
    return {
      content: `Created artifact "${manifest.id}" (${manifest.type}, v1) at ${absFile}. Use artifact_update with id="${manifest.id}" to revise it.`,
      metadata: { artifactId: manifest.id, version: 1, type: manifest.type, path: absFile },
    };
  }