@openweave/weave-tools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lemur bookstores
+
+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/adapters/http-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * HTTP Adapter
+ *
+ * Routes tool calls to a REST/webhook endpoint.
+ * Supports bearer token, api-key, basic, and no-auth strategies.
+ * Injectable fetch for test isolation.
+ */
+import type { ToolManifest, ToolHandler, ToolAuth } from '../types.js';
+export declare function buildAuthHeaders(auth: ToolAuth | undefined): Record<string, string>;
+export type FetchFn = typeof fetch;
+export interface HttpAdapterOptions {
+    manifest: ToolManifest;
+    /** Injectable fetch implementation for tests */
+    fetchFn?: FetchFn;
+}
+export declare function createHttpHandler(manifest: ToolManifest, actionName: string, fetchFn?: FetchFn): ToolHandler;
+export declare function createHttpAdapter(opts: HttpAdapterOptions): Map<string, ToolHandler>;
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/adapters/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/http-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAMvF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnF;AAMD,MAAM,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,WAAW,CA0Db;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAOpF"}

package/dist/adapters/http-adapter.js

@@ -0,0 +1,94 @@
+/**
+ * HTTP Adapter
+ *
+ * Routes tool calls to a REST/webhook endpoint.
+ * Supports bearer token, api-key, basic, and no-auth strategies.
+ * Injectable fetch for test isolation.
+ */
+// ---------------------------------------------------------------------------
+// Auth header builder
+// ---------------------------------------------------------------------------
+export function buildAuthHeaders(auth) {
+    if (!auth || auth.type === 'none')
+        return {};
+    const credential = auth.envVar ? (process.env[auth.envVar] ?? '') : '';
+    switch (auth.type) {
+        case 'bearer':
+            return { Authorization: `Bearer ${credential}` };
+        case 'api-key': {
+            const headerName = auth.headerName ?? 'X-API-Key';
+            return { [headerName]: credential };
+        }
+        case 'basic': {
+            const encoded = Buffer.from(credential).toString('base64');
+            return { Authorization: `Basic ${encoded}` };
+        }
+        default:
+            return {};
+    }
+}
+export function createHttpHandler(manifest, actionName, fetchFn = fetch) {
+    const endpoint = manifest.endpoint;
+    const timeoutMs = manifest.timeout_ms ?? 10_000;
+    return async (args) => {
+        const start = Date.now();
+        const prefixedName = `${manifest.id}__${actionName}`;
+        try {
+            const authHeaders = buildAuthHeaders(manifest.auth);
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            let response;
+            try {
+                response = await fetchFn(`${endpoint}/tools/call`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...authHeaders,
+                    },
+                    body: JSON.stringify({ name: actionName, arguments: args }),
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                return {
+                    toolId: manifest.id,
+                    action: prefixedName,
+                    success: false,
+                    error: `HTTP ${response.status}: ${text.slice(0, 200)}`,
+                    durationMs: Date.now() - start,
+                };
+            }
+            const data = await response.json();
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: true,
+                data,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: false,
+                error: msg.includes('abort') ? `Timeout after ${timeoutMs}ms` : msg,
+                durationMs: Date.now() - start,
+            };
+        }
+    };
+}
+export function createHttpAdapter(opts) {
+    const handlers = new Map();
+    for (const action of opts.manifest.tools) {
+        const prefixedName = `${opts.manifest.id}__${action.name}`;
+        handlers.set(prefixedName, createHttpHandler(opts.manifest, action.name, opts.fetchFn));
+    }
+    return handlers;
+}
+//# sourceMappingURL=http-adapter.js.map

package/dist/adapters/http-adapter.js.map

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

package/dist/adapters/mcp-adapter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Adapter
+ *
+ * Routes tool calls to an external MCP server (HTTP transport).
+ * Sends POST /tools/call in MCP JSON-RPC style and reads the result.
+ * For stdio MCP servers, users should set endpoint to the HTTP bridge URL.
+ *
+ * Injectable fetch for test isolation.
+ */
+import type { ToolManifest, ToolHandler } from '../types.js';
+import { type FetchFn } from './http-adapter.js';
+export declare function createMcpHandler(manifest: ToolManifest, actionName: string, fetchFn?: FetchFn): ToolHandler;
+export declare function createMcpAdapter(manifest: ToolManifest, fetchFn?: FetchFn): Map<string, ToolHandler>;
+//# sourceMappingURL=mcp-adapter.d.ts.map

package/dist/adapters/mcp-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA0BnE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,WAAW,CAuGb;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,OAAe,GACvB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAO1B"}

package/dist/adapters/mcp-adapter.js

