aec-agent 1.0.0

package/dist/components/tool-hub/built-in-tools/artifacts/save-artifact-tool.js

@@ -0,0 +1,105 @@
+import { SDKEventType } from "../../../event-handler/events.js";
+import { argError, formatBytes, ignoredFromPathNote, sandboxFor, sourceFrom, stringArg, stringListArg, withArtifacts } from "./artifact-helpers.js";
+/**
+ * save_artifact — start tracking a lasting output at version 1: either text written to
+ * the agent's workspace first (inline `content`), or an existing workspace file
+ * (`from_path`). A name the agent already used is refused: changing an existing
+ * artifact is update_artifact's job, so its file is never clobbered.
+ */
+export class SaveArtifactTool {
+    name = "tool:save-artifact";
+    version = "1.0.0";
+    definition;
+    constructor(_options = {}) {
+        this.definition = {
+            name: "save_artifact",
+            description: "Save a lasting output — a report, a spec section, a takeoff, an estimate — as an artifact the user keeps " +
+                "and can hand to another agent. Artifacts track a file in your workspace, versioned by name, so later turns " +
+                "refer to them by name instead of re-pasting their content. Pass \"from_path\" to track a file you already " +
+                "wrote (write_file first), or \"content\" to have it written to artifacts/<name> in your workspace and " +
+                "tracked. Use one or the other, not both.",
+            parameters: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: 'Stable name, unique for this agent (e.g. "clash-report.md" or "reports/q3-takeoff.csv")',
+                    },
+                    type: {
+                        type: "string",
+                        description: 'MIME type ("text/markdown", "text/csv", "text/html", "application/json") or a domain type ' +
+                            '("aec/takeoff", "aec/clash-report"). A real MIME type lets the user\'s Artifacts panel render it ' +
+                            "(formatted markdown, a table, a rendered page) instead of plain text.",
+                    },
+                    content: { type: "string", description: "Text to write to your workspace and track. Leave it out when you use from_path." },
+                    from_path: {
+                        type: "string",
+                        description: "Instead of content: a workspace file to track (its bytes are not copied). " +
+                            "Leave it out when you pass content — content wins if both are given.",
+                    },
+                    description: { type: "string", description: "One line on what this artifact is, for the user's list" },
+                    tags: { type: "array", items: { type: "string" }, description: "Optional labels for filtering" },
+                    note: { type: "string", description: "Why this version exists — shown in the version history" },
+                },
+                required: ["name", "type"],
+            },
+            risk: "draft",
+            sandboxOperation: "fs.write",
+        };
+    }
+    async execute(args, context) {
+        const name = stringArg(args, "name")?.trim();
+        const type = stringArg(args, "type")?.trim();
+        if (!name)
+            return argError("save_artifact", '"name" must be a non-empty string');
+        if (!type)
+            return argError("save_artifact", '"type" must be a non-empty string');
+        return withArtifacts("save_artifact", context, async (artifacts) => {
+            const resolved = await sandboxFor("save_artifact", context);
+            if (!resolved.ok)
+                return resolved.output;
+            const { sandbox } = resolved;
+            const source = sourceFrom(args);
+            const saved = await artifacts.save({
+                name,
+                type,
+                ...(source.content !== undefined ? { content: source.content } : {}),
+                ...(source.path !== undefined ? { path: source.path } : {}),
+                ...(stringArg(args, "description") ? { description: stringArg(args, "description") } : {}),
+                ...(stringListArg(args, "tags") ? { tags: stringListArg(args, "tags") } : {}),
+                ...(stringArg(args, "note") ? { note: stringArg(args, "note") } : {}),
+                tool: "save_artifact",
+            }, sandbox);
+            context.emit({
+                type: SDKEventType.ArtifactSaved,
+                sessionId: context.sessionId,
+                payload: {
+                    agentId: saved.artifact.agentId,
+                    artifactId: saved.artifact.id,
+                    name: saved.artifact.name,
+                    type: saved.artifact.type,
+                    version: saved.artifact.version,
+                    bytes: saved.artifact.bytes,
+                    sandboxPath: saved.artifact.sandboxPath,
+                    sandboxId: saved.artifact.sandboxId,
+                },
+            });
+            return {
+                content: `Saved artifact "${saved.artifact.name}" (${saved.artifact.type}) as v1 — tracks ${saved.artifact.sandboxPath} ` +
+                    `(${formatBytes(saved.artifact.bytes)}), id ${saved.artifact.id}. Refer to it by name from now on; use update_artifact to change it.` +
+                    ignoredFromPathNote(source.ignoredFromPath),
+                metadata: {
+                    artifactId: saved.artifact.id,
+                    name: saved.artifact.name,
+                    type: saved.artifact.type,
+                    version: saved.artifact.version,
+                    bytes: saved.artifact.bytes,
+                    sha256: saved.artifact.sha256,
+                    sandboxPath: saved.artifact.sandboxPath,
+                    ...(source.ignoredFromPath ? { ignoredFromPath: source.ignoredFromPath } : {}),
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=save-artifact-tool.js.map

package/dist/components/tool-hub/built-in-tools/artifacts/save-artifact-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-artifact-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/save-artifact-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/artifacts/types.d.ts

@@ -0,0 +1,11 @@
+export interface ArtifactToolOptions {
+    /** Most bytes of a tracked file's content read_artifact returns to the model. Default 100 000 — not a hub limit, just a tool-level ceiling; the sandbox clamps further to its own limits.maxReadBytes. */
+    maxReadBytes?: number;
+    /** Most artifacts list_artifacts returns. Default 50. */
+    maxListEntries?: number;
+}
+export type ResolvedArtifactToolOptions = {
+    maxReadBytes: number;
+    maxListEntries: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/tool-hub/built-in-tools/artifacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,0MAA0M;IAC1M,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/components/tool-hub/built-in-tools/artifacts/types.js

@@ -0,0 +1,8 @@
+// ---------------------------------------------------------------------------
+// Artifact tools (A-62) — save / update / read / list the agent's lasting
+// outputs. They work ONLY through ToolContext.getArtifacts() (the agent-scoped
+// ArtifactView) and ToolContext.getSandbox() (the file every artifact tracks),
+// never the store directly, so ownership stays enforced in one place.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/tool-hub/built-in-tools/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,sEAAsE;AACtE,8EAA8E"}

package/dist/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.d.ts

@@ -0,0 +1,17 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { ArtifactToolOptions } from "./types.js";
+/**
+ * update_artifact — append a version to an existing artifact: rewrite the tracked file
+ * with new content, track a different file with `from_path`, or, with neither, re-track
+ * the same file's current state after you edited it with edit_file/write_file. The
+ * history is a content-less log — `expected_version` gives the model optimistic
+ * concurrency when a person may have changed it in between.
+ */
+export declare class UpdateArtifactTool implements ToolHandler {
+    readonly name = "tool:update-artifact";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    constructor(_options?: ArtifactToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=update-artifact-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-artifact-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAa3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,YAAY,QAAQ,GAAE,mBAAwB,EAiC7C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DtF;CACF"}

package/dist/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.js

@@ -0,0 +1,100 @@
+import { SDKEventType } from "../../../event-handler/events.js";
+import { argError, formatBytes, ignoredFromPathNote, numberArg, refArg, sandboxFor, sourceFrom, stringArg, stringListArg, withArtifacts, } from "./artifact-helpers.js";
+/**
+ * update_artifact — append a version to an existing artifact: rewrite the tracked file
+ * with new content, track a different file with `from_path`, or, with neither, re-track
+ * the same file's current state after you edited it with edit_file/write_file. The
+ * history is a content-less log — `expected_version` gives the model optimistic
+ * concurrency when a person may have changed it in between.
+ */
+export class UpdateArtifactTool {
+    name = "tool:update-artifact";
+    version = "1.0.0";
+    definition;
+    constructor(_options = {}) {
+        this.definition = {
+            name: "update_artifact",
+            description: "Record a new version of a tracked artifact. Identify it by \"name\" or \"id\", then give either the " +
+                "complete new content (not a patch) in \"content\" (rewrites the tracked file), or a different workspace " +
+                "file to track with \"from_path\" — one or the other, not both. Give neither to record the tracked file's " +
+                "current state after you edited it yourself with edit_file/write_file.",
+            parameters: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Name of the artifact to update (or use id)" },
+                    id: { type: "string", description: "Id of the artifact to update (or use name)" },
+                    content: { type: "string", description: "The complete new content, written to the tracked file. Leave it out to track without rewriting." },
+                    from_path: {
+                        type: "string",
+                        description: "Instead of content: a different workspace file to track from now on. " +
+                            "Leave it out when you pass content — content wins if both are given.",
+                    },
+                    note: { type: "string", description: "What changed in this version — shown in the version history" },
+                    description: { type: "string", description: "Replace the artifact's description" },
+                    tags: { type: "array", items: { type: "string" }, description: "Replace the artifact's tags" },
+                    expected_version: {
+                        type: "number",
+                        description: "Only update if this is still the current version number; otherwise the call fails",
+                    },
+                },
+                required: [],
+            },
+            risk: "draft",
+            sandboxOperation: "fs.write",
+        };
+    }
+    async execute(args, context) {
+        const ref = refArg(args);
+        if (!ref.id && !ref.name)
+            return argError("update_artifact", 'give "name" or "id" to say which artifact to update');
+        return withArtifacts("update_artifact", context, async (artifacts) => {
+            const resolved = await sandboxFor("update_artifact", context);
+            if (!resolved.ok)
+                return resolved.output;
+            const { sandbox } = resolved;
+            const source = sourceFrom(args);
+            const expectedVersion = numberArg(args, "expected_version");
+            const updated = await artifacts.update({
+                ...(ref.id ? { id: ref.id } : {}),
+                ...(ref.name ? { name: ref.name } : {}),
+                ...(source.content !== undefined ? { content: source.content } : {}),
+                ...(source.path !== undefined ? { path: source.path } : {}),
+                ...(stringArg(args, "note") ? { note: stringArg(args, "note") } : {}),
+                ...(stringArg(args, "description") !== undefined ? { description: stringArg(args, "description") } : {}),
+                ...(stringListArg(args, "tags") ? { tags: stringListArg(args, "tags") } : {}),
+                ...(expectedVersion !== undefined ? { expectedVersion } : {}),
+                tool: "update_artifact",
+            }, sandbox);
+            context.emit({
+                type: SDKEventType.ArtifactUpdated,
+                sessionId: context.sessionId,
+                payload: {
+                    agentId: updated.artifact.agentId,
+                    artifactId: updated.artifact.id,
+                    name: updated.artifact.name,
+                    type: updated.artifact.type,
+                    version: updated.artifact.version,
+                    bytes: updated.artifact.bytes,
+                    sandboxPath: updated.artifact.sandboxPath,
+                    sandboxId: updated.artifact.sandboxId,
+                },
+            });
+            return {
+                content: `Updated "${updated.artifact.name}" to v${updated.artifact.version} — tracks ${updated.artifact.sandboxPath} ` +
+                    `(${formatBytes(updated.artifact.bytes)}).` +
+                    ignoredFromPathNote(source.ignoredFromPath),
+                metadata: {
+                    artifactId: updated.artifact.id,
+                    name: updated.artifact.name,
+                    version: updated.artifact.version,
+                    previousVersion: updated.artifact.version - 1,
+                    bytes: updated.artifact.bytes,
+                    sha256: updated.artifact.sha256,
+                    sandboxPath: updated.artifact.sandboxPath,
+                    ...(source.ignoredFromPath ? { ignoredFromPath: source.ignoredFromPath } : {}),
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=update-artifact-tool.js.map

package/dist/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-artifact-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/update-artifact-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/interaction/clarify-tool.d.ts

@@ -0,0 +1,16 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+/**
+ * clarify — asks the human user a question mid-turn and waits for the answer, through
+ * the host's InteractionHandler. For genuine ambiguity only (which project, which option,
+ * missing required detail) — not for confirmations of consequential actions, which the
+ * harness gates itself via tool risk "consequential".
+ *
+ * Errors are never retried by the harness: re-asking would show the user the question twice.
+ */
+export declare class ClarifyTool implements ToolHandler {
+    readonly name = "tool:clarify";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=clarify-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/interaction/clarify-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/interaction/clarify-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM3F;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAoBjC;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEtF;CACF"}

package/dist/components/tool-hub/built-in-tools/interaction/clarify-tool.js

@@ -0,0 +1,94 @@
+const MAX_CHOICES = 4;
+const MAX_QUESTION_CHARS = 1_000;
+const MAX_CHOICE_CHARS = 200;
+/**
+ * clarify — asks the human user a question mid-turn and waits for the answer, through
+ * the host's InteractionHandler. For genuine ambiguity only (which project, which option,
+ * missing required detail) — not for confirmations of consequential actions, which the
+ * harness gates itself via tool risk "consequential".
+ *
+ * Errors are never retried by the harness: re-asking would show the user the question twice.
+ */
+export class ClarifyTool {
+    name = "tool:clarify";
+    version = "1.0.0";
+    definition = {
+        name: "clarify",
+        description: "Ask the user a clarifying question and wait for their answer. Use only when the request is " +
+            "genuinely ambiguous or missing information you cannot find with other tools, and a wrong guess " +
+            `would waste work. Ask one focused question; optionally offer up to ${MAX_CHOICES} short choices ` +
+            "(the user may still answer in their own words).",
+        parameters: {
+            type: "object",
+            properties: {
+                question: { type: "string", description: "The question to ask the user" },
+                choices: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: `Optional answer options (max ${MAX_CHOICES})`,
+                },
+            },
+            required: ["question"],
+        },
+        risk: "read-only",
+    };
+    async execute(args, context) {
+        const question = typeof args["question"] === "string" ? args["question"].trim() : "";
+        if (!question) {
+            return { content: 'clarify: "question" must be a non-empty string', isError: true, retryable: false };
+        }
+        if (question.length > MAX_QUESTION_CHARS) {
+            return {
+                content: `clarify: question is too long (max ${MAX_QUESTION_CHARS} characters)`,
+                isError: true,
+                retryable: false,
+            };
+        }
+        const rawChoices = Array.isArray(args["choices"]) ? args["choices"] : [];
+        const choices = [
+            ...new Set(rawChoices
+                .filter((c) => typeof c === "string")
+                .map((c) => c.trim().slice(0, MAX_CHOICE_CHARS))
+                .filter(Boolean)),
+        ].slice(0, MAX_CHOICES);
+        const handler = context.interaction;
+        if (!handler) {
+            return {
+                content: "clarify is unavailable: no interactive user is connected to this session. " +
+                    "Proceed with the most reasonable assumption and state it explicitly in your answer, " +
+                    "or end your turn by asking the question in your reply.",
+                isError: true,
+                retryable: false,
+            };
+        }
+        let answer;
+        try {
+            const response = await handler.askUser({
+                sessionId: context.sessionId,
+                agentId: context.agentId,
+                question,
+                choices: choices.length ? choices : undefined,
+            });
+            answer = typeof response?.answer === "string" ? response.answer.trim() : "";
+        }
+        catch (error) {
+            return {
+                content: `clarify failed: ${error instanceof Error ? error.message : String(error)}. ` +
+                    "Do not ask again in this turn; proceed with a stated assumption or ask in your reply.",
+                isError: true,
+                retryable: false,
+            };
+        }
+        if (!answer) {
+            return {
+                content: "The user did not answer. Proceed with the most reasonable assumption and state it explicitly.",
+                metadata: { question, choices, answered: false },
+            };
+        }
+        return {
+            content: `User's answer: ${answer}`,
+            metadata: { question, choices, answered: true, answer },
+        };
+    }
+}
+//# sourceMappingURL=clarify-tool.js.map

package/dist/components/tool-hub/built-in-tools/interaction/clarify-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/interaction/clarify-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/skills/skill-manage-tool.d.ts

@@ -0,0 +1,22 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+/**
+ * skill_manage — lets an agent create and maintain skills in the shared skill library
+ * (used by the built-in skill-creator skill). A created skill is enabled for the agent
+ * right away; other agents can enable it too. Only custom skills can be changed, and an
+ * agent can only change skills that are enabled for it.
+ *
+ * Risk "consequential": a skill changes how agents behave from then on, so every call
+ * waits for the user's approval, which shows the full content being saved.
+ *
+ * After each change the skill's `.skills/<name>/` folder in an isolated workspace is
+ * brought in line with the library (rewritten, or removed on delete), so the agent never
+ * works from a stale copy. A failed sync is reported but does not fail the call — the
+ * skill is saved either way.
+ */
+export declare class SkillManageTool implements ToolHandler {
+    readonly name = "tool:skill-manage";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=skill-manage-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/skills/skill-manage-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manage-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-manage-tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM3F;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAiCjC;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+GtF;CACF"}