@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/tools/asset-persist.js

@@ -0,0 +1,78 @@
+/**
+ * Shared output-persistence helpers for tools that produce media bytes
+ * (images, audio, video, screenshots, etc.).
+ *
+ * `persistOutput` prefers writing through the context's `createAsset` model
+ * interface — that returns a stable `asset_id` and `asset://` URI the agent
+ * loop and chat UI can reference. When no asset interface is wired (CLI,
+ * tests), it falls back to writing the bytes to a workspace file.
+ */
+import { isString } from "../utils/type-guards.js";
+export const MIME_TO_EXT = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/jpg": "jpg",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "image/bmp": "bmp",
+    "video/mp4": "mp4",
+    "video/webm": "webm",
+    "audio/mpeg": "mp3",
+    "audio/mp3": "mp3",
+    "audio/wav": "wav",
+    "audio/x-wav": "wav",
+    "audio/flac": "flac",
+    "audio/ogg": "ogg",
+    "application/octet-stream": "bin"
+};
+export function workspaceDir(context) {
+    const ws = context.workspaceDir;
+    return isString(ws) && ws ? ws : null;
+}
+export function timestampedName(prefix, ext) {
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
+    return `${prefix}-${ts}.${ext}`;
+}
+export { detectImageMime as inferImageMime } from "@nodetool-ai/runtime";
+export async function persistOutput(context, bytes, opts) {
+    const ext = MIME_TO_EXT[opts.mime] ?? "bin";
+    const result = { bytes: bytes.length, mime_type: opts.mime };
+    // The interface, not the method: `createAsset` is on the prototype either
+    // way, so this used to be a check that could not fail.
+    if (context.hasModelInterface?.("createAsset")) {
+        try {
+            const name = opts.outputFile ?? timestampedName(opts.namePrefix, ext);
+            const asset = (await context.createAsset({
+                name,
+                contentType: opts.mime,
+                content: bytes
+            }));
+            if (asset && isString(asset.id)) {
+                result.asset_id = asset.id;
+                result.asset_uri = `asset://${asset.id}.${ext}`;
+                // The same URI, extension and all: a renderer types the media by the
+                // suffix, and the bare `asset://<id>` this used to hand the model's
+                // prose embedded a video as an image.
+                result.url = result.asset_uri;
+            }
+        }
+        catch {
+            // Fall through to filesystem fallback.
+        }
+    }
+    // Persist a workspace copy so downstream tools can read the bytes back by
+    // `output_file`. Routed through the workspace rather than `node:fs`, so a
+    // cloud deployment behaves identically.
+    if ((opts.outputFile || !result.asset_id) && context.workspace) {
+        const fileName = opts.outputFile ?? timestampedName(opts.namePrefix, ext);
+        try {
+            await context.workspace.write(fileName, bytes, opts.mime);
+            result.path = fileName;
+        }
+        catch {
+            // Non-fatal — asset_id (if set) is still a valid handle.
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=asset-persist.js.map

package/dist/tools/asset-persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-persist.js","sourceRoot":"","sources":["../../src/tools/asset-persist.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,0BAA0B,EAAE,KAAK;CAClC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAChC,OAAO,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,GAAW;IACzD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,GAAG,MAAM,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC;AAClC,CAAC;AAED,OAAO,EAAE,eAAe,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYzE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA0B,EAC1B,KAAiB,EACjB,IAIC;IAED,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAE1E,0EAA0E;IAC1E,uDAAuD;IACvD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC;gBACvC,IAAI;gBACJ,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,OAAO,EAAE,KAAK;aACf,CAAC,CAAoB,CAAC;YACvB,IAAI,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,SAAS,GAAG,WAAW,KAAK,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC;gBAChD,qEAAqE;gBACrE,oEAAoE;gBACpE,sCAAsC;gBACtC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,wCAAwC;IACxC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1E,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/base-tool.d.ts

@@ -3,23 +3,70 @@
  *
  * Port of src/nodetool/agents/tools/base.py
  */
-import type { ProcessingContext } from "@nodetool-ai/runtime";
-import type { ProviderTool } from "@nodetool-ai/runtime";
+import { type JsonSchema, type ProcessingContext, type ProviderTool } from "@nodetool-ai/runtime";
+import { type ZodType } from "zod";
+/**
+ * Reserved input-schema field the LLM populates with a short, user-facing
+ * status message describing what the tool call is about to do. Stripped from
+ * params before they reach `process()` so individual tools don't need to know
+ * about it.
+ */
+export declare const USER_MESSAGE_FIELD = "_message";
 export declare abstract class Tool {
     abstract readonly name: string;
     abstract readonly description: string;
-    abstract readonly inputSchema: Record<string, unknown>;
+    protected readonly jsonSchema?: JsonSchema;
+    /**
+     * Opt-in: when `true`, {@link StepExecutor} injects the LLM-assigned
+     * `tool_call_id` into the args under the reserved `_tool_call_id` field
+     * before calling {@link process}. Only tools that need to forward nested
+     * events (currently {@link RunSubtaskTool}) should set this.
+     */
+    readonly needsToolCallId: boolean;
+    get schema(): ZodType | undefined;
+    get inputSchema(): JsonSchema;
     /**
      * Execute the tool with the given parameters.
      */
     abstract process(context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
+    execute(context: ProcessingContext, params: Record<string, unknown> | null | undefined, options?: {
+        toolCallId?: string;
+    }): Promise<unknown>;
+    static executeTool(tool: Tool, context: ProcessingContext, params: Record<string, unknown> | null | undefined, options?: {
+        toolCallId?: string;
+    }): Promise<unknown>;
     /**
      * Convert this tool to the provider tool format expected by BaseProvider.
+     *
+     * The returned schema has a `_message` string property merged in so the LLM
+     * can attach a one-line user-facing status to every call (see
+     * `USER_MESSAGE_SCHEMA_DESCRIPTION`). The field is optional — older models
+     * may omit it, in which case the per-tool `userMessage()` fallback runs.
      */
     toProviderTool(): ProviderTool;
     /**
-     * Return a user-facing message describing this tool call.
+     * Return a user-facing message describing this tool call. Subclasses override
+     * to render parameter-aware templates (e.g. "Reading config.json"); the
+     * LLM-provided `_message` is preferred via {@link Tool.resolveMessage} when
+     * present.
+     */
+    userMessage(params: Record<string, unknown>): string;
+    /**
+     * Extract the LLM-authored `_message` from a tool-call args object. Returns
+     * a trimmed string or `null` if absent / empty / wrong type.
+     */
+    static extractMessage(params: Record<string, unknown> | null | undefined): string | null;
+    /**
+     * Return a shallow copy of `params` with the reserved `_message` field
+     * removed. Use this before passing args to `tool.process()` so tools never
+     * see the protocol field.
+     */
+    static stripMessage(params: Record<string, unknown> | null | undefined): Record<string, unknown>;
+    /**
+     * Resolve the user-facing message for a tool call: prefer the LLM-provided
+     * `_message`, fall back to the tool's parameter-aware template.
      */
-    userMessage(_params: Record<string, unknown>): string;
+    static resolveMessage(tool: Tool, params: Record<string, unknown> | null | undefined): string;
+    private parseParams;
 }
 //# sourceMappingURL=base-tool.d.ts.map

package/dist/tools/base-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-tool.d.ts","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,8BAAsB,IAAI;IACxB,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,OAAO,CACd,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAEnB;;OAEG;IACH,cAAc,IAAI,YAAY;IAQ9B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAGtD"}
+{"version":3,"file":"base-tool.d.ts","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAItC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAQ7C,8BAAsB,IAAI;IACxB,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAS;IAE1C,IAAI,MAAM,IAAI,OAAO,GAAG,SAAS,CAEhC;IAED,IAAI,WAAW,IAAI,UAAU,CAK5B;IAED;;OAEG;IACH,QAAQ,CAAC,OAAO,CACd,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEd,OAAO,CACX,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACpC,OAAO,CAAC,OAAO,CAAC,CAmBlB;IAED,OAAa,WAAW,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACpC,OAAO,CAAC,OAAO,CAAC,CAWlB;IAED;;;;;;;OAOG;IACH,cAAc,IAAI,YAAY,CAM7B;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAInD;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,GAAG,IAAI,CAMf;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,2BAOnD;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,MAAM,CAIR;IAED,OAAO,CAAC,WAAW;CAsCpB"}

package/dist/tools/base-tool.js

@@ -3,22 +3,199 @@
  *
  * Port of src/nodetool/agents/tools/base.py
  */
+import { parseWithTypeCoercion, zodToJsonSchema } from "@nodetool-ai/runtime";
+import { z } from "zod";
+import { TOOL_CALL_ID_FIELD } from "./subtask-fields.js";
+import { isFunction, isRecord, isString } from "../utils/type-guards.js";
+/**
+ * Reserved input-schema field the LLM populates with a short, user-facing
+ * status message describing what the tool call is about to do. Stripped from
+ * params before they reach `process()` so individual tools don't need to know
+ * about it.
+ */
+export const USER_MESSAGE_FIELD = "_message";
+const USER_MESSAGE_SCHEMA_DESCRIPTION = "Short user-facing status describing what you are about to do (5-12 words, " +
+    "present continuous, e.g. \"Reading config.json\", \"Searching the web for " +
+    "AI trends\", \"Adding image generator node\"). Shown in the UI while the " +
+    "tool runs. Set this on EVERY tool call.";
 export class Tool {
+    jsonSchema;
+    /**
+     * Opt-in: when `true`, {@link StepExecutor} injects the LLM-assigned
+     * `tool_call_id` into the args under the reserved `_tool_call_id` field
+     * before calling {@link process}. Only tools that need to forward nested
+     * events (currently {@link RunSubtaskTool}) should set this.
+     */
+    needsToolCallId = false;
+    get schema() {
+        return undefined;
+    }
+    get inputSchema() {
+        if (this.schema) {
+            return zodToJsonSchema(this.schema);
+        }
+        return this.jsonSchema ?? { type: "object", properties: {} };
+    }
+    async execute(context, params, options = {}) {
+        const cleanArgs = Tool.stripMessage(params);
+        if (this.needsToolCallId && options.toolCallId) {
+            cleanArgs[TOOL_CALL_ID_FIELD] = options.toolCallId;
+        }
+        if (!this.schema) {
+            return this.process(context, cleanArgs);
+        }
+        const parsed = this.parseParams(cleanArgs);
+        if (!parsed.success) {
+            return {
+                error: "invalid_tool_arguments",
+                message: `Invalid arguments for ${this.name}: ${parsed.message}`,
+                issues: parsed.issues
+            };
+        }
+        return this.process(context, parsed.data);
+    }
+    static async executeTool(tool, context, params, options = {}) {
+        const candidate = tool;
+        if (isFunction(candidate.execute)) {
+            return candidate.execute(context, params, options);
+        }
+        const cleanArgs = Tool.stripMessage(params);
+        if (tool.needsToolCallId && options.toolCallId) {
+            cleanArgs[TOOL_CALL_ID_FIELD] = options.toolCallId;
+        }
+        return tool.process(context, cleanArgs);
+    }
     /**
      * Convert this tool to the provider tool format expected by BaseProvider.
+     *
+     * The returned schema has a `_message` string property merged in so the LLM
+     * can attach a one-line user-facing status to every call (see
+     * `USER_MESSAGE_SCHEMA_DESCRIPTION`). The field is optional — older models
+     * may omit it, in which case the per-tool `userMessage()` fallback runs.
      */
     toProviderTool() {
         return {
             name: this.name,
             description: this.description,
-            inputSchema: this.inputSchema
+            inputSchema: injectUserMessageField(this.inputSchema)
         };
     }
     /**
-     * Return a user-facing message describing this tool call.
+     * Return a user-facing message describing this tool call. Subclasses override
+     * to render parameter-aware templates (e.g. "Reading config.json"); the
+     * LLM-provided `_message` is preferred via {@link Tool.resolveMessage} when
+     * present.
      */
-    userMessage(_params) {
+    userMessage(params) {
+        const llm = Tool.extractMessage(params);
+        if (llm)
+            return llm;
         return `Running ${this.name}`;
     }
+    /**
+     * Extract the LLM-authored `_message` from a tool-call args object. Returns
+     * a trimmed string or `null` if absent / empty / wrong type.
+     */
+    static extractMessage(params) {
+        if (!params)
+            return null;
+        const raw = params[USER_MESSAGE_FIELD];
+        if (!isString(raw))
+            return null;
+        const trimmed = raw.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    /**
+     * Return a shallow copy of `params` with the reserved `_message` field
+     * removed. Use this before passing args to `tool.process()` so tools never
+     * see the protocol field.
+     */
+    static stripMessage(params) {
+        if (!params)
+            return {};
+        if (!(USER_MESSAGE_FIELD in params))
+            return params;
+        const out = { ...params };
+        delete out[USER_MESSAGE_FIELD];
+        return out;
+    }
+    /**
+     * Resolve the user-facing message for a tool call: prefer the LLM-provided
+     * `_message`, fall back to the tool's parameter-aware template.
+     */
+    static resolveMessage(tool, params) {
+        const llm = Tool.extractMessage(params ?? {});
+        if (llm)
+            return llm;
+        return tool.userMessage(Tool.stripMessage(params ?? {}));
+    }
+    parseParams(params) {
+        if (!this.schema) {
+            return { success: true, data: params };
+        }
+        try {
+            const parsed = parseWithTypeCoercion(this.schema, params);
+            if (isRecord(parsed)) {
+                return { success: true, data: parsed };
+            }
+            return {
+                success: false,
+                message: "expected an object",
+                issues: ["expected an object"]
+            };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const issues = error.issues.map((issue) => {
+                    const path = issue.path.join(".");
+                    return path ? `${path}: ${issue.message}` : issue.message;
+                });
+                return {
+                    success: false,
+                    message: issues.join("; "),
+                    issues
+                };
+            }
+            return {
+                success: false,
+                message: String(error),
+                issues: [String(error)]
+            };
+        }
+    }
+}
+function injectUserMessageField(schema) {
+    // Only object-type schemas have a `properties` map we can extend. Every tool
+    // in the codebase declares an object schema; bail out cleanly if a custom
+    // tool ever uses something exotic.
+    if (schema["type"] !== "object")
+        return schema;
+    const existingProperties = schema["properties"] ?? {};
+    if (USER_MESSAGE_FIELD in existingProperties)
+        return schema;
+    const out = {
+        ...schema,
+        properties: {
+            ...existingProperties,
+            [USER_MESSAGE_FIELD]: {
+                type: "string",
+                description: USER_MESSAGE_SCHEMA_DESCRIPTION
+            }
+        }
+    };
+    // Schemas that opt into OpenAI strict structured-output (`additionalProperties:
+    // false`) require every key in `properties` to also appear in `required`.
+    // Mirror `_message` into `required` for those tools so the provider doesn't
+    // reject the schema at upload time. For lenient schemas we keep `_message`
+    // optional so older models can omit it without a hard failure.
+    if (schema["additionalProperties"] === false) {
+        const existingRequired = Array.isArray(schema["required"])
+            ? schema["required"]
+            : [];
+        if (!existingRequired.includes(USER_MESSAGE_FIELD)) {
+            out["required"] = [...existingRequired, USER_MESSAGE_FIELD];
+        }
+    }
+    return out;
 }
 //# sourceMappingURL=base-tool.js.map

package/dist/tools/base-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-tool.js","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,OAAgB,IAAI;IAaxB;;OAEG;IACH,cAAc;QACZ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAgC;QAC1C,OAAO,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"base-tool.js","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/binary-output.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared helper for tools that produce binary output (images, audio, video,
+ * downloaded files) and need to:
+ *   1. Persist the bytes to the agent workspace so downstream tools can read
+ *      them back by their `output_file` key.
+ *   2. Push the bytes through the temp / asset storage adapter and resolve a
+ *      UI-fetchable URL so the chat UI can display the result inline instead
+ *      of echoing a `file://` path or a base64 data URI.
+ *
+ * Centralized here so download_file, generate_image, generate_speech and
+ * every other binary-producing tool follow the same pattern.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+export declare function extForMime(mime: string, fallbackName?: string): string;
+export interface PersistedBinary {
+    /** Storage key written to workspace (the same `output_file` callers passed in). */
+    output_file?: string;
+    /** UI-fetchable URL (e.g. `/api/storage/<id>.png`) when one could be resolved. */
+    asset_url?: string;
+    /** "image" | "audio" | "video" | "file" — chosen from the MIME type. */
+    kind?: "image" | "audio" | "video" | "file";
+    /**
+     * Ready-to-paste markdown that embeds `asset_url` with the right syntax for
+     * the asset kind. The chat presenter is instructed to surface this
+     * verbatim instead of synthesizing its own markdown around `output_file`
+     * (which is a workspace key, not a fetchable URL).
+     */
+    display_markdown?: string;
+    /** Per-side write errors. Set only when a write or URL resolution failed. */
+    errors?: {
+        workspace?: string;
+        asset?: string;
+    };
+}
+interface PersistBinaryOptions {
+    /** Optional workspace path. When set, bytes are also written to `context.workspace`. */
+    outputFile?: string;
+    /** MIME type for storage + UI resolution. */
+    contentType: string;
+    /** Storage prefix for the temp adapter copy (e.g. `images`, `audio`, `downloads`). */
+    uiPrefix?: string;
+}
+/**
+ * Persist binary tool output and produce both a workspace key (for downstream
+ * tools to read) and a UI-fetchable URL (for chat rendering).
+ *
+ * Either side may be unavailable: if no `outputFile` is supplied or no
+ * workspace storage is wired, only `asset_url` is returned. If no asset
+ * storage is wired, only `output_file` is returned. Tools should treat both
+ * fields as optional.
+ */
+export declare function persistBinaryOutput(context: ProcessingContext, bytes: Uint8Array, opts: PersistBinaryOptions): Promise<PersistedBinary>;
+export {};
+//# sourceMappingURL=binary-output.d.ts.map

package/dist/tools/binary-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-output.d.ts","sourceRoot":"","sources":["../../src/tools/binary-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAoB9D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AA6CD,UAAU,oBAAoB;IAC5B,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,eAAe,CAAC,CAsD1B"}

package/dist/tools/binary-output.js

@@ -0,0 +1,127 @@
+/**
+ * Shared helper for tools that produce binary output (images, audio, video,
+ * downloaded files) and need to:
+ *   1. Persist the bytes to the agent workspace so downstream tools can read
+ *      them back by their `output_file` key.
+ *   2. Push the bytes through the temp / asset storage adapter and resolve a
+ *      UI-fetchable URL so the chat UI can display the result inline instead
+ *      of echoing a `file://` path or a base64 data URI.
+ *
+ * Centralized here so download_file, generate_image, generate_speech and
+ * every other binary-producing tool follow the same pattern.
+ */
+import { extname } from "node:path";
+import { randomUUID } from "node:crypto";
+const MIME_TO_EXT = {
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/gif": "gif",
+    "image/webp": "webp",
+    "image/bmp": "bmp",
+    "image/svg+xml": "svg",
+    "audio/mpeg": "mp3",
+    "audio/mp3": "mp3",
+    "audio/wav": "wav",
+    "audio/ogg": "ogg",
+    "audio/aac": "aac",
+    "video/mp4": "mp4",
+    "video/webm": "webm",
+    "application/pdf": "pdf",
+    "model/gltf-binary": "glb"
+};
+export function extForMime(mime, fallbackName) {
+    const m = mime.split(";")[0].trim().toLowerCase();
+    if (MIME_TO_EXT[m])
+        return MIME_TO_EXT[m];
+    if (fallbackName) {
+        const ext = extname(fallbackName).replace(/^\./, "");
+        if (ext)
+            return ext;
+    }
+    return "bin";
+}
+function kindForMime(mime) {
+    const m = mime.split(";")[0].trim().toLowerCase();
+    if (m.startsWith("image/"))
+        return "image";
+    if (m.startsWith("audio/"))
+        return "audio";
+    if (m.startsWith("video/"))
+        return "video";
+    return "file";
+}
+function htmlAttrEscape(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function urlForMarkdown(url) {
+    // `(`, `)`, ` `, `<`, `>` can prematurely terminate a markdown link target.
+    return url.replace(/[()\s<>]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0")}`);
+}
+function buildDisplayMarkdown(url, kind, label) {
+    const safeLabel = label.replace(/[[\]]/g, "");
+    switch (kind) {
+        case "image":
+            return `![${safeLabel}](${urlForMarkdown(url)})`;
+        case "audio":
+            return `<audio controls src="${htmlAttrEscape(url)}"></audio>`;
+        case "video":
+            return `<video controls src="${htmlAttrEscape(url)}"></video>`;
+        default:
+            return `[${safeLabel}](${urlForMarkdown(url)})`;
+    }
+}
+/**
+ * Persist binary tool output and produce both a workspace key (for downstream
+ * tools to read) and a UI-fetchable URL (for chat rendering).
+ *
+ * Either side may be unavailable: if no `outputFile` is supplied or no
+ * workspace storage is wired, only `asset_url` is returned. If no asset
+ * storage is wired, only `output_file` is returned. Tools should treat both
+ * fields as optional.
+ */
+export async function persistBinaryOutput(context, bytes, opts) {
+    const result = {};
+    const errors = {};
+    // Workspace copy — read by downstream tools that take `output_file`.
+    if (opts.outputFile && context.workspace) {
+        try {
+            await context.workspace.write(opts.outputFile, bytes, opts.contentType);
+            result.output_file = opts.outputFile;
+        }
+        catch (e) {
+            errors.workspace = e instanceof Error ? e.message : String(e);
+        }
+    }
+    // UI URL copy — written through the temp / asset adapter so the chat UI
+    // can fetch it. Without this, callers either echo a file:// path (which
+    // the UI can't render) or inline base64 bytes (which the LLM presenter
+    // dutifully echoes back as a giant data URI in markdown).
+    if (context.storage) {
+        try {
+            const ext = extForMime(opts.contentType, opts.outputFile);
+            const prefix = opts.uiPrefix ?? "outputs";
+            const key = `${prefix}/${randomUUID()}.${ext}`;
+            const storageUri = await context.storage.store(key, bytes, opts.contentType);
+            result.asset_url = await context.resolveTempUrl(storageUri);
+        }
+        catch (e) {
+            errors.asset = e instanceof Error ? e.message : String(e);
+        }
+    }
+    if (result.asset_url) {
+        const kind = kindForMime(opts.contentType);
+        const label = opts.outputFile ?? kind;
+        result.kind = kind;
+        result.display_markdown = buildDisplayMarkdown(result.asset_url, kind, label);
+    }
+    if (errors.workspace || errors.asset) {
+        result.errors = errors;
+    }
+    return result;
+}
+//# sourceMappingURL=binary-output.js.map

package/dist/tools/binary-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-output.js","sourceRoot":"","sources":["../../src/tools/binary-output.ts"],"names":[],"mappings":"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"}

package/dist/tools/browser-tools.d.ts

@@ -1,32 +1,8 @@
 /**
- * Browser interaction tools.
- *
- * Port of src/nodetool/agents/tools/browser_tools.py (BrowserTool & ScreenshotTool)
+ * What survives of the two browser tools after the port to the `web`
+ * capability module (`../capabilities/web.ts`): the HTML-to-text helper other
+ * code calls directly. `browser` and `take_screenshot` reach a belt through
+ * the registry now, by name.
  */
-import type { ProcessingContext } from "@nodetool-ai/runtime";
-import { Tool } from "./base-tool.js";
-/**
- * Convert raw HTML to readable plain text.
- *
- * - Strips `<script>` and `<style>` blocks
- * - Removes remaining HTML tags
- * - Decodes common HTML entities and numeric character references
- * - Collapses whitespace
- * - Truncates to `maxLength` characters
- */
-export declare function htmlToText(html: string, maxLength?: number): string;
-export declare class BrowserTool extends Tool {
-    readonly name = "browser";
-    readonly description = "Fetch content from a web page";
-    readonly inputSchema: Record<string, unknown>;
-    userMessage(params: Record<string, unknown>): string;
-    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-}
-export declare class ScreenshotTool extends Tool {
-    readonly name = "take_screenshot";
-    readonly description = "Take a screenshot of a web page. Requires a remote browser service (BROWSER_URL).";
-    readonly inputSchema: Record<string, unknown>;
-    userMessage(params: Record<string, unknown>): string;
-    process(_context: ProcessingContext, params: Record<string, unknown>): Promise<unknown>;
-}
+export { htmlToText } from "../capabilities/web.js";
 //# sourceMappingURL=browser-tools.d.ts.map

package/dist/tools/browser-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../src/tools/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAuBtC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,MAAM,CAmCnE;AA0BD,qBAAa,WAAY,SAAQ,IAAI;IACnC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,mCAAmC;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS3C;IAEF,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAM9C,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAoDpB;AAMD,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,uFACkE;IACtF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc3C;IAEF,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAS9C,OAAO,CACX,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAuCpB"}
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../src/tools/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}