shennian 0.3.85 → 0.3.86

package/dist/src/manager/prompt.js

@@ -1,32 +1,34 @@
-const s=`\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002
+// @arch docs/features/manager-agent.md
+// @test src/__tests__/manager-inbox.test.ts
+export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管理者。
 
-\u4F60\u7684\u804C\u8D23\uFF1A
-- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002
-- \u62C6\u89E3\u4EFB\u52A1\u3002
-- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002
-- \u6C47\u603B worker \u7ED3\u679C\u3002
-- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002
-- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002
+你的职责：
+- 理解用户目标。
+- 拆解任务。
+- 创建、指派、观察和停止同一项目目录下的 worker Agent session。
+- 汇总 worker 结果。
+- 判断是否需要继续等待、调整安排、询问用户或验收。
+- 在项目 .shennian/ 目录下维护必要的计划、记录和项目记忆。
 
-\u4F60\u7684\u8FB9\u754C\uFF1A
-- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002
-- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002
-- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002
-- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002
-- \u6BCF\u6B21\u6536\u5230\u65B0\u4EFB\u52A1\u3001\u8865\u5145\u8981\u6C42\u3001\u7EA0\u504F\u6216\u5916\u90E8\u6D88\u606F\u65F6\uFF0C\u5148\u7528 sessions list \u67E5\u770B\u5F53\u524D\u540C\u9879\u76EE worker\uFF1B\u5982\u679C\u53EF\u80FD\u76F8\u5173\uFF0C\u518D\u7528 sessions read \u8BFB\u53D6\u5FC5\u8981\u6458\u8981\u540E\u5224\u65AD\u662F\u5426\u590D\u7528\u3002
-- \u5982\u679C\u5DF2\u6709 worker \u6B63\u5728\u5904\u7406\u540C\u4E00\u76EE\u6807\u3001\u540C\u4E00\u529F\u80FD\u533A\u3001\u540C\u4E00\u6587\u4EF6\u8303\u56F4\u6216\u540C\u4E00\u95EE\u9898\u94FE\u8DEF\uFF0C\u4F18\u5148\u7528 sessions send \u628A\u65B0\u8981\u6C42\u53D1\u7ED9\u8FD9\u4E2A worker\uFF1B\u5373\u4F7F worker \u6B63\u5FD9\u4E5F\u53EF\u4EE5\u53D1\u9001\uFF0C\u9ED8\u8BA4\u4F1A\u8FDB\u5165\u672C\u673A\u961F\u5217\uFF0C\u4E0D\u8981\u56E0\u4E3A\u5B83\u5FD9\u5C31\u65B0\u5EFA worker\u3002
-- \u53EA\u6709\u6CA1\u6709\u76F8\u5173 worker\u3001\u73B0\u6709 worker \u5DF2\u660E\u663E\u4E0D\u9002\u5408\u7EE7\u7EED\u63A8\u8FDB\u3001\u6216\u4EFB\u52A1\u9700\u8981\u5E76\u884C\u62C6\u5206\u7ED9\u4E0D\u540C\u4E13\u957F\u65F6\uFF0C\u624D\u521B\u5EFA\u65B0\u7684 worker\u3002
-- \u521B\u5EFA\u6216\u6307\u6D3E worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002
-- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002
-- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002
-- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002
-- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002
-- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u4E3A\u201C\u5916\u90E8\u5BF9\u8BDD: <\u5BF9\u8BDD\u540D\u79F0>\u201D\u540E\u8DDF\u201C\u5BF9\u65B9: <\u5185\u5BB9\u6216\u9644\u4EF6\u94FE\u63A5>\u201D\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002
-- \u5916\u90E8\u6D88\u606F\u662F\u5426\u9700\u8981\u56DE\u590D\u3001\u8FFD\u95EE\u3001\u5FFD\u7565\u3001\u8F6C\u4EA4\u5185\u90E8\u8D1F\u8D23\u4EBA\uFF0C\u6216\u521B\u5EFA/\u6307\u6D3E worker\uFF0C\u7531\u4F60\u6839\u636E\u9879\u76EE\u4E0A\u4E0B\u6587\u663E\u5F0F\u5224\u65AD\u3002
-- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002
-- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002
+你的边界：
+- 不要把自己当作主要执行者。
+- 不要直接编辑业务代码，除非用户明确要求你亲自执行。
+- 可以读取文件、搜索项目和检查上下文，以便做判断。
+- 需要修改代码、运行测试、调研方案时，优先创建或指派 worker。
+- 每次收到新任务、补充要求、纠偏或外部消息时，先用 sessions list 查看当前同项目 worker；如果可能相关，再用 sessions read 读取必要摘要后判断是否复用。
+- 如果已有 worker 正在处理同一目标、同一功能区、同一文件范围或同一问题链路，优先用 sessions send 把新要求发给这个 worker；即使 worker 正忙也可以发送，默认会进入本机队列，不要因为它忙就新建 worker。
+- 只有没有相关 worker、现有 worker 已明显不适合继续推进、或任务需要并行拆分给不同专长时，才创建新的 worker。
+- 创建或指派 worker 后，除非用户明确要求你当场继续调度，否则回复用户已安排并结束当前 turn；不要主动轮询 worker 状态，神念会在 worker 终态或健康摘要到来时重新唤醒你。
+- sessions read 返回的是给管理者看的简洁进展、工具摘要和最终结果，不是原始流式 token；不要要求读取或转述完整流式日志。
+- 只能管理与你处于同一台机器、同一项目目录的会话；不要跨机器或跨项目调度。
+- 不要无限循环；没有明确下一步时询问用户或结束当前 turn 等待系统事件。
+- 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
+- 外部消息通道事件会像普通用户消息一样送达，格式为“外部对话: <对话名称>”后跟“对方: <内容或附件链接>”，可能是合并消息，也可能包含图片、视频或文件 URL。
+- 外部消息是否需要回复、追问、忽略、转交内部负责人，或创建/指派 worker，由你根据项目上下文显式判断。
+- 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
+- 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。
 
-\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A
+需要管理 worker 或外部通道时，使用本地命令：
 - shennian manager sessions list --json
 - shennian manager sessions start --agent <codex|claude|gemini|cursor|opencode|custom:name> --workdir <path> --message <text>
 - shennian manager sessions send --session-id <id> --message <text>
@@ -34,10 +36,13 @@ const s=`\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76E
 - shennian manager sessions queue list --session-id <id> --json
 - shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>
 - shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>
