@loom-node/tools 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Loom Node Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/tool-registry.test.d.ts

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

package/dist/__tests__/tool-registry.test.d.ts.map

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

package/dist/__tests__/tool-registry.test.js

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { ToolRegistry } from '../tool-registry.js';
+function fakeTool(name) {
+    return {
+        name,
+        description: `desc-${name}`,
+        parameters: { parse: (i) => i, toJsonSchema: () => ({ type: 'object', properties: {} }) },
+        execute: async () => 'ok',
+    };
+}
+describe('ToolRegistry', () => {
+    it('registers and retrieves tools', () => {
+        const reg = new ToolRegistry();
+        reg.register(fakeTool('a'));
+        expect(reg.get('a')?.name).toBe('a');
+    });
+    it('throws on duplicate registration', () => {
+        const reg = new ToolRegistry();
+        reg.register(fakeTool('a'));
+        expect(() => reg.register(fakeTool('a'))).toThrow('already registered');
+    });
+    it('returns all tools', () => {
+        const reg = new ToolRegistry();
+        reg.register(fakeTool('a'));
+        reg.register(fakeTool('b'));
+        expect(reg.all()).toHaveLength(2);
+    });
+    it('converts to JSON definitions', () => {
+        const reg = new ToolRegistry();
+        reg.register(fakeTool('x'));
+        const json = reg.toJsonDefinitions();
+        expect(json[0].name).toBe('x');
+        expect(json[0].parameters).toEqual({ type: 'object', properties: {} });
+    });
+});
+//# sourceMappingURL=tool-registry.test.js.map

package/dist/__tests__/tool-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.js","sourceRoot":"","sources":["../../src/__tests__/tool-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,QAAQ,IAAI,EAAE;QAC3B,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,EAAE;QAClG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/define-tool.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition, ToolSchema, ToolContext } from '@loom-node/core';
+export interface DefineToolOptions<TInput, TOutput> {
+    name: string;
+    description: string;
+    parameters: ToolSchema<TInput>;
+    execute: (input: TInput, ctx: ToolContext) => Promise<TOutput>;
+}
+export declare function defineTool<TInput, TOutput>(opts: DefineToolOptions<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../src/define-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/E,MAAM,WAAW,iBAAiB,CAAC,MAAM,EAAE,OAAO;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EACxC,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAOjC"}

package/dist/define-tool.js

@@ -0,0 +1,9 @@
+export function defineTool(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        parameters: opts.parameters,
+        execute: opts.execute,
+    };
+}
+//# sourceMappingURL=define-tool.js.map

package/dist/define-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.js","sourceRoot":"","sources":["../src/define-tool.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,UAAU,CACxB,IAAwC;IAExC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { defineTool } from './define-tool.js';
+export type { DefineToolOptions } from './define-tool.js';
+export { ToolRegistry } from './tool-registry.js';
+export { zodSchema } from './zod-adapter.js';
+export { McpClient, mcpToolsToDefinitions } from './mcp-client.js';
+export type { McpServerConfig, McpToolInfo } from './mcp-client.js';
+export { shellTool, readFileTool, writeFileTool, listDirTool } from './system/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { defineTool } from './define-tool.js';
+export { ToolRegistry } from './tool-registry.js';
+export { zodSchema } from './zod-adapter.js';
+export { McpClient, mcpToolsToDefinitions } from './mcp-client.js';
+// System tools
+export { shellTool, readFileTool, writeFileTool, listDirTool } from './system/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp-client.d.ts

@@ -0,0 +1,28 @@
+import type { ToolDefinition, JsonSchema } from '@loom-node/core';
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export declare class McpClient {
+    private config;
+    private proc;
+    private pending;
+    private buffer;
+    private ready;
+    private emitter;
+    constructor(config: McpServerConfig);
+    connect(): Promise<void>;
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    disconnect(): Promise<void>;
+    private rpc;
+    private processBuffer;
+}
+export interface McpToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+}
+export declare function mcpToolsToDefinitions(client: McpClient, tools: McpToolInfo[]): ToolDefinition[];
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../src/mcp-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAA2B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,qBAAa,SAAS;IAOR,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,OAAO,CAAoF;IACnG,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAsB;gBAEjB,MAAM,EAAE,eAAe;IAErC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxB,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,GAAG;IAmBjB,OAAO,CAAC,aAAa;CAgBtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAcD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAO/F"}

