@winmatrix/agent-sdk 1.0.3 → 1.0.5

package/dist/adapters/codex/CodexAdapter.js

@@ -0,0 +1,313 @@
+/**
+ * CodexAdapter — spawn Codex CLI non-interactive mode and map JSONL/stdout/stderr to AdapterEvent.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { waitForExit, killProcess } from '../../utils/processUtils.js';
+import { sanitizeTaskEnv } from '../../utils/envSanitizer.js';
+import { executeWithResumeFallback } from '../../utils/resumeFallback.js';
+import { classifyAdapterError } from '../../utils/errorClassification.js';
+function splitLines(buffer, chunk) {
+    const combined = buffer + chunk;
+    const parts = combined.split('\n');
+    return {
+        lines: parts.slice(0, -1),
+        remainder: parts[parts.length - 1] ?? '',
+    };
+}
+function extractText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    for (const key of ['text', 'message', 'output', 'result']) {
+        if (typeof record[key] === 'string')
+            return record[key];
+    }
+    // content 可能为字符串或数组：Codex message item 的 content 是 [{type:'output_text', text:'...'}, ...]
+    if (Array.isArray(record.content)) {
+        const parts = [];
+        for (const part of record.content) {
+            if (part && typeof part === 'object') {
+                const p = part;
+                if (typeof p.text === 'string') {
+                    parts.push(p.text);
+                }
+                else if (typeof p.content === 'string') {
+                    parts.push(p.content);
+                }
+            }
+        }
+        if (parts.length > 0)
+            return parts.join('');
+    }
+    else if (typeof record.content === 'string') {
+        return record.content;
+    }
+    return undefined;
+}
+function extractStringField(value, key) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    return typeof record[key] === 'string' ? record[key] : undefined;
+}
+const TELEMETRY_ONLY_EVENT_TYPES = new Set([
+    'init',
+    'thinking_tokens',
+]);
+function isTelemetryOnlyEventType(value) {
+    return TELEMETRY_ONLY_EVENT_TYPES.has(value.trim().toLowerCase());
+}
+function mapCodexJsonLine(line, threadIdRef) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return {
+            type: 'delta',
+            content: trimmed,
+            engineEvent: { type: 'content_delta', text: trimmed },
+        };
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return undefined;
+    const record = parsed;
+    const type = typeof record.type === 'string' ? record.type : '';
+    if (type && isTelemetryOnlyEventType(type))
+        return undefined;
+    if (type === 'thread.started') {
+        const threadId = typeof record.thread_id === 'string' ? record.thread_id : undefined;
+        if (threadId && threadIdRef)
+            threadIdRef.current = threadId;
+        return undefined;
+    }
+    const text = extractText(record.item) ?? extractText(record.delta) ?? extractText(record);
+    if (type === 'error') {
+        const message = text ?? 'Codex error';
+        const classified = classifyAdapterError({ message });
+        return {
+            type: 'error',
+            message,
+            code: classified.code,
+            retryable: classified.retryable,
+        };
+    }
+    if (type === 'turn.failed') {
+        const message = text ?? 'Codex turn failed';
+        const classified = classifyAdapterError({ message });
+        return {
+            type: 'error',
+            message,
+            code: classified.code,
+            retryable: classified.retryable,
+        };
+    }
+    // Codex 最终回答的实测格式：item.completed + item.type=agent_message + item.text（顶层字符串）。
+    // 必须作为 delta 抽取才能累加进 resultText；否则会被下面 name→thinking 分支吞掉，导致 result 为空。
+    const itemType = extractStringField(record.item, 'type');
+    if (type === 'item.completed' && itemType === 'agent_message' && text) {
+        return {
+            type: 'delta',
+            content: text,
+            engineEvent: { type: 'content_delta', text },
+        };
+    }
+    if (type === 'item.started' || type === 'item.completed') {
+        const name = extractStringField(record, 'name')
+            ?? extractStringField(record.item, 'name')
+            ?? extractStringField(record.item, 'type');
+        if (name && isTelemetryOnlyEventType(name))
+            return undefined;
+        if (name) {
+            return {
+                type: 'thinking',
+                content: `[Codex] ${type}: ${name}`,
+                engineEvent: { type: 'status', text: `[Codex] ${type}: ${name}` },
+            };
+        }
+    }
+    if (text) {
+        return {
+            type: 'delta',
+            content: text,
+            engineEvent: { type: 'content_delta', text },
+        };
+    }
+    if (type) {
+        return {
+            type: 'thinking',
+            content: `[Codex] ${type}`,
+            engineEvent: { type: 'status', text: `[Codex] ${type}` },
+        };
+    }
+    return undefined;
+}
+export class CodexAdapter {
+    meta = {
+        agentType: 'codex',
+        runtime: 'codex',
+        capabilities: {
+            streaming: true,
+            toolCall: false,
+            session: false,
+            cancellation: true,
+            supportsCancel: true,
+            supportsResume: true,
+        },
+        tools: [],
+        skills: [],
+        toolCategories: {},
+    };
+    codexPath;
+    sandbox;
+    skipGitRepoCheck;
+    constructor(config) {
+        const opts = config;
+        this.codexPath = opts?.codexPath ?? 'codex';
+        this.sandbox = opts?.sandbox ?? 'workspace-write';
+        this.skipGitRepoCheck = opts?.skipGitRepoCheck ?? true;
+    }
+    async *execute(task, signal) {
+        yield* executeWithResumeFallback(task, signal, (nextTask, nextSignal) => this.executeOnce(nextTask, nextSignal));
+    }
+    async *executeOnce(task, signal) {
+        const workDir = task.workDir;
+        if (workDir && !existsSync(workDir)) {
+            yield {
+                type: 'error',
+                message: `Work directory does not exist: ${workDir}`,
+                code: 'cli_crash',
+                retryable: false,
+            };
+            return;
+        }
+        const prompt = task.systemPrompt
+            ? `${task.systemPrompt}\n\n---\n\n${task.input}`
+            : task.input;
+        const resumeSessionId = task.resumeSession ? task.sessionId : undefined;
+        const args = resumeSessionId
+            ? ['exec', 'resume', '--json', resumeSessionId]
+            : ['exec', '--json', '--sandbox', this.sandbox];
+        if (!resumeSessionId && this.skipGitRepoCheck)
+            args.push('--skip-git-repo-check');
+        args.push(prompt);
+        let proc;
+        try {
+            // 先剥凭据后显式加（harden-external-computer-daemon P1/D3）
+            const { env, strippedKeys } = sanitizeTaskEnv(task.env);
+            if (strippedKeys.length > 0) {
+                console.warn(`[CodexAdapter] 已剥离 ${strippedKeys.length} 个凭据形态环境变量（仅列 key 名）: ${strippedKeys.join(', ')}`);
+            }
+            proc = spawn(this.codexPath, args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env,
+                cwd: workDir ?? process.cwd(),
+                // POSIX 下独立进程组，killProcess 才能 kill(-pid) 杀整棵树
+                detached: process.platform !== 'win32',
+            });
+        }
+        catch (err) {
+            yield {
+                type: 'error',
+                message: `Failed to spawn codex: ${err instanceof Error ? err.message : String(err)}`,
+                code: 'cli_crash',
+                retryable: false,
+            };
+            return;
+        }
+        let completed = false;
+        let resultText = '';
+        let stderrText = '';
+        let threadId = task.resumeSession && task.sessionId ? task.sessionId : undefined;
+        const threadIdRef = { current: threadId };
+        const onAbort = () => {
+            if (!completed)
+                killProcess(proc);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            proc.stderr?.on('data', (chunk) => {
+                const text = chunk.toString('utf-8');
+                stderrText += text;
+            });
+            let stdoutBuffer = '';
+            for await (const chunk of proc.stdout) {
+                if (signal?.aborted)
+                    break;
+                const text = typeof chunk === 'string' ? chunk : chunk.toString('utf-8');
+                const { lines, remainder } = splitLines(stdoutBuffer, text);
+                stdoutBuffer = remainder;
+                for (const line of lines) {
+                    const event = mapCodexJsonLine(line, threadIdRef);
+                    if (threadIdRef.current)
+                        threadId = threadIdRef.current;
+                    if (!event)
+                        continue;
+                    if (event.type === 'delta')
+                        resultText += event.content;
+                    yield event;
+                }
+            }
+            if (stdoutBuffer.trim()) {
+                const event = mapCodexJsonLine(stdoutBuffer, threadIdRef);
+                if (threadIdRef.current)
+                    threadId = threadIdRef.current;
+                if (event) {
+                    if (event.type === 'delta')
+                        resultText += event.content;
+                    yield event;
+                }
+            }
+            const exitResult = await waitForExit(proc);
+            completed = true;
+            if (exitResult.code === 0) {
+                yield {
+                    type: 'result',
+                    content: resultText.trim(),
+                    sessionId: threadId,
+                };
+                return;
+            }
+            const message = stderrText.trim() || exitResult.error || `Codex exited with code ${exitResult.code}`;
+            const classified = classifyAdapterError({
+                message,
+                exitCode: exitResult.code,
+                aborted: signal?.aborted,
+            });
+            yield { type: 'error', message, code: classified.code, retryable: classified.retryable };
+        }
+        finally {
+            signal?.removeEventListener('abort', onAbort);
+            killProcess(proc);
+        }
+    }
+    async healthCheck() {
+        return new Promise((resolve) => {
+            const proc = spawn(this.codexPath, ['--version'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                timeout: 10_000,
+            });
+            let output = '';
+            proc.stdout?.on('data', (chunk) => {
+                output += chunk.toString('utf-8');
+            });
+            proc.on('exit', (code) => {
+                if (code === 0) {
+                    resolve({ available: true, version: output.trim() });
+                    return;
+                }
+                resolve({ available: false, error: `codex --version exited with code ${code}` });
+            });
+            proc.on('error', (err) => {
+                resolve({ available: false, error: `codex CLI not found: ${err.message}` });
+            });
+        });
+    }
+}
+//# sourceMappingURL=CodexAdapter.js.map

package/dist/adapters/codex/CodexAdapter.js.map

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

package/dist/adapters/hermes/HermesAdapter.d.ts

@@ -4,24 +4,32 @@
  * Hermes 原生支持 MCP Client，可直接连接 WinMatrix MCP Bridge。
  * 会话数据存储在 ~/.hermes/state.db SQLite 中。
  */