@@ -0,0 +1,119 @@
+/**
+ * MCP Adapter
+ *
+ * Routes tool calls to an external MCP server (HTTP transport).
+ * Sends POST /tools/call in MCP JSON-RPC style and reads the result.
+ * For stdio MCP servers, users should set endpoint to the HTTP bridge URL.
+ *
+ * Injectable fetch for test isolation.
+ */
+import { buildAuthHeaders } from './http-adapter.js';
+// ---------------------------------------------------------------------------
+// MCP handler factory
+// ---------------------------------------------------------------------------
+let _mcpRequestId = 1;
+export function createMcpHandler(manifest, actionName, fetchFn = fetch) {
+    const endpoint = manifest.endpoint;
+    const timeoutMs = manifest.timeout_ms ?? 10_000;
+    return async (args) => {
+        const start = Date.now();
+        const prefixedName = `${manifest.id}__${actionName}`;
+        const requestId = _mcpRequestId++;
+        const body = {
+            jsonrpc: '2.0',
+            id: requestId,
+            method: 'tools/call',
+            params: { name: actionName, arguments: args },
+        };
+        try {
+            const authHeaders = buildAuthHeaders(manifest.auth);
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            let response;
+            try {
+                response = await fetchFn(endpoint, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Accept: 'application/json',
+                        ...authHeaders,
+                    },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok) {
+                const text = await response.text().catch(() => '');
+                return {
+                    toolId: manifest.id,
+                    action: prefixedName,
+                    success: false,
+                    error: `MCP HTTP ${response.status}: ${text.slice(0, 200)}`,
+                    durationMs: Date.now() - start,
+                };
+            }
+            const rpc = (await response.json());
+            if (rpc.error) {
+                return {
+                    toolId: manifest.id,
+                    action: prefixedName,
+                    success: false,
+                    error: `MCP error ${rpc.error.code}: ${rpc.error.message}`,
+                    durationMs: Date.now() - start,
+                };
+            }
+            const result = rpc.result;
+            if (!result) {
+                return {
+                    toolId: manifest.id,
+                    action: prefixedName,
+                    success: true,
+                    data: null,
+                    durationMs: Date.now() - start,
+                };
+            }
+            // Extract text content from MCP content array
+            const textContent = result.content
+                .filter((c) => c.type === 'text' && c.text)
+                .map((c) => c.text)
+                .join('\n');
+            let parsedData = textContent;
+            try {
+                parsedData = JSON.parse(textContent);
+            }
+            catch {
+                // keep as string
+            }
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: !result.isError,
+                data: parsedData,
+                error: result.isError ? String(parsedData) : undefined,
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: false,
+                error: msg.includes('abort') ? `Timeout after ${timeoutMs}ms` : msg,
+                durationMs: Date.now() - start,
+            };
+        }
+    };
+}
+export function createMcpAdapter(manifest, fetchFn = fetch) {
+    const handlers = new Map();
+    for (const action of manifest.tools) {
+        const prefixedName = `${manifest.id}__${action.name}`;
+        handlers.set(prefixedName, createMcpHandler(manifest, action.name, fetchFn));
+    }
+    return handlers;
+}
+//# sourceMappingURL=mcp-adapter.js.map

package/dist/adapters/mcp-adapter.js.map

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

package/dist/adapters/script-adapter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Script Adapter
+ *
+ * Executes a local script (bash/python/Node) and reads JSON from stdout.
+ * The script receives tool arguments as a JSON string on stdin or via the
+ * WEAVE_TOOL_ARGS environment variable.
+ *
+ * Injectable spawn function for test isolation.
+ */
+import { spawn, type SpawnOptionsWithoutStdio } from 'node:child_process';
+import type { ToolManifest, ToolHandler } from '../types.js';
+export type SpawnFn = (command: string, args: string[], options: SpawnOptionsWithoutStdio) => ReturnType<typeof spawn>;
+export declare function runScript(scriptPath: string, actionName: string, args: Record<string, unknown>, env: Record<string, string>, timeoutMs: number, spawnFn?: SpawnFn): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}>;
+export declare function createScriptHandler(manifest: ToolManifest, actionName: string, spawnFn?: SpawnFn): ToolHandler;
+export declare function createScriptAdapter(manifest: ToolManifest, spawnFn?: SpawnFn): Map<string, ToolHandler>;
+//# sourceMappingURL=script-adapter.d.ts.map

package/dist/adapters/script-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/script-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAkB,WAAW,EAAE,MAAM,aAAa,CAAC;AAM7E,MAAM,MAAM,OAAO,GAAG,CACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,wBAAwB,KAC9B,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AAM9B,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C/D;AAMD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,CAuDb;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAO1B"}

