@sprinterai/runtime 0.4.1 → 0.6.0

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

@@ -1,13 +1,59 @@
 /**
- * Adapter for generic HTTP agent endpoints.
- *
- * Wraps any HTTP endpoint that accepts JSON and returns JSON
- * as a callable agent interface.
- *
- * Note: This is a stub. Implement with your preferred HTTP client.
- * Throws if not configured.
+ * Create a callable HTTP agent endpoint.
+ * Wraps any HTTP endpoint that accepts/returns JSON as a callable agent interface.
  */
-export async function createHTTPAgent(_config) {
-    throw new Error("HTTP agent adapter not configured. Provide an HTTP client implementation.");
+export function createHTTPAgent(config) {
+    const { endpointUrl, method = 'POST', headers: customHeaders = {}, authToken, timeoutMs = 30_000, } = config;
+    const baseHeaders = {
+        'Content-Type': 'application/json',
+        Accept: 'application/json',
+        ...customHeaders,
+    };
+    if (authToken) {
+        baseHeaders['Authorization'] = `Bearer ${authToken}`;
+    }
+    return {
+        config,
+        async send(input) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const fetchOptions = {
+                    method,
+                    headers: baseHeaders,
+                    // AbortController.signal type varies across Node.js/DOM environments
+                    signal: controller.signal,
+                };
+                let url = endpointUrl;
+                if (method === 'POST') {
+                    fetchOptions.body = JSON.stringify(input);
+                }
+                else if (Object.keys(input).length > 0) {
+                    const params = new URL(endpointUrl);
+                    for (const [key, value] of Object.entries(input)) {
+                        params.searchParams.set(key, String(value));
+                    }
+                    url = params.toString();
+                }
+                const response = await fetch(url, fetchOptions);
+                const responseHeaders = {};
+                response.headers.forEach((value, key) => {
+                    responseHeaders[key] = value;
+                });
+                let data;
+                const contentType = response.headers.get('content-type') ?? '';
+                if (contentType.includes('application/json')) {
+                    data = await response.json();
+                }
+                else {
+                    data = await response.text();
+                }
+                return { status: response.status, data, headers: responseHeaders };
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        },
+    };
 }
 //# sourceMappingURL=http-agent-adapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"http-agent-adapter.js","sourceRoot":"","sources":["../../src/adapters/http-agent-adapter.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"http-agent-adapter.js","sourceRoot":"","sources":["../../src/adapters/http-agent-adapter.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,EACJ,WAAW,EACX,MAAM,GAAG,MAAM,EACf,OAAO,EAAE,aAAa,GAAG,EAAE,EAC3B,SAAS,EACT,SAAS,GAAG,MAAM,GACnB,GAAG,MAAM,CAAC;IAEX,MAAM,WAAW,GAA2B;QAC1C,cAAc,EAAE,kBAAkB;QAClC,MAAM,EAAE,kBAAkB;QAC1B,GAAG,aAAa;KACjB,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,WAAW,CAAC,eAAe,CAAC,GAAG,UAAU,SAAS,EAAE,CAAC;IACvD,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK,CAAC,IAAI,CAAC,KAA8B;YACvC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;YAElE,IAAI,CAAC;gBACH,MAAM,YAAY,GAAgB;oBAChC,MAAM;oBACN,OAAO,EAAE,WAAW;oBACpB,qEAAqE;oBACrE,MAAM,EAAE,UAAU,CAAC,MAAqB;iBACzC,CAAC;gBACF,IAAI,GAAG,GAAG,WAAW,CAAC;gBACtB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACtB,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;qBAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;oBACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjD,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC9C,CAAC;oBACD,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC1B,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBAChD,MAAM,eAAe,GAA2B,EAAE,CAAC;gBACnD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACtC,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBAEH,IAAI,IAAa,CAAC;gBAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBAC/D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC7C,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC/B,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC/B,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;YACrE,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/http-agent-adapter.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-agent-adapter.test.d.ts","sourceRoot":"","sources":["../../src/adapters/http-agent-adapter.test.ts"],"names":[],"mappings":""}

