@namzu/cli 0.0.2 → 0.1.0

package/dist/integrations/clawtool/index.js

@@ -0,0 +1,10 @@
+export { listAgents } from './agents.js';
+export { ClawtoolAuthError, readToken, tryReadToken } from './auth.js';
+export { ClawtoolBinaryError, findBinary } from './binary.js';
+export { ensureDaemon, ClawtoolDaemonError } from './daemon.js';
+export { sendMessage } from './dispatch.js';
+export { ClawtoolMcpClient, MCP_PROTOCOL_VERSION, McpProtocolError, } from './mcp.js';
+export { clawtoolConfigDir, daemonStatePath, listenerTokenPath, } from './paths.js';
+export { createClawtoolPlugin, } from './plugin.js';
+export { readDaemonState } from './state.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/clawtool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAA0B,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAA;AACrF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAA4B,MAAM,aAAa,CAAA;AACzF,OAAO,EAAsB,WAAW,EAA2B,MAAM,eAAe,CAAA;AACxF,OAAO,EACN,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GAEhB,MAAM,UAAU,CAAA;AACjB,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,oBAAoB,GAIpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/integrations/clawtool/mcp.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Minimal MCP-over-Streamable-HTTP client for clawtool's `/mcp` endpoint.
+ *
+ * We deliberately do not reuse `@namzu/sdk`'s `MCPClient` http-sse
+ * transport — that implementation targets the older MCP HTTP+SSE
+ * transport (separate /sse + /message channels), whereas clawtool uses
+ * the newer **Streamable HTTP** transport (single POST that may return
+ * a chunked SSE response with one or more `data:` events). Wire details
+ * verified against clawtool/internal/server/{http.go,mcp_headers.go}.
+ *
+ * Scope: `initialize` → `notifications/initialized` handshake, then
+ * `tools/list` and `tools/call`. Streaming multi-event responses are
+ * read fully before resolving (clawtool's current handlers return a
+ * single event per call).
+ */
+import type { McpCallResult, McpToolDescriptor } from './types.js';
+export declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+export declare class McpProtocolError extends Error {
+    readonly code?: number | undefined;
+    constructor(message: string, code?: number | undefined);
+}
+export interface McpClientOptions {
+    readonly endpoint: string;
+    readonly token: string;
+    readonly clientInfo?: {
+        name: string;
+        version: string;
+    };
+    /** Override `fetch` for tests. */
+    readonly fetch?: typeof fetch;
+    /** Per-request timeout in ms. Default 30s. */
+    readonly timeoutMs?: number;
+}
+export declare class ClawtoolMcpClient {
+    private readonly opts;
+    private id;
+    private initialized;
+    private sessionId;
+    private readonly fetchFn;
+    private readonly timeoutMs;
+    constructor(opts: McpClientOptions);
+    initialize(): Promise<void>;
+    listTools(): Promise<McpToolDescriptor[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<McpCallResult>;
+    private rpc;
+    private notify;
+    private captureSessionId;
+    private headers;
+    private readEnvelope;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/integrations/clawtool/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAElE,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAEhD,qBAAa,gBAAiB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBADtB,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAoBD,qBAAa,iBAAiB;IAOjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,EAAE,CAAI;IACd,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEL,IAAI,EAAE,gBAAgB;IAK7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAMzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;YAKrE,GAAG;YAqCH,MAAM;IAWpB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,OAAO;YAoBD,YAAY;CAQ1B"}

package/dist/integrations/clawtool/mcp.js

@@ -0,0 +1,156 @@
+/**
+ * Minimal MCP-over-Streamable-HTTP client for clawtool's `/mcp` endpoint.
+ *
+ * We deliberately do not reuse `@namzu/sdk`'s `MCPClient` http-sse
+ * transport — that implementation targets the older MCP HTTP+SSE
+ * transport (separate /sse + /message channels), whereas clawtool uses
+ * the newer **Streamable HTTP** transport (single POST that may return
+ * a chunked SSE response with one or more `data:` events). Wire details
+ * verified against clawtool/internal/server/{http.go,mcp_headers.go}.
+ *
+ * Scope: `initialize` → `notifications/initialized` handshake, then
+ * `tools/list` and `tools/call`. Streaming multi-event responses are
+ * read fully before resolving (clawtool's current handlers return a
+ * single event per call).
+ */
+export const MCP_PROTOCOL_VERSION = '2024-11-05';
+export class McpProtocolError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'McpProtocolError';
+    }
+}
+export class ClawtoolMcpClient {
+    opts;
+    id = 0;
+    initialized = false;
+    sessionId = null;
+    fetchFn;
+    timeoutMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchFn = opts.fetch ?? globalThis.fetch;
+        this.timeoutMs = opts.timeoutMs ?? 30_000;
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.rpc('initialize', {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            capabilities: {},
+            clientInfo: this.opts.clientInfo ?? { name: 'namzu', version: '0.0.0' },
+        });
+        // `notifications/initialized` is a notification — JSON-RPC with no
+        // `id`, no response expected. Fire and forget over the same endpoint.
+        await this.notify('notifications/initialized', {});
+        this.initialized = true;
+    }
+    async listTools() {
+        await this.initialize();
+        const result = await this.rpc('tools/list', {});
+        return result.tools;
+    }
+    async callTool(name, args) {
+        await this.initialize();
+        return this.rpc('tools/call', { name, arguments: args });
+    }
+    async rpc(method, params) {
+        const id = ++this.id;
+        const body = { jsonrpc: '2.0', id, method, params };
+        const url = `${this.opts.endpoint.replace(/\/$/, '')}/mcp`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await this.fetchFn(url, {
+                method: 'POST',
+                headers: this.headers(method, params),
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        this.captureSessionId(response);
+        if (!response.ok) {
+            throw new McpProtocolError(`clawtool MCP request to ${method} failed: HTTP ${response.status}`, response.status);
+        }
+        const envelope = await this.readEnvelope(response);
+        if (envelope.error) {
+            throw new McpProtocolError(`clawtool MCP method ${method} returned error: ${envelope.error.message}`, envelope.error.code);
+        }
+        if (envelope.result === undefined) {
+            throw new McpProtocolError(`clawtool MCP method ${method} returned no result`);
+        }
+        return envelope.result;
+    }
+    async notify(method, params) {
+        const body = { jsonrpc: '2.0', method, params };
+        const url = `${this.opts.endpoint.replace(/\/$/, '')}/mcp`;
+        const response = await this.fetchFn(url, {
+            method: 'POST',
+            headers: this.headers(method, params),
+            body: JSON.stringify(body),
+        });
+        this.captureSessionId(response);
+    }
+    captureSessionId(response) {
+        // MCP Streamable HTTP issues a session ID on `initialize` and expects
+        // it echoed on every subsequent request. clawtool returns it via the
+        // `Mcp-Session-Id` header (see internal/server/http.go + mark3labs/mcp-go).
+        const sid = response.headers.get('mcp-session-id') ?? response.headers.get('Mcp-Session-Id');
+        if (sid && sid.length > 0) {
+            this.sessionId = sid;
+        }
+    }
+    headers(method, params) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json, text/event-stream',
+            'Mcp-Method': method,
+        };
+        // Empty token = `--no-auth` daemon; omit Authorization entirely.
+        if (this.opts.token.length > 0) {
+            headers.Authorization = `Bearer ${this.opts.token}`;
+        }
+        if (this.sessionId) {
+            headers['Mcp-Session-Id'] = this.sessionId;
+        }
+        const name = typeof params.name === 'string' ? params.name : undefined;
+        if (name && (method === 'tools/call' || method === 'prompts/get')) {
+            headers['Mcp-Name'] = name;
+        }
+        return headers;
+    }
+    async readEnvelope(response) {
+        const ct = response.headers.get('content-type') ?? '';
+        const text = await response.text();
+        if (ct.includes('text/event-stream')) {
+            return parseSseSingleEvent(text);
+        }
+        return JSON.parse(text);
+    }
+}
+function parseSseSingleEvent(raw) {
+    // Streamable HTTP responses look like:
+    //   data: {"jsonrpc":"2.0", ...}
+    //   (blank line terminator)
+    // We accept multiple events but only return the last well-formed JSON
+    // envelope — clawtool's current handlers emit exactly one.
+    const lines = raw.split('\n');
+    let last;
+    for (const line of lines) {
+        const trimmed = line.replace(/\r$/, '');
+        if (trimmed.startsWith('data:')) {
+            last = trimmed.slice('data:'.length).trim();
+        }
+    }
+    if (!last) {
+        throw new McpProtocolError('clawtool MCP SSE response had no data event');
+    }
+    return JSON.parse(last);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/integrations/clawtool/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAA;AAEhD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGhC;IAFV,YACC,OAAe,EACN,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAC/B,CAAC;CACD;AA8BD,MAAM,OAAO,iBAAiB;IAOA;IANrB,EAAE,GAAG,CAAC,CAAA;IACN,WAAW,GAAG,KAAK,CAAA;IACnB,SAAS,GAAkB,IAAI,CAAA;IACtB,OAAO,CAAc;IACrB,SAAS,CAAQ;IAElC,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,IAAI,CAAC,WAAW;YAAE,OAAM;QAC5B,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE;YAC5B,eAAe,EAAE,oBAAoB;YACrC,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;SACvE,CAAC,CAAA;QACF,mEAAmE;QACnE,sEAAsE;QACtE,MAAM,IAAI,CAAC,MAAM,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAA;QAClD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,SAAS;QACd,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAkB,YAAY,EAAE,EAAE,CAAC,CAAA;QAChE,OAAO,MAAM,CAAC,KAAK,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B;QACzD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACvB,OAAO,IAAI,CAAC,GAAG,CAAgB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxE,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,MAAc,EAAE,MAA+B;QACnE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAA;QACpB,MAAM,IAAI,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QACnE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAA;QAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAClE,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACJ,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAClC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;gBACrC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aACzB,CAAC,CAAA;QACH,CAAC;gBAAS,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC/B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,gBAAgB,CACzB,2BAA2B,MAAM,iBAAiB,QAAQ,CAAC,MAAM,EAAE,EACnE,QAAQ,CAAC,MAAM,CACf,CAAA;QACF,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAI,QAAQ,CAAC,CAAA;QACrD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,gBAAgB,CACzB,uBAAuB,MAAM,oBAAoB,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EACzE,QAAQ,CAAC,KAAK,CAAC,IAAI,CACnB,CAAA;QACF,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,gBAAgB,CAAC,uBAAuB,MAAM,qBAAqB,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAA;IACvB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAA+B;QACnE,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,KAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAA;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAA;QACF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;IAEO,gBAAgB,CAAC,QAAkB;QAC1C,sEAAsE;QACtE,qEAAqE;QACrE,4EAA4E;QAC5E,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;QAC5F,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,GAAG,CAAA;QACrB,CAAC;IACF,CAAC;IAEO,OAAO,CAAC,MAAc,EAAE,MAA+B;QAC9D,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,qCAAqC;YAC7C,YAAY,EAAE,MAAM;SACpB,CAAA;QACD,iEAAiE;QACjE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAA;QAC3C,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QACtE,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,aAAa,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;QAC3B,CAAC;QACD,OAAO,OAAO,CAAA;IACf,CAAC;IAEO,KAAK,CAAC,YAAY,CAAI,QAAkB;QAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QACrD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,IAAI,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACtC,OAAO,mBAAmB,CAAI,IAAI,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAA;IAC9C,CAAC;CACD;AAED,SAAS,mBAAmB,CAAI,GAAW;IAC1C,uCAAuC;IACvC,iCAAiC;IACjC,4BAA4B;IAC5B,sEAAsE;IACtE,2DAA2D;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7B,IAAI,IAAwB,CAAA;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACvC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QAC5C,CAAC;IACF,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,IAAI,gBAAgB,CAAC,6CAA6C,CAAC,CAAA;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAA;AAC9C,CAAC"}

package/dist/integrations/clawtool/mcp.test.d.ts

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

package/dist/integrations/clawtool/mcp.test.d.ts.map

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

package/dist/integrations/clawtool/mcp.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ClawtoolMcpClient, McpProtocolError } from './mcp.js';
+/** Build a Response stub that mimics clawtool's Streamable HTTP SSE shape. */
+function sseResponse(body, sessionId) {
+    const headers = new Headers({ 'content-type': 'text/event-stream' });
+    if (sessionId)
+        headers.set('Mcp-Session-Id', sessionId);
+    const text = `data: ${JSON.stringify(body)}\n\n`;
+    return new Response(text, { status: 200, headers });
+}
+function jsonResponse(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    });
+}
+describe('ClawtoolMcpClient', () => {
+    it('initialize → tools/list issues the right wire calls and threads the session id', async () => {
+        const fetchMock = vi.fn();
+        // 1: initialize
+        fetchMock.mockResolvedValueOnce(sseResponse({
+            jsonrpc: '2.0',
+            id: 1,
+            result: {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                serverInfo: { name: 'clawtool', version: '0.0.0' },
+            },
+        }, 'sid-xyz'));
+        // 2: notifications/initialized (no body matters)
+        fetchMock.mockResolvedValueOnce(jsonResponse({ jsonrpc: '2.0' }));
+        // 3: tools/list
+        fetchMock.mockResolvedValueOnce(sseResponse({
+            jsonrpc: '2.0',
+            id: 2,
+            result: { tools: [{ name: 'Bash', description: 'shell', inputSchema: {} }] },
+        }));
+        const client = new ClawtoolMcpClient({
+            endpoint: 'http://localhost:1234',
+            token: 'tok',
+            fetch: fetchMock,
+        });
+        const tools = await client.listTools();
+        expect(tools).toEqual([{ name: 'Bash', description: 'shell', inputSchema: {} }]);
+        // All three calls hit /mcp.
+        expect(fetchMock).toHaveBeenCalledTimes(3);
+        for (const call of fetchMock.mock.calls) {
+            expect(call[0]).toBe('http://localhost:1234/mcp');
+        }
+        // Initialize carried the bearer + method headers, no session id yet.
+        const initHeaders = fetchMock.mock.calls[0]?.[1]?.headers;
+        expect(initHeaders.Authorization).toBe('Bearer tok');
+        expect(initHeaders['Mcp-Method']).toBe('initialize');
+        expect(initHeaders['Mcp-Session-Id']).toBeUndefined();
+        // Subsequent calls echo the session id captured from the initialize response.
+        const notifyHeaders = fetchMock.mock.calls[1]?.[1]?.headers;
+        expect(notifyHeaders['Mcp-Session-Id']).toBe('sid-xyz');
+        const listHeaders = fetchMock.mock.calls[2]?.[1]?.headers;
+        expect(listHeaders['Mcp-Session-Id']).toBe('sid-xyz');
+        expect(listHeaders['Mcp-Method']).toBe('tools/list');
+    });
+    it('omits the Authorization header when the token is empty (no-auth daemon)', async () => {
+        const fetchMock = vi.fn();
+        fetchMock.mockResolvedValue(sseResponse({
+            jsonrpc: '2.0',
+            id: 1,
+            result: { protocolVersion: '2024-11-05', capabilities: {}, serverInfo: {} },
+        }, 'sid-noauth'));
+        const client = new ClawtoolMcpClient({
+            endpoint: 'http://localhost:1234',
+            token: '',
+            fetch: fetchMock,
+        });
+        await client.initialize();
+        const headers = fetchMock.mock.calls[0]?.[1]?.headers;
+        expect(headers.Authorization).toBeUndefined();
+    });
+    it('tools/call adds the Mcp-Name header for the tool dispatch', async () => {
+        const fetchMock = vi.fn();
+        fetchMock.mockResolvedValueOnce(sseResponse({
+            jsonrpc: '2.0',
+            id: 1,
+            result: { protocolVersion: '2024-11-05', capabilities: {}, serverInfo: {} },
+        }, 'sid-call'));
+        fetchMock.mockResolvedValueOnce(jsonResponse({ jsonrpc: '2.0' }));
+        fetchMock.mockResolvedValueOnce(sseResponse({
+            jsonrpc: '2.0',
+            id: 2,
+            result: { content: [{ type: 'text', text: 'ok' }] },
+        }));
+        const client = new ClawtoolMcpClient({
+            endpoint: 'http://localhost:1234',
+            token: 'tok',
+            fetch: fetchMock,
+        });
+        const result = await client.callTool('Bash', { command: 'echo hi' });
+        expect(result.content[0]).toEqual({ type: 'text', text: 'ok' });
+        const callHeaders = fetchMock.mock.calls[2]?.[1]?.headers;
+        expect(callHeaders['Mcp-Name']).toBe('Bash');
+    });
+    it('throws McpProtocolError on non-2xx responses', async () => {
+        const fetchMock = vi.fn();
+        fetchMock.mockResolvedValue(new Response('', { status: 404 }));
+        const client = new ClawtoolMcpClient({
+            endpoint: 'http://localhost:1234',
+            token: '',
+            fetch: fetchMock,
+        });
+        await expect(client.initialize()).rejects.toThrow(McpProtocolError);
+    });
+    it('throws McpProtocolError when the envelope reports a JSON-RPC error', async () => {
+        const fetchMock = vi.fn();
+        fetchMock.mockResolvedValueOnce(sseResponse({
+            jsonrpc: '2.0',
+            id: 1,
+            error: { code: -32601, message: 'method not found' },
+        }));
+        const client = new ClawtoolMcpClient({
+            endpoint: 'http://localhost:1234',
+            token: '',
+            fetch: fetchMock,
+        });
+        await expect(client.initialize()).rejects.toThrow(/method not found/);
+    });
+});
+//# sourceMappingURL=mcp.test.js.map

