@polpo-ai/tools 0.7.18 → 0.8.0

package/dist/__tests__/custom-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=custom-tools.test.d.ts.map

package/dist/__tests__/custom-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/custom-tools.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/custom-tools.test.js

@@ -0,0 +1,253 @@
+/**
+ * Phase 1 of defineTool — the pure-logic foundation (no sandbox, no API):
+ *   - defineTool()           authoring helper → CustomTool + __custom marker
+ *   - getCustomToolErrors()  shape/name validation (reused by the cloud API)
+ *   - isCustomTool()         type guard
+ *   - normalizeToolResult()  string | ToolResult → ToolResult
+ *   - bindCustomTool()       wrap a CustomTool into a runtime PolpoTool (ctx injection)
+ *   - extractCustomTool()    find the tool in a (bundled) module's exports
+ *   - loadCustomToolBundle() import a bundle file + bind → PolpoTool (self-host path)
+ *
+ * Test-first: these encode the contract before the implementation exists.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { Type } from "@sinclair/typebox";
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { defineTool, getCustomToolErrors, isCustomTool, normalizeToolResult, bindCustomTool, extractCustomTool, loadCustomToolBundle, } from "../custom-tools.js";
+/** Minimal ctx — bindCustomTool only passes it through, so stubs suffice. */
+function fakeCtx(overrides = {}) {
+    return {
+        fs: { marker: "fs" },
+        shell: { marker: "shell" },
+        vault: { marker: "vault" },
+        env: { FOO: "bar" },
+        workDir: "/work",
+        polpo: { marker: "polpo" },
+        ...overrides,
+    };
+}
+const EchoSchema = Type.Object({ msg: Type.String() });
+describe("defineTool", () => {
+    it("returns the spec with the __custom marker", () => {
+        const tool = defineTool({
+            name: "echo",
+            description: "Echoes input",
+            parameters: EchoSchema,
+            execute: (_ctx, params) => `echo: ${params.msg}`,
+        });
+        expect(tool.__custom).toBe(true);
+        expect(tool.name).toBe("echo");
+        expect(tool.description).toBe("Echoes input");
+        expect(tool.parameters).toBe(EchoSchema);
+        expect(typeof tool.execute).toBe("function");
+    });
+    it("preserves optional label and clientSide", () => {
+        const tool = defineTool({
+            name: "echo",
+            label: "Echo Machine",
+            clientSide: true,
+            description: "d",
+            parameters: EchoSchema,
+            execute: () => "ok",
+        });
+        expect(tool.label).toBe("Echo Machine");
+        expect(tool.clientSide).toBe(true);
+    });
+});
+describe("getCustomToolErrors / isCustomTool", () => {
+    const valid = defineTool({
+        name: "do_thing",
+        description: "Does a thing",
+        parameters: EchoSchema,
+        execute: () => "ok",
+    });
+    it("accepts a valid tool", () => {
+        expect(getCustomToolErrors(valid)).toEqual([]);
+        expect(isCustomTool(valid)).toBe(true);
+    });
+    it("rejects non-objects", () => {
+        expect(getCustomToolErrors(null).length).toBeGreaterThan(0);
+        expect(getCustomToolErrors("nope").length).toBeGreaterThan(0);
+        expect(isCustomTool(null)).toBe(false);
+    });
+    it("requires a name", () => {
+        expect(getCustomToolErrors({ ...valid, name: "" }).join()).toMatch(/name/i);
+    });
+    it("enforces snake_case names", () => {
+        for (const bad of ["Echo", "my tool", "1tool", "my-tool", "MY_TOOL"]) {
+            expect(getCustomToolErrors({ ...valid, name: bad }).join()).toMatch(/snake_case|name/i);
+        }
+        for (const ok of ["echo", "do_thing", "get_user_v2", "a1_b2"]) {
+            expect(getCustomToolErrors({ ...valid, name: ok })).toEqual([]);
+        }
+    });
+    it("requires description, parameters and execute", () => {
+        expect(getCustomToolErrors({ ...valid, description: "  " }).join()).toMatch(/description/i);
+        expect(getCustomToolErrors({ ...valid, parameters: undefined }).join()).toMatch(/parameters/i);
+        expect(getCustomToolErrors({ ...valid, execute: "x" }).join()).toMatch(/execute/i);
+    });
+    it("validates optional field types", () => {
+        expect(getCustomToolErrors({ ...valid, label: 5 }).join()).toMatch(/label/i);
+        expect(getCustomToolErrors({ ...valid, clientSide: "yes" }).join()).toMatch(/clientSide/i);
+    });
+    it("isCustomTool requires the __custom marker", () => {
+        const { __custom, ...withoutMarker } = valid;
+        expect(isCustomTool(withoutMarker)).toBe(false);
+    });
+});
+describe("normalizeToolResult", () => {
+    it("wraps a plain string into a text ToolResult", () => {
+        expect(normalizeToolResult("hello")).toEqual({
+            content: [{ type: "text", text: "hello" }],
+            details: null,
+        });
+    });
+    it("passes a well-formed ToolResult through unchanged", () => {
+        const r = { content: [{ type: "text", text: "x" }], details: { a: 1 } };
+        expect(normalizeToolResult(r)).toBe(r);
+    });
+    it("stringifies unexpected return values as a fallback", () => {
+        const out = normalizeToolResult({ foo: 1 });
+        expect(out.content[0]).toEqual({ type: "text", text: JSON.stringify({ foo: 1 }) });
+    });
+});
+describe("bindCustomTool", () => {
+    let tool;
+    beforeEach(() => {
+        tool = defineTool({
+            name: "echo",
+            description: "Echoes input",
+            parameters: EchoSchema,
+            execute: (_ctx, params) => `echo: ${params.msg}`,
+        });
+    });
+    it("produces a PolpoTool with name/label/description/parameters", () => {
+        const pt = bindCustomTool(tool, fakeCtx());
+        expect(pt.name).toBe("echo");
+        expect(pt.label).toBe("echo"); // defaults to name
+        expect(pt.description).toBe("Echoes input");
+        expect(pt.parameters).toBe(EchoSchema);
+        expect(typeof pt.execute).toBe("function");
+    });
+    it("defaults label to name, honors explicit label", () => {
+        expect(bindCustomTool(tool, fakeCtx()).label).toBe("echo");
+        const labeled = bindCustomTool({ ...tool, label: "Echo!" }, fakeCtx());
+        expect(labeled.label).toBe("Echo!");
+    });
+    it("runs execute with the injected ctx and normalizes a string result", async () => {
+        const pt = bindCustomTool(tool, fakeCtx());
+        const res = await pt.execute("call-1", { msg: "hi" });
+        expect(res).toEqual({ content: [{ type: "text", text: "echo: hi" }], details: null });
+    });
+    it("injects the full ctx (fs/shell/vault/env/workDir/polpo) plus signal & onUpdate", async () => {
+        let received;
+        const t = defineTool({
+            name: "spy",
+            description: "captures ctx",
+            parameters: EchoSchema,
+            execute: (ctx) => {
+                received = ctx;
+                return "ok";
+            },
+        });
+        const ctrl = new AbortController();
+        const onUpdate = () => { };
+        const pt = bindCustomTool(t, fakeCtx());
+        await pt.execute("c", { msg: "x" }, ctrl.signal, onUpdate);
+        expect(received.fs).toEqual({ marker: "fs" });
+        expect(received.shell).toEqual({ marker: "shell" });
+        expect(received.vault).toEqual({ marker: "vault" });
+        expect(received.env).toEqual({ FOO: "bar" });
+        expect(received.workDir).toBe("/work");
+        expect(received.polpo).toEqual({ marker: "polpo" });
+        expect(received.signal).toBe(ctrl.signal);
+        expect(received.onUpdate).toBe(onUpdate);
+    });
+    it("passes a ToolResult return value through unchanged", async () => {
+        const t = defineTool({
+            name: "rich",
+            description: "rich result",
+            parameters: EchoSchema,
+            execute: () => ({ content: [{ type: "text", text: "rich" }], details: { ok: true } }),
+        });
+        const res = await bindCustomTool(t, fakeCtx()).execute("c", { msg: "x" });
+        expect(res.details).toEqual({ ok: true });
+    });
+    it("propagates errors thrown inside execute", async () => {
+        const t = defineTool({
+            name: "boom",
+            description: "throws",
+            parameters: EchoSchema,
+            execute: () => {
+                throw new Error("kaboom");
+            },
+        });
+        await expect(bindCustomTool(t, fakeCtx()).execute("c", { msg: "x" })).rejects.toThrow("kaboom");
+    });
+});
+describe("extractCustomTool", () => {
+    const tool = defineTool({
+        name: "echo",
+        description: "d",
+        parameters: EchoSchema,
+        execute: () => "ok",
+    });
+    it("finds a tool passed directly", () => {
+        expect(extractCustomTool(tool)).toBe(tool);
+    });
+    it("finds a default export", () => {
+        expect(extractCustomTool({ default: tool })).toBe(tool);
+    });
+    it("finds a nested default (esbuild interop)", () => {
+        expect(extractCustomTool({ default: { default: tool } })).toBe(tool);
+    });
+    it("finds a named export", () => {
+        expect(extractCustomTool({ myTool: tool })).toBe(tool);
+    });
+    it("throws a helpful error when no tool is present", () => {
+        expect(() => extractCustomTool({ foo: 1 })).toThrow(/no custom tool|export default/i);
+    });
+    it("surfaces validation errors for a near-miss default export", () => {
+        const broken = { __custom: true, name: "Bad Name", description: "d", parameters: EchoSchema, execute: () => "x" };
+        expect(() => extractCustomTool({ default: broken })).toThrow(/snake_case|invalid/i);
+    });
+});
+describe("loadCustomToolBundle", () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), "polpo-tool-"));
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("imports a bundle file, binds ctx, and runs", async () => {
+        const file = join(dir, "echo.mjs");
+        await writeFile(file, `export default {
+        __custom: true,
+        name: "echo",
+        label: "Echo",
+        description: "echoes",
+        parameters: { type: "object", properties: { msg: { type: "string" } } },
+        execute: async (ctx, params) => "echo: " + params.msg + " @ " + ctx.workDir,
+      };`);
+        const pt = await loadCustomToolBundle(file, fakeCtx({ workDir: "/sandbox" }));
+        expect(pt.name).toBe("echo");
+        expect(pt.label).toBe("Echo");
+        const res = await pt.execute("c", { msg: "hi" });
+        expect(res.content[0]).toEqual({ type: "text", text: "echo: hi @ /sandbox" });
+    });
+    it("accepts an already-imported module object", async () => {
+        const tool = defineTool({ name: "echo", description: "d", parameters: EchoSchema, execute: () => "ok" });
+        const pt = await loadCustomToolBundle({ default: tool }, fakeCtx());
+        expect(pt.name).toBe("echo");
+        expect((await pt.execute("c", { msg: "x" })).content[0]).toEqual({ type: "text", text: "ok" });
+    });
+    it("rejects a bundle with no valid tool", async () => {
+        const file = join(dir, "bad.mjs");
+        await writeFile(file, `export const notATool = 42;`);
+        await expect(loadCustomToolBundle(file, fakeCtx())).rejects.toThrow(/no custom tool|export default/i);
+    });
+});
+//# sourceMappingURL=custom-tools.test.js.map

