shennian 0.3.85 → 0.3.86

package/dist/src/agents/opencode.js

@@ -1 +1,298 @@
-import{createInterface as h}from"node:readline";import{randomUUID as l}from"node:crypto";import{AgentAdapter as p,registerAgent as f}from"./adapter.js";import{resolveBuiltinCommand as u,spawnAgentCommand as m}from"./command-spec.js";import{buildAgentProcessEnv as E,buildManagedAgentProcessEnv as C}from"../agent-env.js";import{buildInlineChannelPreamble as I}from"./platform-instructions.js";import{resolveManagedAgentAdapterEnforcement as y}from"../security/managed-agent-policy.js";import{registerManagedAgentRuntimeSecurity as D}from"../security/managed-agent-runtime.js";import{compileOpenCodeManagedPermissions as O,createOpenCodeManagedConfigDirectory as S,disposeOpenCodeManagedConfigDirectory as w,OPENCODE_MANAGED_RUNTIME_SECURITY as P}from"./opencode-managed-permissions.js";D("opencode",P);function _(i){if(!i)return;const t=i.input,e=i.output;if(!(typeof t!="number"&&typeof e!="number"))return{inputTokens:typeof t=="number"?t:0,outputTokens:typeof e=="number"?e:0}}function c(i){if(i==null)return"";if(typeof i=="string")return i;try{return JSON.stringify(i)}catch{return String(i)}}function g(i){if(!i)return"opencode request failed";if(typeof i=="string")return i;if(typeof i!="object")return String(i);const t=i;return typeof t.message=="string"?t.message:typeof t.name=="string"?t.name:"data"in t?g(t.data):c(i)||"opencode request failed"}class A extends p{type="opencode";process=null;agentSessionId=null;workDir=null;seq=0;runId="";terminalState="closed";externalChannel=null;shennianSessionId=null;extraEnv={};managedAgentPolicy=null;managedConfigDir=null;configure(t){this.shennianSessionId=t.sessionId??null,this.externalChannel=t.externalChannel??null,this.extraEnv=t.env??{},"managedAgentPolicy"in t&&(this.managedAgentPolicy=t.managedAgentPolicy??null),this.managedAgentPolicy&&(this.workDir=this.managedAgentPolicy.adapterPolicy.workDir)}async start(t,e,r){this.workDir=this.managedAgentPolicy?.adapterPolicy.workDir??e,r&&(this.agentSessionId=r),this.resetRunState()}async send(t,e,r,s,d,a){if(a?.source==="room_activation"&&!this.managedAgentPolicy)throw new Error("managed_agent_policy_missing");await this.killProcess(),this.runId=l(),this.resetRunState();const n=["run","--format","json","--dir",this.workDir??process.cwd()];this.agentSessionId&&n.push("--session",this.agentSessionId),e&&n.push("--model",e);const o=`${I(this.workDir??process.cwd(),this.externalChannel,this.shennianSessionId??void 0,d)}${t}`;n.push(o),await this.spawnAndParse(n)}async resume(t){await this.killProcess(),this.agentSessionId=t,this.runId=l(),this.resetRunState(),this.emitEvent({state:"start",agentSessionId:t}),this.emitFinalIfOpen({state:"final",agentSessionId:t})}async stop(){await this.killProcess()}resetRunState(){this.seq=0,this.terminalState="open"}async spawnAndParse(t){const e=u("opencode");if(!e){this.emit("error",new Error('Command "opencode" not found. Install it with "npm i -g opencode-ai@latest".'));return}const r=await this.prepareManagedLaunch();let s;try{s=m(e,[t[0],...r.args,...t.slice(1)],{cwd:this.workDir??void 0,stdio:["ignore","pipe","pipe"],env:r.env})}catch(n){throw await this.disposeManagedConfig(r.configDir),n}this.process=s,this.managedConfigDir=r.configDir,h({input:s.stdout}).on("line",n=>{if(n.trim())try{const o=JSON.parse(n);this.handleStreamEvent(o)}catch{this.emitEvent({state:"delta",text:n})}});let a="";s.stderr?.on("data",n=>{a+=n.toString()}),s.on("close",n=>{if(this.process!==s||(this.process=null,this.disposeManagedConfig(r.configDir),this.terminalState!=="open"))return;const o=a.trim();if(n!==0&&n!==null){this.emitErrorIfOpen({state:"error",message:o||`opencode exited with code ${n}`});return}this.emitFinalIfOpen({state:"final",agentSessionId:this.agentSessionId??void 0})}),s.on("error",n=>{this.process===s&&(this.process=null,this.disposeManagedConfig(r.configDir),n.code==="ENOENT"?this.emit("error",new Error('Command "opencode" not found. Install it with "npm i -g opencode-ai@latest".')):this.emit("error",n))})}async prepareManagedLaunch(){const t=this.managedAgentPolicy;if(!t)return{args:["--auto"],env:E({NO_COLOR:"1",...this.extraEnv}),configDir:null};const e=O(y(t),t.adapterPolicy.workDir),r=await S(e),s=C({agentType:"opencode",providerEnv:this.extraEnv,sessionEnv:this.extraEnv,runtimeEnv:{NO_COLOR:"1"}});return s.OPENCODE_CONFIG=r.configPath,s.OPENCODE_CONFIG_DIR=r.directory,s.OPENCODE_CONFIG_CONTENT=JSON.stringify(e.config),s.OPENCODE_DISABLE_PROJECT_CONFIG="true",s.OPENCODE_DISABLE_CLAUDE_CODE="1",s.OPENCODE_DISABLE_CLAUDE_CODE_PROMPT="1",s.OPENCODE_DISABLE_CLAUDE_CODE_SKILLS="1",{args:e.args,env:s,configDir:r.directory}}async disposeManagedConfig(t){t&&(this.managedConfigDir===t&&(this.managedConfigDir=null),await w(t).catch(()=>{}))}handleStreamEvent(t){t.sessionID&&t.sessionID!==this.agentSessionId&&(this.agentSessionId=t.sessionID,this.emitEvent({state:"start",agentSessionId:t.sessionID}));const e=t.part;if(t.type==="text"&&e?.text){this.emitEvent({state:"delta",text:e.text});return}if(t.type==="reasoning"&&e?.text){this.emitEvent({state:"delta",text:e.text,thinking:!0});return}if(t.type==="tool_use"&&e?.type==="tool"){e.state?.status==="completed"||e.state?.status==="error"?this.emitEvent({state:"tool-result",name:e.tool??"tool",result:e.state.status==="error"?e.state.error??"tool failed":c(e.state?.output)}):this.emitEvent({state:"tool-call",name:e.tool??"tool",args:e.state?.input??{}});return}if(t.type==="error"){this.emitErrorIfOpen({state:"error",message:g(t.error)});return}t.type==="step_finish"&&this.emitFinalIfOpen({state:"final",agentSessionId:this.agentSessionId??t.sessionID,usage:_(e?.tokens)})}emitEvent(t){const e={...t,runId:this.runId,seq:this.seq++};this.emit("agentEvent",e)}emitFinalIfOpen(t){this.terminalState==="open"&&(this.terminalState="closed",this.emitEvent(t))}emitErrorIfOpen(t){this.terminalState==="open"&&(this.terminalState="closed",this.emitEvent(t))}async killProcess(){const t=this.process;if(!t){await this.disposeManagedConfig(this.managedConfigDir);return}this.process=null,t.kill("SIGTERM"),await new Promise(e=>{t.on("close",e),setTimeout(()=>{t.kill("SIGKILL"),e()},3e3)}),await this.disposeManagedConfig(this.managedConfigDir)}}f("opencode",()=>new A);export{A as OpenCodeAdapter};
+// @arch docs/architecture/cli/agent-adapters.md
+// @test src/__tests__/opencode-adapter.test.ts
+import { createInterface } from 'node:readline';
+import { randomUUID } from 'node:crypto';
+import { AgentAdapter, registerAgent } from './adapter.js';
+import { resolveBuiltinCommand, spawnAgentCommand } from './command-spec.js';
+import { buildAgentProcessEnv, buildManagedAgentProcessEnv } from '../agent-env.js';
+import { buildInlineChannelPreamble } from './platform-instructions.js';
+import { resolveManagedAgentAdapterEnforcement, } from '../security/managed-agent-policy.js';
+import { registerManagedAgentRuntimeSecurity } from '../security/managed-agent-runtime.js';
+import { compileOpenCodeManagedPermissions, createOpenCodeManagedConfigDirectory, disposeOpenCodeManagedConfigDirectory, OPENCODE_MANAGED_RUNTIME_SECURITY, } from './opencode-managed-permissions.js';
+registerManagedAgentRuntimeSecurity('opencode', OPENCODE_MANAGED_RUNTIME_SECURITY);
+function usageFromTokens(tokens) {
+    if (!tokens)
+        return undefined;
+    const input = tokens.input;
+    const output = tokens.output;
+    if (typeof input !== 'number' && typeof output !== 'number')
+        return undefined;
+    return {
+        inputTokens: typeof input === 'number' ? input : 0,
+        outputTokens: typeof output === 'number' ? output : 0,
+    };
+}
+function stringifyResult(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function extractErrorMessage(value) {
+    if (!value)
+        return 'opencode request failed';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value !== 'object')
+        return String(value);
+    const record = value;
+    if (typeof record.message === 'string')
+        return record.message;
+    if (typeof record.name === 'string')
+        return record.name;
+    if ('data' in record)
+        return extractErrorMessage(record.data);
+    return stringifyResult(value) || 'opencode request failed';
+}
+export class OpenCodeAdapter extends AgentAdapter {
+    type = 'opencode';
+    process = null;
+    agentSessionId = null;
+    workDir = null;
+    seq = 0;
+    runId = '';
+    terminalState = 'closed';
+    externalChannel = null;
+    shennianSessionId = null;
+    extraEnv = {};
+    managedAgentPolicy = null;
+    managedConfigDir = null;
+    configure(options) {
+        this.shennianSessionId = options.sessionId ?? null;
+        this.externalChannel = options.externalChannel ?? null;
+        this.extraEnv = options.env ?? {};
+        if ('managedAgentPolicy' in options) {
+            this.managedAgentPolicy = options.managedAgentPolicy ?? null;
+        }
+        if (this.managedAgentPolicy)
+            this.workDir = this.managedAgentPolicy.adapterPolicy.workDir;
+    }
+    async start(_sessionId, workDir, agentSessionId) {
+        this.workDir = this.managedAgentPolicy?.adapterPolicy.workDir ?? workDir;
+        if (agentSessionId)
+            this.agentSessionId = agentSessionId;
+        this.resetRunState();
+    }
+    async send(text, modelId, _reasoningEffort, _attachments, agentSystemPrompt, context) {
+        if (context?.source === 'room_activation' && !this.managedAgentPolicy) {
+            throw new Error('managed_agent_policy_missing');
+        }
+        await this.killProcess();
+        this.runId = randomUUID();
+        this.resetRunState();
+        const args = ['run', '--format', 'json', '--dir', this.workDir ?? process.cwd()];
+        if (this.agentSessionId) {
+            args.push('--session', this.agentSessionId);
+        }
+        if (modelId) {
+            args.push('--model', modelId);
+        }
+        const outgoing = `${buildInlineChannelPreamble(this.workDir ?? process.cwd(), this.externalChannel, this.shennianSessionId ?? undefined, agentSystemPrompt)}${text}`;
+        args.push(outgoing);
+        await this.spawnAndParse(args);
+    }
+    async resume(agentSessionId) {
+        await this.killProcess();
+        this.agentSessionId = agentSessionId;
+        this.runId = randomUUID();
+        this.resetRunState();
+        this.emitEvent({ state: 'start', agentSessionId });
+        this.emitFinalIfOpen({ state: 'final', agentSessionId });
+    }
+    async stop() {
+        await this.killProcess();
+    }
+    resetRunState() {
+        this.seq = 0;
+        this.terminalState = 'open';
+    }
+    async spawnAndParse(args) {
+        const spec = resolveBuiltinCommand('opencode');
+        if (!spec) {
+            this.emit('error', new Error('Command "opencode" not found. Install it with "npm i -g opencode-ai@latest".'));
+            return;
+        }
+        const managedLaunch = await this.prepareManagedLaunch();
+        let proc;
+        try {
+            proc = spawnAgentCommand(spec, [args[0], ...managedLaunch.args, ...args.slice(1)], {
+                cwd: this.workDir ?? undefined,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: managedLaunch.env,
+            });
+        }
+        catch (error) {
+            await this.disposeManagedConfig(managedLaunch.configDir);
+            throw error;
+        }
+        this.process = proc;
+        this.managedConfigDir = managedLaunch.configDir;
+        const rl = createInterface({ input: proc.stdout });
+        rl.on('line', (line) => {
+            if (!line.trim())
+                return;
+            try {
+                const obj = JSON.parse(line);
+                this.handleStreamEvent(obj);
+            }
+            catch {
+                this.emitEvent({ state: 'delta', text: line });
+            }
+        });
+        let stderrBuf = '';
+        proc.stderr?.on('data', (chunk) => {
+            stderrBuf += chunk.toString();
+        });
+        proc.on('close', (code) => {
+            if (this.process !== proc)
+                return;
+            this.process = null;
+            void this.disposeManagedConfig(managedLaunch.configDir);
+            if (this.terminalState !== 'open')
+                return;
+            const stderr = stderrBuf.trim();
+            if (code !== 0 && code !== null) {
+                this.emitErrorIfOpen({
+                    state: 'error',
+                    message: stderr || `opencode exited with code ${code}`,
+                });
+                return;
+            }
+            this.emitFinalIfOpen({ state: 'final', agentSessionId: this.agentSessionId ?? undefined });
+        });
+        proc.on('error', (err) => {
+            if (this.process !== proc)
+                return;
+            this.process = null;
+            void this.disposeManagedConfig(managedLaunch.configDir);
+            if (err.code === 'ENOENT') {
+                this.emit('error', new Error('Command "opencode" not found. Install it with "npm i -g opencode-ai@latest".'));
+            }
+            else {
+                this.emit('error', err);
+            }
+        });
+    }
+    async prepareManagedLaunch() {
+        const compiled = this.managedAgentPolicy;
+        if (!compiled) {
+            return {
+                args: ['--auto'],
+                env: buildAgentProcessEnv({ NO_COLOR: '1', ...this.extraEnv }),
+                configDir: null,
+            };
+        }
+        const nativeConfig = compileOpenCodeManagedPermissions(resolveManagedAgentAdapterEnforcement(compiled), compiled.adapterPolicy.workDir);
+        const isolated = await createOpenCodeManagedConfigDirectory(nativeConfig);
+        const env = buildManagedAgentProcessEnv({
+            agentType: 'opencode',
+            providerEnv: this.extraEnv,
+            sessionEnv: this.extraEnv,
+            runtimeEnv: { NO_COLOR: '1' },
+        });
+        env.OPENCODE_CONFIG = isolated.configPath;
+        env.OPENCODE_CONFIG_DIR = isolated.directory;
+        env.OPENCODE_CONFIG_CONTENT = JSON.stringify(nativeConfig.config);
+        env.OPENCODE_DISABLE_PROJECT_CONFIG = 'true';
+        env.OPENCODE_DISABLE_CLAUDE_CODE = '1';
+        env.OPENCODE_DISABLE_CLAUDE_CODE_PROMPT = '1';
+        env.OPENCODE_DISABLE_CLAUDE_CODE_SKILLS = '1';
+        return { args: nativeConfig.args, env, configDir: isolated.directory };
+    }
+    async disposeManagedConfig(configDir) {
+        if (!configDir)
+            return;
+        if (this.managedConfigDir === configDir)
+            this.managedConfigDir = null;
+        await disposeOpenCodeManagedConfigDirectory(configDir).catch(() => { });
+    }
+    handleStreamEvent(obj) {
+        if (obj.sessionID && obj.sessionID !== this.agentSessionId) {
+            this.agentSessionId = obj.sessionID;
+            this.emitEvent({ state: 'start', agentSessionId: obj.sessionID });
+        }
+        const part = obj.part;
+        if (obj.type === 'text' && part?.text) {
+            this.emitEvent({ state: 'delta', text: part.text });
+            return;
+        }
+        if (obj.type === 'reasoning' && part?.text) {
+            this.emitEvent({ state: 'delta', text: part.text, thinking: true });
+            return;
+        }
+        if (obj.type === 'tool_use' && part?.type === 'tool') {
+            if (part.state?.status === 'completed' || part.state?.status === 'error') {
+                this.emitEvent({
+                    state: 'tool-result',
+                    name: part.tool ?? 'tool',
+                    result: part.state.status === 'error'
+                        ? (part.state.error ?? 'tool failed')
+                        : stringifyResult(part.state?.output),
+                });
+            }
+            else {
+                this.emitEvent({
+                    state: 'tool-call',
+                    name: part.tool ?? 'tool',
+                    args: part.state?.input ?? {},
+                });
+            }
+            return;
+        }
+        if (obj.type === 'error') {
+            this.emitErrorIfOpen({ state: 'error', message: extractErrorMessage(obj.error) });
+            return;
+        }
+        if (obj.type === 'step_finish') {
+            this.emitFinalIfOpen({
+                state: 'final',
+                agentSessionId: this.agentSessionId ?? obj.sessionID,
+                usage: usageFromTokens(part?.tokens),
+            });
+        }
+    }
+    emitEvent(partial) {
+        const event = {
+            ...partial,
+            runId: this.runId,
+            seq: this.seq++,
+        };
+        this.emit('agentEvent', event);
+    }
+    emitFinalIfOpen(partial) {
+        if (this.terminalState !== 'open')
+            return;
+        this.terminalState = 'closed';
+        this.emitEvent(partial);
+    }
+    emitErrorIfOpen(partial) {
+        if (this.terminalState !== 'open')
+            return;
+        this.terminalState = 'closed';
+        this.emitEvent(partial);
+    }
+    async killProcess() {
+        const proc = this.process;
+        if (!proc) {
+            await this.disposeManagedConfig(this.managedConfigDir);
+            return;
+        }
+        this.process = null;
+        proc.kill('SIGTERM');
+        await new Promise((resolve) => {
+            proc.on('close', resolve);
+            setTimeout(() => {
+                proc.kill('SIGKILL');
+                resolve();
+            }, 3000);
+        });
+        await this.disposeManagedConfig(this.managedConfigDir);
+    }
+}
+registerAgent('opencode', () => new OpenCodeAdapter());