package/dist/adapters/script-adapter.js

@@ -0,0 +1,107 @@
+/**
+ * Script Adapter
+ *
+ * Executes a local script (bash/python/Node) and reads JSON from stdout.
+ * The script receives tool arguments as a JSON string on stdin or via the
+ * WEAVE_TOOL_ARGS environment variable.
+ *
+ * Injectable spawn function for test isolation.
+ */
+import { spawn } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Script runner
+// ---------------------------------------------------------------------------
+export function runScript(scriptPath, actionName, args, env, timeoutMs, spawnFn = spawn) {
+    return new Promise((resolve) => {
+        const child = spawnFn(scriptPath, [actionName], {
+            env: {
+                ...process.env,
+                WEAVE_TOOL_ACTION: actionName,
+                WEAVE_TOOL_ARGS: JSON.stringify(args),
+                ...env,
+            },
+            shell: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGTERM');
+        }, timeoutMs);
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({
+                stdout,
+                stderr,
+                exitCode: timedOut ? -1 : (code ?? 0),
+            });
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ stdout: '', stderr: err.message, exitCode: -2 });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Handler factory
+// ---------------------------------------------------------------------------
+export function createScriptHandler(manifest, actionName, spawnFn) {
+    const scriptPath = manifest.scriptPath;
+    const timeoutMs = manifest.timeout_ms ?? 10_000;
+    const scriptEnv = manifest.scriptEnv ?? {};
+    return async (args) => {
+        const start = Date.now();
+        const prefixedName = `${manifest.id}__${actionName}`;
+        const { stdout, stderr, exitCode } = await runScript(scriptPath, actionName, args, scriptEnv, timeoutMs, spawnFn);
+        if (exitCode === -1) {
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: false,
+                error: `Script timeout after ${timeoutMs}ms`,
+                durationMs: Date.now() - start,
+            };
+        }
+        if (exitCode !== 0) {
+            return {
+                toolId: manifest.id,
+                action: prefixedName,
+                success: false,
+                error: stderr.trim() || `Script exited with code ${exitCode}`,
+                durationMs: Date.now() - start,
+            };
+        }
+        // Parse JSON from stdout
+        const trimmed = stdout.trim();
+        let data = trimmed;
+        try {
+            data = JSON.parse(trimmed);
+        }
+        catch {
+            // Return raw string if not valid JSON
+        }
+        return {
+            toolId: manifest.id,
+            action: prefixedName,
+            success: true,
+            data,
+            durationMs: Date.now() - start,
+        };
+    };
+}
+export function createScriptAdapter(manifest, spawnFn) {
+    const handlers = new Map();
+    for (const action of manifest.tools) {
+        const prefixedName = `${manifest.id}__${action.name}`;
+        handlers.set(prefixedName, createScriptHandler(manifest, action.name, spawnFn));
+    }
+    return handlers;
+}
+//# sourceMappingURL=script-adapter.js.map