package/dist/__tests__/custom-tools.test.js.map

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

package/dist/custom-tools.d.ts

@@ -0,0 +1,105 @@
+/**
+ * defineTool — native custom tools (Phase 1: authoring + validation + binding).
+ *
+ * Devs author a tool with capability-injected `ctx` (no ambient globals):
+ *
+ *   export default defineTool({
+ *     name: "create_invoice",
+ *     description: "Create an invoice for a customer",
+ *     parameters: Type.Object({ customerId: Type.String(), amount: Type.Number() }),
+ *     async execute(ctx, params) {
+ *       const res = await ctx.polpo.invoices.create(params);
+ *       return `Created invoice ${res.id}`;
+ *     },
+ *   });
+ *
+ * At runtime the cloud bundles + executes this inside the per-project sandbox
+ * (Phases 2–3); for OSS self-host it runs in-process via {@link loadCustomToolBundle}.
+ * Both paths converge on {@link bindCustomTool}, which adapts the ctx-based
+ * `execute(ctx, params)` to the standard {@link PolpoTool} signature.
+ */
+import type { TSchema, Static } from "@sinclair/typebox";
+import type { FileSystem } from "@polpo-ai/core/filesystem";
+import type { Shell } from "@polpo-ai/core/shell";
+import type { PolpoTool, ToolResult, ToolUpdateCallback } from "@polpo-ai/core";
+import type { ResolvedVault } from "./types.js";
+/**
+ * Capabilities injected into a custom tool's `execute`. Everything a tool can
+ * touch arrives here — there are no ambient globals or platform env access.
+ */
+export interface CustomToolContext {
+    /** Sandboxed filesystem rooted at the project workspace. */
+    fs: FileSystem;
+    /** Shell for running commands in the workspace. */
+    shell: Shell;
+    /** Agent vault — resolved credentials (API keys, SMTP, …). */
+    vault: ResolvedVault;
+    /** Safe environment variables (platform secrets stripped). */
+    env: Record<string, string | undefined>;
+    /** Absolute working directory inside the workspace. */
+    workDir: string;
+    /** Preconfigured Polpo SDK client, scoped to the project. Typed loosely in v1. */
+    polpo?: unknown;
+    /** Abort signal for this tool call. */
+    signal?: AbortSignal;
+    /** Stream partial results back to the runtime. */
+    onUpdate?: ToolUpdateCallback;
+}
+/** A custom tool's return value — a plain string (wrapped as text) or a full ToolResult. */
+export type CustomToolExecuteResult = string | ToolResult;
+/** The object passed to {@link defineTool}. */
+export interface CustomToolSpec<T extends TSchema = TSchema> {
+    /** Unique, snake_case identifier exposed to the model. */
+    name: string;
+    /** What the tool does — shown to the model. */
+    description: string;
+    /** TypeBox schema for the tool arguments. */
+    parameters: T;
+    /** Human-friendly label for UIs. Defaults to `name`. */
+    label?: string;
+    /** Run on the client instead of the sandbox (plumbed in a later phase). */
+    clientSide?: boolean;
+    /** Tool body. Receives injected capabilities + validated params. */
+    execute: (ctx: CustomToolContext, params: Static<T>) => CustomToolExecuteResult | Promise<CustomToolExecuteResult>;
+}
+/** A defined custom tool — a {@link CustomToolSpec} tagged with the `__custom` marker. */
+export interface CustomTool<T extends TSchema = TSchema> extends CustomToolSpec<T> {
+    readonly __custom: true;
+}
+/**
+ * Authoring helper. Returns the spec tagged with `__custom: true` so the loader
+ * and the cloud registry can recognize it. Pure — no side effects.
+ */
+export declare function defineTool<T extends TSchema>(spec: CustomToolSpec<T>): CustomTool<T>;
+/**
+ * Validate a candidate tool's shape. Returns human-readable error strings
+ * (empty array = valid). Reused by the loader and the cloud `POST /v1/tools`
+ * endpoint so authors get identical feedback in the CLI, dashboard and at load.
+ */
+export declare function getCustomToolErrors(value: unknown): string[];
+/** Type guard: a valid custom tool carrying the `__custom` marker. */
+export declare function isCustomTool(value: unknown): value is CustomTool;
+/** Coerce a custom tool's return value into a {@link ToolResult}. */
+export declare function normalizeToolResult(result: CustomToolExecuteResult): ToolResult;
+/** ctx without the per-call fields, which {@link bindCustomTool} supplies itself. */
+export type CustomToolBindContext = Omit<CustomToolContext, "signal" | "onUpdate">;
+/**
+ * Adapt a {@link CustomTool} (ctx-based `execute`) into a runtime {@link PolpoTool}
+ * (`execute(toolCallId, params, signal?, onUpdate?)`), binding the injected ctx.
+ * This is the "wrap at registration" step that lets custom and built-in tools
+ * coexist without touching the built-ins.
+ */
+export declare function bindCustomTool<T extends TSchema>(tool: CustomTool<T>, ctx: CustomToolBindContext): PolpoTool<T>;
+/**
+ * Find the custom tool inside a (possibly bundled) module's exports. Accepts a
+ * tool passed directly, a default export, a nested default (esbuild interop),
+ * or the first matching named export. Throws a helpful error otherwise.
+ */
+export declare function extractCustomTool(moduleOrTool: unknown): CustomTool;
+/**
+ * Load a custom tool bundle and bind it to a runtime ctx → {@link PolpoTool}.
+ * Accepts either a filesystem path to a bundled module (dynamic import — the
+ * OSS self-host path) or an already-imported module/tool object.
+ */
+export declare function loadCustomToolBundle(pathOrModule: string | object, ctx: CustomToolBindContext): Promise<PolpoTool>;
+//# sourceMappingURL=custom-tools.d.ts.map

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

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