package/dist/mcp-client.js

@@ -0,0 +1,106 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+export class McpClient {
+    config;
+    proc = null;
+    pending = new Map();
+    buffer = '';
+    ready = false;
+    emitter = new EventEmitter();
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        this.proc = spawn(this.config.command, this.config.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env, ...this.config.env },
+        });
+        this.proc.stdout.on('data', (chunk) => {
+            this.buffer += chunk.toString();
+            this.processBuffer();
+        });
+        this.proc.on('error', (err) => {
+            for (const p of this.pending.values())
+                p.reject(err);
+            this.pending.clear();
+        });
+        await this.rpc('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'loom-node', version: '0.1.0' },
+        });
+        await this.rpc('notifications/initialized', undefined);
+        this.ready = true;
+    }
+    async listTools() {
+        const res = await this.rpc('tools/list', {});
+        return res.tools;
+    }
+    async callTool(name, args) {
+        const res = await this.rpc('tools/call', { name, arguments: args });
+        if (res.isError)
+            throw new Error(res.content?.[0]?.text ?? 'MCP tool error');
+        return res.content?.map((c) => c.text ?? '').join('') ?? '';
+    }
+    async disconnect() {
+        if (!this.proc)
+            return;
+        this.proc.kill();
+        this.proc = null;
+        this.ready = false;
+    }
+    async rpc(method, params) {
+        if (!this.proc)
+            throw new Error('MCP client not connected');
+        const id = randomUUID();
+        const msg = JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n';
+        this.proc.stdin.write(msg);
+        if (method.startsWith('notifications/'))
+            return;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`MCP RPC timeout: ${method}`));
+                }
+            }, 30_000);
+        });
+    }
+    processBuffer() {
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop();
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const msg = JSON.parse(line);
+                if (msg.id && this.pending.has(msg.id)) {
+                    const p = this.pending.get(msg.id);
+                    this.pending.delete(msg.id);
+                    if (msg.error)
+                        p.reject(new Error(msg.error.message));
+                    else
+                        p.resolve(msg.result);
+                }
+            }
+            catch { /* skip malformed */ }
+        }
+    }
+}
+function mcpSchema(schema) {
+    return {
+        parse: (input) => input,
+        toJsonSchema: () => schema ?? { type: 'object', properties: {} },
+    };
+}
+export function mcpToolsToDefinitions(client, tools) {
+    return tools.map(t => ({
+        name: t.name,
+        description: t.description ?? '',
+        parameters: mcpSchema(t.inputSchema),
+        execute: async (input, _ctx) => client.callTool(t.name, input),
+    }));
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/system/index.d.ts

@@ -0,0 +1,5 @@
+export { shellTool } from './shell.js';
+export { readFileTool } from './read-file.js';
+export { writeFileTool } from './write-file.js';
+export { listDirTool } from './list-dir.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/system/index.js

@@ -0,0 +1,5 @@
+export { shellTool } from './shell.js';
+export { readFileTool } from './read-file.js';
+export { writeFileTool } from './write-file.js';
+export { listDirTool } from './list-dir.js';
+//# sourceMappingURL=index.js.map

package/dist/system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/system/list-dir.d.ts

@@ -0,0 +1,17 @@
+interface ListDirInput {
+    path: string;
+    recursive?: boolean;
+}
+export declare const listDirTool: import("@loom-node/core").ToolDefinition<ListDirInput, {
+    entries: {
+        name: string;
+        type: "directory" | "file";
+    }[];
+} | {
+    entries: {
+        path: string;
+        type: string;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=list-dir.d.ts.map

package/dist/system/list-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.d.ts","sourceRoot":"","sources":["../../src/system/list-dir.ts"],"names":[],"mappings":"AAKA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,WAAW;;;;;;;cAmBE,MAAM;cAAQ,MAAM;;EAY5C,CAAC"}

package/dist/system/list-dir.js

@@ -0,0 +1,34 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defineTool } from '../define-tool.js';
+import { objectSchema } from './schema-helper.js';
+export const listDirTool = defineTool({
+    name: 'list_directory',
+    description: 'List files and directories at a given path',
+    parameters: objectSchema({
+        path: { type: 'string', description: 'Directory path' },
+        recursive: { type: 'boolean', description: 'List recursively (default false)' },
+    }, ['path'], (input) => input),
+    execute: async (input) => {
+        const entries = await readdir(input.path, { withFileTypes: true });
+        const items = entries.map(e => ({
+            name: e.name,
+            type: e.isDirectory() ? 'directory' : 'file',
+        }));
+        if (!input.recursive)
+            return { entries: items };
+        const result = [];
+        const walk = async (dir) => {
+            const ents = await readdir(dir, { withFileTypes: true });
+            for (const e of ents) {
+                const full = join(dir, e.name);
+                result.push({ path: full, type: e.isDirectory() ? 'directory' : 'file' });
+                if (e.isDirectory())
+                    await walk(full);
+            }
+        };
+        await walk(input.path);
+        return { entries: result };
+    },
+});
+//# sourceMappingURL=list-dir.js.map

package/dist/system/list-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.js","sourceRoot":"","sources":["../../src/system/list-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,4CAA4C;IACzD,UAAU,EAAE,YAAY,CACtB;QACE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;QACvD,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kCAAkC,EAAE;KAChF,EACD,CAAC,MAAM,CAAC,EACR,CAAC,KAAK,EAAE,EAAE,CAAC,KAAqB,CACjC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAoB,CAAC,CAAC,CAAC,MAAe;SAC/D,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAqC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;YACjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1E,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC"}

package/dist/system/read-file.d.ts

@@ -0,0 +1,9 @@
+interface ReadFileInput {
+    path: string;
+    encoding?: string;
+}
+export declare const readFileTool: import("@loom-node/core").ToolDefinition<ReadFileInput, {
+    content: string;
+}>;
+export {};
+//# sourceMappingURL=read-file.d.ts.map

package/dist/system/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/system/read-file.ts"],"names":[],"mappings":"AAIA,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,YAAY;;EAevB,CAAC"}

package/dist/system/read-file.js

@@ -0,0 +1,16 @@
+import { readFile } from 'node:fs/promises';
+import { defineTool } from '../define-tool.js';
+import { objectSchema } from './schema-helper.js';
+export const readFileTool = defineTool({
+    name: 'read_file',
+    description: 'Read the contents of a file',
+    parameters: objectSchema({
+        path: { type: 'string', description: 'Absolute or relative file path' },
+        encoding: { type: 'string', description: 'File encoding (default utf-8)' },
+    }, ['path'], (input) => input),
+    execute: async (input) => {
+        const content = await readFile(input.path, { encoding: (input.encoding ?? 'utf-8') });
+        return { content };
+    },
+});
+//# sourceMappingURL=read-file.js.map

package/dist/system/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/system/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,6BAA6B;IAC1C,UAAU,EAAE,YAAY,CACtB;QACE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;QACvE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAC3E,EACD,CAAC,MAAM,CAAC,EACR,CAAC,KAAK,EAAE,EAAE,CAAC,KAAsB,CAClC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAmB,EAAE,CAAC,CAAC;QACxG,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;CACF,CAAC,CAAC"}

package/dist/system/schema-helper.d.ts

@@ -0,0 +1,4 @@
+import type { ToolSchema, JsonSchema } from '@loom-node/core';
+/** Lightweight inline schema — no zod needed for system tools */
+export declare function objectSchema<T>(properties: Record<string, JsonSchema>, required: string[], parse: (input: unknown) => T): ToolSchema<T>;
+//# sourceMappingURL=schema-helper.d.ts.map

package/dist/system/schema-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helper.d.ts","sourceRoot":"","sources":["../../src/system/schema-helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,CAAC,EAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAC3B,UAAU,CAAC,CAAC,CAAC,CAKf"}

package/dist/system/schema-helper.js

@@ -0,0 +1,8 @@
+/** Lightweight inline schema — no zod needed for system tools */
+export function objectSchema(properties, required, parse) {
+    return {
+        parse,
+        toJsonSchema: () => ({ type: 'object', properties, required }),
+    };
+}
+//# sourceMappingURL=schema-helper.js.map

package/dist/system/schema-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-helper.js","sourceRoot":"","sources":["../../src/system/schema-helper.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAC1B,UAAsC,EACtC,QAAkB,EAClB,KAA4B;IAE5B,OAAO;QACL,KAAK;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/system/shell.d.ts

@@ -0,0 +1,8 @@
+interface ShellInput {
+    command: string;
+    cwd?: string;
+    timeout?: number;
+}
+export declare const shellTool: import("@loom-node/core").ToolDefinition<ShellInput, unknown>;
+export {};
+//# sourceMappingURL=shell.d.ts.map

package/dist/system/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/system/shell.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,SAAS,+DA6BpB,CAAC"}

package/dist/system/shell.js

@@ -0,0 +1,31 @@
+import { exec } from 'node:child_process';
+import { defineTool } from '../define-tool.js';
+import { objectSchema } from './schema-helper.js';
+export const shellTool = defineTool({
+    name: 'shell',
+    description: 'Execute a shell command and return stdout/stderr',
+    parameters: objectSchema({
+        command: { type: 'string', description: 'Shell command to execute' },
+        cwd: { type: 'string', description: 'Working directory' },
+        timeout: { type: 'number', description: 'Timeout in ms (default 30000)' },
+    }, ['command'], (input) => input),
+    execute: async (input, ctx) => {
+        return new Promise((resolve, reject) => {
+            const child = exec(input.command, {
+                cwd: input.cwd,
+                timeout: input.timeout ?? 30_000,
+                maxBuffer: 1024 * 1024,
+                signal: ctx.signal,
+            }, (err, stdout, stderr) => {
+                if (err && !stdout && !stderr)
+                    return reject(err);
+                resolve({
+                    exitCode: child.exitCode ?? (err ? 1 : 0),
+                    stdout: stdout.toString(),
+                    stderr: stderr.toString(),
+                });
+            });
+        });
+    },
+});
+//# sourceMappingURL=shell.js.map

package/dist/system/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/system/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,kDAAkD;IAC/D,UAAU,EAAE,YAAY,CACtB;QACE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACpE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACzD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAC1E,EACD,CAAC,SAAS,CAAC,EACX,CAAC,KAAK,EAAE,EAAE,CAAC,KAAmB,CAC/B;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;gBAChC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,MAAM;gBAChC,SAAS,EAAE,IAAI,GAAG,IAAI;gBACtB,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACzB,IAAI,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClD,OAAO,CAAC;oBACN,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACzC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;oBACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;iBAC1B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/system/write-file.d.ts

@@ -0,0 +1,11 @@
+interface WriteFileInput {
+    path: string;
+    content: string;
+    mkdirp?: boolean;
+}
+export declare const writeFileTool: import("@loom-node/core").ToolDefinition<WriteFileInput, {
+    path: string;
+    bytes: number;
+}>;
+export {};
+//# sourceMappingURL=write-file.d.ts.map

package/dist/system/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/system/write-file.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,aAAa;;;EAmBxB,CAAC"}

package/dist/system/write-file.js

@@ -0,0 +1,21 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { defineTool } from '../define-tool.js';
+import { objectSchema } from './schema-helper.js';
+export const writeFileTool = defineTool({
+    name: 'write_file',
+    description: 'Write content to a file, creating it if it does not exist',
+    parameters: objectSchema({
+        path: { type: 'string', description: 'File path to write' },
+        content: { type: 'string', description: 'Content to write' },
+        mkdirp: { type: 'boolean', description: 'Create parent dirs if missing (default true)' },
+    }, ['path', 'content'], (input) => input),
+    execute: async (input) => {
+        if (input.mkdirp !== false) {
+            await mkdir(dirname(input.path), { recursive: true });
+        }
+        await writeFile(input.path, input.content, 'utf-8');
+        return { path: input.path, bytes: Buffer.byteLength(input.content) };
+    },
+});
+//# sourceMappingURL=write-file.js.map

package/dist/system/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/system/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2DAA2D;IACxE,UAAU,EAAE,YAAY,CACtB;QACE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QAC3D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;QAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8CAA8C,EAAE;KACzF,EACD,CAAC,MAAM,EAAE,SAAS,CAAC,EACnB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAuB,CACnC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,CAAC;CACF,CAAC,CAAC"}

package/dist/tool-registry.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition, JsonToolDefinition } from '@loom-node/core';
+export declare class ToolRegistry {
+    private tools;
+    register(tool: ToolDefinition): void;
+    get(name: string): ToolDefinition | undefined;
+    all(): ToolDefinition[];
+    toJsonDefinitions(): JsonToolDefinition[];
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAOpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,GAAG,IAAI,cAAc,EAAE;IAIvB,iBAAiB,IAAI,kBAAkB,EAAE;CAO1C"}

package/dist/tool-registry.js

@@ -0,0 +1,23 @@
+export class ToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    all() {
+        return [...this.tools.values()];
+    }
+    toJsonDefinitions() {
+        return this.all().map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters.toJsonSchema(),
+        }));
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,sBAAsB,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE;SACxC,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/zod-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { ToolSchema } from '@loom-node/core';
+import type { ZodType, ZodTypeDef } from 'zod';
+export declare function zodSchema<T>(schema: ZodType<T, ZodTypeDef, unknown>): ToolSchema<T>;
+//# sourceMappingURL=zod-adapter.d.ts.map

