shennian 0.3.85 → 0.3.86

package/dist/src/session/handlers/chat.js

@@ -1,2 +1,1030 @@
-import re from"node:os";import{createHash as V}from"node:crypto";import{createAgent as Ae}from"../../agents/adapter.js";import{buildApprovalPendingPayload as ke,buildUserMessagePayload as oe}from"@shennian/wire";import{ManagerModeAdapter as we}from"../../agents/manager.js";import{reportLog as D}from"../../log-reporter.js";import{lookupClaudeTranscriptCwd as Ee}from"../../native-fusion/parsers.js";import{appendMessage as b,getDaemonInstallationId as se,getMessageDeliveryStatus as xe,recordSession as N,upsertMessage as F}from"../store.js";import{mergeProjectedSessions as Te}from"../projection.js";import{buildManagedAgentEnv as Me}from"../../agents/config-status.js";import{parsePersonalAttachmentReferences as _e}from"../attachment-reference.js";import{assertFinishedAttachmentReferences as De,markAttachmentReferences as be}from"../attachment-transfer-store.js";import{requestSessionIndexPublish as x}from"../index-publisher.js";import{writeToolDetail as qe}from"../tool-detail-store.js";import{getPersonalSyncIdentity as de}from"../../personal-sync/epoch.js";import{getManagedRoomIpcRoot as $e,MANAGED_ROOM_IPC_ROOT_ENV as Pe}from"../../daemon-ipc/paths.js";function Ce(e,t,a){if(!e.managedAgentPolicy)throw new Error("managed_agent_policy_missing");const s=e.managedRoomPromptSnapshot;if(!s)throw new Error("managed_room_prompt_snapshot_missing");if(!t?.trim())throw new Error("managed_room_prompt_incomplete");if(!a||!/^mrc_[A-Za-z0-9_-]{43}$/.test(a))throw new Error("managed_room_context_unavailable");const r=V("sha256").update(JSON.stringify({requestedPolicy:e.managedAgentPolicy.requestedPolicy,enforcement:e.managedAgentPolicy.enforcement})).digest("hex"),l=V("sha256").update(e.managedAgentPolicy.adapterPolicy.workDir).digest("hex");if(s.runtimePermissionPolicyHash!==r||s.resolvedWorkDirHash!==l||s.enforcementLevel!==e.managedAgentPolicy.enforcement.level)throw new Error("managed_room_prompt_snapshot_mismatch")}function ve(e){const t=e.indexOf(`
-`),a=t>0?Math.min(t,80):Math.min(e.length,80);return e.slice(0,a)}function ie(e,t,a){return`${e}:${V("sha256").update(`${t}\0${a??""}`).digest("hex")}`}function Oe(e,t,a={}){if(e.state==="tool-call"||e.state==="tool-result"){const s={runId:e.runId,sourceSeq:e.seq};return{state:e.state,runId:e.runId,seq:e.seq,sessionId:t,detailRef:s,status:e.state==="tool-call"?"running":"completed",detailAvailable:!0,...e.durationMs!==void 0?{durationMs:e.durationMs}:{},...e.name?{name:e.name}:{},...e.source?{source:e.source}:{},...e.agentSessionId?{agentSessionId:e.agentSessionId}:{},...a}}return{...e,sessionId:t,...a}}const We=3e4;function Ne(e){return e.state==="heartbeat"?e.runPhase??null:e.state==="tool-call"||e.state==="tool-result"?"tool_running":e.state==="approval-pending"?"waiting_approval":e.state==="delta"?e.thinking?"thinking":"streaming_text":e.state==="init"||e.state==="start"?"thinking":null}function le(e,t){return`Agent send failed: ${t instanceof Error?t.message:String(t)}`}function ce(e,t){return e!=="manager"?e:t==="claude"?"claude":"codex"}function Fe(e,t){N({sessionId:t.sessionId,agentType:t.agentType,sessionMode:t.sessionMode,managerConfig:t.managerConfig,workDir:t.workDir,agentSessionId:t.agentSessionId??null,modelId:t.modelId??null,managerDefaultWorkerAgentType:t.managerDefaultWorkerAgentType,managerDefaultWorkerModelId:t.managerDefaultWorkerModelId}),e.client.sendEvent({type:"event",event:"session.update",payload:{session:{id:t.sessionId,agentType:t.agentType,sessionMode:t.sessionMode,managerConfig:t.managerConfig,agentSessionId:t.agentSessionId??null,modelId:t.modelId??null,workDir:t.workDir,status:"active",externalChannel:null}}})}function ue(e){return Me(e)}function ge(e,t,a){return{}}function j(e,t,a,s,r,l,c,h){const S=a==="codex";e.configure?.({sessionId:t,externalChannel:s??null,env:{...ue(a),...ge(t,s,r),...l&&!S?{SHENNIAN_MANAGED_ROOM_CONTEXT:l,[Pe]:$e()}:{}},...c?{managedAgentPolicy:c}:{},...S?{managedRoomContextToken:l??null,managedRoomExecutor:h??null}:{}})}function fe(e,t,a){const s=t.managedRoomContextToken;s&&s!==a&&e.revokeManagedRoomContextToken?.(s),t.managedRoomContextToken=a}function P(e,t){const a=t?.managedRoomContextToken;!t||!a||(t.managedRoomContextToken=null,e.revokeManagedRoomContextToken?.(a))}function He(e,t,a){if(e!=="claude"||!a)return t;const s=t.trim();return!!s&&s.startsWith("-")&&!s.includes("/")?Ee(a)??t:t}function ze(e,t,a,s){let r=null;function l(n,o={}){e.client.sendAgentEvent({type:"event",event:"agent",payload:Oe(n,t,o),seq:n.seq,id:`agent-evt-${n.runId}-${n.seq}`})}function c(n){n?.heartbeatTimer&&(clearInterval(n.heartbeatTimer),n.heartbeatTimer=null)}function h(n){if(!n.currentRunId||!n.currentRunPhase)return;const o=n.heartbeatSeq++;e.client.sendAgentEvent({type:"event",event:"agent",payload:{state:"heartbeat",sessionId:t,runId:n.currentRunId,seq:o,runPhase:n.currentRunPhase},seq:o,id:`agent-heartbeat-${n.currentRunId}-${o}-${Date.now()}`})}function S(n){!n||n.heartbeatTimer||(n.heartbeatTimer=setInterval(()=>{h(n)},We),n.heartbeatTimer.unref?.())}function y(n){const o=n?.pendingTextEvent;!n||!o||!o.text||(b(t,{id:`agent-${o.runId}-${o.seq}`,sessionId:t,role:"agent",ts:Date.now(),payload:o.text}),x(e.client),l({state:"delta",runId:o.runId,seq:o.seq,text:o.text,thinking:o.thinking||void 0}),n.pendingTextEvent=null)}s.on("agentEvent",n=>{const o=e.sessions.get(t),T=Ne(n),M=n.state==="final"||n.state==="error"||n.state==="aborted";if(o&&(o.nextEventSeq=n.seq+1,M||(o.currentRunId=n.runId),!M&&T&&(o.currentRunPhase=T,S(o)),n.agentSessionId&&(o.agentSessionId=n.agentSessionId)),e.managerRuntime?.noteAgentEvent(t,n),n.state==="delta"&&n.thinking)return;n.state!=="delta"&&D({level:"info",sessionId:t,wsEvent:`agent.${n.state}`,wsDirection:"out",metadata:{runId:n.runId,seq:n.seq,agentType:a}});let k=!1;if(n.state==="tool-call"||n.state==="tool-result"){const m=`agent-${n.runId}-${n.seq}`;qe({sessionId:t,toolCallId:m,detailRevision:n.seq,ts:Date.now(),name:n.name??"tool",...n.args!==void 0?{args:n.args}:{},...n.result!==void 0?{result:n.result}:{},status:n.state==="tool-call"?"running":"completed",...n.durationMs!==void 0?{durationMs:n.durationMs}:{},detailRef:{runId:n.runId,sourceSeq:n.seq}}),b(t,{id:m,sessionId:t,role:"agent",ts:Date.now(),payload:JSON.stringify({v:1,type:n.state==="tool-call"?"tool_use":"tool_result",name:n.name,toolCallId:m,status:n.state==="tool-call"?"running":"completed",...n.durationMs!==void 0?{durationMs:n.durationMs}:{},detailRef:{runId:n.runId,sourceSeq:n.seq},detailRevision:n.seq,detailAvailable:!0,resultOmitted:n.state==="tool-result"})}),k=!0}else n.state==="approval-pending"?(b(t,{id:`agent-${n.runId||"run"}-${n.seq}`,sessionId:t,role:"agent",ts:Date.now(),payload:ke(n.approval)}),k=!0,o&&N({sessionId:t,agentType:a,workDir:o.workDir,agentSessionId:o.agentSessionId,attentionId:ie("approval",n.runId,n.seq)})):(n.state==="error"||n.state==="aborted")&&n.message&&(b(t,{id:`agent-${n.runId||"run"}-${n.seq}`,sessionId:t,role:"agent",ts:Date.now(),payload:n.message}),k=!0);k&&x(e.client);const A=`${t}:${n.runId}`;if(n.state==="delta"&&!n.thinking&&n.text&&e.runTextAcc.set(A,(e.runTextAcc.get(A)??"")+n.text),n.agentSessionId&&n.agentSessionId!==r&&(r=n.agentSessionId,e.nativeFusion?.noteManagedSourceSession(t,ce(a,n.source),n.agentSessionId),o&&N({sessionId:t,agentType:a,workDir:o.workDir,agentSessionId:n.agentSessionId}),e.client.sendEvent({type:"event",event:"session.update",payload:{session:{id:t,agentType:a,agentSessionId:n.agentSessionId}}})),n.state==="delta"){const m=n.text??"";if(!m)return;o?.pendingTextEvent&&o.pendingTextEvent.runId!==n.runId&&y(o),o&&!o.pendingTextEvent&&(o.pendingTextEvent={runId:n.runId,seq:n.seq,text:"",thinking:!1}),o?.pendingTextEvent&&(o.pendingTextEvent.text+=m,o.pendingTextEvent.seq=n.seq);return}let C={};if(n.state==="final"){y(o);const m=e.runTextAcc.get(A)??"";m&&(C={messageSummary:ve(m)}),e.runTextAcc.delete(A)}else n.state==="error"||n.state==="aborted"?(y(o),e.runTextAcc.delete(A)):(n.state==="tool-call"||n.state==="tool-result"||n.state==="approval-pending")&&y(o);M&&o?.currentRunId===n.runId&&(P(e,o),o.currentRunId=null,o.currentRunPhase=null,o.nextEventSeq=0,c(o),e.chatQueue?.noteTerminal(t),N({sessionId:t,agentType:a,workDir:o.workDir,agentSessionId:o.agentSessionId,status:n.state==="final"?"completed":"failed",attentionId:ie("terminal",n.runId),lastActivityAt:new Date().toISOString()}),x(e.client)),l(n,C)}),s.on("error",n=>{console.error(`[chat.send] adapter error sessionId=${t} agentType=${a}: ${n.message}`),P(e,e.sessions.get(t)),e.sessions.delete(t),e.chatQueue?.noteTerminal(t),e.client.sendEvent({type:"event",event:"agent",payload:{state:"error",sessionId:t,message:n.message,runId:"",seq:0}})})}function Be(e,t){if(e.processedReqIds.add(t),e.processedReqIds.size>1e3){const a=e.processedReqIds.values().next().value;e.processedReqIds.delete(a)}}async function H(e,t){P(e,t),t.heartbeatTimer&&(clearInterval(t.heartbeatTimer),t.heartbeatTimer=null),t.adapter.removeAllListeners(),await t.adapter.stop().catch(()=>{})}function me(e,t,a,s,r,l,c){return c?e.send(t,a,s,r,l,c):l?.trim()?e.send(t,a,s,r,l):r?.length?e.send(t,a,s,r):s?e.send(t,a,s):e.send(t,a)}function Le(e,t,a,s,r,l,c){return e.prepareSend?e.prepareSend(t,a,s,r,l,c):Promise.resolve()}async function Ue(e,t,a,s,r,l,c,h,S){e.evictIdleSessions();const y=Ae(a);if(!y)throw new Error(`Unsupported agent: ${a}`);const n=s==="manager"&&a!=="manager"?new we(y,a==="claude"?"claude":"codex"):y;j(n,t,a,c,h,null,S,e.managedRoomExecutor),await n.start(t,r,l);const o={adapter:n,workDir:r,agentType:a,sessionMode:s,agentSessionId:l??null,lastActiveAt:Date.now(),currentRunId:null,currentRunPhase:null,nextEventSeq:0,heartbeatSeq:0,heartbeatTimer:null,pendingTextEvent:null,externalChannel:c??null,externalReplyTarget:h??null,externalChannelEnv:{...ue(a),...ge(t,c,h)},managedRoomContextToken:null};return e.sessions.set(t,o),ze(e,t,a,n),o}function Je(e,t){const a=e.sessions.get(t),s=a?.currentRunId;if(!a||!s)return;const r=a.nextEventSeq;e.runTextAcc.delete(`${t}:${s}`),P(e,a),a.pendingTextEvent=null,a.currentRunId=null,a.currentRunPhase=null,a.nextEventSeq=0,a.heartbeatTimer&&(clearInterval(a.heartbeatTimer),a.heartbeatTimer=null),e.client.sendAgentEvent({type:"event",event:"agent",payload:{state:"aborted",sessionId:t,runId:s,seq:r},seq:r,id:`agent-evt-${s}-${r}`}),e.chatQueue?.noteTerminal(t)}async function ct(e,t,a){const s=a?t.params.managedRoomContextToken??null:null;let r=!1;try{await Qe(e,t,a,()=>{r=!0})}finally{s&&!r&&e.revokeManagedRoomContextToken?.(s)}}async function Qe(e,t,a,s){if(e.processedReqIds.has(t.id)){e.client.sendRes({type:"res",id:t.id,ok:!0});return}const{sessionId:r,text:l,agentType:c,sessionMode:h,managerConfig:S,workDir:y,agentSessionId:n,modelId:o,systemPrompt:T,managerDefaultWorkerAgentType:M,managerDefaultWorkerModelId:k,reasoningEffort:A,clientMessageId:C,sessionListProjection:m,waitForDispatch:G,responseId:pe,managedRoomContextToken:q,suppressExternalOwnerEcho:he,queuedBatchItems:z}=t.params,I=pe||t.id;Te(m);const v=null,B="";if(a?.source==="room_activation"&&(Ce(a,T,q),c==="manager"||h!=="standard"))throw new Error("managed_agent_manager_mode_unsupported");if(Be(e,t.id),!r||!l){e.processedReqIds.delete(t.id),e.client.sendRes({type:"res",id:I,ok:!1,error:"sessionId and text are required"});return}const g=c,$=g==="manager"||h==="manager"?"manager":"standard";$==="manager"&&e.managerRuntime?.setManagerWorkerDefaults(r,M??null,k??null);const O=(g==="claude"||g==="codex"||g==="workbuddy")&&typeof A=="string"&&A.trim()?A.trim():void 0,_=e.resolvePath(He(g,y||re.homedir(),n)||re.homedir()),ye=_,W=_e(t.params.attachments);W?.length&&De(_,W);const p={text:l,attachments:W,localized:!1};let i=e.sessions.get(r);if(i){if(i.lastActiveAt=Date.now(),i.agentType!==g||(i.sessionMode??(i.agentType==="manager"?"manager":"standard"))!==$||i.workDir!==_||JSON.stringify(i.externalChannel??null)!==JSON.stringify(v??null)){e.sessions.delete(r);try{await H(e,i)}catch{e.processedReqIds.delete(t.id)}i=void 0}else if(n&&i.agentSessionId!==n)try{await i.adapter.resume(n),i.agentSessionId=n}catch{e.sessions.delete(r);try{await H(e,i)}catch{e.processedReqIds.delete(t.id)}i=void 0}}if(!i)try{i=await Ue(e,r,g,$,_,n,v,B,a?.managedAgentPolicy)}catch(d){const f=d instanceof Error&&d.message.startsWith("Unsupported agent:")?d.message:`Failed to start ${c}: ${d instanceof Error?d.message:String(d)}`;console.error(`[chat.send] start failed reqId=${t.id} sessionId=${r} agentType=${c} workDir=${_} agentSessionId=${n??""}: ${f}`),e.client.sendEvent({type:"event",event:"agent",payload:{state:"error",sessionId:r,message:f,runId:"",seq:0}}),e.processedReqIds.delete(t.id),e.client.sendRes({type:"res",id:I,ok:!1,error:f});return}const R={id:C??`user-${t.id}`,sessionId:r,role:"user",ts:Date.now(),payload:oe(p.text,p.attachments)},K=Array.isArray(z)&&z.length>0?z.map(d=>({id:d.clientMessageId??d.id,sessionId:r,role:"user",ts:Date.parse(d.createdAt),payload:oe(d.text,d.attachments)})):null,L=K??[R],w=xe(r,R.id),X=w.state==="queued";if(w.state!=="not_found"&&!X){e.client.sendRes({type:"res",id:I,ok:!0,payload:w});return}if(G){a?.source==="room_activation"&&j(i.adapter,r,g,v,B,q,a.managedAgentPolicy,e.managedRoomExecutor);try{await Le(i.adapter,p.text,o,O,p.attachments,T,a?{source:a.source}:void 0)}catch(d){e.processedReqIds.delete(t.id),e.sessions.delete(r),await H(e,i),e.client.sendRes({type:"res",id:I,ok:!1,error:d instanceof Error?d.message:String(d)});return}}D({level:"info",sessionId:r,wsEvent:"chat.send.start",metadata:{reqId:t.id,agentType:g,sessionMode:$,managerConfig:S??null,modelId:o,managerDefaultWorkerAgentType:M??null,managerDefaultWorkerModelId:k??null,reasoningEffort:O,...a?.source==="room_activation"?{managedRoomPromptSnapshot:a.managedRoomPromptSnapshot}:{}}});const U=(d,f)=>({...de(se()),sessionId:r,clientMessageId:R.id,messageId:R.id,deliveryState:d,bodyRevision:f,committedAt:new Date(R.ts).toISOString()}),Y=d=>{e.nativeFusion?.registerManagedSend({sessionId:r,agentType:g,sourceAgentType:ce(g,o),canonicalMessageId:R.id,sourceSessionKey:i.agentSessionId??n??null,text:p.text,managedEchoPolicy:d?.deliveryMode==="external_owner_queue"&&!he?"import_following":"suppress_following",externalRunId:d?.deliveryMode==="external_owner_queue"?`codex-external-${d.queuedSubmissionId??R.id}`:null})},Z=()=>{i.currentRunId||(i.currentRunId=`dispatch:${t.id}`,i.currentRunPhase="thinking",i.nextEventSeq=0)},ee=()=>{if(Y(),X)return{...de(se()),sessionId:r,clientMessageId:w.clientMessageId,messageId:w.messageId,deliveryState:w.deliveryState,bodyRevision:w.bodyRevision,committedAt:w.committedAt};try{Fe(e,{sessionId:r,agentType:g,sessionMode:$,managerConfig:S??null,workDir:ye,agentSessionId:i.agentSessionId??n??null,modelId:o,managerDefaultWorkerAgentType:M??null,managerDefaultWorkerModelId:k??null});let d=0;for(const[f,u]of L.entries()){const E=K?F(r,u,"committed"):b(r,u,"committed");f===0&&(d=E)}return be(_,W??[]),x(e.client),U("committed",d)}catch(d){throw e.nativeFusion?.cancelManagedSend?.(R.id),d}},te=d=>{i.currentRunId||(i.nextEventSeq=0),Y(d);const f=d?.deliveryMode==="external_owner_queue"?"queued":"executing";let u=0;for(const[E,J]of L.entries()){const Q=F(r,J,f);E===0&&(u=Q)}return x(e.client),U(f,u)},ne=async(d,f)=>{e.nativeFusion?.cancelManagedSend?.(R.id);const u=le(g,d);console.error(`[chat.send] send failed reqId=${t.id} sessionId=${r} agentType=${c} workDir=${_} agentSessionId=${i.agentSessionId??n??""}: ${u}`),e.sessions.delete(r);try{await H(e,i)}catch{}if(e.client.sendEvent({type:"event",event:"agent",payload:{state:"error",sessionId:r,message:u,runId:"",seq:0}}),!f){const E={id:`agent-error-${t.id}-${Date.now()}`,sessionId:r,role:"agent",ts:Date.now(),payload:u};b(r,E),x(e.client)}f&&(e.processedReqIds.delete(t.id),e.client.sendRes({type:"res",id:I,ok:!1,error:u}))};if(G){try{ee()}catch(u){e.processedReqIds.delete(t.id),e.client.sendRes({type:"res",id:I,ok:!1,error:`Durable message commit failed: ${u instanceof Error?u.message:String(u)}`});return}Z();let d;try{a?.source==="room_activation"&&(fe(e,i,q),s());const u=p.attachments;d=await me(i.adapter,p.text,o,O,u,T,a?{source:a.source}:void 0),D({level:"info",sessionId:r,wsEvent:"chat.send.done",metadata:{reqId:t.id}})}catch(u){let E=0;for(const[Q,Re]of L.entries()){const Se=F(r,Re,"failed");Q===0&&(E=Se)}x(e.client);const J=le(g,u);await ne(u,!1),e.client.sendRes({type:"res",id:I,ok:!0,payload:{...U("failed",E),failureMessage:J}});return}const f=te(d??void 0);e.client.sendRes({type:"res",id:I,ok:!0,payload:{...f,...p.localized?{localizedAttachments:!0}:{},...d?.deliveryMode==="external_owner_queue"?{queued:!0,deliveryMode:d.deliveryMode,queuedSubmissionId:d.queuedSubmissionId}:{}}}),D({level:"info",sessionId:r,wsEvent:"chat.send.res",metadata:{reqId:t.id,ok:!0}});return}let ae;try{ae=ee()}catch(d){e.processedReqIds.delete(t.id),e.client.sendRes({type:"res",id:I,ok:!1,error:`Durable message commit failed: ${d instanceof Error?d.message:String(d)}`});return}Z(),a?.source==="room_activation"&&(j(i.adapter,r,g,v,B,q,a.managedAgentPolicy,e.managedRoomExecutor),fe(e,i,q),s()),te(),e.client.sendRes({type:"res",id:I,ok:!0,payload:{...ae,...p.localized?{localizedAttachments:!0}:{}}}),D({level:"info",sessionId:r,wsEvent:"chat.send.res",metadata:{reqId:t.id,ok:!0}});const Ie=p.attachments;me(i.adapter,p.text,o,O,Ie,T,a?{source:a.source}:void 0).then(()=>{D({level:"info",sessionId:r,wsEvent:"chat.send.done",metadata:{reqId:t.id}})}).catch(d=>{F(r,R,"failed"),x(e.client),ne(d,!1)})}async function ut(e,t){const{sessionId:a}=t.params,s=e.sessions.get(a);if(s){P(e,s);try{await s.adapter.stop()}catch{e.client.sendRes({type:"res",id:t.id,ok:!1,error:"agent_stop_failed"});return}Je(e,a),e.activityPublisher?.publish(a,null)}e.client.sendRes({type:"res",id:t.id,ok:!0})}export{ut as handleChatAbort,ct as handleChatSend,Fe as sendSessionUpdateEvent};
+// @arch docs/architecture/cli/daemon.md#会话管理
+// @test src/__tests__/session-manager.test.ts
+import os from 'node:os';
+import { createHash } from 'node:crypto';
+import { createAgent } from '../../agents/adapter.js';
+import { buildApprovalPendingPayload, buildUserMessagePayload, } from '@shennian/wire';
+import { ManagerModeAdapter } from '../../agents/manager.js';
+import { reportLog } from '../../log-reporter.js';
+import { lookupClaudeTranscriptCwd } from '../../native-fusion/parsers.js';
+import { appendMessage, getDaemonInstallationId, getMessageDeliveryStatus, recordSession, upsertMessage, } from '../store.js';
+import { mergeProjectedSessions } from '../projection.js';
+import { buildManagedAgentEnv } from '../../agents/config-status.js';
+import { parsePersonalAttachmentReferences } from '../attachment-reference.js';
+import { assertFinishedAttachmentReferences, markAttachmentReferences, } from '../attachment-transfer-store.js';
+import { requestSessionIndexPublish } from '../index-publisher.js';
+import { writeToolDetail } from '../tool-detail-store.js';
+import { getPersonalSyncIdentity } from '../../personal-sync/epoch.js';
+import { buildManagedAgentPermissionPrompt } from '../../room/managed-prompt-composer.js';
+import { getManagedRoomIpcRoot, MANAGED_ROOM_IPC_ROOT_ENV } from '../../daemon-ipc/paths.js';
+function validateManagedRoomExecutionContext(context, systemPrompt, managedRoomContextToken) {
+    if (!context.managedAgentPolicy)
+        throw new Error('managed_agent_policy_missing');
+    const snapshot = context.managedRoomPromptSnapshot;
+    if (!snapshot)
+        throw new Error('managed_room_prompt_snapshot_missing');
+    if (!systemPrompt?.trim())
+        throw new Error('managed_room_prompt_incomplete');
+    if (!managedRoomContextToken || !/^mrc_[A-Za-z0-9_-]{43}$/.test(managedRoomContextToken)) {
+        throw new Error('managed_room_context_unavailable');
+    }
+    const policyHash = createHash('sha256')
+        .update(JSON.stringify({
+        requestedPolicy: context.managedAgentPolicy.requestedPolicy,
+        enforcement: context.managedAgentPolicy.enforcement,
+    }))
+        .digest('hex');
+    const workDirHash = createHash('sha256')
+        .update(context.managedAgentPolicy.adapterPolicy.workDir)
+        .digest('hex');
+    if (snapshot.runtimePermissionPolicyHash !== policyHash ||
+        snapshot.resolvedWorkDirHash !== workDirHash ||
+        snapshot.enforcementLevel !== context.managedAgentPolicy.enforcement.level) {
+        throw new Error('managed_room_prompt_snapshot_mismatch');
+    }
+}
+function extractSummary(text) {
+    const newline = text.indexOf('\n');
+    const end = newline > 0 ? Math.min(newline, 80) : Math.min(text.length, 80);
+    return text.slice(0, end);
+}
+function stableAttentionId(kind, runId, seq) {
+    return `${kind}:${createHash('sha256')
+        .update(`${runId}\0${seq ?? ''}`)
+        .digest('hex')}`;
+}
+function buildRelayAgentPayload(event, sessionId, extra = {}) {
+    if (event.state === 'tool-call' || event.state === 'tool-result') {
+        const detailRef = { runId: event.runId, sourceSeq: event.seq };
+        return {
+            state: event.state,
+            runId: event.runId,
+            seq: event.seq,
+            sessionId,
+            detailRef,
+            status: event.state === 'tool-call' ? 'running' : 'completed',
+            detailAvailable: true,
+            ...(event.durationMs !== undefined ? { durationMs: event.durationMs } : {}),
+            ...(event.name ? { name: event.name } : {}),
+            ...(event.source ? { source: event.source } : {}),
+            ...(event.agentSessionId ? { agentSessionId: event.agentSessionId } : {}),
+            ...extra,
+        };
+    }
+    return { ...event, sessionId, ...extra };
+}
+const SESSION_ACTIVITY_HEARTBEAT_INTERVAL_MS = 30_000;
+function runPhaseFromAgentEvent(event) {
+    if (event.state === 'heartbeat')
+        return event.runPhase ?? null;
+    if (event.state === 'tool-call' || event.state === 'tool-result')
+        return 'tool_running';
+    if (event.state === 'approval-pending')
+        return 'waiting_approval';
+    if (event.state === 'delta')
+        return event.thinking ? 'thinking' : 'streaming_text';
+    if (event.state === 'init' || event.state === 'start')
+        return 'thinking';
+    return null;
+}
+function formatAgentSendFailure(agentType, err) {
+    const raw = err instanceof Error ? err.message : String(err);
+    return `Agent send failed: ${raw}`;
+}
+function getNativeSourceAgentType(agentType, modelId) {
+    if (agentType !== 'manager')
+        return agentType;
+    return modelId === 'claude' ? 'claude' : 'codex';
+}
+export function sendSessionUpdateEvent(runtime, input) {
+    recordSession({
+        sessionId: input.sessionId,
+        agentType: input.agentType,
+        sessionMode: input.sessionMode,
+        managerConfig: input.managerConfig,
+        workDir: input.workDir,
+        agentSessionId: input.agentSessionId ?? null,
+        modelId: input.modelId ?? null,
+        managerDefaultWorkerAgentType: input.managerDefaultWorkerAgentType,
+        managerDefaultWorkerModelId: input.managerDefaultWorkerModelId,
+    });
+    runtime.client.sendEvent({
+        type: 'event',
+        event: 'session.update',
+        payload: {
+            session: {
+                id: input.sessionId,
+                agentType: input.agentType,
+                sessionMode: input.sessionMode,
+                managerConfig: input.managerConfig,
+                agentSessionId: input.agentSessionId ?? null,
+                modelId: input.modelId ?? null,
+                workDir: input.workDir,
+                status: 'active',
+                externalChannel: null,
+            },
+        },
+    });
+}
+function managedProviderEnv(agentType) {
+    return buildManagedAgentEnv(agentType);
+}
+function externalChannelEnv(_sessionId, _channel, _replyTarget) {
+    return {};
+}
+function configureAdapterForSession(adapter, sessionId, agentType, channel, replyTarget, managedRoomContextToken, managedAgentPolicy, managedRoomExecutor) {
+    const useCodexDynamicTools = agentType === 'codex';
+    adapter.configure?.({
+        sessionId,
+        externalChannel: channel ?? null,
+        env: {
+            ...managedProviderEnv(agentType),
+            ...externalChannelEnv(sessionId, channel, replyTarget),
+            ...(managedRoomContextToken && !useCodexDynamicTools
+                ? {
+                    SHENNIAN_MANAGED_ROOM_CONTEXT: managedRoomContextToken,
+                    [MANAGED_ROOM_IPC_ROOT_ENV]: getManagedRoomIpcRoot(),
+                }
+                : {}),
+        },
+        ...(managedAgentPolicy ? { managedAgentPolicy } : {}),
+        ...(useCodexDynamicTools
+            ? {
+                managedRoomContextToken: managedRoomContextToken ?? null,
+                managedRoomExecutor: managedRoomExecutor ?? null,
+            }
+            : {}),
+    });
+}
+function replaceManagedRoomContextToken(runtime, session, token) {
+    const previous = session.managedRoomContextToken;
+    if (previous && previous !== token)
+        runtime.revokeManagedRoomContextToken?.(previous);
+    session.managedRoomContextToken = token;
+}
+function revokeManagedRoomContextToken(runtime, session) {
+    const token = session?.managedRoomContextToken;
+    if (!session || !token)
+        return;
+    session.managedRoomContextToken = null;
+    runtime.revokeManagedRoomContextToken?.(token);
+}
+function maybeResolveClaudeImportedWorkDir(agentType, workDir, agentSessionId) {
+    if (agentType !== 'claude')
+        return workDir;
+    if (!agentSessionId)
+        return workDir;
+    const trimmed = workDir.trim();
+    const looksLikeTranscriptSlug = !!trimmed && trimmed.startsWith('-') && !trimmed.includes('/');
+    if (!looksLikeTranscriptSlug)
+        return workDir;
+    return lookupClaudeTranscriptCwd(agentSessionId) ?? workDir;
+}
+function bindAdapterEvents(runtime, sessionId, agentType, adapter) {
+    let emittedAgentSessionId = null;
+    function sendAgentEvent(event, extra = {}) {
+        runtime.client.sendAgentEvent({
+            type: 'event',
+            event: 'agent',
+            payload: buildRelayAgentPayload(event, sessionId, extra),
+            seq: event.seq,
+            id: `agent-evt-${event.runId}-${event.seq}`,
+        });
+    }
+    function stopActivityHeartbeat(activeSession) {
+        if (!activeSession?.heartbeatTimer)
+            return;
+        clearInterval(activeSession.heartbeatTimer);
+        activeSession.heartbeatTimer = null;
+    }
+    function sendActivityHeartbeat(activeSession) {
+        if (!activeSession.currentRunId || !activeSession.currentRunPhase)
+            return;
+        const seq = activeSession.heartbeatSeq++;
+        runtime.client.sendAgentEvent({
+            type: 'event',
+            event: 'agent',
+            payload: {
+                state: 'heartbeat',
+                sessionId,
+                runId: activeSession.currentRunId,
+                seq,
+                runPhase: activeSession.currentRunPhase,
+            },
+            seq,
+            id: `agent-heartbeat-${activeSession.currentRunId}-${seq}-${Date.now()}`,
+        });
+    }
+    function ensureActivityHeartbeat(activeSession) {
+        if (!activeSession || activeSession.heartbeatTimer)
+            return;
+        activeSession.heartbeatTimer = setInterval(() => {
+            sendActivityHeartbeat(activeSession);
+        }, SESSION_ACTIVITY_HEARTBEAT_INTERVAL_MS);
+        activeSession.heartbeatTimer.unref?.();
+    }
+    function flushTextBuffer(activeSession) {
+        const textBuffer = activeSession?.pendingTextEvent;
+        if (!activeSession || !textBuffer || !textBuffer.text)
+            return;
+        appendMessage(sessionId, {
+            id: `agent-${textBuffer.runId}-${textBuffer.seq}`,
+            sessionId,
+            role: 'agent',
+            ts: Date.now(),
+            payload: textBuffer.text,
+        });
+        requestSessionIndexPublish(runtime.client);
+        sendAgentEvent({
+            state: 'delta',
+            runId: textBuffer.runId,
+            seq: textBuffer.seq,
+            text: textBuffer.text,
+            thinking: textBuffer.thinking || undefined,
+        });
+        activeSession.pendingTextEvent = null;
+    }
+    adapter.on('agentEvent', (event) => {
+        const activeSession = runtime.sessions.get(sessionId);
+        const runPhase = runPhaseFromAgentEvent(event);
+        const isTerminalEvent = event.state === 'final' || event.state === 'error' || event.state === 'aborted';
+        if (activeSession) {
+            activeSession.nextEventSeq = event.seq + 1;
+            if (!isTerminalEvent)
+                activeSession.currentRunId = event.runId;
+            if (!isTerminalEvent && runPhase) {
+                activeSession.currentRunPhase = runPhase;
+                ensureActivityHeartbeat(activeSession);
+            }
+            if (event.agentSessionId)
+                activeSession.agentSessionId = event.agentSessionId;
+        }
+        runtime.managerRuntime?.noteAgentEvent(sessionId, event);
+        // Reasoning is an implementation detail of the local Agent. Keep it on the
+        // machine: it must not enter Relay persistence or become a chat message.
+        if (event.state === 'delta' && event.thinking)
+            return;
+        if (event.state !== 'delta') {
+            reportLog({
+                level: 'info',
+                sessionId,
+                wsEvent: `agent.${event.state}`,
+                wsDirection: 'out',
+                metadata: { runId: event.runId, seq: event.seq, agentType },
+            });
+        }
+        let committedVisibleEvent = false;
+        if (event.state === 'tool-call' || event.state === 'tool-result') {
+            const toolMessageId = `agent-${event.runId}-${event.seq}`;
+            writeToolDetail({
+                sessionId,
+                toolCallId: toolMessageId,
+                detailRevision: event.seq,
+                ts: Date.now(),
+                name: event.name ?? 'tool',
+                ...(event.args !== undefined ? { args: event.args } : {}),
+                ...(event.result !== undefined ? { result: event.result } : {}),
+                status: event.state === 'tool-call' ? 'running' : 'completed',
+                ...(event.durationMs !== undefined ? { durationMs: event.durationMs } : {}),
+                detailRef: { runId: event.runId, sourceSeq: event.seq },
+            });
+            appendMessage(sessionId, {
+                id: toolMessageId,
+                sessionId,
+                role: 'agent',
+                ts: Date.now(),
+                payload: JSON.stringify({
+                    v: 1,
+                    type: event.state === 'tool-call' ? 'tool_use' : 'tool_result',
+                    name: event.name,
+                    toolCallId: toolMessageId,
+                    status: event.state === 'tool-call' ? 'running' : 'completed',
+                    ...(event.durationMs !== undefined ? { durationMs: event.durationMs } : {}),
+                    detailRef: { runId: event.runId, sourceSeq: event.seq },
+                    detailRevision: event.seq,
+                    detailAvailable: true,
+                    resultOmitted: event.state === 'tool-result',
+                }),
+            });
+            committedVisibleEvent = true;
+        }
+        else if (event.state === 'approval-pending') {
+            appendMessage(sessionId, {
+                id: `agent-${event.runId || 'run'}-${event.seq}`,
+                sessionId,
+                role: 'agent',
+                ts: Date.now(),
+                payload: buildApprovalPendingPayload(event.approval),
+            });
+            committedVisibleEvent = true;
+            if (activeSession) {
+                recordSession({
+                    sessionId,
+                    agentType,
+                    workDir: activeSession.workDir,
+                    agentSessionId: activeSession.agentSessionId,
+                    attentionId: stableAttentionId('approval', event.runId, event.seq),
+                });
+            }
+        }
+        else if ((event.state === 'error' || event.state === 'aborted') && event.message) {
+            appendMessage(sessionId, {
+                id: `agent-${event.runId || 'run'}-${event.seq}`,
+                sessionId,
+                role: 'agent',
+                ts: Date.now(),
+                payload: event.message,
+            });
+            committedVisibleEvent = true;
+        }
+        if (committedVisibleEvent)
+            requestSessionIndexPublish(runtime.client);
+        const runKey = `${sessionId}:${event.runId}`;
+        if (event.state === 'delta' && !event.thinking && event.text) {
+            runtime.runTextAcc.set(runKey, (runtime.runTextAcc.get(runKey) ?? '') + event.text);
+        }
+        if (event.agentSessionId && event.agentSessionId !== emittedAgentSessionId) {
+            emittedAgentSessionId = event.agentSessionId;
+            runtime.nativeFusion?.noteManagedSourceSession(sessionId, getNativeSourceAgentType(agentType, event.source), event.agentSessionId);
+            if (activeSession) {
+                recordSession({
+                    sessionId,
+                    agentType,
+                    workDir: activeSession.workDir,
+                    agentSessionId: event.agentSessionId,
+                });
+            }
+            runtime.client.sendEvent({
+                type: 'event',
+                event: 'session.update',
+                payload: {
+                    session: {
+                        id: sessionId,
+                        agentType,
+                        agentSessionId: event.agentSessionId,
+                    },
+                },
+            });
+        }
+        if (event.state === 'delta') {
+            const text = event.text ?? '';
+            if (!text)
+                return;
+            if (activeSession?.pendingTextEvent && activeSession.pendingTextEvent.runId !== event.runId) {
+                flushTextBuffer(activeSession);
+            }
+            if (activeSession && !activeSession.pendingTextEvent) {
+                activeSession.pendingTextEvent = {
+                    runId: event.runId,
+                    seq: event.seq,
+                    text: '',
+                    thinking: false,
+                };
+            }
+            if (activeSession?.pendingTextEvent) {
+                activeSession.pendingTextEvent.text += text;
+                activeSession.pendingTextEvent.seq = event.seq;
+            }
+            return;
+        }
+        let extra = {};
+        if (event.state === 'final') {
+            flushTextBuffer(activeSession);
+            const accumulated = runtime.runTextAcc.get(runKey) ?? '';
+            if (accumulated)
+                extra = { messageSummary: extractSummary(accumulated) };
+            runtime.runTextAcc.delete(runKey);
+        }
+        else if (event.state === 'error' || event.state === 'aborted') {
+            flushTextBuffer(activeSession);
+            runtime.runTextAcc.delete(runKey);
+        }
+        else if (event.state === 'tool-call' ||
+            event.state === 'tool-result' ||
+            event.state === 'approval-pending') {
+            flushTextBuffer(activeSession);
+        }
+        if (isTerminalEvent && activeSession?.currentRunId === event.runId) {
+            revokeManagedRoomContextToken(runtime, activeSession);
+            activeSession.currentRunId = null;
+            activeSession.currentRunPhase = null;
+            activeSession.nextEventSeq = 0;
+            stopActivityHeartbeat(activeSession);
+            runtime.chatQueue?.noteTerminal(sessionId);
+            recordSession({
+                sessionId,
+                agentType,
+                workDir: activeSession.workDir,
+                agentSessionId: activeSession.agentSessionId,
+                status: event.state === 'final' ? 'completed' : 'failed',
+                attentionId: stableAttentionId('terminal', event.runId),
+                lastActivityAt: new Date().toISOString(),
+            });
+            requestSessionIndexPublish(runtime.client);
+        }
+        sendAgentEvent(event, extra);
+    });
+    adapter.on('error', (error) => {
+        console.error(`[chat.send] adapter error sessionId=${sessionId} agentType=${agentType}: ${error.message}`);
+        revokeManagedRoomContextToken(runtime, runtime.sessions.get(sessionId));
+        runtime.sessions.delete(sessionId);
+        runtime.chatQueue?.noteTerminal(sessionId);
+        runtime.client.sendEvent({
+            type: 'event',
+            event: 'agent',
+            payload: { state: 'error', sessionId, message: error.message, runId: '', seq: 0 },
+        });
+    });
+}
+function rememberProcessedReqId(runtime, reqId) {
+    runtime.processedReqIds.add(reqId);
+    if (runtime.processedReqIds.size > 1000) {
+        const first = runtime.processedReqIds.values().next().value;
+        runtime.processedReqIds.delete(first);
+    }
+}
+async function disposeSession(runtime, session) {
+    revokeManagedRoomContextToken(runtime, session);
+    if (session.heartbeatTimer) {
+        clearInterval(session.heartbeatTimer);
+        session.heartbeatTimer = null;
+    }
+    session.adapter.removeAllListeners();
+    await session.adapter.stop().catch(() => { });
+}
+function sendAdapterTurn(adapter, text, modelId, reasoningEffort, attachments, systemPrompt, context) {
+    if (context) {
+        return adapter.send(text, modelId, reasoningEffort, attachments, systemPrompt, context);
+    }
+    if (systemPrompt?.trim()) {
+        return adapter.send(text, modelId, reasoningEffort, attachments, systemPrompt);
+    }
+    if (attachments?.length)
+        return adapter.send(text, modelId, reasoningEffort, attachments);
+    if (reasoningEffort)
+        return adapter.send(text, modelId, reasoningEffort);
+    return adapter.send(text, modelId);
+}
+function prepareAdapterTurn(adapter, text, modelId, reasoningEffort, attachments, systemPrompt, context) {
+    if (!adapter.prepareSend)
+        return Promise.resolve();
+    return adapter.prepareSend(text, modelId, reasoningEffort, attachments, systemPrompt, context);
+}
+async function createActiveSession(runtime, sessionId, agentType, sessionMode, resolvedWorkDir, incomingAgentSid, externalChannel, externalReplyTarget, managedAgentPolicy) {
+    runtime.evictIdleSessions();
+    const baseAdapter = createAgent(agentType);
+    if (!baseAdapter)
+        throw new Error(`Unsupported agent: ${agentType}`);
+    const adapter = sessionMode === 'manager' && agentType !== 'manager'
+        ? new ManagerModeAdapter(baseAdapter, agentType === 'claude' ? 'claude' : 'codex')
+        : baseAdapter;
+    configureAdapterForSession(adapter, sessionId, agentType, externalChannel, externalReplyTarget, null, managedAgentPolicy, runtime.managedRoomExecutor);
+    await adapter.start(sessionId, resolvedWorkDir, incomingAgentSid);
+    const session = {
+        adapter,
+        workDir: resolvedWorkDir,
+        agentType,
+        sessionMode,
+        agentSessionId: incomingAgentSid ?? null,
+        lastActiveAt: Date.now(),
+        currentRunId: null,
+        currentRunPhase: null,
+        nextEventSeq: 0,
+        heartbeatSeq: 0,
+        heartbeatTimer: null,
+        pendingTextEvent: null,
+        externalChannel: externalChannel ?? null,
+        externalReplyTarget: externalReplyTarget ?? null,
+        externalChannelEnv: {
+            ...managedProviderEnv(agentType),
+            ...externalChannelEnv(sessionId, externalChannel, externalReplyTarget),
+        },
+        managedRoomContextToken: null,
+    };
+    runtime.sessions.set(sessionId, session);
+    bindAdapterEvents(runtime, sessionId, agentType, adapter);
+    return session;
+}
+function emitSyntheticAbort(runtime, sessionId) {
+    const session = runtime.sessions.get(sessionId);
+    const runId = session?.currentRunId;
+    if (!session || !runId)
+        return;
+    const seq = session.nextEventSeq;
+    runtime.runTextAcc.delete(`${sessionId}:${runId}`);
+    revokeManagedRoomContextToken(runtime, session);
+    session.pendingTextEvent = null;
+    session.currentRunId = null;
+    session.currentRunPhase = null;
+    session.nextEventSeq = 0;
+    if (session.heartbeatTimer) {
+        clearInterval(session.heartbeatTimer);
+        session.heartbeatTimer = null;
+    }
+    runtime.client.sendAgentEvent({
+        type: 'event',
+        event: 'agent',
+        payload: { state: 'aborted', sessionId, runId, seq },
+        seq,
+        id: `agent-evt-${runId}-${seq}`,
+    });
+    runtime.chatQueue?.noteTerminal(sessionId);
+}
+export async function handleChatSend(runtime, req, context) {
+    const managedRoomToken = context
+        ? (req.params.managedRoomContextToken ?? null)
+        : null;
+    let transferredToTurn = false;
+    try {
+        await handleChatSendImpl(runtime, req, context, () => {
+            transferredToTurn = true;
+        });
+    }
+    finally {
+        if (managedRoomToken && !transferredToTurn) {
+            runtime.revokeManagedRoomContextToken?.(managedRoomToken);
+        }
+    }
+}
+async function handleChatSendImpl(runtime, req, context, transferManagedRoomTokenToTurn) {
+    if (runtime.processedReqIds.has(req.id)) {
+        runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+        return;
+    }
+    const { sessionId, text, agentType, sessionMode: incomingSessionMode, managerConfig, workDir, agentSessionId: incomingAgentSid, modelId, systemPrompt, managerDefaultWorkerAgentType, managerDefaultWorkerModelId, reasoningEffort, clientMessageId, sessionListProjection, waitForDispatch, responseId, managedRoomContextToken, suppressExternalOwnerEcho, queuedBatchItems, managedWorkerParentSessionId, } = req.params;
+    const replyId = responseId || req.id;
+    mergeProjectedSessions(sessionListProjection);
+    const incomingExternalChannel = null;
+    const incomingReplyTarget = '';
+    if (context?.source === 'room_activation') {
+        validateManagedRoomExecutionContext(context, systemPrompt, managedRoomContextToken);
+        if (agentType === 'manager') {
+            throw new Error('managed_agent_manager_mode_unsupported');
+        }
+    }
+    rememberProcessedReqId(runtime, req.id);
+    if (!sessionId || !text) {
+        runtime.processedReqIds.delete(req.id);
+        runtime.client.sendRes({
+            type: 'res',
+            id: replyId,
+            ok: false,
+            error: 'sessionId and text are required',
+        });
+        return;
+    }
+    const requestedAgentType = agentType;
+    const requestedSessionMode = requestedAgentType === 'manager' || incomingSessionMode === 'manager' ? 'manager' : 'standard';
+    if (requestedSessionMode === 'manager') {
+        runtime.managerRuntime?.setManagerWorkerDefaults(sessionId, managerDefaultWorkerAgentType ?? null, managerDefaultWorkerModelId ?? null);
+    }
+    const resolvedReasoningEffort = (requestedAgentType === 'claude' ||
+        requestedAgentType === 'codex' ||
+        requestedAgentType === 'workbuddy') &&
+        typeof reasoningEffort === 'string' &&
+        reasoningEffort.trim()
+        ? reasoningEffort.trim()
+        : undefined;
+    const resolvedWorkDir = runtime.resolvePath(maybeResolveClaudeImportedWorkDir(requestedAgentType, workDir || os.homedir(), incomingAgentSid) || os.homedir());
+    const inheritedManagedAgentPolicy = context?.managedAgentPolicy ?? (managedWorkerParentSessionId
+        ? runtime.managerRuntime?.getManagedAgentPolicyForWorker(managedWorkerParentSessionId, resolvedWorkDir) ?? null
+        : null);
+    if (managedWorkerParentSessionId && !inheritedManagedAgentPolicy) {
+        throw new Error('managed_worker_permission_context_unavailable');
+    }
+    const resolvedSystemPrompt = managedWorkerParentSessionId && inheritedManagedAgentPolicy
+        ? buildManagedAgentPermissionPrompt({
+            requestedPolicy: inheritedManagedAgentPolicy.requestedPolicy,
+            enforcement: inheritedManagedAgentPolicy.enforcement,
+            resolvedWorkDir: inheritedManagedAgentPolicy.adapterPolicy.workDir,
+        })
+        : systemPrompt;
+    const displayWorkDir = resolvedWorkDir;
+    const normalizedAttachments = parsePersonalAttachmentReferences(req.params.attachments);
+    if (normalizedAttachments?.length) {
+        assertFinishedAttachmentReferences(resolvedWorkDir, normalizedAttachments);
+    }
+    const materializedAttachments = {
+        text,
+        attachments: normalizedAttachments,
+        localized: false,
+    };
+    let session = runtime.sessions.get(sessionId);
+    if (session) {
+        session.lastActiveAt = Date.now();
+        const sessionDrifted = session.agentType !== requestedAgentType ||
+            (session.sessionMode ?? (session.agentType === 'manager' ? 'manager' : 'standard')) !==
+                requestedSessionMode ||
+            session.workDir !== resolvedWorkDir ||
+            JSON.stringify(session.externalChannel ?? null) !==
+                JSON.stringify(incomingExternalChannel ?? null);
+        if (sessionDrifted) {
+            runtime.sessions.delete(sessionId);
+            try {
+                await disposeSession(runtime, session);
+            }
+            catch {
+                runtime.processedReqIds.delete(req.id);
+            }
+            session = undefined;
+        }
+        else if (incomingAgentSid && session.agentSessionId !== incomingAgentSid) {
+            try {
+                await session.adapter.resume(incomingAgentSid);
+                session.agentSessionId = incomingAgentSid;
+            }
+            catch {
+                runtime.sessions.delete(sessionId);
+                try {
+                    await disposeSession(runtime, session);
+                }
+                catch {
+                    runtime.processedReqIds.delete(req.id);
+                }
+                session = undefined;
+            }
+        }
+    }
+    if (!session) {
+        try {
+            session = await createActiveSession(runtime, sessionId, requestedAgentType, requestedSessionMode, resolvedWorkDir, incomingAgentSid, incomingExternalChannel, incomingReplyTarget, inheritedManagedAgentPolicy);
+        }
+        catch (err) {
+            const message = err instanceof Error && err.message.startsWith('Unsupported agent:')
+                ? err.message
+                : `Failed to start ${agentType}: ${err instanceof Error ? err.message : String(err)}`;
+            console.error(`[chat.send] start failed reqId=${req.id} sessionId=${sessionId} agentType=${agentType} workDir=${resolvedWorkDir} agentSessionId=${incomingAgentSid ?? ''}: ${message}`);
+            runtime.client.sendEvent({
+                type: 'event',
+                event: 'agent',
+                payload: {
+                    state: 'error',
+                    sessionId,
+                    message,
+                    runId: '',
+                    seq: 0,
+                },
+            });
+            runtime.processedReqIds.delete(req.id);
+            runtime.client.sendRes({
+                type: 'res',
+                id: replyId,
+                ok: false,
+                error: message,
+            });
+            return;
+        }
+    }
+    const userEnvelope = {
+        id: clientMessageId ?? `user-${req.id}`,
+        sessionId,
+        role: 'user',
+        ts: Date.now(),
+        payload: buildUserMessagePayload(materializedAttachments.text, materializedAttachments.attachments),
+    };
+    const queuedBatchEnvelopes = Array.isArray(queuedBatchItems) && queuedBatchItems.length > 0
+        ? queuedBatchItems.map((message) => ({
+            id: message.clientMessageId ?? message.id,
+            sessionId,
+            role: 'user',
+            ts: Date.parse(message.createdAt),
+            payload: buildUserMessagePayload(message.text, message.attachments),
+        }))
+        : null;
+    const committedUserEnvelopes = queuedBatchEnvelopes ?? [userEnvelope];
+    const existingDelivery = getMessageDeliveryStatus(sessionId, userEnvelope.id);
+    const resumingQueuedMessage = existingDelivery.state === 'queued';
+    if (existingDelivery.state !== 'not_found' && !resumingQueuedMessage) {
+        runtime.client.sendRes({ type: 'res', id: replyId, ok: true, payload: existingDelivery });
+        return;
+    }
+    if (waitForDispatch) {
+        if (context?.source === 'room_activation') {
+            // Codex prepareSend may start app-server and create the managed thread.
+            // Bind the per-turn Room tools before that preparation so the thread is
+            // created with the fail-closed dynamic tool surface already available.
+            configureAdapterForSession(session.adapter, sessionId, requestedAgentType, incomingExternalChannel, incomingReplyTarget, managedRoomContextToken, context.managedAgentPolicy, runtime.managedRoomExecutor);
+        }
+        try {
+            await prepareAdapterTurn(session.adapter, materializedAttachments.text, modelId, resolvedReasoningEffort, materializedAttachments.attachments, resolvedSystemPrompt, context ? { source: context.source } : undefined);
+        }
+        catch (error) {
+            runtime.processedReqIds.delete(req.id);
+            runtime.sessions.delete(sessionId);
+            await disposeSession(runtime, session);
+            runtime.client.sendRes({
+                type: 'res',
+                id: replyId,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+    }
+    reportLog({
+        level: 'info',
+        sessionId,
+        wsEvent: 'chat.send.start',
+        metadata: {
+            reqId: req.id,
+            agentType: requestedAgentType,
+            sessionMode: requestedSessionMode,
+            managerConfig: managerConfig ?? null,
+            modelId,
+            managerDefaultWorkerAgentType: managerDefaultWorkerAgentType ?? null,
+            managerDefaultWorkerModelId: managerDefaultWorkerModelId ?? null,
+            reasoningEffort: resolvedReasoningEffort,
+            ...(context?.source === 'room_activation'
+                ? { managedRoomPromptSnapshot: context.managedRoomPromptSnapshot }
+                : {}),
+        },
+    });
+    const durableAck = (deliveryState, bodyRevision) => ({
+        ...getPersonalSyncIdentity(getDaemonInstallationId()),
+        sessionId,
+        clientMessageId: userEnvelope.id,
+        messageId: userEnvelope.id,
+        deliveryState,
+        bodyRevision,
+        committedAt: new Date(userEnvelope.ts).toISOString(),
+    });
+    const registerManagedClaim = (sendResult) => {
+        runtime.nativeFusion?.registerManagedSend({
+            sessionId,
+            agentType: requestedAgentType,
+            sourceAgentType: getNativeSourceAgentType(requestedAgentType, modelId),
+            canonicalMessageId: userEnvelope.id,
+            sourceSessionKey: session.agentSessionId ?? incomingAgentSid ?? null,
+            text: materializedAttachments.text,
+            managedEchoPolicy: sendResult?.deliveryMode === 'external_owner_queue' && !suppressExternalOwnerEcho
+                ? 'import_following'
+                : 'suppress_following',
+            externalRunId: sendResult?.deliveryMode === 'external_owner_queue'
+                ? `codex-external-${sendResult.queuedSubmissionId ?? userEnvelope.id}`
+                : null,
+        });
+    };
+    const markDispatchPending = () => {
+        if (session.currentRunId)
+            return;
+        session.currentRunId = `dispatch:${req.id}`;
+        session.currentRunPhase = 'thinking';
+        session.nextEventSeq = 0;
+    };
+    const commitUserBeforeDispatch = () => {
+        registerManagedClaim();
+        if (resumingQueuedMessage) {
+            return {
+                ...getPersonalSyncIdentity(getDaemonInstallationId()),
+                sessionId,
+                clientMessageId: existingDelivery.clientMessageId,
+                messageId: existingDelivery.messageId,
+                deliveryState: existingDelivery.deliveryState,
+                bodyRevision: existingDelivery.bodyRevision,
+                committedAt: existingDelivery.committedAt,
+            };
+        }
+        try {
+            sendSessionUpdateEvent(runtime, {
+                sessionId,
+                agentType: requestedAgentType,
+                sessionMode: requestedSessionMode,
+                managerConfig: managerConfig ?? null,
+                workDir: displayWorkDir,
+                agentSessionId: session.agentSessionId ?? incomingAgentSid ?? null,
+                modelId,
+                managerDefaultWorkerAgentType: managerDefaultWorkerAgentType ?? null,
+                managerDefaultWorkerModelId: managerDefaultWorkerModelId ?? null,
+            });
+            let primaryBodyRevision = 0;
+            for (const [index, envelope] of committedUserEnvelopes.entries()) {
+                const bodyRevision = queuedBatchEnvelopes
+                    ? upsertMessage(sessionId, envelope, 'committed')
+                    : appendMessage(sessionId, envelope, 'committed');
+                if (index === 0)
+                    primaryBodyRevision = bodyRevision;
+            }
+            markAttachmentReferences(resolvedWorkDir, normalizedAttachments ?? []);
+            requestSessionIndexPublish(runtime.client);
+            return durableAck('committed', primaryBodyRevision);
+        }
+        catch (error) {
+            runtime.nativeFusion?.cancelManagedSend?.(userEnvelope.id);
+            throw error;
+        }
+    };
+    const markAccepted = (sendResult) => {
+        // Some adapters (notably Codex app-server) emit `start` synchronously
+        // during `send()` before chat.send has acknowledged dispatch. Do not wipe
+        // that live run state here, or later chat.enqueue calls will think the
+        // session is idle and bypass the daemon queue.
+        if (!session.currentRunId) {
+            session.nextEventSeq = 0;
+        }
+        registerManagedClaim(sendResult);
+        const state = sendResult?.deliveryMode === 'external_owner_queue' ? 'queued' : 'executing';
+        let primaryBodyRevision = 0;
+        for (const [index, envelope] of committedUserEnvelopes.entries()) {
+            const bodyRevision = upsertMessage(sessionId, envelope, state);
+            if (index === 0)
+                primaryBodyRevision = bodyRevision;
+        }
+        requestSessionIndexPublish(runtime.client);
+        return durableAck(state, primaryBodyRevision);
+    };
+    const handleSendFailure = async (err, respondToReq) => {
+        runtime.nativeFusion?.cancelManagedSend?.(userEnvelope.id);
+        const message = formatAgentSendFailure(requestedAgentType, err);
+        console.error(`[chat.send] send failed reqId=${req.id} sessionId=${sessionId} agentType=${agentType} workDir=${resolvedWorkDir} agentSessionId=${session.agentSessionId ?? incomingAgentSid ?? ''}: ${message}`);
+        runtime.sessions.delete(sessionId);
+        try {
+            await disposeSession(runtime, session);
+        }
+        catch {
+            /* best-effort cleanup */
+        }
+        runtime.client.sendEvent({
+            type: 'event',
+            event: 'agent',
+            payload: {
+                state: 'error',
+                sessionId,
+                message,
+                runId: '',
+                seq: 0,
+            },
+        });
+        if (!respondToReq) {
+            const errorEnvelope = {
+                id: `agent-error-${req.id}-${Date.now()}`,
+                sessionId,
+                role: 'agent',
+                ts: Date.now(),
+                payload: message,
+            };
+            appendMessage(sessionId, errorEnvelope);
+            requestSessionIndexPublish(runtime.client);
+        }
+        if (respondToReq) {
+            runtime.processedReqIds.delete(req.id);
+            runtime.client.sendRes({
+                type: 'res',
+                id: replyId,
+                ok: false,
+                error: message,
+            });
+        }
+    };
+    if (waitForDispatch) {
+        try {
+            commitUserBeforeDispatch();
+        }
+        catch (err) {
+            runtime.processedReqIds.delete(req.id);
+            runtime.client.sendRes({
+                type: 'res',
+                id: replyId,
+                ok: false,
+                error: `Durable message commit failed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return;
+        }
+        markDispatchPending();
+        let sendResult;
+        try {
+            if (context?.source === 'room_activation') {
+                replaceManagedRoomContextToken(runtime, session, managedRoomContextToken);
+                transferManagedRoomTokenToTurn();
+            }
+            const attachments = materializedAttachments.attachments;
+            sendResult = await sendAdapterTurn(session.adapter, materializedAttachments.text, modelId, resolvedReasoningEffort, attachments, resolvedSystemPrompt, context ? { source: context.source } : undefined);
+            reportLog({
+                level: 'info',
+                sessionId,
+                wsEvent: 'chat.send.done',
+                metadata: { reqId: req.id },
+            });
+        }
+        catch (err) {
+            let failedRevision = 0;
+            for (const [index, envelope] of committedUserEnvelopes.entries()) {
+                const bodyRevision = upsertMessage(sessionId, envelope, 'failed');
+                if (index === 0)
+                    failedRevision = bodyRevision;
+            }
+            requestSessionIndexPublish(runtime.client);
+            const failureMessage = formatAgentSendFailure(requestedAgentType, err);
+            await handleSendFailure(err, false);
+            runtime.client.sendRes({
+                type: 'res',
+                id: replyId,
+                ok: true,
+                payload: {
+                    ...durableAck('failed', failedRevision),
+                    failureMessage,
+                },
+            });
+            return;
+        }
+        const ack = markAccepted(sendResult ?? undefined);
+        runtime.client.sendRes({
+            type: 'res',
+            id: replyId,
+            ok: true,
+            payload: {
+                ...ack,
+                ...(materializedAttachments.localized ? { localizedAttachments: true } : {}),
+                ...(sendResult?.deliveryMode === 'external_owner_queue'
+                    ? {
+                        queued: true,
+                        deliveryMode: sendResult.deliveryMode,
+                        queuedSubmissionId: sendResult.queuedSubmissionId,
+                    }
+                    : {}),
+            },
+        });
+        reportLog({
+            level: 'info',
+            sessionId,
+            wsEvent: 'chat.send.res',
+            metadata: { reqId: req.id, ok: true },
+        });
+        return;
+    }
+    let committedAck;
+    try {
+        committedAck = commitUserBeforeDispatch();
+    }
+    catch (err) {
+        runtime.processedReqIds.delete(req.id);
+        runtime.client.sendRes({
+            type: 'res',
+            id: replyId,
+            ok: false,
+            error: `Durable message commit failed: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        return;
+    }
+    markDispatchPending();
+    if (context?.source === 'room_activation') {
+        configureAdapterForSession(session.adapter, sessionId, requestedAgentType, incomingExternalChannel, incomingReplyTarget, managedRoomContextToken, context.managedAgentPolicy, runtime.managedRoomExecutor);
+        replaceManagedRoomContextToken(runtime, session, managedRoomContextToken);
+        transferManagedRoomTokenToTurn();
+    }
+    markAccepted();
+    runtime.client.sendRes({
+        type: 'res',
+        id: replyId,
+        ok: true,
+        payload: {
+            ...committedAck,
+            ...(materializedAttachments.localized ? { localizedAttachments: true } : {}),
+        },
+    });
+    reportLog({
+        level: 'info',
+        sessionId,
+        wsEvent: 'chat.send.res',
+        metadata: { reqId: req.id, ok: true },
+    });
+    const asyncAttachments = materializedAttachments.attachments;
+    const sendPromise = sendAdapterTurn(session.adapter, materializedAttachments.text, modelId, resolvedReasoningEffort, asyncAttachments, resolvedSystemPrompt, context ? { source: context.source } : undefined);
+    void sendPromise
+        .then(() => {
+        reportLog({
+            level: 'info',
+            sessionId,
+            wsEvent: 'chat.send.done',
+            metadata: { reqId: req.id },
+        });
+    })
+        .catch((err) => {
+        upsertMessage(sessionId, userEnvelope, 'failed');
+        requestSessionIndexPublish(runtime.client);
+        void handleSendFailure(err, false);
+    });
+}
+export async function handleChatAbort(runtime, req) {
+    const { sessionId } = req.params;
+    const session = runtime.sessions.get(sessionId);
+    if (session) {
+        // Revoke the daemon-side Turn capability before waiting for the Agent to
+        // acknowledge interruption. No new Room action may start during stop.
+        revokeManagedRoomContextToken(runtime, session);
+        try {
+            await session.adapter.stop();
+        }
+        catch {
+            runtime.client.sendRes({
+                type: 'res',
+                id: req.id,
+                ok: false,
+                error: 'agent_stop_failed',
+            });
+            return;
+        }
+        emitSyntheticAbort(runtime, sessionId);
+        runtime.activityPublisher?.publish(sessionId, null);
+    }
+    runtime.client.sendRes({ type: 'res', id: req.id, ok: true });
+}