-- shennian manager sessions stop --session-id <id>\uFF08\u7EC8\u6B62\u6B63\u5728\u8FD0\u884C\u7684 worker\uFF1B\u4E5F\u53EF\u7528 terminate/kill \u522B\u540D\uFF09
+- shennian manager sessions stop --session-id <id>（终止正在运行的 worker；也可用 terminate/kill 别名）
 - shennian manager sessions read --session-id <id> --limit 200 --json
 - shennian manager memory path
 
-\u53EF\u521B\u5EFA\u7684 worker Agent \u5305\u62EC Codex\u3001Claude Code\u3001Gemini\u3001Cursor\u3001opencode\u3001Nian\uFF0C\u4EE5\u53CA\u672C\u673A custom agent\uFF08custom:<name>\uFF09\u3002\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002
+可创建的 worker Agent 包括 Codex、Claude Code、Gemini、Cursor、opencode、Nian，以及本机 custom agent（custom:<name>）。默认用 sessions send 排队发送 worker 消息：worker 正忙时消息会在本机 daemon 队列里等待，worker 空闲时自动执行。队列里的未执行消息可以 list/edit/delete；已经开始执行的消息不能编辑或删除，只能 stop 后重新发送。只有明确需要打断顺序时才使用 --direct。
 
-\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002`;function n(e){return e}export{s as MANAGER_SYSTEM_PROMPT,n as buildManagerPrompt};
+这些命令已经由神念注入当前 Manager 身份和同项目权限边界。不要尝试伪造 Manager session id。`;
+export function buildManagerPrompt(userText) {
+    return userText;
+}

package/dist/src/manager/registry.js

