aec-agent 1.0.0

package/dist/components/skill-hub/types/agent-skills.d.ts

@@ -0,0 +1,20 @@
+import type { Skill, SkillPackage } from "./skill.js";
+export interface AgentSkills {
+    /** Skills the agent can use now: enabled for it and every required tool available. */
+    list(): Promise<Skill[]>;
+    /** A skill enabled for this agent (even if a required tool is missing), or undefined. */
+    get(name: string): Promise<Skill | undefined>;
+    /**
+     * Add a custom skill to the library and enable it for this agent. Other agents can enable
+     * it later. Throws SkillError ("invalid", "already_exists").
+     */
+    create(skill: SkillPackage): Promise<Skill>;
+    /**
+     * Replace a custom skill enabled for this agent (SKILL.md and all its files). The name
+     * cannot change. Throws SkillError ("not_found", "not_allowed", "read_only", "invalid").
+     */
+    update(name: string, skill: SkillPackage): Promise<Skill>;
+    /** Delete a custom skill enabled for this agent, and disable it. Throws SkillError. */
+    delete(name: string): Promise<void>;
+}
+//# sourceMappingURL=agent-skills.d.ts.map

package/dist/components/skill-hub/types/agent-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills.d.ts","sourceRoot":"","sources":["../../../../src/components/skill-hub/types/agent-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAOtD,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzB,yFAAyF;IACzF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC9C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,uFAAuF;IACvF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/components/skill-hub/types/agent-skills.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-skills.js.map

package/dist/components/skill-hub/types/agent-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-skills.js","sourceRoot":"","sources":["../../../../src/components/skill-hub/types/agent-skills.ts"],"names":[],"mappings":""}

package/dist/components/skill-hub/types/skill.d.ts