package/dist/adapters/script-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-adapter.js","sourceRoot":"","sources":["../../src/adapters/script-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAiC,MAAM,oBAAoB,CAAC;AAa1E,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CACvB,UAAkB,EAClB,UAAkB,EAClB,IAA6B,EAC7B,GAA2B,EAC3B,SAAiB,EACjB,UAAmB,KAAK;IAExB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,EAAE;YAC9C,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,iBAAiB,EAAE,UAAU;gBAC7B,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBACrC,GAAG,GAAG;aACP;YACD,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC;gBACN,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;aACtC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CACjC,QAAsB,EACtB,UAAkB,EAClB,OAAiB;IAEjB,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAW,CAAC;IACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;IAE3C,OAAO,KAAK,EAAE,IAA6B,EAA2B,EAAE;QACtE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,GAAG,QAAQ,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QAErD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,SAAS,CAClD,UAAU,EACV,UAAU,EACV,IAAI,EACJ,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;QAEF,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB,SAAS,IAAI;gBAC5C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,2BAA2B,QAAQ,EAAE;gBAC7D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,GAAY,OAAO,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,EAAE;YACnB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAsB,EACtB,OAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,GAAG,QAAQ,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QACtD,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @openweave/weave-tools
+ *
+ * External Tool Registry & Adapters — M24
+ * Enables users and developers to register any external tool and expose it
+ * to the OpenWeave agent as if it were a native tool.
+ */
+export { validateManifest, type AdapterType, type AuthType, type ToolAuth, type ToolInputSchema, type ToolAction, type ToolManifest, type ManifestValidationResult, type ToolCallResult, type ToolHandler, type RegisteredExternalTool, } from './types.js';
+export { buildAuthHeaders, createHttpHandler, createHttpAdapter, type FetchFn, type HttpAdapterOptions, } from './adapters/http-adapter.js';
+export { createMcpHandler, createMcpAdapter, } from './adapters/mcp-adapter.js';
+export { runScript, createScriptHandler, createScriptAdapter, type SpawnFn, } from './adapters/script-adapter.js';
+export { loadManifestFile, loadLocalManifests, loadNpmManifests, loadAllManifests, type LoadResult, type FsAdapter as LoaderFsAdapter, } from './tool-loader.js';
+export { ToolStore, createToolStore, type ToolStoreData, } from './tool-store.js';
+export { ExternalToolBridge, type ToolRegistryLike, } from './tool-bridge.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;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,OAAO,GACb,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,IAAI,eAAe,GAClC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @openweave/weave-tools
+ *
+ * External Tool Registry & Adapters — M24
+ * Enables users and developers to register any external tool and expose it
+ * to the OpenWeave agent as if it were a native tool.
+ */
+// Types
+export { validateManifest, } from './types.js';
+// Adapters
+export { buildAuthHeaders, createHttpHandler, createHttpAdapter, } from './adapters/http-adapter.js';
+export { createMcpHandler, createMcpAdapter, } from './adapters/mcp-adapter.js';
+export { runScript, createScriptHandler, createScriptAdapter, } from './adapters/script-adapter.js';
+// Loader
+export { loadManifestFile, loadLocalManifests, loadNpmManifests, loadAllManifests, } from './tool-loader.js';
+// Store
+export { ToolStore, createToolStore, } from './tool-store.js';
+// Bridge
+export { ExternalToolBridge, } from './tool-bridge.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;;;;;;GAMG;AAEH,QAAQ;AACR,OAAO,EACL,gBAAgB,GAWjB,MAAM,YAAY,CAAC;AAEpB,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AAEtC,SAAS;AACT,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GAGjB,MAAM,kBAAkB,CAAC;AAE1B,QAAQ;AACR,OAAO,EACL,SAAS,EACT,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,kBAAkB,GAEnB,MAAM,kBAAkB,CAAC"}

package/dist/tool-bridge.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ExternalToolBridge
+ *
+ * Orchestrates tool discovery, manifest loading, adapter creation and
+ * registration into any object that exposes a `register(name, handler)` API.
+ *
+ * This is the main entry point called from `AgentCore.init()`.
+ *
+ * Design:
+ *   - Loads manifests from ToolLoader (local + npm)
+ *   - Persists to ToolStore
+ *   - Creates adapter handlers (HTTP / MCP / Script)
+ *   - Registers prefixed action names into the provided registry
+ */
+import { type FsAdapter } from './tool-loader.js';
+import { ToolStore } from './tool-store.js';
+import { type ToolManifest, type RegisteredExternalTool, type ToolCallResult } from './types.js';
+export interface ToolRegistryLike {
+    /** Register a new tool action */
+    register(def: {
+        name: string;
+        description: string;
+        parameters?: unknown;
+    }, handler: (args: Record<string, unknown>) => Promise<ToolCallResult>): void;
+}
+export declare class ExternalToolBridge {
+    private readonly registeredTools;
+    private readonly store;
+    private readonly projectRoot;
+    constructor(projectRoot: string, store?: ToolStore);
+    private createHandlers;
+    /**
+     * Register a single manifest and wire its handlers into the registry.
+     */
+    registerManifest(manifest: ToolManifest, registry?: ToolRegistryLike): RegisteredExternalTool;
+    /**
+     * Load all manifests from disk and register them.
+     * Called from AgentCore.init().
+     */
+    loadAll(registry?: ToolRegistryLike, fs?: FsAdapter): Promise<{
+        loaded: number;
+        errors: Array<{
+            source: string;
+            error: string;
+        }>;
+    }>;
+    get(id: string): RegisteredExternalTool | undefined;
+    list(): RegisteredExternalTool[];
+    has(id: string): boolean;
+    get size(): number;
+    /** Remove a tool at runtime */
+    unregister(id: string): boolean;
+    /**
+     * Execute an action directly (useful when calling from the CLI `weave tools test`).
+     */
+    execute(prefixedActionName: string, args: Record<string, unknown>): Promise<ToolCallResult>;
+}
+//# sourceMappingURL=tool-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.d.ts","sourceRoot":"","sources":["../src/tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,CACN,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,EAChE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,IAAI,CAAC;CACT;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkD;IAClF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS;IAOlD,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,sBAAsB;IAkCzB;;;OAGG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;QAClE,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD,CAAC;IAcF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAInD,IAAI,IAAI,sBAAsB,EAAE;IAIhC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+BAA+B;IAC/B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAM/B;;OAEG;IACG,OAAO,CACX,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC;CAgB3B"}