@@ -1 +1,317 @@
-import g from"node:fs";import S from"node:path";import{randomUUID as m}from"node:crypto";import{isAgentHiddenPayload as w,sessionPreviewFromPayload as A}from"@shennian/wire";import{resolveShennianPath as T}from"../config/index.js";import{listSessionRecords as f,readMessages as v}from"../session/store.js";import{listProjectedSessions as M}from"../session/projection.js";const I=T("manager-registry.json");function u(){return new Date().toISOString()}function W(){return{managers:{},workers:{},replyTargets:{},inbox:{}}}class G{load(){try{const e=JSON.parse(g.readFileSync(I,"utf-8"));return{managers:e.managers??{},workers:e.workers??{},replyTargets:e.replyTargets??{},inbox:e.inbox??{}}}catch{return W()}}save(e){g.mkdirSync(S.dirname(I),{recursive:!0}),g.writeFileSync(I,JSON.stringify(e,null,2))}upsertManager(e){const t=this.load(),r=t.managers[e.sessionId],s=u(),a={sessionId:e.sessionId,agentSessionId:e.agentSessionId??r?.agentSessionId??null,workDir:e.workDir,machineId:e.machineId??r?.machineId??null,modelId:e.modelId,agentType:e.agentType??r?.agentType??"manager",providerModelId:e.providerModelId??r?.providerModelId??null,defaultWorkerAgentType:e.defaultWorkerAgentType??r?.defaultWorkerAgentType??null,defaultWorkerModelId:e.defaultWorkerModelId??r?.defaultWorkerModelId??null,status:e.status??r?.status??"idle",managedWorkerSessionIds:r?.managedWorkerSessionIds??[],attachedExternalChannels:r?.attachedExternalChannels??[],createdAt:r?.createdAt??s,updatedAt:s};return t.managers[e.sessionId]=a,this.save(t),a}getManager(e){return this.load().managers[e]}enqueueInboxEvent(e){const t=this.load(),r=t.managers[e.managerSessionId],s=t.workers[e.workerSessionId];if(!r||!s||s.managedBy!==r.sessionId||s.workDir!==r.workDir)return null;const a=u(),o=t.inbox[e.managerSessionId]??[],d=o.findIndex(c=>c.workerSessionId===e.workerSessionId&&(e.kind==="worker.health"?c.kind==="worker.health":c.kind===e.kind&&c.runId===e.runId)),l=d>=0?{...o[d],...e,updatedAt:a}:{...e,id:`mie_${m()}`,createdAt:a,updatedAt:a};return d>=0?o[d]=l:o.push(l),t.inbox[e.managerSessionId]=o,this.save(t),l}listInboxEvents(e){return[...this.load().inbox[e]??[]].sort((t,r)=>t.createdAt.localeCompare(r.createdAt))}removeInboxEvents(e,t){if(!t.length)return;const r=this.load(),s=new Set(t);r.inbox[e]=(r.inbox[e]??[]).filter(a=>!s.has(a.id)),this.save(r)}addWorker(e){const t=this.load(),r=t.managers[e.managerSessionId];if(!r)throw new Error("Manager runtime is not registered");const s=e.sessionId??`sess_worker_${m()}`,a=u(),o={sessionId:s,agentType:e.agentType,workDir:e.workDir,managedBy:e.managerSessionId,status:"running",createdAt:a,updatedAt:a,lastActivityAt:a,summary:e.summary??null,agentSessionId:null,runId:null};return t.workers[s]=o,r.managedWorkerSessionIds.includes(s)||r.managedWorkerSessionIds.push(s),r.updatedAt=a,this.save(t),o}updateWorker(e,t){const r=this.load(),s=r.workers[e];if(!s)return;const a={...s,...t,updatedAt:u()};return r.workers[e]=a,this.save(r),a}listWorkers(e,t={}){const r=this.load(),s=r.managers[e];if(!s)return[];const a=Object.values(r.workers).filter(n=>n.workDir===s.workDir).filter(n=>t.includeManagers||n.agentType!=="manager").map(n=>this.decorateManagedWorker(n,t.runningSessionIds)),o=new Set(a.map(n=>n.sessionId)),d=f().filter(n=>n.workDir===s.workDir).filter(n=>t.includeManagers||n.agentType!=="manager").filter(n=>!o.has(n.sessionId)).map(n=>this.sessionRecordToWorker(n,t.runningSessionIds)),l=new Set([...a,...d].map(n=>n.sessionId)),h=(t.projectedSessions??M()).filter(n=>n.workDir===s.workDir).filter(n=>t.includeManagers||n.agentType!=="manager").filter(n=>!l.has(n.id)).map(n=>this.projectedSessionToWorker(n,t.runningSessionIds));return[...a,...d,...h].sort((n,k)=>k.lastActivityAt.localeCompare(n.lastActivityAt))}getWorkerForManager(e,t){const r=this.load(),s=r.managers[e],a=r.workers[t];if(!s)return;if(a)return a.workDir!==s.workDir||a.agentType==="manager"?void 0:this.decorateManagedWorker(a);const o=f().find(d=>d.sessionId===t);if(!(!o||o.workDir!==s.workDir||o.agentType==="manager"))return this.sessionRecordToWorker(o)}decorateManagedWorker(e,t){const r=t?.has(e.sessionId)?"running":e.status,s=this.readTranscriptSummary(e.sessionId,e.summary??null),a=s.lastMessagePreview??e.lastMessagePreview??e.summary??null,o=e.userGoal??s.userGoal??null;return{...e,managedBy:e.managedBy??null,status:r,title:e.title??o??a??e.summary??e.sessionId,userGoal:o,lastMessagePreview:a,summary:e.summary??a,canResume:e.canResume??e.status!=="aborted",source:e.source??"manager_registry",role:"managed_worker"}}sessionRecordToWorker(e,t){const r=this.readTranscriptSummary(e.sessionId,e.lastMessagePreview??null),s=r.lastMessagePreview??e.lastMessagePreview??null,a=r.userGoal,o=t?.has(e.sessionId)?"running":e.status==="failed"?"error":e.status==="completed"?"final":"idle";return{sessionId:e.sessionId,agentType:e.agentType,workDir:e.workDir,managedBy:null,status:o,createdAt:e.createdAt,updatedAt:e.updatedAt,lastActivityAt:e.lastActivityAt,title:a??s??e.sessionId,userGoal:a,lastMessagePreview:s,summary:s??a??null,agentSessionId:e.agentSessionId??null,runId:null,canResume:!!e.agentSessionId,source:"local_index",role:"project_session"}}projectedSessionToWorker(e,t){const r=e.lastMessagePreview??null,s=e.title?.trim()||r,a=t?.has(e.id)?"running":e.status==="failed"?"error":e.status==="completed"?"final":"idle";return{sessionId:e.id,agentType:e.agentType,workDir:e.workDir,managedBy:null,status:a,createdAt:e.createdAt,updatedAt:e.updatedAt,lastActivityAt:e.lastActivityAt||e.updatedAt,title:s??e.id,userGoal:s??null,lastMessagePreview:r,summary:r??s??null,agentSessionId:e.agentSessionId??null,runId:e.activity?.runId??null,canResume:!0,source:"app_projection",role:"project_session"}}readTranscriptSummary(e,t){const r=v(e,{limit:200});if(!r.length)return{userGoal:null,lastMessagePreview:t};const s=[...r].sort((d,l)=>d.ts-l.ts),a=s.find(d=>d.role==="user"),o=[...s].reverse().find(d=>y(d));return{userGoal:a?p(y(a),160):null,lastMessagePreview:p(y(o),180)??t}}createReplyTarget(e){const t=this.load(),r={replyTarget:`rt_${m()}`,managerSessionId:e.managerSessionId,channelId:e.channelId,conversationId:e.conversationId,messageId:e.messageId??null,createdAt:u()};return t.replyTargets[r.replyTarget]=r,this.save(t),r}getReplyTarget(e){return this.load().replyTargets[e]}getLatestReplyTargetForManager(e){return Object.values(this.load().replyTargets).filter(t=>t.managerSessionId===e).sort((t,r)=>r.createdAt.localeCompare(t.createdAt))[0]}}function y(i){return!i||w(i.payload)?null:A(i.payload,180)}function p(i,e){return i?i.length>e?`${i.slice(0,e)}...`:i:null}export{G as ManagerRegistry};
+// @arch docs/features/manager-agent.md
+// @test src/__tests__/manager-inbox.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { isAgentHiddenPayload, sessionPreviewFromPayload } from '@shennian/wire';
+import { resolveShennianPath } from '../config/index.js';
+import { listSessionRecords, readMessages } from '../session/store.js';
+import { listProjectedSessions } from '../session/projection.js';
+const REGISTRY_PATH = resolveShennianPath('manager-registry.json');
+function nowIso() {
+    return new Date().toISOString();
+}
+function emptyRegistry() {
+    return { managers: {}, workers: {}, replyTargets: {}, inbox: {} };
+}
+export class ManagerRegistry {
+    load() {
+        try {
+            const parsed = JSON.parse(fs.readFileSync(REGISTRY_PATH, 'utf-8'));
+            return {
+                managers: parsed.managers ?? {},
+                workers: parsed.workers ?? {},
+                replyTargets: parsed.replyTargets ?? {},
+                inbox: parsed.inbox ?? {},
+            };
+        }
+        catch {
+            return emptyRegistry();
+        }
+    }
+    save(registry) {
+        fs.mkdirSync(path.dirname(REGISTRY_PATH), { recursive: true });
+        fs.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2));
+    }
+    upsertManager(input) {
+        const registry = this.load();
+        const existing = registry.managers[input.sessionId];
+        const timestamp = nowIso();
+        const record = {
+            sessionId: input.sessionId,
+            agentSessionId: input.agentSessionId ?? existing?.agentSessionId ?? null,
+            workDir: input.workDir,
+            machineId: input.machineId ?? existing?.machineId ?? null,
+            modelId: input.modelId,
+            agentType: input.agentType ?? existing?.agentType ?? 'manager',
+            providerModelId: input.providerModelId ?? existing?.providerModelId ?? null,
+            defaultWorkerAgentType: input.defaultWorkerAgentType ?? existing?.defaultWorkerAgentType ?? null,
+            defaultWorkerModelId: input.defaultWorkerModelId ?? existing?.defaultWorkerModelId ?? null,
+            status: input.status ?? existing?.status ?? 'idle',
+            managedWorkerSessionIds: existing?.managedWorkerSessionIds ?? [],
+            attachedExternalChannels: existing?.attachedExternalChannels ?? [],
+            createdAt: existing?.createdAt ?? timestamp,
+            updatedAt: timestamp,
+        };
+        registry.managers[input.sessionId] = record;
+        this.save(registry);
+        return record;
+    }
+    getManager(sessionId) {
+        return this.load().managers[sessionId];
+    }
+    enqueueInboxEvent(input) {
+        const registry = this.load();
+        const manager = registry.managers[input.managerSessionId];
+        const worker = registry.workers[input.workerSessionId];
+        if (!manager || !worker)
+            return null;
+        if (worker.managedBy !== manager.sessionId || worker.workDir !== manager.workDir)
+            return null;
+        const timestamp = nowIso();
+        const events = registry.inbox[input.managerSessionId] ?? [];
+        const dedupeIndex = events.findIndex((event) => event.workerSessionId === input.workerSessionId && (input.kind === 'worker.health'
+            ? event.kind === 'worker.health'
+            : event.kind === input.kind && event.runId === input.runId));
+        const event = dedupeIndex >= 0
+            ? {
+                ...events[dedupeIndex],
+                ...input,
+                updatedAt: timestamp,
+            }
+            : {
+                ...input,
+                id: `mie_${randomUUID()}`,
+                createdAt: timestamp,
+                updatedAt: timestamp,
+            };
+        if (dedupeIndex >= 0)
+            events[dedupeIndex] = event;
+        else
+            events.push(event);
+        registry.inbox[input.managerSessionId] = events;
+        this.save(registry);
+        return event;
+    }
+    listInboxEvents(managerSessionId) {
+        return [...(this.load().inbox[managerSessionId] ?? [])]
+            .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    removeInboxEvents(managerSessionId, eventIds) {
+        if (!eventIds.length)
+            return;
+        const registry = this.load();
+        const ids = new Set(eventIds);
+        registry.inbox[managerSessionId] = (registry.inbox[managerSessionId] ?? [])
+            .filter((event) => !ids.has(event.id));
+        this.save(registry);
+    }
+    addWorker(input) {
+        const registry = this.load();
+        const manager = registry.managers[input.managerSessionId];
+        if (!manager)
+            throw new Error('Manager runtime is not registered');
+        const sessionId = input.sessionId ?? `sess_worker_${randomUUID()}`;
+        const timestamp = nowIso();
+        const record = {
+            sessionId,
+            agentType: input.agentType,
+            workDir: input.workDir,
+            managedBy: input.managerSessionId,
+            status: 'running',
+            createdAt: timestamp,
+            updatedAt: timestamp,
+            lastActivityAt: timestamp,
+            summary: input.summary ?? null,
+            agentSessionId: null,
+            runId: null,
+        };
+        registry.workers[sessionId] = record;
+        if (!manager.managedWorkerSessionIds.includes(sessionId)) {
+            manager.managedWorkerSessionIds.push(sessionId);
+        }
+        manager.updatedAt = timestamp;
+        this.save(registry);
+        return record;
+    }
+    updateWorker(sessionId, patch) {
+        const registry = this.load();
+        const existing = registry.workers[sessionId];
+        if (!existing)
+            return undefined;
+        const record = {
+            ...existing,
+            ...patch,
+            updatedAt: nowIso(),
+        };
+        registry.workers[sessionId] = record;
+        this.save(registry);
+        return record;
+    }
+    listWorkers(managerSessionId, opts = {}) {
+        const registry = this.load();
+        const manager = registry.managers[managerSessionId];
+        if (!manager)
+            return [];
+        const managedWorkers = Object.values(registry.workers)
+            .filter((worker) => worker.workDir === manager.workDir)
+            .filter((worker) => opts.includeManagers || worker.agentType !== 'manager')
+            .map((worker) => this.decorateManagedWorker(worker, opts.runningSessionIds));
+        const managedIds = new Set(managedWorkers.map((worker) => worker.sessionId));
+        const projectSessions = listSessionRecords()
+            .filter((session) => session.workDir === manager.workDir)
+            .filter((session) => opts.includeManagers || session.agentType !== 'manager')
+            .filter((session) => !managedIds.has(session.sessionId))
+            .map((session) => this.sessionRecordToWorker(session, opts.runningSessionIds));
+        const knownIds = new Set([...managedWorkers, ...projectSessions].map((session) => session.sessionId));
+        const projectedSource = opts.projectedSessions ?? listProjectedSessions();
+        const projectedSessions = projectedSource
+            .filter((session) => session.workDir === manager.workDir)
+            .filter((session) => opts.includeManagers || session.agentType !== 'manager')
+            .filter((session) => !knownIds.has(session.id))
+            .map((session) => this.projectedSessionToWorker(session, opts.runningSessionIds));
+        return [...managedWorkers, ...projectSessions, ...projectedSessions]
+            .sort((a, b) => b.lastActivityAt.localeCompare(a.lastActivityAt));
+    }
+    getWorkerForManager(managerSessionId, sessionId) {
+        const registry = this.load();
+        const manager = registry.managers[managerSessionId];
+        const worker = registry.workers[sessionId];
+        if (!manager)
+            return undefined;
+        if (worker) {
+            if (worker.workDir !== manager.workDir)
+                return undefined;
+            if (worker.agentType === 'manager')
+                return undefined;
+            return this.decorateManagedWorker(worker);
+        }
+        const session = listSessionRecords().find((item) => item.sessionId === sessionId);
+        if (!session || session.workDir !== manager.workDir || session.agentType === 'manager')
+            return undefined;
+        return this.sessionRecordToWorker(session);
+    }
+    decorateManagedWorker(worker, runningSessionIds) {
+        const status = runningSessionIds?.has(worker.sessionId) ? 'running' : worker.status;
+        const transcript = this.readTranscriptSummary(worker.sessionId, worker.summary ?? null);
+        const lastMessagePreview = transcript.lastMessagePreview ?? worker.lastMessagePreview ?? worker.summary ?? null;
+        const userGoal = worker.userGoal ?? transcript.userGoal ?? null;
+        return {
+            ...worker,
+            managedBy: worker.managedBy ?? null,
+            status,
+            title: worker.title ?? userGoal ?? lastMessagePreview ?? worker.summary ?? worker.sessionId,
+            userGoal,
+            lastMessagePreview,
+            summary: worker.summary ?? lastMessagePreview,
+            canResume: worker.canResume ?? worker.status !== 'aborted',
+            source: worker.source ?? 'manager_registry',
+            role: 'managed_worker',
+        };
+    }
+    sessionRecordToWorker(session, runningSessionIds) {
+        const transcript = this.readTranscriptSummary(session.sessionId, session.lastMessagePreview ?? null);
+        const lastMessagePreview = transcript.lastMessagePreview ?? session.lastMessagePreview ?? null;
+        const userGoal = transcript.userGoal;
+        const status = runningSessionIds?.has(session.sessionId)
+            ? 'running'
+            : session.status === 'failed'
+                ? 'error'
+                : session.status === 'completed'
+                    ? 'final'
+                    : 'idle';
+        return {
+            sessionId: session.sessionId,
+            agentType: session.agentType,
+            workDir: session.workDir,
+            managedBy: null,
+            status,
+            createdAt: session.createdAt,
+            updatedAt: session.updatedAt,
+            lastActivityAt: session.lastActivityAt,
+            title: userGoal ?? lastMessagePreview ?? session.sessionId,
+            userGoal,
+            lastMessagePreview,
+            summary: lastMessagePreview ?? userGoal ?? null,
+            agentSessionId: session.agentSessionId ?? null,
+            runId: null,
+            canResume: Boolean(session.agentSessionId),
+            source: 'local_index',
+            role: 'project_session',
+        };
+    }
+    projectedSessionToWorker(session, runningSessionIds) {
+        const lastMessagePreview = session.lastMessagePreview ?? null;
+        const userGoal = session.title?.trim() || lastMessagePreview;
+        const status = runningSessionIds?.has(session.id)
+            ? 'running'
+            : session.status === 'failed'
+                ? 'error'
+                : session.status === 'completed'
+                    ? 'final'
+                    : 'idle';
+        return {
+            sessionId: session.id,
+            agentType: session.agentType,
+            workDir: session.workDir,
+            managedBy: null,
+            status,
+            createdAt: session.createdAt,
+            updatedAt: session.updatedAt,
+            lastActivityAt: session.lastActivityAt || session.updatedAt,
+            title: userGoal ?? session.id,
+            userGoal: userGoal ?? null,
+            lastMessagePreview,
+            summary: lastMessagePreview ?? userGoal ?? null,
+            agentSessionId: session.agentSessionId ?? null,
+            runId: session.activity?.runId ?? null,
+            canResume: true,
+            source: 'app_projection',
+            role: 'project_session',
+        };
+    }
+    readTranscriptSummary(sessionId, fallbackPreview) {
+        const messages = readMessages(sessionId, { limit: 200 });
+        if (!messages.length)
+            return { userGoal: null, lastMessagePreview: fallbackPreview };
+        const chronological = [...messages].sort((a, b) => a.ts - b.ts);
+        const firstUser = chronological.find((message) => message.role === 'user');
+        const lastReadable = [...chronological].reverse().find((message) => readableText(message));
+        return {
+            userGoal: firstUser ? clip(readableText(firstUser), 160) : null,
+            lastMessagePreview: clip(readableText(lastReadable), 180) ?? fallbackPreview,
+        };
+    }
+    createReplyTarget(input) {
+        const registry = this.load();
+        const record = {
+            replyTarget: `rt_${randomUUID()}`,
+            managerSessionId: input.managerSessionId,
+            channelId: input.channelId,
+            conversationId: input.conversationId,
+            messageId: input.messageId ?? null,
+            createdAt: nowIso(),
+        };
+        registry.replyTargets[record.replyTarget] = record;
+        this.save(registry);
+        return record;
+    }
+    getReplyTarget(replyTarget) {
+        return this.load().replyTargets[replyTarget];
+    }
+    getLatestReplyTargetForManager(managerSessionId) {
+        return Object.values(this.load().replyTargets)
+            .filter((target) => target.managerSessionId === managerSessionId)
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt))[0];
+    }
+}
+function readableText(message) {
+    if (!message || isAgentHiddenPayload(message.payload))
+        return null;
+    return sessionPreviewFromPayload(message.payload, 180);
+}
+function clip(text, max) {
+    if (!text)
+        return null;
+    return text.length > max ? `${text.slice(0, max)}...` : text;
+}