-import type { AgentAdapter, AdapterEvent, AdapterMeta, AgentTaskContext, HealthStatus, SessionListOptions, SessionListResult, SessionDetailOptions, SessionDetailResult } from '../../core/AgentAdapter.js';
+import type { WorkstationTokenUsageRecorder } from '../../observability/WorkstationTokenUsageRecorder.js';
+import type { AgentAdapter, AdapterEvent, AdapterMeta, AgentTaskContext, HealthStatus, SessionListOptions, SessionListResult, SessionDetailOptions, SessionDetailResult, SessionSearchOptions, SessionSearchResult, SessionDeleteRequest, SessionDeleteResult } from '../../core/AgentAdapter.js';
 export interface HermesAdapterOptions {
     hermesPath?: string;
     /** WinMatrix MCP Bridge URL (Hermes 作为 MCP Client 连接) */
     mcpBridgeUrl?: string;
     /** MCP 认证 token */
     mcpApiKey?: string;
+    workstationId?: string;
+    tokenUsageRecorder?: WorkstationTokenUsageRecorder;
 }
 export declare class HermesAdapter implements AgentAdapter {
     readonly meta: AdapterMeta;
     private hermesPath;
     private mcpBridgeUrl?;
     private mcpApiKey?;
+    private workstationId?;
+    private tokenUsageRecorder?;
     constructor(config?: Record<string, unknown>);
     execute(task: AgentTaskContext, signal?: AbortSignal): AsyncGenerator<AdapterEvent>;
+    private executeOnce;
     healthCheck(): Promise<HealthStatus>;
     listSessions(options: SessionListOptions): Promise<SessionListResult>;
     getSession(sessionId: string, options?: SessionDetailOptions): Promise<SessionDetailResult>;
+    searchSessions(options: SessionSearchOptions): Promise<SessionSearchResult>;
+    deleteSession(sessionId: string, _request: SessionDeleteRequest): Promise<SessionDeleteResult>;
     discoverSkills(_context: {
         workDir?: string;
     }): Promise<Array<{
@@ -33,5 +41,6 @@ export declare class HermesAdapter implements AgentAdapter {
     private scanSkillDirRecursive;
     private openStateDb;
     private queryStateDb;
+    private mutateStateDb;
 }
 //# sourceMappingURL=HermesAdapter.d.ts.map

package/dist/adapters/hermes/HermesAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HermesAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/hermes/HermesAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAYxB;IAEF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASrC,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC;IAoJpF,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IA0BpC,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgCrE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4D/F,cAAc,CAAC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAUhJ,OAAO,CAAC,qBAAqB;YAsBf,WAAW;YAcX,YAAY;CAyB3B"}
+{"version":3,"file":"HermesAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/hermes/HermesAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAkC1G,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EAEnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,6BAA6B,CAAC;CACpD;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAcxB;IAEF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAgC;gBAE/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWrC,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC;YAI3E,WAAW;IA8PpB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IA0BpC,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgCrE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4D/F,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiC3E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiB9F,cAAc,CAAC,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAUhJ,OAAO,CAAC,qBAAqB;YAsBf,WAAW;YAeX,YAAY;IA0B1B,OAAO,CAAC,aAAa;CAWtB"}