package/dist/adapters/http-agent-adapter.test.js

@@ -0,0 +1,164 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createHTTPAgent } from './http-agent-adapter.js';
+/** Create a minimal mock Response compatible with the adapter's usage. */
+function mockFetchResponse(body, options) {
+    const status = options?.status ?? 200;
+    const contentType = options?.contentType ?? 'application/json';
+    const headers = new Headers({ 'content-type': contentType });
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        headers,
+        json: () => Promise.resolve(body),
+        text: () => Promise.resolve(typeof body === 'string' ? body : JSON.stringify(body)),
+    });
+}
+describe('createHTTPAgent', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    it('returns synchronously with config and send method', () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const config = { endpointUrl: 'https://api.example.com/agent' };
+        const agent = createHTTPAgent(config);
+        expect(agent.config).toBe(config);
+        expect(typeof agent.send).toBe('function');
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+    it('send() with POST sends JSON body and returns parsed JSON response', async () => {
+        const responseBody = { result: 'hello' };
+        const mockFetch = mockFetchResponse(responseBody);
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/agent',
+            method: 'POST',
+        });
+        const result = await agent.send({ prompt: 'hi' });
+        expect(result.status).toBe(200);
+        expect(result.data).toEqual(responseBody);
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, options] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://api.example.com/agent');
+        expect(options.method).toBe('POST');
+        expect(options.body).toBe(JSON.stringify({ prompt: 'hi' }));
+        expect(options.headers['Content-Type']).toBe('application/json');
+    });
+    it('send() with GET encodes input as query parameters (no body)', async () => {
+        const mockFetch = mockFetchResponse({ ok: true });
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/search',
+            method: 'GET',
+        });
+        await agent.send({ q: 'test', limit: 10 });
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, options] = mockFetch.mock.calls[0];
+        expect(url).toContain('q=test');
+        expect(url).toContain('limit=10');
+        expect(options.method).toBe('GET');
+        expect(options.body).toBeUndefined();
+    });
+    it('send() with GET and empty input adds no query params', async () => {
+        const mockFetch = mockFetchResponse({ ok: true });
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/search',
+            method: 'GET',
+        });
+        await agent.send({});
+        const [url] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://api.example.com/search');
+    });
+    it('includes Bearer auth token in headers when provided', async () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/agent',
+            authToken: 'my-secret-token',
+        });
+        await agent.send({ data: 'value' });
+        const [, options] = mockFetch.mock.calls[0];
+        const headers = options.headers;
+        expect(headers['Authorization']).toBe('Bearer my-secret-token');
+    });
+    it('merges custom headers with defaults', async () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/agent',
+            headers: { 'X-Custom': 'custom-value', Accept: 'text/plain' },
+        });
+        await agent.send({});
+        const [, options] = mockFetch.mock.calls[0];
+        const headers = options.headers;
+        expect(headers['Content-Type']).toBe('application/json');
+        expect(headers['X-Custom']).toBe('custom-value');
+        // Custom Accept overrides default
+        expect(headers['Accept']).toBe('text/plain');
+    });
+    it('handles text response (non-JSON content-type)', async () => {
+        const mockFetch = mockFetchResponse('plain text response', {
+            contentType: 'text/plain',
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({ endpointUrl: 'https://api.example.com/agent' });
+        const result = await agent.send({});
+        expect(result.data).toBe('plain text response');
+    });
+    it('returns non-200 status codes in response (not thrown)', async () => {
+        const mockFetch = mockFetchResponse({ error: 'not found' }, { status: 404 });
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({ endpointUrl: 'https://api.example.com/agent' });
+        const result = await agent.send({});
+        expect(result.status).toBe(404);
+        expect(result.data).toEqual({ error: 'not found' });
+    });
+    it('collects response headers into a plain object', async () => {
+        const responseHeaders = new Headers({
+            'content-type': 'application/json',
+            'x-request-id': 'abc-123',
+        });
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            headers: responseHeaders,
+            json: () => Promise.resolve({}),
+        }));
+        const agent = createHTTPAgent({ endpointUrl: 'https://api.example.com/agent' });
+        const result = await agent.send({});
+        expect(result.headers['content-type']).toBe('application/json');
+        expect(result.headers['x-request-id']).toBe('abc-123');
+    });
+    it('aborts request after timeout via AbortController', async () => {
+        const abortError = new DOMException('The operation was aborted', 'AbortError');
+        const mockFetch = vi.fn().mockImplementation((_url, options) => new Promise((_resolve, reject) => {
+            options.signal.addEventListener('abort', () => {
+                reject(abortError);
+            });
+        }));
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({
+            endpointUrl: 'https://api.example.com/agent',
+            timeoutMs: 5000,
+        });
+        const sendPromise = agent.send({ data: 'test' });
+        // Advance past the timeout
+        vi.advanceTimersByTime(5001);
+        await expect(sendPromise).rejects.toThrow('aborted');
+    });
+    it('defaults to POST method when not specified', async () => {
+        const mockFetch = mockFetchResponse({});
+        vi.stubGlobal('fetch', mockFetch);
+        const agent = createHTTPAgent({ endpointUrl: 'https://api.example.com/agent' });
+        await agent.send({ msg: 'hello' });
+        const [, options] = mockFetch.mock.calls[0];
+        expect(options.method).toBe('POST');
+        expect(options.body).toBe(JSON.stringify({ msg: 'hello' }));
+    });
+});
+//# sourceMappingURL=http-agent-adapter.test.js.map

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

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