package/dist/custom-tools.js

@@ -0,0 +1,121 @@
+import { pathToFileURL } from "node:url";
+/** snake_case: lowercase letter start, then lowercase / digits / underscores. */
+const NAME_RE = /^[a-z][a-z0-9_]*$/;
+/**
+ * Authoring helper. Returns the spec tagged with `__custom: true` so the loader
+ * and the cloud registry can recognize it. Pure — no side effects.
+ */
+export function defineTool(spec) {
+    return { ...spec, __custom: true };
+}
+/**
+ * Validate a candidate tool's shape. Returns human-readable error strings
+ * (empty array = valid). Reused by the loader and the cloud `POST /v1/tools`
+ * endpoint so authors get identical feedback in the CLI, dashboard and at load.
+ */
+export function getCustomToolErrors(value) {
+    if (typeof value !== "object" || value === null) {
+        return ["Tool must be an object (did you `export default defineTool({...})`?)"];
+    }
+    const t = value;
+    const errors = [];
+    if (typeof t.name !== "string" || t.name.length === 0) {
+        errors.push("`name` is required and must be a non-empty string");
+    }
+    else if (!NAME_RE.test(t.name)) {
+        errors.push(`\`name\` must be snake_case (lowercase letters, digits, underscores; starting with a letter): got "${t.name}"`);
+    }
+    if (typeof t.description !== "string" || t.description.trim().length === 0) {
+        errors.push("`description` is required and must be a non-empty string");
+    }
+    if (typeof t.parameters !== "object" || t.parameters === null) {
+        errors.push("`parameters` is required and must be a TypeBox schema object");
+    }
+    if (typeof t.execute !== "function") {
+        errors.push("`execute` is required and must be a function `(ctx, params) => result`");
+    }
+    if (t.label !== undefined && typeof t.label !== "string") {
+        errors.push("`label` must be a string when provided");
+    }
+    if (t.clientSide !== undefined && typeof t.clientSide !== "boolean") {
+        errors.push("`clientSide` must be a boolean when provided");
+    }
+    return errors;
+}
+/** Type guard: a valid custom tool carrying the `__custom` marker. */
+export function isCustomTool(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__custom === true &&
+        getCustomToolErrors(value).length === 0);
+}
+/** Coerce a custom tool's return value into a {@link ToolResult}. */
+export function normalizeToolResult(result) {
+    if (typeof result === "string") {
+        return { content: [{ type: "text", text: result }], details: null };
+    }
+    if (result &&
+        typeof result === "object" &&
+        Array.isArray(result.content)) {
+        return result;
+    }
+    // Lenient fallback: a tool returned something unexpected — surface it as text
+    // rather than crashing the run.
+    return { content: [{ type: "text", text: JSON.stringify(result) }], details: result ?? null };
+}
+/**
+ * Adapt a {@link CustomTool} (ctx-based `execute`) into a runtime {@link PolpoTool}
+ * (`execute(toolCallId, params, signal?, onUpdate?)`), binding the injected ctx.
+ * This is the "wrap at registration" step that lets custom and built-in tools
+ * coexist without touching the built-ins.
+ */
+export function bindCustomTool(tool, ctx) {
+    return {
+        name: tool.name,
+        label: tool.label ?? tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+        async execute(_toolCallId, params, signal, onUpdate) {
+            const result = await tool.execute({ ...ctx, signal, onUpdate }, params);
+            return normalizeToolResult(result);
+        },
+    };
+}
+/**
+ * Find the custom tool inside a (possibly bundled) module's exports. Accepts a
+ * tool passed directly, a default export, a nested default (esbuild interop),
+ * or the first matching named export. Throws a helpful error otherwise.
+ */
+export function extractCustomTool(moduleOrTool) {
+    if (isCustomTool(moduleOrTool))
+        return moduleOrTool;
+    if (typeof moduleOrTool === "object" && moduleOrTool !== null) {
+        const mod = moduleOrTool;
+        const nestedDefault = mod.default?.default;
+        const candidates = [mod.default, nestedDefault, ...Object.values(mod)];
+        for (const c of candidates) {
+            if (isCustomTool(c))
+                return c;
+        }
+        // Near-miss: a __custom-tagged export that failed validation → surface why.
+        const near = candidates.find((c) => typeof c === "object" && c !== null && c.__custom === true);
+        if (near) {
+            const errs = getCustomToolErrors(near);
+            throw new Error(`Invalid custom tool:\n- ${errs.join("\n- ")}`);
+        }
+    }
+    throw new Error("No custom tool found in module. Expected `export default defineTool({...})`.");
+}
+/**
+ * Load a custom tool bundle and bind it to a runtime ctx → {@link PolpoTool}.
+ * Accepts either a filesystem path to a bundled module (dynamic import — the
+ * OSS self-host path) or an already-imported module/tool object.
+ */
+export async function loadCustomToolBundle(pathOrModule, ctx) {
+    const mod = typeof pathOrModule === "string"
+        ? await import(pathToFileURL(pathOrModule).href)
+        : pathOrModule;
+    const tool = extractCustomTool(mod);
+    return bindCustomTool(tool, ctx);
+}
+//# sourceMappingURL=custom-tools.js.map