package/dist/tool-bridge.js

@@ -0,0 +1,125 @@
+/**
+ * ExternalToolBridge
+ *
+ * Orchestrates tool discovery, manifest loading, adapter creation and
+ * registration into any object that exposes a `register(name, handler)` API.
+ *
+ * This is the main entry point called from `AgentCore.init()`.
+ *
+ * Design:
+ *   - Loads manifests from ToolLoader (local + npm)
+ *   - Persists to ToolStore
+ *   - Creates adapter handlers (HTTP / MCP / Script)
+ *   - Registers prefixed action names into the provided registry
+ */
+import { createHttpAdapter } from './adapters/http-adapter.js';
+import { createMcpAdapter } from './adapters/mcp-adapter.js';
+import { createScriptAdapter } from './adapters/script-adapter.js';
+import { loadAllManifests } from './tool-loader.js';
+import { ToolStore } from './tool-store.js';
+// ---------------------------------------------------------------------------
+// ExternalToolBridge
+// ---------------------------------------------------------------------------
+export class ExternalToolBridge {
+    registeredTools = new Map();
+    store;
+    projectRoot;
+    constructor(projectRoot, store) {
+        this.projectRoot = projectRoot;
+        this.store = store ?? new ToolStore(projectRoot);
+    }
+    // -------------------------------------------------------------------------
+    createHandlers(manifest) {
+        switch (manifest.adapter) {
+            case 'http':
+                return createHttpAdapter({ manifest });
+            case 'mcp':
+                return createMcpAdapter(manifest);
+            case 'script':
+                return createScriptAdapter(manifest);
+            default:
+                return new Map();
+        }
+    }
+    /**
+     * Register a single manifest and wire its handlers into the registry.
+     */
+    registerManifest(manifest, registry) {
+        const handlers = this.createHandlers(manifest);
+        const actionNames = Array.from(handlers.keys());
+        const registered = {
+            manifest,
+            actionNames,
+            handlers,
+            registeredAt: new Date().toISOString(),
+        };
+        this.registeredTools.set(manifest.id, registered);
+        this.store.add(manifest);
+        // Wire handlers into the registry (if provided)
+        if (registry) {
+            for (const action of manifest.tools) {
+                const prefixedName = `${manifest.id}__${action.name}`;
+                const handler = handlers.get(prefixedName);
+                if (handler) {
+                    registry.register({
+                        name: prefixedName,
+                        description: `[${manifest.name}] ${action.description}`,
+                    }, handler);
+                }
+            }
+        }
+        return registered;
+    }
+    /**
+     * Load all manifests from disk and register them.
+     * Called from AgentCore.init().
+     */
+    async loadAll(registry, fs) {
+        const { manifests, errors } = loadAllManifests(this.projectRoot, fs);
+        for (const manifest of manifests) {
+            this.registerManifest(manifest, registry);
+        }
+        return { loaded: manifests.length, errors };
+    }
+    // -------------------------------------------------------------------------
+    // Query API
+    // -------------------------------------------------------------------------
+    get(id) {
+        return this.registeredTools.get(id);
+    }
+    list() {
+        return Array.from(this.registeredTools.values());
+    }
+    has(id) {
+        return this.registeredTools.has(id);
+    }
+    get size() {
+        return this.registeredTools.size;
+    }
+    /** Remove a tool at runtime */
+    unregister(id) {
+        const existed = this.registeredTools.delete(id);
+        this.store.remove(id);
+        return existed;
+    }
+    /**
+     * Execute an action directly (useful when calling from the CLI `weave tools test`).
+     */
+    async execute(prefixedActionName, args) {
+        // Find which tool owns this action
+        for (const reg of this.registeredTools.values()) {
+            const handler = reg.handlers.get(prefixedActionName);
+            if (handler) {
+                return handler(args);
+            }
+        }
+        return {
+            toolId: 'unknown',
+            action: prefixedActionName,
+            success: false,
+            error: `Action "${prefixedActionName}" not found in any registered tool`,
+            durationMs: 0,
+        };
+    }
+}
+//# sourceMappingURL=tool-bridge.js.map

package/dist/tool-bridge.js.map

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