package/dist/src/agents/platform-instructions.js

@@ -1,22 +1,51 @@
-import s from"node:fs";import a from"node:path";import{createHash as c}from"node:crypto";import{resolveShennianPath as u}from"../config/index.js";import{buildExternalChannelInstructions as f}from"./external-channel-instructions.js";const h=`When you mention a local file that the user may want to open, format it as a Markdown link using the exact local path:
+// @arch docs/architecture/cli/agent-adapters.md#平台输出规范
+// @test src/__tests__/platform-instructions.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { resolveShennianPath } from '../config/index.js';
+import { buildExternalChannelInstructions } from './external-channel-instructions.js';
+export const PLATFORM_OUTPUT_INSTRUCTIONS = `When you mention a local file that the user may want to open, format it as a Markdown link using the exact local path:
 
 - Use [filename.ext](</absolute/path/to/filename.ext>) for absolute Unix, macOS, or Windows paths.
 - Use [filename.ext](<relative/path/to/filename.ext>) for paths relative to the current working directory.
 - Do not use file:// URLs for local files.
 - Do not put user-openable file paths only inside code blocks.
-- Keep normal http:// and https:// links unchanged.`;function m(e,o,r,t){return`${[t?.trim()??"",h].filter(Boolean).join(`
-
-`)}
-`}function y(e,o,r,t){const i=f(o,a.resolve(e),r),n=[t?.trim()?`## \u667A\u80FD\u4F53\u63D0\u793A\u8BCD
-
-${t.trim()}`:"",i?`## \u5916\u90E8\u6D88\u606F\u901A\u9053\u8BF4\u660E
-
-${i}`:""].filter(Boolean);return n.length?`# \u795E\u5FF5\u8FD0\u884C\u6307\u4EE4\uFF08\u7CFB\u7EDF\u6307\u4EE4\uFF0C\u975E\u7528\u6237\u8F93\u5165\uFF0C\u8BF7\u9075\u5FAA\u540E\u518D\u56DE\u5E94\u4E0B\u65B9\u7528\u6237\u6D88\u606F\uFF09
-
-${n.join(`
-
-`)}
-
----
-
-`:""}function k(e,o,r,t){const i=c("sha256").update(`${a.resolve(e)}:${r??""}:${JSON.stringify(o??null)}:${t??""}`).digest("hex").slice(0,16),n=u("runtime","agent-instructions",`${i}.md`),l=m(e,o,r,t);s.mkdirSync(a.dirname(n),{recursive:!0});try{if(s.readFileSync(n,"utf8")===l)return n}catch{}return s.writeFileSync(n,l),n}export{h as PLATFORM_OUTPUT_INSTRUCTIONS,y as buildInlineChannelPreamble,m as buildPlatformInstructions,k as ensurePlatformInstructionsFile};
+- Keep normal http:// and https:// links unchanged.`;
+export function buildPlatformInstructions(_workDir, _externalChannel, _sessionId, agentSystemPrompt) {
+    const sections = [
+        agentSystemPrompt?.trim() ?? '',
+        PLATFORM_OUTPUT_INSTRUCTIONS,
+    ].filter(Boolean);
+    return `${sections.join('\n\n')}\n`;
+}
+// 用于没有独立 system-prompt 入口的 adapter（gemini/cursor/opencode/custom/openclaw）：
+// 把外部消息通道说明作为「系统指令」前缀塞进首轮用户消息文本。
+export function buildInlineChannelPreamble(workDir, externalChannel, sessionId, agentSystemPrompt) {
+    const channelInstructions = buildExternalChannelInstructions(externalChannel, path.resolve(workDir), sessionId);
+    const sections = [
+        agentSystemPrompt?.trim() ? `## 智能体提示词\n\n${agentSystemPrompt.trim()}` : '',
+        channelInstructions ? `## 外部消息通道说明\n\n${channelInstructions}` : '',
+    ].filter(Boolean);
+    if (!sections.length)
+        return '';
+    return `# 神念运行指令（系统指令，非用户输入，请遵循后再回应下方用户消息）\n\n${sections.join('\n\n')}\n\n---\n\n`;
+}
+export function ensurePlatformInstructionsFile(workDir, externalChannel, sessionId, agentSystemPrompt) {
+    const key = createHash('sha256')
+        .update(`${path.resolve(workDir)}:${sessionId ?? ''}:${JSON.stringify(externalChannel ?? null)}:${agentSystemPrompt ?? ''}`)
+        .digest('hex')
+        .slice(0, 16);
+    const filePath = resolveShennianPath('runtime', 'agent-instructions', `${key}.md`);
+    const content = buildPlatformInstructions(workDir, externalChannel, sessionId, agentSystemPrompt);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    try {
+        if (fs.readFileSync(filePath, 'utf8') === content)
+            return filePath;
+    }
+    catch {
+        // Write the generated instruction file below.
+    }
+    fs.writeFileSync(filePath, content);
+    return filePath;
+}