package/dist/custom-tools.js.map

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

package/dist/index.d.ts

@@ -31,5 +31,7 @@ export { NodeShell } from "./adapters/node-shell.js";
 export { assertPathAllowed, resolveAllowedPaths, isPathAllowed } from "./path-sandbox.js";
 export { safeEnv, bashSafeEnv } from "./safe-env.js";
 export { assertUrlAllowed } from "./ssrf-guard.js";
+export { defineTool, getCustomToolErrors, isCustomTool, normalizeToolResult, bindCustomTool, extractCustomTool, loadCustomToolBundle, } from "./custom-tools.js";
+export type { CustomTool, CustomToolSpec, CustomToolContext, CustomToolBindContext, CustomToolExecuteResult, } from "./custom-tools.js";
 export type { ResolvedVault } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnK,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnK,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -36,4 +36,6 @@ export { NodeShell } from "./adapters/node-shell.js";
 export { assertPathAllowed, resolveAllowedPaths, isPathAllowed } from "./path-sandbox.js";
 export { safeEnv, bashSafeEnv } from "./safe-env.js";
 export { assertUrlAllowed } from "./ssrf-guard.js";
+// Custom tools (defineTool)
+export { defineTool, getCustomToolErrors, isCustomTool, normalizeToolResult, bindCustomTool, extractCustomTool, loadCustomToolBundle, } from "./custom-tools.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnK,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,0DAA0D;AAC1D,0CAA0C;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnK,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,0DAA0D;AAC1D,0CAA0C;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/tools",
-  "version": "0.7.18",
+  "version": "0.8.0",
   "description": "Agent tools for Polpo — coding, browser, email, search, and more. Core tools work everywhere, extended tools are opt-in.",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@sinclair/typebox": "^0.34.0",
     "nanoid": "^5.0.0",
-    "@polpo-ai/core": "0.7.18"
+    "@polpo-ai/core": "0.8.0"
   },
   "optionalDependencies": {
     "@ai-sdk/anthropic": "^2.0.79",