beeos-claw 0.6.50-staging.2 → 0.6.50-staging.3

package/README.md

@@ -38,6 +38,40 @@ The agent initiates an outbound WebSocket connection to the Bridge server (Phone
 
 Requires both `bridge.url` and `bridge.keyFile` to be configured.
 
+## Run Output Routing
+
+Process ownership is separate from protocol adaptation. `index.ts` composes
+the one OpenClaw Gateway source, Agent Projection worker, Agent Mapping
+registry, Message Service client, and output-router policy. For output
+composition, `ACPServer` subscribes to those ports and contributes only the ACP
+adapter; it does not create or stop the process Gateway/Projection and does not
+own Message Service or Agent Mapping state.
+
+Gateway output is normalized once and projected through an immutable,
+run-scoped channel plan. ACP and Message Service implement the same lifecycle:
+`open`, append-only `project` deltas, then one `terminal` operation. Wire-format
+conversion belongs to the channel adapter; ownership and routing never do.
+Run-domain completion is a separate lifecycle port invoked once alongside
+terminal fan-out, so neither channel adapter owns session cleanup.
+
+The channel plan is created only when run ownership is known:
+
+| Run ownership | Output plan |
+|---|---|
+| ACP prompt or internal `agentSend` | ACP |
+| Adopted background run with an originating conversation | ACP + Message Service |
+| Run already owned by interactive Message Service dispatch | ACP observation only; the dispatch remains the single Message Service writer |
+| Cron run | ACP plus the existing dedicated cron delivery path; never the background Message Service adapter |
+
+Projection, upload, terminal, and persisted-message reconciliation require an
+existing route and cannot create or mutate one. Background dual-channel runs
+wait for the matching persisted-message reconciliation revision before
+terminal fan-out. Persistence reconciliation is pending from route creation,
+including runs with no live chunks, and has its own 10-second deadline; upload
+and other async work retain the general settlement budget. A late
+reconciliation after route closure is reported and never reopens an ACP-only
+route.
+
 ## Configuration
 
 Configuration is resolved from three sources in priority order:

package/dist/acp-gateway/acp-run-output-channel.js

@@ -0,0 +1 @@
+import{toAcpRunOutputUpdate}from"./acp-run-output-mapper.js";export class AcpRunOutputChannel{deps;id="acp";constructor(s){this.deps=s}open(s){}project(s,t){this.session(s).sessionLoadInProgress||this.deps.transport.sendSessionUpdate(s.sessionId,toAcpRunOutputUpdate(t),{turnId:s.runId})}async terminal(s,t,e){}session(s){const t=this.deps.state.sessions.get(s.sessionId);if(!t||t.gatewaySessionKey!==s.gatewaySessionKey)throw new Error(`ACP run output session unavailable: ${s.sessionId}`);return t}}

package/dist/acp-gateway/acp-run-output-mapper.js

@@ -0,0 +1 @@
+export function fromAcpRunOutputUpdate(t){const e={...t.timestamp?{timestamp:t.timestamp}:{},...void 0!==t._seq?{sequence:t._seq}:{},...t.messageId?{messageId:String(t.messageId)}:{}};switch(t.sessionUpdate){case"agent_message_chunk":return{type:"assistant_delta",content:t.content,...t.metadata?{metadata:t.metadata}:{},...e};case"agent_thought_chunk":return{type:"thought_chunk",content:t.content,...e};case"tool_call":return{type:"tool_call",toolCallId:String(t.toolCallId),title:t.title,...t.name?{name:t.name}:{},...t.kind?{toolKind:t.kind}:{},status:t.status,...void 0!==t.arguments?{arguments:t.arguments}:{},...void 0!==t.rawInput?{rawInput:t.rawInput}:{},...void 0!==t.output?{output:t.output}:{},...void 0!==t.content?{content:t.content}:{},...e};case"tool_call_update":return{type:"tool_call_update",toolCallId:String(t.toolCallId),...t.name?{name:t.name}:{},...t.title?{title:t.title}:{},...t.kind?{toolKind:t.kind}:{},status:t.status,...void 0!==t.output?{output:t.output}:{},...void 0!==t.result?{result:t.result}:{},...void 0!==t.text?{text:t.text}:{},...void 0!==t.content?{content:t.content}:{},...void 0!==t.rawOutput?{rawOutput:t.rawOutput}:{},...e};default:return}}export function toAcpRunOutputUpdate(t){const e={...t.timestamp?{timestamp:t.timestamp}:{},...void 0!==t.sequence?{_seq:t.sequence}:{},...t.messageId?{messageId:t.messageId}:{}};switch(t.type){case"assistant_delta":return{sessionUpdate:"agent_message_chunk",content:t.content,...t.metadata?{metadata:t.metadata}:{},...e};case"thought_chunk":return{sessionUpdate:"agent_thought_chunk",content:t.content,...e};case"tool_call":return{sessionUpdate:"tool_call",toolCallId:t.toolCallId,title:t.title,...t.name?{name:t.name}:{},...t.toolKind?{kind:t.toolKind}:{},status:t.status,...void 0!==t.arguments?{arguments:t.arguments}:{},...void 0!==t.rawInput?{rawInput:t.rawInput}:{},...void 0!==t.output?{output:t.output}:{},...void 0!==t.content?{content:t.content}:{},...e};case"tool_call_update":return{sessionUpdate:"tool_call_update",toolCallId:t.toolCallId,...t.name?{name:t.name}:{},...t.title?{title:t.title}:{},...t.toolKind?{kind:t.toolKind}:{},status:t.status,...void 0!==t.output?{output:t.output}:{},...void 0!==t.result?{result:t.result}:{},...void 0!==t.text?{text:t.text}:{},...void 0!==t.content?{content:t.content}:{},...void 0!==t.rawOutput?{rawOutput:t.rawOutput}:{},...e}}}