package/dist/tool-loader.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tool Loader
+ *
+ * Discovers ToolManifest descriptors from:
+ *   1. `.weave/tools/*.tool.json` — local project manifests
+ *   2. npm packages under `node_modules/@openweave-tools/` — community adapters
+ *
+ * Injectable FS functions for test isolation.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { type ToolManifest } from './types.js';
+export interface LoadResult {
+    manifests: ToolManifest[];
+    errors: Array<{
+        source: string;
+        error: string;
+    }>;
+}
+export interface FsAdapter {
+    existsSync: typeof existsSync;
+    readdirSync: typeof readdirSync;
+    readFileSync: typeof readFileSync;
+}
+export declare function loadManifestFile(filePath: string, fs?: FsAdapter): {
+    manifest: ToolManifest | null;
+    error: string | null;
+};
+/** Scans `.weave/tools/` directory for `*.tool.json` files. */
+export declare function loadLocalManifests(projectRoot: string, fs?: FsAdapter): LoadResult;
+/** Scans `node_modules/@openweave-tools/` for community adapter packages. */
+export declare function loadNpmManifests(projectRoot: string, fs?: FsAdapter): LoadResult;
+/** Load all manifests: local + npm. */
+export declare function loadAllManifests(projectRoot: string, fs?: FsAdapter): LoadResult;
+//# sourceMappingURL=tool-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhE,OAAO,EAAoB,KAAK,YAAY,EAAiC,MAAM,YAAY,CAAC;AAMhG,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,YAAY,EAAE,OAAO,YAAY,CAAC;CACnC;AAQD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,EAAE,GAAE,SAAsB,GACzB;IAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAqBzD;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,EAAE,GAAE,SAAsB,GACzB,UAAU,CA0BZ;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,EAAE,GAAE,SAAsB,GACzB,UAAU,CA2BZ;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,EAAE,GAAE,SAAsB,GACzB,UAAU,CAQZ"}

package/dist/tool-loader.js

@@ -0,0 +1,103 @@
+/**
+ * Tool Loader
+ *
+ * Discovers ToolManifest descriptors from:
+ *   1. `.weave/tools/*.tool.json` — local project manifests
+ *   2. npm packages under `node_modules/@openweave-tools/` — community adapters
+ *
+ * Injectable FS functions for test isolation.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { validateManifest } from './types.js';
+const DEFAULT_FS = { existsSync, readdirSync, readFileSync };
+// ---------------------------------------------------------------------------
+// Loaders
+// ---------------------------------------------------------------------------
+export function loadManifestFile(filePath, fs = DEFAULT_FS) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        return { manifest: null, error: `Cannot read file: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return { manifest: null, error: `Invalid JSON in ${filePath}` };
+    }
+    const validation = validateManifest(parsed);
+    if (!validation.valid) {
+        return { manifest: null, error: `Validation failed: ${validation.errors.join('; ')}` };
+    }
+    return { manifest: parsed, error: null };
+}
+/** Scans `.weave/tools/` directory for `*.tool.json` files. */
+export function loadLocalManifests(projectRoot, fs = DEFAULT_FS) {
+    const toolsDir = join(projectRoot, '.weave', 'tools');
+    const result = { manifests: [], errors: [] };
+    if (!fs.existsSync(toolsDir))
+        return result;
+    let entries;
+    try {
+        entries = fs.readdirSync(toolsDir);
+    }
+    catch (err) {
+        result.errors.push({ source: toolsDir, error: String(err) });
+        return result;
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith('.tool.json'))
+            continue;
+        const filePath = join(toolsDir, entry);
+        const { manifest, error } = loadManifestFile(filePath, fs);
+        if (error) {
+            result.errors.push({ source: filePath, error });
+        }
+        else if (manifest) {
+            result.manifests.push(manifest);
+        }
+    }
+    return result;
+}
+/** Scans `node_modules/@openweave-tools/` for community adapter packages. */
+export function loadNpmManifests(projectRoot, fs = DEFAULT_FS) {
+    const nmDir = join(projectRoot, 'node_modules', '@openweave-tools');
+    const result = { manifests: [], errors: [] };
+    if (!fs.existsSync(nmDir))
+        return result;
+    let pkgs;
+    try {
+        pkgs = fs.readdirSync(nmDir);
+    }
+    catch {
+        return result;
+    }
+    for (const pkg of pkgs) {
+        // Each @openweave-tools/<pkg> may have an `openweave.tool.json` at its root
+        const manifestPath = join(nmDir, pkg, 'openweave.tool.json');
+        if (!fs.existsSync(manifestPath))
+            continue;
+        const { manifest, error } = loadManifestFile(manifestPath, fs);
+        if (error) {
+            result.errors.push({ source: manifestPath, error });
+        }
+        else if (manifest) {
+            result.manifests.push(manifest);
+        }
+    }
+    return result;
+}
+/** Load all manifests: local + npm. */
+export function loadAllManifests(projectRoot, fs = DEFAULT_FS) {
+    const local = loadLocalManifests(projectRoot, fs);
+    const npm = loadNpmManifests(projectRoot, fs);
+    return {
+        manifests: [...local.manifests, ...npm.manifests],
+        errors: [...local.errors, ...npm.errors],
+    };
+}
+//# sourceMappingURL=tool-loader.js.map