package/dist/adapters/index.d.ts

@@ -1,9 +1,9 @@
-export { discoverMCPTools } from "./mcp-adapter";
-export type { MCPAdapterConfig } from "./mcp-adapter";
-export { createA2AAgent } from "./a2a-adapter";
-export type { A2AAdapterConfig } from "./a2a-adapter";
-export { createOpenClawModel } from "./openclaw-adapter";
-export type { OpenClawAdapterConfig } from "./openclaw-adapter";
-export { createHTTPAgent } from "./http-agent-adapter";
-export type { HTTPAgentAdapterConfig } from "./http-agent-adapter";
+export { createHTTPAgent } from './http-agent-adapter.js';
+export type { HTTPAgentAdapterConfig, HTTPAgentResponse, HTTPAgentEndpoint, } from './http-agent-adapter.js';
+export { createA2AAgent, discoverA2AAgent } from './a2a-adapter.js';
+export type { A2AAdapterConfig, A2ATaskInput, A2ATaskResult, A2AAgentEndpoint, } from './a2a-adapter.js';
+export { discoverMCPTools } from './mcp-adapter.js';
+export type { MCPAdapterConfig, MCPClientLike, MCPToolInfo, MCPToolCallResult, } from './mcp-adapter.js';
+export { createOpenClawModel } from './openclaw-adapter.js';
+export type { OpenClawAdapterConfig, OpenClawModel } from './openclaw-adapter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/adapters/index.js

