oh-my-knowledge 0.52.3 → 0.53.0

package/dist/renderer/html-renderer.js

@@ -57,7 +57,20 @@ function renderDebiasModeTag(modes, lang) {
 function pluralizeEn(count, singular, plural = `${singular}s`) {
     return `${count} ${count === 1 ? singular : plural}`;
 }
-function gatherRuntimeScopes(meta) {
+function executorDisplayName(executor, lang) {
+    if (executor === 'dsh-host') {
+        return lang === 'zh' ? 'DeepSeek Harness（宿主模式）' : 'DeepSeek Harness (host mode)';
+    }
+    return executor || 'unknown';
+}
+function executorModelDisplayName(executor, model, lang) {
+    const executorName = executorDisplayName(executor, lang);
+    const modelName = model || 'unknown';
+    if (executor === 'dsh-host')
+        return `${executorName} · ${modelName}`;
+    return `${executorName}:${modelName}`;
+}
+function gatherRuntimeScopes(meta, lang) {
     const scopes = [];
     if (meta.executorRuntimes && Object.keys(meta.executorRuntimes).length > 0) {
         Object.entries(meta.executorRuntimes)
@@ -75,14 +88,19 @@ function gatherRuntimeScopes(meta) {
             .slice()
             .sort((a, b) => `${a.executor}:${a.model}`.localeCompare(`${b.executor}:${b.model}`))
             .forEach((entry) => {
-            if (entry.runtime)
-                scopes.push({ role: 'judge', scope: `${entry.executor}:${entry.model}`, runtime: entry.runtime });
+            if (entry.runtime) {
+                scopes.push({
+                    role: 'judge',
+                    scope: executorModelDisplayName(entry.executor, entry.model, lang),
+                    runtime: entry.runtime,
+                });
+            }
         });
     }
     if (meta.diagnostic?.enabled && meta.diagnostic.runtime) {
         scopes.push({
             role: 'diagnostic',
-            scope: `${meta.diagnostic.executor}:${meta.diagnostic.model}`,
+            scope: executorModelDisplayName(meta.diagnostic.executor, meta.diagnostic.model, lang),
             runtime: meta.diagnostic.runtime,
         });
     }
@@ -105,6 +123,7 @@ function runtimeTooltip(runtime) {
         `cost=${runtime.capabilities.costUSD}`,
         `trace=${runtime.capabilities.trace}`,
         `skillIsolation=${runtime.capabilities.skillIsolation}`,
+        ...(runtime.auditability ? [`auditability=${runtime.auditability.status}`] : []),
         ...(runtime.binary?.contentHash
             ? [`contentHash=${runtime.binary.contentHash}`]
             : []),
@@ -115,7 +134,7 @@ function runtimeTooltip(runtime) {
 // fingerprint 重复 3 遍，扫读成本高。新版按 (fingerprint, versionText)
 // 分组，scope 合并到 tag 内 "适用于 ..." 后缀。
 function renderRuntimeFingerprintTags(meta, lang) {
-    const scopes = gatherRuntimeScopes(meta);
+    const scopes = gatherRuntimeScopes(meta, lang);
     if (scopes.length === 0)
         return '';
     const groups = new Map();
@@ -476,11 +495,11 @@ export function renderRunDetail(report, lang = DEFAULT_LANG, skillContext) {
         if (list.length === 0)
             return `<span class="meta-tag">${t('judge', lang)}: —</span>`;
         if (list.length === 1)
-            return `<span class="meta-tag">${t('judge', lang)}: ${e(`${list[0].executor}:${list[0].model}`)}</span>`;
-        return `<span class="meta-tag" title="${t('ensembleDesc', lang)}">${t('judgeModelsLabel', lang)}: ${list.map((j) => e(`${j.executor}:${j.model}`)).join(' · ')}</span>`;
+            return `<span class="meta-tag">${t('judge', lang)}: ${e(executorModelDisplayName(list[0].executor, list[0].model, lang))}</span>`;
+        return `<span class="meta-tag" title="${t('ensembleDesc', lang)}">${t('judgeModelsLabel', lang)}: ${list.map((j) => e(executorModelDisplayName(j.executor, j.model, lang))).join(' · ')}</span>`;
     })()}
     ${m.judgeRepeat && m.judgeRepeat > 1 ? `<span class="meta-tag" title="${t('judgeStddevDesc', lang)}">${t('judgeRepeatLabel', lang)}: ${m.judgeRepeat}</span>` : ''}
-    <span class="meta-tag">${t('executor', lang)}: ${e(m.executor || 'unknown')}</span>
+    <span class="meta-tag">${t('executor', lang)}: ${e(executorDisplayName(m.executor, lang))}</span>
     ${m.effort ? `<span class="meta-tag" title="${e(lang === 'zh' ? 'executor LLM 的扩展思考预算(--effort)。跨 effort 报告不可严格比较' : 'reasoning effort for executor LLM (--effort); reports across different efforts are not strictly comparable')}">effort: ${e(m.effort)}</span>` : ''}
     <span class="meta-tag"${execCostReported ? '' : ` title="${e(lang === 'zh' ? 'executor 不报 USD 成本(如 codex CLI),无法估算' : 'executor does not report USD cost (e.g. codex CLI); not measurable')}"`}>${t('cost', lang)}: ${fmtCost(totalExecCost, execCostReported)}</span>
     <span class="meta-tag"${totalCostReported ? '' : ` title="${e(costCompletenessTooltip(lang))}"`}>${totalCostLabel}: ${fmtKnownCost(m.totalCostUSD, totalCostReported)}</span>${processCostTag ? `
@@ -639,10 +658,10 @@ export function renderBatchEvaluationDetail(report, lang = DEFAULT_LANG) {
         if (list.length === 0)
             return `<span class="meta-tag">${t('judge', lang)}: —</span>`;
         if (list.length === 1)
-            return `<span class="meta-tag">${t('judge', lang)}: ${e(`${list[0].executor}:${list[0].model}`)}</span>`;
-        return `<span class="meta-tag" title="${t('ensembleDesc', lang)}">${t('judgeModelsLabel', lang)}: ${list.map((j) => e(`${j.executor}:${j.model}`)).join(' · ')}</span>`;
+            return `<span class="meta-tag">${t('judge', lang)}: ${e(executorModelDisplayName(list[0].executor, list[0].model, lang))}</span>`;
+        return `<span class="meta-tag" title="${t('ensembleDesc', lang)}">${t('judgeModelsLabel', lang)}: ${list.map((j) => e(executorModelDisplayName(j.executor, j.model, lang))).join(' · ')}</span>`;
     })()}
-      <span class="meta-tag">${t('executor', lang)}: ${e(m.executor || 'unknown')}</span>
+      <span class="meta-tag">${t('executor', lang)}: ${e(executorDisplayName(m.executor, lang))}</span>
       <span class="meta-tag"${totalCostReported ? '' : ` title="${e(costCompletenessTooltip(lang))}"`}>${t('totalCost', lang)}: ${fmtKnownCost(m.totalCostUSD, totalCostReported)}</span>
     </div>
     ${(() => {

package/dist/types/executor.d.ts

@@ -88,7 +88,7 @@ export interface ExecutorInput {
      *  - claude-cli:物化为临时 settings.json + on-disk hook 脚本,跑完清理
      *  - script(自定义脚本):同样物化临时 settings,通过 env(OMK_MOCK_SETTINGS_FILE /
      *    OMK_MOCK_MCP_CONFIG_FILE / OMK_MOCKS_FILE)暴露给脚本;脚本负责消费该协议
-     *  - codex / codex-sdk / gemini / *-api:不支持,executor capability gate 会拒绝,
+     *  - codex / codex-sdk / *-api:不支持,executor capability gate 会拒绝,
      *    绝不静默忽略后把 mock_hit 记成模型失败 */
     mocks?: import('./eval.js').Mock[];
     /** 解析 mock.return_file 的相对路径锚点(默认 sample 文件所在目录)。 */
@@ -119,7 +119,13 @@ export interface ExecutorInput {
      */
     effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 }
-export type ExecutorFn = (input: ExecutorInput) => Promise<ExecResult>;
+export type ExecutorRuntimeFingerprintResolver = (model: string, options?: {
+    skillDir?: string | null;
+}) => ExecutorRuntimeFingerprint;
+export type ExecutorFn = ((input: ExecutorInput) => Promise<ExecResult>) & {
+    /** Same-process hosts can report the runtime that actually owns execution. */
+    readonly runtimeFingerprint?: ExecutorRuntimeFingerprintResolver;
+};
 export interface ExecutorCache {
     get(key: string): ExecResult | null;
     set(key: string, value: ExecResult): void;
@@ -176,5 +182,10 @@ export interface ExecutorRuntimeFingerprint {
     fingerprint: string;
     binary?: ExecutorRuntimeBinary;
     sdk?: ExecutorRuntimePackage;
+    /** Whether the recorded fields cover the complete effective runtime composition. */
+    auditability?: {
+        status: 'complete' | 'partial';
+        reasons?: string[];
+    };
     capabilities: ExecutorRuntimeCapabilities;
 }

package/dist/types/judge.d.ts

@@ -1,9 +1,9 @@
 import type { ExecutorRuntimeFingerprint } from './executor.js';
 /** Single judge configuration: which executor to call and which model alias to pass. */
 export interface JudgeConfig {
-    /** Executor name (claude / openai / gemini / anthropic-api / openai-api / shell command). */
+    /** Executor name (claude / codex / anthropic-api / openai-api / shell command). */
     executor: string;
-    /** Model alias passed to the executor (e.g. "opus", "haiku", "gpt-4o", "gemini-2.0-pro"). */
+    /** Model alias passed to the executor (e.g. "opus", "haiku", "gpt-4o"). */
     model: string;
 }
 /** Persisted judge entry on Report.meta.judgeModels: judge config + runtime fingerprint of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-knowledge",
-  "version": "0.52.3",
+  "version": "0.53.0",
   "packageManager": "yarn@4.16.0",
   "description": "OMK — Observe. Measure. Know. Evidence-backed knowledge changes for AI applications.",
   "type": "module",
@@ -13,6 +13,11 @@
   "files": [
     "dist/"
   ],
+  "dsh": {
+    "bundle": {
+      "patch": "./dist/dsh-plugin/cordis.patch.yml"
+    }
+  },
   "scripts": {
     "clean": "rm -rf dist dist-scripts node_modules/.cache/omk",
     "build": "run-s build:src build:scripts build:assets",
@@ -28,6 +33,7 @@
     "lint": "eslint 'src/**/*.ts' 'test/**/*.ts' --cache --cache-location node_modules/.cache/eslint/ --max-warnings 0",
     "lint-staged": "lint-staged",
     "test": "vitest run",
+    "test:profile": "yarn build && node dist-scripts/test-profile.js",
     "ci": "run-s lint typecheck build build:docs:check test",
     "prepublishOnly": "run-s clean build",
     "prepare": "husky"
@@ -98,12 +104,10 @@
   "author": "lizhiyao",
   "license": "MIT",
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.143",
-    "@anthropic-ai/sdk": "^0.117.1",
+    "@anthropic-ai/sdk": "^0.120.0",
     "@inquirer/prompts": "^8.4.3",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@oclif/core": "^4",
-    "@openai/codex-sdk": "0.147.0",
     "ajv": "^8.18.0",
     "chart.js": "^4.5.1",
     "es-module-lexer": "^2.0.0",
@@ -111,6 +115,18 @@
     "simple-statistics": "^7.8.9",
     "zod": "^4.4.3"
   },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.143",
+    "@openai/codex-sdk": "^0.149.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@openai/codex-sdk": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
@@ -124,6 +140,6 @@
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",
     "vitepress": "^1.6.4",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   }
 }

package/dist/executors/claude-protocol.d.ts

@@ -1,28 +0,0 @@
-import type { ExecResult } from '../types/index.js';
-import type { ClaudeSdkBaseMessage, ClaudeSdkResultMessage } from './shared.js';
-export interface ClaudeSdkMeasurements {
-    durationMs: number;
-    durationApiMs: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens: number;
-    cacheCreationTokens: number;
-    costUSD: number;
-    numTurns: number;
-}
-export declare function normalizeClaudeSdkMeasurements(result: ClaudeSdkResultMessage): ClaudeSdkMeasurements | {
-    error: string;
-};
-export interface ClaudeStreamParseResult {
-    messages: ClaudeSdkBaseMessage[];
-    malformedLineCount: number;
-}
-export declare function parseClaudeStreamJson(stdout: string): ClaudeStreamParseResult;
-export declare function buildClaudeResult(options: {
-    messages: ClaudeSdkBaseMessage[];
-    wallClockDurationMs: number;
-    source: 'claude stream-json' | 'claude-sdk';
-    malformedLineCount?: number;
-    forcedError?: string;
-    messageTimestamps?: number[];
-}): ExecResult;

package/dist/executors/claude-sdk-trace.d.ts

@@ -1,9 +0,0 @@
-import type { ToolCallInfo, TurnInfo } from '../types/index.js';
-import type { ClaudeSdkBaseMessage } from './shared.js';
-export declare function isClaudeSdkResultMessage(message: ClaudeSdkBaseMessage): boolean;
-export declare function extractAgentTrace(messages: ClaudeSdkBaseMessage[], timestamps?: number[]): {
-    turns: TurnInfo[];
-    toolCalls: ToolCallInfo[];
-    fullNumTurns: number;
-    numSubAgents: number;
-};

package/dist/executors/codex-protocol.d.ts

@@ -1,24 +0,0 @@
-import type { ExecResult } from '../types/index.js';
-import type { CodexEvent } from './shared.js';
-export declare function extractCodexUsage(events: CodexEvent[]): {
-    input: number;
-    cached: number;
-    output: number;
-};
-/**
- * Match @openai/codex-sdk's `finalResponse`: the latest completed
- * agent_message is the answer. Earlier messages remain available in `turns`.
- */
-export declare function extractCodexFinalOutput(events: CodexEvent[]): string;
-export declare function extractCodexProtocolError(events: CodexEvent[]): string | undefined;
-export declare function validateCodexProtocol(events: CodexEvent[]): string | undefined;
-export declare function extractCodexStopReason(events: CodexEvent[]): string;
-export declare function sumCodexElapsed(resultEvents: CodexEvent[], wallClock: number): number;
-export interface BuildCodexResultOptions {
-    events: CodexEvent[];
-    wallClockDurationMs: number;
-    source: 'codex --json' | 'codex-sdk';
-    malformedLineCount?: number;
-    forcedError?: string;
-}
-export declare function buildCodexResult({ events, wallClockDurationMs, source, malformedLineCount, forcedError, }: BuildCodexResultOptions): ExecResult;

package/dist/executors/gemini.d.ts

@@ -1,2 +0,0 @@
-import type { ExecResult, ExecutorInput } from '../types/index.js';
-export declare function geminiExecutor({ model, system, prompt, timeoutMs }: ExecutorInput): Promise<ExecResult>;

package/dist/executors/gemini.js

@@ -1,156 +0,0 @@
-import { DEFAULT_TIMEOUT_MS, errorMessage, interruptedExecResult, parseJson, spawnWithSigintPropagation, timeoutExecResult, } from './shared.js';
-import { optionalTokenCount } from '../shared/token-usage.js';
-export async function geminiExecutor({ model, system, prompt, timeoutMs = DEFAULT_TIMEOUT_MS }) {
-    const fullPrompt = system ? `${system}\n\n${prompt}` : prompt;
-    const start = Date.now();
-    try {
-        const args = [];
-        if (model)
-            args.push('--model', model);
-        const { child, done } = spawnWithSigintPropagation('gemini', args, {
-            env: { ...process.env },
-            timeoutMs,
-        });
-        child.stdin?.on('error', () => undefined);
-        child.stdin?.write(fullPrompt);
-        child.stdin?.end();
-        let output;
-        try {
-            const r = await done;
-            output = r.stdout;
-        }
-        catch (err) {
-            const details = err;
-            if (details.killedByTimeout)
-                return timeoutExecResult(timeoutMs, Date.now() - start);
-            if (details.killedBySignal)
-                return interruptedExecResult(Date.now() - start);
-            const durationMs = Date.now() - start;
-            return {
-                ok: false,
-                error: details.stderr?.trim() || details.message || `gemini exited with code ${details.code ?? '?'}`,
-                durationMs,
-                durationApiMs: 0,
-                inputTokens: 0,
-                outputTokens: 0,
-                cacheReadTokens: 0,
-                cacheCreationTokens: 0,
-                tokenUsageReportedByExecutor: false,
-                costUSD: 0,
-                costReportedByExecutor: false,
-                output: details.stdout?.trim() || null,
-                stopReason: 'error',
-                numTurns: 0,
-            };
-        }
-        const durationMs = Date.now() - start;
-        let text = output;
-        let inputTokens = 0;
-        let outputTokens = 0;
-        let tokenUsageReported = false;
-        try {
-            const parsed = parseJson(output);
-            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                const record = parsed;
-                const declaresProtocol = Object.hasOwn(record, 'response')
-                    || Object.hasOwn(record, 'stats');
-                if (declaresProtocol) {
-                    const data = parsed;
-                    if (typeof data.response !== 'string') {
-                        return invalidGeminiProtocolResult(durationMs, '"response" must be a string');
-                    }
-                    text = data.response;
-                    if (data.stats !== undefined
-                        && (!data.stats
-                            || typeof data.stats !== 'object'
-                            || Array.isArray(data.stats))) {
-                        return invalidGeminiProtocolResult(durationMs, '"stats" must be an object when present');
-                    }
-                    if (data.stats !== undefined) {
-                        const parsedInput = optionalTokenCount(data.stats.inputTokens);
-                        const parsedOutput = optionalTokenCount(data.stats.outputTokens);
-                        if (parsedInput === undefined || parsedOutput === undefined) {
-                            return invalidGeminiProtocolResult(durationMs, 'invalid token usage');
-                        }
-                        inputTokens = parsedInput;
-                        outputTokens = parsedOutput;
-                        tokenUsageReported = true;
-                    }
-                }
-            }
-        }
-        catch {
-            text = output.trim();
-        }
-        if (!text.trim()) {
-            return {
-                ok: false,
-                error: 'gemini completed without model output',
-                durationMs,
-                durationApiMs: 0,
-                inputTokens,
-                outputTokens,
-                cacheReadTokens: 0,
-                cacheCreationTokens: 0,
-                ...(!tokenUsageReported && { tokenUsageReportedByExecutor: false }),
-                costUSD: 0,
-                costReportedByExecutor: false,
-                output: null,
-                stopReason: 'error',
-                numTurns: 1,
-            };
-        }
-        return {
-            ok: true,
-            durationMs,
-            durationApiMs: 0,
-            inputTokens,
-            outputTokens,
-            cacheReadTokens: 0,
-            cacheCreationTokens: 0,
-            ...(!tokenUsageReported && { tokenUsageReportedByExecutor: false }),
-            costUSD: 0,
-            costReportedByExecutor: false,
-            output: text,
-            stopReason: 'end',
-            numTurns: 1,
-        };
-    }
-    catch (err) {
-        const durationMs = Date.now() - start;
-        return {
-            ok: false,
-            error: errorMessage(err),
-            durationMs,
-            durationApiMs: 0,
-            inputTokens: 0,
-            outputTokens: 0,
-            cacheReadTokens: 0,
-            cacheCreationTokens: 0,
-            tokenUsageReportedByExecutor: false,
-            costUSD: 0,
-            costReportedByExecutor: false,
-            output: null,
-            stopReason: 'error',
-            numTurns: 0,
-        };
-    }
-}
-function invalidGeminiProtocolResult(durationMs, message) {
-    return {
-        ok: false,
-        error: `gemini returned malformed protocol JSON: ${message}`,
-        durationMs,
-        durationApiMs: 0,
-        inputTokens: 0,
-        outputTokens: 0,
-        cacheReadTokens: 0,
-        cacheCreationTokens: 0,
-        tokenUsageReportedByExecutor: false,
-        costUSD: 0,
-        costReportedByExecutor: false,
-        output: null,
-        stopReason: 'error',
-        numTurns: 1,
-    };
-}

package/dist/executors/runtime-fingerprint.d.ts

@@ -1,6 +0,0 @@
-import type { ExecutorRuntimeFingerprint } from '../types/index.js';
-export interface ExecutorRuntimeFingerprintOptions {
-    skillDir?: string | null;
-    env?: NodeJS.ProcessEnv;
-}
-export declare function getExecutorRuntimeFingerprint(executorName: string, model: string, options?: ExecutorRuntimeFingerprintOptions): ExecutorRuntimeFingerprint;

package/dist/executors/shared.d.ts

@@ -1,226 +0,0 @@
-import { execFile, type ChildProcess } from 'node:child_process';
-import type { ExecResult } from '../types/index.js';
-export declare const execFileAsync: typeof execFile.__promisify__;
-export declare const DEFAULT_MODEL = "sonnet";
-export declare const JUDGE_MODEL = "haiku";
-export declare const DEFAULT_TIMEOUT_MS = 600000;
-export declare const MAX_BUFFER: number;
-export type ExecutorVendor = 'anthropic' | 'openai' | 'google' | 'unknown';
-export declare function executorVendor(executor: string): ExecutorVendor;
-export interface TokenUsage {
-    input_tokens?: number;
-    output_tokens?: number;
-    cache_read_input_tokens?: number;
-    cache_creation_input_tokens?: number;
-}
-export interface ClaudeCliResponse {
-    is_error?: boolean;
-    duration_ms?: number;
-    duration_api_ms?: number;
-    usage?: TokenUsage;
-    total_cost_usd?: number;
-    result?: string;
-    stop_reason?: string | null;
-    num_turns?: number;
-}
-export interface OpenAiUsage {
-    prompt_tokens?: number;
-    completion_tokens?: number;
-    prompt_tokens_details?: {
-        cached_tokens?: number;
-    };
-}
-export interface OpenAiResponse {
-    usage?: OpenAiUsage;
-    choices?: Array<{
-        message?: {
-            content?: string | null;
-            refusal?: string | null;
-        };
-        finish_reason?: string;
-    }>;
-    error?: {
-        message?: string;
-    };
-}
-export interface GeminiResponse {
-    response?: string;
-    stats?: {
-        inputTokens?: number;
-        outputTokens?: number;
-    };
-}
-export interface AnthropicResponse {
-    usage?: TokenUsage;
-    content?: Array<{
-        type?: string;
-        text?: string;
-    }>;
-    stop_reason?: string;
-    error?: {
-        message?: string;
-    };
-}
-export interface ClaudeSdkQueryOptions {
-    model?: string;
-    systemPrompt?: string;
-    cwd: string;
-    permissionMode: 'bypassPermissions';
-    allowDangerouslySkipPermissions: true;
-    abortController: AbortController;
-    env: NodeJS.ProcessEnv;
-}
-export interface ClaudeSdkQueryInput {
-    prompt: string;
-    options: ClaudeSdkQueryOptions;
-}
-export interface ClaudeSdkBaseMessage {
-    type: string;
-    message?: {
-        role?: string;
-        content?: Array<{
-            type: string;
-            text?: string;
-            id?: string;
-            name?: string;
-            input?: unknown;
-        }>;
-    };
-    tool_use_id?: string;
-    content?: string | Array<{
-        type: string;
-        text?: string;
-    }>;
-    is_error?: boolean;
-}
-export interface ClaudeSdkResultMessage extends ClaudeSdkBaseMessage {
-    type: 'result';
-    result?: string;
-    usage?: TokenUsage;
-    total_cost_usd?: number;
-    duration_api_ms?: number;
-    duration_ms?: number;
-    num_turns?: number;
-    stop_reason?: string | null;
-    modelUsage?: Record<string, {
-        inputTokens?: number;
-        outputTokens?: number;
-        cacheReadInputTokens?: number;
-        cacheCreationInputTokens?: number;
-    }>;
-    subtype?: string;
-    errors?: string[];
-}
-export interface ClaudeSdkModule {
-    query: (opts: ClaudeSdkQueryInput) => AsyncIterable<ClaudeSdkBaseMessage>;
-}
-export interface CodexEvent {
-    type?: string;
-    turn_id?: string;
-    usage?: {
-        input_tokens?: number;
-        cached_input_tokens?: number;
-        output_tokens?: number;
-        reasoning_output_tokens?: number;
-    };
-    elapsed_ms?: number;
-    stop_reason?: string;
-    item?: {
-        id?: string;
-        type?: string;
-        text?: string;
-        command?: string;
-        aggregated_output?: string;
-        exit_code?: number | null;
-        status?: string;
-        path?: string;
-        content?: string;
-        query?: string;
-        results?: unknown[];
-        changes?: Array<{
-            path?: string;
-            changeKind?: string;
-        }>;
-        server?: string;
-        tool?: string;
-        name?: string;
-        arguments?: unknown;
-        result?: unknown;
-        message?: string;
-        error?: {
-            message?: string;
-        };
-    };
-    error?: {
-        message?: string;
-    };
-    message?: string;
-    ts?: number;
-}
-/**
- * Translate Codex's external event shape into omk's internal protocol model.
- * Codex currently calls file-change discriminators `kind`; omk reserves bare
- * `kind` for ArtifactKind, so the raw field is qualified at the boundary.
- */
-export declare function normalizeCodexProtocolEvent(value: unknown): CodexEvent | null;
-export interface ExecutorErrorLike {
-    message?: string;
-    name?: string;
-    killed?: boolean;
-    stdout?: string;
-}
-export declare function asErrorLike(err: unknown): ExecutorErrorLike;
-export declare function errorMessage(err: unknown, fallback?: string): string;
-export declare function parseJson<T>(content: string): T;
-export interface JsonResponseBody<T> {
-    data: T | null;
-    rawBody: string;
-}
-export declare function readJsonResponse<T>(response: Response): Promise<JsonResponseBody<T>>;
-export declare function responseBodyPreview(rawBody: string, maxLength?: number): string;
-export declare function buildExecEnv(skillDir?: string | null): NodeJS.ProcessEnv;
-export declare function timeoutExecResult(timeoutMs: number, durationMs: number): ExecResult;
-export declare function interruptedExecResult(durationMs: number): ExecResult;
-/**
- * Register an in-process runtime (for example an SDK-owned child) with the
- * same SIGINT coordinator used by spawned executors.
- */
-export declare function registerSigintSubscriber(subscriber: () => void): () => void;
-export declare function __resetSigintRegistryForTest(): void;
-export interface SpawnHelperResult {
-    stdout: string;
-    stderr: string;
-    code: number | null;
-    signal: NodeJS.Signals | null;
-    killedByTimeout: boolean;
-    killedBySignal: NodeJS.Signals | null;
-}
-export interface SpawnHelperError extends Error {
-    stdout?: string;
-    stderr?: string;
-    code?: number | null;
-    signal?: NodeJS.Signals | null;
-    killedByTimeout?: boolean;
-    killedBySignal?: NodeJS.Signals | null;
-}
-export interface SpawnHelperOptions {
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    /** kill child after this many ms; reject with killedByTimeout=true */
-    timeoutMs?: number;
-    /** per-stream stdout/stderr byte limit; reject when either stream exceeds it */
-    maxBuffer?: number;
-    /** external abort signal; abort() 走跟 SIGINT 同一 grace 路径 */
-    abortSignal?: AbortSignal;
-}
-/**
- * spawn child + 注册到全局 SIGINT registry。返回 { child, done } 让 caller 自己
- * 操作 stdin(写入 / 关闭),通过 done 等结果。
- *
- * 适用:claude / codex / gemini / script CLI 子进程。HTTP executor(*-api)用 fetch +
- * AbortSignal.timeout,自带 abort,不走这个。claude-sdk in-process 也不走。
- */
-export declare function spawnWithSigintPropagation(command: string, args: string[], options?: SpawnHelperOptions): {
-    child: ChildProcess;
-    done: Promise<SpawnHelperResult>;
-};