package/dist/src/manager/retired-external-channel-compat.js

@@ -1 +1,40 @@
-const n=async()=>{throw new Error("feature_retired")};class s{constructor(e,t,a){}async start(){}async stop(){}getManagerChannel(...e){return null}getManagerChannelStatus(...e){return null}getChannelStatusById(...e){return null}getChannelById(...e){}listManagerChannelStatuses(...e){return[]}listManagerExternalChannels(...e){return[]}listChannelIdsManagedBy(...e){return[]}getDefaultReplyTarget(...e){return n()}upsertManagerChannel(...e){return n()}upsertManagerWeChatRpaChannel(...e){return n()}syncManagerWeChatRpaChannel(...e){return n()}cancelManagerWeChatRpaOutbound(...e){return n()}deleteManagerWeChatRpaChannel(...e){return n()}reply(...e){return n()}}class u{constructor(...e){}async reconcileSession(...e){}async reconcileAll(...e){}}function g(){return{run:async()=>{throw new Error("feature_retired")}}}function l(...r){return{listBindings:async(...e)=>({bindings:[]})}}function i(...r){return Promise.reject(new Error("feature_retired"))}function o(r){return[r]}function c(r){return`retired:${r}`}export{s as RetiredChannelRuntime,u as RetiredWeChatRpaSessionBindingSync,g as createRetiredAutomationLane,l as createRetiredChannelApiClient,i as retiredDirectWeChat,o as splitExternalReplyText,c as weChatChannelConversationId};
+const retired = async () => { throw new Error('feature_retired'); };
+export class RetiredChannelRuntime {
+    constructor(_onMessage, _createReplyTarget, _options) { }
+    async start() { }
+    async stop() { }
+    getManagerChannel(..._args) { return null; }
+    getManagerChannelStatus(..._args) { return null; }
+    getChannelStatusById(..._args) { return null; }
+    getChannelById(..._args) { return undefined; }
+    listManagerChannelStatuses(..._args) { return []; }
+    listManagerExternalChannels(..._args) { return []; }
+    listChannelIdsManagedBy(..._args) { return []; }
+    getDefaultReplyTarget(..._args) { return retired(); }
+    upsertManagerChannel(..._args) { return retired(); }
+    upsertManagerWeChatRpaChannel(..._args) { return retired(); }
+    syncManagerWeChatRpaChannel(..._args) { return retired(); }
+    cancelManagerWeChatRpaOutbound(..._args) { return retired(); }
+    deleteManagerWeChatRpaChannel(..._args) { return retired(); }
+    reply(..._args) { return retired(); }
+}
+export class RetiredWeChatRpaSessionBindingSync {
+    constructor(..._args) { }
+    async reconcileSession(..._args) { }
+    async reconcileAll(..._args) { }
+}
+export function createRetiredAutomationLane() {
+    return { run: async () => { throw new Error('feature_retired'); } };
+}
+export function createRetiredChannelApiClient(..._args) {
+    return { listBindings: async (..._args) => ({ bindings: [] }) };
+}
+export function retiredDirectWeChat(..._args) {
+    return Promise.reject(new Error('feature_retired'));
+}
+export function splitExternalReplyText(text) {
+    return [text];
+}
+export function weChatChannelConversationId(name) {
+    return `retired:${name}`;
+}

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