@@ -1,5 +1,5 @@
-export { discoverMCPTools } from "./mcp-adapter";
-export { createA2AAgent } from "./a2a-adapter";
-export { createOpenClawModel } from "./openclaw-adapter";
-export { createHTTPAgent } from "./http-agent-adapter";
+export { createHTTPAgent } from './http-agent-adapter.js';
+export { createA2AAgent, discoverA2AAgent } from './a2a-adapter.js';
+export { discoverMCPTools } from './mcp-adapter.js';
+export { createOpenClawModel } from './openclaw-adapter.js';
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -1,19 +1,39 @@
-import type { ToolDefinition } from "@sprinterai/core";
+import type { ToolDefinition } from '@sprinterai/core';
+/** Minimal interface for an MCP client -- inject your own implementation. */
+export interface MCPClientLike {
+    listTools(): Promise<MCPToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<MCPToolCallResult>;
+}
+/** MCP tool metadata returned from listTools(). */
+export interface MCPToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/** Result from an MCP tool call. */
+export interface MCPToolCallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: unknown;
+    }>;
+    isError?: boolean;
+}
 /** Configuration for an MCP server connection. */
 export interface MCPAdapterConfig {
-    /** MCP server URL. */
+    /** MCP server URL (for documentation/logging; the client handles the actual connection). */
     serverUrl: string;
     /** Authentication token if required. */
     authToken?: string;
+    /** Pre-configured MCP client instance. */
+    client: MCPClientLike;
 }
 /**
- * Adapter to convert MCP server tools into platform ToolDefinitions.
- *
- * MCP (Model Context Protocol) servers expose tools via a standard protocol.
- * This adapter discovers and wraps them as platform tools.
+ * Discover and convert MCP server tools into platform ToolDefinitions.
  *
- * Note: Requires an MCP client library at runtime.
- * Throws if the adapter is not configured with a client.
+ * The caller is responsible for creating and configuring the MCP client.
+ * This adapter converts MCP tools into the platform's ToolDefinition format
+ * and proxies tool execution back through the MCP client.
  */
-export declare function discoverMCPTools(_config: MCPAdapterConfig): Promise<ToolDefinition[]>;
+export declare function discoverMCPTools(config: MCPAdapterConfig): Promise<ToolDefinition[]>;
 //# sourceMappingURL=mcp-adapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAI3B"}
+{"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnF;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA2B1F"}

package/dist/adapters/mcp-adapter.js

@@ -1,13 +1,48 @@
+import { z } from 'zod';
 /**
- * Adapter to convert MCP server tools into platform ToolDefinitions.
+ * Discover and convert MCP server tools into platform ToolDefinitions.
  *
- * MCP (Model Context Protocol) servers expose tools via a standard protocol.
- * This adapter discovers and wraps them as platform tools.
- *
- * Note: Requires an MCP client library at runtime.
- * Throws if the adapter is not configured with a client.
+ * The caller is responsible for creating and configuring the MCP client.
+ * This adapter converts MCP tools into the platform's ToolDefinition format
+ * and proxies tool execution back through the MCP client.
+ */
+export async function discoverMCPTools(config) {
+    const { client } = config;
+    const mcpTools = await client.listTools();
+    return mcpTools.map((tool) => ({
+        slug: `mcp-${tool.name}`,
+        name: tool.name,
+        description: tool.description ?? `MCP tool: ${tool.name}`,
+        category: 'mcp',
+        icon: 'plug',
+        inputSchema: jsonSchemaToPassthroughZod(tool.inputSchema),
+        async execute(input) {
+            const result = await client.callTool(tool.name, (input ?? {}));
+            if (result.isError) {
+                const errorText = result.content
+                    .map((c) => c.text ?? '')
+                    .filter(Boolean)
+                    .join('\n');
+                throw new Error(errorText || `MCP tool '${tool.name}' failed`);
+            }
+            // Return text content if single text result, otherwise full content array
+            if (result.content.length === 1 && result.content[0].type === 'text') {
+                return result.content[0].text;
+            }
+            return result.content;
+        },
+    }));
+}
+/**
+ * Convert a JSON Schema object to a permissive Zod schema.
+ * The MCP server performs its own validation, so we use a passthrough schema
+ * that accepts any object shape.
  */
