@winmatrix/daemon 1.0.3 → 1.0.5

package/dist/core/DaemonClient.d.ts

@@ -0,0 +1,102 @@
+/**
+ * WinMatrix Agent SDK - DaemonClient
+ *
+ * Extends WinMatrixAgentClient for the Computer/Daemon connection model.
+ * After WebSocket connection, sends `computer.register` (instead of `register`)
+ * with the computer's identity, host info, and detected runtimes.
+ *
+ * The Daemon connection acts as a multiplexing channel:
+ *   - computer.heartbeat events keep the Computer alive
+ *   - agent.create / agent.stop events manage Agent lifecycle on the host
+ *   - task.* messages are routed by agentId for individual agents
+ */
+import { type AgentProfile, type ComputerRegisterParams, type ClientInboundFrame } from '@winmatrix/protocol';
+import { WinMatrixAgentClient, type WinMatrixAgentClientOptions } from './WinMatrixAgentClient.js';
+export interface DaemonClientOptions extends Omit<WinMatrixAgentClientOptions, 'agentId' | 'name' | 'agentType' | 'capabilities' | 'apiKey'> {
+    /** Persistent installation UUID */
+    installationId: string;
+    /** Computer registration token (wmc_...) */
+    token: string;
+    /** Operating system name + version (e.g. "darwin 24.0.0") */
+    hostOs: string;
+    /** CPU architecture (e.g. "arm64") */
+    hostArch: string;
+    /** Hostname of the machine */
+    hostname: string;
+    /** Daemon version string */
+    daemonVersion?: string;
+    /** Detected AI runtimes on this computer */
+    runtimes: ComputerRegisterParams['runtimes'];
+    /** Agent types the daemon can host natively (e.g. ["claude-code","hermes","openclaw"]) */
+    supportedAgentTypes?: string[];
+    /**
+     * Called for agent-level messages that should be forwarded to AgentWrapper
+     * rather than handled by the SDK client.
+     *
+     * @param frame  - Parsed standard frame (event/req/res)
+     * @param raw    - Raw JSON string for forwarding to Wrapper stdin
+     * @param agentId - Top-level agentId extracted from the raw JSON before parseFrame
+     */
+    onPassthrough?: (frame: ClientInboundFrame, raw: string, agentId: string | null) => void;
+}
+export interface AgentCreateEvent {
+    agentId: string;
+    runtime: string;
+    apiKey: string;
+    name: string;
+    agentType: string;
+}
+export interface AgentStopEvent {
+    agentId: string;
+}
+export interface AgentErrorEvent {
+    agentId: string;
+    error: string;
+}
+type DaemonEventHandler<T = void> = (data: T) => void | Promise<void>;
+export declare class DaemonClient extends WinMatrixAgentClient {
+    private readonly daemonOptions;
+    private serverComputerId;
+    private agentCreateHandler;
+    private agentStopHandler;
+    private profileCollector;
+    /** 心跳执行锁，防止定时器回调并发 */
+    private heartbeatInProgress;
+    constructor(options: DaemonClientOptions);
+    /** Register handler for daemon-specific events */
+    onDaemonEvent(event: 'agent.create' | 'agent.stop', handler: DaemonEventHandler<unknown>): void;
+    /** Get the server-assigned computer ID (available after successful registration) */
+    getComputerId(): string | null;
+    /** Set the profile collector function (called during heartbeat to attach agentProfiles) */
+    setProfileCollector(fn: () => Promise<AgentProfile[]>): void;
+    /**
+     * 通过 daemon 连接发送 agent.error 事件。
+     * 替代直接访问私有 ws 属性，用于 agent.create 失败时通知服务端。
+     */
+    sendAgentError(agentId: string, error: string): boolean;
+    /** Immediately send a heartbeat with agent profiles (used for agent create/destroy/rescan) */
+    sendHeartbeatNow(): Promise<void>;
+    /**
+     * Override register() to send computer.register instead of agent register.
+     */
+    protected register(): Promise<void>;
+    /**
+     * Override heartbeat for daemon mode — sends computer.heartbeat events with optional agentProfiles.
+     * 使用锁防止定时器回调并发执行，确保上次心跳完成后再调度下次。
+     */
+    protected startHeartbeat(): void;
+    /**
+     * Override to extract agentId before parseFrame and intercept daemon events.
+     *
+     * 注意：方案 B 下 onPassthrough 未设置，passthrough 路由代码（task.assign ACK / wrapper 响应）
+     * 当前为 dead code。每个 agent 有独立 WinMatrixAgentClient + WebSocket，消息由
+     * AgentProcessManager 分发到各 agent 的 client，不经过 daemon 连接多路复用。
+     */
+    protected handleMessage(data: import('ws').Data): void;
+    /**
+     * Handle daemon-specific events. Returns true if the event was handled.
+     */
+    private handleDaemonEvent;
+}
+export {};
+//# sourceMappingURL=DaemonClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonClient.d.ts","sourceRoot":"","sources":["../../src/core/DaemonClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAE3B,KAAK,kBAAkB,EAIxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAInG,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC1I,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1F;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,KAAK,kBAAkB,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAItE,qBAAa,YAAa,SAAQ,oBAAoB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,kBAAkB,CAAqD;IAC/E,OAAO,CAAC,gBAAgB,CAAmD;IAC3E,OAAO,CAAC,gBAAgB,CAAgD;IACxE,sBAAsB;IACtB,OAAO,CAAC,mBAAmB,CAAS;gBAExB,OAAO,EAAE,mBAAmB;IAcxC,kDAAkD;IAClD,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI;IAQ/F,oFAAoF;IACpF,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI;IAI5D;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAUvD,8FAA8F;IACxF,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC;;OAEG;cACa,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BzC;;;OAGG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAmBhC;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,GAAG,IAAI;IAoEtD;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAoB1B"}