package/dist/integrations/clawtool/mcp.test.js.map

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

package/dist/integrations/clawtool/paths.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve clawtool's XDG-style config directory, honoring `XDG_CONFIG_HOME`.
+ * Mirrors clawtool's Go `internal/daemon/daemon.go:75-77` behavior.
+ */
+export declare function clawtoolConfigDir(env?: NodeJS.ProcessEnv): string;
+export declare function daemonStatePath(env?: NodeJS.ProcessEnv): string;
+export declare function listenerTokenPath(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/integrations/clawtool/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI9E;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9E"}

package/dist/integrations/clawtool/paths.js

@@ -0,0 +1,19 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Resolve clawtool's XDG-style config directory, honoring `XDG_CONFIG_HOME`.
+ * Mirrors clawtool's Go `internal/daemon/daemon.go:75-77` behavior.
+ */
+export function clawtoolConfigDir(env = process.env) {
+    const xdg = env.XDG_CONFIG_HOME;
+    if (xdg && xdg.trim().length > 0)
+        return join(xdg, 'clawtool');
+    return join(homedir(), '.config', 'clawtool');
+}
+export function daemonStatePath(env = process.env) {
+    return join(clawtoolConfigDir(env), 'daemon.json');
+}
+export function listenerTokenPath(env = process.env) {
+    return join(clawtoolConfigDir(env), 'listener-token');
+}
+//# sourceMappingURL=paths.js.map

package/dist/integrations/clawtool/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/integrations/clawtool/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAA;IAC/B,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAC9D,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAA;AACtD,CAAC"}

package/dist/integrations/clawtool/peers.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Client for clawtool's BIAM peer registry (`/v1/peers`) — the canonical
+ * cross-terminal / cross-host agent coordination layer. namzu registers
+ * itself here as a peer so any orchestrator (clawtool's dashboard, another
+ * namzu's `/agents`) can see it, and messages it via the same registry.
+ *
+ * namzu does NOT run its own session daemon for this — clawtool already owns
+ * peer presence, heartbeats, messaging, broadcast, mDNS LAN discovery, and a
+ * dashboard. We just register + list + send through it.
+ *
+ * Every call is best-effort: with no reachable clawtool daemon the helpers
+ * return null / [] / false so the TUI works the same with or without it.
+ */
+import { type EnsureDaemonOptions } from './daemon.js';
+export interface Peer {
+    readonly peer_id: string;
+    readonly display_name: string;
+    readonly backend: string;
+    readonly circle?: string;
+    readonly role?: string;
+    readonly status?: string;
+    readonly session_id?: string;
+    readonly pid?: number;
+    readonly path?: string;
+    readonly last_seen?: string;
+}
+export interface RegisterPeerInput {
+    readonly display_name: string;
+    readonly backend: string;
+    readonly path?: string;
+    readonly session_id?: string;
+    readonly pid?: number;
+    readonly circle?: string;
+    readonly metadata?: Record<string, string>;
+}
+/** Register (or refresh) this process as a BIAM peer; returns its peer_id. */
+export declare function registerPeer(input: RegisterPeerInput, opts?: EnsureDaemonOptions): Promise<string | null>;
+export declare function heartbeatPeer(peerId: string, opts?: EnsureDaemonOptions): Promise<void>;
+export declare function deregisterPeer(peerId: string, opts?: EnsureDaemonOptions): Promise<void>;
+export declare function listPeers(opts?: EnsureDaemonOptions): Promise<readonly Peer[]>;
+/** A message in a peer's BIAM inbox (clawtool `a2a.Message`). */
+export interface InboxMessage {
+    readonly id: string;
+    readonly type?: string;
+    readonly from_peer: string;
+    readonly to_peer?: string;
+    readonly text: string;
+    readonly correlation_id?: string;
+    readonly timestamp?: string;
+}
+/**
+ * Drain this peer's inbox — returns + clears pending messages other agents
+ * sent to us. namzu polls this so clawtool / another agent can talk TO it,
+ * not just be listed. (`peek` leaves messages in place; default drains.)
+ */
+export declare function drainInbox(peerId: string, opts?: EnsureDaemonOptions & {
+    peek?: boolean;
+}): Promise<readonly InboxMessage[]>;
+/**
+ * Send a message to another peer's BIAM inbox. `from` is our own peer id so
+ * the recipient knows who sent it (and can reply) — clawtool stamps it as the
+ * message's `from_peer`.
+ */
+export declare function sendPeerMessage(peerId: string, text: string, opts?: EnsureDaemonOptions & {
+    from?: string;
+}): Promise<boolean>;
+//# sourceMappingURL=peers.d.ts.map

package/dist/integrations/clawtool/peers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.d.ts","sourceRoot":"","sources":["../../../src/integrations/clawtool/peers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,aAAa,CAAA;AAEpE,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAmBD,8EAA8E;AAC9E,wBAAsB,YAAY,CACjC,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,mBAAwB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAejG;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAwB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAgBxF;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAmB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACjD,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAiBlC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,mBAAmB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/integrations/clawtool/peers.js

@@ -0,0 +1,150 @@
+/**
+ * Client for clawtool's BIAM peer registry (`/v1/peers`) — the canonical
+ * cross-terminal / cross-host agent coordination layer. namzu registers
+ * itself here as a peer so any orchestrator (clawtool's dashboard, another
+ * namzu's `/agents`) can see it, and messages it via the same registry.
+ *
+ * namzu does NOT run its own session daemon for this — clawtool already owns
+ * peer presence, heartbeats, messaging, broadcast, mDNS LAN discovery, and a
+ * dashboard. We just register + list + send through it.
+ *
+ * Every call is best-effort: with no reachable clawtool daemon the helpers
+ * return null / [] / false so the TUI works the same with or without it.
+ */
+import { ensureDaemon } from './daemon.js';
+async function endpoint(opts) {
+    try {
+        return await ensureDaemon(opts);
+    }
+    catch {
+        return null;
+    }
+}
+function authHeaders(token, withBody) {
+    const h = {};
+    if (token.length > 0)
+        h.Authorization = `Bearer ${token}`;
+    if (withBody)
+        h['content-type'] = 'application/json';
+    return h;
+}
+/** Register (or refresh) this process as a BIAM peer; returns its peer_id. */
+export async function registerPeer(input, opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return null;
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    try {
+        const res = await fetchFn(new URL('/v1/peers/register', ep.baseUrl).toString(), {
+            method: 'POST',
+            headers: authHeaders(ep.token, true),
+            body: JSON.stringify(input),
+        });
+        if (!res.ok)
+            return null;
+        const peer = (await res.json());
+        return typeof peer.peer_id === 'string' ? peer.peer_id : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function heartbeatPeer(peerId, opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return;
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    try {
+        await fetchFn(new URL(`/v1/peers/${encodeURIComponent(peerId)}/heartbeat`, ep.baseUrl).toString(), {
+            method: 'POST',
+            headers: authHeaders(ep.token, false),
+        });
+    }
+    catch {
+        // best-effort
+    }
+}
+export async function deregisterPeer(peerId, opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return;
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    try {
+        await fetchFn(new URL(`/v1/peers/${encodeURIComponent(peerId)}`, ep.baseUrl).toString(), {
+            method: 'DELETE',
+            headers: authHeaders(ep.token, false),
+        });
+    }
+    catch {
+        // best-effort
+    }
+}
+export async function listPeers(opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return [];
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    try {
+        const res = await fetchFn(new URL('/v1/peers', ep.baseUrl).toString(), {
+            method: 'GET',
+            headers: authHeaders(ep.token, false),
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        const peers = Array.isArray(data) ? data : data.peers;
+        return Array.isArray(peers) ? peers : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Drain this peer's inbox — returns + clears pending messages other agents
+ * sent to us. namzu polls this so clawtool / another agent can talk TO it,
+ * not just be listed. (`peek` leaves messages in place; default drains.)
+ */
+export async function drainInbox(peerId, opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return [];
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    try {
+        const url = new URL(`/v1/peers/${encodeURIComponent(peerId)}/messages`, ep.baseUrl);
+        if (opts.peek)
+            url.searchParams.set('peek', '1');
+        const res = await fetchFn(url.toString(), {
+            method: 'GET',
+            headers: authHeaders(ep.token, false),
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return Array.isArray(data.messages) ? data.messages : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Send a message to another peer's BIAM inbox. `from` is our own peer id so
+ * the recipient knows who sent it (and can reply) — clawtool stamps it as the
+ * message's `from_peer`.
+ */
+export async function sendPeerMessage(peerId, text, opts = {}) {
+    const ep = await endpoint(opts);
+    if (!ep)
+        return false;
+    const fetchFn = opts.fetch ?? globalThis.fetch;
+    const body = { text };
+    if (opts.from)
+        body.from_peer = opts.from;
+    try {
+        const res = await fetchFn(new URL(`/v1/peers/${encodeURIComponent(peerId)}/messages`, ep.baseUrl).toString(), { method: 'POST', headers: authHeaders(ep.token, true), body: JSON.stringify(body) });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=peers.js.map