@@ -0,0 +1,55 @@
+/** One extra file of a skill, e.g. "scripts/extract.py" or "references/format.md". Text only. */
+export interface SkillFile {
+    /** Relative POSIX path inside the skill folder. */
+    path: string;
+    content: string;
+}
+/** What you register or create: the SKILL.md text and the skill's other files. */
+export interface SkillPackage {
+    /** The full SKILL.md: `---` frontmatter (name, description, …) `---` then the instructions. */
+    content: string;
+    files?: SkillFile[];
+}
+/**
+ * Where a skill comes from:
+ *  - "built-in": shipped with the SDK (the essential skills) — read-only.
+ *  - "app":      registered by the host app with `Kernel.useSkill()` — read-only.
+ *  - "custom":   created at runtime (by an agent through skill_manage, or by a user) and
+ *                kept in the SkillStore — the only kind that can be edited or deleted.
+ */
+export type SkillSource = "built-in" | "app" | "custom";
+/** The SKILL.md frontmatter fields (Agent Skills specification). */
+export interface SkillFrontmatter {
+    /** 1–64 chars of a-z, 0-9 and single hyphens; unique in the library. */
+    name: string;
+    /** What the skill does and when to use it (1–1024 chars) — this is what the model sees. */
+    description: string;
+    license?: string;
+    /** Environment requirements, free text (max 500 chars). */
+    compatibility?: string;
+    /** `allowed-tools` — a hint, never a permission boundary. */
+    allowedTools?: string[];
+    /** Extra string key/values. Nested maps are flattened to dotted keys ("hermes.tags"). */
+    metadata: Record<string, string>;
+}
+/** A skill in the library — parsed, validated and ready to show to an agent. */
+export interface Skill extends SkillFrontmatter {
+    /** The SKILL.md instructions without the frontmatter. */
+    body: string;
+    /** The SKILL.md text as written — the source of truth. */
+    content: string;
+    files: SkillFile[];
+    source: SkillSource;
+    /**
+     * Tools the skill needs (metadata `requires-tools`, space or comma separated). An agent
+     * that lacks any of them does not see the skill in its index.
+     */
+    requiresTools: string[];
+    /** Agent that created it (custom skills made through skill_manage). */
+    createdBy?: string;
+    /** Increments on every update of a custom skill; 1 for built-in and app skills. */
+    version: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/components/skill-hub/types/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/components/skill-hub/types/skill.ts"],"names":[],"mappings":"AAUA,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,gFAAgF;AAChF,MAAM,WAAW,KAAM,SAAQ,gBAAgB;IAC7C,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/skill-hub/types/skill.js

@@ -0,0 +1,11 @@
+// ---------------------------------------------------------------------------
+// Skill — learned or predefined procedures the agent can execute
+//
+// A skill is a SKILL.md file (YAML frontmatter + Markdown instructions) plus optional
+// files — scripts/, references/, assets/ — in the Agent Skills format (agentskills.io),
+// the same format Claude, Hermes Agent and OpenClaw use. A skill is NOT a tool: it adds
+// no new abilities, it tells the model how to use the tools it already has. Only the
+// name + description are in the prompt; the body is loaded on demand (skill_view).
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=skill.js.map

package/dist/components/skill-hub/types/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/components/skill-hub/types/skill.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,sFAAsF;AACtF,wFAAwF;AACxF,wFAAwF;AACxF,qFAAqF;AACrF,mFAAmF;AACnF,8EAA8E"}

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

@@ -0,0 +1,52 @@
+import type { SandboxView } from "../../../sandbox-hub/types/sandbox.js";
+import type { ArtifactRef, ArtifactView } from "../../../artifact-hub/types/artifact.js";
+import type { ToolContext, ToolOutput } from "../../types.js";
+import type { ArtifactToolOptions, ResolvedArtifactToolOptions } from "./types.js";
+export declare function resolveOptions(options?: ArtifactToolOptions): ResolvedArtifactToolOptions;
+/**
+ * Run `fn` against the agent's artifacts. Every ArtifactError becomes an error
+ * result the model can act on; deterministic failures (name conflict, not found,
+ * a missing tracked file, …) are marked non-retryable so the harness does not
+ * repeat them. SandboxError is mapped too, since every artifact read or write
+ * touches the agent's sandbox.
+ */
+export declare function withArtifacts(toolName: string, context: ToolContext, fn: (artifacts: ArtifactView) => Promise<ToolOutput>): Promise<ToolOutput>;
+export declare function argError(toolName: string, message: string): ToolOutput;
+export declare function stringArg(args: Record<string, unknown>, key: string): string | undefined;
+export declare function numberArg(args: Record<string, unknown>, key: string): number | undefined;
+export declare function stringListArg(args: Record<string, unknown>, key: string): string[] | undefined;
+/** `id` / `name` from tool arguments — the model may use either to point at an artifact. */
+export declare function refArg(args: Record<string, unknown>): ArtifactRef;
+/**
+ * Resolves the agent's sandbox for an artifact tool call. Every artifact tracks a
+ * file, so a tool with no sandbox has nothing to track or read — a clear, non-retryable
+ * argument error rather than a deeper failure once the call proceeds.
+ */
+export declare function sandboxFor(toolName: string, context: ToolContext): Promise<{
+    ok: true;
+    sandbox: SandboxView;
+} | {
+    ok: false;
+    output: ToolOutput;
+}>;
+/**
+ * Content/path for a save/update: either inline `content` (written to the sandbox
+ * and then tracked), or a sandbox file named by `from_path` (tracked as-is). Models
+ * routinely fill every property a schema offers, so passing both is handled rather
+ * than refused: inline `content` wins and the ignored `from_path` is reported back
+ * in the result. A blank `content` next to a `from_path` means the model meant to
+ * track that file. This does not read or write anything — the view does.
+ */
+export declare function sourceFrom(args: Record<string, unknown>): {
+    content?: string;
+    path?: string;
+    ignoredFromPath?: string;
+};
+/**
+ * Told to the model when it passed both `content` and `from_path`: the call went
+ * through on the inline content, and this says which argument was dropped so the
+ * next call is unambiguous (and so a track it actually wanted is not silent).
+ */
+export declare function ignoredFromPathNote(ignoredFromPath: string | undefined): string;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=artifact-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/artifact-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAKnF,wBAAgB,cAAc,CAAC,OAAO,GAAE,mBAAwB,GAAG,2BAA2B,CAO7F;AAUD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,GACnD,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAEtE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAK9F;AAED,4FAA4F;AAC5F,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAOjE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAQjF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAcvH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM/E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

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

@@ -0,0 +1,143 @@
+import { ArtifactError } from "../../../../kernel/errors/artifact-error.js";
+import { SandboxError } from "../../../../kernel/errors/sandbox-error.js";
+// Shared plumbing for the artifact tools: view + sandbox access, argument
+// parsing, ArtifactError/SandboxError -> ToolOutput mapping and output formatting.
+export function resolveOptions(options = {}) {
+    const positive = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.floor(value) : fallback;
+    return {
+        maxReadBytes: positive(options.maxReadBytes, 100_000),
+        maxListEntries: positive(options.maxListEntries, 50),
+    };
+}
+const HINTS = {
+    name_conflict: "Use update_artifact to add a new version, or save under a different name.",
+    not_found: "Check the exact name or id with list_artifacts.",
+    conflict: "Read the artifact again to get the current version, then update it.",
+    not_configured: "No artifact store is configured on this server; tell the user.",
+    file_missing: "write the file first (write_file) or pass content, then try again",
+};
+/**
+ * Run `fn` against the agent's artifacts. Every ArtifactError becomes an error
+ * result the model can act on; deterministic failures (name conflict, not found,
+ * a missing tracked file, …) are marked non-retryable so the harness does not
+ * repeat them. SandboxError is mapped too, since every artifact read or write
+ * touches the agent's sandbox.
+ */
+export async function withArtifacts(toolName, context, fn) {
+    if (!context.getArtifacts) {
+        return {
+            content: `${toolName}: this agent has no artifact store — lasting outputs are not available`,
+            isError: true,
+            retryable: false,
+        };
+    }
+    try {
+        return await fn(context.getArtifacts());
+    }
+    catch (error) {
+        if (error instanceof ArtifactError) {
+            const hint = HINTS[error.code];
+            return {
+                content: `${toolName} failed (${error.code}): ${error.message}${hint ? `\n${hint}` : ""}`,
+                isError: true,
+                retryable: error.retryable,
+                metadata: { code: error.code },
+            };
+        }
+        if (error instanceof SandboxError) {
+            const hint = error.code === "disabled" ? "this agent has no sandbox, so it cannot have artifacts" : undefined;
+            return {
+                content: `${toolName} failed: sandbox error (${error.code}): ${error.message}${hint ? `\n${hint}` : ""}`,
+                isError: true,
+                retryable: error.retryable,
+                metadata: { code: error.code },
+            };
+        }
+        return {
+            content: `${toolName} failed: ${error instanceof Error ? error.message : String(error)}`,
+            isError: true,
+        };
+    }
+}
+export function argError(toolName, message) {
+    return { content: `${toolName}: ${message}`, isError: true, retryable: false };
+}
+export function stringArg(args, key) {
+    const value = args[key];
+    return typeof value === "string" ? value : undefined;
+}
+export function numberArg(args, key) {
+    const value = args[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+export function stringListArg(args, key) {
+    const value = args[key];
+    if (!Array.isArray(value))
+        return undefined;
+    const list = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean);
+    return list.length ? list : undefined;
+}
+/** `id` / `name` from tool arguments — the model may use either to point at an artifact. */
+export function refArg(args) {
+    const id = stringArg(args, "id")?.trim();
+    const name = stringArg(args, "name")?.trim();
+    return {
+        ...(id ? { id } : {}),
+        ...(name ? { name } : {}),
+    };
+}
+/**
+ * Resolves the agent's sandbox for an artifact tool call. Every artifact tracks a
+ * file, so a tool with no sandbox has nothing to track or read — a clear, non-retryable
+ * argument error rather than a deeper failure once the call proceeds.
+ */
+export async function sandboxFor(toolName, context) {
+    if (!context.getSandbox) {
+        return {
+            ok: false,
+            output: argError(toolName, "this agent has no sandbox, so it cannot have artifacts — artifacts track files in the agent's workspace"),
+        };
+    }
+    return { ok: true, sandbox: await context.getSandbox() };
+}
+/**
+ * Content/path for a save/update: either inline `content` (written to the sandbox
+ * and then tracked), or a sandbox file named by `from_path` (tracked as-is). Models
+ * routinely fill every property a schema offers, so passing both is handled rather
+ * than refused: inline `content` wins and the ignored `from_path` is reported back
+ * in the result. A blank `content` next to a `from_path` means the model meant to
+ * track that file. This does not read or write anything — the view does.
+ */
+export function sourceFrom(args) {
+    const inline = stringArg(args, "content");
+    const fromPath = stringArg(args, "from_path")?.trim();
+    // An empty/whitespace `content` next to a from_path means the model meant to track
+    // the file (some providers send "" for the property they did not fill).
+    const hasInline = inline !== undefined && (!fromPath || inline.trim() !== "");
+    if (hasInline) {
+        return { content: inline, ...(fromPath ? { ignoredFromPath: fromPath } : {}) };
+    }
+    if (fromPath) {
+        return { path: fromPath };
+    }
+    return {};
+}
+/**
+ * Told to the model when it passed both `content` and `from_path`: the call went
+ * through on the inline content, and this says which argument was dropped so the
+ * next call is unambiguous (and so a track it actually wanted is not silent).
+ */
+export function ignoredFromPathNote(ignoredFromPath) {
+    if (!ignoredFromPath)
+        return "";
+    return (`\nNote: you passed both "content" and "from_path" — the inline content was saved and "${ignoredFromPath}" was ignored. ` +
+        `Pass only one. To track that file instead, call update_artifact with just "from_path".`);
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+//# sourceMappingURL=artifact-helpers.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { ToolHandler } from "../../types.js";
+import type { ArtifactToolOptions } from "./types.js";
+/** Tool names of the artifact tools, for agent allowlists. */
+export declare const ARTIFACT_TOOL_NAMES: readonly ["save_artifact", "update_artifact", "read_artifact", "list_artifacts"];
+/** All artifact tools with the same options — register them with `core.useTool()`. */
+export declare function createArtifactTools(options?: ArtifactToolOptions): ToolHandler[];
+//# sourceMappingURL=create-artifact-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-artifact-tools.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/create-artifact-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAIlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,YAC9B,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,CAC7D,CAAC;AAEX,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,mBAAwB,GAAG,WAAW,EAAE,CAOpF"}

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

@@ -0,0 +1,18 @@
+import { ListArtifactsTool } from "./list-artifacts-tool.js";
+import { ReadArtifactTool } from "./read-artifact-tool.js";
+import { SaveArtifactTool } from "./save-artifact-tool.js";
+import { UpdateArtifactTool } from "./update-artifact-tool.js";
+/** Tool names of the artifact tools, for agent allowlists. */
+export const ARTIFACT_TOOL_NAMES = [
+    "save_artifact", "update_artifact", "read_artifact", "list_artifacts",
+];
+/** All artifact tools with the same options — register them with `core.useTool()`. */
+export function createArtifactTools(options = {}) {
+    return [
+        new SaveArtifactTool(options),
+        new UpdateArtifactTool(options),
+        new ReadArtifactTool(options),
+        new ListArtifactsTool(options),
+    ];
+}
+//# sourceMappingURL=create-artifact-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-artifact-tools.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/create-artifact-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB;CAC7D,CAAC;AAEX,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAwB,EAAE;IACnE,OAAO;QACL,IAAI,gBAAgB,CAAC,OAAO,CAAC;QAC7B,IAAI,kBAAkB,CAAC,OAAO,CAAC;QAC/B,IAAI,gBAAgB,CAAC,OAAO,CAAC;QAC7B,IAAI,iBAAiB,CAAC,OAAO,CAAC;KAC/B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { ArtifactToolOptions } from "./types.js";
+/**
+ * list_artifacts — what this agent has already made, most recently updated first.
+ * Metadata only (no content), so the model can decide what to read or update without
+ * pulling whole deliverables into context.
+ */
+export declare class ListArtifactsTool implements ToolHandler {
+    readonly name = "tool:list-artifacts";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    private options;
+    constructor(options?: ArtifactToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=list-artifacts-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-artifacts-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/list-artifacts-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,mBAAmB,EAA+B,MAAM,YAAY,CAAC;AAEnF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,OAAO,CAA8B;IAE7C,YAAY,OAAO,GAAE,mBAAwB,EAmB5C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CtF;CACF"}

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

@@ -0,0 +1,69 @@
+import { formatBytes, numberArg, resolveOptions, stringArg, stringListArg, withArtifacts } from "./artifact-helpers.js";
+/**
+ * list_artifacts — what this agent has already made, most recently updated first.
+ * Metadata only (no content), so the model can decide what to read or update without
+ * pulling whole deliverables into context.
+ */
+export class ListArtifactsTool {
+    name = "tool:list-artifacts";
+    version = "1.0.0";
+    definition;
+    options;
+    constructor(options = {}) {
+        this.options = resolveOptions(options);
+        this.definition = {
+            name: "list_artifacts",
+            description: "List the artifacts you have made — name, type, version, size and description, newest first. " +
+                "Check this before saving, so you update an existing deliverable instead of creating a near-duplicate.",
+            parameters: {
+                type: "object",
+                properties: {
+                    type: { type: "string", description: 'Only artifacts of this type (e.g. "text/markdown")' },
+                    tags: { type: "array", items: { type: "string" }, description: "Only artifacts carrying any of these tags" },
+                    this_session_only: { type: "boolean", description: "Only artifacts first created in this conversation" },
+                    limit: { type: "number", description: "Most artifacts to return" },
+                },
+                required: [],
+            },
+            risk: "read-only",
+        };
+    }
+    async execute(args, context) {
+        return withArtifacts("list_artifacts", context, async (artifacts) => {
+            const requested = numberArg(args, "limit");
+            const limit = Math.max(1, Math.floor(Math.min(requested && requested > 0 ? requested : this.options.maxListEntries, this.options.maxListEntries)));
+            const type = stringArg(args, "type")?.trim();
+            const tags = stringListArg(args, "tags");
+            const thisSessionOnly = args["this_session_only"] === true;
+            const found = await artifacts.list({
+                ...(type ? { types: [type] } : {}),
+                ...(tags ? { tags } : {}),
+                ...(thisSessionOnly && artifacts.sessionId ? { sessionId: artifacts.sessionId } : {}),
+                limit,
+            });
+            if (found.length === 0) {
+                return {
+                    content: "No artifacts yet. Use save_artifact when you produce a deliverable worth keeping.",
+                    metadata: { count: 0 },
+                };
+            }
+            const lines = found.map((artifact) => [
+                `${artifact.name} (${artifact.type}) v${artifact.version}`,
+                formatBytes(artifact.bytes),
+                `tracks ${artifact.sandboxPath}`,
+                `updated ${artifact.updatedAt}`,
+                ...(artifact.tags?.length ? [`tags: ${artifact.tags.join(", ")}`] : []),
+                ...(artifact.description ? [artifact.description] : []),
+                `id ${artifact.id}`,
+            ].join(" · "));
+            return {
+                content: `${found.length} artifact${found.length === 1 ? "" : "s"}:\n${lines.join("\n")}`,
+                metadata: {
+                    count: found.length,
+                    artifacts: found.map((a) => ({ id: a.id, name: a.name, type: a.type, version: a.version, bytes: a.bytes, sandboxPath: a.sandboxPath })),
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=list-artifacts-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-artifacts-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/list-artifacts-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGxH;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,qBAAqB,CAAC;IAC7B,OAAO,GAAG,OAAO,CAAC;IAClB,UAAU,CAAiB;IAC5B,OAAO,CAA8B;IAE7C,YAAY,OAAO,GAAwB,EAAE;QAC3C,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,8FAA8F;gBAC9F,uGAAuG;YACzG,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;oBAC3F,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE;oBAC5G,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mDAAmD,EAAE;oBACxG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;iBACnE;gBACD,QAAQ,EAAE,EAAE;aACb;YACD,IAAI,EAAE,WAAW;SAClB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAAoB;QAC/D,OAAO,aAAa,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAClE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CACxH,CAAC;YACF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;YAE3D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,eAAe,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrF,KAAK;aACN,CAAC,CAAC;YAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,mFAAmF;oBAC5F,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;iBACvB,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACnC;gBACE,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,OAAO,EAAE;gBAC1D,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC3B,UAAU,QAAQ,CAAC,WAAW,EAAE;gBAChC,WAAW,QAAQ,CAAC,SAAS,EAAE;gBAC/B,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvE,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,MAAM,QAAQ,CAAC,EAAE,EAAE;aACpB,CAAC,IAAI,CAAC,KAAK,CAAC,CACd,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACzF,QAAQ,EAAE;oBACR,KAAK,EAAE,KAAK,CAAC,MAAM;oBACnB,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;iBACxI;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { ArtifactToolOptions } from "./types.js";
+/**
+ * read_artifact — read a tracked artifact's file, live from the agent's sandbox. Bounded
+ * for the model's context by max_bytes; the file itself is never truncated, and the
+ * user's Artifacts panel always shows it whole.
+ */
+export declare class ReadArtifactTool implements ToolHandler {
+    readonly name = "tool:read-artifact";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    private options;
+    constructor(options?: ArtifactToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=read-artifact-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-artifact-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/read-artifact-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,mBAAmB,EAA+B,MAAM,YAAY,CAAC;AAEnF;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,OAAO,CAA8B;IAE7C,YAAY,OAAO,GAAE,mBAAwB,EAmB5C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDtF;CACF"}

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

@@ -0,0 +1,79 @@
+import { argError, formatBytes, numberArg, refArg, resolveOptions, sandboxFor, withArtifacts } from "./artifact-helpers.js";
+/**
+ * read_artifact — read a tracked artifact's file, live from the agent's sandbox. Bounded
+ * for the model's context by max_bytes; the file itself is never truncated, and the
+ * user's Artifacts panel always shows it whole.
+ */
+export class ReadArtifactTool {
+    name = "tool:read-artifact";
+    version = "1.0.0";
+    definition;
+    options;
+    constructor(options = {}) {
+        this.options = resolveOptions(options);
+        this.definition = {
+            name: "read_artifact",
+            description: "Read an artifact's tracked file, live from your workspace. Use this instead of keeping a long deliverable " +
+                "in the conversation: refer to the artifact by name and read it when you need it.",
+            parameters: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Name of the artifact (or use id)" },
+                    id: { type: "string", description: "Id of the artifact (or use name)" },
+                    max_bytes: { type: "number", description: "Most bytes of content to return" },
+                },
+                required: [],
+            },
+            risk: "read-only",
+            sandboxOperation: "fs.read",
+        };
+    }
+    async execute(args, context) {
+        const ref = refArg(args);
+        if (!ref.id && !ref.name)
+            return argError("read_artifact", 'give "name" or "id" to say which artifact to read');
+        return withArtifacts("read_artifact", context, async (artifacts) => {
+            const resolved = await sandboxFor("read_artifact", context);
+            if (!resolved.ok)
+                return resolved.output;
+            const { sandbox } = resolved;
+            const requested = numberArg(args, "max_bytes");
+            const maxBytes = Math.max(1, Math.floor(Math.min(requested && requested > 0 ? requested : this.options.maxReadBytes, this.options.maxReadBytes)));
+            const { artifact, file } = await artifacts.read(ref, sandbox, { maxBytes });
+            if (file.status === "missing") {
+                return {
+                    content: `read_artifact: "${artifact.name}" (tracks ${file.path}) is missing — ${file.reason}`,
+                    isError: true,
+                    retryable: false,
+                    metadata: { code: "file_missing", artifactId: artifact.id, name: artifact.name, sandboxPath: file.path },
+                };
+            }
+            const header = [
+                `${artifact.name} (${artifact.type}) v${artifact.version}`,
+                formatBytes(file.size),
+                `tracks ${file.path}`,
+            ].join(" · ");
+            const notice = file.status === "changed"
+                ? `Note: this file changed since v${artifact.version} was tracked — call update_artifact with just the name to record it.\n\n`
+                : "";
+            const truncationNote = file.truncated
+                ? `\n\n… [showing ${formatBytes(Buffer.byteLength(file.content, "utf8"))} of ${formatBytes(file.size)} — raise max_bytes to see more]`
+                : "";
+            return {
+                content: `${notice}${header}\n\n${file.content}${truncationNote}`,
+                metadata: {
+                    artifactId: artifact.id,
+                    name: artifact.name,
+                    type: artifact.type,
+                    version: artifact.version,
+                    status: file.status,
+                    bytes: file.size,
+                    sha256: file.sha256,
+                    truncated: file.truncated,
+                    sandboxPath: file.path,
+                },
+            };
+        });
+    }
+}
+//# sourceMappingURL=read-artifact-tool.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+import type { ArtifactToolOptions } from "./types.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 declare class SaveArtifactTool implements ToolHandler {
+    readonly name = "tool:save-artifact";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    constructor(_options?: ArtifactToolOptions);
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=save-artifact-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save-artifact-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/artifacts/save-artifact-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpC,YAAY,QAAQ,GAAE,mBAAwB,EAuC7C;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DtF;CACF"}