shennian 0.3.85 → 0.3.86

package/dist/src/agents/gemini.js

@@ -1 +1,180 @@
-import{createInterface as l}from"node:readline";import{randomUUID as u}from"node:crypto";import{AgentAdapter as d,registerAgent as h}from"./adapter.js";import{resolveBuiltinCommand as c,spawnResolvedCommand as p}from"./command-spec.js";import{buildAgentProcessEnv as f}from"../agent-env.js";import{buildInlineChannelPreamble as g}from"./platform-instructions.js";function r(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function k(t){if(!t)return;const e=r(t.input_tokens)??r(t.prompt_tokens)??r(t.inputTokens)??r(t.promptTokenCount),n=r(t.output_tokens)??r(t.completion_tokens)??r(t.outputTokens)??r(t.candidatesTokenCount)??r(t.responseTokenCount);if(!(e===void 0&&n===void 0))return{inputTokens:e??0,outputTokens:n??0}}class I extends d{type="gemini";process=null;agentSessionId=null;workDir=null;seq=0;runId="";externalChannel=null;shennianSessionId=null;extraEnv={};configure(e){this.shennianSessionId=e.sessionId??null,this.externalChannel=e.externalChannel??null,this.extraEnv=e.env??{}}async start(e,n,i){this.workDir=n,this.seq=0,i&&(this.agentSessionId=i)}async send(e,n,i,m,a){await this.killProcess(),this.runId=u(),this.seq=0;const o=["-p",`${g(this.workDir??process.cwd(),this.externalChannel,this.shennianSessionId??void 0,a)}${e}`,"--output-format","stream-json"];n&&o.push("-m",n),this.agentSessionId&&o.push("--resume",this.agentSessionId),this.spawnAndParse(o)}async resume(e){await this.killProcess(),this.agentSessionId=e,this.runId=u(),this.seq=0,this.spawnAndParse(["--resume",e,"--output-format","stream-json"])}async stop(){await this.killProcess()}spawnAndParse(e){const n=c("gemini");if(!n){this.emit("error",new Error('Command "gemini" not found. Is Gemini CLI installed?'));return}const i=p(n,e,{cwd:this.workDir??void 0,stdio:["ignore","pipe","pipe"],env:f(this.extraEnv)});this.process=i,l({input:i.stdout}).on("line",s=>{if(s.trim())try{const o=JSON.parse(s);this.handleStreamEvent(o)}catch{this.emitEvent({state:"delta",text:s})}});let a="";i.stderr?.on("data",s=>{a+=s.toString()}),i.on("close",s=>{if(this.process===i&&(this.process=null,s!==0&&s!==null)){const o=a.trim()||`gemini exited with code ${s}`;this.emitEvent({state:"error",message:o})}}),i.on("error",s=>{this.process===i&&(this.process=null,s.code==="ENOENT"?this.emit("error",new Error('Command "gemini" not found. Is Gemini CLI installed?')):this.emit("error",s))})}handleStreamEvent(e){switch(e.type){case"init":{e.session_id&&(this.agentSessionId=e.session_id);break}case"message":{e.role==="assistant"&&e.content&&this.emitEvent({state:"delta",text:e.content});break}case"result":{if(e.status==="success")this.emitEvent({state:"final",agentSessionId:this.agentSessionId??void 0,usage:k(e.stats)});else if(e.status==="error"){const n=typeof e.error=="string"&&e.error||typeof e.message=="string"&&e.message||"gemini result error";this.emitEvent({state:"error",message:n})}break}default:break}}emitEvent(e){const n={...e,runId:this.runId,seq:this.seq++};this.emit("agentEvent",n)}async killProcess(){const e=this.process;e&&(this.process=null,e.kill("SIGTERM"),await new Promise(n=>{e.on("close",n),setTimeout(()=>{e.kill("SIGKILL"),n()},3e3)}))}}h("gemini",()=>new I);export{I as GeminiAdapter};
+import { createInterface } from 'node:readline';
+import { randomUUID } from 'node:crypto';
+import { AgentAdapter, registerAgent } from './adapter.js';
+import { resolveBuiltinCommand, spawnResolvedCommand } from './command-spec.js';
+import { buildAgentProcessEnv } from '../agent-env.js';
+import { buildInlineChannelPreamble } from './platform-instructions.js';
+function num(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : undefined;
+}
+function usageFromStats(stats) {
+    if (!stats)
+        return undefined;
+    const input = num(stats.input_tokens) ??
+        num(stats.prompt_tokens) ??
+        num(stats.inputTokens) ??
+        num(stats.promptTokenCount);
+    const output = num(stats.output_tokens) ??
+        num(stats.completion_tokens) ??
+        num(stats.outputTokens) ??
+        num(stats.candidatesTokenCount) ??
+        num(stats.responseTokenCount);
+    if (input === undefined && output === undefined)
+        return undefined;
+    return {
+        inputTokens: input ?? 0,
+        outputTokens: output ?? 0,
+    };
+}
+export class GeminiAdapter extends AgentAdapter {
+    type = 'gemini';
+    process = null;
+    agentSessionId = null;
+    workDir = null;
+    seq = 0;
+    runId = '';
+    externalChannel = null;
+    shennianSessionId = null;
+    extraEnv = {};
+    configure(options) {
+        this.shennianSessionId = options.sessionId ?? null;
+        this.externalChannel = options.externalChannel ?? null;
+        this.extraEnv = options.env ?? {};
+    }
+    async start(_sessionId, workDir, agentSessionId) {
+        this.workDir = workDir;
+        this.seq = 0;
+        if (agentSessionId)
+            this.agentSessionId = agentSessionId;
+    }
+    async send(text, modelId, _reasoningEffort, _attachments, agentSystemPrompt) {
+        await this.killProcess();
+        this.runId = randomUUID();
+        this.seq = 0;
+        const outgoing = `${buildInlineChannelPreamble(this.workDir ?? process.cwd(), this.externalChannel, this.shennianSessionId ?? undefined, agentSystemPrompt)}${text}`;
+        const args = ['-p', outgoing, '--output-format', 'stream-json'];
+        if (modelId) {
+            args.push('-m', modelId);
+        }
+        if (this.agentSessionId) {
+            args.push('--resume', this.agentSessionId);
+        }
+        this.spawnAndParse(args);
+    }
+    async resume(agentSessionId) {
+        await this.killProcess();
+        this.agentSessionId = agentSessionId;
+        this.runId = randomUUID();
+        this.seq = 0;
+        this.spawnAndParse(['--resume', agentSessionId, '--output-format', 'stream-json']);
+    }
+    async stop() {
+        await this.killProcess();
+    }
+    spawnAndParse(args) {
+        const spec = resolveBuiltinCommand('gemini');
+        if (!spec) {
+            this.emit('error', new Error('Command "gemini" not found. Is Gemini CLI installed?'));
+            return;
+        }
+        const proc = spawnResolvedCommand(spec, args, {
+            cwd: this.workDir ?? undefined,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: buildAgentProcessEnv(this.extraEnv),
+        });
+        this.process = proc;
+        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;
+            if (code !== 0 && code !== null) {
+                const msg = stderrBuf.trim() || `gemini exited with code ${code}`;
+                this.emitEvent({ state: 'error', message: msg });
+            }
+        });
+        proc.on('error', (err) => {
+            if (this.process !== proc)
+                return;
+            this.process = null;
+            if (err.code === 'ENOENT') {
+                this.emit('error', new Error('Command "gemini" not found. Is Gemini CLI installed?'));
+            }
+            else {
+                this.emit('error', err);
+            }
+        });
+    }
+    handleStreamEvent(obj) {
+        switch (obj.type) {
+            case 'init': {
+                if (obj.session_id) {
+                    this.agentSessionId = obj.session_id;
+                }
+                break;
+            }
+            case 'message': {
+                if (obj.role === 'assistant' && obj.content) {
+                    this.emitEvent({ state: 'delta', text: obj.content });
+                }
+                break;
+            }
+            case 'result': {
+                if (obj.status === 'success') {
+                    this.emitEvent({
+                        state: 'final',
+                        agentSessionId: this.agentSessionId ?? undefined,
+                        usage: usageFromStats(obj.stats),
+                    });
+                }
+                else if (obj.status === 'error') {
+                    const msg = (typeof obj.error === 'string' && obj.error) ||
+                        (typeof obj.message === 'string' && obj.message) ||
+                        'gemini result error';
+                    this.emitEvent({ state: 'error', message: msg });
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    emitEvent(partial) {
+        const event = {
+            ...partial,
+            runId: this.runId,
+            seq: this.seq++,
+        };
+        this.emit('agentEvent', event);
+    }
+    async killProcess() {
+        const proc = this.process;
+        if (!proc)
+            return;
+        this.process = null;
+        proc.kill('SIGTERM');
+        await new Promise((resolve) => {
+            proc.on('close', resolve);
+            setTimeout(() => {
+                proc.kill('SIGKILL');
+                resolve();
+            }, 3000);
+        });
+    }
+}
+registerAgent('gemini', () => new GeminiAdapter());

package/dist/src/agents/manager.d.ts

@@ -1,6 +1,7 @@
 import type { AgentSendContext, AgentSendResult } from './adapter.js';
 import { AgentAdapter } from './adapter.js';
 import type { ChatAttachmentMeta, ExternalChannelSessionStatus } from '@shennian/wire';
+import type { CompiledManagedAgentPolicy } from '../security/managed-agent-policy.js';
 type ManagerModelId = 'codex' | 'claude';
 /** Decorates a real provider Adapter with Manager session capabilities. New
  * sessions use this class and keep their real agentType/modelId. */
@@ -17,6 +18,7 @@ export declare class ManagerModeAdapter extends AgentAdapter {
         sessionId?: string;
         externalChannel?: ExternalChannelSessionStatus | null;
         env?: NodeJS.ProcessEnv;
+        managedAgentPolicy?: CompiledManagedAgentPolicy | null;
     }): void;
     start(sessionId: string, workDir: string, agentSessionId?: string | null): Promise<void>;
     send(text: string, modelId?: string, reasoningEffort?: string, attachments?: ChatAttachmentMeta[], agentSystemPrompt?: string | null, context?: AgentSendContext): Promise<void | AgentSendResult>;

package/dist/src/agents/manager.js

@@ -1,18 +1,250 @@
-import{AgentAdapter as g,registerAgent as I}from"./adapter.js";import{CodexAdapter as p}from"./codex.js";import{ClaudeAdapter as f}from"./claude.js";import{MANAGER_SYSTEM_PROMPT as y,buildManagerPrompt as l}from"../manager/prompt.js";import{getManagerRuntimeService as o}from"../manager/runtime.js";import d from"node:fs";import c from"node:path";import{PLATFORM_OUTPUT_INSTRUCTIONS as S}from"./platform-instructions.js";function w(i){return i==="claude"?"claude":"codex"}function M(i){return i.replace(/[^a-zA-Z0-9_.-]/g,"_")}function v(i){const e=c.join(i,"AGENTS.md");try{return d.readFileSync(e,"utf8").trim()}catch{return""}}function k(i,e){return c.join(i,".shennian","runtime","manager",M(e),"instructions.md")}function h(i,e){const n=v(i),t=o(),r=t?.getManagerExternalChannelSystemPrompt(e)??"",s=typeof t?.getManagerWorkerDefaults=="function"?t.getManagerWorkerDefaults(e):void 0,a=s?.agentType?`\u9ED8\u8BA4 worker Agent\uFF1A${s.agentType}${s.modelId?`
-\u9ED8\u8BA4 worker \u6A21\u578B\uFF1A${s.modelId}`:""}\u3002\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u6216\u4EFB\u52A1\u660E\u663E\u9700\u8981\u5176\u4ED6 Agent/\u6A21\u578B\uFF0C\u521B\u5EFA worker \u65F6\u4F18\u5148\u4F7F\u7528\u8FD9\u4E2A\u9ED8\u8BA4\u7EC4\u5408\u3002`:"";return`${["# Shennian Manager Instructions","This file is generated by Shennian for a Manager Agent substrate session. Do not edit it by hand.",n?`## Project Instructions
-
-${n}`:"",`## Manager Instructions
-
-${y}`,a?`## Worker Defaults
-
-${a}`:"",r?`## External Message Channel Instructions
-
-${r}`:"",S].filter(Boolean).join(`
-
-`)}
-`}function E(i,e){const n=k(i,e),t=h(i,e);d.mkdirSync(c.dirname(n),{recursive:!0});try{if(d.readFileSync(n,"utf8")===t)return n}catch{}return d.writeFileSync(n,t),n}class R extends g{inner;substrate;type;sessionId="";workDir="";agentSessionId=null;configured={};constructor(e,n){super(),this.inner=e,this.substrate=n,this.type=e.type,e.on("agentEvent",t=>{t.agentSessionId&&(this.agentSessionId=t.agentSessionId),this.emit("agentEvent",{...t,source:t.source??n})}),e.on("error",t=>this.emit("error",t))}configure(e){this.configured=e,this.applyEnvironment()}async start(e,n,t){this.sessionId=e,this.workDir=n,this.agentSessionId=t??null,this.applyEnvironment(),await this.inner.start(e,n,t),o()?.registerManager({sessionId:e,agentSessionId:this.agentSessionId,workDir:n,modelId:this.substrate,agentType:this.type==="claude"?"claude":"codex",status:"idle"}),o()?.bindManagerAdapterEvents(e,this.inner)}async send(e,n,t,r,s,a){o()?.registerManager({sessionId:this.sessionId,agentSessionId:this.agentSessionId,workDir:this.workDir,modelId:this.substrate,agentType:this.type==="claude"?"claude":"codex",providerModelId:n??null,status:"running"}),await o()?.ready(),this.applyEnvironment();const u=h(this.workDir,this.sessionId),m=A(u,s);return this.inner.send(l(e),n,t,r,m,a)}async resume(e){this.agentSessionId=e,await this.inner.resume(e)}async stop(){await this.inner.stop()}getStatus(){return this.inner.getStatus?.()??Promise.resolve({active:!1})}setTitle(e,n,t){return this.inner.setTitle?.(e,n,t)??Promise.resolve()}applyEnvironment(){const e=this.sessionId?o()?.getInjectedEnv(this.sessionId,this.agentSessionId,this.workDir,this.substrate)??{}:{};this.inner.configure?.({...this.configured,sessionId:this.configured.sessionId??this.sessionId,env:{...this.configured.env??{},...e}})}}function A(i,e){const n=e?.trim()??"";if(!n)return i;const r=["[\u667A\u80FD\u4F53\u79C1\u6709\u7CFB\u7EDF\u63D0\u793A\u8BCD]","[\u667A\u80FD\u4F53\u8EAB\u4EFD]"].map(s=>n.indexOf(s)).filter(s=>s>=0).sort((s,a)=>s-a)[0]??-1;return n.startsWith("[\u795E\u5FF5\u53D7\u7BA1\u4F1A\u8BDD\u89C4\u5219]")&&r>=0?`${n.slice(0,r)}[\u4F1A\u8BDD\u6A21\u5F0F]
-${i.trim()}
-
-${n.slice(r)}`:`${i.trim()}
-
-${n}`}class b extends g{type="manager";inner=null;sessionId="";workDir="";agentSessionId=null;modelId="codex";async start(e,n,t){this.sessionId=e,this.workDir=n,this.agentSessionId=t??null,o()?.registerManager({sessionId:e,agentSessionId:this.agentSessionId,workDir:n,modelId:this.modelId,agentType:"manager",status:"idle"})}async send(e,n){const t=w(n);if(!this.inner||t!==this.modelId){await this.inner?.stop().catch(()=>{}),this.inner?.removeAllListeners(),this.modelId=t;const r=E(this.workDir,this.sessionId),s=h(this.workDir,this.sessionId);this.inner=t==="claude"?new f({systemPrompt:s,hidden:!0}):new p({modelInstructionsFile:r,hidden:!0}),this.bindInner(this.inner),await this.inner.start(this.sessionId,this.workDir,this.agentSessionId),o()?.bindManagerAdapterEvents(this.sessionId,this.inner)}o()?.registerManager({sessionId:this.sessionId,agentSessionId:this.agentSessionId,workDir:this.workDir,modelId:this.modelId,agentType:"manager",status:"running"}),await o()?.ready(),await this.withManagerEnv(()=>this.inner.send(l(e)))}async resume(e){this.agentSessionId=e,this.inner&&await this.inner.resume(e)}async stop(){await this.inner?.stop()}bindInner(e){e.on("agentEvent",n=>{n.agentSessionId&&(this.agentSessionId=n.agentSessionId),this.emit("agentEvent",this.wrapEvent(n))}),e.on("error",n=>this.emit("error",n))}wrapEvent(e){return{...e,source:e.source??this.modelId,agentSessionId:e.agentSessionId??this.agentSessionId??void 0}}async withManagerEnv(e){const n=o()?.getInjectedEnv(this.sessionId,this.agentSessionId,this.workDir,this.modelId)??{},t=new Map;for(const[r,s]of Object.entries(n))t.set(r,process.env[r]),process.env[r]=s;try{return await e()}finally{for(const[r,s]of t)s===void 0?delete process.env[r]:process.env[r]=s}}}I("manager",()=>new b);export{b as ManagerAdapter,R as ManagerModeAdapter,A as combineManagerInstructions};
+// @arch docs/features/manager-agent.md
+// @test src/__tests__/manager-adapter.test.ts
+import { AgentAdapter, registerAgent } from './adapter.js';
+import { CodexAdapter } from './codex.js';
+import { ClaudeAdapter } from './claude.js';
+import { MANAGER_SYSTEM_PROMPT, buildManagerPrompt } from '../manager/prompt.js';
+import { getManagerRuntimeService } from '../manager/runtime.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import { PLATFORM_OUTPUT_INSTRUCTIONS } from './platform-instructions.js';
+function normalizeManagerModel(modelId) {
+    return modelId === 'claude' ? 'claude' : 'codex';
+}
+function safeSessionDirName(sessionId) {
+    return sessionId.replace(/[^a-zA-Z0-9_.-]/g, '_');
+}
+function readProjectAgentsMd(workDir) {
+    const agentsPath = path.join(workDir, 'AGENTS.md');
+    try {
+        return fs.readFileSync(agentsPath, 'utf8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+function managerInstructionsPath(workDir, sessionId) {
+    return path.join(workDir, '.shennian', 'runtime', 'manager', safeSessionDirName(sessionId), 'instructions.md');
+}
+function buildStableManagerInstructions(workDir, managerSessionId) {
+    const projectInstructions = readProjectAgentsMd(workDir);
+    const managerRuntime = getManagerRuntimeService();
+    const channelInstructions = managerRuntime?.getManagerExternalChannelSystemPrompt(managerSessionId) ?? '';
+    const workerDefaults = typeof managerRuntime?.getManagerWorkerDefaults === 'function'
+        ? managerRuntime.getManagerWorkerDefaults(managerSessionId)
+        : undefined;
+    const workerDefaultInstructions = workerDefaults?.agentType
+        ? `默认 worker Agent：${workerDefaults.agentType}${workerDefaults.modelId ? `\n默认 worker 模型：${workerDefaults.modelId}` : ''}。除非用户明确要求或任务明显需要其他 Agent/模型，创建 worker 时优先使用这个默认组合。`
+        : '';
+    const sections = [
+        '# Shennian Manager Instructions',
+        'This file is generated by Shennian for a Manager Agent substrate session. Do not edit it by hand.',
+        projectInstructions
+            ? `## Project Instructions\n\n${projectInstructions}`
+            : '',
+        `## Manager Instructions\n\n${MANAGER_SYSTEM_PROMPT}`,
+        workerDefaultInstructions
+            ? `## Worker Defaults\n\n${workerDefaultInstructions}`
+            : '',
+        channelInstructions
+            ? `## External Message Channel Instructions\n\n${channelInstructions}`
+            : '',
+        PLATFORM_OUTPUT_INSTRUCTIONS,
+    ].filter(Boolean);
+    return `${sections.join('\n\n')}\n`;
+}
+function ensureManagerInstructionsFile(workDir, sessionId) {
+    const filePath = managerInstructionsPath(workDir, sessionId);
+    const content = buildStableManagerInstructions(workDir, sessionId);
+    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;
+}
+/** Decorates a real provider Adapter with Manager session capabilities. New
+ * sessions use this class and keep their real agentType/modelId. */
+export class ManagerModeAdapter extends AgentAdapter {
+    inner;
+    substrate;
+    type;
+    sessionId = '';
+    workDir = '';
+    agentSessionId = null;
+    configured = {};
+    constructor(inner, substrate) {
+        super();
+        this.inner = inner;
+        this.substrate = substrate;
+        this.type = inner.type;
+        inner.on('agentEvent', (event) => {
+            if (event.agentSessionId)
+                this.agentSessionId = event.agentSessionId;
+            this.emit('agentEvent', { ...event, source: event.source ?? substrate });
+        });
+        inner.on('error', (error) => this.emit('error', error));
+    }
+    configure(options) {
+        this.configured = options;
+        if (options.sessionId) {
+            getManagerRuntimeService()?.setManagedAgentPolicy(options.sessionId, options.managedAgentPolicy ?? null);
+        }
+        this.applyEnvironment();
+    }
+    async start(sessionId, workDir, agentSessionId) {
+        this.sessionId = sessionId;
+        this.workDir = workDir;
+        this.agentSessionId = agentSessionId ?? null;
+        this.applyEnvironment();
+        await this.inner.start(sessionId, workDir, agentSessionId);
+        getManagerRuntimeService()?.registerManager({
+            sessionId, agentSessionId: this.agentSessionId, workDir, modelId: this.substrate,
+            agentType: this.type === 'claude' ? 'claude' : 'codex', status: 'idle',
+        });
+        getManagerRuntimeService()?.bindManagerAdapterEvents(sessionId, this.inner);
+    }
+    async send(text, modelId, reasoningEffort, attachments, agentSystemPrompt, context) {
+        getManagerRuntimeService()?.registerManager({
+            sessionId: this.sessionId, agentSessionId: this.agentSessionId, workDir: this.workDir,
+            modelId: this.substrate, agentType: this.type === 'claude' ? 'claude' : 'codex',
+            providerModelId: modelId ?? null, status: 'running',
+        });
+        await getManagerRuntimeService()?.ready();
+        this.applyEnvironment();
+        const managerInstructions = buildStableManagerInstructions(this.workDir, this.sessionId);
+        const combined = combineManagerInstructions(managerInstructions, agentSystemPrompt);
+        return this.inner.send(buildManagerPrompt(text), modelId, reasoningEffort, attachments, combined, context);
+    }
+    async resume(agentSessionId) {
+        this.agentSessionId = agentSessionId;
+        await this.inner.resume(agentSessionId);
+    }
+    async stop() {
+        getManagerRuntimeService()?.setManagedAgentPolicy(this.sessionId, null);
+        await this.inner.stop();
+    }
+    getStatus() { return this.inner.getStatus?.() ?? Promise.resolve({ active: false }); }
+    setTitle(agentSessionId, title, workDir) {
+        return this.inner.setTitle?.(agentSessionId, title, workDir) ?? Promise.resolve();
+    }
+    applyEnvironment() {
+        const managerEnv = this.sessionId
+            ? getManagerRuntimeService()?.getInjectedEnv(this.sessionId, this.agentSessionId, this.workDir, this.substrate) ?? {}
+            : {};
+        this.inner.configure?.({
+            ...this.configured,
+            sessionId: this.configured.sessionId ?? this.sessionId,
+            env: { ...(this.configured.env ?? {}), ...managerEnv },
+            managedAgentPolicy: this.configured.managedAgentPolicy ?? null,
+        });
+    }
+}
+export function combineManagerInstructions(managerInstructions, systemPrompt) {
+    const prompt = systemPrompt?.trim() ?? '';
+    if (!prompt)
+        return managerInstructions;
+    const roomMarkers = ['[智能体私有系统提示词]', '[智能体身份]'];
+    const index = roomMarkers
+        .map((marker) => prompt.indexOf(marker))
+        .filter((position) => position >= 0)
+        .sort((a, b) => a - b)[0] ?? -1;
+    if (prompt.startsWith('[神念受管会话规则]') && index >= 0) {
+        return `${prompt.slice(0, index)}[会话模式]\n${managerInstructions.trim()}\n\n${prompt.slice(index)}`;
+    }
+    return `${managerInstructions.trim()}\n\n${prompt}`;
+}
+export class ManagerAdapter extends AgentAdapter {
+    type = 'manager';
+    inner = null;
+    sessionId = '';
+    workDir = '';
+    agentSessionId = null;
+    modelId = 'codex';
+    async start(sessionId, workDir, agentSessionId) {
+        this.sessionId = sessionId;
+        this.workDir = workDir;
+        this.agentSessionId = agentSessionId ?? null;
+        getManagerRuntimeService()?.registerManager({
+            sessionId,
+            agentSessionId: this.agentSessionId,
+            workDir,
+            modelId: this.modelId,
+            agentType: 'manager',
+            status: 'idle',
+        });
+    }
+    async send(text, modelId) {
+        const nextModel = normalizeManagerModel(modelId);
+        if (!this.inner || nextModel !== this.modelId) {
+            await this.inner?.stop().catch(() => { });
+            this.inner?.removeAllListeners();
+            this.modelId = nextModel;
+            const instructionsFile = ensureManagerInstructionsFile(this.workDir, this.sessionId);
+            const systemPrompt = buildStableManagerInstructions(this.workDir, this.sessionId);
+            this.inner = nextModel === 'claude'
+                ? new ClaudeAdapter({ systemPrompt, hidden: true })
+                : new CodexAdapter({ modelInstructionsFile: instructionsFile, hidden: true });
+            this.bindInner(this.inner);
+            await this.inner.start(this.sessionId, this.workDir, this.agentSessionId);
+            getManagerRuntimeService()?.bindManagerAdapterEvents(this.sessionId, this.inner);
+        }
+        getManagerRuntimeService()?.registerManager({
+            sessionId: this.sessionId,
+            agentSessionId: this.agentSessionId,
+            workDir: this.workDir,
+            modelId: this.modelId,
+            agentType: 'manager',
+            status: 'running',
+        });
+        await getManagerRuntimeService()?.ready();
+        await this.withManagerEnv(() => this.inner.send(buildManagerPrompt(text)));
+    }
+    async resume(agentSessionId) {
+        this.agentSessionId = agentSessionId;
+        if (this.inner)
+            await this.inner.resume(agentSessionId);
+    }
+    async stop() {
+        await this.inner?.stop();
+    }
+    bindInner(inner) {
+        inner.on('agentEvent', (event) => {
+            if (event.agentSessionId)
+                this.agentSessionId = event.agentSessionId;
+            this.emit('agentEvent', this.wrapEvent(event));
+        });
+        inner.on('error', (error) => this.emit('error', error));
+    }
+    wrapEvent(event) {
+        return {
+            ...event,
+            source: event.source ?? this.modelId,
+            agentSessionId: event.agentSessionId ?? this.agentSessionId ?? undefined,
+        };
+    }
+    async withManagerEnv(work) {
+        const env = getManagerRuntimeService()?.getInjectedEnv(this.sessionId, this.agentSessionId, this.workDir, this.modelId) ?? {};
+        const previous = new Map();
+        for (const [key, value] of Object.entries(env)) {
+            previous.set(key, process.env[key]);
+            process.env[key] = value;
+        }
+        try {
+            return await work();
+        }
+        finally {
+            for (const [key, value] of previous) {
+                if (value === undefined)
+                    delete process.env[key];
+                else
+                    process.env[key] = value;
+            }
+        }
+    }
+}
+registerAgent('manager', () => new ManagerAdapter());

package/dist/src/agents/model-registry/cache.js

@@ -1 +1,37 @@
-import e from"node:fs";import o from"node:path";import{CACHE_TTL_MS as s,CACHE_VERSION as n,MODEL_CACHE_PATH as t}from"./types.js";function a(){e.mkdirSync(o.dirname(t),{recursive:!0})}function p(){try{const r=JSON.parse(e.readFileSync(t,"utf-8"));if(r.version===n&&r.agents&&typeof r.agents=="object")return r}catch{}return{version:n,agents:{}}}function C(r){try{a(),e.writeFileSync(t,JSON.stringify(r,null,2))}catch{}}function h(r,i){return!r||r.version!==i?!1:Date.now()-r.refreshedAt<s}export{h as isCacheFresh,p as readCache,C as writeCache};
+// @arch docs/architecture/cli/model-discovery.md
+// @test src/__tests__/model-switching.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { CACHE_TTL_MS, CACHE_VERSION, MODEL_CACHE_PATH } from './types.js';
+function ensureDirExists() {
+    fs.mkdirSync(path.dirname(MODEL_CACHE_PATH), { recursive: true });
+}
+export function readCache() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(MODEL_CACHE_PATH, 'utf-8'));
+        if (parsed.version === CACHE_VERSION && parsed.agents && typeof parsed.agents === 'object') {
+            return parsed;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return { version: CACHE_VERSION, agents: {} };
+}
+export function writeCache(cache) {
+    try {
+        ensureDirExists();
+        fs.writeFileSync(MODEL_CACHE_PATH, JSON.stringify(cache, null, 2));
+    }
+    catch {
+        // Cache is best-effort. Discovery should still succeed when local
+        // filesystem writes are unavailable (e.g. restricted sandboxes).
+    }
+}
+export function isCacheFresh(entry, version) {
+    if (!entry)
+        return false;
+    if (entry.version !== version)
+        return false;
+    return Date.now() - entry.refreshedAt < CACHE_TTL_MS;
+}