package/dist/src/agents/runtime-compatibility.js

@@ -1 +1,44 @@
-import r from"node:fs";import c from"node:os";import s from"node:path";import{getCommandVersion as d}from"./command-spec.js";function m(e){const i=s.join("ChatGPT.app","Contents","Resources","codex");return[s.join("/Applications",i),s.join(e,"Applications",i)]}function a(e){if((e.platform??process.platform)!=="darwin")return;const i=e.exists??r.existsSync,t=e.getVersion??d,n=m(e.homeDir??c.homedir()).find(i);if(n)return t({command:n,args:[],display:"Codex Desktop",kind:"native",path:n})}function l(e,i={}){const t=e.version,n=e.type==="codex"?a(i):void 0;if(!t&&!n)return;const o=t&&n?t===n?"compatible":"version_mismatch":void 0;return{...t?{cliVersion:t}:{},...n?{desktopVersion:n}:{},...o?{compatibility:o}:{},...o==="version_mismatch"?{upgradeAction:"manual"}:{}}}export{l as getAgentRuntimeSummary};
+// @arch docs/features/agent-provider-config.md
+// @test src/__tests__/agent-runtime-compatibility.test.ts
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { getCommandVersion } from './command-spec.js';
+function codexDesktopCandidates(homeDir) {
+    const suffix = path.join('ChatGPT.app', 'Contents', 'Resources', 'codex');
+    return [
+        path.join('/Applications', suffix),
+        path.join(homeDir, 'Applications', suffix),
+    ];
+}
+function detectCodexDesktopVersion(probe) {
+    if ((probe.platform ?? process.platform) !== 'darwin')
+        return undefined;
+    const exists = probe.exists ?? fs.existsSync;
+    const getVersion = probe.getVersion ?? getCommandVersion;
+    const executable = codexDesktopCandidates(probe.homeDir ?? os.homedir()).find(exists);
+    if (!executable)
+        return undefined;
+    return getVersion({
+        command: executable,
+        args: [],
+        display: 'Codex Desktop',
+        kind: 'native',
+        path: executable,
+    });
+}
+export function getAgentRuntimeSummary(agent, probe = {}) {
+    const cliVersion = agent.version;
+    const desktopVersion = agent.type === 'codex' ? detectCodexDesktopVersion(probe) : undefined;
+    if (!cliVersion && !desktopVersion)
+        return undefined;
+    const compatibility = cliVersion && desktopVersion
+        ? cliVersion === desktopVersion ? 'compatible' : 'version_mismatch'
+        : undefined;
+    return {
+        ...(cliVersion ? { cliVersion } : {}),
+        ...(desktopVersion ? { desktopVersion } : {}),
+        ...(compatibility ? { compatibility } : {}),
+        ...(compatibility === 'version_mismatch' ? { upgradeAction: 'manual' } : {}),
+    };
+}