orbitx 0.0.8 → 0.0.9

package/dist/core/mcp-rng.js

@@ -0,0 +1,14 @@
+/* MCP RNG Generate unique cross reference hex numbers shared with tools and guaranty tools never use duplicate id */
+export default class MCPRNG {
+    #storage;
+    constructor(storage) {
+        this.#storage = storage;
+    }
+    async getRNG() {
+        const current = await this.#storage.get("__RNG__");
+        const rng = current ? Number(current) : 0;
+        await this.#storage.set("__RNG__", (rng + 1).toString());
+        return `0x${rng.toString(16)}`;
+    }
+}
+//# sourceMappingURL=mcp-rng.js.map

package/dist/core/mcp-rng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-rng.js","sourceRoot":"","sources":["../../src/core/mcp-rng.ts"],"names":[],"mappings":"AAGA,qHAAqH;AACrH,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,QAAQ,CAAa;IAErB,YAAY,OAAmB;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM;QACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,OAAO,KAAK,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;CACJ"}

package/dist/core/mcp-server.d.ts

@@ -1,9 +1,13 @@
-import type MCPTool from "./mcp.js";
+import { MCP, type MCPTool } from "./mcp.js";
 import type MCPConnection from "./mcp-connection.js";
-export declare class MCPServer {
+import type MCPStorage from "./mcp-storage.js";
+import MCPRNG from "./mcp-rng.js";
+export declare class MCPServer extends MCP {
     #private;
-    constructor(connection: MCPConnection);
-    registerTool(tool: MCPTool): void;
+    constructor(connection: MCPConnection, storage?: MCPStorage, rng?: MCPRNG);
+    getStorage(): MCPStorage;
+    getRNG(): MCPRNG;
+    registerTool(tool: MCPTool<any>): void;
 }
 export default MCPServer;
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/core/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AAErD,qBAAa,SAAS;;gBAGN,UAAU,EAAE,aAAa;IAqCrC,YAAY,CAAC,IAAI,EAAE,OAAO;CAG7B;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAE/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,qBAAa,SAAU,SAAQ,GAAG;;gBAKlB,UAAU,EAAE,aAAa,EAAE,OAAO,GAAE,UAA+B,EAAE,GAAG,CAAC,EAAE,MAAM;IA0C7F,UAAU;IAIV,MAAM;IAIN,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;CAIlC;AAED,eAAe,SAAS,CAAC"}

package/dist/core/mcp-server.js

@@ -1,8 +1,18 @@
-export class MCPServer {
+import { MCP } from "./mcp.js";
+import MCPFSStorage from "./mcp-fs-storage.js";
+import MCPRNG from "./mcp-rng.js";
+export class MCPServer extends MCP {
     #connection;
+    #storage;
+    #rng;
     #tools = [];
-    constructor(connection) {
+    constructor(connection, storage = new MCPFSStorage(), rng) {
+        super();
         this.#connection = connection;
+        this.#storage = storage;
+        if (!rng)
+            rng = new MCPRNG(storage);
+        this.#rng = rng;
         this.#connection.on("read", (data) => {
             const topic = data.topic;
             const pid = data.pid;
@@ -20,7 +30,7 @@ export class MCPServer {
             if (topic == "toolCall") {
                 const tool = this.#tools.find(t => t.getOptions().name == data.tool);
                 if (tool) {
-                    tool.getOptions().execute(data.envID, data.inputs).then((response) => {
+                    tool.getOptions().execute(data.envID, data.inputs, tool.getMCP(), tool.getOptions().customClass).then((response) => {
                         this.#connection.emit("write", {
                             pid,
                             topic: "toolCallCallback",
@@ -37,7 +47,14 @@ export class MCPServer {
             }
         });
     }
+    getStorage() {
+        return this.#storage;
+    }
+    getRNG() {
+        return this.#rng;
+    }
     registerTool(tool) {
+        tool.setMCP(this);
         this.#tools.push(tool);
     }
 }

package/dist/core/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IAClB,WAAW,CAAC;IACZ,MAAM,GAAc,EAAE,CAAC;IACvB,YAAY,UAAyB;QACjC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAS,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACrB,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC3B,GAAG;oBACH,KAAK,EAAE,kBAAkB;oBACzB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC5B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI;wBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW;wBAC1C,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM;qBACnC,CAAC,CAAC;iBACN,CAAC,CAAC;YACP,CAAC;YACD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrE,IAAI,IAAI,EAAE,CAAC;oBACP,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACjE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;4BAC3B,GAAG;4BACH,KAAK,EAAE,kBAAkB;4BACzB,MAAM,EAAE,QAAQ;yBACnB,CAAC,CAAC;oBACP,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;wBACb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;4BAC3B,GAAG;4BACH,KAAK,EAAE,kBAAkB;4BACzB,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;yBACnC,CAAC,CAAC;oBACP,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED,YAAY,CAAC,IAAa;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACJ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAgB,MAAM,UAAU,CAAC;AAG7C,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,MAAM,OAAO,SAAU,SAAQ,GAAG;IAC9B,WAAW,CAAC;IACZ,QAAQ,CAAC;IACT,IAAI,CAAC;IACL,MAAM,GAAmB,EAAE,CAAC;IAC5B,YAAY,UAAyB,EAAE,UAAsB,IAAI,YAAY,EAAE,EAAE,GAAY;QACzF,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,GAAG;YACJ,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAS,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACrB,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC3B,GAAG;oBACH,KAAK,EAAE,kBAAkB;oBACzB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC5B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI;wBAC5B,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW;wBAC1C,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM;qBACnC,CAAC,CAAC;iBACN,CAAC,CAAC;YACP,CAAC;YACD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrE,IAAI,IAAI,EAAE,CAAC;oBACP,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBAC/G,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;4BAC3B,GAAG;4BACH,KAAK,EAAE,kBAAkB;4BACzB,MAAM,EAAE,QAAQ;yBACnB,CAAC,CAAC;oBACP,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;wBACb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE;4BAC3B,GAAG;4BACH,KAAK,EAAE,kBAAkB;4BACzB,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;yBACnC,CAAC,CAAC;oBACP,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,YAAY,CAAC,IAAkB;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACJ;AAED,eAAe,SAAS,CAAC"}

package/dist/core/mcp-storage.d.ts

@@ -0,0 +1,5 @@
+export default abstract class MCPStorage {
+    abstract get(key: string): Promise<string>;
+    abstract set(key: string, value: string): Promise<void>;
+}
+//# sourceMappingURL=mcp-storage.d.ts.map

package/dist/core/mcp-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-storage.d.ts","sourceRoot":"","sources":["../../src/core/mcp-storage.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,UAAU;IACpC,QAAQ,CAAC,GAAG,CACR,GAAG,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;IAElB,QAAQ,CAAC,GAAG,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;CACnB"}

package/dist/core/mcp-storage.js

@@ -0,0 +1,3 @@
+export default class MCPStorage {
+}
+//# sourceMappingURL=mcp-storage.js.map

package/dist/core/mcp-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-storage.js","sourceRoot":"","sources":["../../src/core/mcp-storage.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAgB,UAAU;CASvC"}

package/dist/core/mcp.d.ts

@@ -1,4 +1,32 @@
-export declare class MCPTool {
+import EventEmitter from "events";
+import type MCPRNG from "./mcp-rng.js";
+import type MCPStorage from "./mcp-storage.js";
+export type MCPToolOutput = {
+    type: "text";
+    output: Record<string, any>;
+} | {
+    type: "image";
+    output: {
+        image: string;
+        mimeType?: string;
+        [key: string]: any;
+    };
+};
+export declare function normalizeToolOutput(raw: any): MCPToolOutput;
+export declare abstract class MCPCustomClass {
+    #private;
+    setMCP(mcp: MCP): void;
+    getMCP(): MCP | undefined;
+    /** Subscribe to / emit interaction events from this tool (e.g. "status", "progress"). */
+    getEvents(): EventEmitter;
+}
+export declare abstract class MCP {
+    abstract getStorage(): MCPStorage;
+    abstract getRNG(): MCPRNG;
+}
+/** Convenience helper: get a fresh, guaranteed-unique hex id from an MCP instance's RNG. */
+export declare function generateRefId(mcp?: MCP): Promise<string>;
+export declare class MCPTool<T extends MCPCustomClass | undefined = undefined> {
     #private;
     constructor(options: {
         name: string;
@@ -10,8 +38,12 @@ export declare class MCPTool {
             required?: boolean;
             default?: any;
         }[];
-        execute: (envID: string, inputs: Record<string, any>) => Promise<any>;
+        stopIterationAfterUsingThisTool?: boolean;
+        customClass?: T;
+        execute: (envID: string, inputs: Record<string, any>, mcp?: MCP, customClass?: T) => Promise<any>;
     });
+    setMCP(mcp: MCP): void;
+    getMCP(): MCP | undefined;
     getOptions(): {
         name: string;
         description: string;
@@ -22,7 +54,9 @@ export declare class MCPTool {
             required?: boolean;
             default?: any;
         }[];
-        execute: (envID: string, inputs: Record<string, any>) => Promise<any>;
+        stopIterationAfterUsingThisTool: boolean;
+        customClass?: T;
+        execute: (envID: string, inputs: Record<string, any>, mcp?: MCP, customClass?: T) => Promise<any>;
     };
 }
 export default MCPTool;

package/dist/core/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/core/mcp.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAO;;gBAEJ,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;YAC3D,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,CAAC;SACjB,EAAE,CAAC;QACJ,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACzE;IAID,UAAU;cAdA,MAAM;qBACC,MAAM;gBACX;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;YAC3D,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,CAAC;SACjB,EAAE;iBACM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;;CAQ5E;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/core/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAG/C,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;CAAE,CAAC;AAEzF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAW3D;AAGD,8BAAsB,cAAc;;IAIhC,MAAM,CAAC,GAAG,EAAE,GAAG;IAIf,MAAM;IAIN,yFAAyF;IACzF,SAAS,IAAI,YAAY;CAG5B;AAED,8BAAsB,GAAG;IACrB,QAAQ,CAAC,UAAU,IAAI,UAAU;IACjC,QAAQ,CAAC,MAAM,IAAI,MAAM;CAC5B;AAED,4FAA4F;AAC5F,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D;AAED,qBAAa,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,SAAS,GAAG,SAAS;;gBAIrD,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;YAC3D,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,CAAC;SACjB,EAAE,CAAC;QACJ,+BAA+B,CAAC,EAAE,OAAO,CAAA;QACzC,WAAW,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,CACL,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,CAAC,EAAE,GAAG,EACT,WAAW,CAAC,EAAE,CAAC,KACd,OAAO,CAAC,GAAG,CAAC,CAAC;KACrB;IAID,MAAM,CAAC,GAAG,EAAE,GAAG;IAKf,MAAM;IAIN,UAAU;cA9BA,MAAM;qBACC,MAAM;gBACX;YACJ,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;YAC3D,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,GAAG,CAAC;SACjB,EAAE;yCAC+B,OAAO;sBAC3B,CAAC;iBACN,CACL,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,CAAC,EAAE,GAAG,EACT,WAAW,CAAC,EAAE,CAAC,KACd,OAAO,CAAC,GAAG,CAAC;;CAiBxB;AAED,eAAe,OAAO,CAAC"}

package/dist/core/mcp.js

@@ -1,7 +1,48 @@
+import EventEmitter from "events";
+export function normalizeToolOutput(raw) {
+    if (raw &&
+        typeof raw === "object" &&
+        (raw.type === "text" || raw.type === "image") &&
+        raw.output &&
+        typeof raw.output === "object") {
+        return raw;
+    }
+    return { type: "text", output: raw ?? {} };
+}
+export class MCPCustomClass {
+    #mcp;
+    #events = new EventEmitter();
+    setMCP(mcp) {
+        this.#mcp = mcp;
+    }
+    getMCP() {
+        return this.#mcp;
+    }
+    /** Subscribe to / emit interaction events from this tool (e.g. "status", "progress"). */
+    getEvents() {
+        return this.#events;
+    }
+}
+export class MCP {
+}
+/** Convenience helper: get a fresh, guaranteed-unique hex id from an MCP instance's RNG. */
+export async function generateRefId(mcp) {
+    if (!mcp)
+        return `0x${Math.random().toString(16).slice(2, 10)}`;
+    return mcp.getRNG().getRNG();
+}
 export class MCPTool {
     #options;
+    #mcp;
     constructor(options) {
-        this.#options = options;
+        this.#options = { stopIterationAfterUsingThisTool: false, ...options };
+    }
+    setMCP(mcp) {
+        this.#mcp = mcp;
+        this.#options.customClass?.setMCP(mcp);
+    }
+    getMCP() {
+        return this.#mcp;
     }
     getOptions() {
         return this.#options;

package/dist/core/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/core/mcp.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAO;IAChB,QAAQ,CAAC;IACT,YAAY,OAWX;QACG,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/core/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAC;AASlC,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IACxC,IACI,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;QAC7C,GAAG,CAAC,MAAM;QACV,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAChC,CAAC;QACC,OAAO,GAAoB,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;AAC/C,CAAC;AAGD,MAAM,OAAgB,cAAc;IAChC,IAAI,CAAkB;IACtB,OAAO,GAAiB,IAAI,YAAY,EAAE,CAAC;IAE3C,MAAM,CAAC,GAAQ;QACX,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,yFAAyF;IACzF,SAAS;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAED,MAAM,OAAgB,GAAG;CAGxB;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAS;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAChE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,OAAO;IAChB,QAAQ,CAAC;IACT,IAAI,CAAkB;IAEtB,YAAY,OAkBX;QACG,IAAI,CAAC,QAAQ,GAAG,EAAE,+BAA+B,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,GAAQ;QACX,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ;AAED,eAAe,OAAO,CAAC"}

package/dist/core/ollama-provider.d.ts

@@ -1,9 +1,16 @@
-import AIProvider, { type Message, type ChatResponse, type StreamCallback } from "./ai-provider.js";
+import type { Message, ChatResponse, StreamCallback, ToolSchema, ProviderCapabilities } from "./ai-provider.js";
+import AIProvider from "./ai-provider.js";
 export declare class OllamaProvider extends AIProvider {
     private client;
     private model;
-    constructor(model: string, host?: string);
-    chat(messages: Message[], streamCallback?: StreamCallback): Promise<ChatResponse>;
+    private supportsTools;
+    private contextWindow;
+    constructor(model: string, host?: string, options?: {
+        supportsTools?: boolean;
+        contextWindow?: number;
+    });
+    getCapabilities(): ProviderCapabilities;
+    chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[]): Promise<ChatResponse>;
 }
 export default OllamaProvider;
 //# sourceMappingURL=ollama-provider.d.ts.map

package/dist/core/ollama-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../src/core/ollama-provider.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpG,qBAAa,cAAe,SAAQ,UAAU;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC;IAM5D,IAAI,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,YAAY,CAAC;CAmD3B;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ollama-provider.d.ts","sourceRoot":"","sources":["../../src/core/ollama-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAmB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAuD1C,qBAAa,cAAe,SAAQ,UAAU;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IAMtB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,aAAa,CAAS;gBAElB,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC,EAAE,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO;IAQrI,eAAe,IAAI,oBAAoB;IASjC,IAAI,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,KAAK,CAAC,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC;CAqE3B;AAED,eAAe,cAAc,CAAC"}

package/dist/core/ollama-provider.js

@@ -1,57 +1,138 @@
 import { Ollama } from "ollama";
-import AIProvider, {} from "./ai-provider.js";
+import AIProvider from "./ai-provider.js";
+import { toOpenAIFunctionTools } from "./tool-schema-translator.js";
+import { withRetry } from "./retry.js";
+const DEFAULT_CONTEXT_WINDOW = 32_000;
+function toOllamaMessages(messages, supportsTools) {
+    return messages.map(msg => {
+        // Ollama rejects `tool`-role messages for models that don't support
+        // tool-calling at all (it throws). BaseAgent only builds tool-role
+        // messages when it already knows supportsTools is true, so this is
+        // just a defensive downgrade in case a `tool` message ever reaches
+        // here on a non-tool-capable model — fold it into `system` instead
+        // of letting the API error out.
+        if (msg.role === "tool" && !supportsTools) {
+            return { role: "system", content: msg.content || "" };
+        }
+        if (msg.role === "tool") {
+            return {
+                role: "tool",
+                content: msg.content || "",
+                tool_name: msg.toolName,
+            };
+        }
+        if (msg.role === "assistant" && msg.toolCalls?.length && supportsTools) {
+            return {
+                role: "assistant",
+                content: msg.content || "",
+                tool_calls: msg.toolCalls.map(tc => ({
+                    function: { name: tc.name, arguments: tc.inputs },
+                })),
+            };
+        }
+        if (msg.parts?.length) {
+            const text = msg.parts.filter(p => p.type === "text").map(p => p.text).join("\n");
+            const images = msg.parts.filter(p => p.type === "image").map(p => p.image);
+            return { role: msg.role, content: text, ...(images.length ? { images } : {}) };
+        }
+        return { role: msg.role, content: msg.content || "" };
+    });
+}
+function fromOllamaToolCalls(toolCalls) {
+    if (!toolCalls || toolCalls.length === 0)
+        return undefined;
+    return toolCalls.map((tc, idx) => ({
+        id: `${idx}`,
+        name: tc.function?.name || "",
+        inputs: tc.function?.arguments || {},
+    }));
+}
 export class OllamaProvider extends AIProvider {
     client;
     model;
-    constructor(model, host = "http://localhost:11434") {
+    // Whether the currently-configured model supports Ollama's native
+    // function-calling API. Ollama throws if `tools` is sent to a model
+    // that doesn't support it, so this must be known ahead of time rather
+    // than discovered by trial and error — callers should set this based on
+    // the model card (most recent tool-capable families default to true).
+    supportsTools;
+    contextWindow;
+    constructor(model, host = "http://localhost:11434", options = {}) {
         super();
         this.client = new Ollama({ host });
         this.model = model;
+        this.supportsTools = options.supportsTools ?? false;
+        this.contextWindow = options.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
     }
-    async chat(messages, streamCallback) {
-        const formattedMessages = messages.map(msg => ({
-            role: msg.role,
-            content: msg.content || ""
-        }));
+    getCapabilities() {
+        return {
+            supportsTools: this.supportsTools,
+            supportsImages: true,
+            contextWindow: this.contextWindow,
+            safeUsageRatio: 0.5,
+        };
+    }
+    async chat(messages, streamCallback, tools) {
+        const formattedMessages = toOllamaMessages(messages, this.supportsTools);
+        // Never send `tools` to a model we don't know supports it — Ollama
+        // throws rather than silently ignoring an unsupported `tools` field.
+        const formattedTools = tools && tools.length > 0 && this.supportsTools
+            ? toOpenAIFunctionTools(tools)
+            : undefined;
         if (streamCallback) {
-            const stream = await this.client.chat({
-                model: this.model,
-                messages: formattedMessages,
-                stream: true
-            });
-            let fullContent = "";
-            let promptEvalCount = 0;
-            let evalCount = 0;
-            for await (const chunk of stream) {
-                const content = chunk.message?.content || "";
-                if (content) {
-                    fullContent += content;
-                    streamCallback({ role: "assistant", content, done: false });
-                }
-                if (chunk.prompt_eval_count !== undefined) {
-                    promptEvalCount = chunk.prompt_eval_count;
+            return withRetry(async () => {
+                // Per-attempt accumulators live inside this closure so a
+                // failed/partial stream from a previous attempt never leaks
+                // into a retry's output — each attempt starts clean.
+                const stream = await this.client.chat({
+                    model: this.model,
+                    messages: formattedMessages,
+                    ...(formattedTools ? { tools: formattedTools } : {}),
+                    stream: true
+                });
+                let fullContent = "";
+                let promptEvalCount = 0;
+                let evalCount = 0;
+                let toolCalls;
+                for await (const chunk of stream) {
+                    const content = chunk.message?.content || "";
+                    if (content) {
+                        fullContent += content;
+                        streamCallback({ role: "assistant", content, done: false });
+                    }
+                    if (chunk.message?.tool_calls?.length) {
+                        toolCalls = fromOllamaToolCalls(chunk.message.tool_calls);
+                    }
+                    if (chunk.prompt_eval_count !== undefined) {
+                        promptEvalCount = chunk.prompt_eval_count;
+                    }
+                    if (chunk.eval_count !== undefined) {
+                        evalCount = chunk.eval_count;
+                    }
                 }
-                if (chunk.eval_count !== undefined) {
-                    evalCount = chunk.eval_count;
-                }
-            }
-            streamCallback({ role: "assistant", content: "", done: true });
-            return {
-                content: fullContent,
-                inputTokens: promptEvalCount,
-                outputTokens: evalCount
-            };
+                streamCallback({ role: "assistant", content: "", done: true, ...(toolCalls ? { toolCalls } : {}) });
+                return {
+                    content: fullContent,
+                    inputTokens: promptEvalCount,
+                    outputTokens: evalCount,
+                    ...(toolCalls ? { toolCalls } : {}),
+                };
+            });
         }
         else {
-            const response = await this.client.chat({
-                model: this.model,
-                messages: formattedMessages
+            return withRetry(async () => {
+                const response = await this.client.chat({
+                    model: this.model,
+                    messages: formattedMessages,
+                    ...(formattedTools ? { tools: formattedTools } : {}),
+                });
+                return {
+                    content: response.message?.content || "",
+                    inputTokens: response.prompt_eval_count || 0,
+                    outputTokens: response.eval_count || 0,
+                    ...(fromOllamaToolCalls(response.message?.tool_calls) ? { toolCalls: fromOllamaToolCalls(response.message?.tool_calls) } : {}),
+                };
             });
-            return {
-                content: response.message?.content || "",
-                inputTokens: response.prompt_eval_count || 0,
-                outputTokens: response.eval_count || 0
-            };
         }
     }
 }

package/dist/core/ollama-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ollama-provider.js","sourceRoot":"","sources":["../../src/core/ollama-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,UAAU,EAAE,EAAwD,MAAM,kBAAkB,CAAC;AAEpG,MAAM,OAAO,cAAe,SAAQ,UAAU;IAClC,MAAM,CAAS;IACf,KAAK,CAAS;IAEtB,YAAY,KAAa,EAAE,OAAe,wBAAwB;QAC9D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CACN,QAAmB,EACnB,cAA+B;QAE/B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;SAC7B,CAAC,CAAC,CAAC;QAEJ,IAAI,cAAc,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,iBAAwB;gBAClC,MAAM,EAAE,IAAI;aACf,CAAC,CAAC;YAEH,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,IAAI,SAAS,GAAG,CAAC,CAAC;YAElB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;gBAC7C,IAAI,OAAO,EAAE,CAAC;oBACV,WAAW,IAAI,OAAO,CAAC;oBACvB,cAAc,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAED,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;oBACxC,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC;gBAC9C,CAAC;gBACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACjC,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;gBACjC,CAAC;YACL,CAAC;YAED,cAAc,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO;gBACH,OAAO,EAAE,WAAW;gBACpB,WAAW,EAAE,eAAe;gBAC5B,YAAY,EAAE,SAAS;aAC1B,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,iBAAwB;aACrC,CAAC,CAAC;YAEH,OAAO;gBACH,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE;gBACxC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,IAAI,CAAC;gBAC5C,YAAY,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC;aACzC,CAAC;QACN,CAAC;IACL,CAAC;CACJ;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ollama-provider.js","sourceRoot":"","sources":["../../src/core/ollama-provider.ts"],"names":[],"mappings":"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"}

package/dist/core/retry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runs `fn`, retrying on any thrown error using the fixed backoff schedule
+ * above. Every error is treated as transient/retryable — callers that only
+ * want to retry specific error shapes should filter inside `fn` and rethrow
+ * a non-retryable marker instead (not needed currently, since all providers
+ * here want to retry on any error: network errors, timeouts, 5xx, etc).
+ */
+export declare function withRetry<T>(fn: () => Promise<T>): Promise<T>;
+export default withRetry;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAenE;AAED,eAAe,SAAS,CAAC"}

package/dist/core/retry.js

@@ -0,0 +1,39 @@
+/**
+ * Retry-with-backoff helper. Each provider calls this around its own SDK
+ * call (not a central wrapper in BaseAgent) so provider-specific errors
+ * (rate limits, transient 5xx, network blips) are retried right at the
+ * source before ever reaching the agent loop.
+ *
+ * Schedule: 1s, 2s, 4s, 8s between attempts (4 waits => 5 total attempts).
+ * After the last attempt still fails, the error is rethrown as-is so the
+ * caller sees the real underlying error rather than a generic wrapper.
+ */
+const BACKOFF_SCHEDULE_MS = [1_000, 2_000, 4_000, 8_000];
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Runs `fn`, retrying on any thrown error using the fixed backoff schedule
+ * above. Every error is treated as transient/retryable — callers that only
+ * want to retry specific error shapes should filter inside `fn` and rethrow
+ * a non-retryable marker instead (not needed currently, since all providers
+ * here want to retry on any error: network errors, timeouts, 5xx, etc).
+ */
+export async function withRetry(fn) {
+    let lastError;
+    for (let attempt = 0; attempt <= BACKOFF_SCHEDULE_MS.length; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            const waitMs = BACKOFF_SCHEDULE_MS[attempt];
+            if (waitMs === undefined)
+                break; // no more retries left
+            await sleep(waitMs);
+        }
+    }
+    throw lastError;
+}
+export default withRetry;
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEzD,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB;IACnD,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QACrE,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,SAAS,GAAG,GAAG,CAAC;YAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,uBAAuB;YACxD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,MAAM,SAAS,CAAC;AACpB,CAAC;AAED,eAAe,SAAS,CAAC"}

package/dist/core/skill.d.ts

@@ -1,14 +1,17 @@
+import type MCPTool from "./mcp.js";
 export declare class Skill {
     #private;
     constructor(skill: {
         name: string;
         description: string;
         instructions: string;
+        tools: MCPTool<any>[];
     });
     getSkill(): {
         name: string;
         description: string;
         instructions: string;
+        tools: MCPTool<any>[];
     };
 }
 export default Skill;

package/dist/core/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/core/skill.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;;gBAEF,KAAK,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACxB;IAID,QAAQ;cAPE,MAAM;qBACC,MAAM;sBACL,MAAM;;CAQ3B;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/core/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAEpC,qBAAa,KAAK;;gBAEF,KAAK,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAA;KACxB;IAID,QAAQ;cARE,MAAM;qBACC,MAAM;sBACL,MAAM;eACb,OAAO,CAAC,GAAG,CAAC,EAAE;;CAQ5B;AAED,eAAe,KAAK,CAAC"}

package/dist/core/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/core/skill.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IACd,MAAM,CAAC;IACP,YAAY,KAIX;QACG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/core/skill.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,KAAK;IACd,MAAM,CAAC;IACP,YAAY,KAKX;QACG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ;AAED,eAAe,KAAK,CAAC"}

package/dist/core/tool-schema-translator.d.ts

@@ -0,0 +1,10 @@
+import type { ToolSchema } from "./ai-provider.js";
+/**
+ * Translates our standard, provider-agnostic ToolSchema[] into the
+ * OpenAI-compatible `tools: [{type:"function", function:{...}}]` shape.
+ * Both the OpenAI SDK (DeepSeekProvider) and Ollama's function-calling API
+ * use this same shape, so it's shared rather than duplicated per provider.
+ */
+export declare function toOpenAIFunctionTools(tools: ToolSchema[]): any[];
+export default toOpenAIFunctionTools;
+//# sourceMappingURL=tool-schema-translator.d.ts.map

package/dist/core/tool-schema-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-translator.d.ts","sourceRoot":"","sources":["../../src/core/tool-schema-translator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,EAAE,CAoBhE;AAED,eAAe,qBAAqB,CAAC"}

package/dist/core/tool-schema-translator.js

@@ -0,0 +1,29 @@
+/**
+ * Translates our standard, provider-agnostic ToolSchema[] into the
+ * OpenAI-compatible `tools: [{type:"function", function:{...}}]` shape.
+ * Both the OpenAI SDK (DeepSeekProvider) and Ollama's function-calling API
+ * use this same shape, so it's shared rather than duplicated per provider.
+ */
+export function toOpenAIFunctionTools(tools) {
+    return tools.map(t => ({
+        type: "function",
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: {
+                type: "object",
+                properties: Object.fromEntries(t.inputs.map(i => [
+                    i.name,
+                    {
+                        type: i.type === "array" ? "array" : i.type === "object" ? "object" : i.type,
+                        description: i.description,
+                        ...(i.default !== undefined ? { default: i.default } : {}),
+                    }
+                ])),
+                required: t.inputs.filter(i => i.required).map(i => i.name),
+            },
+        },
+    }));
+}
+export default toOpenAIFunctionTools;
+//# sourceMappingURL=tool-schema-translator.js.map

package/dist/core/tool-schema-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-translator.js","sourceRoot":"","sources":["../../src/core/tool-schema-translator.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,CAAC,CAAC,IAAI;oBACN;wBACI,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;wBAC5E,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC7D;iBACJ,CAAC,CAAC;gBACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAC9D;SACJ;KACJ,CAAC,CAAC,CAAC;AACR,CAAC;AAED,eAAe,qBAAqB,CAAC"}