package/dist/tool-loader.js.map

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

package/dist/tool-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool Store
+ *
+ * Persists registered tool manifests to `.weave/tools.json`.
+ * Supports add / remove / list / get operations.
+ *
+ * Injectable FS functions for test isolation.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import type { ToolManifest } from './types.js';
+export interface ToolStoreData {
+    version: 1;
+    tools: Record<string, ToolManifest>;
+    updatedAt: string;
+}
+export interface FsAdapter {
+    existsSync: typeof existsSync;
+    readFileSync: typeof readFileSync;
+    writeFileSync: typeof writeFileSync;
+    mkdirSync: typeof mkdirSync;
+}
+export declare class ToolStore {
+    private readonly storePath;
+    private readonly fs;
+    constructor(projectRoot: string, fs?: FsAdapter);
+    private read;
+    private write;
+    add(manifest: ToolManifest): void;
+    remove(id: string): boolean;
+    get(id: string): ToolManifest | null;
+    list(): ToolManifest[];
+    has(id: string): boolean;
+    size(): number;
+    clear(): void;
+}
+export declare function createToolStore(projectRoot: string, fs?: FsAdapter): ToolStore;
+//# sourceMappingURL=tool-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-store.d.ts","sourceRoot":"","sources":["../src/tool-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AAQD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;gBAEnB,WAAW,EAAE,MAAM,EAAE,EAAE,GAAE,SAAsB;IAO3D,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,KAAK;IAUb,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKpC,IAAI,IAAI,YAAY,EAAE;IAKtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAKxB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;CAGd;AAMD,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,EAAE,CAAC,EAAE,SAAS,GACb,SAAS,CAEX"}

package/dist/tool-store.js

