@winmatrix/agent-sdk 0.1.0

package/dist/runtime/bridgeHome.js

@@ -0,0 +1,61 @@
+/**
+ * Dual Runtime Bridge 用户目录布局（类似 Hermes：固定用户目录下的状态与配置）。
+ *
+ * 默认：`~/.winmatrix-bridge/`
+ * 覆盖：`WINMATRIX_BRIDGE_HOME`（绝对路径或相对于 cwd）
+ */
+import { mkdirSync, existsSync, readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+export const DEFAULT_BRIDGE_DIR_NAME = '.winmatrix-bridge';
+/** 与 {@link bridgeConfigLoader.DEFAULT_BRIDGE_CONFIG_BASENAME} 一致 */
+export const BRIDGE_CONFIG_FILENAME = 'bridge.config.json';
+/** 日志目录（相对 bridge home） */
+export const REL_LOG_DIR = 'logs';
+/** 进行中任务快照（崩溃后可对照 recovery） */
+export const REL_TASKS_PENDING = path.join('tasks', 'pending');
+/** 已完成任务追加日志（JSON Lines） */
+export const REL_TASKS_RECOVERY = path.join('tasks', 'recovery');
+export function getBridgeHomeDir() {
+    const override = process.env.WINMATRIX_BRIDGE_HOME?.trim();
+    if (override) {
+        return path.isAbsolute(override) ? override : path.join(process.cwd(), override);
+    }
+    return path.join(homedir(), DEFAULT_BRIDGE_DIR_NAME);
+}
+export function getBridgeConfigPath() {
+    return path.join(getBridgeHomeDir(), BRIDGE_CONFIG_FILENAME);
+}
+/** 创建 ~/.winmatrix-bridge/{logs,tasks/pending,tasks/recovery}（幂等） */
+export function ensureBridgeHomeLayout() {
+    const root = getBridgeHomeDir();
+    const dirs = [
+        root,
+        path.join(root, REL_LOG_DIR),
+        path.join(root, REL_TASKS_PENDING),
+        path.join(root, REL_TASKS_RECOVERY),
+    ];
+    for (const d of dirs) {
+        mkdirSync(d, { recursive: true });
+    }
+    return root;
+}
+/**
+ * 若上次异常退出后 `tasks/pending` 仍有快照，启动时打印一行提示（仅人工对照，不触发服务端重派）。
+ * 详见 README「tasks/pending 与 tasks/recovery 的语义」。
+ */
+export function logPendingTasksRecoveryHint() {
+    const dir = path.join(getBridgeHomeDir(), REL_TASKS_PENDING);
+    if (!existsSync(dir))
+        return;
+    try {
+        const n = readdirSync(dir).filter((f) => f.endsWith('.json')).length;
+        if (n > 0) {
+            console.log(`[bridge] recovery hint: ${n} pending task record(s) under ${dir}`);
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=bridgeHome.js.map

package/dist/runtime/bridgeHome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeHome.js","sourceRoot":"","sources":["../../src/runtime/bridgeHome.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,qEAAqE;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE3D,2BAA2B;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/D,4BAA4B;AAC5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAEjE,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,sBAAsB,CAAC,CAAC;AAC/D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC;KACpC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC"}

package/dist/runtime/bridgeReconnectPolicy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Decide whether bridge should keep retrying after a WinMatrixAgentClient connect error.
+ *
+ * Credential / registration mismatches won't fix themselves by reconnecting alone.
+ */
+export declare function isNonRecoverableExternalAgentAuthError(err: unknown): boolean;
+export declare function nextReconnectDelayMs(current: number): number;
+//# sourceMappingURL=bridgeReconnectPolicy.d.ts.map

package/dist/runtime/bridgeReconnectPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeReconnectPolicy.d.ts","sourceRoot":"","sources":["../../src/runtime/bridgeReconnectPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,sCAAsC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI5E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/runtime/bridgeReconnectPolicy.js

@@ -0,0 +1,16 @@
+/**
+ * Decide whether bridge should keep retrying after a WinMatrixAgentClient connect error.
+ *
+ * Credential / registration mismatches won't fix themselves by reconnecting alone.
+ */
+const MAX_BACKOFF_MS = 60_000;
+export function isNonRecoverableExternalAgentAuthError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/invalid_credentials/i.test(msg))
+        return true;
+    return /Registration failed:/i.test(msg) && /invalid_credentials/i.test(msg);
+}
+export function nextReconnectDelayMs(current) {
+    return Math.min(current * 2, MAX_BACKOFF_MS);
+}
+//# sourceMappingURL=bridgeReconnectPolicy.js.map

package/dist/runtime/bridgeReconnectPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeReconnectPolicy.js","sourceRoot":"","sources":["../../src/runtime/bridgeReconnectPolicy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,MAAM,UAAU,sCAAsC,CAAC,GAAY;IACjE,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC"}

package/dist/runtime/bridgeTaskJournal.d.ts

@@ -0,0 +1,7 @@
+import type { TaskInput } from '../core/WinMatrixAgentClient.js';
+export type BridgeRuntimeKindJournal = 'hermes' | 'openclaw';
+/** task.assign 收到后写入 pending（供崩溃对照；不负责服务端重派语义） */
+export declare function recordTaskStarted(runtime: BridgeRuntimeKindJournal, task: TaskInput): void;
+/** complete / fail 后删除 pending，并追加一行 recovery */
+export declare function recordTaskFinished(runtime: BridgeRuntimeKindJournal, taskId: string, outcome: 'complete' | 'fail'): void;
+//# sourceMappingURL=bridgeTaskJournal.d.ts.map

package/dist/runtime/bridgeTaskJournal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeTaskJournal.d.ts","sourceRoot":"","sources":["../../src/runtime/bridgeTaskJournal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAmB7D,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAe1F;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,GAAG,MAAM,GAC3B,IAAI,CAuBN"}

package/dist/runtime/bridgeTaskJournal.js

@@ -0,0 +1,66 @@
+/**
+ * 本地任务快照：进行中写入 tasks/pending，结束后移至 recovery（JSON Lines）。
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { ensureBridgeHomeLayout, getBridgeHomeDir, REL_TASKS_PENDING, REL_TASKS_RECOVERY } from './bridgeHome.js';
+function sanitizeTaskId(taskId) {
+    const safe = taskId.replace(/[^a-zA-Z0-9._-]/g, '_');
+    return safe.slice(0, 180) || 'unknown';
+}
+function pendingFile(taskId) {
+    ensureBridgeHomeLayout();
+    return path.join(getBridgeHomeDir(), REL_TASKS_PENDING, `${sanitizeTaskId(taskId)}.json`);
+}
+function recoveryLogFile() {
+    ensureBridgeHomeLayout();
+    const dir = path.join(getBridgeHomeDir(), REL_TASKS_RECOVERY);
+    mkdirSync(dir, { recursive: true });
+    return path.join(dir, 'completed.jsonl');
+}
+/** task.assign 收到后写入 pending（供崩溃对照；不负责服务端重派语义） */
+export function recordTaskStarted(runtime, task) {
+    try {
+        ensureBridgeHomeLayout();
+        const payload = {
+            taskId: task.taskId,
+            runtime,
+            receivedAt: Date.now(),
+            inputPreview: task.input.slice(0, 4000),
+            ...(task.context?.projectId ? { projectId: task.context.projectId } : {}),
+        };
+        writeFileSync(pendingFile(task.taskId), `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[bridge] task journal pending write failed: ${msg}`);
+    }
+}
+/** complete / fail 后删除 pending，并追加一行 recovery */
+export function recordTaskFinished(runtime, taskId, outcome) {
+    try {
+        ensureBridgeHomeLayout();
+        const pf = pendingFile(taskId);
+        let snapshot = { taskId, runtime };
+        if (existsSync(pf)) {
+            try {
+                snapshot = JSON.parse(readFileSync(pf, 'utf8'));
+            }
+            catch {
+                /* ignore parse */
+            }
+            unlinkSync(pf);
+        }
+        const line = {
+            ...snapshot,
+            outcome,
+            finishedAt: Date.now(),
+        };
+        appendFileSync(recoveryLogFile(), `${JSON.stringify(line)}\n`, 'utf8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[bridge] task journal finish failed: ${msg}`);
+    }
+}
+//# sourceMappingURL=bridgeTaskJournal.js.map

package/dist/runtime/bridgeTaskJournal.js.map

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

package/dist/runtime/localRuntimeAvailabilityMonitor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Probe local Hermes/OpenClaw HTTP endpoints and notify WinMatrix via runtime.availability events.
+ */
+import type { WinMatrixAgentClient } from '../core/WinMatrixAgentClient.js';
+export type LocalRuntimeKindBridge = 'hermes' | 'openclaw';
+/**
+ * Lightweight reachability probe: HEAD the base URL — process down ⇒ fetch throws before status.
+ */
+export declare function probeLocalHttpEndpoint(endpointUrl: string): Promise<{
+    reachable: boolean;
+    error?: string;
+}>;
+export declare function startLocalRuntimeAvailabilityMonitor(options: {
+    client: WinMatrixAgentClient;
+    runtimeKind: LocalRuntimeKindBridge;
+    mode: 'endpoint' | 'command';
+    /** Required when mode is endpoint */
+    endpointUrl?: string;
+    probeIntervalMs?: number;
+    isStopped: () => boolean;
+}): () => void;
+//# sourceMappingURL=localRuntimeAvailabilityMonitor.d.ts.map

package/dist/runtime/localRuntimeAvailabilityMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localRuntimeAvailabilityMonitor.d.ts","sourceRoot":"","sources":["../../src/runtime/localRuntimeAvailabilityMonitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5E,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAK3D;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAYjH;AAED,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,sBAAsB,CAAC;IACpC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B,GAAG,MAAM,IAAI,CA4Db"}

package/dist/runtime/localRuntimeAvailabilityMonitor.js

@@ -0,0 +1,81 @@
+/**
+ * Probe local Hermes/OpenClaw HTTP endpoints and notify WinMatrix via runtime.availability events.
+ */
+const DEFAULT_PROBE_INTERVAL_MS = 15_000;
+const FETCH_TIMEOUT_MS = 10_000;
+/**
+ * Lightweight reachability probe: HEAD the base URL — process down ⇒ fetch throws before status.
+ */
+export async function probeLocalHttpEndpoint(endpointUrl) {
+    const ctl = new AbortController();
+    const tid = setTimeout(() => ctl.abort(), FETCH_TIMEOUT_MS);
+    try {
+        await fetch(endpointUrl, { method: 'HEAD', signal: ctl.signal, redirect: 'manual' });
+        return { reachable: true };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return { reachable: false, error };
+    }
+    finally {
+        clearTimeout(tid);
+    }
+}
+export function startLocalRuntimeAvailabilityMonitor(options) {
+    const intervalMs = options.probeIntervalMs ?? DEFAULT_PROBE_INTERVAL_MS;
+    /** null = never emitted yet */
+    let lastReachableEmitted = null;
+    const notify = (payload) => {
+        if (options.isStopped())
+            return;
+        options.client.notifyRuntimeAvailability(payload);
+    };
+    const tick = async () => {
+        if (options.isStopped())
+            return;
+        if (options.mode === 'command') {
+            const reachable = true;
+            if (lastReachableEmitted === reachable)
+                return;
+            lastReachableEmitted = reachable;
+            notify({
+                runtimeKind: options.runtimeKind,
+                reachable,
+                mode: 'command',
+                checkedAtIso: new Date().toISOString(),
+            });
+            return;
+        }
+        const url = options.endpointUrl?.trim();
+        if (!url) {
+            if (lastReachableEmitted === false)
+                return;
+            lastReachableEmitted = false;
+            notify({
+                runtimeKind: options.runtimeKind,
+                reachable: false,
+                mode: 'endpoint',
+                checkedAtIso: new Date().toISOString(),
+                error: 'missing_endpoint',
+            });
+            return;
+        }
+        const { reachable, error } = await probeLocalHttpEndpoint(url);
+        if (lastReachableEmitted === reachable)
+            return;
+        lastReachableEmitted = reachable;
+        notify({
+            runtimeKind: options.runtimeKind,
+            reachable,
+            mode: 'endpoint',
+            checkedAtIso: new Date().toISOString(),
+            ...(error !== undefined ? { error } : {}),
+        });
+    };
+    void tick();
+    const timer = setInterval(() => void tick(), intervalMs);
+    return () => {
+        clearInterval(timer);
+    };
+}
+//# sourceMappingURL=localRuntimeAvailabilityMonitor.js.map

package/dist/runtime/localRuntimeAvailabilityMonitor.js.map

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

package/dist/runtime/runDualRuntimeBridge.d.ts

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

package/dist/runtime/runDualRuntimeBridge.d.ts.map

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

package/dist/runtime/runDualRuntimeBridge.js

@@ -0,0 +1,32 @@
+import { loadBridgeConfig } from './bridgeConfigLoader.js';
+import { startDualRuntimeBridge } from './DualRuntimeBridge.js';
+async function main() {
+    const config = loadBridgeConfig();
+    const bridge = await startDualRuntimeBridge(config);
+    console.log('[bridge] started. Press Ctrl+C to stop.');
+    const shutdown = () => {
+        console.log('[bridge] shutting down...');
+        bridge.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((err) => {
+    if (err instanceof Error) {
+        const msg = err.message?.trim()
+            ? err.message
+            : [err.name, err.code && `code=${err.code}`]
+                .filter(Boolean)
+                .join(' ')
+                || '(empty error message; see stack below)';
+        console.error(`[bridge] failed: ${msg}`);
+        if (err.stack)
+            console.error(err.stack);
+    }
+    else {
+        console.error('[bridge] failed:', err);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=runDualRuntimeBridge.js.map

package/dist/runtime/runDualRuntimeBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDualRuntimeBridge.js","sourceRoot":"","sources":["../../src/runtime/runDualRuntimeBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE;YAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAG,GAA6B,CAAC,IAAI,IAAI,QAAS,GAA6B,CAAC,IAAI,EAAE,CAAC;iBAC7F,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC;mBACX,wCAAwC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/utils/parseSkillMd.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 解析 SKILL.md 的 YAML frontmatter，提取 name/description/category。
+ * 返回 null 表示文件不存在、无 frontmatter 或 name 为空。
+ */
+export declare function parseSkillMd(filePath: string): {
+    name: string;
+    description?: string;
+    category?: string;
+} | null;
+//# sourceMappingURL=parseSkillMd.d.ts.map

package/dist/utils/parseSkillMd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSkillMd.d.ts","sourceRoot":"","sources":["../../src/utils/parseSkillMd.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB/G"}

package/dist/utils/parseSkillMd.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'node:fs';
+/**
+ * 解析 SKILL.md 的 YAML frontmatter，提取 name/description/category。
+ * 返回 null 表示文件不存在、无 frontmatter 或 name 为空。
+ */
+export function parseSkillMd(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        // 要求结尾 --- 独占一行（仅允许行尾空白），避免匹配 YAML 多行字符串内的 ---
+        const match = content.match(/^---[\t ]*\n([\s\S]*?)\n---[\t ]*(?:\n|$)/);
+        if (!match)
+            return null;
+        const fm = match[1];
+        const result = { name: '' };
+        for (const line of fm.split('\n')) {
+            const kv = line.match(/^(\w[\w\s]*?)\s*:\s*(.*)$/);
+            if (!kv)
+                continue;
+            const key = kv[1].trim().toLowerCase();
+            const value = kv[2].trim().replace(/^['"](.*)['"]$/, '$1');
+            if (key === 'name')
+                result.name = value;
+            else if (key === 'description')
+                result.description = value;
+            else if (key === 'category')
+                result.category = value;
+        }
+        return result.name ? result : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parseSkillMd.js.map

package/dist/utils/parseSkillMd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSkillMd.js","sourceRoot":"","sources":["../../src/utils/parseSkillMd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,+CAA+C;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACzE,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAA8D,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACvF,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACnD,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAC3D,IAAI,GAAG,KAAK,MAAM;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;iBACnC,IAAI,GAAG,KAAK,aAAa;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;iBACtD,IAAI,GAAG,KAAK,UAAU;gBAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;QACvD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/processUtils.d.ts

@@ -0,0 +1,8 @@
+import { type ChildProcess } from 'node:child_process';
+export declare const CANCEL_GRACE_MS = 10000;
+export declare function waitForExit(proc: ChildProcess): Promise<{
+    code: number | null;
+    error?: string;
+}>;
+export declare function killProcess(proc: ChildProcess): void;
+//# sourceMappingURL=processUtils.d.ts.map

package/dist/utils/processUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processUtils.d.ts","sourceRoot":"","sources":["../../src/utils/processUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAYhG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAYpD"}

package/dist/utils/processUtils.js

@@ -0,0 +1,31 @@
+export const CANCEL_GRACE_MS = 10_000;
+export function waitForExit(proc) {
+    return new Promise((resolve) => {
+        proc.once('exit', (code, sig) => {
+            resolve({
+                code,
+                error: sig ? `Process killed by signal ${sig}` : undefined,
+            });
+        });
+        proc.once('error', (err) => {
+            resolve({ code: null, error: err.message });
+        });
+    });
+}
+export function killProcess(proc) {
+    if (proc.exitCode !== null || proc.signalCode !== null)
+        return;
+    try {
+        proc.kill('SIGTERM');
+        setTimeout(() => {
+            try {
+                if (proc.exitCode === null && proc.signalCode === null) {
+                    proc.kill('SIGKILL');
+                }
+            }
+            catch { /* already dead */ }
+        }, CANCEL_GRACE_MS);
+    }
+    catch { /* already dead */ }
+}
+//# sourceMappingURL=processUtils.js.map

package/dist/utils/processUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processUtils.js","sourceRoot":"","sources":["../../src/utils/processUtils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC9B,OAAO,CAAC;gBACN,IAAI;gBACJ,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;aAC3D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO;IAC/D,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;oBACvD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC,EAAE,eAAe,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAChC,CAAC"}

package/dist/utils/spawnHelper.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 统一子进程 spawn 封装
+ *
+ * 供 ClaudeAdapter 和 HermesAdapter 共用。
+ * 提供超时、取消、stderr 转发、环境变量注入。
+ */
+import { type ChildProcess } from 'node:child_process';
+export interface SpawnHelperOptions {
+    /** 命令 */
+    command: string;
+    /** 参数 */
+    args: string[];
+    /** 工作目录 */
+    cwd?: string;
+    /** 环境变量（合并到 process.env） */
+    env?: NodeJS.ProcessEnv;
+    /** 超时时间 (ms)，超时后 SIGTERM → SIGKILL */
+    timeoutMs?: number;
+    /** AbortSignal 用于外部取消 */
+    signal?: AbortSignal;
+    /** 可选：将 stderr 内容转发到此回调 */
+    onStderr?: (text: string) => void;
+}
+export interface SpawnResult {
+    proc: ChildProcess;
+    /** stdout 异步迭代器 */
+    stdout: AsyncIterable<string>;
+    /** 等待进程退出 */
+    waitForExit: () => Promise<{
+        code: number | null;
+        error?: string;
+    }>;
+}
+/**
+ * 启动子进程并返回统一的流式接口
+ */
+export declare function spawnHelper(options: SpawnHelperOptions): SpawnResult;
+//# sourceMappingURL=spawnHelper.d.ts.map

package/dist/utils/spawnHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnHelper.d.ts","sourceRoot":"","sources":["../../src/utils/spawnHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,SAAS;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,mBAAmB;IACnB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa;IACb,WAAW,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAqGpE"}

package/dist/utils/spawnHelper.js

@@ -0,0 +1,122 @@
+/**
+ * 统一子进程 spawn 封装
+ *
+ * 供 ClaudeAdapter 和 HermesAdapter 共用。
+ * 提供超时、取消、stderr 转发、环境变量注入。
+ */
+import { spawn } from 'node:child_process';
+const CANCEL_GRACE_MS = 10_000;
+/**
+ * 启动子进程并返回统一的流式接口
+ */
+export function spawnHelper(options) {
+    const spawnOpts = {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        cwd: options.cwd ?? process.cwd(),
+        env: { ...process.env, ...(options.env ?? {}) },
+    };
+    const proc = spawn(options.command, options.args, spawnOpts);
+    // Timeout
+    let timeoutTimer;
+    if (options.timeoutMs && options.timeoutMs > 0) {
+        timeoutTimer = setTimeout(() => {
+            killProcess(proc);
+        }, options.timeoutMs);
+    }
+    // Abort signal
+    const onAbort = () => killProcess(proc);
+    options.signal?.addEventListener('abort', onAbort, { once: true });
+    // stderr forwarding
+    if (options.onStderr) {
+        proc.stderr?.on('data', (chunk) => {
+            options.onStderr?.(chunk.toString('utf-8'));
+        });
+    }
+    // stdout async iterator
+    const stdoutIterable = {
+        [Symbol.asyncIterator]() {
+            const buffer = [];
+            let resolveNext = null;
+            let done = false;
+            const onData = (chunk) => {
+                const text = chunk.toString('utf-8');
+                if (resolveNext) {
+                    resolveNext({ value: text, done: false });
+                    resolveNext = null;
+                }
+                else {
+                    buffer.push(text);
+                }
+            };
+            const onEnd = () => {
+                done = true;
+                if (resolveNext) {
+                    resolveNext({ value: undefined, done: true });
+                    resolveNext = null;
+                }
+            };
+            proc.stdout?.on('data', onData);
+            proc.once('exit', onEnd);
+            proc.stdout?.once('end', onEnd);
+            return {
+                async next() {
+                    if (done && buffer.length === 0) {
+                        return { value: undefined, done: true };
+                    }
+                    if (buffer.length > 0) {
+                        return { value: buffer.shift(), done: false };
+                    }
+                    return new Promise((resolve) => {
+                        resolveNext = resolve;
+                    });
+                },
+                async return() {
+                    proc.stdout?.removeListener('data', onData);
+                    done = true;
+                    if (resolveNext) {
+                        resolveNext({ value: undefined, done: true });
+                        resolveNext = null;
+                    }
+                    return { value: undefined, done: true };
+                },
+            };
+        },
+    };
+    const waitForExit = () => {
+        return new Promise((resolve) => {
+            proc.once('exit', (code, sig) => {
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                options.signal?.removeEventListener('abort', onAbort);
+                resolve({
+                    code,
+                    error: sig ? `${options.command} killed by signal ${sig}` : undefined,
+                });
+            });
+            proc.once('error', (err) => {
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                options.signal?.removeEventListener('abort', onAbort);
+                resolve({ code: null, error: err.message });
+            });
+        });
+    };
+    return { proc, stdout: stdoutIterable, waitForExit };
+}
+function killProcess(proc) {
+    if (proc.exitCode !== null || proc.signalCode !== null)
+        return;
+    try {
+        proc.kill('SIGTERM');
+        setTimeout(() => {
+            try {
+                if (proc.exitCode === null && proc.signalCode === null) {
+                    proc.kill('SIGKILL');
+                }
+            }
+            catch { /* already dead */ }
+        }, CANCEL_GRACE_MS);
+    }
+    catch { /* already dead */ }
+}
+//# sourceMappingURL=spawnHelper.js.map

package/dist/utils/spawnHelper.js.map

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