@@ -3,6 +3,7 @@ import { type AgentType, type ExternalChannelSessionStatus, type ReqFrame } from
 import { ManagerRegistry } from './registry.js';
 import type { SessionManagerRuntime } from '../session/types.js';
 import { RetiredChannelRuntime as ChannelRuntime, type ChannelRuntimeOptions, type WeChatAutomationLane, type WeChatRpaSessionContext } from './retired-external-channel-compat.js';
+import type { CompiledManagedAgentPolicy } from '../security/managed-agent-policy.js';
 export type LocalReqDispatcher = (req: ReqFrame) => Promise<void>;
 type ManagerRuntimeServiceOptions = {
     getRuntime: () => SessionManagerRuntime;
@@ -15,6 +16,7 @@ export declare function setManagerRuntimeService(service: ManagerRuntimeService
 export declare function getManagerRuntimeService(): ManagerRuntimeService | null;
 export declare class ManagerRuntimeService {
     private opts;
+    private readonly managedPolicies;
     readonly registry: ManagerRegistry;
     readonly channelRuntime: ChannelRuntime;
     private readonly weChatRpaSessionSync;
@@ -49,6 +51,8 @@ export declare class ManagerRuntimeService {
         defaultWorkerModelId?: string | null;
         status?: 'idle' | 'running' | 'interrupting';
     }): void;
+    setManagedAgentPolicy(sessionId: string, policy: CompiledManagedAgentPolicy | null): void;
+    getManagedAgentPolicyForWorker(managerSessionId: string, workDir: string): CompiledManagedAgentPolicy | null;
     setManagerWorkerDefaults(sessionId: string, agentType?: AgentType | null, modelId?: string | null): void;
     getManagerWorkerDefaults(sessionId: string): {
         agentType: AgentType | null;