package/dist/zod-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.d.ts","sourceRoot":"","sources":["../src/zod-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAE/C,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAKnF"}

package/dist/zod-adapter.js

@@ -0,0 +1,51 @@
+export function zodSchema(schema) {
+    return {
+        parse: (input) => schema.parse(input),
+        toJsonSchema: () => zodToJsonSchema(schema),
+    };
+}
+function zodToJsonSchema(schema) {
+    const def = schema._def;
+    const typeName = def?.typeName ?? '';
+    switch (typeName) {
+        case 'ZodString':
+            return { type: 'string', ...(def.description ? { description: def.description } : {}) };
+        case 'ZodNumber':
+            return { type: 'number' };
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray':
+            return { type: 'array', items: zodToJsonSchema(def.type) };
+        case 'ZodEnum':
+            return { type: 'string', enum: def.values };
+        case 'ZodOptional':
+        case 'ZodNullable':
+            return zodToJsonSchema(def.innerType);
+        case 'ZodDefault':
+            return { ...zodToJsonSchema(def.innerType), default: def.defaultValue() };
+        case 'ZodObject': {
+            const shape = def.shape();
+            const properties = {};
+            const required = [];
+            for (const [key, val] of Object.entries(shape)) {
+                properties[key] = zodToJsonSchema(val);
+                if (!isOptional(val))
+                    required.push(key);
+            }
+            return { type: 'object', properties, ...(required.length ? { required } : {}) };
+        }
+        case 'ZodEffects':
+            return zodToJsonSchema(def.schema);
+        default:
+            return {};
+    }
+}
+function isOptional(schema) {
+    const name = schema._def?.typeName ?? '';
+    if (name === 'ZodOptional')
+        return true;
+    if (name === 'ZodDefault')
+        return true;
+    return false;
+}
+//# sourceMappingURL=zod-adapter.js.map

package/dist/zod-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.js","sourceRoot":"","sources":["../src/zod-adapter.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CAAI,MAAuC;IAClE,OAAO;QACL,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9C,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAe;IACtC,MAAM,GAAG,GAAI,MAAc,CAAC,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAW,GAAG,EAAE,QAAQ,IAAI,EAAE,CAAC;IAE7C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1F,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,aAAa,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC;QAC5E,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,UAAU,GAA+B,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAc,CAAC,CAAC;gBAClD,IAAI,CAAC,UAAU,CAAC,GAAc,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAClF,CAAC;QACD,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAe;IACjC,MAAM,IAAI,GAAY,MAAc,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC1D,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@loom-node/tools",
+  "version": "0.1.0",
+  "description": "Tool framework for Loom-Node - defineTool, Zod schema, MCP integration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@loom-node/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^3.22.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "zod": "^3.22.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist .tsbuildinfo"
+  }
+}