-export async function discoverMCPTools(_config) {
-    throw new Error("MCP adapter not configured. Install an MCP client library and provide it to the adapter.");
+function jsonSchemaToPassthroughZod(schema) {
+    if (!schema || schema.type !== 'object') {
+        return z.record(z.unknown());
+    }
+    // Use z.object({}).passthrough() for object schemas -- accepts any keys
+    return z.object({}).passthrough();
 }
 //# sourceMappingURL=mcp-adapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAyB;IAEzB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../src/adapters/mcp-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IAE1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,aAAa,IAAI,CAAC,IAAI,EAAE;QACzD,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,KAAc;YAC1B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC,CAAC;YAC1F,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;qBAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;qBACxB,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,aAAa,IAAI,CAAC,IAAI,UAAU,CAAC,CAAC;YACjE,CAAC;YACD,0EAA0E;YAC1E,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CAAC,MAAgC;IAClE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,wEAAwE;IACxE,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,118 @@
+import { describe, it, expect, vi } from 'vitest';
+import { discoverMCPTools } from './mcp-adapter.js';
+function createMockClient(tools = [], callResult) {
+    return {
+        listTools: vi.fn().mockResolvedValue(tools),
+        callTool: vi.fn().mockResolvedValue(callResult ?? {
+            content: [{ type: 'text', text: 'ok' }],
+            isError: false,
+        }),
+    };
+}
+describe('discoverMCPTools', () => {
+    it('returns empty array when server has no tools', async () => {
+        const client = createMockClient([]);
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        expect(tools).toEqual([]);
+    });
+    it('converts MCP tools to ToolDefinitions', async () => {
+        const mcpTools = [
+            { name: 'search', description: 'Search the web', inputSchema: { type: 'object' } },
+            { name: 'calc' },
+        ];
+        const client = createMockClient(mcpTools);
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        expect(tools).toHaveLength(2);
+        expect(tools[0].slug).toBe('mcp-search');
+        expect(tools[0].name).toBe('search');
+        expect(tools[0].description).toBe('Search the web');
+        expect(tools[0].category).toBe('mcp');
+        expect(tools[0].icon).toBe('plug');
+        expect(tools[1].slug).toBe('mcp-calc');
+        expect(tools[1].name).toBe('calc');
+        expect(tools[1].description).toBe('MCP tool: calc');
+    });
+    it('creates a passthrough zod schema for object inputSchema', async () => {
+        const mcpTools = [
+            { name: 'test', inputSchema: { type: 'object', properties: { q: { type: 'string' } } } },
+        ];
+        const client = createMockClient(mcpTools);
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        const schema = tools[0].inputSchema;
+        // Passthrough schema should accept any object
+        const result = schema.safeParse({ q: 'hello', extra: 123 });
+        expect(result.success).toBe(true);
+    });
+    it('creates a record schema for non-object inputSchema', async () => {
+        const mcpTools = [{ name: 'test', inputSchema: { type: 'string' } }];
+        const client = createMockClient(mcpTools);
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        const schema = tools[0].inputSchema;
+        const result = schema.safeParse({ anything: 'works' });
+        expect(result.success).toBe(true);
+    });
+    it('creates a record schema when inputSchema is undefined', async () => {
+        const mcpTools = [{ name: 'test' }];
+        const client = createMockClient(mcpTools);
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        const schema = tools[0].inputSchema;
+        const result = schema.safeParse({ key: 'value' });
+        expect(result.success).toBe(true);
+    });
+    it('execute proxies to MCP client and returns single text content', async () => {
+        const mcpTools = [{ name: 'greet' }];
+        const client = createMockClient(mcpTools, {
+            content: [{ type: 'text', text: 'Hello world' }],
+            isError: false,
+        });
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        const result = await tools[0].execute({ name: 'Alice' });
+        expect(result).toBe('Hello world');
+        expect(client.callTool).toHaveBeenCalledWith('greet', { name: 'Alice' });
+    });
+    it('execute returns full content array for non-text or multiple results', async () => {
+        const multiContent = [
+            { type: 'text', text: 'part1' },
+            { type: 'image', data: 'base64data' },
+        ];
+        const mcpTools = [{ name: 'multi' }];
+        const client = createMockClient(mcpTools, {
+            content: multiContent,
+            isError: false,
+        });
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        const result = await tools[0].execute({});
+        expect(result).toEqual(multiContent);
+    });
+    it('execute throws on error result with error text', async () => {
+        const mcpTools = [{ name: 'fail' }];
+        const client = createMockClient(mcpTools, {
+            content: [{ type: 'text', text: 'Something went wrong' }],
+            isError: true,
+        });
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        await expect(tools[0].execute({})).rejects.toThrow('Something went wrong');
+    });
+    it('execute throws generic error when error result has no text', async () => {
+        const mcpTools = [{ name: 'fail' }];
+        const client = createMockClient(mcpTools, {
+            content: [{ type: 'binary' }],
+            isError: true,
+        });
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        await expect(tools[0].execute({})).rejects.toThrow("MCP tool 'fail' failed");
+    });
+    it('execute passes empty object when input is null/undefined', async () => {
+        const mcpTools = [{ name: 'noargs' }];
+        const client = createMockClient(mcpTools, {
+            content: [{ type: 'text', text: 'done' }],
+            isError: false,
+        });
+        const tools = await discoverMCPTools({ serverUrl: 'http://localhost', client });
+        await tools[0].execute(null);
+        expect(client.callTool).toHaveBeenCalledWith('noargs', {});
+        await tools[0].execute(undefined);
+        expect(client.callTool).toHaveBeenCalledWith('noargs', {});
+    });
+});
+//# sourceMappingURL=mcp-adapter.test.js.map

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

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

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

@@ -1,20 +1,46 @@
+import type { LanguageModel } from 'ai';
 /** Configuration for an OpenClaw connection. */
 export interface OpenClawAdapterConfig {
     /** OpenClaw base URL. */
     baseUrl: string;
     /** API key for authentication. */
     apiKey: string;
-    /** Model identifier on the OpenClaw endpoint. */
+    /** Model identifier on the OpenClaw endpoint (default: 'default'). */
     modelId?: string;
+    /**
+     * Model factory function. Creates a LanguageModel from the endpoint config.
+     *
+     * If not provided, the adapter attempts to dynamically import @ai-sdk/openai-compatible.
+     *
+     * Example using @ai-sdk/openai-compatible:
+     * ```
+     * import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+     * const provider = createOpenAICompatible({ baseURL: 'https://...', name: 'openclaw' });
+     * createOpenClawModel({ baseUrl, apiKey, createModel: () => provider.languageModel('model-id') });
+     * ```
+     */
+    createModel?: (config: {
+        baseUrl: string;
+        apiKey: string;
+        modelId: string;
+    }) => LanguageModel;
+}
+/** Result from creating an OpenClaw model. */
+export interface OpenClawModel {
+    /** The AI SDK LanguageModel instance. */
+    model: LanguageModel;
+    /** Provider name. */
+    provider: string;
+    /** Base URL of the endpoint. */
+    baseUrl: string;
+    /** Model ID used. */
+    modelId: string;
 }
 /**
- * Adapter for OpenClaw-compatible endpoints.
- *
- * OpenClaw provides an OpenAI-compatible API for accessing various models.
- * This adapter wraps an OpenClaw endpoint as a LanguageModelV1 provider.
+ * Create a LanguageModel from an OpenClaw-compatible endpoint.
  *
- * Note: Use @ai-sdk/openai-compatible to create the model provider.
- * Throws if not configured.
+ * Uses the provided createModel factory if available. Otherwise attempts
+ * to dynamically import @ai-sdk/openai-compatible.
  */
-export declare function createOpenClawModel(_config: OpenClawAdapterConfig): Promise<never>;
+export declare function createOpenClawModel(config: OpenClawAdapterConfig): Promise<OpenClawModel>;
 //# sourceMappingURL=openclaw-adapter.d.ts.map