@@ -0,0 +1,83 @@
+/**
+ * Tool Store
+ *
+ * Persists registered tool manifests to `.weave/tools.json`.
+ * Supports add / remove / list / get operations.
+ *
+ * Injectable FS functions for test isolation.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+const DEFAULT_FS = { existsSync, readFileSync, writeFileSync, mkdirSync };
+// ---------------------------------------------------------------------------
+// ToolStore
+// ---------------------------------------------------------------------------
+export class ToolStore {
+    storePath;
+    fs;
+    constructor(projectRoot, fs = DEFAULT_FS) {
+        this.storePath = join(projectRoot, '.weave', 'tools.json');
+        this.fs = fs;
+    }
+    // -------------------------------------------------------------------------
+    read() {
+        if (!this.fs.existsSync(this.storePath)) {
+            return { version: 1, tools: {}, updatedAt: new Date().toISOString() };
+        }
+        try {
+            const raw = this.fs.readFileSync(this.storePath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { version: 1, tools: {}, updatedAt: new Date().toISOString() };
+        }
+    }
+    write(data) {
+        const dir = dirname(this.storePath);
+        if (!this.fs.existsSync(dir)) {
+            this.fs.mkdirSync(dir, { recursive: true });
+        }
+        this.fs.writeFileSync(this.storePath, JSON.stringify(data, null, 2), 'utf8');
+    }
+    // -------------------------------------------------------------------------
+    add(manifest) {
+        const data = this.read();
+        data.tools[manifest.id] = manifest;
+        data.updatedAt = new Date().toISOString();
+        this.write(data);
+    }
+    remove(id) {
+        const data = this.read();
+        if (!(id in data.tools))
+            return false;
+        delete data.tools[id];
+        data.updatedAt = new Date().toISOString();
+        this.write(data);
+        return true;
+    }
+    get(id) {
+        const data = this.read();
+        return data.tools[id] ?? null;
+    }
+    list() {
+        const data = this.read();
+        return Object.values(data.tools);
+    }
+    has(id) {
+        const data = this.read();
+        return id in data.tools;
+    }
+    size() {
+        return this.list().length;
+    }
+    clear() {
+        this.write({ version: 1, tools: {}, updatedAt: new Date().toISOString() });
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createToolStore(projectRoot, fs) {
+    return new ToolStore(projectRoot, fs);
+}
+//# sourceMappingURL=tool-store.js.map

package/dist/tool-store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * WeaveTools — Type Definitions (M24)
+ *
+ * Core contracts for the External Tool Registry & Adapters system.
+ * A ToolManifest describes any external tool; adapters route calls to the right backend.
+ */
+/** Transport mechanism used to reach the external tool. */
+export type AdapterType = 'http' | 'mcp' | 'script';
+/** Authentication strategies for HTTP/MCP adapters. */
+export type AuthType = 'bearer' | 'api-key' | 'basic' | 'none';
+export interface ToolAuth {
+    type: AuthType;
+    /** Name of the environment variable holding the credential */
+    envVar?: string;
+    /** HTTP header name for api-key auth (default: 'X-API-Key') */
+    headerName?: string;
+}
+export interface ToolInputSchema {
+    type: 'object';
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        enum?: unknown[];
+    }>;
+    required?: string[];
+}
+/** A single callable action within an external tool manifest. */
+export interface ToolAction {
+    /** Matches the MCP tool name / HTTP action path */
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+}
+export interface ToolManifest {
+    /** Unique identifier, used as prefix: `<id>__<action>` */
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    adapter: AdapterType;
+    endpoint?: string;
+    auth?: ToolAuth;
+    /** Path to executable script (relative to project root) */
+    scriptPath?: string;
+    /** Extra environment variables to pass to the script */
+    scriptEnv?: Record<string, string>;
+    /** Timeout in milliseconds (default: 10 000) */
+    timeout_ms?: number;
+    tools: ToolAction[];
+}
+export interface ManifestValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateManifest(manifest: unknown): ManifestValidationResult;
+/** Result of invoking a single tool action. */
+export interface ToolCallResult {
+    toolId: string;
+    action: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    durationMs: number;
+}
+/** Internal handler function registered in the tool registry for each action. */
+export type ToolHandler = (args: Record<string, unknown>) => Promise<ToolCallResult>;
+/** A registered external tool with its resolved handler. */
+export interface RegisteredExternalTool {
+    manifest: ToolManifest;
+    /** Prefixed action names: `<id>__<action>` */
+    actionNames: string[];
+    handlers: Map<string, ToolHandler>;
+    registeredAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpD,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACrF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAMD,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IAGrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAGhB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,wBAAwB,CA4C5E;AAMD,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAErF,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,52 @@
+/**
+ * WeaveTools — Type Definitions (M24)
+ *
+ * Core contracts for the External Tool Registry & Adapters system.
+ * A ToolManifest describes any external tool; adapters route calls to the right backend.
+ */
+export function validateManifest(manifest) {
+    const errors = [];
+    if (!manifest || typeof manifest !== 'object') {
+        return { valid: false, errors: ['Manifest must be an object'] };
+    }
+    const m = manifest;
+    if (!m['id'] || typeof m['id'] !== 'string')
+        errors.push('Missing required field: id (string)');
+    if (!m['name'] || typeof m['name'] !== 'string')
+        errors.push('Missing required field: name (string)');
+    if (!m['description'] || typeof m['description'] !== 'string')
+        errors.push('Missing required field: description (string)');
+    if (!m['version'] || typeof m['version'] !== 'string')
+        errors.push('Missing required field: version (string)');
+    const validAdapters = ['http', 'mcp', 'script'];
+    if (!validAdapters.includes(m['adapter'])) {
+        errors.push(`Invalid adapter "${m['adapter']}" — must be one of: ${validAdapters.join(', ')}`);
+    }
+    if (m['adapter'] === 'http' || m['adapter'] === 'mcp') {
+        if (!m['endpoint'] || typeof m['endpoint'] !== 'string') {
+            errors.push('HTTP/MCP adapter requires endpoint (string)');
+        }
+    }
+    if (m['adapter'] === 'script') {
+        if (!m['scriptPath'] || typeof m['scriptPath'] !== 'string') {
+            errors.push('Script adapter requires scriptPath (string)');
+        }
+    }
+    if (!Array.isArray(m['tools'])) {
+        errors.push('Missing required field: tools (array)');
+    }
+    else if (m['tools'].length === 0) {
+        errors.push('tools array must contain at least one action');
+    }
+    else {
+        for (const t of m['tools']) {
+            const tool = t;
+            if (!tool['name'])
+                errors.push(`Tool action missing "name" field`);
+            if (!tool['description'])
+                errors.push(`Tool action "${tool['name']}" missing "description"`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@openweave/weave-tools",
+  "version": "1.0.0",
+  "description": "WeaveTools — External Tool Registry & Adapters for OpenWeave agent extensibility",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "openweave",
+    "tools",
+    "adapters",
+    "mcp",
+    "agent",
+    "extensibility"
+  ],
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --max-warnings 0",
+    "clean": "rm -rf dist"
+  }
+}