package/dist/core/DaemonClient.js

@@ -0,0 +1,225 @@
+/**
+ * WinMatrix Agent SDK - DaemonClient
+ *
+ * Extends WinMatrixAgentClient for the Computer/Daemon connection model.
+ * After WebSocket connection, sends `computer.register` (instead of `register`)
+ * with the computer's identity, host info, and detected runtimes.
+ *
+ * The Daemon connection acts as a multiplexing channel:
+ *   - computer.heartbeat events keep the Computer alive
+ *   - agent.create / agent.stop events manage Agent lifecycle on the host
+ *   - task.* messages are routed by agentId for individual agents
+ */
+import { METHODS, EVENTS, parseFrame, isEvent, isRequest, isResponse, } from '@winmatrix/protocol';
+import { WinMatrixAgentClient } from './WinMatrixAgentClient.js';
+/* ── DaemonClient ── */
+export class DaemonClient extends WinMatrixAgentClient {
+    daemonOptions;
+    serverComputerId = null;
+    agentCreateHandler = null;
+    agentStopHandler = null;
+    profileCollector = null;
+    /** 心跳执行锁，防止定时器回调并发 */
+    heartbeatInProgress = false;
+    constructor(options) {
+        super({
+            url: options.url,
+            apiKey: options.token,
+            agentId: `computer:${options.installationId}`,
+            name: options.hostname,
+            agentType: 'daemon',
+            capabilities: { streaming: false, toolCall: false, cancellation: false },
+            autoReconnect: options.autoReconnect,
+            bridgeHooks: options.bridgeHooks,
+        });
+        this.daemonOptions = options;
+    }
+    /** Register handler for daemon-specific events */
+    onDaemonEvent(event, handler) {
+        if (event === 'agent.create') {
+            this.agentCreateHandler = handler;
+        }
+        else if (event === 'agent.stop') {
+            this.agentStopHandler = handler;
+        }
+    }
+    /** Get the server-assigned computer ID (available after successful registration) */
+    getComputerId() {
+        return this.serverComputerId;
+    }
+    /** Set the profile collector function (called during heartbeat to attach agentProfiles) */
+    setProfileCollector(fn) {
+        this.profileCollector = fn;
+    }
+    /**
+     * 通过 daemon 连接发送 agent.error 事件。
+     * 替代直接访问私有 ws 属性，用于 agent.create 失败时通知服务端。
+     */
+    sendAgentError(agentId, error) {
+        if (this.getState() !== 'registered')
+            return false;
+        try {
+            this.sendEvent(EVENTS.AGENT_ERROR, { agentId, error });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Immediately send a heartbeat with agent profiles (used for agent create/destroy/rescan) */
+    async sendHeartbeatNow() {
+        if (this.getState() !== 'registered')
+            return;
+        try {
+            const agentProfiles = this.profileCollector ? await this.profileCollector() : undefined;
+            this.sendEvent(EVENTS.COMPUTER_HEARTBEAT, agentProfiles ? { agentProfiles } : undefined);
+        }
+        catch {
+            // best-effort
+        }
+    }
+    /* ── Protected overrides ── */
+    /**
+     * Override register() to send computer.register instead of agent register.
+     */
+    async register() {
+        const params = {
+            installationId: this.daemonOptions.installationId,
+            token: this.daemonOptions.token,
+            hostname: this.daemonOptions.hostname,
+            os: this.daemonOptions.hostOs,
+            arch: this.daemonOptions.hostArch,
+            daemonVersion: this.daemonOptions.daemonVersion,
+            runtimes: this.daemonOptions.runtimes,
+        };
+        if (this.daemonOptions.supportedAgentTypes?.length) {
+            params.supportedAgentTypes = this.daemonOptions.supportedAgentTypes;
+        }
+        const response = await this.sendRequest(METHODS.COMPUTER_REGISTER, params);
+        if (!response.ok) {
+            throw new Error(`Computer registration failed: ${response.error ?? 'unknown error'}`);
+        }
+        const payload = response.payload;
+        if (payload?.computerId) {
+            this.serverComputerId = payload.computerId;
+        }
+    }
+    /**
+     * Override heartbeat for daemon mode — sends computer.heartbeat events with optional agentProfiles.
+     * 使用锁防止定时器回调并发执行，确保上次心跳完成后再调度下次。
+     */
+    startHeartbeat() {
+        const interval = 30000;
+        this.heartbeatTimer = setInterval(async () => {
+            // 如果上次心跳还在执行，跳过本次
+            if (this.heartbeatInProgress)
+                return;
+            if (this.getState() !== 'registered')
+                return;
+            this.heartbeatInProgress = true;
+            try {
+                const agentProfiles = this.profileCollector ? await this.profileCollector() : undefined;
+                this.sendEvent(EVENTS.COMPUTER_HEARTBEAT, agentProfiles ? { agentProfiles } : undefined);
+            }
+            catch {
+                // Ignore transient send failures
+            }
+            finally {
+                this.heartbeatInProgress = false;
+            }
+        }, interval);
+    }
+    /**
+     * Override to extract agentId before parseFrame and intercept daemon events.
+     *
+     * 注意：方案 B 下 onPassthrough 未设置，passthrough 路由代码（task.assign ACK / wrapper 响应）
+     * 当前为 dead code。每个 agent 有独立 WinMatrixAgentClient + WebSocket，消息由
+     * AgentProcessManager 分发到各 agent 的 client，不经过 daemon 连接多路复用。
+     */
+    handleMessage(data) {
+        const raw = typeof data === 'string' ? data : data.toString('utf-8');
+        // Extract top-level agentId before parseFrame (which drops non-standard fields)
+        let agentId = null;
+        try {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                if (typeof parsed.agentId === 'string' && parsed.agentId.length > 0) {
+                    agentId = parsed.agentId;
+                }
+            }
+        }
+        catch {
+            return;
+        }
+        // Parse the frame for routing
+        const frame = parseFrame(raw);
+        if (!frame)
+            return;
+        // Intercept daemon events BEFORE parent handling
+        if (isEvent(frame)) {
+            const eventFrame = frame;
+            if (this.handleDaemonEvent(eventFrame.event, eventFrame.payload)) {
+                return;
+            }
+        }
+        // Pass through agent-level messages to daemon for wrapper forwarding
+        if (this.daemonOptions.onPassthrough) {
+            if (isRequest(frame)) {
+                const reqFrame = frame;
+                if (reqFrame.method === METHODS.TASK_ASSIGN) {
+                    // Ack receipt, then pass through
+                    this.sendRaw({ type: 'res', id: reqFrame.id, ok: true });
+                    this.daemonOptions.onPassthrough(frame, raw, agentId);
+                    return;
+                }
+                // Other unrecognized requests → pass through
+                this.daemonOptions.onPassthrough(frame, raw, agentId);
+                return;
+            }
+            if (isEvent(frame)) {
+                const evtFrame = frame;
+                // Pass through task/tool events for agent-level routing
+                if (evtFrame.event.startsWith('task.') || evtFrame.event.startsWith('tool.')) {
+                    this.daemonOptions.onPassthrough(frame, raw, agentId);
+                    return;
+                }
+            }
+        }
+        // Pass through response frames for forwarded wrapper requests
+        // (IDs starting with 'wrapper-'). Daemon-originated responses (IDs
+        // starting with 'sdk-') must be handled by the parent's pendingRequests.
+        if (isResponse(frame) && this.daemonOptions.onPassthrough) {
+            const resFrame = frame;
+            if (typeof resFrame.id === 'string' && resFrame.id.startsWith('wrapper-')) {
+                this.daemonOptions.onPassthrough(frame, raw, agentId);
+                return;
+            }
+        }
+        // Delegate to parent for standard message handling (responses, ping, etc.)
+        super.handleMessage(data);
+    }
+    /**
+     * Handle daemon-specific events. Returns true if the event was handled.
+     */
+    handleDaemonEvent(event, payload) {
+        switch (event) {
+            case EVENTS.AGENT_CREATE: {
+                const createPayload = payload;
+                if (createPayload?.agentId && (createPayload?.runtime || createPayload?.agentType === 'hermes' || createPayload?.agentType === 'openclaw')) {
+                    this.agentCreateHandler?.(createPayload);
+                }
+                return true;
+            }
+            case EVENTS.AGENT_STOP: {
+                const stopPayload = payload;
+                if (stopPayload?.agentId) {
+                    this.agentStopHandler?.(stopPayload);
+                }
+                return true;
+            }
+            default:
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=DaemonClient.js.map

package/dist/core/DaemonClient.js.map

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

package/dist/core/RuntimeDoctor.d.ts

@@ -8,6 +8,6 @@ export declare function daemonRuntimeEntryFromClaudeDoctor(result: ClaudeRuntime
 export declare function adapterClaudePathFromRuntimeEntry(runtime: Pick<DaemonRuntimeEntry, 'available' | 'resolvedPath' | 'command'> | undefined): string | undefined;
 export declare function runDaemonRuntimeDoctor(options?: {
     persist?: boolean;
-}): RuntimeDoctorSummary;
+}): Promise<RuntimeDoctorSummary>;
 export declare function formatClaudeDoctorLines(result: ClaudeRuntimeDoctorResult): string[];
 //# sourceMappingURL=RuntimeDoctor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RuntimeDoctor.d.ts","sourceRoot":"","sources":["../../src/core/RuntimeDoctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,GAChC,kBAAkB,CAYpB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC,GAAG,SAAS,GACtF,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,oBAAoB,CAqB5F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAqBnF"}
+{"version":3,"file":"RuntimeDoctor.d.ts","sourceRoot":"","sources":["../../src/core/RuntimeDoctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,GAChC,kBAAkB,CAYpB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS,CAAC,GAAG,SAAS,GACtF,MAAM,GAAG,SAAS,CAKpB;AAsBD,wBAAsB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6B3G;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAqBnF"}

package/dist/core/RuntimeDoctor.js

@@ -1,4 +1,4 @@
-import { detectRuntimes, runClaudeRuntimeDoctor, } from '@winmatrix/agent-sdk';
+import { detectRuntimes, runClaudeRuntimeDoctor, OpenClawAdapter, } from '@winmatrix/agent-sdk';
 import { persistDaemonRuntimeToDisk, } from './ConfigLoader.js';
 export function daemonRuntimeEntryFromClaudeDoctor(result) {
     return {
@@ -19,7 +19,25 @@ export function adapterClaudePathFromRuntimeEntry(runtime) {
     }
     return runtime.resolvedPath ?? runtime.command;
 }
-export function runDaemonRuntimeDoctor(options) {
+/**
+ * 探测本机 openclaw CLI 可用性(spawn `openclaw --version`)。
+ * CLI 模式下不连 gateway(无 WS-RPC scope/protocol 问题),仅验 CLI 可执行。
+ * Promise.race 3s 兜底(虽然 healthCheck 内部 spawnSync 已有 5s timeout,双保险)。
+ */
+async function probeOpenClawGateway(timeoutMs = 3_000) {
+    try {
+        const adapter = new OpenClawAdapter({});
+        const status = await Promise.race([
+            adapter.healthCheck(),
+            new Promise((resolve) => setTimeout(() => resolve({ available: false }), timeoutMs)),
+        ]);
+        return { available: status.available, version: status.version };
+    }
+    catch {
+        return { available: false };
+    }
+}
+export async function runDaemonRuntimeDoctor(options) {
     const claude = runClaudeRuntimeDoctor();
     const runtimeEntry = daemonRuntimeEntryFromClaudeDoctor(claude);
     if (options?.persist !== false) {
@@ -32,6 +50,13 @@ export function runDaemonRuntimeDoctor(options) {
             available: claude.available,
         }
         : runtime));
+    // openclaw 是 WS gateway(非 CLI),detectRuntimes 探不到;用 healthCheck 探测默认本机 gateway
+    const openclawStatus = await probeOpenClawGateway();
+    runtimes.push({
+        name: 'openclaw',
+        available: openclawStatus.available,
+        version: openclawStatus.version,
+    });
     return {
         claude,
         runtimes,

package/dist/core/RuntimeDoctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeDoctor.js","sourceRoot":"","sources":["../../src/core/RuntimeDoctor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,sBAAsB,GAGvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,0BAA0B,GAE3B,MAAM,mBAAmB,CAAC;AAO3B,MAAM,UAAU,kCAAkC,CAChD,MAAiC;IAEjC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAAuF;IAEvF,IAAI,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAA+B;IACpE,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,YAAY,GAAG,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QAC/B,0BAA0B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACjD,OAAO,CAAC,IAAI,KAAK,QAAQ;QACvB,CAAC,CAAC;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B;QACH,CAAC,CAAC,OAAO,CACZ,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiC;IACvE,MAAM,KAAK,GAAG;QACZ,2BAA2B,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,EAAE;QAC3E,yBAAyB,MAAM,CAAC,SAAS,EAAE;QAC3C,sBAAsB,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE;QAC5C,uBAAuB,MAAM,CAAC,OAAO,IAAI,GAAG,EAAE;KAC/C,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"RuntimeDoctor.js","sourceRoot":"","sources":["../../src/core/RuntimeDoctor.ts"],"names":[],"mappings":"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"}

package/dist/core/WinMatrixAgentClient.d.ts

@@ -0,0 +1,183 @@
+/**
+ * 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, type EngineProgressEvent, type EngineLaunchSpec, RuntimeAvailabilityPayload, BaseResponse, BaseRequest, InboundFrame } from '@winmatrix/protocol';
+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;
+    /** Adapter session id for resume */
+    sessionId?: string;
+    /** When true, adapter resumes sessionId */
+    resumeSession?: boolean;
+    /** 新版信封透传的工作目录（来自 LaunchSpec.workDir）；V1 路径不设置。 */
+    workDir?: string;
+    /**
+     * 统一 Agent Engine Gateway Run key（`${recordId}:${attemptNo}`）。
+     * 仅在新版 task.assign 信封（launchSpec）中携带；旧版 V1 assign 时不设置。
+     * daemon 用其做幂等 launch（同一 runKey 重复 assign 不重复执行）。
+     */
+    runKey?: string;
+    /** 新版信封的 invocation fingerprint；不同 fingerprint 拒绝为同一 runKey 启动。 */
+    invocationFingerprint?: string;
+    /** 原始 canonical LaunchSpec（结构化 input/session/model 等），供 adapter 高级用法使用。 */
+    launchSpec?: EngineLaunchSpec;
+    /** 非敏感环境变量（来自 LaunchSpec.nonSensitiveEnv）。 */
+    env?: Record<string, string>;
+    /** Claude 引擎选项（来自 LaunchSpec.permissionMode/allowedTools/engineOptions）。 */
+    claude?: {
+        permissionMode?: string;
+        tools?: string[];
+        disallowedTools?: string[];
+        systemPrompt?: string;
+        maxBudgetUsd?: number;
+        maxTurns?: number;
+        useAgentSdk?: boolean;
+    };
+    /** Hermes 引擎选项（来自 LaunchSpec.model/engineOptions）。 */
+    hermes?: {
+        model?: string;
+        provider?: string;
+        toolsets?: string[];
+    };
+    /** OpenClaw 引擎选项（来自 LaunchSpec.engineOptions）。 */
+    openclaw?: {
+        gatewayHost?: string;
+        gatewayPort?: number;
+    };
+}
+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 host (daemon)
+     * 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>;
+    /** Daemon-side handler for versioned Agent Engine Run control/discovery RPCs. */
+    agentEngineRequestHandler?: (method: string, params: unknown) => Promise<unknown>;
+    /** Validate task.assign identity/capacity before acknowledging launch. */
+    taskAssignAdmission?: (params: unknown) => {
+        ok: true;
+        disposition?: 'accepted' | 'existing';
+    } | {
+        ok: false;
+        error: string;
+    };
+}
+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 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' | '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, meta?: Record<string, unknown>, engineEvent?: EngineProgressEvent): 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(socket?: WebSocket | null): void;
+    private scheduleReconnect;
+    private cleanup;
+    private cleanupSocket;
+}
+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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"}