@winmatrix/agent-sdk 0.1.0

package/dist/core/RuntimeDetector.js

@@ -0,0 +1,45 @@
+/**
+ * RuntimeDetector - 本地 AI CLI 运行时检测
+ *
+ * 扫描 PATH 中已知 AI CLI 工具，返回可用列表和版本信息。
+ */
+import { execSync } from 'node:child_process';
+const KNOWN_RUNTIMES = [
+    { name: 'claude', command: 'claude' },
+    { name: 'cursor', command: 'cursor' },
+    { name: 'codex', command: 'codex' },
+    { name: 'kimi', command: 'kimi' },
+    { name: 'copilot', command: 'copilot' },
+    { name: 'gemini', command: 'gemini' },
+];
+function tryGetVersion(command) {
+    try {
+        const output = execSync(`${command} --version`, {
+            timeout: 5000,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        return output.trim().split('\n')[0].slice(0, 100);
+    }
+    catch {
+        try {
+            // 有些 CLI 使用 -v 而不是 --version
+            const output = execSync(`${command} -v`, {
+                timeout: 5000,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                encoding: 'utf-8',
+            });
+            return output.trim().split('\n')[0].slice(0, 100);
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+export function detectRuntimes() {
+    return KNOWN_RUNTIMES.map(({ name, command }) => {
+        const version = tryGetVersion(command);
+        return { name, version, available: version !== undefined };
+    });
+}
+//# sourceMappingURL=RuntimeDetector.js.map

package/dist/core/RuntimeDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeDetector.js","sourceRoot":"","sources":["../../src/core/RuntimeDetector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAQ9C,MAAM,cAAc,GAA6C;IAC/D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;IACnC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IACjC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;IACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;CACtC,CAAC;AAEF,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,YAAY,EAAE;YAC9C,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,6BAA6B;YAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,KAAK,EAAE;gBACvC,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/WinMatrixAgentClient.d.ts

@@ -0,0 +1,134 @@
+/**
+ * WinMatrix Agent SDK - Client
+ *
+ * Main client class for connecting external agents to the WinMatrix platform.
+ * Handles WebSocket connection, registration, heartbeat, task lifecycle, and tool calls.
+ */
+import WebSocket from 'ws';
+import { RegisterParams, TaskAssignParams, RuntimeAvailabilityPayload, BaseResponse, BaseRequest, InboundFrame } from './Protocol.js';
+export type ClientState = 'disconnected' | 'connecting' | 'connected' | 'registered';
+export interface TaskInput {
+    taskId: string;
+    input: string;
+    context: TaskAssignParams['context'];
+    streaming: boolean;
+    /** 服务端生成的系统提示词 */
+    systemPrompt?: string;
+    /** 本任务的 MCP ToolProxy token（per-task session ID） */
+    mcpToken?: string;
+}
+export interface WinMatrixAgentClientOptions {
+    /** WebSocket URL of the WinMatrix server (e.g. ws://localhost:8400/api/v1/external-agents/connect) */
+    url: string;
+    /** Agent identifier */
+    agentId: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Display name for this agent */
+    name: string;
+    /** Agent type identifier */
+    agentType: string;
+    /** Capability declaration */
+    capabilities: RegisterParams['capabilities'];
+    /**
+     * Optional hooks (e.g. Dual Runtime Bridge task journaling).
+     * - `onTaskAssigned`: once per task.assign, before the task handler runs.
+     * - `onTaskCompleted` / `onTaskFailed`: before task.complete / task.error frames are sent.
+     */
+    bridgeHooks?: {
+        onTaskAssigned?: (task: TaskInput) => void;
+        /** Invoked before sending task.complete (e.g. bridge task journal). */
+        onTaskCompleted?: (taskId: string, result: unknown) => void;
+        /** Invoked before sending task.error (e.g. bridge task journal). */
+        onTaskFailed?: (taskId: string, error: string, code?: string) => void;
+    };
+    /**
+     * When true, the client schedules its own exponential backoff reconnect on disconnect
+     * or failed connect(). Default false — prefer orchestrating reconnect at the bridge / host
+     * (e.g. DualRuntimeBridge) so policies (auth backoff-off, single owner) stay in one place.
+     */
+    autoReconnect?: boolean;
+    /**
+     * Session query handler — called when the server sends session.list / session.get RPC.
+     * The handler receives the method name and params, and should return the result payload
+     * to send back in the response frame.
+     */
+    sessionQueryHandler?: (method: string, params: unknown) => Promise<unknown>;
+}
+type EventHandler<T = void> = (data: T) => void | Promise<void>;
+export declare class WinMatrixAgentClient {
+    private readonly options;
+    private ws;
+    private state;
+    protected heartbeatTimer: ReturnType<typeof setInterval> | null;
+    private reconnectTimer;
+    private reconnectDelay;
+    private readonly maxReconnectDelay;
+    private pendingRequests;
+    private requestTimeout;
+    private taskHandler;
+    private cancelHandler;
+    private resumeHandler;
+    private disconnectHandler;
+    private errorHandler;
+    private registeredHandler;
+    private serverConfig;
+    constructor(options: WinMatrixAgentClientOptions);
+    /** Current lifecycle state */
+    getState(): ClientState;
+    /** Set or replace the session query handler after construction */
+    setSessionQueryHandler(handler: (method: string, params: unknown) => Promise<unknown>): void;
+    /** Register an event handler */
+    on(event: 'task' | 'cancel' | 'resume' | 'disconnect' | 'error' | 'registered', handler: EventHandler<unknown>): void;
+    /** Open connection and register with the server */
+    connect(): Promise<void>;
+    /** Gracefully disconnect */
+    disconnect(): void;
+    /**
+     * 向 WinMatrix 上报本地 Hermes/OpenClaw HTTP（或命令模式）运行时可用性快照。
+     * 一般由 bridge 周期性调用；需在 `registered` 状态下发送。
+     */
+    notifyRuntimeAvailability(payload: RuntimeAvailabilityPayload): void;
+    /** Send a streaming delta for an active task */
+    streamDelta(taskId: string, content: string): void;
+    /** Mark a task as completed with a result. sessionId and usage are passed at top level for server-side DB persistence. */
+    completeTask(taskId: string, result: unknown, sessionId?: string, usage?: {
+        input: number;
+        output: number;
+    }): void;
+    /** Mark a task as failed with an error message */
+    failTask(taskId: string, error: string, code?: string): void;
+    /** Call a WinMatrix tool and wait for the result */
+    callTool(toolName: string, args: unknown, taskId?: string, agentId?: string): Promise<unknown>;
+    /**
+     * Send an arbitrary frame to the server.
+     * Wraps the low-level sendRaw, keeping the WS write path encapsulated.
+     */
+    sendFrame(frame: Record<string, unknown>): void;
+    protected establishConnection(): Promise<void>;
+    protected register(): Promise<void>;
+    protected sendRequest(method: string, params?: unknown): Promise<BaseResponse>;
+    protected sendEvent(event: string, payload?: unknown): void;
+    protected sendRaw(data: unknown): void;
+    protected handleMessage(data: WebSocket.Data): void;
+    /**
+     * 处理服务端发来的请求帧（如 task.assign）
+     *
+     * 服务端通过 waitForResponse 发送 { type: 'req', method: 'task.assign', params } 帧，
+     * SDK 需要回复 { type: 'res', id, ok: true } 确认收到，然后异步处理任务。
+     */
+    protected handleIncomingRequest(frame: BaseRequest): void;
+    private handleResponse;
+    protected handleEventFrame(frame: InboundFrame & {
+        type: 'event';
+        event: string;
+        payload?: unknown;
+    }): void;
+    protected setState(state: ClientState): void;
+    protected startHeartbeat(): void;
+    protected handleDisconnect(): void;
+    private scheduleReconnect;
+    private cleanup;
+}
+export {};
+//# sourceMappingURL=WinMatrixAgentClient.d.ts.map

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

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

package/dist/core/WinMatrixAgentClient.js

@@ -0,0 +1,382 @@
+/**
+ * WinMatrix Agent SDK - Client
+ *
+ * Main client class for connecting external agents to the WinMatrix platform.
+ * Handles WebSocket connection, registration, heartbeat, task lifecycle, and tool calls.
+ */
+import WebSocket from 'ws';
+import { createRequest, createEvent, nextRequestId, parseFrame, isResponse, isEvent, isRequest, METHODS, EVENTS, } from './Protocol.js';
+/* ── Client ── */
+export class WinMatrixAgentClient {
+    options;
+    ws = null;
+    state = 'disconnected';
+    heartbeatTimer = null;
+    reconnectTimer = null;
+    reconnectDelay = 1000;
+    maxReconnectDelay = 60000;
+    pendingRequests = new Map();
+    requestTimeout = 30000;
+    // Event handlers
+    taskHandler = null;
+    cancelHandler = null;
+    resumeHandler = null;
+    disconnectHandler = null;
+    errorHandler = null;
+    registeredHandler = null;
+    // Server-assigned config
+    serverConfig = null;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Current lifecycle state */
+    getState() {
+        return this.state;
+    }
+    /** Set or replace the session query handler after construction */
+    setSessionQueryHandler(handler) {
+        this.options.sessionQueryHandler = handler;
+    }
+    /** Register an event handler */
+    on(event, handler) {
+        if (event === 'task') {
+            this.taskHandler = handler;
+        }
+        else if (event === 'cancel') {
+            this.cancelHandler = handler;
+        }
+        else if (event === 'resume') {
+            this.resumeHandler = handler;
+        }
+        else if (event === 'disconnect') {
+            this.disconnectHandler = handler;
+        }
+        else if (event === 'error') {
+            this.errorHandler = handler;
+        }
+        else if (event === 'registered') {
+            this.registeredHandler = handler;
+        }
+    }
+    /** Open connection and register with the server */
+    async connect() {
+        if (this.state !== 'disconnected') {
+            throw new Error(`Cannot connect from state '${this.state}'`);
+        }
+        this.setState('connecting');
+        try {
+            await this.establishConnection();
+            await this.register();
+            this.startHeartbeat();
+            this.reconnectDelay = 1000;
+            this.setState('registered');
+        }
+        catch (err) {
+            this.cleanup();
+            this.setState('disconnected');
+            if (this.options.autoReconnect) {
+                this.scheduleReconnect();
+            }
+            throw err;
+        }
+    }
+    /** Gracefully disconnect */
+    disconnect() {
+        this.cleanup();
+        this.setState('disconnected');
+    }
+    /**
+     * 向 WinMatrix 上报本地 Hermes/OpenClaw HTTP（或命令模式）运行时可用性快照。
+     * 一般由 bridge 周期性调用；需在 `registered` 状态下发送。
+     */
+    notifyRuntimeAvailability(payload) {
+        if (this.state !== 'registered')
+            return;
+        try {
+            this.sendEvent(EVENTS.RUNTIME_AVAILABILITY, payload);
+        }
+        catch {
+            /* 发送瞬时竞态时忽略 */
+        }
+    }
+    /** Send a streaming delta for an active task */
+    streamDelta(taskId, content) {
+        this.sendEvent(EVENTS.TASK_DELTA, { taskId, content });
+    }
+    /** Mark a task as completed with a result. sessionId and usage are passed at top level for server-side DB persistence. */
+    completeTask(taskId, result, sessionId, usage) {
+        try {
+            this.options.bridgeHooks?.onTaskCompleted?.(taskId, result);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.warn(`[WinMatrixAgentClient] bridgeHooks.onTaskCompleted failed: ${msg}`);
+        }
+        this.sendEvent(EVENTS.TASK_COMPLETE, { taskId, result, sessionId, usage });
+    }
+    /** Mark a task as failed with an error message */
+    failTask(taskId, error, code) {
+        try {
+            this.options.bridgeHooks?.onTaskFailed?.(taskId, error, code);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.warn(`[WinMatrixAgentClient] bridgeHooks.onTaskFailed failed: ${msg}`);
+        }
+        const payload = { taskId, error };
+        if (code)
+            payload.code = code;
+        this.sendEvent(EVENTS.TASK_ERROR, payload);
+    }
+    /** Call a WinMatrix tool and wait for the result */
+    async callTool(toolName, args, taskId, agentId) {
+        const callId = nextRequestId();
+        const params = { callId, toolName, args };
+        if (taskId)
+            params.taskId = taskId;
+        if (agentId)
+            params.agentId = agentId;
+        const response = await this.sendRequest(METHODS.TOOL_CALL, params);
+        if (!response.ok) {
+            throw new Error(response.error ?? 'Tool call failed');
+        }
+        const payload = response.payload;
+        return payload && typeof payload === 'object' && 'result' in payload ? payload.result : response.payload;
+    }
+    /**
+     * Send an arbitrary frame to the server.
+     * Wraps the low-level sendRaw, keeping the WS write path encapsulated.
+     */
+    sendFrame(frame) {
+        this.sendRaw(frame);
+    }
+    /* ── Protected: Connection (overridable by DaemonClient) ── */
+    establishConnection() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.options.url);
+            ws.on('open', () => {
+                this.setState('connected');
+                resolve();
+            });
+            ws.on('error', (err) => {
+                const detail = err?.message?.trim()
+                    ? err.message
+                    : String(err.code ?? err);
+                reject(new Error(`WebSocket failed for ${this.options.url}: ${detail || 'unknown'}`, {
+                    cause: err,
+                }));
+            });
+            ws.on('close', () => {
+                this.handleDisconnect();
+            });
+            ws.on('message', (data) => {
+                this.handleMessage(data);
+            });
+            this.ws = ws;
+        });
+    }
+    async register() {
+        const params = {
+            agentId: this.options.agentId,
+            apiKey: this.options.apiKey,
+            name: this.options.name,
+            agentType: this.options.agentType,
+            capabilities: this.options.capabilities,
+        };
+        const response = await this.sendRequest(METHODS.REGISTER, params);
+        if (!response.ok) {
+            throw new Error(`Registration failed: ${response.error ?? 'unknown error'}`);
+        }
+        this.serverConfig = response.payload;
+    }
+    /* ── Protected: Messaging (overridable by DaemonClient) ── */
+    sendRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            const id = nextRequestId();
+            const frame = createRequest(id, method, params);
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request ${id} (${method}) timed out`));
+            }, this.requestTimeout);
+            this.pendingRequests.set(id, { resolve, reject, timer });
+            this.sendRaw(frame);
+        });
+    }
+    sendEvent(event, payload) {
+        const frame = createEvent(event, payload);
+        this.sendRaw(frame);
+    }
+    sendRaw(data) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            console.warn('[WinMatrixAgentClient] WebSocket not connected, dropping frame');
+            return;
+        }
+        this.ws.send(JSON.stringify(data));
+    }
+    handleMessage(data) {
+        const raw = typeof data === 'string' ? data : data.toString('utf-8');
+        const frame = parseFrame(raw);
+        if (!frame)
+            return;
+        if (isResponse(frame)) {
+            this.handleResponse(frame);
+        }
+        else if (isEvent(frame)) {
+            this.handleEventFrame(frame);
+        }
+        else if (isRequest(frame)) {
+            this.handleIncomingRequest(frame);
+        }
+    }
+    /**
+     * 处理服务端发来的请求帧（如 task.assign）
+     *
+     * 服务端通过 waitForResponse 发送 { type: 'req', method: 'task.assign', params } 帧，
+     * SDK 需要回复 { type: 'res', id, ok: true } 确认收到，然后异步处理任务。
+     */
+    handleIncomingRequest(frame) {
+        if (frame.method === METHODS.TASK_ASSIGN && this.taskHandler) {
+            // 立即回复确认
+            this.sendRaw({ type: 'res', id: frame.id, ok: true });
+            const params = frame.params;
+            const taskPayload = {
+                taskId: params.taskId,
+                input: params.input,
+                context: params.context,
+                streaming: params.streaming,
+                systemPrompt: params.systemPrompt,
+                mcpToken: params.mcpToken,
+            };
+            this.options.bridgeHooks?.onTaskAssigned?.(taskPayload);
+            try {
+                const result = this.taskHandler(taskPayload);
+                if (result instanceof Promise) {
+                    result.catch((err) => {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        this.failTask(params.taskId, `Task handler error: ${msg}`);
+                    });
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.failTask(params.taskId, `Task handler error: ${msg}`);
+            }
+        }
+        else if ((frame.method === METHODS.SESSION_LIST || frame.method === METHODS.SESSION_GET) &&
+            this.options.sessionQueryHandler) {
+            this.options
+                .sessionQueryHandler(frame.method, frame.params)
+                .then((result) => {
+                this.sendRaw({ type: 'res', id: frame.id, ok: true, payload: result });
+            })
+                .catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.sendRaw({ type: 'res', id: frame.id, ok: false, error: msg });
+            });
+        }
+        else if (frame.method === METHODS.PING) {
+            // 服务端 ping，回复 pong
+            this.sendRaw({ type: 'res', id: frame.id, ok: true });
+        }
+        else {
+            // 未知请求，回复错误
+            this.sendRaw({ type: 'res', id: frame.id, ok: false, error: `Unknown method: ${frame.method}` });
+        }
+    }
+    handleResponse(frame) {
+        const pending = this.pendingRequests.get(frame.id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timer);
+        this.pendingRequests.delete(frame.id);
+        pending.resolve(frame);
+    }
+    handleEventFrame(frame) {
+        if (frame.event === EVENTS.TASK_CANCEL) {
+            const payload = frame.payload;
+            if (payload?.taskId) {
+                this.cancelHandler?.({ taskId: payload.taskId });
+                this.sendEvent(EVENTS.TASK_CANCELLED, { taskId: payload.taskId });
+            }
+        }
+        else if (frame.event === EVENTS.TASK_RESUME) {
+            const payload = frame.payload;
+            if (payload?.taskId) {
+                this.resumeHandler?.({ taskId: payload.taskId });
+            }
+        }
+    }
+    /* ── Protected: Lifecycle ── */
+    setState(state) {
+        const prev = this.state;
+        this.state = state;
+        if (state === 'registered' && state !== prev) {
+            this.registeredHandler?.();
+        }
+    }
+    startHeartbeat() {
+        const interval = this.serverConfig?.config.heartbeatInterval ?? 30000;
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws?.readyState === WebSocket.OPEN) {
+                this.sendRequest(METHODS.PING).catch((err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    this.errorHandler?.(new Error(`Heartbeat failed: ${msg}`));
+                });
+            }
+        }, interval);
+    }
+    handleDisconnect() {
+        this.cleanup();
+        this.setState('disconnected');
+        if (this.disconnectHandler) {
+            this.disconnectHandler();
+        }
+        if (this.options.autoReconnect) {
+            this.scheduleReconnect();
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const delay = this.reconnectDelay;
+        this.reconnectDelay = Math.min(delay * 2, this.maxReconnectDelay);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.setState('disconnected');
+            this.connect().catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (this.errorHandler) {
+                    this.errorHandler(new Error(`Reconnect failed: ${msg}`));
+                }
+                // scheduleReconnect will be called again by connect() failure
+            });
+        }, delay);
+    }
+    cleanup() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        for (const [, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Connection closed'));
+        }
+        this.pendingRequests.clear();
+        if (this.ws) {
+            try {
+                this.ws.removeAllListeners();
+                this.ws.close();
+            }
+            catch {
+                // ignore close errors
+            }
+            this.ws = null;
+        }
+        this.serverConfig = null;
+    }
+}
+//# sourceMappingURL=WinMatrixAgentClient.js.map

package/dist/core/WinMatrixAgentClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * WinMatrix Agent SDK
+ *
+ * Public API surface. Re-exports client, adapters, and protocol types.
+ */
+export { WinMatrixAgentClient } from './core/WinMatrixAgentClient.js';
+export type { WinMatrixAgentClientOptions, ClientState, TaskInput } from './core/WinMatrixAgentClient.js';
+export { DaemonClient } from './core/DaemonClient.js';
+export type { DaemonClientOptions, AgentCreateEvent, AgentStopEvent, AgentErrorEvent, } from './core/DaemonClient.js';
+export { ClaudeAdapter } from './adapters/claude/ClaudeAdapter.js';
+export { parseClaudeLine, splitLines } from './adapters/claude/ClaudeStreamParser.js';
+export type { ClaudeDeltaAction, ClaudeToolUseAction, ClaudeResultAction, ClaudeErrorAction, ClaudeSkipAction, ClaudeLineAction, } from './adapters/claude/ClaudeStreamParser.js';
+export { OpenClawAdapter } from './adapters/openclaw/OpenClawAdapter.js';
+export type { OpenClawAdapterOptions } from './adapters/openclaw/OpenClawAdapter.js';
+export { unwrapOpenClawPayloads } from './adapters/openclaw/unwrapOpenClawPayloads.js';
+export { HermesAdapter } from './adapters/hermes/HermesAdapter.js';
+export type { HermesAdapterOptions } from './adapters/hermes/HermesAdapter.js';
+export { METHODS, EVENTS, ERROR_CODES, nextRequestId, createRequest, createEvent, parseFrame, parseResponse, parseEvent, isResponse, isEvent, isRequest, isTaskAssignRequest, isTaskCancelEvent, isTaskResumeEvent, isSessionListRequest, isSessionGetRequest, } from './core/Protocol.js';
+export type { BaseRequest, BaseResponse, BaseEvent, InboundFrame, RegisterParams, RegisterResponsePayload, ComputerRegisterParams, ComputerRegisterResponsePayload, TaskContext, TaskConstraints, TaskAssignParams, TaskDeltaPayload, TaskThinkingPayload, TaskCompletePayload, TaskErrorPayload, TaskCancelPayload, TaskCancelledPayload, TaskResumePayload, SessionListParams, SessionListResponsePayload, SessionGetParams, SessionGetResponsePayload, RuntimeAvailabilityPayload, ToolCallParams, ToolCallResponse, AgentProfile, } from './core/Protocol.js';
+export type { AgentAdapter, AdapterEvent, AdapterMeta, AgentTaskContext, ClaudeTaskOptions, HermesTaskOptions, OpenClawTaskOptions, HealthStatus, SessionListOptions, SessionDetailOptions, SessionEntry, SessionListResult, SessionDetailResult, TokenUsage, } from './core/AgentAdapter.js';
+export { LOCAL_FILE_TOOLS, isLocalTool } from './core/AgentAdapter.js';
+export { AdapterRegistry, getGlobalRegistry } from './core/AdapterRegistry.js';
+export type { AdapterConstructor } from './core/AdapterRegistry.js';
+export { detectRuntimes } from './core/RuntimeDetector.js';
+export type { Runtime } from './core/RuntimeDetector.js';
+export { loadBridgeConfig, loadBridgeConfigFromJsonFile, loadBridgeConfigFromJsonObject, DEFAULT_BRIDGE_CONFIG_BASENAME, } from './runtime/bridgeConfigLoader.js';
+export type { BridgeConfigFileJson, BridgeRuntimeFileJson } from './runtime/bridgeConfigTypes.js';
+export { BRIDGE_CONFIG_FILE_VERSION } from './runtime/bridgeConfigTypes.js';
+export type { BridgeConfig, RuntimeConfig } from './runtime/DualRuntimeBridge.js';
+export { isNonRecoverableExternalAgentAuthError, nextReconnectDelayMs, } from './runtime/bridgeReconnectPolicy.js';
+export { probeLocalHttpEndpoint, startLocalRuntimeAvailabilityMonitor, } from './runtime/localRuntimeAvailabilityMonitor.js';
+export type { LocalRuntimeKindBridge } from './runtime/localRuntimeAvailabilityMonitor.js';
+export { getBridgeHomeDir, getBridgeConfigPath, ensureBridgeHomeLayout, DEFAULT_BRIDGE_DIR_NAME, BRIDGE_CONFIG_FILENAME, } from './runtime/bridgeHome.js';
+export { spawnHelper } from './utils/spawnHelper.js';
+export type { SpawnHelperOptions, SpawnResult } from './utils/spawnHelper.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":"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"}