beeos-claw 0.5.36 → 0.5.38

package/dist/a2a/tools.js

@@ -1 +1 @@
-import{agentFetch}from"../agent-auth.js";import{resolveAgentIdFromMentions}from"../delegation/mention-resolver.js";async function a2aFetch(t,e,a){const n=`${t.agentGatewayUrl}${e}`;return t.agentKeys?agentFetch(n,t.agentKeys,a):fetch(n,a)}export{a2aFetch};function normalizeState(t){if(!t)return"";const e=t.toLowerCase();return{task_state_submitted:"submitted",task_state_delivered:"submitted",task_state_working:"working",task_state_completed:"completed",task_state_failed:"failed",task_state_timeout:"timeout",task_state_canceled:"canceled",task_state_rejected:"rejected",task_state_input_required:"input-required",task_state_auth_required:"auth-required"}[e]??e}function unwrapTask(t){if(!t||"object"!=typeof t)return;const e=t,a=e.task;return a&&"object"==typeof a?a:e}function extractArtifactText(t){const e=t?.artifacts;if(!e)return;return e.flatMap(t=>t.parts??[]).filter(t=>"string"==typeof t.text&&(void 0===t.kind||"text"===t.kind)).map(t=>t.text).join("\n")||void 0}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function stringValue(t){return"string"==typeof t&&""!==t?t:void 0}function normalizeArtifactFilePart(t){const e=stringValue(t.kind),a=isRecord(t.file)?t.file:void 0;let n=stringValue(t.url),s=stringValue(t.filename),r=stringValue(t.mediaType);if(a&&(n=stringValue(a.uri)??stringValue(a.url)??n,s=stringValue(a.name)??stringValue(a.filename)??s,r=stringValue(a.mimeType)??stringValue(a.mediaType)??r),n&&(!e||"file"===e))return{uri:n,...s?{name:s}:{},...r?{mimeType:r}:{}}}function extractArtifactFiles(t){const e=t?.artifacts;if(!e)return;const a=[];for(const t of e){const e=t.parts;if(Array.isArray(e))for(const t of e){if(!isRecord(t))continue;const e=normalizeArtifactFilePart(t);e&&a.push(e)}}return a.length>0?a:void 0}function extractStatusText(t){const e=t?.status,a=e?.message?.parts,n=a?.[0]?.text;return"string"==typeof n?n:void 0}function taskState(t){return normalizeState(t?.status?.state)}const TERMINAL_FAILURE_STATES=new Set(["failed","timeout","canceled","rejected"]);function taskContextId(t){const e=t?.contextId;return"string"==typeof e&&""!==e?e:void 0}function buildTaskPayload(t,e,a){const n=taskState(t),s=extractArtifactText(t),r=extractArtifactFiles(t),i=extractStatusText(t),o=taskContextId(t),c={status:n,is_terminal:"completed"===n||TERMINAL_FAILURE_STATES.has(n)};return e&&(c.task_id=e),a&&(c.agent_id=a),o&&(c.context_id=o),s?c.result=s:i&&(c.error=i),r&&(c.files=r),c}export{unwrapTask,extractArtifactText,extractArtifactFiles,extractStatusText,taskState,taskContextId,normalizeState,buildTaskPayload};export class TaskHandleRegistry{seq=0;handles=new Map;taskIdToHandle=new Map;create(t,e,a,n){const s="bth_"+ ++this.seq;return this.handles.set(s,{taskId:t,agentId:e,contextId:a,sessionKey:n}),this.taskIdToHandle.set(t,s),s}resolveTaskId(t){const e=this.handles.get(t);return e?e.taskId:t}resolveAgentId(t){const e=this.handles.get(t);if(e)return e.agentId;const a=this.taskIdToHandle.get(t);return a?this.handles.get(a)?.agentId:void 0}}const defaultRegistry=new TaskHandleRegistry;export function registerA2ATools(t,e,a=defaultRegistry,n,s,r,i){t.registerTool({name:"beeos_discover_agents",description:"List agents available for A2A collaboration. When called without a query, returns all visible agents (your own agents + public agents). When called with a query, filters by name, description, or skill. Results include an `isSelf` flag marking the agent that represents the current instance (do not call yourself). Each result includes `instanceName` (human-readable device/instance label) when available.",parameters:{type:"object",properties:{query:{type:"string",description:"Optional keyword to filter agents by name, description, or skill. Omit to list all agents."}},required:[]},async execute(t,a,n){const{query:s}=a??{};try{const t=new URLSearchParams({limit:"50"});s&&t.set("query",s);const a=await a2aFetch(e,`/api/v1/a2a/discover?${t}`,{signal:n});if(!a.ok)return{content:JSON.stringify({error:`discover failed: ${a.status}`})};const r=await a.json(),o=i?.();if(o&&Array.isArray(r?.data))for(const t of r.data)t.isSelf=t.instance_id===o;return{content:JSON.stringify(r,null,2)}}catch(t){if(n?.aborted)throw t;return{content:JSON.stringify({error:t instanceof Error?t.message:String(t)})}}}}),t.registerTool({name:"beeos_call_agent",description:"Ask another agent to perform a task. This creates the task ASYNCHRONOUSLY and returns immediately with a handle ({ task_id, agent_id, context_id, status }) — it does NOT wait for the result. To fetch the agent's reply, call beeos_get_task with the returned task_id (and agent_id). Do NOT call beeos_call_agent again to poll an existing task — that creates a brand-new task.",parameters:{type:"object",properties:{agentId:{type:"string",description:"The target agent UUID (e.g. d04080d1-...) or display name. Prefer the UUID from discover results or @mention metadata when available."},message:{type:"string",description:"The task description or message to send to the agent"},taskId:{type:"string",description:"Optional existing task ID to continue a multi-turn conversation. When provided, the message is appended to the existing task instead of creating a new one."},files:{type:"array",items:{type:"string"},description:"Optional file URLs to include with the request"},contextId:{type:"string",description:"Optional context ID for multi-turn conversations with the same agent"},timeoutMs:{type:"number",description:"Server-side task timeout in milliseconds (how long the target agent may run before the task is timed out). Defaults to 600000 (10 minutes). This is NOT a client wait time — beeos_call_agent returns immediately regardless."}},required:["agentId","message"]},async execute(t,i,o){let{agentId:c,message:d,files:l,contextId:u,timeoutMs:g,taskId:f}=i;const h=n?.(t),p=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;if(!p.test(c)){const a=s?.(t);if(a?.length){const t=resolveAgentIdFromMentions(a,c);t&&(e.logger.info?.(`beeos_call_agent: resolved "${c}" → ${t} via mention context`),c=t)}if(!p.test(c))try{const t=await a2aFetch(e,`/api/v1/a2a/discover?query=${encodeURIComponent(c)}&limit=10`,{signal:o});if(t.ok){const a=await t.json(),n=a?.data??[],s=c.toLowerCase(),r=n.find(t=>t.name.toLowerCase()===s)??n.find(t=>t.name.toLowerCase().includes(s));if(!r)return{content:JSON.stringify({error:`Could not resolve agent name "${c}". Available agents: ${n.map(t=>`${t.name} (${t.id})`).join(", ")||"none"}`})};e.logger.info?.(`beeos_call_agent: resolved "${c}" → ${r.id} (${r.name}) via discover`),c=r.id}}catch{}}const m=u||(h?`session:${h}`:""),y=g||6e5;try{const t={jsonrpc:"2.0",id:`claw-${Date.now()}`,method:"SendMessage",params:{message:{role:"user",parts:[{text:d}],...m?{contextId:m}:{},...f?{taskId:f}:{}},configuration:{timeoutMs:y}}},n=`/api/v1/a2a/${encodeURIComponent(c)}`,s=AbortSignal.timeout(3e4),i=o?AbortSignal.any([o,s]):s,l=await a2aFetch(e,n,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t),signal:i}),g=await l.text();let p;try{p=JSON.parse(g)}catch{p={}}if(!l.ok||p.error){if(401===l.status||403===l.status){const t=p.error??{};-32600===t.code&&r&&r("_beeos/auth_required",{type:"auth_required",target_agent_id:c,target_agent_name:c,title:"Authentication Required",content:`Agent **${c}** requires authentication.`})}const t=p.error?JSON.stringify(p.error):g;return{content:JSON.stringify({error:`send task failed: ${l.status} ${t}`,agent_id:c})}}const k=unwrapTask(p.result),_=k?.id;return _?(a.create(_,c,u,h),{content:JSON.stringify({status:taskState(k)||"working",task_id:_,agent_id:c,context_id:taskContextId(k)??m??void 0,message:`Task created. Call beeos_get_task with task_id "${_}" (and agent_id "${c}") to fetch status and result.`})}):{content:JSON.stringify({error:"task created but server returned no task_id",agent_id:c})}}catch(t){if(o?.aborted)throw t;return t instanceof DOMException&&"TimeoutError"===t.name?{content:JSON.stringify({error:"create task request timed out after 30000ms",agent_id:c})}:{content:JSON.stringify({error:t instanceof Error?t.message:String(t),agent_id:c})}}}}),t.registerTool({name:"beeos_get_task",description:'Fetch the current state AND data of an existing A2A task by its task_id. Use this to check on a task that beeos_call_agent created (it returns status "working" with a task_id), or to re-read a finished task. Always returns a JSON object { status, task_id, agent_id, context_id, is_terminal, result?, files?, error? }: `result` holds the produced output (present whenever the device produced output, EVEN for timeout/canceled/failed tasks that still produced content); `files` contains structured file artifacts ({uri,name,mimeType}). The runtime displays image files in Canvas when Canvas is active, otherwise as chat attachments. Do not output MEDIA:, and do not upload/fetch/browser/shell files[].uri for display. Use beeos_fetch_file only for local byte analysis. `error` holds the failure reason when there is no produced output; `is_terminal` indicates whether the task has reached a final state. Do NOT call beeos_call_agent again to re-query an existing task — that creates a brand-new task.',parameters:{type:"object",properties:{taskId:{type:"string",description:"The task ID returned by a previous beeos_call_agent call."},agentId:{type:"string",description:"The target agent UUID that owns the task (the same agentId passed to beeos_call_agent). Optional when the task was created earlier in this session — it is resolved automatically."}},required:["taskId"]},async execute(t,n,s){const{taskId:r,agentId:i}=n??{};if(!r)return{content:JSON.stringify({error:"taskId is required"})};const o=i||a.resolveAgentId(r);if(!o)return{content:JSON.stringify({error:`agentId is required to query task "${r}" (it was not created in this session, so the target agent is unknown). Pass the agentId you originally called.`,task_id:r})};try{const t=`/api/v1/a2a/${encodeURIComponent(o)}`,a=await a2aFetch(e,t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:`claw-get-${Date.now()}`,method:"GetTask",params:{id:r}}),signal:s}),n=await a.text();let i;try{i=JSON.parse(n)}catch{i={}}if(!a.ok||i.error){const t=i.error?JSON.stringify(i.error):n;return{content:JSON.stringify({error:`get task failed: ${a.status} ${t}`,task_id:r,agent_id:o})}}const c=unwrapTask(i.result);return{content:JSON.stringify(buildTaskPayload(c,r,o))}}catch(t){if(s?.aborted)throw t;return{content:JSON.stringify({error:t instanceof Error?t.message:String(t),task_id:r,agent_id:o})}}}})}
+import{agentFetch}from"../agent-auth.js";import{resolveAgentIdFromMentions}from"../delegation/mention-resolver.js";async function a2aFetch(t,e,a){const n=`${t.agentGatewayUrl}${e}`;return t.agentKeys?agentFetch(n,t.agentKeys,a):fetch(n,a)}export{a2aFetch};function normalizeState(t){if(!t)return"";const e=t.toLowerCase();return{task_state_submitted:"submitted",task_state_delivered:"submitted",task_state_working:"working",task_state_completed:"completed",task_state_failed:"failed",task_state_timeout:"timeout",task_state_canceled:"canceled",task_state_rejected:"rejected",task_state_input_required:"input-required",task_state_auth_required:"auth-required"}[e]??e}function unwrapTask(t){if(!t||"object"!=typeof t)return;const e=t,a=e.task;return a&&"object"==typeof a?a:e}function extractArtifactText(t){const e=t?.artifacts;if(!e)return;return e.flatMap(t=>t.parts??[]).filter(t=>"string"==typeof t.text&&(void 0===t.kind||"text"===t.kind)).map(t=>t.text).join("\n")||void 0}function isRecord(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function stringValue(t){return"string"==typeof t&&""!==t?t:void 0}function normalizeArtifactFilePart(t){const e=stringValue(t.kind),a=isRecord(t.file)?t.file:void 0;let n=stringValue(t.url),s=stringValue(t.filename),r=stringValue(t.mediaType);if(a&&(n=stringValue(a.uri)??stringValue(a.url)??n,s=stringValue(a.name)??stringValue(a.filename)??s,r=stringValue(a.mimeType)??stringValue(a.mediaType)??r),n&&(!e||"file"===e))return{uri:n,...s?{name:s}:{},...r?{mimeType:r}:{}}}function extractArtifactFiles(t){const e=t?.artifacts;if(!e)return;const a=[];for(const t of e){const e=t.parts;if(Array.isArray(e))for(const t of e){if(!isRecord(t))continue;const e=normalizeArtifactFilePart(t);e&&a.push(e)}}return a.length>0?a:void 0}function extractStatusText(t){const e=t?.status,a=e?.message?.parts,n=a?.[0]?.text;return"string"==typeof n?n:void 0}function taskState(t){return normalizeState(t?.status?.state)}const TERMINAL_FAILURE_STATES=new Set(["failed","timeout","canceled","rejected"]);function taskContextId(t){const e=t?.contextId;return"string"==typeof e&&""!==e?e:void 0}function buildTaskPayload(t,e,a){const n=taskState(t),s=extractArtifactText(t),r=extractArtifactFiles(t),i=extractStatusText(t),o=taskContextId(t),c={status:n,is_terminal:"completed"===n||TERMINAL_FAILURE_STATES.has(n)};return e&&(c.task_id=e),a&&(c.agent_id=a),o&&(c.context_id=o),s?c.result=s:i&&(c.error=i),r&&(c.files=r),c}export{unwrapTask,extractArtifactText,extractArtifactFiles,extractStatusText,taskState,taskContextId,normalizeState,buildTaskPayload};export class TaskHandleRegistry{seq=0;handles=new Map;taskIdToHandle=new Map;create(t,e,a,n){const s="bth_"+ ++this.seq;return this.handles.set(s,{taskId:t,agentId:e,contextId:a,sessionKey:n}),this.taskIdToHandle.set(t,s),s}resolveTaskId(t){const e=this.handles.get(t);return e?e.taskId:t}resolveAgentId(t){const e=this.handles.get(t);if(e)return e.agentId;const a=this.taskIdToHandle.get(t);return a?this.handles.get(a)?.agentId:void 0}}const defaultRegistry=new TaskHandleRegistry;export function registerA2ATools(t,e,a=defaultRegistry,n,s,r,i){t.registerTool({name:"beeos_discover_agents",description:"List agents available for A2A collaboration. When called without a query, returns all visible agents (your own agents + public agents). When called with a query, filters by name, description, or skill. Results include an `isSelf` flag marking the agent that represents the current instance (do not call yourself). Each result includes `instanceName` (human-readable device/instance label) when available.",parameters:{type:"object",properties:{query:{type:"string",description:"Optional keyword to filter agents by name, description, or skill. Omit to list all agents."}},required:[]},async execute(t,a,n){const{query:s}=a??{};try{const t=new URLSearchParams({limit:"50"});s&&t.set("query",s);const a=await a2aFetch(e,`/api/v1/a2a/discover?${t}`,{signal:n});if(!a.ok)return{content:JSON.stringify({error:`discover failed: ${a.status}`})};const r=await a.json(),o=i?.();if(o&&Array.isArray(r?.data))for(const t of r.data)t.isSelf=t.instance_id===o;return{content:JSON.stringify(r,null,2)}}catch(t){if(n?.aborted)throw t;return{content:JSON.stringify({error:t instanceof Error?t.message:String(t)})}}}}),t.registerTool({name:"beeos_call_agent",description:"Ask another agent to perform a task. This creates the task ASYNCHRONOUSLY and returns immediately with a handle ({ task_id, agent_id, context_id, status }) — it does NOT wait for the result. To fetch the agent's reply, call beeos_get_task with the returned task_id (and agent_id). Do NOT call beeos_call_agent again to poll an existing task — that creates a brand-new task.",parameters:{type:"object",properties:{agentId:{type:"string",description:"The target agent UUID (e.g. d04080d1-...) or display name. Prefer the UUID from discover results or @mention metadata when available."},message:{type:"string",description:"The task description or message to send to the agent"},taskId:{type:"string",description:"Optional existing task ID to continue a multi-turn conversation. When provided, the message is appended to the existing task instead of creating a new one."},files:{type:"array",items:{type:"string"},description:"Optional file URLs to include with the request"},contextId:{type:"string",description:"Optional context ID for multi-turn conversations with the same agent"},timeoutMs:{type:"number",description:"Server-side task timeout in milliseconds (how long the target agent may run before the task is timed out). Defaults to 600000 (10 minutes). This is NOT a client wait time — beeos_call_agent returns immediately regardless."}},required:["agentId","message"]},async execute(t,i,o){let{agentId:c,message:d,files:l,contextId:u,timeoutMs:g,taskId:f}=i;const h=n?.(t),p=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;if(!p.test(c)){const a=s?.(t);if(a?.length){const t=resolveAgentIdFromMentions(a,c);t&&(e.logger.info?.(`beeos_call_agent: resolved "${c}" → ${t} via mention context`),c=t)}if(!p.test(c))try{const t=await a2aFetch(e,`/api/v1/a2a/discover?query=${encodeURIComponent(c)}&limit=10`,{signal:o});if(t.ok){const a=await t.json(),n=a?.data??[],s=c.toLowerCase(),r=n.find(t=>t.name.toLowerCase()===s)??n.find(t=>t.name.toLowerCase().includes(s));if(!r)return{content:JSON.stringify({error:`Could not resolve agent name "${c}". Available agents: ${n.map(t=>`${t.name} (${t.id})`).join(", ")||"none"}`})};e.logger.info?.(`beeos_call_agent: resolved "${c}" → ${r.id} (${r.name}) via discover`),c=r.id}}catch{}}const m=u||(h?`session:${h}`:""),y=g||6e5;try{const t={jsonrpc:"2.0",id:`claw-${Date.now()}`,method:"SendMessage",params:{message:{role:"user",parts:[{text:d}],...m?{contextId:m}:{},...f?{taskId:f}:{}},configuration:{timeoutMs:y}}},n=`/api/v1/a2a/${encodeURIComponent(c)}`,s=AbortSignal.timeout(3e4),i=o?AbortSignal.any([o,s]):s,l=await a2aFetch(e,n,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t),signal:i}),g=await l.text();let p;try{p=JSON.parse(g)}catch{p={}}if(!l.ok||p.error){if(401===l.status||403===l.status){const t=p.error??{};-32600===t.code&&r&&r("_beeos/auth_required",{type:"auth_required",target_agent_id:c,target_agent_name:c,title:"Authentication Required",content:`Agent **${c}** requires authentication.`})}const t=p.error?JSON.stringify(p.error):g;return{content:JSON.stringify({error:`send task failed: ${l.status} ${t}`,agent_id:c})}}const k=unwrapTask(p.result),_=k?.id;return _?(a.create(_,c,u,h),{content:JSON.stringify({status:taskState(k)||"working",task_id:_,agent_id:c,context_id:taskContextId(k)??m??void 0,message:`Task created. Call beeos_get_task with task_id "${_}" (and agent_id "${c}") to fetch status and result.`})}):{content:JSON.stringify({error:"task created but server returned no task_id",agent_id:c})}}catch(t){if(o?.aborted)throw t;return t instanceof DOMException&&"TimeoutError"===t.name?{content:JSON.stringify({error:"create task request timed out after 30000ms",agent_id:c})}:{content:JSON.stringify({error:t instanceof Error?t.message:String(t),agent_id:c})}}}}),t.registerTool({name:"beeos_get_task",description:'Fetch the current state AND data of an existing A2A task by its task_id. Use this to check on a task that beeos_call_agent created (it returns status "working" with a task_id), or to re-read a finished task. Always returns a JSON object { status, task_id, agent_id, context_id, is_terminal, result?, files?, error? }: `result` holds the produced output (present whenever the device produced output, EVEN for timeout/canceled/failed tasks that still produced content); `files` contains structured file artifacts ({uri,name,mimeType}). Do not output MEDIA:, and do not upload/fetch/browser/shell files[].uri for display. Use beeos_fetch_file only for local byte analysis. `error` holds the failure reason when there is no produced output; `is_terminal` indicates whether the task has reached a final state. Do NOT call beeos_call_agent again to re-query an existing task — that creates a brand-new task.',parameters:{type:"object",properties:{taskId:{type:"string",description:"The task ID returned by a previous beeos_call_agent call."},agentId:{type:"string",description:"The target agent UUID that owns the task (the same agentId passed to beeos_call_agent). Optional when the task was created earlier in this session — it is resolved automatically."}},required:["taskId"]},async execute(t,n,s){const{taskId:r,agentId:i}=n??{};if(!r)return{content:JSON.stringify({error:"taskId is required"})};const o=i||a.resolveAgentId(r);if(!o)return{content:JSON.stringify({error:`agentId is required to query task "${r}" (it was not created in this session, so the target agent is unknown). Pass the agentId you originally called.`,task_id:r})};try{const t=`/api/v1/a2a/${encodeURIComponent(o)}`,a=await a2aFetch(e,t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",id:`claw-get-${Date.now()}`,method:"GetTask",params:{id:r}}),signal:s}),n=await a.text();let i;try{i=JSON.parse(n)}catch{i={}}if(!a.ok||i.error){const t=i.error?JSON.stringify(i.error):n;return{content:JSON.stringify({error:`get task failed: ${a.status} ${t}`,task_id:r,agent_id:o})}}const c=unwrapTask(i.result);return{content:JSON.stringify(buildTaskPayload(c,r,o))}}catch(t){if(s?.aborted)throw t;return{content:JSON.stringify({error:t instanceof Error?t.message:String(t),task_id:r,agent_id:o})}}}})}

package/dist/a2a/tools.test.js

@@ -1 +1 @@
-import{describe,it,expect,vi,afterEach}from"vitest";import{registerA2ATools,TaskHandleRegistry,unwrapTask,extractArtifactText,extractArtifactFiles,extractStatusText,taskState,buildTaskPayload}from"./tools.js";const AGENT_ID="d04080d1-1111-2222-3333-444455556666";function makeCfg(){return{agentGatewayUrl:"https://gw.test",agentKeys:null,logger:{info:vi.fn(),warn:vi.fn(),error:vi.fn(),debug:vi.fn()}}}function registerTools(t,e=new TaskHandleRegistry){const s=new Map;return registerA2ATools({registerTool:t=>s.set(t.name,t)},t,e),s}function jsonResponse(t,e=!0,s=200){const a=JSON.stringify(t);return{ok:e,status:s,text:async()=>a,json:async()=>JSON.parse(a)}}describe("unwrapTask",()=>{it("unwraps the v1.0 SendMessage { task } envelope",()=>{const t=unwrapTask({task:{id:"t1",status:{state:"TASK_STATE_WORKING"}}});expect(t?.id).toBe("t1")}),it("returns the bare task for v0.3 / GetTask results",()=>{const t=unwrapTask({id:"t2",status:{state:"working"}});expect(t?.id).toBe("t2")}),it("returns undefined for non-object input",()=>{expect(unwrapTask(void 0)).toBeUndefined(),expect(unwrapTask("nope")).toBeUndefined()})}),describe("extractArtifactText",()=>{it("reads v1.0 text parts ({ text } without kind)",()=>{expect(extractArtifactText({artifacts:[{parts:[{text:"hello"},{text:"world"}]}]})).toBe("hello\nworld")}),it("reads v0.3 text parts ({ kind: 'text', text })",()=>{expect(extractArtifactText({artifacts:[{parts:[{kind:"text",text:"hi"}]}]})).toBe("hi")}),it("skips non-text parts (e.g. file/data)",()=>{expect(extractArtifactText({artifacts:[{parts:[{kind:"file",url:"u"},{text:"kept"}]}]})).toBe("kept")}),it("returns undefined when there are no artifacts",()=>{expect(extractArtifactText({status:{state:"working"}})).toBeUndefined(),expect(extractArtifactText(void 0)).toBeUndefined()})}),describe("extractArtifactFiles",()=>{it("reads v1.0 flat file parts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{url:"beeos-file://file-1",filename:"screenshot.jpeg",mediaType:"image/jpeg"}]}]})).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}])}),it("reads v0.3 nested file parts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{kind:"file",file:{uri:"beeos-file://file-2",name:"capture.png",mimeType:"image/png"}}]}]})).toEqual([{uri:"beeos-file://file-2",name:"capture.png",mimeType:"image/png"}])}),it("does not infer files from text-only beeos-file URI artifacts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{text:"beeos-file://file-3"}]}]})).toBeUndefined()})}),describe("extractStatusText",()=>{it("reads the agent status message text",()=>{expect(extractStatusText({status:{message:{parts:[{text:"boom"}]}}})).toBe("boom")}),it("returns undefined when no status message",()=>{expect(extractStatusText({status:{}})).toBeUndefined()})}),describe("taskState",()=>{it("normalizes v1.0 SCREAMING_SNAKE states",()=>{expect(taskState({status:{state:"TASK_STATE_COMPLETED"}})).toBe("completed"),expect(taskState({status:{state:"TASK_STATE_WORKING"}})).toBe("working")}),it("passes through v0.3 lowercase states",()=>{expect(taskState({status:{state:"failed"}})).toBe("failed")})}),describe("buildTaskPayload",()=>{it("surfaces produced content with the terminal state (canceled with artifact)",()=>{expect(buildTaskPayload({contextId:"ctx-1",status:{state:"TASK_STATE_CANCELED"},artifacts:[{parts:[{text:"partial work"}]}]},"t1","agent-1")).toEqual({status:"canceled",task_id:"t1",agent_id:"agent-1",context_id:"ctx-1",is_terminal:!0,result:"partial work"})}),it("reports status-message text as error when there is no artifact",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_FAILED",message:{parts:[{text:"boom"}]}}},"t2","agent-2")).toEqual({status:"failed",task_id:"t2",agent_id:"agent-2",is_terminal:!0,error:"boom"})}),it("marks a working task as non-terminal with neither result nor error",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_WORKING"}},"t3","agent-3")).toEqual({status:"working",task_id:"t3",agent_id:"agent-3",is_terminal:!1})}),it("includes result for a completed task",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"the answer"}]}]},"t4","agent-4")).toEqual({status:"completed",task_id:"t4",agent_id:"agent-4",is_terminal:!0,result:"the answer"})}),it("returns result text and structured files together",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"beeos-file://file-1"},{url:"beeos-file://file-1",filename:"screenshot.jpeg",mediaType:"image/jpeg"}]}]},"t5","agent-5")).toEqual({status:"completed",task_id:"t5",agent_id:"agent-5",is_terminal:!0,result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]})}),it("does not turn text-only beeos-file URI results into files",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"beeos-file://file-only-text"}]}]},"t6","agent-6")).toEqual({status:"completed",task_id:"t6",agent_id:"agent-6",is_terminal:!0,result:"beeos-file://file-only-text"})})}),describe("beeos_call_agent async create",()=>{afterEach(()=>{vi.unstubAllGlobals()}),it("creates the task and returns the handle (task_id, agent_id, context_id) without polling or task data",async()=>{const t=[],e=vi.fn(async(e,s)=>{const a=s?.body?JSON.parse(s.body):{};if(t.push({url:e,method:s?.method,rpcMethod:a.method}),"SendMessage"===a.method)return jsonResponse({jsonrpc:"2.0",id:a.id,result:{task:{id:"task-async-1",contextId:"c1",status:{state:"TASK_STATE_WORKING"}}}});throw new Error(`unexpected request method: ${a.method}`)});vi.stubGlobal("fetch",e);const s=registerTools(makeCfg()).get("beeos_call_agent"),a=await s.execute("tc-1",{agentId:AGENT_ID,message:"do it"}),o=JSON.parse(a.content);expect(o.status).toBe("working"),expect(o.task_id).toBe("task-async-1"),expect(o.agent_id).toBe(AGENT_ID),expect(o.context_id).toBe("c1"),expect(o.result).toBeUndefined(),expect(t).toHaveLength(1),expect(t[0].rpcMethod).toBe("SendMessage"),expect(t[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`)}),it("registers the task so beeos_get_task can resolve the agent id",async()=>{const t=vi.fn(async(t,e)=>{const s=e?.body?JSON.parse(e.body):{};return"SendMessage"===s.method?jsonResponse({jsonrpc:"2.0",id:s.id,result:{task:{id:"task-reg-1",status:{state:"TASK_STATE_WORKING"}}}}):jsonResponse({jsonrpc:"2.0",id:s.id,result:{id:"task-reg-1",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"done"}]}]}})});vi.stubGlobal("fetch",t);const e=new TaskHandleRegistry,s=registerTools(makeCfg(),e);await s.get("beeos_call_agent").execute("tc",{agentId:AGENT_ID,message:"do it"});const a=await s.get("beeos_get_task").execute("tc",{taskId:"task-reg-1"}),o=JSON.parse(a.content);expect(o.status).toBe("completed"),expect(o.result).toBe("done"),expect(o.agent_id).toBe(AGENT_ID)}),it("returns an error handle (with agent_id, no task_id) when create fails",async()=>{const t=vi.fn(async(t,e)=>jsonResponse({jsonrpc:"2.0",id:(e?.body?JSON.parse(e.body):{}).id,error:{code:-32e3,message:"boom"}},!1,500));vi.stubGlobal("fetch",t);const e=registerTools(makeCfg()).get("beeos_call_agent"),s=await e.execute("tc",{agentId:AGENT_ID,message:"do it"}),a=JSON.parse(s.content);expect(a.error).toContain("send task failed"),expect(a.agent_id).toBe(AGENT_ID),expect(a.task_id).toBeUndefined()})}),describe("beeos_get_task",()=>{function t(t){const e=[],s=vi.fn(async(s,a)=>{const o=a?.body?JSON.parse(a.body):{};if(e.push({url:s,method:a?.method,rpcMethod:o.method,params:o.params}),"GetTask"!==o.method)throw new Error(`unexpected method: ${o.method}`);return jsonResponse({jsonrpc:"2.0",id:o.id,result:t})});return vi.stubGlobal("fetch",s),e}afterEach(()=>{vi.unstubAllGlobals()}),it("describes structured files as runtime-presented artifacts, not Markdown or MEDIA",()=>{const t=registerTools(makeCfg()).get("beeos_get_task").description??"";expect(t).toContain("runtime displays image files"),expect(t).toContain("chat attachments"),expect(t).toContain("Do not output MEDIA:"),expect(t).not.toContain("![")}),it("returns the data of a completed task and queries the right endpoint",async()=>{const e=t({id:"task-1",contextId:"ctx-1",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"the answer"}]}]}),s=registerTools(makeCfg()).get("beeos_get_task"),a=await s.execute("tc",{taskId:"task-1",agentId:AGENT_ID}),o=JSON.parse(a.content);expect(o.status).toBe("completed"),expect(o.task_id).toBe("task-1"),expect(o.agent_id).toBe(AGENT_ID),expect(o.context_id).toBe("ctx-1"),expect(o.is_terminal).toBe(!0),expect(o.result).toBe("the answer"),expect(e).toHaveLength(1),expect(e[0].method).toBe("POST"),expect(e[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`),expect(e[0].params.id).toBe("task-1")}),it("surfaces partial output AND the terminal state for a canceled task that still produced an artifact",async()=>{t({id:"task-cx",status:{state:"TASK_STATE_CANCELED"},artifacts:[{parts:[{text:"partial plan"}]}]});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-cx",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.status).toBe("canceled"),expect(a.task_id).toBe("task-cx"),expect(a.result).toBe("partial plan")}),it("returns an error for a terminal task with no produced content",async()=>{t({id:"task-to",status:{state:"TASK_STATE_FAILED",message:{parts:[{text:"boom"}]}}});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-to",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.error).toBe("boom"),expect(a.task_id).toBe("task-to")}),it("reports a still-running task as working",async()=>{t({id:"task-w",status:{state:"TASK_STATE_WORKING"}});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-w",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.status).toBe("working"),expect(a.task_id).toBe("task-w")}),it("resolves agentId from the session registry when omitted",async()=>{const e=new TaskHandleRegistry;e.create("task-reg",AGENT_ID);const s=t({id:"task-reg",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"ok"}]}]}),a=registerTools(makeCfg(),e).get("beeos_get_task"),o=await a.execute("tc",{taskId:"task-reg"}),r=JSON.parse(o.content);expect(r.status).toBe("completed"),expect(r.result).toBe("ok"),expect(r.agent_id).toBe(AGENT_ID),expect(s[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`)}),it("errors when agentId is neither passed nor resolvable",async()=>{const t=vi.fn();vi.stubGlobal("fetch",t);const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"unknown-task"}),a=JSON.parse(s.content);expect(a.error).toContain("agentId is required"),expect(t).not.toHaveBeenCalled()})});
+import{describe,it,expect,vi,afterEach}from"vitest";import{registerA2ATools,TaskHandleRegistry,unwrapTask,extractArtifactText,extractArtifactFiles,extractStatusText,taskState,buildTaskPayload}from"./tools.js";const AGENT_ID="d04080d1-1111-2222-3333-444455556666";function makeCfg(){return{agentGatewayUrl:"https://gw.test",agentKeys:null,logger:{info:vi.fn(),warn:vi.fn(),error:vi.fn(),debug:vi.fn()}}}function registerTools(t,e=new TaskHandleRegistry){const s=new Map;return registerA2ATools({registerTool:t=>s.set(t.name,t)},t,e),s}function jsonResponse(t,e=!0,s=200){const a=JSON.stringify(t);return{ok:e,status:s,text:async()=>a,json:async()=>JSON.parse(a)}}describe("unwrapTask",()=>{it("unwraps the v1.0 SendMessage { task } envelope",()=>{const t=unwrapTask({task:{id:"t1",status:{state:"TASK_STATE_WORKING"}}});expect(t?.id).toBe("t1")}),it("returns the bare task for v0.3 / GetTask results",()=>{const t=unwrapTask({id:"t2",status:{state:"working"}});expect(t?.id).toBe("t2")}),it("returns undefined for non-object input",()=>{expect(unwrapTask(void 0)).toBeUndefined(),expect(unwrapTask("nope")).toBeUndefined()})}),describe("extractArtifactText",()=>{it("reads v1.0 text parts ({ text } without kind)",()=>{expect(extractArtifactText({artifacts:[{parts:[{text:"hello"},{text:"world"}]}]})).toBe("hello\nworld")}),it("reads v0.3 text parts ({ kind: 'text', text })",()=>{expect(extractArtifactText({artifacts:[{parts:[{kind:"text",text:"hi"}]}]})).toBe("hi")}),it("skips non-text parts (e.g. file/data)",()=>{expect(extractArtifactText({artifacts:[{parts:[{kind:"file",url:"u"},{text:"kept"}]}]})).toBe("kept")}),it("returns undefined when there are no artifacts",()=>{expect(extractArtifactText({status:{state:"working"}})).toBeUndefined(),expect(extractArtifactText(void 0)).toBeUndefined()})}),describe("extractArtifactFiles",()=>{it("reads v1.0 flat file parts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{url:"beeos-file://file-1",filename:"screenshot.jpeg",mediaType:"image/jpeg"}]}]})).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}])}),it("reads v0.3 nested file parts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{kind:"file",file:{uri:"beeos-file://file-2",name:"capture.png",mimeType:"image/png"}}]}]})).toEqual([{uri:"beeos-file://file-2",name:"capture.png",mimeType:"image/png"}])}),it("does not infer files from text-only beeos-file URI artifacts",()=>{expect(extractArtifactFiles({artifacts:[{parts:[{text:"beeos-file://file-3"}]}]})).toBeUndefined()})}),describe("extractStatusText",()=>{it("reads the agent status message text",()=>{expect(extractStatusText({status:{message:{parts:[{text:"boom"}]}}})).toBe("boom")}),it("returns undefined when no status message",()=>{expect(extractStatusText({status:{}})).toBeUndefined()})}),describe("taskState",()=>{it("normalizes v1.0 SCREAMING_SNAKE states",()=>{expect(taskState({status:{state:"TASK_STATE_COMPLETED"}})).toBe("completed"),expect(taskState({status:{state:"TASK_STATE_WORKING"}})).toBe("working")}),it("passes through v0.3 lowercase states",()=>{expect(taskState({status:{state:"failed"}})).toBe("failed")})}),describe("buildTaskPayload",()=>{it("surfaces produced content with the terminal state (canceled with artifact)",()=>{expect(buildTaskPayload({contextId:"ctx-1",status:{state:"TASK_STATE_CANCELED"},artifacts:[{parts:[{text:"partial work"}]}]},"t1","agent-1")).toEqual({status:"canceled",task_id:"t1",agent_id:"agent-1",context_id:"ctx-1",is_terminal:!0,result:"partial work"})}),it("reports status-message text as error when there is no artifact",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_FAILED",message:{parts:[{text:"boom"}]}}},"t2","agent-2")).toEqual({status:"failed",task_id:"t2",agent_id:"agent-2",is_terminal:!0,error:"boom"})}),it("marks a working task as non-terminal with neither result nor error",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_WORKING"}},"t3","agent-3")).toEqual({status:"working",task_id:"t3",agent_id:"agent-3",is_terminal:!1})}),it("includes result for a completed task",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"the answer"}]}]},"t4","agent-4")).toEqual({status:"completed",task_id:"t4",agent_id:"agent-4",is_terminal:!0,result:"the answer"})}),it("returns result text and structured files together",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"beeos-file://file-1"},{url:"beeos-file://file-1",filename:"screenshot.jpeg",mediaType:"image/jpeg"}]}]},"t5","agent-5")).toEqual({status:"completed",task_id:"t5",agent_id:"agent-5",is_terminal:!0,result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]})}),it("does not turn text-only beeos-file URI results into files",()=>{expect(buildTaskPayload({status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"beeos-file://file-only-text"}]}]},"t6","agent-6")).toEqual({status:"completed",task_id:"t6",agent_id:"agent-6",is_terminal:!0,result:"beeos-file://file-only-text"})})}),describe("beeos_call_agent async create",()=>{afterEach(()=>{vi.unstubAllGlobals()}),it("creates the task and returns the handle (task_id, agent_id, context_id) without polling or task data",async()=>{const t=[],e=vi.fn(async(e,s)=>{const a=s?.body?JSON.parse(s.body):{};if(t.push({url:e,method:s?.method,rpcMethod:a.method}),"SendMessage"===a.method)return jsonResponse({jsonrpc:"2.0",id:a.id,result:{task:{id:"task-async-1",contextId:"c1",status:{state:"TASK_STATE_WORKING"}}}});throw new Error(`unexpected request method: ${a.method}`)});vi.stubGlobal("fetch",e);const s=registerTools(makeCfg()).get("beeos_call_agent"),a=await s.execute("tc-1",{agentId:AGENT_ID,message:"do it"}),o=JSON.parse(a.content);expect(o.status).toBe("working"),expect(o.task_id).toBe("task-async-1"),expect(o.agent_id).toBe(AGENT_ID),expect(o.context_id).toBe("c1"),expect(o.result).toBeUndefined(),expect(t).toHaveLength(1),expect(t[0].rpcMethod).toBe("SendMessage"),expect(t[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`)}),it("registers the task so beeos_get_task can resolve the agent id",async()=>{const t=vi.fn(async(t,e)=>{const s=e?.body?JSON.parse(e.body):{};return"SendMessage"===s.method?jsonResponse({jsonrpc:"2.0",id:s.id,result:{task:{id:"task-reg-1",status:{state:"TASK_STATE_WORKING"}}}}):jsonResponse({jsonrpc:"2.0",id:s.id,result:{id:"task-reg-1",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"done"}]}]}})});vi.stubGlobal("fetch",t);const e=new TaskHandleRegistry,s=registerTools(makeCfg(),e);await s.get("beeos_call_agent").execute("tc",{agentId:AGENT_ID,message:"do it"});const a=await s.get("beeos_get_task").execute("tc",{taskId:"task-reg-1"}),o=JSON.parse(a.content);expect(o.status).toBe("completed"),expect(o.result).toBe("done"),expect(o.agent_id).toBe(AGENT_ID)}),it("returns an error handle (with agent_id, no task_id) when create fails",async()=>{const t=vi.fn(async(t,e)=>jsonResponse({jsonrpc:"2.0",id:(e?.body?JSON.parse(e.body):{}).id,error:{code:-32e3,message:"boom"}},!1,500));vi.stubGlobal("fetch",t);const e=registerTools(makeCfg()).get("beeos_call_agent"),s=await e.execute("tc",{agentId:AGENT_ID,message:"do it"}),a=JSON.parse(s.content);expect(a.error).toContain("send task failed"),expect(a.agent_id).toBe(AGENT_ID),expect(a.task_id).toBeUndefined()})}),describe("beeos_get_task",()=>{function t(t){const e=[],s=vi.fn(async(s,a)=>{const o=a?.body?JSON.parse(a.body):{};if(e.push({url:s,method:a?.method,rpcMethod:o.method,params:o.params}),"GetTask"!==o.method)throw new Error(`unexpected method: ${o.method}`);return jsonResponse({jsonrpc:"2.0",id:o.id,result:t})});return vi.stubGlobal("fetch",s),e}afterEach(()=>{vi.unstubAllGlobals()}),it("describes structured files as resource artifacts, not Markdown or MEDIA",()=>{const t=registerTools(makeCfg()).get("beeos_get_task").description??"";expect(t).toContain("files` contains structured file artifacts"),expect(t).toContain("Do not output MEDIA:"),expect(t).not.toContain("runtime displays image files"),expect(t).not.toContain("chat attachments"),expect(t).not.toContain("![")}),it("returns the data of a completed task and queries the right endpoint",async()=>{const e=t({id:"task-1",contextId:"ctx-1",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"the answer"}]}]}),s=registerTools(makeCfg()).get("beeos_get_task"),a=await s.execute("tc",{taskId:"task-1",agentId:AGENT_ID}),o=JSON.parse(a.content);expect(o.status).toBe("completed"),expect(o.task_id).toBe("task-1"),expect(o.agent_id).toBe(AGENT_ID),expect(o.context_id).toBe("ctx-1"),expect(o.is_terminal).toBe(!0),expect(o.result).toBe("the answer"),expect(e).toHaveLength(1),expect(e[0].method).toBe("POST"),expect(e[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`),expect(e[0].params.id).toBe("task-1")}),it("surfaces partial output AND the terminal state for a canceled task that still produced an artifact",async()=>{t({id:"task-cx",status:{state:"TASK_STATE_CANCELED"},artifacts:[{parts:[{text:"partial plan"}]}]});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-cx",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.status).toBe("canceled"),expect(a.task_id).toBe("task-cx"),expect(a.result).toBe("partial plan")}),it("returns an error for a terminal task with no produced content",async()=>{t({id:"task-to",status:{state:"TASK_STATE_FAILED",message:{parts:[{text:"boom"}]}}});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-to",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.error).toBe("boom"),expect(a.task_id).toBe("task-to")}),it("reports a still-running task as working",async()=>{t({id:"task-w",status:{state:"TASK_STATE_WORKING"}});const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"task-w",agentId:AGENT_ID}),a=JSON.parse(s.content);expect(a.status).toBe("working"),expect(a.task_id).toBe("task-w")}),it("resolves agentId from the session registry when omitted",async()=>{const e=new TaskHandleRegistry;e.create("task-reg",AGENT_ID);const s=t({id:"task-reg",status:{state:"TASK_STATE_COMPLETED"},artifacts:[{parts:[{text:"ok"}]}]}),a=registerTools(makeCfg(),e).get("beeos_get_task"),o=await a.execute("tc",{taskId:"task-reg"}),r=JSON.parse(o.content);expect(r.status).toBe("completed"),expect(r.result).toBe("ok"),expect(r.agent_id).toBe(AGENT_ID),expect(s[0].url).toBe(`https://gw.test/api/v1/a2a/${AGENT_ID}`)}),it("errors when agentId is neither passed nor resolvable",async()=>{const t=vi.fn();vi.stubGlobal("fetch",t);const e=registerTools(makeCfg()).get("beeos_get_task"),s=await e.execute("tc",{taskId:"unknown-task"}),a=JSON.parse(s.content);expect(a.error).toContain("agentId is required"),expect(t).not.toHaveBeenCalled()})});

package/dist/acp-gateway/bridge-core.js

@@ -1 +1 @@
-import{randomUUID,createHash}from"node:crypto";import{mkdir,writeFile,readFile,rm,lstat,readlink,stat,readdir,rename,cp}from"node:fs/promises";import path from"node:path";import{join,resolve,relative,sep}from"node:path";import{homedir}from"node:os";import AdmZip from"adm-zip";import{sanitizePromptPayload,stripTransportMetadata,isHeartbeatPromptText,isCronPromptText,extractCronJobId,classifyHeartbeatFilter,previewFilteredText}from"../message-filter.js";import{createCronOverridesStore}from"../cron-overrides.js";import{CRON_DURATION_FLOOR_MS}from"../config.js";import{CANVAS_TERM_MAPPING,CANVAS_UPDATE_HINT,buildActiveSurfacesContext}from"../canvas/tools.js";import{parseMentionsParam,buildMentionInstruction}from"../delegation/mention-resolver.js";import{EXTERNAL_PROTOCOL_TAGS}from"./external-protocol-tags.js";import{extractPromptBlocks,toGatewayPrompt,resolveSlashCommandName as resolveSlashCmd}from"./prompt-converter.js";import{loadHistory,loadHistoryPage,groupIntoTurns,splitUserReplayBlocks}from"./history-replay.js";import{findLocalHistoryEntryByMessageId,LocalSessionHistory}from"./local-session-history.js";import{reconcileMissingArtifacts}from"./missing-artifacts-reconciler.js";import{buildResolutionPlan,resolveResources,applyResolutions}from"./prompt-resource-resolver.js";import{readEnrichmentCache,readUploadToolResult}from"../upload/result-cache.js";import{buildToolResultSessionContentBlocks}from"./tool-result-payload-strategies.js";import{prefersChatFileArtifacts}from"./file-artifact-presenter.js";import{buildToolCallPayload,buildToolCallUpdatePayload}from"./tool-call-payload-builder.js";import{Errors}from"../errors/index.js";import{formatFriendlyError}from"../errors/classify.js";import{resolveChannelFromSessionKey}from"../channel-detection.js";import{resolveTurnId,recordTurnIdForRole,recordToolCallTurnForUpdate}from"./gateway-events.js";import{emitNormalizedToolResultForTurn}from"./tool-result-emitter.js";import{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";import{McpService}from"./mcp-service.js";import{DEFAULT_PROMPT_TIMEOUT_MS}from"./types.js";import{ACP_PROTOCOL_VERSION}from"@beeos-ai/beeos-types/acp";import{parseAndValidateTemplatePackage,TemplatePackageError,MAX_ZIP_BYTES}from"./agent-template-package.js";const AGENT_VALID_ID_RE=/^[a-z0-9][a-z0-9_-]{0,63}$/i,AGENT_INVALID_CHARS_RE=/[^a-z0-9_-]+/g,AGENT_LEADING_DASH_RE=/^-+/,AGENT_TRAILING_DASH_RE=/-+$/,DEFAULT_AGENT_ID="main";export function normalizeAgentId(e){const t=(e??"").trim();return t?AGENT_VALID_ID_RE.test(t)?t.toLowerCase():t.toLowerCase().replace(AGENT_INVALID_CHARS_RE,"-").replace(AGENT_LEADING_DASH_RE,"").replace(AGENT_TRAILING_DASH_RE,"").slice(0,64)||"main":"main"}function narrowContentBlock(e){switch(e.type){case"text":return"string"==typeof e.text?{type:"text",text:e.text}:void 0;case"resource_link":return"string"==typeof e.uri?{type:"resource_link",uri:e.uri,...void 0!==e.name?{name:e.name}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}}:void 0;case"file":return{type:"file",...void 0!==e.text?{text:e.text}:{},...void 0!==e.uri?{uri:e.uri}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}};case"image":return{type:"image",...void 0!==e.uri?{uri:e.uri}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}};default:return}}const DEFAULT_MODE={id:"default",name:"Default",description:"Default agent mode"},USER_MESSAGE_PREFIX="User Message From BeeOS:",USER_MESSAGE_PREFIX_WITH_NEWLINE=`${USER_MESSAGE_PREFIX}\n`,SLASH_COMMAND_NAME_RE=/^[a-z0-9_-]+$/i,HISTORY_PAGE_DEFAULT_LIMIT=100,HISTORY_PAGE_MAX_LIMIT=1e3;function withUserMessagePrefix(e){return e.startsWith(USER_MESSAGE_PREFIX)?e:`${USER_MESSAGE_PREFIX_WITH_NEWLINE}${e}`}const BACKGROUND_SESSION_PATTERNS=[":cron:",":hook:","node-",...EXTERNAL_PROTOCOL_TAGS];function isBackgroundSessionKey(e){return BACKGROUND_SESSION_PATTERNS.some(t=>e.includes(t))}function isSystemDefaultSessionKey(e){const t=e.split(":");if(t.length<3||"agent"!==t[0])return!1;const s=t.slice(2).join(":");return"main"===s||s===t[1]}function isPlaceholderTitle(e){return!e||"New chat"===e||(!!/^[0-9a-f]{6,12}\s*\(20\d{2}/i.test(e)||(!!/^Sender\s*\(untrusted/i.test(e)||!!/^Conversation\s+info\s*\(untrusted/i.test(e)))}function cleanGatewayDerivedTitle(e){if(!e)return;let t=stripTransportMetadata(e);return/^\[System\b/.test(t)?void 0:(t=t.trim(),t||void 0)}function mergePersistedToolResultEnvelopes(e,t){if(e||t)return{toolName:e?.toolName||t?.toolName||"tool",...e?.toolCallId||t?.toolCallId?{toolCallId:e?.toolCallId??t?.toolCallId}:{},...e?.rawText??t?.rawText?{rawText:e?.rawText??t?.rawText}:{},...void 0!==e?.rawResult||void 0!==t?.rawResult?{rawResult:e?.rawResult??t?.rawResult}:{},...e?.timestamp||t?.timestamp?{timestamp:e?.timestamp??t?.timestamp}:{}}}function resolveStandaloneSlashCommandName(e,t){if(0===e.length)return;if(e.some(e=>"text"!==e.type))return;const s=t.trim();if(!s||s.includes("\n")||!s.startsWith("/"))return;const r=s.match(/^\/([^\s:]+)(?::|\s|$)/)?.[1]?.trim();return r&&!r.includes("/")&&SLASH_COMMAND_NAME_RE.test(r)?r.toLowerCase():void 0}export const BEEOS_CHANNEL_TAG_RE=/<!-- beeos:channel=(.+?) -->/;export function encodeBeeosChannelTag(e,t){const s=`\x3c!-- beeos:channel=${t} --\x3e`,r=stripBeeosChannelTag(e);return r?`${r}\n${s}`:s}export function decodeBeeosChannelId(e){if(!e)return;const t=BEEOS_CHANNEL_TAG_RE.exec(e);return t?.[1]}export function stripBeeosChannelTag(e){return e?e.replace(/\n?<!-- beeos:channel=.+? -->/g,"").trim():""}function deriveSessionId(e,t){const s=createHash("sha256").update(`${t}:${e}`).digest("hex").substring(0,32);return`session:${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20,32)}`}function parseAgentIdFromKey(e){const t=e.split(":");return(t.length>=3&&"agent"===t[0]?t[1]:"")||"main"}function createSessionObject(e){const t=parseAgentIdFromKey(e.gatewayKey);return{sessionId:deriveSessionId(e.gatewayKey,e.instanceId),gatewaySessionKey:e.gatewayKey,agentId:t,platformAgentId:e.resolvePlatformAgentId?.(t),createdAt:Date.now(),chatReplayDedupKeys:new Set,cwd:e.cwd,title:e.title,channelType:resolveChannelFromSessionKey(e.gatewayKey,e.thirdPartyChannels)}}class HistoryUpdateRecorder{transport;updates=[];constructor(e){this.transport=e}sendSessionUpdate(e,t,s){const r=this.transport.materializeSessionUpdate(t,s);return null!==r&&this.updates.push(r),!0}}export class AcpGatewayBridgeCore{state;transport;config;logger;writeObs;getGateway;thirdPartyChannels;beeosFileResolver;agentFetch;agentGatewayUrl;triggerAgentSync;cronChannelCache=new Map;static CRON_CHANNEL_CACHE_MAX=256;localSessionHistory;mcp;initialized=!1;agentMapping=null;_syncResolvers=[];_mappingReadyCallbacks=[];_mappingUpdateCallbacks=[];cronIsolatedSessionKeys=new Set;cronOverrides;setAgentMapping(e){this.agentMapping=e;for(const t of this.state.sessions.values())!t.platformAgentId&&t.agentId&&(t.platformAgentId=e.get(t.agentId)?.id);for(const e of this._syncResolvers)e();this._syncResolvers=[];for(const e of this._mappingReadyCallbacks)e();this._mappingReadyCallbacks=[];for(const t of this._mappingUpdateCallbacks)t(e)}onceAgentMappingReady(e){this.agentMapping&&this.agentMapping.size>0?e():this._mappingReadyCallbacks.push(e)}onAgentMappingUpdated(e){this._mappingUpdateCallbacks.push(e),this.agentMapping&&this.agentMapping.size>0&&e(this.agentMapping)}markAgentSyncDone(){for(const e of this._syncResolvers)e();this._syncResolvers=[]}waitForAgentMapping(e=15e3){return this.agentMapping?Promise.resolve():new Promise(t=>{this._syncResolvers.push(t);const s=setTimeout(()=>{const e=this._syncResolvers.indexOf(t);-1!==e&&this._syncResolvers.splice(e,1),t()},e);"object"==typeof s&&"unref"in s&&s.unref()})}handleTerminalRequest=null;handleTerminalNotification=null;onRunComplete=null;onRunFailed=null;onRunEnded=null;handleSlashCommand=null;onPromptStart=null;instanceId;constructor(e){this.state=e.state,this.transport=e.transport,this.config=e.config,this.logger=e.logger,this.writeObs=e.writeObs,this.getGateway=e.getGateway,this.instanceId=e.instanceId||"unknown",this.thirdPartyChannels=e.thirdPartyChannels??new Set,this.beeosFileResolver=e.beeosFileResolver,this.agentFetch=e.agentFetch,this.agentGatewayUrl=e.agentGatewayUrl,this.triggerAgentSync=e.triggerAgentSync,this.localSessionHistory=new LocalSessionHistory({logger:this.logger}),this.cronOverrides=createCronOverridesStore(this.logger),this.mcp=new McpService({transport:this.transport,logger:this.logger,state:this.state}),this.transport.setSessionUpdateObserver((e,t,s)=>{const r=s?.turnId;if(!r)return;const n=this.state.sessions.get(e);n&&(recordTurnIdForRole(n,t,r),recordToolCallTurnForUpdate(n,t,r))})}resolvePlatformAgentId(e){return this.agentMapping?.get(e)?.id}getDefaultAgentId(){return this.agentMapping&&this.agentMapping.size>0?this.agentMapping.keys().next().value??"main":"main"}registerSession(e,t={}){const{ensureVerbose:s=!0}=t;this.state.sessions.has(e.sessionId);this.state.sessions.set(e.sessionId,e),this.state.sessionsByGatewayKey.set(e.gatewaySessionKey,e),s&&this.ensureVerboseFull(e),this.subscribeSessionMessages(e)}async ensureVerboseFull(e){if(e.verbosePatched)return;const t=this.getGateway();if(t?.isConnected){e.verbosePatched=!0;try{await t.sessionsPatch(e.gatewaySessionKey,{verboseLevel:"full"})}catch(t){e.verbosePatched=!1,this.logger.debug?.(`[bridge-core] ensureVerboseFull failed: ${t instanceof Error?t.message:t}`)}}}ensureSessionForKey(e){const t=this.state.findSessionByKey(e);if(t)return t;const s=createSessionObject({gatewayKey:e,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels});return this.registerSession(s),this.logger.debug?.(`[bridge-core] ensureSessionForKey: lazily created session sid=${s.sessionId} key=${e}`),s}async preloadSessionsFromGateway(){const e=this.getGateway();if(e?.isConnected)try{const t=await e.sessionsList();if(!t||"object"!=typeof t)return;const s=t.sessions;if(!Array.isArray(s))return;let r=0;for(const e of s){const t=e,s=t.sessionKey??t.key??t.id??t.name;if(!s||"string"!=typeof s)continue;if(this.state.findSessionByKey(s))continue;const n=t.label||t.derivedTitle||t.title||void 0,i=n&&!isPlaceholderTitle(n)?n:void 0,o=createSessionObject({gatewayKey:s,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,title:i});this.registerSession(o,{ensureVerbose:!1}),r++}r>0&&this.logger.info?.(`[bridge-core] preloadSessions: loaded ${r} session(s) from gateway`)}catch(e){this.logger.debug?.("[bridge-core] preloadSessions failed:",e)}else this.logger.debug?.("[bridge-core] preloadSessions skipped: gateway not connected")}async handleRequest(e){this.writeObs({component:"bridge-core",domain:"forward",name:`rpc.request.${e.method}`,severity:"debug",payload:{id:e.id,method:e.method}});const t=e;try{switch(t.method){case"initialize":this.handleInitialize(t);break;case"ping":this.transport.sendResult(t.id,{pong:!0});break;case"session/new":await this.handleSessionNew(t);break;case"session/load":await this.handleSessionLoad(t);break;case"session/list":await this.handleSessionList(t);break;case"session/rename":this.handleSessionRename(t);break;case"session/delete":await this.handleSessionDelete(t);break;case"session/clear":await this.handleSessionClear(t);break;case"session/prompt":await this.handleSessionPrompt(t);break;case"session/set_mode":await this.handleSessionSetMode(t);break;case"session/set_model":await this.handleSessionSetModel(t);break;case"agent/create":await this.handleAgentCreate(t);break;case"agent/update":await this.handleAgentUpdate(t);break;case"agent/delete":await this.handleAgentDelete(t);break;case"agent/applyTemplate":await this.handleApplyTemplate(t);break;case"skills/list":await this.handleSkillsList(t);break;case"skills/install":await this.handleSkillsInstall(t);break;case"skills/uninstall":await this.handleSkillsUninstall(t);break;case"skills/update":await this.handleSkillsUpdate(t);break;case"models/list":await this.handleModelsList(t);break;case"session/cancel":this.handleSessionCancel(t.id,t.params);break;case"cron/list":case"cron/status":case"cron/add":case"cron/update":case"cron/remove":case"cron/run":case"cron/runs":await this.handleCronRequest(t);break;default:"_beeos/session/history"===e.method?await this.handleSessionHistoryPage(e):"mcp/list"===e.method?await this.mcp.handleList(e):"mcp/set"===e.method?await this.mcp.handleSet(e):"mcp/unset"===e.method?await this.mcp.handleUnset(e):e.method.startsWith("terminal/")&&this.handleTerminalRequest?await this.handleTerminalRequest(e):this.transport.sendAcpError(e.id,Errors.MethodNotFound,{message:`Method not found: ${e.method}`})}}catch(t){this.transport.sendAcpError(e.id,Errors.InternalError,{message:t instanceof Error?t.message:"Internal error"})}}handleCanvasNotification=null;getCanvasState=null;onSessionLoaded=null;onSkillInstalled=null;onSessionDeleted=null;onSessionCleared=null;handleNotification(e){switch(e.method){case"session/cancel":this.handleSessionCancel(void 0,e.params);break;case"canvas/toggle":case"canvas/clear":this.handleCanvasNotification?this.handleCanvasNotification(e.method,e.params):this.logger.debug?.(`[bridge-core] Canvas notification ignored (canvas disabled): ${e.method}`);break;case"canvas/reference":{const t=e.params,s=t?.surfaceId,r=this.state.resolveSessionFromParams(t);if(!r){this.logger.warn?.(`[bridge-core] canvas/reference ignored — no session found for sessionId=${t?.sessionId}`);break}r.referencedSurfaceId=s||void 0,this.logger.debug?.(`[bridge-core] Canvas reference ${s?"set":"cleared"}: ${s??"(none)"}`);break}default:e.method.startsWith("terminal/")&&this.handleTerminalNotification?this.handleTerminalNotification(e.method,e.params):this.logger.debug?.(`[bridge-core] Unknown notification: ${e.method}`)}}handleInitialize(e){this.initialized=!0;const t=this.transport.forwardControl;!1===e.params?.forwardThinking&&(t.forwardThinking=!1),!1===e.params?.forwardToolCalls&&(t.forwardToolCalls=!1),this.transport.sendResult(e.id,{protocolVersion:ACP_PROTOCOL_VERSION,agentCapabilities:{loadSession:!0,skills:!0,multipleSessions:!0,sessionCapabilities:{"web-ssh":!!this.config.bridge.shell.enabled,canvas:!!this.config.canvasEnabled},promptCapabilities:{image:!0,audio:!1,embeddedContext:!0},mcp:{}},agentInfo:{name:"beeos-claw",title:"BeeOS Agent Bridge",version:"0.1.0"},_meta:{},authMethods:[]})}async handleSessionNew(e){const t=`agent:${"string"==typeof e.params?.agentId&&e.params.agentId||this.config.gateway.agentId||this.getDefaultAgentId()}:${randomUUID()}`,s="string"==typeof e.params?.cwd?e.params.cwd:".",r=createSessionObject({gatewayKey:t,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,cwd:s});this.registerSession(r,{ensureVerbose:!1}),this.transport.sendResult(e.id,{sessionId:r.sessionId,modes:{availableModes:[{...DEFAULT_MODE}],currentModeId:DEFAULT_MODE.id},_meta:{sessionKey:t,agentId:r.agentId,platformAgentId:r.platformAgentId??null}}),this.fetchHistoryInBackground(t)}fetchHistoryInBackground(e){const t=this.getGateway();t?.isConnected&&loadHistory(t,e,50).catch(e=>{this.logger.debug?.(`[bridge-core] Background history fetch failed: ${e instanceof Error?e.message:e}`)})}async subscribeSessionMessages(e){if(e.messageSubscriptionActive)return;const t=this.getGateway();if(t?.isConnected)try{await t.sessionsMessagesSubscribe(e.gatewaySessionKey),e.messageSubscriptionActive=!0,this.logger.debug?.(`[bridge-core] session.message subscribed sessionKey=${e.gatewaySessionKey}`)}catch(t){this.logger.debug?.(`[bridge-core] session.message subscribe failed key=${e.gatewaySessionKey}: ${t instanceof Error?t.message:t}`)}}async resubscribeAllSessionMessages(){for(const e of this.state.sessions.values())e.messageSubscriptionActive=!1,await this.subscribeSessionMessages(e)}handleSessionMessage(e){const t=e?.sessionKey,s=e?.messageId;if(!t||!s)return;const r=this.state.sessionsByGatewayKey.get(t);if(!r)return;const n=e.message?.role;if("toolResult"===n||"tool"===n)return void this.handlePersistedToolResultMessage(r,e).catch(e=>{this.logger.warn?.(`[bridge-core] persisted toolResult handling failed sessionKey=${t} messageId=${s}: ${e instanceof Error?e.message:String(e)}`)});const i="user"===n?"user":"system"===n?"system":"assistant",o=r.lastTurnIdByRole?.[i];if(!o)return void this.logger.debug?.(`[bridge-core] session.message skipped: no lastTurnId role=${i} sessionKey=${t} messageId=${s}`);const a=e.message?.timestamp,l="number"==typeof a&&a>0?new Date(a).toISOString():void 0,d={turnId:o};"number"==typeof e.messageSeq&&(d.seq=e.messageSeq),this.transport.sendSessionUpdate(r.sessionId,{sessionUpdate:"message_id_bind",role:i,messageId:s,...l?{timestamp:l}:{}},d),r.lastTurnIdByRole&&(r.lastTurnIdByRole[i]=void 0),"assistant"===i&&reconcileMissingArtifacts({localHistory:this.localSessionHistory,transport:this.transport,config:this.config,logger:this.logger,writeObs:this.writeObs,getCanvasState:()=>this.getCanvasState?.()??null,isSessionAlive:e=>this.state.sessions.has(e)},{session:r,turnId:o,messageId:s,runId:void 0})}async handlePersistedToolResultMessage(e,t){const s=t.messageId;if(!s)return;const r=extractPersistedToolResultEnvelope(t.message),n=this.extractPersistedToolResultFromHistory(e,s),i=mergePersistedToolResultEnvelopes(n,r);if(!i?.toolCallId)return void this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.skipped_no_tool_call_id",severity:"warn",payload:{sessionId:e.sessionId,messageId:s}});n&&this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.hydrated_from_history",severity:"debug",payload:{sessionId:e.sessionId,messageId:s,toolCallId:i.toolCallId,toolName:i.toolName}});const o=e.toolCallTurns?.get(i.toolCallId),a=o?.turnId??resolveTurnId(e);a?await emitNormalizedToolResultForTurn({session:e,envelope:{toolCallId:i.toolCallId,toolName:i.toolName||o?.toolName||"tool",...i.rawText?{rawText:i.rawText}:{},...i.rawResult?{rawResult:i.rawResult}:{},...i.timestamp?{timestamp:i.timestamp}:{}},turnId:a,config:this.config,logger:this.logger,writeObs:this.writeObs,getCanvasState:()=>this.getCanvasState?.()??null,sendUpdate:s=>(a&&void 0===s._turnId&&(s._turnId=a),this.transport.sendSessionUpdate(e.sessionId,s,{turnId:a,..."number"==typeof t.messageSeq?{seq:t.messageSeq}:{}}))}):this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.skipped_no_turn",severity:"warn",payload:{sessionId:e.sessionId,messageId:t.messageId,toolCallId:i.toolCallId,toolName:i.toolName}})}extractPersistedToolResultFromHistory(e,t){if(!e.agentId)return;const s=this.localSessionHistory.readEntries({agentId:e.agentId,sessionKey:e.gatewaySessionKey,sessionId:e.sessionId}),r=findLocalHistoryEntryByMessageId(s,t);if(!r)return;const n=r.role;return"toolResult"===n||"tool"===n?extractPersistedToolResultEnvelope(r):void 0}async recoverSessionFromGateway(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.sessionsList();if(!s||"object"!=typeof s)return;const r=s.sessions;if(!Array.isArray(r))return;for(const t of r){const s=t,r=s.sessionKey??s.key??s.id??s.name;if(r&&"string"==typeof r&&deriveSessionId(r,this.instanceId)===e){const e=s.label||s.derivedTitle||s.title||void 0,t=e&&!isPlaceholderTitle(e)?e:void 0,n=createSessionObject({gatewayKey:r,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,title:t});return this.registerSession(n),n}}}catch(e){this.logger.debug?.("[bridge-core] recoverSessionFromGateway failed:",e)}}async resolveOrCreateSession(e){let t=this.state.sessions.get(e);if(!t&&e.startsWith("agent:")&&(t=this.state.findSessionByKey(e)),t||e.startsWith("agent:")||(t=await this.recoverSessionFromGateway(e)),t)return{session:t,created:!1};const s=e.startsWith("agent:"),r=this.config.gateway.agentId||this.getDefaultAgentId();return t=createSessionObject({gatewayKey:s?e:`agent:${r}:${e}`,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels}),this.registerSession(t),{session:t,created:!0}}async handleSessionLoad(e){const t=e.params?.sessionId;if(!t)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const{session:s}=await this.resolveOrCreateSession(t),r=s.sessionId;this.state.lastActiveSessionId=r,s.chatReplayDedupKeys.clear(),s.sessionLoadInProgress=!0;try{const e=await this.emitHistoryTurns(s);this.emitCurrentStreamSnapshot(s,e)}finally{s.sessionLoadInProgress=!1}this.transport.sendResult(e.id,{sessionId:r}),this.onSessionLoaded?.(r,s.gatewaySessionKey,s.platformAgentId),this.pushSkillsList().catch(e=>{this.logger.warn?.(`[bridge-core] pushSkillsList failed: ${e instanceof Error?e.message:e}`)})}async emitHistoryTurns(e){const t=new Set,s=e.sessionId;try{const r=this.getGateway(),n=e.assistantMq&&!e.assistantMq.closed,i=n?null:r,o=await loadHistory(i,e.gatewaySessionKey,100,{localHistory:this.localSessionHistory,agentId:e.agentId,sessionId:e.sessionId,logger:this.logger,emitObs:e=>{this.writeObs({component:"history-replay",domain:"lifecycle",name:e.name,severity:e.severity,payload:e.payload})}}),a=groupIntoTurns(o),l=a.filter(e=>"user"===e.role).length,d=a.filter(e=>"assistant"===e.role).length,c=a.filter(e=>e.toolCalls?.length).length,g=a.reduce((e,t)=>e+(t.toolCalls?.length??0),0);if(this.logger.debug?.(`[bridge-core] handleSessionLoad sid=${s} messages=${o.length} turns=${a.length} userTurns=${l} asstTurns=${d} turnsWithToolCalls=${c} totalToolCalls=${g}`),l>0&&e.pendingUserTurnUpdates&&e.pendingUserTurnUpdates.length>0&&(e.pendingUserTurnUpdates=[]),a.length>0&&isPlaceholderTitle(e.title)&&"manual"!==e.titleSource){const t=a.find(e=>{if("user"!==e.role)return!1;if("internal_system"===e.provenance?.kind)return!1;if(isCronPromptText(e.content))return!1;const t=stripTransportMetadata(e.content).trim();return t.length>0&&!/^Sender\s*\(untrusted/i.test(t)});if(t?.content){const r=stripTransportMetadata(t.content).trim().slice(0,64).replace(/\n/g," ").trim();if(r){e.title=r,e.titleSource="truncated";const t=this.getGateway();t?.isConnected&&t.sessionsPatch(e.gatewaySessionKey,{label:r}).catch(()=>{}),this.transport.sendSessionUpdate(s,{sessionUpdate:"title_update",title:r}),this.tryGenerateTitleFromHistory(e,s,a)}}}const p=t=>`history:${e.gatewaySessionKey}:${t}`;let m=-1;if(n)for(let e=a.length-1;e>=0;e--)if("assistant"===a[e].role){m=e;break}const{replayedToolCallIds:h,streamCompleteCount:u}=await this.replayHistoryTurnsToSink(e,a,this.transport,{mqActive:Boolean(n),lastAsstIdx:m,turnIdFor:(e,t)=>p(t)});for(const e of h)t.add(e);this.logger.debug?.(`[bridge-core] emitHistoryTurns DONE sid=${s} historyStreamCompleteEmitted=${u} replayedToolCallIds=${t.size}`)}catch(e){this.logger.warn?.("[bridge-core] Failed to load session history:",e)}return t}async replayHistoryTurnsToSink(e,t,s,r){const n=e.sessionId,i=new Set;let o=0;for(let a=0;a<t.length;a++){const l=t[a],d=r.turnIdFor(l,a);if(r.mqActive&&a===r.lastAsstIdx)this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] assistant — mq active, deferring to emitCurrentStreamSnapshot`);else if("user"!==l.role||"internal_system"!==l.provenance?.kind)if("user"===l.role&&/^\s*system\s*\(untrusted[^)]*\)/i.test(l.content))this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] system-injected user message`);else if("user"===l.role&&isHeartbeatPromptText(l.content))this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] heartbeat cron prompt sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);else if("user"===l.role&&isCronPromptText(l.content))this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] cron-triggered user message sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);else{if("assistant"===l.role){const t=classifyHeartbeatFilter(l.content);if(t.filtered){this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] heartbeat assistant reply reason=${t.reason} sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);continue}}if("system"!==l.role)if(this.logger.debug?.(`[bridge-core] SENDING history_turn[${a}] role=${l.role} contentLen=${l.content.length} content=${JSON.stringify(l.content.slice(0,80))} tcCount=${l.toolCalls?.length??0}`),"user"===l.role)this.replayUserTurnAsChunks(s,n,l.content,l.metadata,l.timestamp,d,l._seq);else{if(await this.replayAssistantTurnAsStream(s,n,l,d),l.toolCalls)for(const e of l.toolCalls)e.id&&i.add(e.id);s.sendSessionUpdate(n,{sessionUpdate:"stream_complete",stopReason:"end_turn"},{turnId:d}),o+=1}else this.logger.debug?.(`[bridge-core] SENDING system_message[${a}] contentLen=${l.content.length}`),s.sendSessionUpdate(n,{sessionUpdate:"system_message_chunk",content:{type:"text",text:l.content},metadata:l.metadata,...l.timestamp?{timestamp:l.timestamp}:{}},{turnId:d,...void 0!==l._seq?{seq:l._seq}:{}})}else this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] internal_system user message`)}return{replayedToolCallIds:i,streamCompleteCount:o}}async handleSessionHistoryPage(e){const t=e.params??{},s="string"==typeof t.sessionId?t.sessionId:"";if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const r="string"==typeof t.cursor&&t.cursor.length>0?t.cursor:void 0,n="number"==typeof t.limit&&Number.isFinite(t.limit)&&t.limit>0?Math.min(1e3,Math.floor(t.limit)):100,{session:i}=await this.resolveOrCreateSession(s),o=this.getGateway(),a=await loadHistoryPage(o,i.gatewaySessionKey,{...r?{cursor:r}:{},limit:n,logger:this.logger}),l=groupIntoTurns(a.messages),d=new HistoryUpdateRecorder(this.transport);await this.replayHistoryTurnsToSink(i,l,d,{mqActive:!1,lastAsstIdx:-1,turnIdFor:(e,t)=>void 0!==e._seq?`history:${i.gatewaySessionKey}:seq:${e._seq}`:`history:${i.gatewaySessionKey}:seq:none:${r??"head"}:${t}`}),this.logger.debug?.(`[bridge-core] _beeos/session/history sid=${i.sessionId} cursor=${r??"<head>"} limit=${n} turns=${l.length} updates=${d.updates.length} hasMore=${a.hasMore} nextCursor=${a.nextCursor??"<none>"}`),this.transport.sendResult(e.id,{updates:d.updates,...a.nextCursor?{nextCursor:a.nextCursor}:{},hasMore:a.hasMore})}emitCurrentStreamSnapshot(e,t){const s=e.pendingUserTurnUpdates;if(s&&s.length>0)for(const t of s)this.transport.sendSessionUpdate(e.sessionId,t);const r=e.assistantMq;if(r&&!r.closed){const s=r.peek(0);let n=0;if(t&&t.size>0)for(let e=0;e<s.length;e++){const r=s[e],i=r.sessionUpdate,o=r.toolCallId;if("tool_call"!==i&&"tool_call_update"!==i||!o||!t.has(o)){if("agent_message_chunk"===i){if(""===(r.content?.text??"").trim()&&e<s.length-1){const r=s[e+1];if(("tool_call"===r.sessionUpdate||"tool_call_update"===r.sessionUpdate)&&r.toolCallId&&t.has(r.toolCallId)){n=e+1;continue}}break}break}n=e+1}const i=resolveTurnId(e),o=i?{turnId:i}:void 0;for(let t=n;t<s.length;t++)this.transport.sendSessionUpdate(e.sessionId,s[t],o)}}async handleSessionList(e){const t=[];for(const[,e]of this.state.sessions)isBackgroundSessionKey(e.gatewaySessionKey)||this.cronIsolatedSessionKeys.has(e.gatewaySessionKey)||t.push({sessionId:e.sessionId,title:e.title||"New chat",cwd:e.cwd,updatedAt:e.lastStreamActivityTs??e.createdAt,agentId:e.agentId,platformAgentId:e.platformAgentId,deletable:!isSystemDefaultSessionKey(e.gatewaySessionKey)});const s=this.getGateway();if(s?.isConnected)try{const e=await s.sessionsList();if(e&&"object"==typeof e&&Array.isArray(e.sessions)){const s=e.sessions;for(const e of s){const s=e,r=s.sessionKey??s.key??s.id??s.name;if(!r||"string"!=typeof r)continue;if(isBackgroundSessionKey(r))continue;if(this.cronIsolatedSessionKeys.has(r))continue;const n=deriveSessionId(r,this.instanceId),i=t.find(e=>e.sessionId===r||e.sessionId===n||this.state.sessions.get(e.sessionId)?.gatewaySessionKey===r),o=s.label||cleanGatewayDerivedTitle(s.derivedTitle)||s.title||void 0,a=o&&!isPlaceholderTitle(o)?o:void 0,l=s.model,d=s.modelProvider;if(i){if(a&&isPlaceholderTitle(i.title)){i.title=a;const e=this.state.sessions.get(i.sessionId);e&&isPlaceholderTitle(e.title)&&(e.title=a)}const e=s.updatedAt;e&&(i.updatedAt=e),l&&(i.model=l),d&&(i.modelProvider=d)}else{const e=createSessionObject({gatewayKey:r,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,cwd:s.cwd,title:a});this.registerSession(e,{ensureVerbose:!1}),t.push({sessionId:e.sessionId,title:a||"",cwd:s.cwd,updatedAt:s.updatedAt,agentId:e.agentId,platformAgentId:e.platformAgentId,deletable:!isSystemDefaultSessionKey(r),model:l,modelProvider:d})}}}}catch(e){this.logger.debug?.("[bridge-core] sessions.list enrichment failed:",e)}t.sort((e,t)=>(t.updatedAt??0)-(e.updatedAt??0)||e.sessionId.localeCompare(t.sessionId)),this.transport.sendResult(e.id,{sessions:t})}handleSessionRename(e){const t=e.params?.sessionId,s=e.params?.title;if(!t||!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId, title"});const r=s.slice(0,64),n=this.state.sessions.get(t);if(!n)return void this.transport.sendAcpError(e.id,Errors.SessionNotFound);n.title=r,n.titleSource="manual";const i=n.gatewaySessionKey,o=this.getGateway();o?.isConnected&&o.sessionsPatch(i,{label:r}).catch(e=>{this.logger.debug?.(`[bridge-core] sessionsPatch (rename) failed: ${e instanceof Error?e.message:e}`)}),this.transport.sendResult(e.id,{sessionId:t,title:r})}static TITLE_TEMPLATES=[{match:["今日日报","日报"],zh:"今日工作日报",en:"Daily Work Log"},{match:["周报","周报总结","本周周报"],zh:"本周工作周报",en:"Weekly Work Report"},{match:["月报","月度汇报","月度总结"],zh:"本月工作月报",en:"Monthly Work Report"},{match:["工作日志","日志"],zh:"工作日志整理",en:"Work Log Review"},{match:["晨会","今日晨会"],zh:"今日晨会纪要",en:"Daily Standup Notes"},{match:["复盘","今日复盘"],zh:"今日工作复盘",en:"Daily Retrospective"},{match:["新会话","new chat","new conversation"],zh:"新会话",en:"New Conversation"}];static TITLE_SYSTEM_PROMPT='You are a conversation title generator. Your task is to generate a concise, human-readable title summarizing the topic of the user\'s question together with the assistant\'s answer.\n\n### Rules:\n- Length: 3-6 words in English, or 6-20 characters in Chinese (up to 24 if needed to keep all key domain terms intact).\n- Language: Match the user\'s input language exactly. Mixed zh/en input → use the dominant language.\n- Extract the core topic (noun-centric) of the Q&A exchange, not the action verb.\n- Use the assistant\'s answer to disambiguate or enrich the topic when the question alone is vague (e.g. "帮我看下" + an answer about x402 → "x402 支付集成").\n- No punctuation, no quotation marks, no emojis, no markdown.\n- No prefix like "Title:" or "Here is". Output the title only.\n- Avoid generic words: "help", "question", "chat", "problem", "task".\n- If both the question and answer are too vague to summarize, return "新会话" (for zh) or "New Conversation" (for en).\n\n### Input Format:\nThe user message will contain both the question and the assistant\'s answer, delimited like this:\n[User Question]\n...question text...\n\n[Assistant Answer]\n...answer text (may be truncated with "..." in the middle)...\n\n### Output Format:\nRespond ONLY with valid JSON, no other text:\n{"title": "<your title here>"}\n\n### Examples:\nInput:\n[User Question]\n帮我写一个关于BeeOS设备接入的PRD\n\n[Assistant Answer]\n好的，这是 BeeOS 设备接入 PRD 的草稿：1. 目标 ...\nOutput: {"title": "BeeOS 设备接入 PRD"}\n\nInput:\n[User Question]\n帮我看下\n\n[Assistant Answer]\n你说的 x402 支付协议是一个基于 HTTP 402 的链上支付标准 ...\nOutput: {"title": "x402 支付协议解析"}\n\nInput:\n[User Question]\nWhat\'s the best way to integrate x402 payment protocol?\n\n[Assistant Answer]\nYou have three options: 1. Use the official SDK ...\nOutput: {"title": "x402 Payment Integration"}\n\nInput:\n[User Question]\nhi\n\n[Assistant Answer]\nHello! How can I help you today?\nOutput: {"title": "New Conversation"}';matchTitleTemplate(e){const t=e.trim().toLowerCase();for(const s of AcpGatewayBridgeCore.TITLE_TEMPLATES)if(s.match.some(e=>e.toLowerCase()===t))return/[\u4e00-\u9fff]/.test(e)?s.zh:s.en}isGuardMessage(e){const t=e.trim();return[...t].length<3||[...t].every(e=>/[\p{P}\p{S}\s]/u.test(e))}truncateQuestionForTitle(e){return e.length>2e3?e.slice(0,1500):e}truncateAnswerForTitle(e){return e.length<=1e3?e:`${e.slice(0,500)}\n...\n${e.slice(-500)}`}generateTitleFromQA(e,t,s,r){if(this.isGuardMessage(s))return void this.logger.info?.(`[bridge-core] title-gen SKIP guard message sid=${t}`);const n=this.matchTitleTemplate(s);if(n){e.title=n,e.titleSource="template";const s=this.getGateway();return s?.isConnected&&s.sessionsPatch(e.gatewaySessionKey,{label:n}).catch(()=>{}),void this.transport.sendSessionUpdate(t,{sessionUpdate:"title_update",title:n})}const i=(process.env.AROUTER_BASE_URL||"").replace(/\/$/,""),o=process.env.AROUTER_API_KEY||"";if(!i||!o)return void this.logger.info?.(`[bridge-core] title-gen SKIP sid=${t}: no AROUTER env vars`);const a=`[User Question]\n${this.truncateQuestionForTitle(s)}\n\n[Assistant Answer]\n${this.truncateAnswerForTitle(r)}`;this.logger.info?.(`[bridge-core] title-gen CALLING LLM sid=${t} q="${s.slice(0,60)}" aLen=${r.length}`),fetch(`${i}/v1/chat/completions`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${o}`},body:JSON.stringify({model:"openai/gpt-4o-mini",max_tokens:32,temperature:.3,messages:[{role:"system",content:AcpGatewayBridgeCore.TITLE_SYSTEM_PROMPT},{role:"user",content:a}]})}).then(async s=>{if(!s.ok){const e=await s.text().catch(()=>"");return void this.logger.info?.(`[bridge-core] title-gen FAILED sid=${t} status=${s.status} body=${e.slice(0,300)}`)}const r=await s.json(),n=r.choices?.[0]?.message?.content?.trim();if(!n)return;const i=n.replace(/^```json\s*/,"").replace(/```$/,"").trim();let o;try{o=JSON.parse(i).title?.trim()??""}catch{return void this.logger.debug?.(`[bridge-core] title-gen JSON parse failed: ${i}`)}if(!o)return;if("manual"===e.titleSource)return void this.logger.debug?.("[bridge-core] title-gen discarded: user already renamed");this.logger.info?.(`[bridge-core] title-gen OK sid=${t} title="${o}"`),e.title=o,e.titleSource="auto";const a=this.getGateway();a?.isConnected&&a.sessionsPatch(e.gatewaySessionKey,{label:o}).catch(()=>{}),this.transport.sendSessionUpdate(t,{sessionUpdate:"title_update",title:o})}).catch(e=>{this.logger.info?.(`[bridge-core] title-gen ERROR sid=${t}: ${e instanceof Error?e.message:e}`)})}async tryGenerateTitleFromHistory(e,t,s){if("manual"===e.titleSource||"auto"===e.titleSource)return;const r=this.getGateway();if(!r?.isConnected)return;let n=s;if(!n)try{const t=await loadHistory(r,e.gatewaySessionKey);n=groupIntoTurns(t)}catch(e){return void this.logger.debug?.(`[bridge-core] title-gen loadHistory failed sid=${t}: ${e instanceof Error?e.message:e}`)}const i=n.find(e=>{if("user"!==e.role)return!1;if(!e.content?.trim())return!1;if("internal_system"===e.provenance?.kind)return!1;if(isCronPromptText(e.content))return!1;const t=stripTransportMetadata(e.content).trim();return!!t&&!/^Sender\s*\(untrusted/i.test(t)});if(!i)return;const o=n.indexOf(i),a=n.slice(o+1).find(e=>"assistant"===e.role&&!!e.content?.trim());if(!a)return;const l=stripTransportMetadata(i.content).trim(),d=a.content.trim();l&&d&&this.generateTitleFromQA(e,t,l,d)}async handleSessionDelete(e){const t=e.params?.sessionId;if(!t)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const s=this.state.sessions.get(t);if(!s)return this.logger.info?.(`[bridge-core] session/delete sessionId=${t} NOT FOUND in local state`),void this.transport.sendAcpError(e.id,Errors.SessionNotFound);const r=s.gatewaySessionKey;this.logger.info?.(`[bridge-core] session/delete sessionId=${t} gatewayKey=${r} gwConnected=${!!this.getGateway()?.isConnected}`);let n=!1;const i=this.getGateway();if(i?.isConnected&&r)try{await i.sessionsDelete(r),n=!0,this.logger.info?.(`[bridge-core] Gateway sessions.delete SUCCESS for key=${r}`)}catch(t){const s=t instanceof Error?t.message:String(t);if(this.logger.info?.(`[bridge-core] Gateway sessions.delete FAILED for key=${r}: ${s}`),!s.includes("Cannot delete the main session"))return void this.transport.sendResult(e.id,{deleted:!1});try{await i.sessionsReset(r),n=!0,this.logger.info?.(`[bridge-core] Gateway sessions.reset SUCCESS for key=${r}`)}catch(t){return this.logger.warn?.(`[bridge-core] Gateway sessions.reset also failed for key=${r}: ${t instanceof Error?t.message:t}`),void this.transport.sendResult(e.id,{deleted:!1})}}else r&&this.logger.warn?.(`[bridge-core] Gateway not connected, proceeding with local-only delete for key=${r}`);void 0!==s.pendingPromptId&&this.failPrompt(s,Errors.SessionDeleted.rpcCode,Errors.SessionDeleted.message),this.state.clearPromptTimeout(s),this.state.clearStreamIdleTimer(s),s.assistantMq?.close(),s.assistantMq=void 0,s.currentRunId&&this.state.promptsByRunId.delete(s.currentRunId);const o=new Set;for(const[e,s]of this.state.toolCallToSessionMap)s===t&&(this.state.toolCallToSessionMap.delete(e),o.add(e));for(const[e,t]of this.state.toolCallIdMap)o.has(t)&&this.state.toolCallIdMap.delete(e);this.state.sessions.delete(t),this.state.sessionsByGatewayKey.delete(r),this.transport.resetSessionUpdateCount(t),n&&this.onSessionDeleted?.(r),this.logger.info?.(`[bridge-core] session/delete DONE sessionId=${t} gatewayKey=${r} deleted=true`),this.transport.sendResult(e.id,{deleted:!0})}async handleSessionClear(e){this.logger.info?.(`[bridge-core] handleSessionClear called, params=${JSON.stringify(e.params)}`);const t=e.params?.sessionId;if(!t)return this.logger.warn?.("[bridge-core] session/clear missing sessionId"),void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const s=this.state.sessions.get(t);if(!s)return this.logger.warn?.(`[bridge-core] session/clear sessionId=${t} not found in state`),void this.transport.sendAcpError(e.id,Errors.SessionNotFound);this.logger.info?.(`[bridge-core] session/clear sessionId=${t} gatewayKey=${s.gatewaySessionKey}`);const r=this.getGateway(),n=r?.isConnected;if(s.promptDone||void 0===s.pendingPromptId&&void 0===s.currentRunId||(this.logger.info?.(`[bridge-core] session/clear: cancelling active run sid=${t} runId=${s.currentRunId}`),n&&(s.currentRunId||s.gatewayRequestId)&&r.agentCancel(s.gatewaySessionKey,{runId:s.currentRunId,requestId:s.gatewayRequestId}),this.endRun(s,{kind:"complete",stopReason:"cancelled"})),n&&s.gatewaySessionKey)try{await r.sessionsReset(s.gatewaySessionKey),this.logger.info?.(`[bridge-core] Gateway sessions.reset SUCCESS for key=${s.gatewaySessionKey}`)}catch(e){this.logger.warn?.(`[bridge-core] Gateway sessions.reset FAILED for key=${s.gatewaySessionKey}: ${e instanceof Error?e.message:e}`)}else this.logger.warn?.(`[bridge-core] session/clear skipped gateway reset: connected=${n}, key=${s.gatewaySessionKey}`);s.chatReplayDedupKeys.clear(),this.logger.info?.("[bridge-core] session/clear dedupKeys cleared, calling onSessionCleared"),this.onSessionCleared?.(t,s.gatewaySessionKey),this.transport.sendResult(e.id,{cleared:!0}),this.logger.info?.("[bridge-core] session/clear DONE, sent cleared=true")}async handleSessionSetMode(e){const t=e.params?.sessionId,s=e.params?.mode,r=t?this.state.sessions.get(t):void 0,n=this.getGateway();if(r&&n?.isConnected&&s){const e={};if("verbose"===s||"detailed"===s?e.verboseLevel="full":"concise"!==s&&"default"!==s||(e.verboseLevel="default"),"reasoning"!==s&&"thinking"!==s||(e.reasoningLevel="stream"),Object.keys(e).length>0)try{await n.sessionsPatch(r.gatewaySessionKey,e)}catch(e){this.logger.warn?.(`[bridge-core] sessions.patch failed: ${e instanceof Error?e.message:e}`)}}this.transport.sendResult(e.id,{mode:s??"default"})}async handleSessionSetModel(e){const t=e.params?.sessionId,s=e.params?.model,r=t?this.state.sessions.get(t):void 0,n=this.getGateway();let i=s??null,o=null;if(r&&n?.isConnected&&s)try{const e=await n.sessionsPatch(r.gatewaySessionKey,{model:s}),t=e?.resolved;t?.model&&(i=t.model),t?.modelProvider&&(o=t.modelProvider)}catch(e){this.logger.warn?.(`[bridge-core] sessions.patch for model failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{model:i,modelProvider:o})}async createAgentShell(e,t,s){const r=this.getGateway();if(!r?.isConnected)throw new Error("gateway not connected");const n=`agent-${randomUUID().replace(/-/g,"").slice(0,12)}`,i=n,o=e,a=join(this.getOpenclawHome(),`workspace-${n}`),l=await r.request("agents.create",{name:i,workspace:a,...s?{model:s}:{},...t?.emoji?{emoji:t.emoji}:{},...t?.avatar?{avatar:t.avatar}:{}}),d=l?.agentId??n,c=l?.workspace??a;if(o)try{await r.request("agents.update",{agentId:d,name:o})}catch(e){this.logger.warn?.(`[bridge-core] createAgentShell: failed to set display name for "${d}": ${e instanceof Error?e.message:e}`)}return{agentId:d,workspace:c}}async handleAgentCreate(e){const t=e.params,s=(t?.name??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing agent name"});const r=this.getGateway();if(r?.isConnected)try{const{agentId:n,workspace:i}=await this.createAgentShell(s,t?.identity,t?.model),o=t?.files??{};for(const[e,t]of Object.entries(o))if("IDENTITY.md"!==e){if("string"==typeof t)try{await r.request("agents.files.set",{agentId:n,name:e,content:t})}catch(t){this.logger.warn?.(`[bridge-core] agent/create: failed to write "${e}" for "${n}": ${t instanceof Error?t.message:t}`)}}else this.logger.warn?.("[bridge-core] agent/create: ignoring IDENTITY.md in files (identity is set via structured fields)");this.logger.info?.(`[bridge-core] Created agent "${n}" (name="${s}") workspace=${i}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/create: agent sync after create failed: ${e instanceof Error?e.message:e}`)}const a=this.agentMapping?.get(n)?.id??"";this.transport.sendResult(e.id,{agentId:n,platformAgentId:a,workspace:i})}catch(t){this.logger.error?.(`[bridge-core] Failed to create agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Create agent failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleApplyTemplate(e){const t=e.params,s=(t?.name??"").trim(),r=(t?.packageUrl??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing agent name"});if(!r)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"packageUrl"});const n=this.getGateway();if(n?.isConnected)try{const n=await fetch(r);if(!n.ok)throw new TemplatePackageError(`failed to download package: HTTP ${n.status}`);const i=Buffer.from(await n.arrayBuffer());if(i.length>MAX_ZIP_BYTES)throw new TemplatePackageError(`package too large: ${i.length} bytes (max ${MAX_ZIP_BYTES})`);const o=t?.sha256?.trim().toLowerCase();if(o){if(createHash("sha256").update(i).digest("hex")!==o)throw new TemplatePackageError("package sha256 mismatch")}const a=parseAndValidateTemplatePackage(i),{agentId:l,workspace:d}=await this.createAgentShell(s,t?.identity,t?.model);let c=0;for(const[e,t]of a.workspaceFiles){const s=resolve(d,e),r=relative(d,s);if(""===r||r.startsWith("..")||path.isAbsolute(r))throw new TemplatePackageError(`refusing to write outside workspace: ${e}`);await mkdir(path.dirname(s),{recursive:!0}),await writeFile(s,t),c++}const g=a.manifest?.slug??"(no manifest)",p=a.manifest?.version??"";this.logger.info?.(`[bridge-core] agent/applyTemplate: applied "${g}${p?`@${p}`:""}" to agent "${l}" (${c} files) workspace=${d}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/applyTemplate: agent sync after apply failed: ${e instanceof Error?e.message:e}`)}const m=this.agentMapping?.get(l)?.id??"";this.transport.sendResult(e.id,{agentId:l,platformAgentId:m,workspace:d})}catch(t){if(t instanceof TemplatePackageError)return this.logger.warn?.(`[bridge-core] agent/applyTemplate: invalid package: ${t.message}`),void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:`Invalid template package: ${t.message}`});this.logger.error?.(`[bridge-core] Failed to apply template for "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Apply template failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleAgentUpdate(e){const t=e.params,s=(t?.agentId??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"agentId"});const r=t?.name?.trim(),n=t?.model?.trim(),i=t?.identity?.emoji?.trim(),o=t?.identity?.avatar?.trim();if(!(r||n||i||o))return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"No updatable fields provided (name/model/identity)"});const a=this.getGateway();if(a?.isConnected)try{const t=await a.request("agents.update",{agentId:s,...r?{name:r}:{},...n?{model:n}:{},...i?{emoji:i}:{},...o?{avatar:o}:{}}),l=t?.agentId??s;this.logger.info?.(`[bridge-core] Updated agent "${l}"${r?` name="${r}"`:""}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/update: agent sync after update failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{agentId:l})}catch(t){this.logger.error?.(`[bridge-core] Failed to update agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Update agent failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleAgentDelete(e){const t=e.params,s=(t?.agentId??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"agentId"});if("main"===normalizeAgentId(s))return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:'"main" cannot be deleted; delete the instance instead'});const r=this.getGateway();if(!r?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);const n=t?.deleteFiles??!0;try{const t=await r.request("agents.delete",{agentId:s,deleteFiles:n}),i=t?.agentId??s;this.logger.info?.(`[bridge-core] Deleted agent "${i}" (deleteFiles=${n})`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/delete: agent sync after delete failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{agentId:i,..."number"==typeof t?.removedBindings?{removedBindings:t.removedBindings}:{}})}catch(t){this.logger.error?.(`[bridge-core] Failed to delete agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Delete agent failed: ${t instanceof Error?t.message:String(t)}`})}}async handleModelsList(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.request("models.list",{});this.transport.sendResult(e.id,s??{models:[]})}catch(t){this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Failed to list models: ${t instanceof Error?t.message:t}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleSkillsList(e){const t=e.params?.agentId,s=await this.fetchSimplifiedSkills(t);this.transport.sendResult(e.id,{skills:s})}async fetchSimplifiedSkills(e){const t=this.getGateway();if(!t?.isConnected)return[];try{const s=await t.skillsStatus(e);if(!s?.skills)return[];const r=s.skills.filter(e=>!1!==e.eligible||!0===e.disabled).sort((e,t)=>e.always&&!t.always?-1:!e.always&&t.always?1:e.name.localeCompare(t.name)).map(e=>({name:e.name,description:e.description,emoji:e.emoji,always:e.always||void 0,bundled:e.bundled||void 0,disabled:e.disabled||void 0,skillKey:e.skillKey||void 0,iconUrl:void 0})),n=await this.getSkillsDir(e);for(const e of r){const t=e.skillKey??e.name;try{const s=await readFile(join(n,t,".beeos-meta.json"),"utf8"),r=JSON.parse(s);r?.iconUrl&&(e.iconUrl=r.iconUrl)}catch{}}return r}catch(e){return this.logger.warn?.(`[bridge-core] Failed to fetch skills: ${e instanceof Error?e.message:e}`),[]}}async pushSkillsList(e){const t=await this.fetchSimplifiedSkills(e);this.transport.sendNotification("session/update",{sessionId:"_system",update:{sessionUpdate:"available_commands_update",commands:t}}),this.writeObs({component:"bridge-core",domain:"lifecycle",name:"skills.pushed",severity:"debug",payload:{count:t.length}})}getOpenclawHome(){return process.env.OPENCLAW_HOME||join(homedir(),".openclaw")}async getSkillsDir(e){const t=this.getOpenclawHome();if(!e||"main"===e)return join(t,"skills");const s=await this.resolveAgentWorkspaceDir(e);return join(s??join(t,`workspace-${e}`),"skills")}async resolveAgentWorkspaceDir(e){const t=this.getGateway();if(!t?.isConnected)return null;try{const s=await t.request("agents.list",{}),r=normalizeAgentId(e),n=s?.agents?.find(e=>normalizeAgentId(e.id)===r);return n?.workspace??null}catch(t){return this.logger.warn?.(`[bridge-core] resolveAgentWorkspaceDir("${e}") failed: ${t instanceof Error?t.message:t}`),null}}async handleSkillsInstall(e){const t=e.params,s=t?.zipUrl,r=t?.files,n=t?.agentId;let i;try{i=validateSkillSlug(t?.slug||t?.name||"")}catch{return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Invalid or missing skill slug"})}if(!r?.length&&!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing skill files or zipUrl"});const o=resolveSkillInstallDir(await this.getSkillsDir(n),i);try{if(await mkdir(o,{recursive:!0}),s){const e=await fetchWithRetry(s,{maxRetries:4,logger:this.logger});await extractZipToDir(e,o)}else if(r?.length){const e=resolve(o);for(const t of r){const s=join(o,t.path);if(!resolve(s).startsWith(e+sep))throw new Error(`File path escapes skill directory: ${t.path}`);await mkdir(join(s,".."),{recursive:!0});const r=await fetch(t.downloadUrl,{signal:AbortSignal.timeout(12e4)});if(!r.ok)throw new Error(`Failed to download ${t.path}: ${r.status}`);const n=Buffer.from(await r.arrayBuffer());await writeFile(s,n)}}if(t?.iconUrl)try{await writeFile(join(o,".beeos-meta.json"),JSON.stringify({iconUrl:t.iconUrl}),"utf8")}catch{}this.logger.info?.(`[bridge-core] Installed skill "${i}"${n?` for agent "${n}"`:""} via ${s?"zip":"files"}`),this.transport.sendResult(e.id,{success:!0}),this.onSkillInstalled?.(i,o),await this.pushSkillsList(n)}catch(t){this.logger.error?.(`[bridge-core] Failed to install skill "${i}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Install failed: ${t instanceof Error?t.message:String(t)}`})}}async handleSkillsUninstall(e){const t=e.params,s=t?.agentId;let r;try{r=validateSkillSlug(t?.slug||t?.name||"")}catch{return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Invalid or missing skill name"})}const n=resolveSkillInstallDir(await this.getSkillsDir(s),r),i=resolveSkillInstallDir(join(homedir(),".agents","skills"),r);try{let t=!1;try{const e=await lstat(n);if(e.isSymbolicLink()){const e=await readlink(n);await rm(n,{force:!0}),await rm(e,{recursive:!0,force:!0}),t=!0}else e.isDirectory()&&(await rm(n,{recursive:!0,force:!0}),t=!0)}catch{}try{const e=await lstat(i);(e.isDirectory()||e.isSymbolicLink())&&(await rm(i,{recursive:!0,force:!0}),t=!0)}catch{}t||this.logger.warn?.(`[bridge-core] Skill "${r}" not found in any known location`),this.logger.info?.(`[bridge-core] Uninstalled skill "${r}"${s?` for agent "${s}"`:""}`),this.transport.sendResult(e.id,{success:!0}),await this.pushSkillsList(s)}catch(t){this.logger.error?.(`[bridge-core] Failed to uninstall skill "${r}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Uninstall failed: ${t instanceof Error?t.message:String(t)}`})}}async handleSkillsUpdate(e){const t=e.params,s=t?.skillKey,r=t?.enabled,n=t?.agentId;if(!s||"boolean"!=typeof r)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing skillKey or enabled"});const i=this.getGateway();if(i?.isConnected)try{const t=await i.skillsUpdate(s,r,n);this.logger.info?.(`[bridge-core] Updated skill "${s}" enabled=${r}${n?` for agent "${n}"`:""}`),this.transport.sendResult(e.id,{ok:t?.ok??!0,skillKey:s,enabled:r}),await this.pushSkillsList(n)}catch(t){this.logger.error?.(`[bridge-core] Failed to update skill "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Update failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.InternalError,{message:"Gateway not connected"})}async handleSessionPrompt(e){const t=e.params?.sessionId,s=e.params?.prompt;if(!t||!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId, prompt"});const{session:r,created:n}=await this.resolveOrCreateSession(t);n&&this.onSessionLoaded?.(r.sessionId,r.gatewaySessionKey,r.platformAgentId);const i=r.sessionId;this.state.lastActiveSessionId=i,this.onPromptStart?.();const o=this.getGateway();if(!o?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);await this.ensureVerboseFull(r);let a=extractPromptBlocks(sanitizePromptPayload(s));const l=a.filter(e=>"text"===e.type&&"text"in e&&"string"==typeof e.text).map(e=>e.text).join("\n");if(r.fileArtifactDisplayMode=prefersChatFileArtifacts(l)?"chat":"auto",!r.title||isPlaceholderTitle(r.title)){const e=a.find(e=>"text"===e.type&&e.text);if(e&&"text"in e&&e.text){const t=stripTransportMetadata(e.text).trim();if(this.logger.info?.(`[bridge-core] title-gen sid=${i} existing="${r.title}" cleanText="${t.slice(0,80)}" isPlaceholder=${isPlaceholderTitle(t)}`),t&&!isPlaceholderTitle(t)){const e=t.slice(0,64).replace(/\n/g," ").trim();r.title=e,r.titleSource="truncated",o?.isConnected&&e&&o.sessionsPatch(r.gatewaySessionKey,{label:e}).catch(e=>{this.logger.debug?.(`[bridge-core] sessionsPatch (title) failed: ${e instanceof Error?e.message:e}`)}),this.transport.sendSessionUpdate(i,{sessionUpdate:"title_update",title:e})}}}const d=buildResolutionPlan(a);if(d.refs.length>0)try{const e=await resolveResources(d,this.writeObs);a=applyResolutions(a,e)}catch(e){this.logger.warn?.(`[bridge-core] Resource pre-resolution failed: ${e instanceof Error?e.message:e}`)}let c;if(this.beeosFileResolver){const e=this.beeosFileResolver.buildResolutionPlan(a);if(e.refs.length>0)try{c=await this.beeosFileResolver.resolveMetadataForPrompt(e)}catch(e){this.logger.warn?.(`[bridge-core] BeeOS file resolution failed: ${e instanceof Error?e.message:e}`)}}const g=toGatewayPrompt(a,{beeosFileResolutionsByUri:c});if("error"in g)return void this.transport.sendAcpError(e.id,Errors.PromptConvertFailed,{message:g.error});const{message:p,attachments:m}=g,h=resolveStandaloneSlashCommandName(a,p)??resolveSlashCmd(a,p),u="string"==typeof h;if(h&&this.handleSlashCommand){const t=this;if(await(async()=>{try{return await t.handleSlashCommand(h)}catch(e){return t.logger.warn?.(`[bridge-core] /${h} handler failed: ${e instanceof Error?e.message:e}`),!1}})())return this.emitPromptAsUserSessionUpdates(r,a,resolveTurnId(r)),this.transport.sendSessionUpdate(i,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:`Loading ${h}...`},timestamp:(new Date).toISOString()},{turnId:resolveTurnId(r)}),void this.transport.sendResult(e.id,{stopReason:"end_turn"})}const f="chat.send";let y=u?p:withUserMessagePrefix(p);const w=this.config.canvasEnabled&&!u&&!0===r.canvasActive&&!r.channelType;if(w){const e=r.promptsSinceCanvasInjection??0;!r.canvasPromptInjected||e>=10?(y=`${CANVAS_TERM_MAPPING}\n\n${y}`,r.canvasPromptInjected=!0,r.promptsSinceCanvasInjection=0,this.logger.debug?.("[bridge-core] Canvas term mapping injected (re-inject cycle)")):r.promptsSinceCanvasInjection=e+1}if(w){const e=this.getCanvasState?.();if(e){const t=e.resolveCanvasForSession(r.gatewaySessionKey);y=`${buildActiveSurfacesContext(e,t)??"[Canvas] Canvas panel is available. Use render_ui for structured/visual content."}\n\n${y}`}const t=r.referencedSurfaceId;t&&(y=`${CANVAS_UPDATE_HINT}\n[IMPORTANT: The user selected canvas surface "${t}" for editing. You MUST call render_ui with id="${t}" to UPDATE this existing surface. Do NOT create a new surface with a different id.]\n${y}`,r.referencedSurfaceId=void 0)}if(!u){const t=parseMentionsParam(e.params?.mentions);if(t.length>0){r.activeMentions=t;y=`${buildMentionInstruction(t)}\n${y}`,this.logger.debug?.(`[bridge-core] delegation mention instruction injected for ${t.length} agent(s)`)}else r.activeMentions=void 0}u&&this.logger.info?.(`[bridge-core] slash command passthrough sessionId=${i} command=/${h}`),r.promptDone||void 0===r.pendingPromptId&&void 0===r.currentRunId||(this.logger.warn?.(`[bridge-core] handleSessionPrompt: force-ending stale run sid=${i} oldRunId=${r.currentRunId} oldPromptId=${r.pendingPromptId}`),(r.currentRunId||r.gatewayRequestId)&&o.agentCancel(r.gatewaySessionKey,{runId:r.currentRunId,requestId:r.gatewayRequestId}),this.endRun(r,{kind:"complete",stopReason:"cancelled"})),this.state.resetForNewRun(r,i,this.transport),r.pendingPromptId=e.id,r.gatewayMethod=f;const I=resolveTurnId(r);this.emitPromptAsUserSessionUpdates(r,a,I),this.transport.sendSessionUpdate(i,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:""},timestamp:(new Date).toISOString()},I?{turnId:I}:void 0);const S=extractCronJobId(p);S&&(r.cronJobId=S),this.schedulePromptTimeout(r);const v=m.length>0?m.map(e=>({type:e.type,content:e.content,...e.mimeType?{mimeType:e.mimeType}:{},...e.fileName?{fileName:e.fileName}:{}})):void 0,b=`req_${randomUUID().replace(/-/g,"")}`,T={sessionKey:r.gatewaySessionKey,message:y,deliver:!1,idempotencyKey:randomUUID()};v?.length&&(T.attachments=v);if(!o.sendFrame({type:"req",id:b,method:f,params:T}))return this.state.clearPromptTimeout(r),r.pendingPromptId=void 0,r.assistantMq?.close(),r.assistantMq=void 0,r.pendingUserTurnUpdates=void 0,void this.transport.sendAcpError(e.id,Errors.SendFailed,{message:"failed to send prompt to gateway"});r.gatewayRequestId=b,this.state.promptsByGatewayRequestId.set(b,r)}replayUserTurnAsChunks(e,t,s,r,n,i,o){const a=splitUserReplayBlocks(s),l=i||void 0!==o?{...i?{turnId:i}:{},...void 0!==o?{seq:o}:{}}:void 0;for(const s of a){let i;if("text"===s.type){if(!s.text)continue;i={type:"text",text:s.text}}else i="resource_link"===s.type?{type:"resource_link",uri:s.uri??"",...s.fileName?{name:s.fileName}:{},...s.mimeType?{mimeType:s.mimeType}:{}}:{type:s.type,...s.mimeType?{mimeType:s.mimeType}:{},...s.fileName?{fileName:s.fileName}:{}};e.sendSessionUpdate(t,{sessionUpdate:"user_message_chunk",content:i,...r?{metadata:r}:{},...n?{timestamp:n}:{}},l)}}async replayAssistantTurnAsStream(e,t,s,r){const n=e=>{if(r||void 0!==e)return{...r?{turnId:r}:{},...void 0!==e?{seq:e}:{}}},i=new Set,o=(s,r,o)=>{if(!s?.length)return;const a=n(o);for(const n of s)n.uri&&!i.has(n.uri)&&(i.add(n.uri),e.sendSessionUpdate(t,{sessionUpdate:"agent_message_chunk",content:{type:"resource_link",uri:n.uri,name:n.name??"file",...n.mimeType?{mimeType:n.mimeType}:{}},...r?{timestamp:r}:{}},a))},a=n(s._seq);if(!s.sourceMessages?.length){const r={sessionUpdate:"history_turn",role:s.role,content:s.content,reasoning:s.reasoning,toolCalls:s.toolCalls,...s.timestamp?{timestamp:s.timestamp}:{}};return s.metadata&&(r.metadata=s.metadata),e.sendSessionUpdate(t,r,a),void o(s.files,s.timestamp,s._seq)}for(const r of s.sourceMessages){const i=r.updateType??"agent_message_chunk",o=n(r._seq);switch(i){case"agent_message_chunk":e.sendSessionUpdate(t,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:r.content},...r.timestamp?{timestamp:r.timestamp}:{},...r.metadata?{metadata:r.metadata}:{}},o);break;case"agent_thought_chunk":e.sendSessionUpdate(t,{sessionUpdate:"agent_thought_chunk",content:{type:"text",text:r.content},...r.timestamp?{timestamp:r.timestamp}:{}},o);break;case"tool_call":{const n=r.toolCallId??"",i=s.toolCalls?.find(e=>e.id===n),a=r.toolName??"tool",l=r.content??"";let d={};if(l)try{d=JSON.parse(l)}catch{}e.sendSessionUpdate(t,buildToolCallPayload({toolCallId:n,toolName:a,args:d,kind:i?.kind,status:i?.status??"in_progress",timestamp:r.timestamp}),o);break}case"tool_call_update":{const n=r.toolCallId??"",i=s.toolCalls?.find(e=>e.id===n),a=r.toolName??i?.name??"tool",l=r.content??i?.output??"";let d=r.files?.map(e=>({uri:e.uri,name:e.name??"file",...e.mimeType?{mimeType:e.mimeType}:{}}));if(d?.length||(d=await readEnrichmentCache(n).catch(()=>{})),!d&&"beeos_upload_file"===a){const e=await readUploadToolResult(n).catch(()=>{});if(e){const t=buildToolResultSessionContentBlocks(a,e).filter(e=>"resource_link"===e.content?.type&&e.content.uri).map(e=>({uri:e.content.uri,name:e.content.name??"file",...e.content.mimeType?{mimeType:e.content.mimeType}:{}}));t.length>0&&(d=t)}}e.sendSessionUpdate(t,buildToolCallUpdatePayload({toolCallId:n,toolName:a,outputText:l,kind:i?.kind,status:i?.status??"completed",resourceLinks:d,timestamp:r.timestamp}),o);break}}}o(s.files,s.timestamp,s._seq)}emitPromptAsUserSessionUpdates(e,t,s){const r=(new Date).toISOString(),n=s?{turnId:s}:void 0;for(const i of t){const t=this.toUserSessionUpdateContent(i);if(!t)continue;const o={sessionUpdate:"user_message_chunk",content:t,timestamp:r};s&&void 0===o._turnId&&(o._turnId=s),this.transport.sendSessionUpdate(e.sessionId,o,n),e.pendingUserTurnUpdates?.push(o)}}toUserSessionUpdateContent(e){if("text"===e.type){if(!e.text)return;return{type:"text",text:e.text}}if("image"===e.type){const t=e.mimeType??e.mime_type??"application/octet-stream",s=e.fileName??e.file_name??e.name;if(!e.data&&!e.uri)return;return{type:"image",...e.data?{data:e.data}:{},...e.uri?{uri:e.uri}:{},...t?{mimeType:t}:{},...s?{fileName:s}:{}}}if("resource_link"===e.type){if(!e.uri)return;return{type:"resource_link",uri:e.uri,...e.title?{title:e.title}:{},...e.name?{name:e.name}:{},...e.mimeType??e.mime_type?{mimeType:e.mimeType??e.mime_type}:{}}}if("file"===e.type){const t=e.mimeType??e.mime_type??"application/octet-stream",s=e.fileName??e.file_name??e.filename??e.name;if(!e.data&&!e.text&&!e.uri)return;return{type:"file",...e.data?{data:e.data}:{},...e.text?{text:e.text}:{},...e.uri?{uri:e.uri}:{},...t?{mimeType:t}:{},...s?{fileName:s}:{}}}if("resource"===e.type){const t=e.resource??{},s=t.uri??e.uri,r=t.mimeType??t.mime_type??e.mimeType??e.mime_type,n=t.text??e.text,i=t.data??e.data,o=t.fileName??t.file_name??t.filename??t.name??e.fileName??e.file_name??e.filename??e.name;if(!s&&!n&&!i)return;return{type:"resource",resource:{...s?{uri:s}:{},...r?{mimeType:r}:{},...n?{text:n}:{},...i?{data:i}:{},...o?{fileName:o}:{}}}}}handleSessionCancel(e,t){const s=t&&"object"==typeof t&&"sessionId"in t?t.sessionId:void 0;if(!s)return void(void 0!==e&&this.transport.sendAcpError(e,Errors.MissingParam,{param:"sessionId"}));const r=this.state.sessions.get(s);if(!r)return void(void 0!==e&&this.transport.sendAcpError(e,Errors.SessionNotFound));const n=this.getGateway(),i=n?.isConnected,o=!(!r.currentRunId&&!r.gatewayRequestId);if(i&&o){n.agentCancel(r.gatewaySessionKey,{runId:r.currentRunId,requestId:r.gatewayRequestId})}this.endRun(r,{kind:"complete",stopReason:"cancelled"})||this.transport.sendSessionUpdate(r.sessionId,{sessionUpdate:"stream_complete",stopReason:"cancelled"},{turnId:resolveTurnId(r)}),void 0!==e&&this.transport.sendResult(e,{})}endRun(e,t){if(e.promptDone)return this.logger.debug?.(`[bridge-core] endRun skipped (promptDone=true) sessionId=${e.sessionId} outcome=${t.kind}`),!1;if(void 0===e.pendingPromptId&&void 0===e.currentRunId)return this.logger.debug?.(`[bridge-core] endRun skipped (no pendingPromptId and no currentRunId) sessionId=${e.sessionId} outcome=${t.kind}`),!1;const s=resolveTurnId(e),r=s?{turnId:s}:void 0;e.promptDone=!0;const n=e.currentRunId;if("complete"===t.kind){if(n&&this.onRunComplete){const s=e.agentAssistantTextSoFar??e.chatAssistantTextSoFar??"";this.onRunComplete(n,s,t.stopReason)}void 0!==e.pendingPromptId&&this.transport.sendResult(e.pendingPromptId,{stopReason:t.stopReason}),this.transport.sendSessionUpdate(e.sessionId,{sessionUpdate:"stream_complete",stopReason:t.stopReason},r),this.tryGenerateTitleFromHistory(e,e.sessionId)}else n&&this.onRunFailed&&this.onRunFailed(n,t.message),void 0!==e.pendingPromptId&&this.transport.sendError(e.pendingPromptId,t.code,t.message),this.transport.sendSessionUpdate(e.sessionId,{sessionUpdate:"stream_complete",stopReason:"error",error:t.message},r);return this.cleanupPrompt(e),this.onRunEnded?.(e,t),!0}schedulePromptTimeout(e){let t;if(this.state.clearPromptTimeout(e),e.cronJobId){const s=this.cronOverrides.get(e.cronJobId)??this.config.cronMaxDurationDefaultMs;t=Math.max(CRON_DURATION_FLOOR_MS,Math.min(this.config.cronMaxDurationCapMs,s))}else t=this.config.promptTimeoutMs??DEFAULT_PROMPT_TIMEOUT_MS;t<=0||(e.promptTimeoutTimer=setTimeout(()=>{void 0===e.pendingPromptId&&void 0===e.currentRunId||((e.currentRunId||e.gatewayRequestId)&&this.getGateway()?.agentCancel(e.gatewaySessionKey,{runId:e.currentRunId,requestId:e.gatewayRequestId}),this.logger.warn?.(`[bridge-core] Prompt timed out sessionId=${e.sessionId} after ${t}ms`),this.failPrompt(e,Errors.PromptTimeout.rpcCode,`Prompt timed out after ${t}ms`))},t),"object"==typeof e.promptTimeoutTimer&&"unref"in e.promptTimeoutTimer&&e.promptTimeoutTimer.unref())}cleanupPrompt(e){this.state.clearPromptTimeout(e),this.state.clearStreamIdleTimer(e);const t=e.currentRunId;if(t){this.state.promptsByRunId.delete(t),this.state.runIdToCronJobId.delete(t),this.state.markRunCompleted(t);const e=`tc_${t}_`;for(const[t,s]of this.state.toolCallIdMap)s.startsWith(e)&&this.state.toolCallIdMap.delete(t)}e.gatewayRequestId&&this.state.promptsByGatewayRequestId.delete(e.gatewayRequestId),e.pendingPromptId=void 0,e.promptDone=void 0,e.currentRunId=void 0,e.gatewayRequestId=void 0,e.assistantStreamStartedAt=void 0,e.gatewayMethod=void 0,e.assistantMq?.close(),e.assistantMq=void 0,e.pendingUserTurnUpdates=void 0}completePrompt(e,t){this.endRun(e,{kind:"complete",stopReason:t})}failPrompt(e,t,s){this.endRun(e,{kind:"error",code:t,message:s})}cleanupAllPendingPrompts(){for(const e of this.state.sessions.values())this.failPrompt(e,Errors.GatewayDisconnected.rpcCode,Errors.GatewayDisconnected.message)}handleGatewayResponse(e){const t=e.id;if(!t)return;const s=this.state.promptsByGatewayRequestId.get(t);if(!s||s.promptDone)return;if(!e.ok){const r=e.error,n=r?.message??"gateway returned error";return this.logger.warn?.(`[bridge-core] handleGatewayResponse: gateway rejected prompt gatewayRequestId=${t} error=${n}`),void this.failPrompt(s,Errors.SendFailed.rpcCode,n)}const r=e.payload,n=r?.runId;n?(s.currentRunId=n,s.assistantStreamStartedAt=Date.now(),this.state.promptsByRunId.set(n,s),this.logger.debug?.(`[bridge-core] handleGatewayResponse: bound runId=${n} gatewayRequestId=${t} sessionId=${s.sessionId}`)):this.logger.debug?.(`[bridge-core] handleGatewayResponse: no runId in payload gatewayRequestId=${t} sessionId=${s.sessionId}`)}maybeCompletePromptFromChatState(e,t){if(e.promptDone||"chat.send"!==e.gatewayMethod)return;const s="string"==typeof t.state?t.state.toLowerCase():void 0;if(s)if("final"===s){const s="string"==typeof t.stopReason?t.stopReason:void 0;this.completePrompt(e,s||"end_turn")}else if("aborted"===s||"cancelled"===s||"cancel"===s)this.completePrompt(e,"cancelled");else if("error"===s){const s=("string"==typeof t.summary?t.summary:void 0)??("string"==typeof t.message?t.message:void 0)??"gateway chat error";this.failPrompt(e,Errors.AgentError.rpcCode,formatFriendlyError(s))}}async handleCronRequest(e){const t=this.getGateway();if(!t?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);const s=e.method.replace("/","."),r={...e.params??{}},n="cron.update"===s;!n||r.patch&&"object"==typeof r.patch||(r.patch={});const i=n?r.patch:r,o=i._beeos_meta;let a;if(delete i._beeos_meta,"cron.add"!==s&&"cron.update"!==s||!0!==i._beeos_internal)void 0!==i._beeos_internal&&delete i._beeos_internal;else if(delete i._beeos_internal,i.delivery={mode:"none"},"cron.add"===s){const e=await this.allocateCronChannel(i.name??"cron");e&&(i.description=encodeBeeosChannelTag(i.description,e))}else{const e=r.id,t="description"in i,s=i.description;let n,o=decodeBeeosChannelId(s);!o&&e&&(o=this.cronChannelCache.get(e)),!o&&e&&(n=await this.lookupCronJobDescription(e),o=decodeBeeosChannelId(n));let l=!1;o||(o=await this.allocateCronChannel(i.name??"cron"),l=!0),o&&(t?i.description=encodeBeeosChannelTag(s,o):l&&(i.description=encodeBeeosChannelTag(n,o)),a=o)}try{const n=await t.request(s,r),l="cron.list"===s||"cron.status"===s?this.enrichCronResponseWithOverrides(n):n;if(this.transport.sendResult(e.id,l??{}),("cron.add"===s||"cron.update"===s)&&n&&"object"==typeof n){const e=n.id;if(e&&void 0!==o?.maxDurationMs){const t=Math.max(CRON_DURATION_FLOOR_MS,Math.min(this.config.cronMaxDurationCapMs,o.maxDurationMs));this.cronOverrides.set(e,t)}}if("cron.remove"===s){const t=e.params?.id;t&&(this.cronOverrides.delete(t),this.cronChannelCache.delete(t))}if(("cron.add"===s||"cron.update"===s)&&n&&"object"==typeof n){const e=n.id,t=decodeBeeosChannelId(i.description)??a;e&&t&&this.setCronChannelCache(e,t)}"cron.add"!==s&&"cron.update"!==s&&"cron.remove"!==s||this.refreshCronIsolatedSessionKeys()}catch(t){const r=t instanceof Error?t.message:"cron request failed";this.logger.warn?.(`[bridge-core] ${s} failed: ${r}`),this.transport.sendAcpError(e.id,Errors.SendFailed,{message:r})}}enrichCronResponseWithOverrides(e){if(!e||"object"!=typeof e)return e;const t=e,s=e=>{if(!e||"object"!=typeof e)return e;const t=e,s=t.id;if("string"!=typeof s)return e;const r=this.cronOverrides.get(s);return"number"!=typeof r?e:{...t,_beeos_meta:{maxDurationMs:r}}};if(Array.isArray(t.jobs))return{...t,jobs:t.jobs.map(s)};if(t.jobs&&"object"==typeof t.jobs){const e=t.jobs,r={};for(const[t,n]of Object.entries(e))r[t]=s(n);return{...t,jobs:r}}return e}async allocateCronChannel(e){if(this.agentFetch&&this.agentGatewayUrl)try{const t=`${this.agentGatewayUrl}/api/v1/channels`,s=await this.agentFetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({participants:[this.instanceId,"service:cron"],metadata:{source:"cron",job_name:e}})});if(!s.ok)return void this.logger.warn?.(`[bridge-core] channel alloc failed: ${s.status}`);return(await s.json()).id}catch(e){return void this.logger.warn?.(`[bridge-core] channel alloc error: ${e instanceof Error?e.message:e}`)}else this.logger.debug?.("[bridge-core] agentFetch/agentGatewayUrl unavailable, skip channel alloc")}async lookupCronJobDescription(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.request("cron.list",{}),r=s?.jobs;if(!Array.isArray(r))return;for(const t of r){if(!t||"object"!=typeof t)continue;const s=t;if(s.id===e)return"string"==typeof s.description?s.description:void 0}}catch(e){this.logger.debug?.(`[bridge-core] cron.list description lookup failed: ${e instanceof Error?e.message:e}`)}}setCronChannelCache(e,t){if(this.cronChannelCache.size>=AcpGatewayBridgeCore.CRON_CHANNEL_CACHE_MAX){const e=this.cronChannelCache.keys().next().value;void 0!==e&&this.cronChannelCache.delete(e)}this.cronChannelCache.set(e,t)}async refreshCronIsolatedSessionKeys(){const e=this.getGateway();if(e?.isConnected)try{const t=await e.request("cron.list",{}),s=t?.jobs;if(!Array.isArray(s))return;const r=new Set,n=[];for(const e of s){if(!e||"object"!=typeof e)continue;const t=e;if("string"==typeof t.id&&n.push(t.id),"isolated"!==t.sessionTarget)continue;const s=t.sessionKey;"string"==typeof s&&s.length>0&&r.add(s)}this.cronIsolatedSessionKeys=r,this.cronOverrides.reconcile(n)}catch(e){this.logger.debug?.(`[bridge-core] refreshCronIsolatedSessionKeys failed: ${e instanceof Error?e.message:e}`)}}}async function fetchWithRetry(e,t={}){const s=t.maxRetries??3;let r;for(let n=0;n<=s;n++){const i=await fetch(e,{signal:AbortSignal.timeout(12e4),redirect:"follow"});if(i.ok)return Buffer.from(await i.arrayBuffer());if(429===i.status||i.status>=500){const o=Number(i.headers.get("retry-after"))||0,a=1e3*Math.max(o,2**n);if(r=new Error(`HTTP ${i.status} from ${e}`),n<s){t.logger?.info?.(`[bridge-core] Download ${i.status}, retry ${n+1}/${s} in ${(a/1e3).toFixed(0)}s`),await new Promise(e=>setTimeout(e,a));continue}}throw new Error(`Failed to download zip: ${i.status}`)}throw r??new Error("Download failed after retries")}const SKILL_ROOT_MARKERS=["SKILL.md","skill.md","SKILL.MD"];async function resolveSkillRoot(e){for(const t of SKILL_ROOT_MARKERS)try{return await stat(join(e,t)),e}catch{}const t=(await readdir(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&!e.name.startsWith(".")&&"__MACOSX"!==e.name);if(1===t.length){const s=join(e,t[0].name);for(const e of SKILL_ROOT_MARKERS)try{return await stat(join(s,e)),s}catch{}return s}return e}async function extractZipToDir(e,t){const s=new AdmZip(e),r=join(t,".beeos-extract-tmp-"+Date.now());try{await mkdir(r,{recursive:!0}),s.extractAllTo(r,!0);const e=await resolveSkillRoot(r),n=await readdir(e,{withFileTypes:!0});let i=0;for(const s of n){if(s.name.startsWith(".beeos-extract-tmp")||"__MACOSX"===s.name)continue;const r=join(e,s.name),n=join(t,s.name);await rename(r,n).catch(async()=>{await cp(r,n,{recursive:!0})}),i++}if(0===i)throw new Error("Zip archive contained no extractable files")}finally{await rm(r,{recursive:!0,force:!0}).catch(()=>{})}}const VALID_SLUG_PATTERN=/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i,NON_ASCII_PATTERN=/[^\x00-\x7F]/;function validateSkillSlug(e){const t=e.trim();if(!t||t.includes("/")||t.includes("\\")||t.includes(".."))throw new Error(`Invalid skill slug: ${e}`);if(NON_ASCII_PATTERN.test(t)||!VALID_SLUG_PATTERN.test(t))throw new Error(`Invalid skill slug: ${e}`);return t}function safeDirName(e){const t=e.trim();return t?t.replaceAll("/","__").replaceAll("\\","__"):t}function resolveSkillInstallDir(e,t){const s=safeDirName(t),r=join(e,s),n=resolve(e),i=resolve(r),o=relative(n,i);if(!o||".."===o||o.startsWith(`..${sep}`)||path.isAbsolute(o))throw new Error("Invalid skill target path");return r}
+import{randomUUID,createHash}from"node:crypto";import{mkdir,writeFile,readFile,rm,lstat,readlink,stat,readdir,rename,cp}from"node:fs/promises";import path from"node:path";import{join,resolve,relative,sep}from"node:path";import{homedir}from"node:os";import AdmZip from"adm-zip";import{sanitizePromptPayload,stripTransportMetadata,isHeartbeatPromptText,isCronPromptText,extractCronJobId,classifyHeartbeatFilter,previewFilteredText}from"../message-filter.js";import{createCronOverridesStore}from"../cron-overrides.js";import{CRON_DURATION_FLOOR_MS}from"../config.js";import{CANVAS_TERM_MAPPING,CANVAS_UPDATE_HINT,buildActiveSurfacesContext}from"../canvas/tools.js";import{parseMentionsParam,buildMentionInstruction}from"../delegation/mention-resolver.js";import{EXTERNAL_PROTOCOL_TAGS}from"./external-protocol-tags.js";import{extractPromptBlocks,toGatewayPrompt,resolveSlashCommandName as resolveSlashCmd}from"./prompt-converter.js";import{loadHistory,loadHistoryPage,groupIntoTurns,splitUserReplayBlocks}from"./history-replay.js";import{LocalSessionHistory}from"./local-session-history.js";import{reconcileMissingArtifacts}from"./missing-artifacts-reconciler.js";import{buildResolutionPlan,resolveResources,applyResolutions}from"./prompt-resource-resolver.js";import{readEnrichmentCache,readUploadToolResult}from"../upload/result-cache.js";import{buildToolResultSessionContentBlocks}from"./tool-result-blocks.js";import{prefersChatFileArtifacts}from"./file-artifact-presenter.js";import{buildToolCallPayload,buildToolCallUpdatePayload}from"./tool-call-payload-builder.js";import{Errors}from"../errors/index.js";import{formatFriendlyError}from"../errors/classify.js";import{resolveChannelFromSessionKey}from"../channel-detection.js";import{resolveTurnId,recordTurnIdForRole,recordToolCallTurnForUpdate}from"./gateway-events.js";import{emitToolResultProjectionForTurn}from"./tool-result-emitter.js";import{extractPersistedToolResultEnvelope,findPersistedToolResultEnvelopeByMessageId}from"./tool-result-transcript.js";import{projectPersistedToolResultForReplay}from"./tool-result-projection.js";import{McpService}from"./mcp-service.js";import{DEFAULT_PROMPT_TIMEOUT_MS}from"./types.js";import{ACP_PROTOCOL_VERSION}from"@beeos-ai/beeos-types/acp";import{parseAndValidateTemplatePackage,TemplatePackageError,MAX_ZIP_BYTES}from"./agent-template-package.js";const AGENT_VALID_ID_RE=/^[a-z0-9][a-z0-9_-]{0,63}$/i,AGENT_INVALID_CHARS_RE=/[^a-z0-9_-]+/g,AGENT_LEADING_DASH_RE=/^-+/,AGENT_TRAILING_DASH_RE=/-+$/,DEFAULT_AGENT_ID="main";export function normalizeAgentId(e){const t=(e??"").trim();return t?AGENT_VALID_ID_RE.test(t)?t.toLowerCase():t.toLowerCase().replace(AGENT_INVALID_CHARS_RE,"-").replace(AGENT_LEADING_DASH_RE,"").replace(AGENT_TRAILING_DASH_RE,"").slice(0,64)||"main":"main"}function narrowContentBlock(e){switch(e.type){case"text":return"string"==typeof e.text?{type:"text",text:e.text}:void 0;case"resource_link":return"string"==typeof e.uri?{type:"resource_link",uri:e.uri,...void 0!==e.name?{name:e.name}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}}:void 0;case"file":return{type:"file",...void 0!==e.text?{text:e.text}:{},...void 0!==e.uri?{uri:e.uri}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}};case"image":return{type:"image",...void 0!==e.uri?{uri:e.uri}:{},...void 0!==e.mimeType?{mimeType:e.mimeType}:{}};default:return}}const DEFAULT_MODE={id:"default",name:"Default",description:"Default agent mode"},USER_MESSAGE_PREFIX="User Message From BeeOS:",USER_MESSAGE_PREFIX_WITH_NEWLINE=`${USER_MESSAGE_PREFIX}\n`,SLASH_COMMAND_NAME_RE=/^[a-z0-9_-]+$/i,HISTORY_PAGE_DEFAULT_LIMIT=100,HISTORY_PAGE_MAX_LIMIT=1e3;function withUserMessagePrefix(e){return e.startsWith(USER_MESSAGE_PREFIX)?e:`${USER_MESSAGE_PREFIX_WITH_NEWLINE}${e}`}const BACKGROUND_SESSION_PATTERNS=[":cron:",":hook:","node-",...EXTERNAL_PROTOCOL_TAGS];function isBackgroundSessionKey(e){return BACKGROUND_SESSION_PATTERNS.some(t=>e.includes(t))}function isSystemDefaultSessionKey(e){const t=e.split(":");if(t.length<3||"agent"!==t[0])return!1;const s=t.slice(2).join(":");return"main"===s||s===t[1]}function isPlaceholderTitle(e){return!e||"New chat"===e||(!!/^[0-9a-f]{6,12}\s*\(20\d{2}/i.test(e)||(!!/^Sender\s*\(untrusted/i.test(e)||!!/^Conversation\s+info\s*\(untrusted/i.test(e)))}function cleanGatewayDerivedTitle(e){if(!e)return;let t=stripTransportMetadata(e);return/^\[System\b/.test(t)?void 0:(t=t.trim(),t||void 0)}function mergePersistedToolResultEnvelopes(e,t){if(e||t)return{toolName:e?.toolName||t?.toolName||"tool",...e?.toolCallId||t?.toolCallId?{toolCallId:e?.toolCallId??t?.toolCallId}:{},...e?.rawText??t?.rawText?{rawText:e?.rawText??t?.rawText}:{},...void 0!==e?.rawResult||void 0!==t?.rawResult?{rawResult:e?.rawResult??t?.rawResult}:{},...e?.timestamp||t?.timestamp?{timestamp:e?.timestamp??t?.timestamp}:{}}}function resolveStandaloneSlashCommandName(e,t){if(0===e.length)return;if(e.some(e=>"text"!==e.type))return;const s=t.trim();if(!s||s.includes("\n")||!s.startsWith("/"))return;const r=s.match(/^\/([^\s:]+)(?::|\s|$)/)?.[1]?.trim();return r&&!r.includes("/")&&SLASH_COMMAND_NAME_RE.test(r)?r.toLowerCase():void 0}export const BEEOS_CHANNEL_TAG_RE=/<!-- beeos:channel=(.+?) -->/;export function encodeBeeosChannelTag(e,t){const s=`\x3c!-- beeos:channel=${t} --\x3e`,r=stripBeeosChannelTag(e);return r?`${r}\n${s}`:s}export function decodeBeeosChannelId(e){if(!e)return;const t=BEEOS_CHANNEL_TAG_RE.exec(e);return t?.[1]}export function stripBeeosChannelTag(e){return e?e.replace(/\n?<!-- beeos:channel=.+? -->/g,"").trim():""}function deriveSessionId(e,t){const s=createHash("sha256").update(`${t}:${e}`).digest("hex").substring(0,32);return`session:${s.slice(0,8)}-${s.slice(8,12)}-${s.slice(12,16)}-${s.slice(16,20)}-${s.slice(20,32)}`}function parseAgentIdFromKey(e){const t=e.split(":");return(t.length>=3&&"agent"===t[0]?t[1]:"")||"main"}function createSessionObject(e){const t=parseAgentIdFromKey(e.gatewayKey);return{sessionId:deriveSessionId(e.gatewayKey,e.instanceId),gatewaySessionKey:e.gatewayKey,agentId:t,platformAgentId:e.resolvePlatformAgentId?.(t),createdAt:Date.now(),chatReplayDedupKeys:new Set,cwd:e.cwd,title:e.title,channelType:resolveChannelFromSessionKey(e.gatewayKey,e.thirdPartyChannels)}}class HistoryUpdateRecorder{transport;updates=[];constructor(e){this.transport=e}sendSessionUpdate(e,t,s){const r=this.transport.materializeSessionUpdate(t,s);return null!==r&&this.updates.push(r),!0}}export class AcpGatewayBridgeCore{state;transport;config;logger;writeObs;getGateway;thirdPartyChannels;beeosFileResolver;agentFetch;agentGatewayUrl;triggerAgentSync;cronChannelCache=new Map;static CRON_CHANNEL_CACHE_MAX=256;localSessionHistory;mcp;initialized=!1;agentMapping=null;_syncResolvers=[];_mappingReadyCallbacks=[];_mappingUpdateCallbacks=[];cronIsolatedSessionKeys=new Set;cronOverrides;setAgentMapping(e){this.agentMapping=e;for(const t of this.state.sessions.values())!t.platformAgentId&&t.agentId&&(t.platformAgentId=e.get(t.agentId)?.id);for(const e of this._syncResolvers)e();this._syncResolvers=[];for(const e of this._mappingReadyCallbacks)e();this._mappingReadyCallbacks=[];for(const t of this._mappingUpdateCallbacks)t(e)}onceAgentMappingReady(e){this.agentMapping&&this.agentMapping.size>0?e():this._mappingReadyCallbacks.push(e)}onAgentMappingUpdated(e){this._mappingUpdateCallbacks.push(e),this.agentMapping&&this.agentMapping.size>0&&e(this.agentMapping)}markAgentSyncDone(){for(const e of this._syncResolvers)e();this._syncResolvers=[]}waitForAgentMapping(e=15e3){return this.agentMapping?Promise.resolve():new Promise(t=>{this._syncResolvers.push(t);const s=setTimeout(()=>{const e=this._syncResolvers.indexOf(t);-1!==e&&this._syncResolvers.splice(e,1),t()},e);"object"==typeof s&&"unref"in s&&s.unref()})}handleTerminalRequest=null;handleTerminalNotification=null;onRunComplete=null;onRunFailed=null;onRunEnded=null;handleSlashCommand=null;onPromptStart=null;instanceId;constructor(e){this.state=e.state,this.transport=e.transport,this.config=e.config,this.logger=e.logger,this.writeObs=e.writeObs,this.getGateway=e.getGateway,this.instanceId=e.instanceId||"unknown",this.thirdPartyChannels=e.thirdPartyChannels??new Set,this.beeosFileResolver=e.beeosFileResolver,this.agentFetch=e.agentFetch,this.agentGatewayUrl=e.agentGatewayUrl,this.triggerAgentSync=e.triggerAgentSync,this.localSessionHistory=new LocalSessionHistory({logger:this.logger}),this.cronOverrides=createCronOverridesStore(this.logger),this.mcp=new McpService({transport:this.transport,logger:this.logger,state:this.state}),this.transport.setSessionUpdateObserver((e,t,s)=>{const r=s?.turnId;if(!r)return;const n=this.state.sessions.get(e);n&&(recordTurnIdForRole(n,t,r),recordToolCallTurnForUpdate(n,t,r))})}resolvePlatformAgentId(e){return this.agentMapping?.get(e)?.id}getDefaultAgentId(){return this.agentMapping&&this.agentMapping.size>0?this.agentMapping.keys().next().value??"main":"main"}registerSession(e,t={}){const{ensureVerbose:s=!0}=t;this.state.sessions.has(e.sessionId);this.state.sessions.set(e.sessionId,e),this.state.sessionsByGatewayKey.set(e.gatewaySessionKey,e),s&&this.ensureVerboseFull(e),this.subscribeSessionMessages(e)}async ensureVerboseFull(e){if(e.verbosePatched)return;const t=this.getGateway();if(t?.isConnected){e.verbosePatched=!0;try{await t.sessionsPatch(e.gatewaySessionKey,{verboseLevel:"full"})}catch(t){e.verbosePatched=!1,this.logger.debug?.(`[bridge-core] ensureVerboseFull failed: ${t instanceof Error?t.message:t}`)}}}ensureSessionForKey(e){const t=this.state.findSessionByKey(e);if(t)return t;const s=createSessionObject({gatewayKey:e,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels});return this.registerSession(s),this.logger.debug?.(`[bridge-core] ensureSessionForKey: lazily created session sid=${s.sessionId} key=${e}`),s}async preloadSessionsFromGateway(){const e=this.getGateway();if(e?.isConnected)try{const t=await e.sessionsList();if(!t||"object"!=typeof t)return;const s=t.sessions;if(!Array.isArray(s))return;let r=0;for(const e of s){const t=e,s=t.sessionKey??t.key??t.id??t.name;if(!s||"string"!=typeof s)continue;if(this.state.findSessionByKey(s))continue;const n=t.label||t.derivedTitle||t.title||void 0,i=n&&!isPlaceholderTitle(n)?n:void 0,o=createSessionObject({gatewayKey:s,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,title:i});this.registerSession(o,{ensureVerbose:!1}),r++}r>0&&this.logger.info?.(`[bridge-core] preloadSessions: loaded ${r} session(s) from gateway`)}catch(e){this.logger.debug?.("[bridge-core] preloadSessions failed:",e)}else this.logger.debug?.("[bridge-core] preloadSessions skipped: gateway not connected")}async handleRequest(e){this.writeObs({component:"bridge-core",domain:"forward",name:`rpc.request.${e.method}`,severity:"debug",payload:{id:e.id,method:e.method}});const t=e;try{switch(t.method){case"initialize":this.handleInitialize(t);break;case"ping":this.transport.sendResult(t.id,{pong:!0});break;case"session/new":await this.handleSessionNew(t);break;case"session/load":await this.handleSessionLoad(t);break;case"session/list":await this.handleSessionList(t);break;case"session/rename":this.handleSessionRename(t);break;case"session/delete":await this.handleSessionDelete(t);break;case"session/clear":await this.handleSessionClear(t);break;case"session/prompt":await this.handleSessionPrompt(t);break;case"session/set_mode":await this.handleSessionSetMode(t);break;case"session/set_model":await this.handleSessionSetModel(t);break;case"agent/create":await this.handleAgentCreate(t);break;case"agent/update":await this.handleAgentUpdate(t);break;case"agent/delete":await this.handleAgentDelete(t);break;case"agent/applyTemplate":await this.handleApplyTemplate(t);break;case"skills/list":await this.handleSkillsList(t);break;case"skills/install":await this.handleSkillsInstall(t);break;case"skills/uninstall":await this.handleSkillsUninstall(t);break;case"skills/update":await this.handleSkillsUpdate(t);break;case"models/list":await this.handleModelsList(t);break;case"session/cancel":this.handleSessionCancel(t.id,t.params);break;case"cron/list":case"cron/status":case"cron/add":case"cron/update":case"cron/remove":case"cron/run":case"cron/runs":await this.handleCronRequest(t);break;default:"_beeos/session/history"===e.method?await this.handleSessionHistoryPage(e):"mcp/list"===e.method?await this.mcp.handleList(e):"mcp/set"===e.method?await this.mcp.handleSet(e):"mcp/unset"===e.method?await this.mcp.handleUnset(e):e.method.startsWith("terminal/")&&this.handleTerminalRequest?await this.handleTerminalRequest(e):this.transport.sendAcpError(e.id,Errors.MethodNotFound,{message:`Method not found: ${e.method}`})}}catch(t){this.transport.sendAcpError(e.id,Errors.InternalError,{message:t instanceof Error?t.message:"Internal error"})}}handleCanvasNotification=null;getCanvasState=null;onSessionLoaded=null;onSkillInstalled=null;onSessionDeleted=null;onSessionCleared=null;handleNotification(e){switch(e.method){case"session/cancel":this.handleSessionCancel(void 0,e.params);break;case"canvas/toggle":case"canvas/clear":this.handleCanvasNotification?this.handleCanvasNotification(e.method,e.params):this.logger.debug?.(`[bridge-core] Canvas notification ignored (canvas disabled): ${e.method}`);break;case"canvas/reference":{const t=e.params,s=t?.surfaceId,r=this.state.resolveSessionFromParams(t);if(!r){this.logger.warn?.(`[bridge-core] canvas/reference ignored — no session found for sessionId=${t?.sessionId}`);break}r.referencedSurfaceId=s||void 0,this.logger.debug?.(`[bridge-core] Canvas reference ${s?"set":"cleared"}: ${s??"(none)"}`);break}default:e.method.startsWith("terminal/")&&this.handleTerminalNotification?this.handleTerminalNotification(e.method,e.params):this.logger.debug?.(`[bridge-core] Unknown notification: ${e.method}`)}}handleInitialize(e){this.initialized=!0;const t=this.transport.forwardControl;!1===e.params?.forwardThinking&&(t.forwardThinking=!1),!1===e.params?.forwardToolCalls&&(t.forwardToolCalls=!1),this.transport.sendResult(e.id,{protocolVersion:ACP_PROTOCOL_VERSION,agentCapabilities:{loadSession:!0,skills:!0,multipleSessions:!0,sessionCapabilities:{"web-ssh":!!this.config.bridge.shell.enabled,canvas:!!this.config.canvasEnabled},promptCapabilities:{image:!0,audio:!1,embeddedContext:!0},mcp:{}},agentInfo:{name:"beeos-claw",title:"BeeOS Agent Bridge",version:"0.1.0"},_meta:{},authMethods:[]})}async handleSessionNew(e){const t=`agent:${"string"==typeof e.params?.agentId&&e.params.agentId||this.config.gateway.agentId||this.getDefaultAgentId()}:${randomUUID()}`,s="string"==typeof e.params?.cwd?e.params.cwd:".",r=createSessionObject({gatewayKey:t,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,cwd:s});this.registerSession(r,{ensureVerbose:!1}),this.transport.sendResult(e.id,{sessionId:r.sessionId,modes:{availableModes:[{...DEFAULT_MODE}],currentModeId:DEFAULT_MODE.id},_meta:{sessionKey:t,agentId:r.agentId,platformAgentId:r.platformAgentId??null}}),this.fetchHistoryInBackground(t)}fetchHistoryInBackground(e){const t=this.getGateway();t?.isConnected&&loadHistory(t,e,50).catch(e=>{this.logger.debug?.(`[bridge-core] Background history fetch failed: ${e instanceof Error?e.message:e}`)})}async subscribeSessionMessages(e){if(e.messageSubscriptionActive)return;const t=this.getGateway();if(t?.isConnected)try{await t.sessionsMessagesSubscribe(e.gatewaySessionKey),e.messageSubscriptionActive=!0,this.logger.debug?.(`[bridge-core] session.message subscribed sessionKey=${e.gatewaySessionKey}`)}catch(t){this.logger.debug?.(`[bridge-core] session.message subscribe failed key=${e.gatewaySessionKey}: ${t instanceof Error?t.message:t}`)}}async resubscribeAllSessionMessages(){for(const e of this.state.sessions.values())e.messageSubscriptionActive=!1,await this.subscribeSessionMessages(e)}handleSessionMessage(e){const t=e?.sessionKey,s=e?.messageId;if(!t||!s)return;const r=this.state.sessionsByGatewayKey.get(t);if(!r)return;const n=e.message?.role;if("toolResult"===n||"tool"===n)return void this.handlePersistedToolResultMessage(r,e).catch(e=>{this.logger.warn?.(`[bridge-core] persisted toolResult handling failed sessionKey=${t} messageId=${s}: ${e instanceof Error?e.message:String(e)}`)});const i="user"===n?"user":"system"===n?"system":"assistant",o=r.lastTurnIdByRole?.[i];if(!o)return void this.logger.debug?.(`[bridge-core] session.message skipped: no lastTurnId role=${i} sessionKey=${t} messageId=${s}`);const a=e.message?.timestamp,l="number"==typeof a&&a>0?new Date(a).toISOString():void 0,d={turnId:o};"number"==typeof e.messageSeq&&(d.seq=e.messageSeq),this.transport.sendSessionUpdate(r.sessionId,{sessionUpdate:"message_id_bind",role:i,messageId:s,...l?{timestamp:l}:{}},d),r.lastTurnIdByRole&&(r.lastTurnIdByRole[i]=void 0),"assistant"===i&&reconcileMissingArtifacts({localHistory:this.localSessionHistory,transport:this.transport,config:this.config,logger:this.logger,writeObs:this.writeObs,getCanvasState:()=>this.getCanvasState?.()??null,isSessionAlive:e=>this.state.sessions.has(e)},{session:r,turnId:o,messageId:s,runId:void 0})}async handlePersistedToolResultMessage(e,t){const s=t.messageId;if(!s)return;const r=extractPersistedToolResultEnvelope(t.message),n=this.extractPersistedToolResultFromHistory(e,s),i=mergePersistedToolResultEnvelopes(n,r);if(!i?.toolCallId)return void this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.skipped_no_tool_call_id",severity:"warn",payload:{sessionId:e.sessionId,messageId:s}});n&&this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.hydrated_from_history",severity:"debug",payload:{sessionId:e.sessionId,messageId:s,toolCallId:i.toolCallId,toolName:i.toolName}});const o=e.toolCallTurns?.get(i.toolCallId),a=o?.turnId??resolveTurnId(e);if(!a)return void this.writeObs({component:"bridge-core",domain:"tool_result",name:"tool_result.skipped_no_turn",severity:"warn",payload:{sessionId:e.sessionId,messageId:t.messageId,toolCallId:i.toolCallId,toolName:i.toolName}});const l=projectPersistedToolResultForReplay({toolCallId:i.toolCallId,toolName:i.toolName||o?.toolName||"tool",...i.rawText?{rawText:i.rawText}:{},...i.rawResult?{rawResult:i.rawResult}:{},...i.timestamp?{timestamp:i.timestamp}:{}});await emitToolResultProjectionForTurn({session:e,projection:l,toolCallId:i.toolCallId,turnId:a,config:this.config,logger:this.logger,writeObs:this.writeObs,getCanvasState:()=>this.getCanvasState?.()??null,sendUpdate:s=>(a&&void 0===s._turnId&&(s._turnId=a),this.transport.sendSessionUpdate(e.sessionId,s,{turnId:a,..."number"==typeof t.messageSeq?{seq:t.messageSeq}:{}}))})}extractPersistedToolResultFromHistory(e,t){if(!e.agentId)return;const s=this.localSessionHistory.readEntries({agentId:e.agentId,sessionKey:e.gatewaySessionKey,sessionId:e.sessionId});return findPersistedToolResultEnvelopeByMessageId(s,t)}async recoverSessionFromGateway(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.sessionsList();if(!s||"object"!=typeof s)return;const r=s.sessions;if(!Array.isArray(r))return;for(const t of r){const s=t,r=s.sessionKey??s.key??s.id??s.name;if(r&&"string"==typeof r&&deriveSessionId(r,this.instanceId)===e){const e=s.label||s.derivedTitle||s.title||void 0,t=e&&!isPlaceholderTitle(e)?e:void 0,n=createSessionObject({gatewayKey:r,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,title:t});return this.registerSession(n),n}}}catch(e){this.logger.debug?.("[bridge-core] recoverSessionFromGateway failed:",e)}}async resolveOrCreateSession(e){let t=this.state.sessions.get(e);if(!t&&e.startsWith("agent:")&&(t=this.state.findSessionByKey(e)),t||e.startsWith("agent:")||(t=await this.recoverSessionFromGateway(e)),t)return{session:t,created:!1};const s=e.startsWith("agent:"),r=this.config.gateway.agentId||this.getDefaultAgentId();return t=createSessionObject({gatewayKey:s?e:`agent:${r}:${e}`,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels}),this.registerSession(t),{session:t,created:!0}}async handleSessionLoad(e){const t=e.params?.sessionId;if(!t)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const{session:s}=await this.resolveOrCreateSession(t),r=s.sessionId;this.state.lastActiveSessionId=r,s.chatReplayDedupKeys.clear(),s.sessionLoadInProgress=!0;try{const e=await this.emitHistoryTurns(s);this.emitCurrentStreamSnapshot(s,e)}finally{s.sessionLoadInProgress=!1}this.transport.sendResult(e.id,{sessionId:r}),this.onSessionLoaded?.(r,s.gatewaySessionKey,s.platformAgentId),this.pushSkillsList().catch(e=>{this.logger.warn?.(`[bridge-core] pushSkillsList failed: ${e instanceof Error?e.message:e}`)})}async emitHistoryTurns(e){const t=new Set,s=e.sessionId;try{const r=this.getGateway(),n=e.assistantMq&&!e.assistantMq.closed,i=n?null:r,o=await loadHistory(i,e.gatewaySessionKey,100,{localHistory:this.localSessionHistory,agentId:e.agentId,sessionId:e.sessionId,logger:this.logger,emitObs:e=>{this.writeObs({component:"history-replay",domain:"lifecycle",name:e.name,severity:e.severity,payload:e.payload})}}),a=groupIntoTurns(o),l=a.filter(e=>"user"===e.role).length,d=a.filter(e=>"assistant"===e.role).length,c=a.filter(e=>e.toolCalls?.length).length,g=a.reduce((e,t)=>e+(t.toolCalls?.length??0),0);if(this.logger.debug?.(`[bridge-core] handleSessionLoad sid=${s} messages=${o.length} turns=${a.length} userTurns=${l} asstTurns=${d} turnsWithToolCalls=${c} totalToolCalls=${g}`),l>0&&e.pendingUserTurnUpdates&&e.pendingUserTurnUpdates.length>0&&(e.pendingUserTurnUpdates=[]),a.length>0&&isPlaceholderTitle(e.title)&&"manual"!==e.titleSource){const t=a.find(e=>{if("user"!==e.role)return!1;if("internal_system"===e.provenance?.kind)return!1;if(isCronPromptText(e.content))return!1;const t=stripTransportMetadata(e.content).trim();return t.length>0&&!/^Sender\s*\(untrusted/i.test(t)});if(t?.content){const r=stripTransportMetadata(t.content).trim().slice(0,64).replace(/\n/g," ").trim();if(r){e.title=r,e.titleSource="truncated";const t=this.getGateway();t?.isConnected&&t.sessionsPatch(e.gatewaySessionKey,{label:r}).catch(()=>{}),this.transport.sendSessionUpdate(s,{sessionUpdate:"title_update",title:r}),this.tryGenerateTitleFromHistory(e,s,a)}}}const p=t=>`history:${e.gatewaySessionKey}:${t}`;let m=-1;if(n)for(let e=a.length-1;e>=0;e--)if("assistant"===a[e].role){m=e;break}const{replayedToolCallIds:h,streamCompleteCount:u}=await this.replayHistoryTurnsToSink(e,a,this.transport,{mqActive:Boolean(n),lastAsstIdx:m,turnIdFor:(e,t)=>p(t)});for(const e of h)t.add(e);this.logger.debug?.(`[bridge-core] emitHistoryTurns DONE sid=${s} historyStreamCompleteEmitted=${u} replayedToolCallIds=${t.size}`)}catch(e){this.logger.warn?.("[bridge-core] Failed to load session history:",e)}return t}async replayHistoryTurnsToSink(e,t,s,r){const n=e.sessionId,i=new Set;let o=0;for(let a=0;a<t.length;a++){const l=t[a],d=r.turnIdFor(l,a);if(r.mqActive&&a===r.lastAsstIdx)this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] assistant — mq active, deferring to emitCurrentStreamSnapshot`);else if("user"!==l.role||"internal_system"!==l.provenance?.kind)if("user"===l.role&&/^\s*system\s*\(untrusted[^)]*\)/i.test(l.content))this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] system-injected user message`);else if("user"===l.role&&isHeartbeatPromptText(l.content))this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] heartbeat cron prompt sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);else if("user"===l.role&&isCronPromptText(l.content))this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] cron-triggered user message sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);else{if("assistant"===l.role){const t=classifyHeartbeatFilter(l.content);if(t.filtered){this.logger.info?.(`[bridge-core] SKIP history_turn[${a}] heartbeat assistant reply reason=${t.reason} sessionId=${e.sessionId} contentLen=${l.content.length} preview="${previewFilteredText(l.content)}"`);continue}}if("system"!==l.role)if(this.logger.debug?.(`[bridge-core] SENDING history_turn[${a}] role=${l.role} contentLen=${l.content.length} content=${JSON.stringify(l.content.slice(0,80))} tcCount=${l.toolCalls?.length??0}`),"user"===l.role)this.replayUserTurnAsChunks(s,n,l.content,l.metadata,l.timestamp,d,l._seq);else{if(await this.replayAssistantTurnAsStream(s,n,l,d),l.toolCalls)for(const e of l.toolCalls)e.id&&i.add(e.id);s.sendSessionUpdate(n,{sessionUpdate:"stream_complete",stopReason:"end_turn"},{turnId:d}),o+=1}else this.logger.debug?.(`[bridge-core] SENDING system_message[${a}] contentLen=${l.content.length}`),s.sendSessionUpdate(n,{sessionUpdate:"system_message_chunk",content:{type:"text",text:l.content},metadata:l.metadata,...l.timestamp?{timestamp:l.timestamp}:{}},{turnId:d,...void 0!==l._seq?{seq:l._seq}:{}})}else this.logger.debug?.(`[bridge-core] SKIP history_turn[${a}] internal_system user message`)}return{replayedToolCallIds:i,streamCompleteCount:o}}async handleSessionHistoryPage(e){const t=e.params??{},s="string"==typeof t.sessionId?t.sessionId:"";if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const r="string"==typeof t.cursor&&t.cursor.length>0?t.cursor:void 0,n="number"==typeof t.limit&&Number.isFinite(t.limit)&&t.limit>0?Math.min(1e3,Math.floor(t.limit)):100,{session:i}=await this.resolveOrCreateSession(s),o=this.getGateway(),a=await loadHistoryPage(o,i.gatewaySessionKey,{...r?{cursor:r}:{},limit:n,logger:this.logger}),l=groupIntoTurns(a.messages),d=new HistoryUpdateRecorder(this.transport);await this.replayHistoryTurnsToSink(i,l,d,{mqActive:!1,lastAsstIdx:-1,turnIdFor:(e,t)=>void 0!==e._seq?`history:${i.gatewaySessionKey}:seq:${e._seq}`:`history:${i.gatewaySessionKey}:seq:none:${r??"head"}:${t}`}),this.logger.debug?.(`[bridge-core] _beeos/session/history sid=${i.sessionId} cursor=${r??"<head>"} limit=${n} turns=${l.length} updates=${d.updates.length} hasMore=${a.hasMore} nextCursor=${a.nextCursor??"<none>"}`),this.transport.sendResult(e.id,{updates:d.updates,...a.nextCursor?{nextCursor:a.nextCursor}:{},hasMore:a.hasMore})}emitCurrentStreamSnapshot(e,t){const s=e.pendingUserTurnUpdates;if(s&&s.length>0)for(const t of s)this.transport.sendSessionUpdate(e.sessionId,t);const r=e.assistantMq;if(r&&!r.closed){const s=r.peek(0);let n=0;if(t&&t.size>0)for(let e=0;e<s.length;e++){const r=s[e],i=r.sessionUpdate,o=r.toolCallId;if("tool_call"!==i&&"tool_call_update"!==i||!o||!t.has(o)){if("agent_message_chunk"===i){if(""===(r.content?.text??"").trim()&&e<s.length-1){const r=s[e+1];if(("tool_call"===r.sessionUpdate||"tool_call_update"===r.sessionUpdate)&&r.toolCallId&&t.has(r.toolCallId)){n=e+1;continue}}break}break}n=e+1}const i=resolveTurnId(e),o=i?{turnId:i}:void 0;for(let t=n;t<s.length;t++)this.transport.sendSessionUpdate(e.sessionId,s[t],o)}}async handleSessionList(e){const t=[];for(const[,e]of this.state.sessions)isBackgroundSessionKey(e.gatewaySessionKey)||this.cronIsolatedSessionKeys.has(e.gatewaySessionKey)||t.push({sessionId:e.sessionId,title:e.title||"New chat",cwd:e.cwd,updatedAt:e.lastStreamActivityTs??e.createdAt,agentId:e.agentId,platformAgentId:e.platformAgentId,deletable:!isSystemDefaultSessionKey(e.gatewaySessionKey)});const s=this.getGateway();if(s?.isConnected)try{const e=await s.sessionsList();if(e&&"object"==typeof e&&Array.isArray(e.sessions)){const s=e.sessions;for(const e of s){const s=e,r=s.sessionKey??s.key??s.id??s.name;if(!r||"string"!=typeof r)continue;if(isBackgroundSessionKey(r))continue;if(this.cronIsolatedSessionKeys.has(r))continue;const n=deriveSessionId(r,this.instanceId),i=t.find(e=>e.sessionId===r||e.sessionId===n||this.state.sessions.get(e.sessionId)?.gatewaySessionKey===r),o=s.label||cleanGatewayDerivedTitle(s.derivedTitle)||s.title||void 0,a=o&&!isPlaceholderTitle(o)?o:void 0,l=s.model,d=s.modelProvider;if(i){if(a&&isPlaceholderTitle(i.title)){i.title=a;const e=this.state.sessions.get(i.sessionId);e&&isPlaceholderTitle(e.title)&&(e.title=a)}const e=s.updatedAt;e&&(i.updatedAt=e),l&&(i.model=l),d&&(i.modelProvider=d)}else{const e=createSessionObject({gatewayKey:r,instanceId:this.instanceId,resolvePlatformAgentId:e=>this.resolvePlatformAgentId(e),thirdPartyChannels:this.thirdPartyChannels,cwd:s.cwd,title:a});this.registerSession(e,{ensureVerbose:!1}),t.push({sessionId:e.sessionId,title:a||"",cwd:s.cwd,updatedAt:s.updatedAt,agentId:e.agentId,platformAgentId:e.platformAgentId,deletable:!isSystemDefaultSessionKey(r),model:l,modelProvider:d})}}}}catch(e){this.logger.debug?.("[bridge-core] sessions.list enrichment failed:",e)}t.sort((e,t)=>(t.updatedAt??0)-(e.updatedAt??0)||e.sessionId.localeCompare(t.sessionId)),this.transport.sendResult(e.id,{sessions:t})}handleSessionRename(e){const t=e.params?.sessionId,s=e.params?.title;if(!t||!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId, title"});const r=s.slice(0,64),n=this.state.sessions.get(t);if(!n)return void this.transport.sendAcpError(e.id,Errors.SessionNotFound);n.title=r,n.titleSource="manual";const i=n.gatewaySessionKey,o=this.getGateway();o?.isConnected&&o.sessionsPatch(i,{label:r}).catch(e=>{this.logger.debug?.(`[bridge-core] sessionsPatch (rename) failed: ${e instanceof Error?e.message:e}`)}),this.transport.sendResult(e.id,{sessionId:t,title:r})}static TITLE_TEMPLATES=[{match:["今日日报","日报"],zh:"今日工作日报",en:"Daily Work Log"},{match:["周报","周报总结","本周周报"],zh:"本周工作周报",en:"Weekly Work Report"},{match:["月报","月度汇报","月度总结"],zh:"本月工作月报",en:"Monthly Work Report"},{match:["工作日志","日志"],zh:"工作日志整理",en:"Work Log Review"},{match:["晨会","今日晨会"],zh:"今日晨会纪要",en:"Daily Standup Notes"},{match:["复盘","今日复盘"],zh:"今日工作复盘",en:"Daily Retrospective"},{match:["新会话","new chat","new conversation"],zh:"新会话",en:"New Conversation"}];static TITLE_SYSTEM_PROMPT='You are a conversation title generator. Your task is to generate a concise, human-readable title summarizing the topic of the user\'s question together with the assistant\'s answer.\n\n### Rules:\n- Length: 3-6 words in English, or 6-20 characters in Chinese (up to 24 if needed to keep all key domain terms intact).\n- Language: Match the user\'s input language exactly. Mixed zh/en input → use the dominant language.\n- Extract the core topic (noun-centric) of the Q&A exchange, not the action verb.\n- Use the assistant\'s answer to disambiguate or enrich the topic when the question alone is vague (e.g. "帮我看下" + an answer about x402 → "x402 支付集成").\n- No punctuation, no quotation marks, no emojis, no markdown.\n- No prefix like "Title:" or "Here is". Output the title only.\n- Avoid generic words: "help", "question", "chat", "problem", "task".\n- If both the question and answer are too vague to summarize, return "新会话" (for zh) or "New Conversation" (for en).\n\n### Input Format:\nThe user message will contain both the question and the assistant\'s answer, delimited like this:\n[User Question]\n...question text...\n\n[Assistant Answer]\n...answer text (may be truncated with "..." in the middle)...\n\n### Output Format:\nRespond ONLY with valid JSON, no other text:\n{"title": "<your title here>"}\n\n### Examples:\nInput:\n[User Question]\n帮我写一个关于BeeOS设备接入的PRD\n\n[Assistant Answer]\n好的，这是 BeeOS 设备接入 PRD 的草稿：1. 目标 ...\nOutput: {"title": "BeeOS 设备接入 PRD"}\n\nInput:\n[User Question]\n帮我看下\n\n[Assistant Answer]\n你说的 x402 支付协议是一个基于 HTTP 402 的链上支付标准 ...\nOutput: {"title": "x402 支付协议解析"}\n\nInput:\n[User Question]\nWhat\'s the best way to integrate x402 payment protocol?\n\n[Assistant Answer]\nYou have three options: 1. Use the official SDK ...\nOutput: {"title": "x402 Payment Integration"}\n\nInput:\n[User Question]\nhi\n\n[Assistant Answer]\nHello! How can I help you today?\nOutput: {"title": "New Conversation"}';matchTitleTemplate(e){const t=e.trim().toLowerCase();for(const s of AcpGatewayBridgeCore.TITLE_TEMPLATES)if(s.match.some(e=>e.toLowerCase()===t))return/[\u4e00-\u9fff]/.test(e)?s.zh:s.en}isGuardMessage(e){const t=e.trim();return[...t].length<3||[...t].every(e=>/[\p{P}\p{S}\s]/u.test(e))}truncateQuestionForTitle(e){return e.length>2e3?e.slice(0,1500):e}truncateAnswerForTitle(e){return e.length<=1e3?e:`${e.slice(0,500)}\n...\n${e.slice(-500)}`}generateTitleFromQA(e,t,s,r){if(this.isGuardMessage(s))return void this.logger.info?.(`[bridge-core] title-gen SKIP guard message sid=${t}`);const n=this.matchTitleTemplate(s);if(n){e.title=n,e.titleSource="template";const s=this.getGateway();return s?.isConnected&&s.sessionsPatch(e.gatewaySessionKey,{label:n}).catch(()=>{}),void this.transport.sendSessionUpdate(t,{sessionUpdate:"title_update",title:n})}const i=(process.env.AROUTER_BASE_URL||"").replace(/\/$/,""),o=process.env.AROUTER_API_KEY||"";if(!i||!o)return void this.logger.info?.(`[bridge-core] title-gen SKIP sid=${t}: no AROUTER env vars`);const a=`[User Question]\n${this.truncateQuestionForTitle(s)}\n\n[Assistant Answer]\n${this.truncateAnswerForTitle(r)}`;this.logger.info?.(`[bridge-core] title-gen CALLING LLM sid=${t} q="${s.slice(0,60)}" aLen=${r.length}`),fetch(`${i}/v1/chat/completions`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${o}`},body:JSON.stringify({model:"openai/gpt-4o-mini",max_tokens:32,temperature:.3,messages:[{role:"system",content:AcpGatewayBridgeCore.TITLE_SYSTEM_PROMPT},{role:"user",content:a}]})}).then(async s=>{if(!s.ok){const e=await s.text().catch(()=>"");return void this.logger.info?.(`[bridge-core] title-gen FAILED sid=${t} status=${s.status} body=${e.slice(0,300)}`)}const r=await s.json(),n=r.choices?.[0]?.message?.content?.trim();if(!n)return;const i=n.replace(/^```json\s*/,"").replace(/```$/,"").trim();let o;try{o=JSON.parse(i).title?.trim()??""}catch{return void this.logger.debug?.(`[bridge-core] title-gen JSON parse failed: ${i}`)}if(!o)return;if("manual"===e.titleSource)return void this.logger.debug?.("[bridge-core] title-gen discarded: user already renamed");this.logger.info?.(`[bridge-core] title-gen OK sid=${t} title="${o}"`),e.title=o,e.titleSource="auto";const a=this.getGateway();a?.isConnected&&a.sessionsPatch(e.gatewaySessionKey,{label:o}).catch(()=>{}),this.transport.sendSessionUpdate(t,{sessionUpdate:"title_update",title:o})}).catch(e=>{this.logger.info?.(`[bridge-core] title-gen ERROR sid=${t}: ${e instanceof Error?e.message:e}`)})}async tryGenerateTitleFromHistory(e,t,s){if("manual"===e.titleSource||"auto"===e.titleSource)return;const r=this.getGateway();if(!r?.isConnected)return;let n=s;if(!n)try{const t=await loadHistory(r,e.gatewaySessionKey);n=groupIntoTurns(t)}catch(e){return void this.logger.debug?.(`[bridge-core] title-gen loadHistory failed sid=${t}: ${e instanceof Error?e.message:e}`)}const i=n.find(e=>{if("user"!==e.role)return!1;if(!e.content?.trim())return!1;if("internal_system"===e.provenance?.kind)return!1;if(isCronPromptText(e.content))return!1;const t=stripTransportMetadata(e.content).trim();return!!t&&!/^Sender\s*\(untrusted/i.test(t)});if(!i)return;const o=n.indexOf(i),a=n.slice(o+1).find(e=>"assistant"===e.role&&!!e.content?.trim());if(!a)return;const l=stripTransportMetadata(i.content).trim(),d=a.content.trim();l&&d&&this.generateTitleFromQA(e,t,l,d)}async handleSessionDelete(e){const t=e.params?.sessionId;if(!t)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const s=this.state.sessions.get(t);if(!s)return this.logger.info?.(`[bridge-core] session/delete sessionId=${t} NOT FOUND in local state`),void this.transport.sendAcpError(e.id,Errors.SessionNotFound);const r=s.gatewaySessionKey;this.logger.info?.(`[bridge-core] session/delete sessionId=${t} gatewayKey=${r} gwConnected=${!!this.getGateway()?.isConnected}`);let n=!1;const i=this.getGateway();if(i?.isConnected&&r)try{await i.sessionsDelete(r),n=!0,this.logger.info?.(`[bridge-core] Gateway sessions.delete SUCCESS for key=${r}`)}catch(t){const s=t instanceof Error?t.message:String(t);if(this.logger.info?.(`[bridge-core] Gateway sessions.delete FAILED for key=${r}: ${s}`),!s.includes("Cannot delete the main session"))return void this.transport.sendResult(e.id,{deleted:!1});try{await i.sessionsReset(r),n=!0,this.logger.info?.(`[bridge-core] Gateway sessions.reset SUCCESS for key=${r}`)}catch(t){return this.logger.warn?.(`[bridge-core] Gateway sessions.reset also failed for key=${r}: ${t instanceof Error?t.message:t}`),void this.transport.sendResult(e.id,{deleted:!1})}}else r&&this.logger.warn?.(`[bridge-core] Gateway not connected, proceeding with local-only delete for key=${r}`);void 0!==s.pendingPromptId&&this.failPrompt(s,Errors.SessionDeleted.rpcCode,Errors.SessionDeleted.message),this.state.clearPromptTimeout(s),this.state.clearStreamIdleTimer(s),s.assistantMq?.close(),s.assistantMq=void 0,s.currentRunId&&this.state.promptsByRunId.delete(s.currentRunId);const o=new Set;for(const[e,s]of this.state.toolCallToSessionMap)s===t&&(this.state.toolCallToSessionMap.delete(e),o.add(e));for(const[e,t]of this.state.toolCallIdMap)o.has(t)&&this.state.toolCallIdMap.delete(e);this.state.sessions.delete(t),this.state.sessionsByGatewayKey.delete(r),this.transport.resetSessionUpdateCount(t),n&&this.onSessionDeleted?.(r),this.logger.info?.(`[bridge-core] session/delete DONE sessionId=${t} gatewayKey=${r} deleted=true`),this.transport.sendResult(e.id,{deleted:!0})}async handleSessionClear(e){this.logger.info?.(`[bridge-core] handleSessionClear called, params=${JSON.stringify(e.params)}`);const t=e.params?.sessionId;if(!t)return this.logger.warn?.("[bridge-core] session/clear missing sessionId"),void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId"});const s=this.state.sessions.get(t);if(!s)return this.logger.warn?.(`[bridge-core] session/clear sessionId=${t} not found in state`),void this.transport.sendAcpError(e.id,Errors.SessionNotFound);this.logger.info?.(`[bridge-core] session/clear sessionId=${t} gatewayKey=${s.gatewaySessionKey}`);const r=this.getGateway(),n=r?.isConnected;if(s.promptDone||void 0===s.pendingPromptId&&void 0===s.currentRunId||(this.logger.info?.(`[bridge-core] session/clear: cancelling active run sid=${t} runId=${s.currentRunId}`),n&&(s.currentRunId||s.gatewayRequestId)&&r.agentCancel(s.gatewaySessionKey,{runId:s.currentRunId,requestId:s.gatewayRequestId}),this.endRun(s,{kind:"complete",stopReason:"cancelled"})),n&&s.gatewaySessionKey)try{await r.sessionsReset(s.gatewaySessionKey),this.logger.info?.(`[bridge-core] Gateway sessions.reset SUCCESS for key=${s.gatewaySessionKey}`)}catch(e){this.logger.warn?.(`[bridge-core] Gateway sessions.reset FAILED for key=${s.gatewaySessionKey}: ${e instanceof Error?e.message:e}`)}else this.logger.warn?.(`[bridge-core] session/clear skipped gateway reset: connected=${n}, key=${s.gatewaySessionKey}`);s.chatReplayDedupKeys.clear(),this.logger.info?.("[bridge-core] session/clear dedupKeys cleared, calling onSessionCleared"),this.onSessionCleared?.(t,s.gatewaySessionKey),this.transport.sendResult(e.id,{cleared:!0}),this.logger.info?.("[bridge-core] session/clear DONE, sent cleared=true")}async handleSessionSetMode(e){const t=e.params?.sessionId,s=e.params?.mode,r=t?this.state.sessions.get(t):void 0,n=this.getGateway();if(r&&n?.isConnected&&s){const e={};if("verbose"===s||"detailed"===s?e.verboseLevel="full":"concise"!==s&&"default"!==s||(e.verboseLevel="default"),"reasoning"!==s&&"thinking"!==s||(e.reasoningLevel="stream"),Object.keys(e).length>0)try{await n.sessionsPatch(r.gatewaySessionKey,e)}catch(e){this.logger.warn?.(`[bridge-core] sessions.patch failed: ${e instanceof Error?e.message:e}`)}}this.transport.sendResult(e.id,{mode:s??"default"})}async handleSessionSetModel(e){const t=e.params?.sessionId,s=e.params?.model,r=t?this.state.sessions.get(t):void 0,n=this.getGateway();let i=s??null,o=null;if(r&&n?.isConnected&&s)try{const e=await n.sessionsPatch(r.gatewaySessionKey,{model:s}),t=e?.resolved;t?.model&&(i=t.model),t?.modelProvider&&(o=t.modelProvider)}catch(e){this.logger.warn?.(`[bridge-core] sessions.patch for model failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{model:i,modelProvider:o})}async createAgentShell(e,t,s){const r=this.getGateway();if(!r?.isConnected)throw new Error("gateway not connected");const n=`agent-${randomUUID().replace(/-/g,"").slice(0,12)}`,i=n,o=e,a=join(this.getOpenclawHome(),`workspace-${n}`),l=await r.request("agents.create",{name:i,workspace:a,...s?{model:s}:{},...t?.emoji?{emoji:t.emoji}:{},...t?.avatar?{avatar:t.avatar}:{}}),d=l?.agentId??n,c=l?.workspace??a;if(o)try{await r.request("agents.update",{agentId:d,name:o})}catch(e){this.logger.warn?.(`[bridge-core] createAgentShell: failed to set display name for "${d}": ${e instanceof Error?e.message:e}`)}return{agentId:d,workspace:c}}async handleAgentCreate(e){const t=e.params,s=(t?.name??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing agent name"});const r=this.getGateway();if(r?.isConnected)try{const{agentId:n,workspace:i}=await this.createAgentShell(s,t?.identity,t?.model),o=t?.files??{};for(const[e,t]of Object.entries(o))if("IDENTITY.md"!==e){if("string"==typeof t)try{await r.request("agents.files.set",{agentId:n,name:e,content:t})}catch(t){this.logger.warn?.(`[bridge-core] agent/create: failed to write "${e}" for "${n}": ${t instanceof Error?t.message:t}`)}}else this.logger.warn?.("[bridge-core] agent/create: ignoring IDENTITY.md in files (identity is set via structured fields)");this.logger.info?.(`[bridge-core] Created agent "${n}" (name="${s}") workspace=${i}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/create: agent sync after create failed: ${e instanceof Error?e.message:e}`)}const a=this.agentMapping?.get(n)?.id??"";this.transport.sendResult(e.id,{agentId:n,platformAgentId:a,workspace:i})}catch(t){this.logger.error?.(`[bridge-core] Failed to create agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Create agent failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleApplyTemplate(e){const t=e.params,s=(t?.name??"").trim(),r=(t?.packageUrl??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing agent name"});if(!r)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"packageUrl"});const n=this.getGateway();if(n?.isConnected)try{const n=await fetch(r);if(!n.ok)throw new TemplatePackageError(`failed to download package: HTTP ${n.status}`);const i=Buffer.from(await n.arrayBuffer());if(i.length>MAX_ZIP_BYTES)throw new TemplatePackageError(`package too large: ${i.length} bytes (max ${MAX_ZIP_BYTES})`);const o=t?.sha256?.trim().toLowerCase();if(o){if(createHash("sha256").update(i).digest("hex")!==o)throw new TemplatePackageError("package sha256 mismatch")}const a=parseAndValidateTemplatePackage(i),{agentId:l,workspace:d}=await this.createAgentShell(s,t?.identity,t?.model);let c=0;for(const[e,t]of a.workspaceFiles){const s=resolve(d,e),r=relative(d,s);if(""===r||r.startsWith("..")||path.isAbsolute(r))throw new TemplatePackageError(`refusing to write outside workspace: ${e}`);await mkdir(path.dirname(s),{recursive:!0}),await writeFile(s,t),c++}const g=a.manifest?.slug??"(no manifest)",p=a.manifest?.version??"";this.logger.info?.(`[bridge-core] agent/applyTemplate: applied "${g}${p?`@${p}`:""}" to agent "${l}" (${c} files) workspace=${d}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/applyTemplate: agent sync after apply failed: ${e instanceof Error?e.message:e}`)}const m=this.agentMapping?.get(l)?.id??"";this.transport.sendResult(e.id,{agentId:l,platformAgentId:m,workspace:d})}catch(t){if(t instanceof TemplatePackageError)return this.logger.warn?.(`[bridge-core] agent/applyTemplate: invalid package: ${t.message}`),void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:`Invalid template package: ${t.message}`});this.logger.error?.(`[bridge-core] Failed to apply template for "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Apply template failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleAgentUpdate(e){const t=e.params,s=(t?.agentId??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"agentId"});const r=t?.name?.trim(),n=t?.model?.trim(),i=t?.identity?.emoji?.trim(),o=t?.identity?.avatar?.trim();if(!(r||n||i||o))return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"No updatable fields provided (name/model/identity)"});const a=this.getGateway();if(a?.isConnected)try{const t=await a.request("agents.update",{agentId:s,...r?{name:r}:{},...n?{model:n}:{},...i?{emoji:i}:{},...o?{avatar:o}:{}}),l=t?.agentId??s;this.logger.info?.(`[bridge-core] Updated agent "${l}"${r?` name="${r}"`:""}`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/update: agent sync after update failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{agentId:l})}catch(t){this.logger.error?.(`[bridge-core] Failed to update agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Update agent failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleAgentDelete(e){const t=e.params,s=(t?.agentId??"").trim();if(!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"agentId"});if("main"===normalizeAgentId(s))return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:'"main" cannot be deleted; delete the instance instead'});const r=this.getGateway();if(!r?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);const n=t?.deleteFiles??!0;try{const t=await r.request("agents.delete",{agentId:s,deleteFiles:n}),i=t?.agentId??s;this.logger.info?.(`[bridge-core] Deleted agent "${i}" (deleteFiles=${n})`);try{await(this.triggerAgentSync?.())}catch(e){this.logger.warn?.(`[bridge-core] agent/delete: agent sync after delete failed: ${e instanceof Error?e.message:e}`)}this.transport.sendResult(e.id,{agentId:i,..."number"==typeof t?.removedBindings?{removedBindings:t.removedBindings}:{}})}catch(t){this.logger.error?.(`[bridge-core] Failed to delete agent "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Delete agent failed: ${t instanceof Error?t.message:String(t)}`})}}async handleModelsList(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.request("models.list",{});this.transport.sendResult(e.id,s??{models:[]})}catch(t){this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Failed to list models: ${t instanceof Error?t.message:t}`})}else this.transport.sendAcpError(e.id,Errors.GatewayNotConnected)}async handleSkillsList(e){const t=e.params?.agentId,s=await this.fetchSimplifiedSkills(t);this.transport.sendResult(e.id,{skills:s})}async fetchSimplifiedSkills(e){const t=this.getGateway();if(!t?.isConnected)return[];try{const s=await t.skillsStatus(e);if(!s?.skills)return[];const r=s.skills.filter(e=>!1!==e.eligible||!0===e.disabled).sort((e,t)=>e.always&&!t.always?-1:!e.always&&t.always?1:e.name.localeCompare(t.name)).map(e=>({name:e.name,description:e.description,emoji:e.emoji,always:e.always||void 0,bundled:e.bundled||void 0,disabled:e.disabled||void 0,skillKey:e.skillKey||void 0,iconUrl:void 0})),n=await this.getSkillsDir(e);for(const e of r){const t=e.skillKey??e.name;try{const s=await readFile(join(n,t,".beeos-meta.json"),"utf8"),r=JSON.parse(s);r?.iconUrl&&(e.iconUrl=r.iconUrl)}catch{}}return r}catch(e){return this.logger.warn?.(`[bridge-core] Failed to fetch skills: ${e instanceof Error?e.message:e}`),[]}}async pushSkillsList(e){const t=await this.fetchSimplifiedSkills(e);this.transport.sendNotification("session/update",{sessionId:"_system",update:{sessionUpdate:"available_commands_update",commands:t}}),this.writeObs({component:"bridge-core",domain:"lifecycle",name:"skills.pushed",severity:"debug",payload:{count:t.length}})}getOpenclawHome(){return process.env.OPENCLAW_HOME||join(homedir(),".openclaw")}async getSkillsDir(e){const t=this.getOpenclawHome();if(!e||"main"===e)return join(t,"skills");const s=await this.resolveAgentWorkspaceDir(e);return join(s??join(t,`workspace-${e}`),"skills")}async resolveAgentWorkspaceDir(e){const t=this.getGateway();if(!t?.isConnected)return null;try{const s=await t.request("agents.list",{}),r=normalizeAgentId(e),n=s?.agents?.find(e=>normalizeAgentId(e.id)===r);return n?.workspace??null}catch(t){return this.logger.warn?.(`[bridge-core] resolveAgentWorkspaceDir("${e}") failed: ${t instanceof Error?t.message:t}`),null}}async handleSkillsInstall(e){const t=e.params,s=t?.zipUrl,r=t?.files,n=t?.agentId;let i;try{i=validateSkillSlug(t?.slug||t?.name||"")}catch{return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Invalid or missing skill slug"})}if(!r?.length&&!s)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing skill files or zipUrl"});const o=resolveSkillInstallDir(await this.getSkillsDir(n),i);try{if(await mkdir(o,{recursive:!0}),s){const e=await fetchWithRetry(s,{maxRetries:4,logger:this.logger});await extractZipToDir(e,o)}else if(r?.length){const e=resolve(o);for(const t of r){const s=join(o,t.path);if(!resolve(s).startsWith(e+sep))throw new Error(`File path escapes skill directory: ${t.path}`);await mkdir(join(s,".."),{recursive:!0});const r=await fetch(t.downloadUrl,{signal:AbortSignal.timeout(12e4)});if(!r.ok)throw new Error(`Failed to download ${t.path}: ${r.status}`);const n=Buffer.from(await r.arrayBuffer());await writeFile(s,n)}}if(t?.iconUrl)try{await writeFile(join(o,".beeos-meta.json"),JSON.stringify({iconUrl:t.iconUrl}),"utf8")}catch{}this.logger.info?.(`[bridge-core] Installed skill "${i}"${n?` for agent "${n}"`:""} via ${s?"zip":"files"}`),this.transport.sendResult(e.id,{success:!0}),this.onSkillInstalled?.(i,o),await this.pushSkillsList(n)}catch(t){this.logger.error?.(`[bridge-core] Failed to install skill "${i}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Install failed: ${t instanceof Error?t.message:String(t)}`})}}async handleSkillsUninstall(e){const t=e.params,s=t?.agentId;let r;try{r=validateSkillSlug(t?.slug||t?.name||"")}catch{return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Invalid or missing skill name"})}const n=resolveSkillInstallDir(await this.getSkillsDir(s),r),i=resolveSkillInstallDir(join(homedir(),".agents","skills"),r);try{let t=!1;try{const e=await lstat(n);if(e.isSymbolicLink()){const e=await readlink(n);await rm(n,{force:!0}),await rm(e,{recursive:!0,force:!0}),t=!0}else e.isDirectory()&&(await rm(n,{recursive:!0,force:!0}),t=!0)}catch{}try{const e=await lstat(i);(e.isDirectory()||e.isSymbolicLink())&&(await rm(i,{recursive:!0,force:!0}),t=!0)}catch{}t||this.logger.warn?.(`[bridge-core] Skill "${r}" not found in any known location`),this.logger.info?.(`[bridge-core] Uninstalled skill "${r}"${s?` for agent "${s}"`:""}`),this.transport.sendResult(e.id,{success:!0}),await this.pushSkillsList(s)}catch(t){this.logger.error?.(`[bridge-core] Failed to uninstall skill "${r}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Uninstall failed: ${t instanceof Error?t.message:String(t)}`})}}async handleSkillsUpdate(e){const t=e.params,s=t?.skillKey,r=t?.enabled,n=t?.agentId;if(!s||"boolean"!=typeof r)return void this.transport.sendAcpError(e.id,Errors.InvalidParams,{message:"Missing skillKey or enabled"});const i=this.getGateway();if(i?.isConnected)try{const t=await i.skillsUpdate(s,r,n);this.logger.info?.(`[bridge-core] Updated skill "${s}" enabled=${r}${n?` for agent "${n}"`:""}`),this.transport.sendResult(e.id,{ok:t?.ok??!0,skillKey:s,enabled:r}),await this.pushSkillsList(n)}catch(t){this.logger.error?.(`[bridge-core] Failed to update skill "${s}": ${t instanceof Error?t.message:t}`),this.transport.sendAcpError(e.id,Errors.InternalError,{message:`Update failed: ${t instanceof Error?t.message:String(t)}`})}else this.transport.sendAcpError(e.id,Errors.InternalError,{message:"Gateway not connected"})}async handleSessionPrompt(e){const t=e.params?.sessionId,s=e.params?.prompt;if(!t||!s)return void this.transport.sendAcpError(e.id,Errors.MissingParam,{param:"sessionId, prompt"});const{session:r,created:n}=await this.resolveOrCreateSession(t);n&&this.onSessionLoaded?.(r.sessionId,r.gatewaySessionKey,r.platformAgentId);const i=r.sessionId;this.state.lastActiveSessionId=i,this.onPromptStart?.();const o=this.getGateway();if(!o?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);await this.ensureVerboseFull(r);let a=extractPromptBlocks(sanitizePromptPayload(s));const l=a.filter(e=>"text"===e.type&&"text"in e&&"string"==typeof e.text).map(e=>e.text).join("\n");if(r.fileArtifactDisplayMode=prefersChatFileArtifacts(l)?"chat":"auto",!r.title||isPlaceholderTitle(r.title)){const e=a.find(e=>"text"===e.type&&e.text);if(e&&"text"in e&&e.text){const t=stripTransportMetadata(e.text).trim();if(this.logger.info?.(`[bridge-core] title-gen sid=${i} existing="${r.title}" cleanText="${t.slice(0,80)}" isPlaceholder=${isPlaceholderTitle(t)}`),t&&!isPlaceholderTitle(t)){const e=t.slice(0,64).replace(/\n/g," ").trim();r.title=e,r.titleSource="truncated",o?.isConnected&&e&&o.sessionsPatch(r.gatewaySessionKey,{label:e}).catch(e=>{this.logger.debug?.(`[bridge-core] sessionsPatch (title) failed: ${e instanceof Error?e.message:e}`)}),this.transport.sendSessionUpdate(i,{sessionUpdate:"title_update",title:e})}}}const d=buildResolutionPlan(a);if(d.refs.length>0)try{const e=await resolveResources(d,this.writeObs);a=applyResolutions(a,e)}catch(e){this.logger.warn?.(`[bridge-core] Resource pre-resolution failed: ${e instanceof Error?e.message:e}`)}let c;if(this.beeosFileResolver){const e=this.beeosFileResolver.buildResolutionPlan(a);if(e.refs.length>0)try{c=await this.beeosFileResolver.resolveMetadataForPrompt(e)}catch(e){this.logger.warn?.(`[bridge-core] BeeOS file resolution failed: ${e instanceof Error?e.message:e}`)}}const g=toGatewayPrompt(a,{beeosFileResolutionsByUri:c});if("error"in g)return void this.transport.sendAcpError(e.id,Errors.PromptConvertFailed,{message:g.error});const{message:p,attachments:m}=g,h=resolveStandaloneSlashCommandName(a,p)??resolveSlashCmd(a,p),u="string"==typeof h;if(h&&this.handleSlashCommand){const t=this;if(await(async()=>{try{return await t.handleSlashCommand(h)}catch(e){return t.logger.warn?.(`[bridge-core] /${h} handler failed: ${e instanceof Error?e.message:e}`),!1}})())return this.emitPromptAsUserSessionUpdates(r,a,resolveTurnId(r)),this.transport.sendSessionUpdate(i,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:`Loading ${h}...`},timestamp:(new Date).toISOString()},{turnId:resolveTurnId(r)}),void this.transport.sendResult(e.id,{stopReason:"end_turn"})}const f="chat.send";let y=u?p:withUserMessagePrefix(p);const w=this.config.canvasEnabled&&!u&&!0===r.canvasActive&&!r.channelType;if(w){const e=r.promptsSinceCanvasInjection??0;!r.canvasPromptInjected||e>=10?(y=`${CANVAS_TERM_MAPPING}\n\n${y}`,r.canvasPromptInjected=!0,r.promptsSinceCanvasInjection=0,this.logger.debug?.("[bridge-core] Canvas term mapping injected (re-inject cycle)")):r.promptsSinceCanvasInjection=e+1}if(w){const e=this.getCanvasState?.();if(e){const t=e.resolveCanvasForSession(r.gatewaySessionKey);y=`${buildActiveSurfacesContext(e,t)??"[Canvas] Canvas panel is available. Use render_ui for structured/visual content."}\n\n${y}`}const t=r.referencedSurfaceId;t&&(y=`${CANVAS_UPDATE_HINT}\n[IMPORTANT: The user selected canvas surface "${t}" for editing. You MUST call render_ui with id="${t}" to UPDATE this existing surface. Do NOT create a new surface with a different id.]\n${y}`,r.referencedSurfaceId=void 0)}if(!u){const t=parseMentionsParam(e.params?.mentions);if(t.length>0){r.activeMentions=t;y=`${buildMentionInstruction(t)}\n${y}`,this.logger.debug?.(`[bridge-core] delegation mention instruction injected for ${t.length} agent(s)`)}else r.activeMentions=void 0}u&&this.logger.info?.(`[bridge-core] slash command passthrough sessionId=${i} command=/${h}`),r.promptDone||void 0===r.pendingPromptId&&void 0===r.currentRunId||(this.logger.warn?.(`[bridge-core] handleSessionPrompt: force-ending stale run sid=${i} oldRunId=${r.currentRunId} oldPromptId=${r.pendingPromptId}`),(r.currentRunId||r.gatewayRequestId)&&o.agentCancel(r.gatewaySessionKey,{runId:r.currentRunId,requestId:r.gatewayRequestId}),this.endRun(r,{kind:"complete",stopReason:"cancelled"})),this.state.resetForNewRun(r,i,this.transport),r.pendingPromptId=e.id,r.gatewayMethod=f;const I=resolveTurnId(r);this.emitPromptAsUserSessionUpdates(r,a,I),this.transport.sendSessionUpdate(i,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:""},timestamp:(new Date).toISOString()},I?{turnId:I}:void 0);const S=extractCronJobId(p);S&&(r.cronJobId=S),this.schedulePromptTimeout(r);const v=m.length>0?m.map(e=>({type:e.type,content:e.content,...e.mimeType?{mimeType:e.mimeType}:{},...e.fileName?{fileName:e.fileName}:{}})):void 0,b=`req_${randomUUID().replace(/-/g,"")}`,T={sessionKey:r.gatewaySessionKey,message:y,deliver:!1,idempotencyKey:randomUUID()};v?.length&&(T.attachments=v);if(!o.sendFrame({type:"req",id:b,method:f,params:T}))return this.state.clearPromptTimeout(r),r.pendingPromptId=void 0,r.assistantMq?.close(),r.assistantMq=void 0,r.pendingUserTurnUpdates=void 0,void this.transport.sendAcpError(e.id,Errors.SendFailed,{message:"failed to send prompt to gateway"});r.gatewayRequestId=b,this.state.promptsByGatewayRequestId.set(b,r)}replayUserTurnAsChunks(e,t,s,r,n,i,o){const a=splitUserReplayBlocks(s),l=i||void 0!==o?{...i?{turnId:i}:{},...void 0!==o?{seq:o}:{}}:void 0;for(const s of a){let i;if("text"===s.type){if(!s.text)continue;i={type:"text",text:s.text}}else i="resource_link"===s.type?{type:"resource_link",uri:s.uri??"",...s.fileName?{name:s.fileName}:{},...s.mimeType?{mimeType:s.mimeType}:{}}:{type:s.type,...s.mimeType?{mimeType:s.mimeType}:{},...s.fileName?{fileName:s.fileName}:{}};e.sendSessionUpdate(t,{sessionUpdate:"user_message_chunk",content:i,...r?{metadata:r}:{},...n?{timestamp:n}:{}},l)}}async replayAssistantTurnAsStream(e,t,s,r){const n=e=>{if(r||void 0!==e)return{...r?{turnId:r}:{},...void 0!==e?{seq:e}:{}}},i=new Set,o=(s,r,o)=>{if(!s?.length)return;const a=n(o);for(const n of s)n.uri&&!i.has(n.uri)&&(i.add(n.uri),e.sendSessionUpdate(t,{sessionUpdate:"agent_message_chunk",content:{type:"resource_link",uri:n.uri,name:n.name??"file",...n.mimeType?{mimeType:n.mimeType}:{}},...r?{timestamp:r}:{}},a))},a=n(s._seq);if(!s.sourceMessages?.length){const r={sessionUpdate:"history_turn",role:s.role,content:s.content,reasoning:s.reasoning,toolCalls:s.toolCalls,...s.timestamp?{timestamp:s.timestamp}:{}};return s.metadata&&(r.metadata=s.metadata),e.sendSessionUpdate(t,r,a),void o(s.files,s.timestamp,s._seq)}for(const r of s.sourceMessages){const i=r.updateType??"agent_message_chunk",a=n(r._seq);switch(i){case"agent_message_chunk":e.sendSessionUpdate(t,{sessionUpdate:"agent_message_chunk",content:{type:"text",text:r.content},...r.timestamp?{timestamp:r.timestamp}:{},...r.metadata?{metadata:r.metadata}:{}},a);break;case"agent_thought_chunk":e.sendSessionUpdate(t,{sessionUpdate:"agent_thought_chunk",content:{type:"text",text:r.content},...r.timestamp?{timestamp:r.timestamp}:{}},a);break;case"tool_call":{const n=r.toolCallId??"",i=s.toolCalls?.find(e=>e.id===n),o=r.toolName??"tool",l=r.content??"";let d={};if(l)try{d=JSON.parse(l)}catch{}e.sendSessionUpdate(t,buildToolCallPayload({toolCallId:n,toolName:o,args:d,kind:i?.kind,status:i?.status??"in_progress",timestamp:r.timestamp}),a);break}case"tool_call_update":{const n=r.toolCallId??"",i=s.toolCalls?.find(e=>e.id===n),l=r.toolName??i?.name??"tool",d=r.content??i?.output??"",c=await this.resolveReplayResourceLinks(n,l,r.files);e.sendSessionUpdate(t,buildToolCallUpdatePayload({toolCallId:n,toolName:l,outputText:d,kind:i?.kind,status:i?.status??"completed",resourceLinks:c,timestamp:r.timestamp}),a),o(c,r.timestamp,r._seq);break}}}o(s.files,s.timestamp,s._seq)}async resolveReplayResourceLinks(e,t,s){let r=s?.map(e=>({uri:e.uri,name:e.name??"file",...e.mimeType?{mimeType:e.mimeType}:{}}));if(r?.length)return r;if(r=await readEnrichmentCache(e).catch(()=>{}),r?.length)return r;if("beeos_upload_file"!==t)return;const n=await readUploadToolResult(e).catch(()=>{});if(!n)return;const i=buildToolResultSessionContentBlocks(t,n).filter(e=>"resource_link"===e.content?.type&&e.content.uri).map(e=>({uri:e.content.uri,name:e.content.name??"file",...e.content.mimeType?{mimeType:e.content.mimeType}:{}}));return i.length>0?i:void 0}emitPromptAsUserSessionUpdates(e,t,s){const r=(new Date).toISOString(),n=s?{turnId:s}:void 0;for(const i of t){const t=this.toUserSessionUpdateContent(i);if(!t)continue;const o={sessionUpdate:"user_message_chunk",content:t,timestamp:r};s&&void 0===o._turnId&&(o._turnId=s),this.transport.sendSessionUpdate(e.sessionId,o,n),e.pendingUserTurnUpdates?.push(o)}}toUserSessionUpdateContent(e){if("text"===e.type){if(!e.text)return;return{type:"text",text:e.text}}if("image"===e.type){const t=e.mimeType??e.mime_type??"application/octet-stream",s=e.fileName??e.file_name??e.name;if(!e.data&&!e.uri)return;return{type:"image",...e.data?{data:e.data}:{},...e.uri?{uri:e.uri}:{},...t?{mimeType:t}:{},...s?{fileName:s}:{}}}if("resource_link"===e.type){if(!e.uri)return;return{type:"resource_link",uri:e.uri,...e.title?{title:e.title}:{},...e.name?{name:e.name}:{},...e.mimeType??e.mime_type?{mimeType:e.mimeType??e.mime_type}:{}}}if("file"===e.type){const t=e.mimeType??e.mime_type??"application/octet-stream",s=e.fileName??e.file_name??e.filename??e.name;if(!e.data&&!e.text&&!e.uri)return;return{type:"file",...e.data?{data:e.data}:{},...e.text?{text:e.text}:{},...e.uri?{uri:e.uri}:{},...t?{mimeType:t}:{},...s?{fileName:s}:{}}}if("resource"===e.type){const t=e.resource??{},s=t.uri??e.uri,r=t.mimeType??t.mime_type??e.mimeType??e.mime_type,n=t.text??e.text,i=t.data??e.data,o=t.fileName??t.file_name??t.filename??t.name??e.fileName??e.file_name??e.filename??e.name;if(!s&&!n&&!i)return;return{type:"resource",resource:{...s?{uri:s}:{},...r?{mimeType:r}:{},...n?{text:n}:{},...i?{data:i}:{},...o?{fileName:o}:{}}}}}handleSessionCancel(e,t){const s=t&&"object"==typeof t&&"sessionId"in t?t.sessionId:void 0;if(!s)return void(void 0!==e&&this.transport.sendAcpError(e,Errors.MissingParam,{param:"sessionId"}));const r=this.state.sessions.get(s);if(!r)return void(void 0!==e&&this.transport.sendAcpError(e,Errors.SessionNotFound));const n=this.getGateway(),i=n?.isConnected,o=!(!r.currentRunId&&!r.gatewayRequestId);if(i&&o){n.agentCancel(r.gatewaySessionKey,{runId:r.currentRunId,requestId:r.gatewayRequestId})}this.endRun(r,{kind:"complete",stopReason:"cancelled"})||this.transport.sendSessionUpdate(r.sessionId,{sessionUpdate:"stream_complete",stopReason:"cancelled"},{turnId:resolveTurnId(r)}),void 0!==e&&this.transport.sendResult(e,{})}endRun(e,t){if(e.promptDone)return this.logger.debug?.(`[bridge-core] endRun skipped (promptDone=true) sessionId=${e.sessionId} outcome=${t.kind}`),!1;if(void 0===e.pendingPromptId&&void 0===e.currentRunId)return this.logger.debug?.(`[bridge-core] endRun skipped (no pendingPromptId and no currentRunId) sessionId=${e.sessionId} outcome=${t.kind}`),!1;const s=resolveTurnId(e),r=s?{turnId:s}:void 0;e.promptDone=!0;const n=e.currentRunId;if("complete"===t.kind){if(n&&this.onRunComplete){const s=e.agentAssistantTextSoFar??e.chatAssistantTextSoFar??"";this.onRunComplete(n,s,t.stopReason)}void 0!==e.pendingPromptId&&this.transport.sendResult(e.pendingPromptId,{stopReason:t.stopReason}),this.transport.sendSessionUpdate(e.sessionId,{sessionUpdate:"stream_complete",stopReason:t.stopReason},r),this.tryGenerateTitleFromHistory(e,e.sessionId)}else n&&this.onRunFailed&&this.onRunFailed(n,t.message),void 0!==e.pendingPromptId&&this.transport.sendError(e.pendingPromptId,t.code,t.message),this.transport.sendSessionUpdate(e.sessionId,{sessionUpdate:"stream_complete",stopReason:"error",error:t.message},r);return this.cleanupPrompt(e),this.onRunEnded?.(e,t),!0}schedulePromptTimeout(e){let t;if(this.state.clearPromptTimeout(e),e.cronJobId){const s=this.cronOverrides.get(e.cronJobId)??this.config.cronMaxDurationDefaultMs;t=Math.max(CRON_DURATION_FLOOR_MS,Math.min(this.config.cronMaxDurationCapMs,s))}else t=this.config.promptTimeoutMs??DEFAULT_PROMPT_TIMEOUT_MS;t<=0||(e.promptTimeoutTimer=setTimeout(()=>{void 0===e.pendingPromptId&&void 0===e.currentRunId||((e.currentRunId||e.gatewayRequestId)&&this.getGateway()?.agentCancel(e.gatewaySessionKey,{runId:e.currentRunId,requestId:e.gatewayRequestId}),this.logger.warn?.(`[bridge-core] Prompt timed out sessionId=${e.sessionId} after ${t}ms`),this.failPrompt(e,Errors.PromptTimeout.rpcCode,`Prompt timed out after ${t}ms`))},t),"object"==typeof e.promptTimeoutTimer&&"unref"in e.promptTimeoutTimer&&e.promptTimeoutTimer.unref())}cleanupPrompt(e){this.state.clearPromptTimeout(e),this.state.clearStreamIdleTimer(e);const t=e.currentRunId;if(t){this.state.promptsByRunId.delete(t),this.state.runIdToCronJobId.delete(t),this.state.markRunCompleted(t);const e=`tc_${t}_`;for(const[t,s]of this.state.toolCallIdMap)s.startsWith(e)&&this.state.toolCallIdMap.delete(t)}e.gatewayRequestId&&this.state.promptsByGatewayRequestId.delete(e.gatewayRequestId),e.pendingPromptId=void 0,e.promptDone=void 0,e.currentRunId=void 0,e.gatewayRequestId=void 0,e.assistantStreamStartedAt=void 0,e.gatewayMethod=void 0,e.assistantMq?.close(),e.assistantMq=void 0,e.pendingUserTurnUpdates=void 0}completePrompt(e,t){this.endRun(e,{kind:"complete",stopReason:t})}failPrompt(e,t,s){this.endRun(e,{kind:"error",code:t,message:s})}cleanupAllPendingPrompts(){for(const e of this.state.sessions.values())this.failPrompt(e,Errors.GatewayDisconnected.rpcCode,Errors.GatewayDisconnected.message)}handleGatewayResponse(e){const t=e.id;if(!t)return;const s=this.state.promptsByGatewayRequestId.get(t);if(!s||s.promptDone)return;if(!e.ok){const r=e.error,n=r?.message??"gateway returned error";return this.logger.warn?.(`[bridge-core] handleGatewayResponse: gateway rejected prompt gatewayRequestId=${t} error=${n}`),void this.failPrompt(s,Errors.SendFailed.rpcCode,n)}const r=e.payload,n=r?.runId;n?(s.currentRunId=n,s.assistantStreamStartedAt=Date.now(),this.state.promptsByRunId.set(n,s),this.logger.debug?.(`[bridge-core] handleGatewayResponse: bound runId=${n} gatewayRequestId=${t} sessionId=${s.sessionId}`)):this.logger.debug?.(`[bridge-core] handleGatewayResponse: no runId in payload gatewayRequestId=${t} sessionId=${s.sessionId}`)}maybeCompletePromptFromChatState(e,t){if(e.promptDone||"chat.send"!==e.gatewayMethod)return;const s="string"==typeof t.state?t.state.toLowerCase():void 0;if(s)if("final"===s){const s="string"==typeof t.stopReason?t.stopReason:void 0;this.completePrompt(e,s||"end_turn")}else if("aborted"===s||"cancelled"===s||"cancel"===s)this.completePrompt(e,"cancelled");else if("error"===s){const s=("string"==typeof t.summary?t.summary:void 0)??("string"==typeof t.message?t.message:void 0)??"gateway chat error";this.failPrompt(e,Errors.AgentError.rpcCode,formatFriendlyError(s))}}async handleCronRequest(e){const t=this.getGateway();if(!t?.isConnected)return void this.transport.sendAcpError(e.id,Errors.GatewayNotConnected);const s=e.method.replace("/","."),r={...e.params??{}},n="cron.update"===s;!n||r.patch&&"object"==typeof r.patch||(r.patch={});const i=n?r.patch:r,o=i._beeos_meta;let a;if(delete i._beeos_meta,"cron.add"!==s&&"cron.update"!==s||!0!==i._beeos_internal)void 0!==i._beeos_internal&&delete i._beeos_internal;else if(delete i._beeos_internal,i.delivery={mode:"none"},"cron.add"===s){const e=await this.allocateCronChannel(i.name??"cron");e&&(i.description=encodeBeeosChannelTag(i.description,e))}else{const e=r.id,t="description"in i,s=i.description;let n,o=decodeBeeosChannelId(s);!o&&e&&(o=this.cronChannelCache.get(e)),!o&&e&&(n=await this.lookupCronJobDescription(e),o=decodeBeeosChannelId(n));let l=!1;o||(o=await this.allocateCronChannel(i.name??"cron"),l=!0),o&&(t?i.description=encodeBeeosChannelTag(s,o):l&&(i.description=encodeBeeosChannelTag(n,o)),a=o)}try{const n=await t.request(s,r),l="cron.list"===s||"cron.status"===s?this.enrichCronResponseWithOverrides(n):n;if(this.transport.sendResult(e.id,l??{}),("cron.add"===s||"cron.update"===s)&&n&&"object"==typeof n){const e=n.id;if(e&&void 0!==o?.maxDurationMs){const t=Math.max(CRON_DURATION_FLOOR_MS,Math.min(this.config.cronMaxDurationCapMs,o.maxDurationMs));this.cronOverrides.set(e,t)}}if("cron.remove"===s){const t=e.params?.id;t&&(this.cronOverrides.delete(t),this.cronChannelCache.delete(t))}if(("cron.add"===s||"cron.update"===s)&&n&&"object"==typeof n){const e=n.id,t=decodeBeeosChannelId(i.description)??a;e&&t&&this.setCronChannelCache(e,t)}"cron.add"!==s&&"cron.update"!==s&&"cron.remove"!==s||this.refreshCronIsolatedSessionKeys()}catch(t){const r=t instanceof Error?t.message:"cron request failed";this.logger.warn?.(`[bridge-core] ${s} failed: ${r}`),this.transport.sendAcpError(e.id,Errors.SendFailed,{message:r})}}enrichCronResponseWithOverrides(e){if(!e||"object"!=typeof e)return e;const t=e,s=e=>{if(!e||"object"!=typeof e)return e;const t=e,s=t.id;if("string"!=typeof s)return e;const r=this.cronOverrides.get(s);return"number"!=typeof r?e:{...t,_beeos_meta:{maxDurationMs:r}}};if(Array.isArray(t.jobs))return{...t,jobs:t.jobs.map(s)};if(t.jobs&&"object"==typeof t.jobs){const e=t.jobs,r={};for(const[t,n]of Object.entries(e))r[t]=s(n);return{...t,jobs:r}}return e}async allocateCronChannel(e){if(this.agentFetch&&this.agentGatewayUrl)try{const t=`${this.agentGatewayUrl}/api/v1/channels`,s=await this.agentFetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({participants:[this.instanceId,"service:cron"],metadata:{source:"cron",job_name:e}})});if(!s.ok)return void this.logger.warn?.(`[bridge-core] channel alloc failed: ${s.status}`);return(await s.json()).id}catch(e){return void this.logger.warn?.(`[bridge-core] channel alloc error: ${e instanceof Error?e.message:e}`)}else this.logger.debug?.("[bridge-core] agentFetch/agentGatewayUrl unavailable, skip channel alloc")}async lookupCronJobDescription(e){const t=this.getGateway();if(t?.isConnected)try{const s=await t.request("cron.list",{}),r=s?.jobs;if(!Array.isArray(r))return;for(const t of r){if(!t||"object"!=typeof t)continue;const s=t;if(s.id===e)return"string"==typeof s.description?s.description:void 0}}catch(e){this.logger.debug?.(`[bridge-core] cron.list description lookup failed: ${e instanceof Error?e.message:e}`)}}setCronChannelCache(e,t){if(this.cronChannelCache.size>=AcpGatewayBridgeCore.CRON_CHANNEL_CACHE_MAX){const e=this.cronChannelCache.keys().next().value;void 0!==e&&this.cronChannelCache.delete(e)}this.cronChannelCache.set(e,t)}async refreshCronIsolatedSessionKeys(){const e=this.getGateway();if(e?.isConnected)try{const t=await e.request("cron.list",{}),s=t?.jobs;if(!Array.isArray(s))return;const r=new Set,n=[];for(const e of s){if(!e||"object"!=typeof e)continue;const t=e;if("string"==typeof t.id&&n.push(t.id),"isolated"!==t.sessionTarget)continue;const s=t.sessionKey;"string"==typeof s&&s.length>0&&r.add(s)}this.cronIsolatedSessionKeys=r,this.cronOverrides.reconcile(n)}catch(e){this.logger.debug?.(`[bridge-core] refreshCronIsolatedSessionKeys failed: ${e instanceof Error?e.message:e}`)}}}async function fetchWithRetry(e,t={}){const s=t.maxRetries??3;let r;for(let n=0;n<=s;n++){const i=await fetch(e,{signal:AbortSignal.timeout(12e4),redirect:"follow"});if(i.ok)return Buffer.from(await i.arrayBuffer());if(429===i.status||i.status>=500){const o=Number(i.headers.get("retry-after"))||0,a=1e3*Math.max(o,2**n);if(r=new Error(`HTTP ${i.status} from ${e}`),n<s){t.logger?.info?.(`[bridge-core] Download ${i.status}, retry ${n+1}/${s} in ${(a/1e3).toFixed(0)}s`),await new Promise(e=>setTimeout(e,a));continue}}throw new Error(`Failed to download zip: ${i.status}`)}throw r??new Error("Download failed after retries")}const SKILL_ROOT_MARKERS=["SKILL.md","skill.md","SKILL.MD"];async function resolveSkillRoot(e){for(const t of SKILL_ROOT_MARKERS)try{return await stat(join(e,t)),e}catch{}const t=(await readdir(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&!e.name.startsWith(".")&&"__MACOSX"!==e.name);if(1===t.length){const s=join(e,t[0].name);for(const e of SKILL_ROOT_MARKERS)try{return await stat(join(s,e)),s}catch{}return s}return e}async function extractZipToDir(e,t){const s=new AdmZip(e),r=join(t,".beeos-extract-tmp-"+Date.now());try{await mkdir(r,{recursive:!0}),s.extractAllTo(r,!0);const e=await resolveSkillRoot(r),n=await readdir(e,{withFileTypes:!0});let i=0;for(const s of n){if(s.name.startsWith(".beeos-extract-tmp")||"__MACOSX"===s.name)continue;const r=join(e,s.name),n=join(t,s.name);await rename(r,n).catch(async()=>{await cp(r,n,{recursive:!0})}),i++}if(0===i)throw new Error("Zip archive contained no extractable files")}finally{await rm(r,{recursive:!0,force:!0}).catch(()=>{})}}const VALID_SLUG_PATTERN=/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i,NON_ASCII_PATTERN=/[^\x00-\x7F]/;function validateSkillSlug(e){const t=e.trim();if(!t||t.includes("/")||t.includes("\\")||t.includes(".."))throw new Error(`Invalid skill slug: ${e}`);if(NON_ASCII_PATTERN.test(t)||!VALID_SLUG_PATTERN.test(t))throw new Error(`Invalid skill slug: ${e}`);return t}function safeDirName(e){const t=e.trim();return t?t.replaceAll("/","__").replaceAll("\\","__"):t}function resolveSkillInstallDir(e,t){const s=safeDirName(t),r=join(e,s),n=resolve(e),i=resolve(r),o=relative(n,i);if(!o||".."===o||o.startsWith(`..${sep}`)||path.isAbsolute(o))throw new Error("Invalid skill target path");return r}

package/dist/acp-gateway/history-artifact-hydrator.js

@@ -0,0 +1 @@
+export function hydrateFromLocalArtifacts(e){const{messages:l,gatewaySessionKey:t,options:s,logger:a,parseGatewayHistory:o}=e,{localHistory:n,agentId:i,sessionId:r}=s??{};if(!n||!i)return{messages:l,addedFileCount:0};let d=[];try{d=n.readEntries({agentId:i,sessionKey:t,sessionId:r})}catch(e){return(a?.warn??console.debug)?.(`[loadHistory] local artifact hydration read failed: ${e instanceof Error?e.message:String(e)}`),{messages:l,addedFileCount:0}}if(0===d.length)return{messages:l,addedFileCount:0};return mergeLocalFileArtifactMessages(l,o({messages:d}))}export function mergeLocalFileArtifactMessages(e,l){const t=l.filter(e=>e.files?.length);if(0===t.length)return{messages:e,addedFileCount:0};const s=e.map(cloneReplayMessage);let a=0;for(const e of t){const l=replayFileToolCallId(e),t=replayFileToolName(e),o=(e.files??[]).filter(e=>!hasReplayableFileMessage(s,l,e));if(0===o.length)continue;const n=findReplayableFileMessageIndex(s,l);if(n>=0){const e=s[n];e.files=[...e.files??[],...o],a+=o.length;continue}const i={role:"assistant",content:e.content,updateType:l?"tool_call_update":"agent_message_chunk",...l?{toolCallId:l}:{},...t?{toolName:t}:{},files:o,...e.timestamp?{timestamp:e.timestamp}:{},...e.messageId?{messageId:e.messageId}:{},...void 0!==e._seq?{_seq:e._seq}:{}};s.splice(findLocalArtifactInsertIndex(s,e),0,i),a+=o.length}return a>0?{messages:s,addedFileCount:a}:{messages:e,addedFileCount:0}}function cloneReplayMessage(e){return{...e,...e.files?{files:e.files.map(e=>({...e}))}:{},...e.toolCalls?{toolCalls:e.toolCalls.map(e=>({...e}))}:{}}}function hasReplayableFileMessage(e,l,t){return e.some(e=>!!e.files?.some(e=>e.uri===t.uri)&&("agent_message_chunk"===e.updateType||"tool_call_update"===e.updateType&&(!l||e.toolCallId===l)))}function findReplayableFileMessageIndex(e,l){return e.findIndex(e=>"agent_message_chunk"===e.updateType&&!l||Boolean("tool_call_update"===e.updateType&&l&&e.toolCallId===l))}function findLocalArtifactInsertIndex(e,l){if(void 0!==l._seq){const t=e.findIndex(e=>void 0!==e._seq&&e._seq>l._seq);if(t>=0)return t}const t=replayFileToolCallId(l);if(t)for(let l=e.length-1;l>=0;l--){const s=e[l];if(s.toolCallId===t)return l+1;if(s.toolCalls?.some(e=>e.id===t))return l+1}return e.length}function replayFileToolCallId(e){return e.toolCallId?e.toolCallId:1===e.toolCalls?.length?e.toolCalls[0]?.id:void 0}function replayFileToolName(e){return e.toolName?e.toolName:1===e.toolCalls?.length?e.toolCalls[0]?.name:void 0}

package/dist/acp-gateway/history-replay.js

@@ -1 +1 @@
-import{stripTransportMetadata}from"../message-filter.js";import{formatProviderError}from"./error-message-formatter.js";import{buildToolResultSessionContentBlocks}from"./tool-result-payload-strategies.js";import{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";const DEFAULT_CHAT_HISTORY_RPC_TIMEOUT_MS=3e3;function toISO(e){if(null!=e){if("string"==typeof e){if(!e)return;const t=new Date(e),o=t.getTime();return Number.isFinite(o)?t.toISOString():void 0}if(!(e<=0))try{return new Date(e).toISOString()}catch{return}}}function inferToolKindFromName(e){if(!e)return;const t=e.toLowerCase();return t.includes("read")?"read":t.includes("write")||t.includes("edit")?"edit":t.includes("delete")||t.includes("remove")?"delete":t.includes("move")||t.includes("rename")?"move":t.includes("search")||t.includes("find")?"search":t.includes("exec")||t.includes("run")||t.includes("bash")?"execute":t.includes("fetch")||t.includes("http")?"fetch":"other"}const BEEOS_USER_MSG_MARKER_RE=/(?:^|\n)\s*User Message From \w+:\s*\n/i,CANVAS_STATE_RE=/^\[Canvas State\][^\n]*/,SYSTEM_NOTE_RE=/^\[System Note\][^\n]*/,CANVAS_INTERACTION_RE=/^\[Canvas Interaction\] The user clicked "([^"]*)" on surface "([^"]*)"/,ACTION_CONTEXT_RE=/\nAction context: (.+?)(?:\n|$)/s;function stripBeeosUserEnvelope(e){const t=BEEOS_USER_MSG_MARKER_RE.exec(e);if(t){return e.slice(t.index+t[0].length).trim()}let o=e;return o=o.replace(CANVAS_STATE_RE,"").trimStart(),o=o.replace(SYSTEM_NOTE_RE,"").trimStart(),stripTransportMetadata(o).trim()}export async function loadHistory(e,t,o=100,s){const n=Date.now(),a=s?.rpcTimeoutMs??3e3,i=s?.logger,l=s?.emitObs,r=e=>{i?.info&&i.info(e)};let c,u=null;if(e?.isConnected)try{u=await Promise.race([e.chatHistory(t,o),new Promise(e=>{const t=setTimeout(()=>e(null),a);"object"==typeof t&&"unref"in t&&t.unref()})])}catch(e){c=e}const p=u?parseGatewayHistory(u):[];if(p.length>0){const e=hydrateFromLocalArtifacts({messages:p,gatewaySessionKey:t,options:s,logger:i}),o=e.messages,a=Date.now()-n,c=o.filter(e=>"user"===e.role).length,u=o.filter(e=>"assistant"===e.role).length,d=e.addedFileCount>0?"chat.history+local-jsonl-artifacts":"chat.history";return r(`[loadHistory] source=${d} sid=${t} messages=${o.length} (user=${c} asst=${u}) artifacts=${e.addedFileCount} elapsedMs=${a}`),l?.({name:"history.source",severity:"info",payload:{sessionKey:t,source:d,messages:o.length,userCount:c,asstCount:u,addedFileArtifacts:e.addedFileCount,elapsedMs:a}}),o}const{localHistory:d,agentId:f,sessionId:m}=s??{},g=e?.isConnected?null===u?c?"rpc-error":"rpc-timeout":"rpc-empty":"gateway-disconnected";if(!d||!f){const e=Date.now()-n;return r(`[loadHistory] source=none sid=${t} reason=${g} elapsedMs=${e}`),c&&(i?.warn??console.debug)?.(`[loadHistory] chat.history error: ${c instanceof Error?c.message:String(c)}`),l?.({name:"history.none",severity:"warn",payload:{sessionKey:t,reason:g,fallbackAvailable:!1,elapsedMs:e}}),[]}let y=[];try{y=d.readEntries({agentId:f,sessionKey:t,sessionId:m})}catch(e){(i?.warn??console.debug)?.(`[loadHistory] local jsonl read failed: ${e instanceof Error?e.message:String(e)}`)}if(0===y.length){const e=Date.now()-n;return r(`[loadHistory] source=none sid=${t} reason=${g},local-empty elapsedMs=${e}`),l?.({name:"history.none",severity:"warn",payload:{sessionKey:t,reason:`${g},local-empty`,fallbackAvailable:!0,elapsedMs:e}}),[]}const h=parseGatewayHistory({messages:y}),_=Date.now()-n;return r(`[loadHistory] source=local-jsonl sid=${t} reason=${g} messages=${h.length} localLines=${y.length} elapsedMs=${_}`),l?.({name:"history.local_fallback",severity:"info",payload:{sessionKey:t,reason:g,localLines:y.length,messages:h.length,elapsedMs:_}}),h}function hydrateFromLocalArtifacts(e){const{messages:t,gatewaySessionKey:o,options:s,logger:n}=e,{localHistory:a,agentId:i,sessionId:l}=s??{};if(!a||!i)return{messages:t,addedFileCount:0};let r=[];try{r=a.readEntries({agentId:i,sessionKey:o,sessionId:l})}catch(e){return(n?.warn??console.debug)?.(`[loadHistory] local artifact hydration read failed: ${e instanceof Error?e.message:String(e)}`),{messages:t,addedFileCount:0}}if(0===r.length)return{messages:t,addedFileCount:0};return mergeLocalFileArtifactMessages(t,parseGatewayHistory({messages:r}))}function mergeLocalFileArtifactMessages(e,t){const o=t.filter(e=>e.files?.length);if(0===o.length)return{messages:e,addedFileCount:0};const s=e.map(cloneReplayMessage);let n=0;for(const e of o){const t=replayFileToolCallId(e),o=replayFileToolName(e),a=(e.files??[]).filter(e=>!hasReplayableFileMessage(s,t,e));if(0===a.length)continue;const i=findReplayableFileMessageIndex(s,t);if(i>=0){const e=s[i];e.files=[...e.files??[],...a],n+=a.length;continue}const l={role:"assistant",content:e.content,updateType:t?"tool_call_update":"agent_message_chunk",...t?{toolCallId:t}:{},...o?{toolName:o}:{},files:a,...e.timestamp?{timestamp:e.timestamp}:{},...e.messageId?{messageId:e.messageId}:{},...void 0!==e._seq?{_seq:e._seq}:{}};s.splice(findLocalArtifactInsertIndex(s,e),0,l),n+=a.length}return n>0?{messages:s,addedFileCount:n}:{messages:e,addedFileCount:0}}function cloneReplayMessage(e){return{...e,...e.files?{files:e.files.map(e=>({...e}))}:{},...e.toolCalls?{toolCalls:e.toolCalls.map(e=>({...e}))}:{}}}function hasReplayableFileMessage(e,t,o){return e.some(e=>!!e.files?.some(e=>e.uri===o.uri)&&("agent_message_chunk"===e.updateType||"tool_call_update"===e.updateType&&(!t||e.toolCallId===t)))}function findReplayableFileMessageIndex(e,t){return e.findIndex(e=>"agent_message_chunk"===e.updateType&&!t||Boolean("tool_call_update"===e.updateType&&t&&e.toolCallId===t))}function findLocalArtifactInsertIndex(e,t){if(void 0!==t._seq){const o=e.findIndex(e=>void 0!==e._seq&&e._seq>t._seq);if(o>=0)return o}const o=replayFileToolCallId(t);if(o)for(let t=e.length-1;t>=0;t--){const s=e[t];if(s.toolCallId===o)return t+1;if(s.toolCalls?.some(e=>e.id===o))return t+1}return e.length}function replayFileToolCallId(e){return e.toolCallId?e.toolCallId:1===e.toolCalls?.length?e.toolCalls[0]?.id:void 0}function replayFileToolName(e){return e.toolName?e.toolName:1===e.toolCalls?.length?e.toolCalls[0]?.name:void 0}export async function loadHistoryPage(e,t,o){if(!e)return{messages:[],hasMore:!1};const s=await e.chatHistoryPage(t,{...null!=o.limit?{limit:o.limit}:{},...o.cursor?{cursor:o.cursor}:{}});if(!s)return(o.logger?.debug??(()=>{}))(`[loadHistoryPage] no page sid=${t} cursor=${o.cursor??"<head>"}`),{messages:[],hasMore:!1};const n=parseGatewayHistory({messages:s.messages});return(o.logger?.debug??(()=>{}))(`[loadHistoryPage] sid=${t} cursor=${o.cursor??"<head>"} raw=${s.messages.length} parsed=${n.length} hasMore=${s.hasMore} nextCursor=${s.nextCursor??"<none>"}`),{messages:n,...s.nextCursor?{nextCursor:s.nextCursor}:{},hasMore:s.hasMore}}export function groupIntoTurns(e){const t=[];let o=null;const s=()=>{o&&(t.push(o),o=null)};for(const n of e){if("assistant"===n.role&&(n.reasoning||n.toolCalls?.length)){s(),o={role:"assistant",content:n.content,reasoning:n.reasoning,files:n.files,sourceMessages:[n],...n.timestamp?{timestamp:n.timestamp}:{},...n.messageId?{messageId:n.messageId}:{},...void 0!==n._seq?{_seq:n._seq}:{}},n.toolCalls?.length&&(o.toolCalls=n.toolCalls.map(e=>({id:e.id,callId:e.id,name:e.name,arguments:e.arguments??"",status:e.status??"in_progress",output:e.output,isError:"error"===e.status||"failed"===e.status,kind:inferToolKindFromName(e.name)})));continue}if("assistant"===n.role&&"string"==typeof n.metadata?.status&&"error"===n.metadata.status){s();const e={role:"assistant",content:n.content,files:n.files,sourceMessages:[n],...n.timestamp?{timestamp:n.timestamp}:{},...n.messageId?{messageId:n.messageId}:{},...void 0!==n._seq?{_seq:n._seq}:{}};n.metadata&&(e.metadata=n.metadata),t.push(e);continue}if("system"===n.role){s();const e={role:"system",content:n.content};n.metadata&&(e.metadata=n.metadata),n.timestamp&&(e.timestamp=n.timestamp),n.messageId&&(e.messageId=n.messageId),void 0!==n._seq&&(e._seq=n._seq),t.push(e);continue}if("user"===n.role){s();const e={role:"user",content:n.content};n.provenance&&(e.provenance=n.provenance),n.metadata&&(e.metadata=n.metadata),n.timestamp&&(e.timestamp=n.timestamp),n.messageId&&(e.messageId=n.messageId),void 0!==n._seq&&(e._seq=n._seq),t.push(e);continue}o||(o={role:"assistant",content:"",sourceMessages:[]}),o.sourceMessages||(o.sourceMessages=[]),o.sourceMessages.push(n),!o.timestamp&&n.timestamp&&(o.timestamp=n.timestamp),!o.messageId&&n.messageId&&(o.messageId=n.messageId),void 0===o._seq&&void 0!==n._seq&&(o._seq=n._seq);switch(n.updateType??"agent_message_chunk"){case"agent_thought_chunk":o.reasoning=(o.reasoning??"")+n.content;break;case"tool_call":o.toolCalls||(o.toolCalls=[]),o.toolCalls.push({id:n.toolCallId??`tc_${o.toolCalls.length}`,callId:n.toolCallId??`tc_${o.toolCalls.length}`,name:n.toolName??"tool",arguments:n.content||"",status:"in_progress",kind:inferToolKindFromName(n.toolName)});break;case"tool_call_update":{n.files?.length&&(o.files=[...o.files??[],...n.files]),o.toolCalls||(o.toolCalls=[]);const e=n.toolCallId?o.toolCalls.find(e=>e.id===n.toolCallId):void 0;e?(e.output=n.content,e.status="completed"):o.toolCalls.push({id:n.toolCallId??`tc_${o.toolCalls.length}`,callId:n.toolCallId??`tc_${o.toolCalls.length}`,name:n.toolName??"tool",arguments:"",status:"completed",output:n.content,kind:inferToolKindFromName(n.toolName)});break}default:o.content+=n.content,n.files?.length&&(o.files=[...o.files??[],...n.files])}}return s(),t}const TOOL_CALL_BLOCK_TYPES=new Set(["toolCall","toolUse","functionCall","tool_use","tool_call","toolcall"]),TOOL_RESULT_BLOCK_TYPES=new Set(["tool_result","tool_result_error","toolResult"]);function readOpenClawMeta(e){const t=e.__openclaw;if(!t||"object"!=typeof t)return{};const o={},s=t.id,n=t.seq;return"string"==typeof s&&s.length>0&&(o.id=s),"number"==typeof n&&Number.isFinite(n)&&(o.seq=n),o}function rawSeqOf(e){if(!e||"object"!=typeof e)return;const t=e.__openclaw;if(!t||"object"!=typeof t)return;const o=t.seq;return"number"==typeof o&&Number.isFinite(o)?o:void 0}function sortBySeqWhenComplete(e){if(e.length<2)return e;for(const t of e)if(void 0===rawSeqOf(t))return e;const t=e.slice();return t.sort((e,t)=>rawSeqOf(e)-rawSeqOf(t)),t}function collapseErrorRetryChains(e){const t=new Set,o=new Set;for(const s of e){if(!s||"object"!=typeof s)continue;const e=s;if("assistant"!==e.role)continue;if("error"!==e.stopReason)continue;const n=e.__openclaw&&"object"==typeof e.__openclaw?e.__openclaw:void 0,a="string"==typeof n?.id?n.id:"string"==typeof e.id?e.id:void 0,i="string"==typeof e.parentId?e.parentId:void 0;a&&t.add(a),i&&o.add(i)}const s=[];let n=null;for(const a of e){if(!a||"object"!=typeof a){s.push(a),n=null;continue}const e=a;if(!("assistant"===e.role&&"error"===e.stopReason)){s.push(a),n=null;continue}const i=e.__openclaw&&"object"==typeof e.__openclaw?e.__openclaw:void 0,l="string"==typeof i?.id?i.id:"string"==typeof e.id?e.id:void 0;l&&o.has(l)&&t.has(l)||(null===n?(n=s.length,s.push(a)):s[n]=a)}return s}function extractBlockText(e){if("string"==typeof e)return e;if(!Array.isArray(e))return"";let t="";for(const o of e)"string"!=typeof o?o&&"object"==typeof o&&"string"==typeof o.text&&(t+=o.text):t+=o;return t}function isRecord(e){return!!e&&"object"==typeof e&&!Array.isArray(e)}function normalizePersistedToolResultForReplay(e,t,o){let s=isRecord(o)?buildToolResultSessionContentBlocks(e,o):[];if(0===s.length&&t?.trim()){const o=t.trim();try{const t=JSON.parse(o);s=buildToolResultSessionContentBlocks(e,t)}catch{s=[{type:"content",content:{type:"text",text:o}}]}}const n=[],a=[];for(const e of s){const t=e.content;"resource_link"===t.type&&t.uri?a.push({uri:t.uri,...t.name?{name:t.name}:{},...t.mimeType?{mimeType:t.mimeType}:{}}):"text"===t.type&&t.text&&n.push(t.text)}return{outputText:n.join("\n"),...a.length>0?{files:a}:{}}}export function parseGatewayHistory(e){if(!e||"object"!=typeof e)return[];const t=e.messages;if(!Array.isArray(t))return[];const o=collapseErrorRetryChains(sortBySeqWhenComplete(t)),s=[];let n=null;for(const e of o){if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.role?t.role:"assistant",a=readOpenClawMeta(t),i=a.id,l=a.seq,r=t.message?.timestamp,c=toISO("number"==typeof t.timestamp||"string"==typeof t.timestamp?t.timestamp:"number"==typeof r||"string"==typeof r?r:void 0),u=e=>(i&&(e.messageId=i),void 0!==l&&(e._seq=l),c&&!e.timestamp&&(e.timestamp=c),e);if("toolResult"===o||"tool"===o){const e=extractPersistedToolResultEnvelope(t),o=e?.toolCallId??"",a=e?.toolName??"tool",i=normalizePersistedToolResultForReplay(a,e?.rawText,e?.rawResult),l=i.outputText,r=!0===t.is_error||!0===t.isError;if(n?.toolCalls?.length){const e=(o?n.toolCalls.find(e=>e.id===o):void 0)??n.toolCalls.find(e=>void 0===e.output);e&&(e.output=l,e.status=r?"failed":"completed"),i.files?.length&&(n.files=[...n.files??[],...i.files])}else s.push(u({role:"assistant",content:l,updateType:"tool_call_update",toolCallId:o||void 0,toolName:a,files:i.files}));continue}if("user"===o&&Array.isArray(t.content)){let e=!1,o=!1;for(const s of t.content){if(!s||"object"!=typeof s)continue;const t=s,n="string"==typeof t.type?t.type:"";TOOL_RESULT_BLOCK_TYPES.has(n)?e=!0:"text"===n&&"string"==typeof t.text&&t.text.trim()&&(o=!0)}if(e&&!o){for(const e of t.content){if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.type?t.type:"";if(!TOOL_RESULT_BLOCK_TYPES.has(o))continue;const a=String(t.toolUseId??t.tool_use_id??t.toolCallId??t.tool_call_id??""),i=String(t.name??t.toolName??t.tool_name??"tool"),l="string"==typeof t.output?t.output:extractBlockText(t.content),r=normalizePersistedToolResultForReplay(i,l,t),c=r.outputText||l,p=!0===t.is_error||!0===t.isError;if(n?.toolCalls?.length){const e=(a?n.toolCalls.find(e=>e.id===a):void 0)??n.toolCalls.find(e=>void 0===e.output);e&&(e.output=c,e.status=p?"failed":"completed"),r.files?.length&&(n.files=[...n.files??[],...r.files])}else s.push(u({role:"assistant",content:c,updateType:"tool_call_update",toolCallId:a||void 0,toolName:i,files:r.files}))}continue}}const p="user"===o?"user":"assistant";let d,f,m,g,y,h="";if("string"==typeof t.content)h=t.content;else if(Array.isArray(t.content)){if("assistant"===p&&t.content.some(e=>{if(!e||"object"!=typeof e)return!1;const t="string"==typeof e.type?e.type:"";return TOOL_CALL_BLOCK_TYPES.has(t)||TOOL_RESULT_BLOCK_TYPES.has(t)})&&"assistant"===p){const e=new Map;for(const o of t.content){if("string"==typeof o){o&&s.push(u({role:"assistant",content:o,updateType:"agent_message_chunk"}));continue}if(!o||"object"!=typeof o)continue;const t=o,n="string"==typeof t.type?t.type:"";if("text"===n&&"string"==typeof t.text&&t.text)s.push(u({role:"assistant",content:t.text,updateType:"agent_message_chunk"}));else if("thinking"===n&&"string"==typeof t.thinking)s.push(u({role:"assistant",content:t.thinking,updateType:"agent_thought_chunk"}));else if("resource_link"===n&&"string"==typeof t.uri&&t.uri)m||(m=[]),m.push({uri:t.uri,..."string"==typeof t.name&&t.name?{name:t.name}:{},..."string"==typeof t.mimeType&&t.mimeType?{mimeType:t.mimeType}:{}});else if(TOOL_CALL_BLOCK_TYPES.has(n)){const o=t.arguments??t.input,n="string"==typeof o?o:null!=o?JSON.stringify(o):"",a=String(t.id??t.toolCallId??t.tool_call_id??""),i=u({role:"assistant",content:n,updateType:"tool_call",toolCallId:a,toolName:String(t.name??"tool")});s.push(i),a&&e.set(a,i)}else if(TOOL_RESULT_BLOCK_TYPES.has(n)){const o=String(t.toolUseId??t.tool_use_id??t.toolCallId??t.tool_call_id??""),n=e.get(o)?.toolName??String(t.name??t.toolName??t.tool_name??"tool"),a="string"==typeof t.output?t.output:extractBlockText(t.content),i=normalizePersistedToolResultForReplay(n,a,t),l=i.outputText||a,r=!0===t.is_error||!0===t.isError;if(s.push(u({role:"assistant",content:l,updateType:"tool_call_update",toolCallId:o||void 0,toolName:n,files:i.files})),o&&e.has(o)){const t=e.get(o);i.files?.length&&(t.files=[...t.files??[],...i.files]),t.toolCalls||(t.toolCalls=[{id:o,name:t.toolName??"tool",arguments:t.content,status:r?"failed":"completed",output:l}])}}}m?.length&&s.push(u({role:"assistant",content:"",files:m})),"string"==typeof t.reasoning&&t.reasoning?s.push(u({role:"assistant",content:t.reasoning,updateType:"agent_thought_chunk"})):"string"==typeof t.thinking&&t.thinking&&s.push(u({role:"assistant",content:t.thinking,updateType:"agent_thought_chunk"})),s.length>0&&"assistant"===s[s.length-1].role&&(n=s[s.length-1]);continue}for(const e of t.content){if("string"==typeof e){h+=e;continue}if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.type?t.type:"";"text"===o&&"string"==typeof t.text?h+=t.text:"thinking"===o&&"string"==typeof t.thinking?f=(f??"")+t.thinking:"resource_link"===o&&"string"==typeof t.uri&&t.uri&&(m||(m=[]),m.push({uri:t.uri,..."string"==typeof t.name&&t.name?{name:t.name}:{},..."string"==typeof t.mimeType&&t.mimeType?{mimeType:t.mimeType}:{}}))}}if(f||("string"==typeof t.reasoning&&t.reasoning?f=t.reasoning:"string"==typeof t.thinking&&t.thinking&&(f=t.thinking)),!d?.length){const e=t.tool_calls??t.toolCalls;if(Array.isArray(e)){d=[];for(const t of e){if(!t||"object"!=typeof t)continue;const e=t,o=e.function;d.push({id:String(e.id??e.toolCallId??""),name:String(o?.name??e.name??e.toolName??"tool"),arguments:"string"==typeof e.arguments?e.arguments:"string"==typeof o?.arguments?o.arguments:"",status:String(e.status??"in_progress"),output:"string"==typeof e.output?e.output:void 0})}0===d.length&&(d=void 0)}}if("user"===p&&h){h=stripBeeosUserEnvelope(h);const e=CANVAS_INTERACTION_RE.exec(h);if(e){const t=e[1];g={kind:"canvas_action"};const o={type:"canvas_action",actionName:t,surfaceId:e[2]},s=ACTION_CONTEXT_RE.exec(h);if(s)try{o.actionPayload=JSON.parse(s[1])}catch{}y=o,h=`Clicked "${t}"`}}if(!h&&!f&&!d?.length&&!m?.length&&"assistant"===p&&"string"==typeof t.errorMessage&&t.errorMessage){const e=t.errorMessage,o="string"==typeof t.stopReason?t.stopReason:void 0,s=formatProviderError({raw:e,stopReason:o});h=s.content,y={...y??{},status:"error",errorSource:"provider",errorCategory:s.category,...void 0!==s.httpStatus?{httpStatus:s.httpStatus}:{},...o?{stopReason:o}:{},rawError:e}}if(!(h||f||d?.length||m?.length))continue;if(!g&&"user"===p&&t.provenance&&"object"==typeof t.provenance){const e=t.provenance;"string"==typeof e.kind&&(g={kind:e.kind},"string"==typeof e.sourceTool&&(g.sourceTool=e.sourceTool))}const _=u({role:p,content:h,reasoning:f,toolCalls:d,provenance:g,metadata:y,files:m});s.push(_),"assistant"===p&&(n=_)}s.filter(e=>e.toolCalls?.length),s.reduce((e,t)=>e+(t.toolCalls?.length??0),0),s.reduce((e,t)=>e+(t.toolCalls?.filter(e=>void 0!==e.output).length??0),0);return s}const BEEOS_REF_RE=/<BEEOS_REF\s+((?:[^"]|"[^"]*")*?)\s*\/>/g;function parseBeeosRefAttrs(e){const t=new Map,o=/(\w+)="([^"]*)"/g;for(const s of e.matchAll(o))t.set(s[1],s[2]);return t}function guessMimeFromName(e){if(!e)return;const t=e.split(".").pop()?.toLowerCase();return t?{jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",gif:"image/gif",webp:"image/webp",svg:"image/svg+xml",pdf:"application/pdf",mp3:"audio/mpeg",wav:"audio/wav",mp4:"video/mp4",webm:"video/webm",txt:"text/plain",json:"application/json",csv:"text/csv"}[t]:void 0}export function splitBeeosRefReplayText(e){if(!e)return[];if(!e.includes("<BEEOS_REF "))return[{type:"text",text:e}];const t=[];let o=0;for(const s of e.matchAll(BEEOS_REF_RE)){const n=e.slice(o,s.index).trim();n&&t.push({type:"text",text:n});const a=parseBeeosRefAttrs(s[1]),i=a.get("id"),l=a.get("name"),r=a.get("status");i&&"download_failed"!==r?t.push({type:"resource_link",uri:`beeos-file://${i}`,fileName:l,mimeType:guessMimeFromName(l)??"application/octet-stream"}):i&&t.push({type:"resource_link",uri:`beeos-file://${i}`,fileName:l??"file",mimeType:guessMimeFromName(l)??"application/octet-stream"}),o=(s.index??0)+s[0].length}const s=e.slice(o).trim();return s&&t.push({type:"text",text:s}),t}const ATTACHMENT_MARKER_RE=/\[(image|file)\s+([^\]]*)\]/g;export function splitUserAttachmentMarkers(e){if(!e)return[];if(!e.includes("[image ")&&!e.includes("[file "))return[{type:"text",text:e}];const t=[];let o=0;for(const s of e.matchAll(ATTACHMENT_MARKER_RE)){const n=e.slice(o,s.index).trim();n&&t.push({type:"text",text:n});const a=s[1],i=s[2],l=new Map;for(const e of i.split(/\s+/)){const t=e.indexOf("=");t>0&&l.set(e.slice(0,t),e.slice(t+1))}t.push({type:a,mimeType:l.get("mime"),fileName:l.get("name")||("image"===a?"Image":"File")}),o=(s.index??0)+s[0].length}const s=e.slice(o).trim();return s&&t.push({type:"text",text:s}),t}export function splitUserReplayBlocks(e){return e?e.includes("<BEEOS_REF ")?splitBeeosRefReplayText(e):e.includes("[image ")||e.includes("[file ")?splitUserAttachmentMarkers(e):[{type:"text",text:e}]:[]}
+import{stripTransportMetadata}from"../message-filter.js";import{formatProviderError}from"./error-message-formatter.js";import{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";import{hydrateFromLocalArtifacts}from"./history-artifact-hydrator.js";import{projectPersistedToolResultForReplay,toReplayFiles}from"./tool-result-projection.js";const DEFAULT_CHAT_HISTORY_RPC_TIMEOUT_MS=3e3;function toISO(e){if(null!=e){if("string"==typeof e){if(!e)return;const t=new Date(e),o=t.getTime();return Number.isFinite(o)?t.toISOString():void 0}if(!(e<=0))try{return new Date(e).toISOString()}catch{return}}}function inferToolKindFromName(e){if(!e)return;const t=e.toLowerCase();return t.includes("read")?"read":t.includes("write")||t.includes("edit")?"edit":t.includes("delete")||t.includes("remove")?"delete":t.includes("move")||t.includes("rename")?"move":t.includes("search")||t.includes("find")?"search":t.includes("exec")||t.includes("run")||t.includes("bash")?"execute":t.includes("fetch")||t.includes("http")?"fetch":"other"}const BEEOS_USER_MSG_MARKER_RE=/(?:^|\n)\s*User Message From \w+:\s*\n/i,CANVAS_STATE_RE=/^\[Canvas State\][^\n]*/,SYSTEM_NOTE_RE=/^\[System Note\][^\n]*/,CANVAS_INTERACTION_RE=/^\[Canvas Interaction\] The user clicked "([^"]*)" on surface "([^"]*)"/,ACTION_CONTEXT_RE=/\nAction context: (.+?)(?:\n|$)/s;function stripBeeosUserEnvelope(e){const t=BEEOS_USER_MSG_MARKER_RE.exec(e);if(t){return e.slice(t.index+t[0].length).trim()}let o=e;return o=o.replace(CANVAS_STATE_RE,"").trimStart(),o=o.replace(SYSTEM_NOTE_RE,"").trimStart(),stripTransportMetadata(o).trim()}export async function loadHistory(e,t,o=100,s){const n=Date.now(),a=s?.rpcTimeoutMs??3e3,r=s?.logger,i=s?.emitObs,l=e=>{r?.info&&r.info(e)};let c,u=null;if(e?.isConnected)try{u=await Promise.race([e.chatHistory(t,o),new Promise(e=>{const t=setTimeout(()=>e(null),a);"object"==typeof t&&"unref"in t&&t.unref()})])}catch(e){c=e}const p=u?parseGatewayHistory(u):[];if(p.length>0){const e=hydrateFromLocalArtifacts({messages:p,gatewaySessionKey:t,options:s,logger:r,parseGatewayHistory:parseGatewayHistory}),o=e.messages,a=Date.now()-n,c=o.filter(e=>"user"===e.role).length,u=o.filter(e=>"assistant"===e.role).length,m=e.addedFileCount>0?"chat.history+local-jsonl-artifacts":"chat.history";return l(`[loadHistory] source=${m} sid=${t} messages=${o.length} (user=${c} asst=${u}) artifacts=${e.addedFileCount} elapsedMs=${a}`),i?.({name:"history.source",severity:"info",payload:{sessionKey:t,source:m,messages:o.length,userCount:c,asstCount:u,addedFileArtifacts:e.addedFileCount,elapsedMs:a}}),o}const{localHistory:m,agentId:d,sessionId:f}=s??{},g=e?.isConnected?null===u?c?"rpc-error":"rpc-timeout":"rpc-empty":"gateway-disconnected";if(!m||!d){const e=Date.now()-n;return l(`[loadHistory] source=none sid=${t} reason=${g} elapsedMs=${e}`),c&&(r?.warn??console.debug)?.(`[loadHistory] chat.history error: ${c instanceof Error?c.message:String(c)}`),i?.({name:"history.none",severity:"warn",payload:{sessionKey:t,reason:g,fallbackAvailable:!1,elapsedMs:e}}),[]}let y=[];try{y=m.readEntries({agentId:d,sessionKey:t,sessionId:f})}catch(e){(r?.warn??console.debug)?.(`[loadHistory] local jsonl read failed: ${e instanceof Error?e.message:String(e)}`)}if(0===y.length){const e=Date.now()-n;return l(`[loadHistory] source=none sid=${t} reason=${g},local-empty elapsedMs=${e}`),i?.({name:"history.none",severity:"warn",payload:{sessionKey:t,reason:`${g},local-empty`,fallbackAvailable:!0,elapsedMs:e}}),[]}const h=parseGatewayHistory({messages:y}),_=Date.now()-n;return l(`[loadHistory] source=local-jsonl sid=${t} reason=${g} messages=${h.length} localLines=${y.length} elapsedMs=${_}`),i?.({name:"history.local_fallback",severity:"info",payload:{sessionKey:t,reason:g,localLines:y.length,messages:h.length,elapsedMs:_}}),h}export async function loadHistoryPage(e,t,o){if(!e)return{messages:[],hasMore:!1};const s=await e.chatHistoryPage(t,{...null!=o.limit?{limit:o.limit}:{},...o.cursor?{cursor:o.cursor}:{}});if(!s)return(o.logger?.debug??(()=>{}))(`[loadHistoryPage] no page sid=${t} cursor=${o.cursor??"<head>"}`),{messages:[],hasMore:!1};const n=parseGatewayHistory({messages:s.messages});return(o.logger?.debug??(()=>{}))(`[loadHistoryPage] sid=${t} cursor=${o.cursor??"<head>"} raw=${s.messages.length} parsed=${n.length} hasMore=${s.hasMore} nextCursor=${s.nextCursor??"<none>"}`),{messages:n,...s.nextCursor?{nextCursor:s.nextCursor}:{},hasMore:s.hasMore}}export function groupIntoTurns(e){const t=[];let o=null;const s=()=>{o&&(t.push(o),o=null)};for(const n of e){if("assistant"===n.role&&(n.reasoning||n.toolCalls?.length)){s(),o={role:"assistant",content:n.content,reasoning:n.reasoning,files:n.files,sourceMessages:[n],...n.timestamp?{timestamp:n.timestamp}:{},...n.messageId?{messageId:n.messageId}:{},...void 0!==n._seq?{_seq:n._seq}:{}},n.toolCalls?.length&&(o.toolCalls=n.toolCalls.map(e=>({id:e.id,callId:e.id,name:e.name,arguments:e.arguments??"",status:e.status??"in_progress",output:e.output,isError:"error"===e.status||"failed"===e.status,kind:inferToolKindFromName(e.name)})));continue}if("assistant"===n.role&&"string"==typeof n.metadata?.status&&"error"===n.metadata.status){s();const e={role:"assistant",content:n.content,files:n.files,sourceMessages:[n],...n.timestamp?{timestamp:n.timestamp}:{},...n.messageId?{messageId:n.messageId}:{},...void 0!==n._seq?{_seq:n._seq}:{}};n.metadata&&(e.metadata=n.metadata),t.push(e);continue}if("system"===n.role){s();const e={role:"system",content:n.content};n.metadata&&(e.metadata=n.metadata),n.timestamp&&(e.timestamp=n.timestamp),n.messageId&&(e.messageId=n.messageId),void 0!==n._seq&&(e._seq=n._seq),t.push(e);continue}if("user"===n.role){s();const e={role:"user",content:n.content};n.provenance&&(e.provenance=n.provenance),n.metadata&&(e.metadata=n.metadata),n.timestamp&&(e.timestamp=n.timestamp),n.messageId&&(e.messageId=n.messageId),void 0!==n._seq&&(e._seq=n._seq),t.push(e);continue}o||(o={role:"assistant",content:"",sourceMessages:[]}),o.sourceMessages||(o.sourceMessages=[]),o.sourceMessages.push(n),!o.timestamp&&n.timestamp&&(o.timestamp=n.timestamp),!o.messageId&&n.messageId&&(o.messageId=n.messageId),void 0===o._seq&&void 0!==n._seq&&(o._seq=n._seq);switch(n.updateType??"agent_message_chunk"){case"agent_thought_chunk":o.reasoning=(o.reasoning??"")+n.content;break;case"tool_call":o.toolCalls||(o.toolCalls=[]),o.toolCalls.push({id:n.toolCallId??`tc_${o.toolCalls.length}`,callId:n.toolCallId??`tc_${o.toolCalls.length}`,name:n.toolName??"tool",arguments:n.content||"",status:"in_progress",kind:inferToolKindFromName(n.toolName)});break;case"tool_call_update":{n.files?.length&&(o.files=[...o.files??[],...n.files]),o.toolCalls||(o.toolCalls=[]);const e=n.toolCallId?o.toolCalls.find(e=>e.id===n.toolCallId):void 0;e?(e.output=n.content,e.status="completed"):o.toolCalls.push({id:n.toolCallId??`tc_${o.toolCalls.length}`,callId:n.toolCallId??`tc_${o.toolCalls.length}`,name:n.toolName??"tool",arguments:"",status:"completed",output:n.content,kind:inferToolKindFromName(n.toolName)});break}default:o.content+=n.content,n.files?.length&&(o.files=[...o.files??[],...n.files])}}return s(),t}const TOOL_CALL_BLOCK_TYPES=new Set(["toolCall","toolUse","functionCall","tool_use","tool_call","toolcall"]),TOOL_RESULT_BLOCK_TYPES=new Set(["tool_result","tool_result_error","toolResult"]);function readOpenClawMeta(e){const t=e.__openclaw;if(!t||"object"!=typeof t)return{};const o={},s=t.id,n=t.seq;return"string"==typeof s&&s.length>0&&(o.id=s),"number"==typeof n&&Number.isFinite(n)&&(o.seq=n),o}function rawSeqOf(e){if(!e||"object"!=typeof e)return;const t=e.__openclaw;if(!t||"object"!=typeof t)return;const o=t.seq;return"number"==typeof o&&Number.isFinite(o)?o:void 0}function sortBySeqWhenComplete(e){if(e.length<2)return e;for(const t of e)if(void 0===rawSeqOf(t))return e;const t=e.slice();return t.sort((e,t)=>rawSeqOf(e)-rawSeqOf(t)),t}function collapseErrorRetryChains(e){const t=new Set,o=new Set;for(const s of e){if(!s||"object"!=typeof s)continue;const e=s;if("assistant"!==e.role)continue;if("error"!==e.stopReason)continue;const n=e.__openclaw&&"object"==typeof e.__openclaw?e.__openclaw:void 0,a="string"==typeof n?.id?n.id:"string"==typeof e.id?e.id:void 0,r="string"==typeof e.parentId?e.parentId:void 0;a&&t.add(a),r&&o.add(r)}const s=[];let n=null;for(const a of e){if(!a||"object"!=typeof a){s.push(a),n=null;continue}const e=a;if(!("assistant"===e.role&&"error"===e.stopReason)){s.push(a),n=null;continue}const r=e.__openclaw&&"object"==typeof e.__openclaw?e.__openclaw:void 0,i="string"==typeof r?.id?r.id:"string"==typeof e.id?e.id:void 0;i&&o.has(i)&&t.has(i)||(null===n?(n=s.length,s.push(a)):s[n]=a)}return s}function extractBlockText(e){if("string"==typeof e)return e;if(!Array.isArray(e))return"";let t="";for(const o of e)"string"!=typeof o?o&&"object"==typeof o&&"string"==typeof o.text&&(t+=o.text):t+=o;return t}function isRecord(e){return!!e&&"object"==typeof e&&!Array.isArray(e)}export function parseGatewayHistory(e){if(!e||"object"!=typeof e)return[];const t=e.messages;if(!Array.isArray(t))return[];const o=collapseErrorRetryChains(sortBySeqWhenComplete(t)),s=[];let n=null;for(const e of o){if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.role?t.role:"assistant",a=readOpenClawMeta(t),r=a.id,i=a.seq,l=t.message?.timestamp,c=toISO("number"==typeof t.timestamp||"string"==typeof t.timestamp?t.timestamp:"number"==typeof l||"string"==typeof l?l:void 0),u=e=>(r&&(e.messageId=r),void 0!==i&&(e._seq=i),c&&!e.timestamp&&(e.timestamp=c),e);if("toolResult"===o||"tool"===o){const e=extractPersistedToolResultEnvelope(t),o=e?.toolCallId??"",a=e?.toolName??"tool",r=projectPersistedToolResultForReplay({toolCallId:o||void 0,toolName:a,rawText:e?.rawText,rawResult:e?.rawResult,timestamp:c}),i=toReplayFiles(r.resourceLinks),l=r.outputText,p=!0===t.is_error||!0===t.isError;if(n?.toolCalls?.length){const e=(o?n.toolCalls.find(e=>e.id===o):void 0)??n.toolCalls.find(e=>void 0===e.output);e&&(e.output=l,e.status=p?"failed":"completed"),i?.length&&(n.files=[...n.files??[],...i])}else s.push(u({role:"assistant",content:l,updateType:"tool_call_update",toolCallId:o||void 0,toolName:a,files:i}));continue}if("user"===o&&Array.isArray(t.content)){let e=!1,o=!1;for(const s of t.content){if(!s||"object"!=typeof s)continue;const t=s,n="string"==typeof t.type?t.type:"";TOOL_RESULT_BLOCK_TYPES.has(n)?e=!0:"text"===n&&"string"==typeof t.text&&t.text.trim()&&(o=!0)}if(e&&!o){for(const e of t.content){if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.type?t.type:"";if(!TOOL_RESULT_BLOCK_TYPES.has(o))continue;const a=String(t.toolUseId??t.tool_use_id??t.toolCallId??t.tool_call_id??""),r=String(t.name??t.toolName??t.tool_name??"tool"),i="string"==typeof t.output?t.output:extractBlockText(t.content),l=projectPersistedToolResultForReplay({toolCallId:a||void 0,toolName:r,rawText:i,rawResult:t,timestamp:c}),p=toReplayFiles(l.resourceLinks),m=l.outputText||i,d=!0===t.is_error||!0===t.isError;if(n?.toolCalls?.length){const e=(a?n.toolCalls.find(e=>e.id===a):void 0)??n.toolCalls.find(e=>void 0===e.output);e&&(e.output=m,e.status=d?"failed":"completed"),p?.length&&(n.files=[...n.files??[],...p])}else s.push(u({role:"assistant",content:m,updateType:"tool_call_update",toolCallId:a||void 0,toolName:r,files:p}))}continue}}const p="user"===o?"user":"assistant";let m,d,f,g,y,h="";if("string"==typeof t.content)h=t.content;else if(Array.isArray(t.content)){if("assistant"===p&&t.content.some(e=>{if(!e||"object"!=typeof e)return!1;const t="string"==typeof e.type?e.type:"";return TOOL_CALL_BLOCK_TYPES.has(t)||TOOL_RESULT_BLOCK_TYPES.has(t)})&&"assistant"===p){const e=new Map;for(const o of t.content){if("string"==typeof o){o&&s.push(u({role:"assistant",content:o,updateType:"agent_message_chunk"}));continue}if(!o||"object"!=typeof o)continue;const t=o,n="string"==typeof t.type?t.type:"";if("text"===n&&"string"==typeof t.text&&t.text)s.push(u({role:"assistant",content:t.text,updateType:"agent_message_chunk"}));else if("thinking"===n&&"string"==typeof t.thinking)s.push(u({role:"assistant",content:t.thinking,updateType:"agent_thought_chunk"}));else if("resource_link"===n&&"string"==typeof t.uri&&t.uri)f||(f=[]),f.push({uri:t.uri,..."string"==typeof t.name&&t.name?{name:t.name}:{},..."string"==typeof t.mimeType&&t.mimeType?{mimeType:t.mimeType}:{}});else if(TOOL_CALL_BLOCK_TYPES.has(n)){const o=t.arguments??t.input,n="string"==typeof o?o:null!=o?JSON.stringify(o):"",a=String(t.id??t.toolCallId??t.tool_call_id??""),r=u({role:"assistant",content:n,updateType:"tool_call",toolCallId:a,toolName:String(t.name??"tool")});s.push(r),a&&e.set(a,r)}else if(TOOL_RESULT_BLOCK_TYPES.has(n)){const o=String(t.toolUseId??t.tool_use_id??t.toolCallId??t.tool_call_id??""),n=e.get(o)?.toolName??String(t.name??t.toolName??t.tool_name??"tool"),a="string"==typeof t.output?t.output:extractBlockText(t.content),r=projectPersistedToolResultForReplay({toolCallId:o||void 0,toolName:n,rawText:a,rawResult:t,timestamp:c}),i=toReplayFiles(r.resourceLinks),l=r.outputText||a,p=!0===t.is_error||!0===t.isError;if(s.push(u({role:"assistant",content:l,updateType:"tool_call_update",toolCallId:o||void 0,toolName:n,files:i})),o&&e.has(o)){const t=e.get(o);i?.length&&(t.files=[...t.files??[],...i]),t.toolCalls||(t.toolCalls=[{id:o,name:t.toolName??"tool",arguments:t.content,status:p?"failed":"completed",output:l}])}}}f?.length&&s.push(u({role:"assistant",content:"",files:f})),"string"==typeof t.reasoning&&t.reasoning?s.push(u({role:"assistant",content:t.reasoning,updateType:"agent_thought_chunk"})):"string"==typeof t.thinking&&t.thinking&&s.push(u({role:"assistant",content:t.thinking,updateType:"agent_thought_chunk"})),s.length>0&&"assistant"===s[s.length-1].role&&(n=s[s.length-1]);continue}for(const e of t.content){if("string"==typeof e){h+=e;continue}if(!e||"object"!=typeof e)continue;const t=e,o="string"==typeof t.type?t.type:"";"text"===o&&"string"==typeof t.text?h+=t.text:"thinking"===o&&"string"==typeof t.thinking?d=(d??"")+t.thinking:"resource_link"===o&&"string"==typeof t.uri&&t.uri&&(f||(f=[]),f.push({uri:t.uri,..."string"==typeof t.name&&t.name?{name:t.name}:{},..."string"==typeof t.mimeType&&t.mimeType?{mimeType:t.mimeType}:{}}))}}if(d||("string"==typeof t.reasoning&&t.reasoning?d=t.reasoning:"string"==typeof t.thinking&&t.thinking&&(d=t.thinking)),!m?.length){const e=t.tool_calls??t.toolCalls;if(Array.isArray(e)){m=[];for(const t of e){if(!t||"object"!=typeof t)continue;const e=t,o=e.function;m.push({id:String(e.id??e.toolCallId??""),name:String(o?.name??e.name??e.toolName??"tool"),arguments:"string"==typeof e.arguments?e.arguments:"string"==typeof o?.arguments?o.arguments:"",status:String(e.status??"in_progress"),output:"string"==typeof e.output?e.output:void 0})}0===m.length&&(m=void 0)}}if("user"===p&&h){h=stripBeeosUserEnvelope(h);const e=CANVAS_INTERACTION_RE.exec(h);if(e){const t=e[1];g={kind:"canvas_action"};const o={type:"canvas_action",actionName:t,surfaceId:e[2]},s=ACTION_CONTEXT_RE.exec(h);if(s)try{o.actionPayload=JSON.parse(s[1])}catch{}y=o,h=`Clicked "${t}"`}}if(!h&&!d&&!m?.length&&!f?.length&&"assistant"===p&&"string"==typeof t.errorMessage&&t.errorMessage){const e=t.errorMessage,o="string"==typeof t.stopReason?t.stopReason:void 0,s=formatProviderError({raw:e,stopReason:o});h=s.content,y={...y??{},status:"error",errorSource:"provider",errorCategory:s.category,...void 0!==s.httpStatus?{httpStatus:s.httpStatus}:{},...o?{stopReason:o}:{},rawError:e}}if(!(h||d||m?.length||f?.length))continue;if(!g&&"user"===p&&t.provenance&&"object"==typeof t.provenance){const e=t.provenance;"string"==typeof e.kind&&(g={kind:e.kind},"string"==typeof e.sourceTool&&(g.sourceTool=e.sourceTool))}const _=u({role:p,content:h,reasoning:d,toolCalls:m,provenance:g,metadata:y,files:f});s.push(_),"assistant"===p&&(n=_)}s.filter(e=>e.toolCalls?.length),s.reduce((e,t)=>e+(t.toolCalls?.length??0),0),s.reduce((e,t)=>e+(t.toolCalls?.filter(e=>void 0!==e.output).length??0),0);return s}const BEEOS_REF_RE=/<BEEOS_REF\s+((?:[^"]|"[^"]*")*?)\s*\/>/g;function parseBeeosRefAttrs(e){const t=new Map,o=/(\w+)="([^"]*)"/g;for(const s of e.matchAll(o))t.set(s[1],s[2]);return t}function guessMimeFromName(e){if(!e)return;const t=e.split(".").pop()?.toLowerCase();return t?{jpg:"image/jpeg",jpeg:"image/jpeg",png:"image/png",gif:"image/gif",webp:"image/webp",svg:"image/svg+xml",pdf:"application/pdf",mp3:"audio/mpeg",wav:"audio/wav",mp4:"video/mp4",webm:"video/webm",txt:"text/plain",json:"application/json",csv:"text/csv"}[t]:void 0}export function splitBeeosRefReplayText(e){if(!e)return[];if(!e.includes("<BEEOS_REF "))return[{type:"text",text:e}];const t=[];let o=0;for(const s of e.matchAll(BEEOS_REF_RE)){const n=e.slice(o,s.index).trim();n&&t.push({type:"text",text:n});const a=parseBeeosRefAttrs(s[1]),r=a.get("id"),i=a.get("name"),l=a.get("status");r&&"download_failed"!==l?t.push({type:"resource_link",uri:`beeos-file://${r}`,fileName:i,mimeType:guessMimeFromName(i)??"application/octet-stream"}):r&&t.push({type:"resource_link",uri:`beeos-file://${r}`,fileName:i??"file",mimeType:guessMimeFromName(i)??"application/octet-stream"}),o=(s.index??0)+s[0].length}const s=e.slice(o).trim();return s&&t.push({type:"text",text:s}),t}const ATTACHMENT_MARKER_RE=/\[(image|file)\s+([^\]]*)\]/g;export function splitUserAttachmentMarkers(e){if(!e)return[];if(!e.includes("[image ")&&!e.includes("[file "))return[{type:"text",text:e}];const t=[];let o=0;for(const s of e.matchAll(ATTACHMENT_MARKER_RE)){const n=e.slice(o,s.index).trim();n&&t.push({type:"text",text:n});const a=s[1],r=s[2],i=new Map;for(const e of r.split(/\s+/)){const t=e.indexOf("=");t>0&&i.set(e.slice(0,t),e.slice(t+1))}t.push({type:a,mimeType:i.get("mime"),fileName:i.get("name")||("image"===a?"Image":"File")}),o=(s.index??0)+s[0].length}const s=e.slice(o).trim();return s&&t.push({type:"text",text:s}),t}export function splitUserReplayBlocks(e){return e?e.includes("<BEEOS_REF ")?splitBeeosRefReplayText(e):e.includes("[image ")||e.includes("[file ")?splitUserAttachmentMarkers(e):[{type:"text",text:e}]:[]}

package/dist/acp-gateway/history-replay.test.js

@@ -1 +1 @@
-import{describe,expect,it,vi,beforeEach,afterEach}from"vitest";import{mkdtempSync,mkdirSync,rmSync,writeFileSync}from"node:fs";import os from"node:os";import path from"node:path";import{groupIntoTurns,loadHistory,parseGatewayHistory}from"./history-replay.js";import{LocalSessionHistory}from"./local-session-history.js";function makeGateway(e={}){const{connected:t=!0,delayMs:s=0,response:a={messages:[]},reject:o=!1}=e;return{get isConnected(){return t},chatHistory:vi.fn(async()=>{if(s>0&&await new Promise(e=>setTimeout(e,s)),o)throw new Error("rpc-failed");return a})}}describe("loadHistory",()=>{const e={info:vi.fn(),warn:vi.fn(),debug:vi.fn()};let t;function s(e,s,a){const o=path.join(t,"agents",e,"sessions");mkdirSync(o,{recursive:!0});const n=path.join(o,`${s}.jsonl`),r=a.map(e=>JSON.stringify({id:e.id,type:"message",timestamp:(new Date).toISOString(),message:{role:e.role,content:[{type:"text",text:e.text}],timestamp:Date.now()}}));writeFileSync(n,r.join("\n")+"\n")}beforeEach(()=>{t=mkdtempSync(path.join(os.tmpdir(),"beeos-claw-lh-")),e.info.mockClear(),e.warn.mockClear(),e.debug.mockClear()}),afterEach(()=>{rmSync(t,{recursive:!0,force:!0})}),it("returns gateway messages when chat.history has content",async()=>{const t=makeGateway({response:{messages:[{id:"m1",role:"user",content:[{type:"text",text:"hi"}]},{id:"m2",role:"assistant",content:[{type:"text",text:"hello"}]}]}}),s=vi.fn(),a=await loadHistory(t,"agent:main:s1",100,{logger:e,emitObs:s});expect(a.length).toBeGreaterThan(0),expect(t.chatHistory).toHaveBeenCalledOnce(),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=chat.history")),expect(s).toHaveBeenCalledOnce(),expect(s).toHaveBeenCalledWith(expect.objectContaining({name:"history.source",severity:"info",payload:expect.objectContaining({source:"chat.history",messages:a.length})}))}),it("hydrates chat.history with local persisted toolResult file artifacts",async()=>{const s={status:"completed",result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"device-screenshots/screenshot.jpeg",mimeType:"image/jpeg"}]};!function(e,s,a){const o=path.join(t,"agents",e,"sessions");mkdirSync(o,{recursive:!0});const n=path.join(o,`${s}.jsonl`);writeFileSync(n,a.map(e=>JSON.stringify(e)).join("\n")+"\n")}("main","s1",[{id:"u1",type:"message",timestamp:"2026-07-02T18:02:44.475Z",message:{role:"user",content:[{type:"text",text:"@device /screenshot"}],timestamp:1783015364475}},{id:"a1",type:"message",timestamp:"2026-07-02T18:02:56.660Z",message:{role:"assistant",content:[{type:"toolCall",id:"tc-get-task",name:"beeos_get_task",arguments:{taskId:"task-1",agentId:"device"}}],timestamp:1783015376660}},{id:"tr1",type:"message",timestamp:"2026-07-02T18:02:57.046Z",message:{role:"toolResult",toolCallId:"tc-get-task",toolName:"beeos_get_task",content:[{type:"text",text:JSON.stringify({content:JSON.stringify(s)})}],details:{content:JSON.stringify(s)},isError:!1,timestamp:1783015377046}},{id:"a2",type:"message",timestamp:"2026-07-02T18:03:01.926Z",message:{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1783015381926}}]);const a=makeGateway({response:{messages:[{role:"user",content:[{type:"text",text:"@device /screenshot"}],timestamp:1783015364475,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"toolCall",id:"tc-get-task",name:"beeos_get_task",arguments:{taskId:"task-1",agentId:"device"}}],timestamp:1783015376660,__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1783015381926,__openclaw:{id:"a2",seq:4}}]}}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=vi.fn(),r=(await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",emitObs:n})).find(e=>"tool_call_update"===e.updateType&&"tc-get-task"===e.toolCallId);expect(r).toMatchObject({role:"assistant",updateType:"tool_call_update",toolCallId:"tc-get-task",toolName:"beeos_get_task",files:[{uri:"beeos-file://file-1",name:"device-screenshots/screenshot.jpeg",mimeType:"image/jpeg"}]}),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=chat.history+local-jsonl-artifacts")),expect(n).toHaveBeenCalledWith(expect.objectContaining({name:"history.source",severity:"info",payload:expect.objectContaining({source:"chat.history+local-jsonl-artifacts",addedFileArtifacts:1})}))}),it("falls back to local jsonl when gateway is disconnected",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"},{id:"m2",role:"assistant",text:"hello"}]);const a=makeGateway({connected:!1}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=vi.fn(),r=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",emitObs:n});expect(r.length).toBeGreaterThan(0),expect(a.chatHistory).not.toHaveBeenCalled(),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=local-jsonl")),expect(n).toHaveBeenCalledWith(expect.objectContaining({name:"history.local_fallback",severity:"info",payload:expect.objectContaining({reason:"gateway-disconnected"})}))}),it("falls back to local jsonl when chat.history times out",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({delayMs:500}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",rpcTimeoutMs:50});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-timeout"))}),it("falls back to local jsonl when chat.history returns empty",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({response:{messages:[]}}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1"});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-empty"))}),it("returns [] when both gateway and local are empty",async()=>{const s=makeGateway({response:{messages:[]}}),a=new LocalSessionHistory({logger:e,openclawHome:t}),o=vi.fn(),n=await loadHistory(s,"agent:main:s1",100,{logger:e,localHistory:a,agentId:"main",sessionId:"missing",emitObs:o});expect(n).toEqual([]),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("local-empty")),expect(o).toHaveBeenCalledWith(expect.objectContaining({name:"history.none",severity:"warn",payload:expect.objectContaining({fallbackAvailable:!0})}))}),it("falls back to local on rpc error",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({reject:!0}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1"});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-error"))})}),describe("parseGatewayHistory provider error replay",()=>{it("converts assistant stopReason=error + errorMessage (HTML) into a summarised bubble",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"你好"}],timestamp:17767039e5,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html><html><head><title>Bad gateway</title></head><body><h1>Bad gateway</h1><p>Cloudflare</p></body></html>",timestamp:1776703955154,__openclaw:{id:"a1",seq:2}}]});expect(e).toHaveLength(2);const t=e[1];expect(t.role).toBe("assistant"),expect(t.content).toContain("HTTP 502"),expect(t.content).not.toContain("<!DOCTYPE"),expect(t.content).not.toContain("<html"),expect(t.metadata).toMatchObject({status:"error",errorSource:"provider",errorCategory:"gateway",httpStatus:502,stopReason:"error"}),expect(t.metadata?.rawError).toContain("<!DOCTYPE"),expect(t.messageId).toBe("a1")}),it("passes through short plain-text error messages verbatim",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[],stopReason:"error",errorMessage:"rate_limit_exceeded: please slow down",timestamp:1776703955154,__openclaw:{id:"a2",seq:1}}]});expect(e).toHaveLength(1),expect(e[0].content).toBe("rate_limit_exceeded: please slow down"),expect(e[0].metadata).toMatchObject({status:"error",errorSource:"provider",errorCategory:"rate_limit"})}),it("truncates oversized plain-text error bodies",()=>{const e="x".repeat(2e3),t=parseGatewayHistory({messages:[{role:"assistant",content:[],stopReason:"error",errorMessage:e,__openclaw:{id:"a3",seq:1}}]});expect(t).toHaveLength(1),expect(t[0].content.length).toBeLessThan(e.length),expect(t[0].content.endsWith("…")).toBe(!0)}),it("does NOT reformat assistant messages whose normal content happens to contain HTML",()=>{const e="Sure, here is the snippet: <html><body><h1>Hello</h1></body></html>. The <h1> tag is a top-level heading.",t=parseGatewayHistory({messages:[{role:"assistant",content:[{type:"text",text:e}],errorMessage:"502 <html>should be ignored</html>",stopReason:"error",__openclaw:{id:"a5",seq:1}}]});expect(t).toHaveLength(1),expect(t[0].content).toBe(e),expect(t[0].content).toContain("<html>"),expect(t[0].metadata?.status).toBeUndefined(),expect(t[0].metadata?.errorCategory).toBeUndefined()}),it("collapses provider retry chains to a single terminal error entry (parentId linked)",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a1",__openclaw:{id:"a2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a2",__openclaw:{id:"a3",seq:4}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a3",__openclaw:{id:"a4",seq:5}}]});expect(e).toHaveLength(2),expect(e[0].role).toBe("user"),expect(e[1].role).toBe("assistant"),expect(e[1].messageId).toBe("a4"),expect(e[1].content).toContain("HTTP 502");const t=e[1].content.split("HTTP 502").length-1;expect(t).toBe(1)}),it("collapse fallback: missing __openclaw metadata still keeps only the last error in a contiguous run",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}]},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 1"},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 2 final"}]});expect(e).toHaveLength(2),expect(e[1].content).toBe("502 attempt 2 final")}),it("collapses sibling-style retries where every retry's parent is the same user (not a prior error)",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 1",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 2",parentId:"u1",__openclaw:{id:"a2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 3",parentId:"u1",__openclaw:{id:"a3",seq:4}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 4 final",parentId:"u1",__openclaw:{id:"a4",seq:5}}]}).filter(e=>"error"===e.metadata?.status);expect(e).toHaveLength(1),expect(e[0].messageId).toBe("a4"),expect(e[0].metadata?.rawError).toBe("502 attempt 4 final")}),it("does NOT collapse error chains that are separated by a successful reply",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"q1"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 first turn",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"user",content:[{type:"text",text:"q2"}],parentId:"a1",__openclaw:{id:"u2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"503 second turn",parentId:"u2",__openclaw:{id:"a2",seq:4}}]});expect(e).toHaveLength(4),expect(e[1].role).toBe("assistant"),expect(e[1].metadata?.status).toBe("error"),expect(e[3].role).toBe("assistant"),expect(e[3].metadata?.status).toBe("error")}),it("still drops genuinely empty assistant messages (no errorMessage, no content)",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[],__openclaw:{id:"a4",seq:1}}]});expect(e).toHaveLength(0)})}),describe("parseGatewayHistory deterministic ordering (Bug-W)",()=>{const e=[{role:"user",content:[{type:"text",text:"hi"}],timestamp:1776704e6,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"text",text:"hello"}],timestamp:1776704001e3,__openclaw:{id:"a1",seq:2}},{role:"user",content:[{type:"text",text:"what time is it"}],timestamp:1776704002e3,__openclaw:{id:"u2",seq:3}},{role:"assistant",content:[{type:"text",text:"3pm"}],timestamp:1776704003e3,__openclaw:{id:"a2",seq:4}}];it("produces the same sequence regardless of input order (shuffled inputs)",()=>{const t=parseGatewayHistory({messages:e}),s=parseGatewayHistory({messages:[...e].reverse()}),a=parseGatewayHistory({messages:[e[2],e[0],e[3],e[1]]});expect(t).toHaveLength(4),expect(s).toEqual(t),expect(a).toEqual(t);for(let e=1;e<t.length;e++)expect(t[e]._seq).toBeGreaterThan(t[e-1]._seq)}),it("preserves original order when any entry is missing __openclaw.seq",()=>{const t=parseGatewayHistory({messages:[e[0],e[1],{role:"assistant",content:[{type:"text",text:"oops"}]},e[2],e[3]]}),s=t.findIndex(e=>"assistant"===e.role&&e.content.includes("oops")),a=t.findIndex(e=>"user"===e.role&&e.content.includes("what time"));expect(s).toBeGreaterThan(-1),expect(a).toBeGreaterThan(s)}),it("sorts within a single turn that was split into multiple JSONL rows",()=>{const e=parseGatewayHistory({messages:[{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",content:"42"}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:13}},{role:"user",content:[{type:"text",text:"go"}],timestamp:1776704009e3,__openclaw:{id:"u9",seq:10}},{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"calc",input:{a:6,b:7}}],timestamp:177670401e4,__openclaw:{id:"a9",seq:12}},{role:"assistant",content:[{type:"text",text:"let me compute"}],timestamp:177670401e4,__openclaw:{id:"a9",seq:11}}]}).map(e=>e._seq);for(let t=1;t<e.length;t++)expect(e[t]).toBeGreaterThanOrEqual(e[t-1])}),it("replays persisted role=toolResult file artifacts as turn files",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"screenshot"}],timestamp:1776704009e3,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"beeos_get_task",input:{taskId:"task-1"}}],timestamp:177670401e4,__openclaw:{id:"a1",seq:2}},{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",name:"beeos_get_task",content:JSON.stringify({status:"completed",result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]})}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:3}},{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1776704012e3,__openclaw:{id:"a2",seq:4}}]}),t=e.find(e=>"tool_call_update"===e.updateType);expect(t).toMatchObject({content:"",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]});const s=groupIntoTurns(e).find(e=>"assistant"===e.role&&e.toolCalls?.length);expect(s?.files).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]),expect(s?.toolCalls?.[0]?.output).toBe("")}),it("does not replay text-only beeos-file URI tool results as files",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"beeos_get_task",input:{}}],timestamp:177670401e4,__openclaw:{id:"a1",seq:1}},{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",name:"beeos_get_task",content:"beeos-file://file-1"}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:2}}]}),t=e.find(e=>"tool_call_update"===e.updateType);expect(t).toMatchObject({content:"beeos-file://file-1"}),expect(t?.files).toBeUndefined();const s=groupIntoTurns(e).find(e=>"assistant"===e.role);expect(s?.files).toBeUndefined()}),it("does not reorder when all seqs are already ascending (no-op path)",()=>{const t=parseGatewayHistory({messages:e}).map(e=>e._seq);expect(t).toEqual([1,2,3,4])})});
+import{describe,expect,it,vi,beforeEach,afterEach}from"vitest";import{mkdtempSync,mkdirSync,rmSync,writeFileSync}from"node:fs";import os from"node:os";import path from"node:path";import{groupIntoTurns,loadHistory,parseGatewayHistory}from"./history-replay.js";import{LocalSessionHistory}from"./local-session-history.js";function makeGateway(e={}){const{connected:t=!0,delayMs:s=0,response:a={messages:[]},reject:o=!1}=e;return{get isConnected(){return t},chatHistory:vi.fn(async()=>{if(s>0&&await new Promise(e=>setTimeout(e,s)),o)throw new Error("rpc-failed");return a})}}describe("loadHistory",()=>{const e={info:vi.fn(),warn:vi.fn(),debug:vi.fn()};let t;function s(e,s,a){const o=path.join(t,"agents",e,"sessions");mkdirSync(o,{recursive:!0});const n=path.join(o,`${s}.jsonl`),r=a.map(e=>JSON.stringify({id:e.id,type:"message",timestamp:(new Date).toISOString(),message:{role:e.role,content:[{type:"text",text:e.text}],timestamp:Date.now()}}));writeFileSync(n,r.join("\n")+"\n")}beforeEach(()=>{t=mkdtempSync(path.join(os.tmpdir(),"beeos-claw-lh-")),e.info.mockClear(),e.warn.mockClear(),e.debug.mockClear()}),afterEach(()=>{rmSync(t,{recursive:!0,force:!0})}),it("returns gateway messages when chat.history has content",async()=>{const t=makeGateway({response:{messages:[{id:"m1",role:"user",content:[{type:"text",text:"hi"}]},{id:"m2",role:"assistant",content:[{type:"text",text:"hello"}]}]}}),s=vi.fn(),a=await loadHistory(t,"agent:main:s1",100,{logger:e,emitObs:s});expect(a.length).toBeGreaterThan(0),expect(t.chatHistory).toHaveBeenCalledOnce(),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=chat.history")),expect(s).toHaveBeenCalledOnce(),expect(s).toHaveBeenCalledWith(expect.objectContaining({name:"history.source",severity:"info",payload:expect.objectContaining({source:"chat.history",messages:a.length})}))}),it("hydrates chat.history with local persisted toolResult file artifacts",async()=>{const s={status:"completed",result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"device-screenshots/screenshot.jpeg",mimeType:"image/jpeg"}]};!function(e,s,a){const o=path.join(t,"agents",e,"sessions");mkdirSync(o,{recursive:!0});const n=path.join(o,`${s}.jsonl`);writeFileSync(n,a.map(e=>JSON.stringify(e)).join("\n")+"\n")}("main","s1",[{id:"u1",type:"message",timestamp:"2026-07-02T18:02:44.475Z",message:{role:"user",content:[{type:"text",text:"@device /screenshot"}],timestamp:1783015364475}},{id:"a1",type:"message",timestamp:"2026-07-02T18:02:56.660Z",message:{role:"assistant",content:[{type:"toolCall",id:"tc-get-task",name:"beeos_get_task",arguments:{taskId:"task-1",agentId:"device"}}],timestamp:1783015376660}},{id:"tr1",type:"message",timestamp:"2026-07-02T18:02:57.046Z",message:{role:"toolResult",toolCallId:"tc-get-task",toolName:"beeos_get_task",content:[{type:"text",text:JSON.stringify({content:JSON.stringify(s)})}],details:{content:JSON.stringify(s)},isError:!1,timestamp:1783015377046}},{id:"a2",type:"message",timestamp:"2026-07-02T18:03:01.926Z",message:{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1783015381926}}]);const a=makeGateway({response:{messages:[{role:"user",content:[{type:"text",text:"@device /screenshot"}],timestamp:1783015364475,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"toolCall",id:"tc-get-task",name:"beeos_get_task",arguments:{taskId:"task-1",agentId:"device"}}],timestamp:1783015376660,__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1783015381926,__openclaw:{id:"a2",seq:4}}]}}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=vi.fn(),r=(await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",emitObs:n})).find(e=>"tool_call_update"===e.updateType&&"tc-get-task"===e.toolCallId);expect(r).toMatchObject({role:"assistant",updateType:"tool_call_update",toolCallId:"tc-get-task",toolName:"beeos_get_task",files:[{uri:"beeos-file://file-1",name:"device-screenshots/screenshot.jpeg",mimeType:"image/jpeg"}]}),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=chat.history+local-jsonl-artifacts")),expect(n).toHaveBeenCalledWith(expect.objectContaining({name:"history.source",severity:"info",payload:expect.objectContaining({source:"chat.history+local-jsonl-artifacts",addedFileArtifacts:1})}))}),it("falls back to local jsonl when gateway is disconnected",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"},{id:"m2",role:"assistant",text:"hello"}]);const a=makeGateway({connected:!1}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=vi.fn(),r=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",emitObs:n});expect(r.length).toBeGreaterThan(0),expect(a.chatHistory).not.toHaveBeenCalled(),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("source=local-jsonl")),expect(n).toHaveBeenCalledWith(expect.objectContaining({name:"history.local_fallback",severity:"info",payload:expect.objectContaining({reason:"gateway-disconnected"})}))}),it("falls back to local jsonl when chat.history times out",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({delayMs:500}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1",rpcTimeoutMs:50});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-timeout"))}),it("falls back to local jsonl when chat.history returns empty",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({response:{messages:[]}}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1"});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-empty"))}),it("returns [] when both gateway and local are empty",async()=>{const s=makeGateway({response:{messages:[]}}),a=new LocalSessionHistory({logger:e,openclawHome:t}),o=vi.fn(),n=await loadHistory(s,"agent:main:s1",100,{logger:e,localHistory:a,agentId:"main",sessionId:"missing",emitObs:o});expect(n).toEqual([]),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("local-empty")),expect(o).toHaveBeenCalledWith(expect.objectContaining({name:"history.none",severity:"warn",payload:expect.objectContaining({fallbackAvailable:!0})}))}),it("falls back to local on rpc error",async()=>{s("main","s1",[{id:"m1",role:"user",text:"hi"}]);const a=makeGateway({reject:!0}),o=new LocalSessionHistory({logger:e,openclawHome:t}),n=await loadHistory(a,"agent:main:s1",100,{logger:e,localHistory:o,agentId:"main",sessionId:"s1"});expect(n.length).toBeGreaterThan(0),expect(e.info).toHaveBeenCalledWith(expect.stringContaining("reason=rpc-error"))})}),describe("parseGatewayHistory provider error replay",()=>{it("converts assistant stopReason=error + errorMessage (HTML) into a summarised bubble",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"你好"}],timestamp:17767039e5,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html><html><head><title>Bad gateway</title></head><body><h1>Bad gateway</h1><p>Cloudflare</p></body></html>",timestamp:1776703955154,__openclaw:{id:"a1",seq:2}}]});expect(e).toHaveLength(2);const t=e[1];expect(t.role).toBe("assistant"),expect(t.content).toContain("HTTP 502"),expect(t.content).not.toContain("<!DOCTYPE"),expect(t.content).not.toContain("<html"),expect(t.metadata).toMatchObject({status:"error",errorSource:"provider",errorCategory:"gateway",httpStatus:502,stopReason:"error"}),expect(t.metadata?.rawError).toContain("<!DOCTYPE"),expect(t.messageId).toBe("a1")}),it("passes through short plain-text error messages verbatim",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[],stopReason:"error",errorMessage:"rate_limit_exceeded: please slow down",timestamp:1776703955154,__openclaw:{id:"a2",seq:1}}]});expect(e).toHaveLength(1),expect(e[0].content).toBe("rate_limit_exceeded: please slow down"),expect(e[0].metadata).toMatchObject({status:"error",errorSource:"provider",errorCategory:"rate_limit"})}),it("truncates oversized plain-text error bodies",()=>{const e="x".repeat(2e3),t=parseGatewayHistory({messages:[{role:"assistant",content:[],stopReason:"error",errorMessage:e,__openclaw:{id:"a3",seq:1}}]});expect(t).toHaveLength(1),expect(t[0].content.length).toBeLessThan(e.length),expect(t[0].content.endsWith("…")).toBe(!0)}),it("does NOT reformat assistant messages whose normal content happens to contain HTML",()=>{const e="Sure, here is the snippet: <html><body><h1>Hello</h1></body></html>. The <h1> tag is a top-level heading.",t=parseGatewayHistory({messages:[{role:"assistant",content:[{type:"text",text:e}],errorMessage:"502 <html>should be ignored</html>",stopReason:"error",__openclaw:{id:"a5",seq:1}}]});expect(t).toHaveLength(1),expect(t[0].content).toBe(e),expect(t[0].content).toContain("<html>"),expect(t[0].metadata?.status).toBeUndefined(),expect(t[0].metadata?.errorCategory).toBeUndefined()}),it("collapses provider retry chains to a single terminal error entry (parentId linked)",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a1",__openclaw:{id:"a2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a2",__openclaw:{id:"a3",seq:4}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 <!DOCTYPE html>bad gateway</html>",parentId:"a3",__openclaw:{id:"a4",seq:5}}]});expect(e).toHaveLength(2),expect(e[0].role).toBe("user"),expect(e[1].role).toBe("assistant"),expect(e[1].messageId).toBe("a4"),expect(e[1].content).toContain("HTTP 502");const t=e[1].content.split("HTTP 502").length-1;expect(t).toBe(1)}),it("collapse fallback: missing __openclaw metadata still keeps only the last error in a contiguous run",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}]},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 1"},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 2 final"}]});expect(e).toHaveLength(2),expect(e[1].content).toBe("502 attempt 2 final")}),it("collapses sibling-style retries where every retry's parent is the same user (not a prior error)",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"hi"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 1",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 2",parentId:"u1",__openclaw:{id:"a2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 3",parentId:"u1",__openclaw:{id:"a3",seq:4}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 attempt 4 final",parentId:"u1",__openclaw:{id:"a4",seq:5}}]}).filter(e=>"error"===e.metadata?.status);expect(e).toHaveLength(1),expect(e[0].messageId).toBe("a4"),expect(e[0].metadata?.rawError).toBe("502 attempt 4 final")}),it("does NOT collapse error chains that are separated by a successful reply",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"q1"}],__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[],stopReason:"error",errorMessage:"502 first turn",parentId:"u1",__openclaw:{id:"a1",seq:2}},{role:"user",content:[{type:"text",text:"q2"}],parentId:"a1",__openclaw:{id:"u2",seq:3}},{role:"assistant",content:[],stopReason:"error",errorMessage:"503 second turn",parentId:"u2",__openclaw:{id:"a2",seq:4}}]});expect(e).toHaveLength(4),expect(e[1].role).toBe("assistant"),expect(e[1].metadata?.status).toBe("error"),expect(e[3].role).toBe("assistant"),expect(e[3].metadata?.status).toBe("error")}),it("still drops genuinely empty assistant messages (no errorMessage, no content)",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[],__openclaw:{id:"a4",seq:1}}]});expect(e).toHaveLength(0)})}),describe("parseGatewayHistory deterministic ordering (Bug-W)",()=>{const e=[{role:"user",content:[{type:"text",text:"hi"}],timestamp:1776704e6,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"text",text:"hello"}],timestamp:1776704001e3,__openclaw:{id:"a1",seq:2}},{role:"user",content:[{type:"text",text:"what time is it"}],timestamp:1776704002e3,__openclaw:{id:"u2",seq:3}},{role:"assistant",content:[{type:"text",text:"3pm"}],timestamp:1776704003e3,__openclaw:{id:"a2",seq:4}}];it("produces the same sequence regardless of input order (shuffled inputs)",()=>{const t=parseGatewayHistory({messages:e}),s=parseGatewayHistory({messages:[...e].reverse()}),a=parseGatewayHistory({messages:[e[2],e[0],e[3],e[1]]});expect(t).toHaveLength(4),expect(s).toEqual(t),expect(a).toEqual(t);for(let e=1;e<t.length;e++)expect(t[e]._seq).toBeGreaterThan(t[e-1]._seq)}),it("preserves original order when any entry is missing __openclaw.seq",()=>{const t=parseGatewayHistory({messages:[e[0],e[1],{role:"assistant",content:[{type:"text",text:"oops"}]},e[2],e[3]]}),s=t.findIndex(e=>"assistant"===e.role&&e.content.includes("oops")),a=t.findIndex(e=>"user"===e.role&&e.content.includes("what time"));expect(s).toBeGreaterThan(-1),expect(a).toBeGreaterThan(s)}),it("sorts within a single turn that was split into multiple JSONL rows",()=>{const e=parseGatewayHistory({messages:[{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",content:"42"}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:13}},{role:"user",content:[{type:"text",text:"go"}],timestamp:1776704009e3,__openclaw:{id:"u9",seq:10}},{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"calc",input:{a:6,b:7}}],timestamp:177670401e4,__openclaw:{id:"a9",seq:12}},{role:"assistant",content:[{type:"text",text:"let me compute"}],timestamp:177670401e4,__openclaw:{id:"a9",seq:11}}]}).map(e=>e._seq);for(let t=1;t<e.length;t++)expect(e[t]).toBeGreaterThanOrEqual(e[t-1])}),it("replays persisted role=toolResult file artifacts as turn files",()=>{const e=parseGatewayHistory({messages:[{role:"user",content:[{type:"text",text:"screenshot"}],timestamp:1776704009e3,__openclaw:{id:"u1",seq:1}},{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"beeos_get_task",input:{taskId:"task-1"}}],timestamp:177670401e4,__openclaw:{id:"a1",seq:2}},{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",name:"beeos_get_task",content:JSON.stringify({status:"completed",result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]})}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:3}},{role:"assistant",content:[{type:"text",text:"Done"}],timestamp:1776704012e3,__openclaw:{id:"a2",seq:4}}]}),t=e.find(e=>"tool_call_update"===e.updateType),s=e.findIndex(e=>"tool_call_update"===e.updateType),a=e.findIndex(e=>"assistant"===e.role&&"Done"===e.content);expect(s).toBeGreaterThanOrEqual(0),expect(a).toBeGreaterThan(s),expect(t).toMatchObject({content:"",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]});const o=groupIntoTurns(e).find(e=>"assistant"===e.role&&e.toolCalls?.length);expect(o?.files).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]),expect(o?.toolCalls?.[0]?.output).toBe("")}),it("does not replay text-only beeos-file URI tool results as files",()=>{const e=parseGatewayHistory({messages:[{role:"assistant",content:[{type:"tool_use",id:"tc_1",name:"beeos_get_task",input:{}}],timestamp:177670401e4,__openclaw:{id:"a1",seq:1}},{role:"toolResult",content:[{type:"tool_result",tool_use_id:"tc_1",name:"beeos_get_task",content:"beeos-file://file-1"}],timestamp:1776704011e3,__openclaw:{id:"tr1",seq:2}}]}),t=e.find(e=>"tool_call_update"===e.updateType);expect(t).toMatchObject({content:"beeos-file://file-1"}),expect(t?.files).toBeUndefined();const s=groupIntoTurns(e).find(e=>"assistant"===e.role);expect(s?.files).toBeUndefined()}),it("does not reorder when all seqs are already ascending (no-op path)",()=>{const t=parseGatewayHistory({messages:e}).map(e=>e._seq);expect(t).toEqual([1,2,3,4])})});

package/dist/acp-gateway/missing-artifacts-reconciler.js

@@ -1 +1 @@
-import{findLocalHistoryEntryByMessageId}from"./local-session-history.js";import{recordToolCallTurnForUpdate}from"./gateway-events.js";import{buildToolCallPayload}from"./tool-call-payload-builder.js";import{emitNormalizedToolResultForTurn}from"./tool-result-emitter.js";import{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";import{stripTransportMetadata}from"../message-filter.js";export function reconcileMissingArtifacts(t,e){const{session:o,turnId:s,messageId:n,runId:r}=e;if(!o.agentId)return;const i=(o.toolCallTurns?.size??0)>0;o.hasAgentAssistantStream&&o.hasAgentThinkingStream&&o.hasAgentToolStartStream&&o.hasAgentToolResultStream&&!i||setImmediate(()=>{(async()=>{if(t.isSessionAlive(o.sessionId))try{const e=t.localHistory.readEntries({agentId:o.agentId,sessionKey:o.gatewaySessionKey,sessionId:o.sessionId}),i=findLocalHistoryEntryByMessageId(e,n);if(!i)return;const a=findLocalHistoryEntryIndexByMessageId(e,n),l=Array.isArray(i.content)?i.content:[];if(0===l.length)return;const c="number"==typeof i.timestamp?new Date(i.timestamp).toISOString():"string"==typeof i.timestamp?i.timestamp:void 0;let d=0;const m=e=>{void 0===e._turnId&&(e._turnId=s),t.transport.sendSessionUpdate(o.sessionId,e,{turnId:s})&&(d+=1)};await reconcilePersistedToolResultsInTurn({deps:t,session:o,turnId:s,entries:e,currentIndex:a,timestamp:c,emit:m});for(const e of l){if(!isRecord(e))continue;const n=asString(e.type);if(n){if("text"===n&&!o.hasAgentAssistantStream){const t=asString(e.text);if(!t)continue;const o=stripTransportMetadata(t);if(!o)continue;m({sessionUpdate:"agent_message_chunk",content:{type:"text",text:o},...c?{timestamp:c}:{}});continue}if("thinking"===n&&!o.hasAgentThinkingStream){const t=asString(e.thinking)??asString(e.text);if(!t)continue;m({sessionUpdate:"agent_thought_chunk",content:{type:"text",text:t},...c?{timestamp:c}:{}});continue}if("toolCall"===n&&!o.hasAgentToolStartStream){const t=resolveToolCallId(e),n=asString(e.name)??asString(e.toolName)??asString(e.tool_name)??"tool",r=resolveToolArgs(e),i=buildToolCallPayload({toolCallId:t,toolName:n,args:r,timestamp:c});recordToolCallTurnForUpdate(o,i,s),m(i);continue}if("toolResult"===n&&!o.hasAgentToolResultStream){const n=resolveToolCallId(e),r=asString(e.name)??asString(e.toolName)??asString(e.tool_name)??"tool",i=e.result,a=asString(e.text)??asString(e.result)??(isRecord(i)||Array.isArray(i)?JSON.stringify(i,null,2):void 0);if(!a)continue;await emitNormalizedToolResultForTurn({session:o,envelope:{toolCallId:n,toolName:r,rawText:a,rawResult:i,...c?{timestamp:c}:{}},turnId:s,config:t.config,logger:t.logger,writeObs:t.writeObs,getCanvasState:t.getCanvasState,sendUpdate:t=>(m(t),!0)});continue}}}d>0&&(t.logger.info?.(`[missing-artifacts] reconciled ${d} block(s) sessionId=${o.sessionId} runId=${r??"n/a"} messageId=${n}`),t.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.emitted",severity:"info",payload:{sessionId:o.sessionId,runId:r,messageId:n,emitted:d}}))}catch(e){t.logger.warn?.(`[missing-artifacts] reconcile failed sessionId=${o.sessionId} messageId=${n}: ${e instanceof Error?e.message:String(e)}`),t.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.failed",severity:"warn",payload:{sessionId:o.sessionId,messageId:n,error:e instanceof Error?e.message:String(e)}})}else t.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.skipped_stale",severity:"debug",payload:{sessionId:o.sessionId,messageId:n,runId:r}})})()})}async function reconcilePersistedToolResultsInTurn(t){const{deps:e,session:o,turnId:s,entries:n,currentIndex:r,timestamp:i,emit:a}=t;if(r<0)return 0;const l=findCurrentUserTurnStart(n,r),c=n.slice(l,r+1);recordToolCallsFromTurnWindow(o,s,c);let d=0;for(const t of c){const n=t.role;if("toolResult"!==n&&"tool"!==n)continue;const r=extractPersistedToolResultEnvelope(t);if(!r?.toolCallId)continue;const l=o.toolCallTurns?.get(r.toolCallId);if(l?.turnId!==s)continue;const c=d;await emitNormalizedToolResultForTurn({session:o,envelope:{toolCallId:r.toolCallId,toolName:r.toolName||l.toolName||"tool",...r.rawText?{rawText:r.rawText}:{},...r.rawResult?{rawResult:r.rawResult}:{},...r.timestamp??i?{timestamp:r.timestamp??i}:{}},turnId:s,config:e.config,logger:e.logger,writeObs:e.writeObs,getCanvasState:e.getCanvasState,sendUpdate:t=>(a(t),d+=1,!0)}),d>c&&e.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.persisted_tool_result.emitted",severity:"info",payload:{sessionId:o.sessionId,toolCallId:r.toolCallId,toolName:r.toolName,emitted:d-c}})}return d}function findCurrentUserTurnStart(t,e){for(let o=e;o>=0;o--){const e=t[o]?.role;if("user"===e)return o+1}return 0}function recordToolCallsFromTurnWindow(t,e,o){for(const s of o){if("assistant"!==s.role)continue;const o=Array.isArray(s.content)?s.content:[];for(const s of o){if(!isRecord(s))continue;if("toolCall"!==asString(s.type))continue;const o=resolveToolCallId(s),n=asString(s.name)??asString(s.toolName)??asString(s.tool_name)??"tool";t.toolCallTurns??=new Map,t.toolCallTurns.has(o)||t.toolCallTurns.set(o,{turnId:e,toolName:n})}}}function findLocalHistoryEntryIndexByMessageId(t,e){for(let o=t.length-1;o>=0;o--){const s=t[o];if(!s)continue;const n=s.__openclaw;if(isRecord(n)&&n.id===e)return o;if(s.id===e)return o}return-1}function isRecord(t){return!!t&&"object"==typeof t&&!Array.isArray(t)}function asString(t){if("string"==typeof t&&t.length>0)return t}function resolveToolCallId(t){const e=asString(t.toolCallId)??asString(t.tool_call_id)??asString(t.id);return e||`reconcile_${hashStable(JSON.stringify(t))}`}function resolveToolArgs(t){const e=[t.arguments,t.args,t.input];for(const t of e){if(isRecord(t))return t;if("string"==typeof t)try{const e=JSON.parse(t);if(isRecord(e))return e}catch{}}return{}}function hashStable(t){let e=5381;for(let o=0;o<t.length;o++)e=(e<<5)+e+t.charCodeAt(o)|0;return(e>>>0).toString(16)}
+import{findLocalHistoryEntryByMessageId}from"./local-session-history.js";import{recordToolCallTurnForUpdate}from"./gateway-events.js";import{buildToolCallPayload}from"./tool-call-payload-builder.js";import{emitNormalizedToolResultForTurn,emitToolResultProjectionForTurn}from"./tool-result-emitter.js";import{collectToolCallsFromTurnWindow,collectToolResultsFromTurnWindow,findCurrentUserTurnStart,findLocalHistoryEntryIndexByMessageId,resolveToolArgs,resolveToolCallId}from"./tool-result-transcript.js";import{stripTransportMetadata}from"../message-filter.js";export function reconcileMissingArtifacts(e,t){const{session:o,turnId:s,messageId:n,runId:r}=t;if(!o.agentId)return;const i=(o.toolCallTurns?.size??0)>0;o.hasAgentAssistantStream&&o.hasAgentThinkingStream&&o.hasAgentToolStartStream&&o.hasAgentToolResultStream&&!i||setImmediate(()=>{(async()=>{if(e.isSessionAlive(o.sessionId))try{const t=e.localHistory.readEntries({agentId:o.agentId,sessionKey:o.gatewaySessionKey,sessionId:o.sessionId}),i=findLocalHistoryEntryByMessageId(t,n);if(!i)return;const a=findLocalHistoryEntryIndexByMessageId(t,n),l=Array.isArray(i.content)?i.content:[];if(0===l.length)return;const d="number"==typeof i.timestamp?new Date(i.timestamp).toISOString():"string"==typeof i.timestamp?i.timestamp:void 0;let c=0;const m=t=>{void 0===t._turnId&&(t._turnId=s),e.transport.sendSessionUpdate(o.sessionId,t,{turnId:s})&&(c+=1)};await reconcilePersistedToolResultsInTurn({deps:e,session:o,turnId:s,entries:t,currentIndex:a,timestamp:d,emit:m});for(const t of l){if(!isRecord(t))continue;const n=asString(t.type);if(n){if("text"===n&&!o.hasAgentAssistantStream){const e=asString(t.text);if(!e)continue;const o=stripTransportMetadata(e);if(!o)continue;m({sessionUpdate:"agent_message_chunk",content:{type:"text",text:o},...d?{timestamp:d}:{}});continue}if("thinking"===n&&!o.hasAgentThinkingStream){const e=asString(t.thinking)??asString(t.text);if(!e)continue;m({sessionUpdate:"agent_thought_chunk",content:{type:"text",text:e},...d?{timestamp:d}:{}});continue}if("toolCall"===n&&!o.hasAgentToolStartStream){const e=resolveToolCallId(t),n=asString(t.name)??asString(t.toolName)??asString(t.tool_name)??"tool",r=resolveToolArgs(t),i=buildToolCallPayload({toolCallId:e,toolName:n,args:r,timestamp:d});recordToolCallTurnForUpdate(o,i,s),m(i);continue}if("toolResult"===n&&!o.hasAgentToolResultStream){const n=resolveToolCallId(t),r=asString(t.name)??asString(t.toolName)??asString(t.tool_name)??"tool",i=t.result,a=asString(t.text)??asString(t.result)??(isRecord(i)||Array.isArray(i)?JSON.stringify(i,null,2):void 0);if(!a)continue;await emitNormalizedToolResultForTurn({session:o,envelope:{toolCallId:n,toolName:r,rawText:a,rawResult:i,...d?{timestamp:d}:{}},turnId:s,config:e.config,logger:e.logger,writeObs:e.writeObs,getCanvasState:e.getCanvasState,sendUpdate:e=>(m(e),!0)});continue}}}c>0&&(e.logger.info?.(`[missing-artifacts] reconciled ${c} block(s) sessionId=${o.sessionId} runId=${r??"n/a"} messageId=${n}`),e.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.emitted",severity:"info",payload:{sessionId:o.sessionId,runId:r,messageId:n,emitted:c}}))}catch(t){e.logger.warn?.(`[missing-artifacts] reconcile failed sessionId=${o.sessionId} messageId=${n}: ${t instanceof Error?t.message:String(t)}`),e.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.failed",severity:"warn",payload:{sessionId:o.sessionId,messageId:n,error:t instanceof Error?t.message:String(t)}})}else e.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.missing_artifacts.skipped_stale",severity:"debug",payload:{sessionId:o.sessionId,messageId:n,runId:r}})})()})}async function reconcilePersistedToolResultsInTurn(e){const{deps:t,session:o,turnId:s,entries:n,currentIndex:r,timestamp:i,emit:a}=e;if(r<0)return 0;const l=findCurrentUserTurnStart(n,r);recordToolCallsFromTurnWindow(o,s,n.slice(l,r+1));let d=0;const c=collectToolResultsFromTurnWindow({entries:n,currentIndex:r,turnId:s,toolCallTurns:o.toolCallTurns,timestamp:i});for(const e of c){if(!e.toolCallId)continue;const n=d;await emitToolResultProjectionForTurn({session:o,projection:e,toolCallId:e.toolCallId,turnId:s,config:t.config,logger:t.logger,writeObs:t.writeObs,getCanvasState:t.getCanvasState,sendUpdate:e=>(a(e),d+=1,!0)}),d>n&&t.writeObs({component:"bridge-core",domain:"lifecycle",name:"reconcile.persisted_tool_result.emitted",severity:"info",payload:{sessionId:o.sessionId,toolCallId:e.toolCallId,toolName:e.toolName,projectionKey:e.projectionKey,emitted:d-n}})}return d}function recordToolCallsFromTurnWindow(e,t,o){for(const s of collectToolCallsFromTurnWindow(o))e.toolCallTurns??=new Map,e.toolCallTurns.has(s.toolCallId)||e.toolCallTurns.set(s.toolCallId,{turnId:t,toolName:s.toolName})}function isRecord(e){return!!e&&"object"==typeof e&&!Array.isArray(e)}function asString(e){if("string"==typeof e&&e.length>0)return e}

package/dist/acp-gateway/tool-result-blocks.js

@@ -0,0 +1 @@
+import{asTrimmedNonEmptyString as asStr,isPlainRecord as isRecord}from"../utils/text.js";export function buildToolResultSessionContentBlocks(t,e){const n=[];if(!isRecord(e))return"string"==typeof e&&e.trim()&&n.push({type:"content",content:{type:"text",text:e.trim()}}),n;const r=buildFileResourceBlocks(e),o=asStr(e.content);if(o){const e=buildBlocksFromJsonText(t,o);if(e.length>0)return appendFileBlocks(e,r)}const s=e.content??e.result;if(Array.isArray(s)){for(const t of s){const e=toContentBlock(t);e&&n.push(e)}if(n.length>0)return appendFileBlocks(n,r)}const i=e.result;if(i&&"object"==typeof i&&!Array.isArray(i)){const t=i.content;if(Array.isArray(t)){for(const e of t){const t=toContentBlock(e);t&&n.push(t)}if(n.length>0)return appendFileBlocks(n,r)}}const c=asStr(e.output)??asStr(e.text)??asStr(e.result)??o??asStr(e.message)??asStr(e.error);return c&&n.push({type:"content",content:{type:"text",text:c}}),appendFileBlocks(n,r)}function buildBlocksFromJsonText(t,e){const n=e.trim();if(!n||!n.startsWith("{")&&!n.startsWith("["))return[];try{return buildToolResultSessionContentBlocks(t,JSON.parse(n))}catch{return[]}}function buildFileResourceBlocks(t){if(!Array.isArray(t.files))return[];const e=[];for(const n of t.files){if(!isRecord(n))continue;const t=asStr(n.fileId)??asStr(n.file_id),r=t?`beeos-file://${t}`:asStr(n.uri)??asStr(n.downloadUrl)??asStr(n.url);if(!r)continue;const o=asStr(n.name)??asStr(n.fileName)??asStr(n.file_name),s=asStr(n.mimeType)??asStr(n.mime_type);e.push({type:"content",content:{type:"resource_link",uri:r,...o?{name:o}:{},...s?{mimeType:s}:{}}})}return e}function appendFileBlocks(t,e){if(0===e.length)return t;const n=new Set(e.map(t=>t.content.uri).filter(Boolean));return[...t.filter(t=>!("text"===t.content.type&&t.content.text&&n.has(t.content.text))),...e]}function toContentBlock(t){if(!isRecord(t))return"string"==typeof t&&t.trim()?{type:"content",content:{type:"text",text:t.trim()}}:null;const e=asStr(t.type);if(!e)return null;if("text"===e){const e=asStr(t.text);return e?{type:"content",content:{type:"text",text:e}}:null}if("resource_link"===e){const e=asStr(t.uri);return e?{type:"content",content:{type:"resource_link",uri:e,...t.name?{name:String(t.name)}:{},...t.mimeType?{mimeType:String(t.mimeType)}:{},...t.title?{title:String(t.title)}:{}}}:null}if("image"===e){const e=asStr(t.data),n=asStr(t.uri);return e||n?{type:"content",content:{type:"image",...e?{data:e}:{},...n?{uri:n}:{},...t.mimeType?{mimeType:String(t.mimeType)}:{}}}:null}return null}

package/dist/acp-gateway/tool-result-emitter.js

@@ -1 +1 @@
-import{createHash}from"node:crypto";import{presentFileArtifacts}from"./file-artifact-presenter.js";import{buildToolCallUpdatePayload}from"./tool-call-payload-builder.js";import{normalizeToolResultForAcpUpdate}from"./tool-result-payload-strategies.js";export async function emitNormalizedToolResultForTurn(t){const{session:e,envelope:o}=t,l=await normalizeToolResultForAcpUpdate({toolCallId:t.normalizeToolCallId??o.toolCallId,toolName:o.toolName,rawText:o.rawText,rawResult:o.rawResult}),r={emitted:!1,outputText:l.outputText,...l.resourceLinks?.length?{resourceLinks:l.resourceLinks}:{}};if(!l.outputText&&!l.resourceLinks?.length)return r;const a=toolResultDedupKey(o);if(e.emittedToolResultKeys??=new Set,e.emittedToolResultKeys.has(a))return r;const s=buildToolCallUpdatePayload({toolCallId:o.toolCallId,toolName:o.toolName,outputText:l.outputText,rawOutput:o.rawResult,resourceLinks:l.resourceLinks,timestamp:o.timestamp});stampTurnId(s,t.turnId);return!1!==t.sendUpdate(s)?(e.emittedToolResultKeys.add(a),r.emitted=!0,t.writeObs({component:"acp-gateway",domain:"tool_result",name:"tool_result.normalized",severity:"info",payload:{toolCallId:o.toolCallId,toolName:o.toolName,hasText:Boolean(l.outputText),resourceLinkCount:l.resourceLinks?.length??0}}),l.resourceLinks?.length&&await presentFileArtifacts(e,o.toolCallId,l.resourceLinks,{config:t.config,logger:t.logger,writeObs:t.writeObs,getCanvasState:t.getCanvasState,sendUpdate:e=>{stampTurnId(e,t.turnId),t.sendUpdate(e)}}),r):r}function stampTurnId(t,e){e&&void 0===t._turnId&&(t._turnId=e)}function toolResultDedupKey(t){const e=t.rawText??stableStringify(t.rawResult);return`${t.toolCallId}:${createHash("sha1").update(e).digest("hex")}`}function stableStringify(t){if(void 0===t)return"";try{return JSON.stringify(t)}catch{return String(t)}}
+import{presentFileArtifacts}from"./file-artifact-presenter.js";import{buildToolCallUpdatePayload}from"./tool-call-payload-builder.js";import{normalizeToolResultForAcpUpdate}from"./tool-result-payload-strategies.js";export async function emitNormalizedToolResultForTurn(t){const{session:e,envelope:o}=t;return emitToolResultProjectionForTurn({session:e,projection:{...(await normalizeToolResultForAcpUpdate({toolCallId:t.normalizeToolCallId??o.toolCallId,toolName:o.toolName,rawText:o.rawText,rawResult:o.rawResult})).projection,toolName:o.toolName,rawOutput:o.rawResult,...o.timestamp?{timestamp:o.timestamp}:{}},toolCallId:o.toolCallId,config:t.config,logger:t.logger,writeObs:t.writeObs,getCanvasState:t.getCanvasState,turnId:t.turnId,sendUpdate:t.sendUpdate})}export async function emitToolResultProjectionForTurn(t){const{session:e,projection:o,toolCallId:r}=t,l={emitted:!1,outputText:o.outputText,...o.resourceLinks?.length?{resourceLinks:o.resourceLinks}:{}};if(!o.outputText&&!o.resourceLinks?.length)return l;const a=`${r}:${o.projectionKey}`;if(e.emittedToolResultKeys??=new Set,e.emittedToolResultKeys.has(a))return l;const s=buildToolCallUpdatePayload({toolCallId:r,toolName:o.toolName,outputText:o.outputText,rawOutput:o.rawOutput,resourceLinks:o.resourceLinks,timestamp:o.timestamp});stampTurnId(s,t.turnId);return!1!==t.sendUpdate(s)?(e.emittedToolResultKeys.add(a),l.emitted=!0,t.writeObs({component:"acp-gateway",domain:"tool_result",name:"tool_result.normalized",severity:"info",payload:{toolCallId:r,toolName:o.toolName,hasText:Boolean(o.outputText),resourceLinkCount:o.resourceLinks?.length??0,projectionKey:o.projectionKey}}),o.resourceLinks?.length&&await presentFileArtifacts(e,r,o.resourceLinks,{config:t.config,logger:t.logger,writeObs:t.writeObs,getCanvasState:t.getCanvasState,sendUpdate:e=>{stampTurnId(e,t.turnId),t.sendUpdate(e)}}),l):l}function stampTurnId(t,e){e&&void 0===t._turnId&&(t._turnId=e)}

package/dist/acp-gateway/tool-result-payload-strategies.js

@@ -1 +1 @@
-import{readUploadToolResult,writeEnrichmentCache}from"../upload/result-cache.js";import{BEEOS_UPLOAD_TOOL_NAME}from"../upload/tool.js";import{tryExtractLocalFiles}from"../upload/local-file-extractors.js";import{uploadLocalFile,getUploadDeps}from"../upload/upload-file.js";import{asTrimmedNonEmptyString as asStr,isPlainRecord as isRecord}from"../utils/text.js";const strategies=[{name:"beeos_upload_file_cache",canHandle:t=>t.toolName===BEEOS_UPLOAD_TOOL_NAME,resolve:strategyUploadCache},{name:"passthrough_gateway_result",canHandle:()=>!0,resolve:async t=>strategyPassthrough(t)}];export function registerToolResultStrategy(t,e){if(e?.prepend)strategies.unshift(t);else{const e=Math.max(0,strategies.length-1);strategies.splice(e,0,t)}}export function getToolResultStrategies(){return strategies}export async function resolveToolResultBlocks(t){let e=[];for(const o of strategies)if(o.canHandle(t))try{const n=await o.resolve(t);if(n&&n.length>0){e=n;break}}catch{}return enrichWithLocalFileUploads(t,e)}export async function normalizeToolResultForAcpUpdate(t){let e;try{e=await resolveToolResultBlocks(t)}catch{e=t.rawText?[{type:"content",content:{type:"text",text:t.rawText}}]:[]}0===e.length&&t.rawText&&(e=[{type:"content",content:{type:"text",text:t.rawText}}]);const o=[],n=[];for(const t of e){const{content:e}=t;"resource_link"===e.type&&e.uri?n.push({uri:e.uri,name:e.name??"file",...e.mimeType?{mimeType:e.mimeType}:{}}):"text"===e.type&&e.text&&o.push(e.text)}return{blocks:e,outputText:o.join("\n"),rawOutput:t.rawResult,...n.length>0?{resourceLinks:n}:{}}}async function enrichWithLocalFileUploads(t,e){const o=getUploadDeps();if(!o)return e;const n=tryExtractLocalFiles(t);if(0===n.length)return e;const r=[...e],l=[];for(const e of n)try{o.logger?.debug?.(`[enrich] Uploading local file ${e.filePath} for toolCallId=${t.toolCallId}`);const n=await uploadLocalFile(e.filePath,o.gatewayUrl,o.keys,{fileNameOverride:e.suggestedName});o.logger?.info?.(`[enrich] Uploaded: fileId=${n.fileId} toolCallId=${t.toolCallId}`);const s={uri:n.uri,name:n.name,...n.mimeType?{mimeType:n.mimeType}:{}};l.push(s),r.push({type:"content",content:{type:"resource_link",...s}}),r.push({type:"content",content:{type:"text",text:`[Auto-uploaded: ${n.name}. Do NOT call beeos_upload_file for this file.]`}})}catch(t){o.logger?.warn?.(`[enrich] Upload failed for ${e.filePath}: ${t instanceof Error?t.message:String(t)}, skipping`)}return l.length>0&&writeEnrichmentCache(t.toolCallId,l).catch(e=>{o.logger?.warn?.(`[enrich] Cache write failed for toolCallId=${t.toolCallId}: ${e instanceof Error?e.message:String(e)}`)}),r}async function strategyUploadCache(t){if(t.toolName!==BEEOS_UPLOAD_TOOL_NAME)return null;let e;try{e=await readUploadToolResult(t.toolCallId)}catch{return null}if(!e)return null;const o=pickUploadPayload(e);return buildToolResultSessionContentBlocks(t.toolName,o??e)}function strategyPassthrough(t){if(t.rawResult&&isRecord(t.rawResult)){const e=buildToolResultSessionContentBlocks(t.toolName,t.rawResult);if(e.length>0)return e}const e=t.rawText?.trim();if(!e)return[];try{const o=JSON.parse(e);if(isRecord(o)){const e=buildToolResultSessionContentBlocks(t.toolName,o);if(e.length>0)return e}}catch{}return[{type:"content",content:{type:"text",text:e}}]}function isUploadPayload(t){return!!isRecord(t)&&(!0===t.ok||!1===t.ok||"files"in t||Array.isArray(t.content)&&t.content.length>0)}function pickUploadPayload(t){if(isRecord(t)){for(const e of["output","result","details"]){const o=t[e];if(isUploadPayload(o))return o;if(isRecord(o))for(const t of["output","result","details"])if(isUploadPayload(o[t]))return o[t]}return Array.isArray(t.content)&&t.content.length>0||isUploadPayload(t)?t:void 0}}export function buildToolResultSessionContentBlocks(t,e){const o=[];if(!isRecord(e))return"string"==typeof e&&e.trim()&&o.push({type:"content",content:{type:"text",text:e.trim()}}),o;const n=buildFileResourceBlocks(e),r=asStr(e.content);if(r){const e=buildBlocksFromJsonText(t,r);if(e.length>0)return appendFileBlocks(e,n)}const l=e.content??e.result;if(Array.isArray(l)){for(const t of l){const e=toContentBlock(t);e&&o.push(e)}if(o.length>0)return appendFileBlocks(o,n)}const s=e.result;if(s&&"object"==typeof s&&!Array.isArray(s)){const t=s.content;if(Array.isArray(t)){for(const e of t){const t=toContentBlock(e);t&&o.push(t)}if(o.length>0)return appendFileBlocks(o,n)}}const i=asStr(e.output)??asStr(e.text)??asStr(e.result)??r??asStr(e.message)??asStr(e.error);return i&&o.push({type:"content",content:{type:"text",text:i}}),appendFileBlocks(o,n)}function buildBlocksFromJsonText(t,e){const o=e.trim();if(!o||!o.startsWith("{")&&!o.startsWith("["))return[];try{return buildToolResultSessionContentBlocks(t,JSON.parse(o))}catch{return[]}}function buildFileResourceBlocks(t){if(!Array.isArray(t.files))return[];const e=[];for(const o of t.files){if(!isRecord(o))continue;const t=asStr(o.fileId)??asStr(o.file_id),n=t?`beeos-file://${t}`:asStr(o.uri)??asStr(o.downloadUrl)??asStr(o.url);if(!n)continue;const r=asStr(o.name)??asStr(o.fileName)??asStr(o.file_name),l=asStr(o.mimeType)??asStr(o.mime_type);e.push({type:"content",content:{type:"resource_link",uri:n,...r?{name:r}:{},...l?{mimeType:l}:{}}})}return e}function appendFileBlocks(t,e){if(0===e.length)return t;const o=new Set(e.map(t=>t.content.uri).filter(Boolean));return[...t.filter(t=>!("text"===t.content.type&&t.content.text&&o.has(t.content.text))),...e]}function toContentBlock(t){if(!isRecord(t))return"string"==typeof t&&t.trim()?{type:"content",content:{type:"text",text:t.trim()}}:null;const e=asStr(t.type);if(!e)return null;if("text"===e){const e=asStr(t.text);return e?{type:"content",content:{type:"text",text:e}}:null}if("resource_link"===e){const e=asStr(t.uri);return e?{type:"content",content:{type:"resource_link",uri:e,...t.name?{name:String(t.name)}:{},...t.mimeType?{mimeType:String(t.mimeType)}:{},...t.title?{title:String(t.title)}:{}}}:null}if("image"===e){const e=asStr(t.data),o=asStr(t.uri);return e||o?{type:"content",content:{type:"image",...e?{data:e}:{},...o?{uri:o}:{},...t.mimeType?{mimeType:String(t.mimeType)}:{}}}:null}return null}
+import{readUploadToolResult,writeEnrichmentCache}from"../upload/result-cache.js";import{BEEOS_UPLOAD_TOOL_NAME}from"../upload/tool.js";import{tryExtractLocalFiles}from"../upload/local-file-extractors.js";import{uploadLocalFile,getUploadDeps}from"../upload/upload-file.js";import{isPlainRecord as isRecord}from"../utils/text.js";import{buildToolResultSessionContentBlocks}from"./tool-result-blocks.js";import{projectBlocksToToolResultProjection}from"./tool-result-projection.js";export{buildToolResultSessionContentBlocks}from"./tool-result-blocks.js";const strategies=[{name:"beeos_upload_file_cache",canHandle:t=>t.toolName===BEEOS_UPLOAD_TOOL_NAME,resolve:strategyUploadCache},{name:"passthrough_gateway_result",canHandle:()=>!0,resolve:async t=>strategyPassthrough(t)}];export function registerToolResultStrategy(t,e){if(e?.prepend)strategies.unshift(t);else{const e=Math.max(0,strategies.length-1);strategies.splice(e,0,t)}}export function getToolResultStrategies(){return strategies}export async function resolveToolResultBlocks(t){let e=[];for(const o of strategies)if(o.canHandle(t))try{const l=await o.resolve(t);if(l&&l.length>0){e=l;break}}catch{}return enrichWithLocalFileUploads(t,e)}export async function normalizeToolResultForAcpUpdate(t){let e;try{e=await resolveToolResultBlocks(t)}catch{e=t.rawText?[{type:"content",content:{type:"text",text:t.rawText}}]:[]}0===e.length&&t.rawText&&(e=[{type:"content",content:{type:"text",text:t.rawText}}]);const o=projectBlocksToToolResultProjection({toolCallId:t.toolCallId,toolName:t.toolName,blocks:e,rawOutput:t.rawResult});return{blocks:e,outputText:o.outputText,rawOutput:t.rawResult,...o.resourceLinks?.length?{resourceLinks:o.resourceLinks}:{},projection:o}}async function enrichWithLocalFileUploads(t,e){const o=getUploadDeps();if(!o)return e;const l=tryExtractLocalFiles(t);if(0===l.length)return e;const r=[...e],a=[];for(const e of l)try{o.logger?.debug?.(`[enrich] Uploading local file ${e.filePath} for toolCallId=${t.toolCallId}`);const l=await uploadLocalFile(e.filePath,o.gatewayUrl,o.keys,{fileNameOverride:e.suggestedName});o.logger?.info?.(`[enrich] Uploaded: fileId=${l.fileId} toolCallId=${t.toolCallId}`);const s={uri:l.uri,name:l.name,...l.mimeType?{mimeType:l.mimeType}:{}};a.push(s),r.push({type:"content",content:{type:"resource_link",...s}}),r.push({type:"content",content:{type:"text",text:`[Auto-uploaded: ${l.name}. Do NOT call beeos_upload_file for this file.]`}})}catch(t){o.logger?.warn?.(`[enrich] Upload failed for ${e.filePath}: ${t instanceof Error?t.message:String(t)}, skipping`)}return a.length>0&&writeEnrichmentCache(t.toolCallId,a).catch(e=>{o.logger?.warn?.(`[enrich] Cache write failed for toolCallId=${t.toolCallId}: ${e instanceof Error?e.message:String(e)}`)}),r}async function strategyUploadCache(t){if(t.toolName!==BEEOS_UPLOAD_TOOL_NAME)return null;let e;try{e=await readUploadToolResult(t.toolCallId)}catch{return null}if(!e)return null;const o=pickUploadPayload(e);return buildToolResultSessionContentBlocks(t.toolName,o??e)}function strategyPassthrough(t){if(t.rawResult&&isRecord(t.rawResult)){const e=buildToolResultSessionContentBlocks(t.toolName,t.rawResult);if(e.length>0)return e}const e=t.rawText?.trim();if(!e)return[];try{const o=JSON.parse(e);if(isRecord(o)){const e=buildToolResultSessionContentBlocks(t.toolName,o);if(e.length>0)return e}}catch{}return[{type:"content",content:{type:"text",text:e}}]}function isUploadPayload(t){return!!isRecord(t)&&(!0===t.ok||!1===t.ok||"files"in t||Array.isArray(t.content)&&t.content.length>0)}function pickUploadPayload(t){if(isRecord(t)){for(const e of["output","result","details"]){const o=t[e];if(isUploadPayload(o))return o;if(isRecord(o))for(const t of["output","result","details"])if(isUploadPayload(o[t]))return o[t]}return Array.isArray(t.content)&&t.content.length>0||isUploadPayload(t)?t:void 0}}

package/dist/acp-gateway/tool-result-projection.js

@@ -0,0 +1 @@
+import{createHash}from"node:crypto";import{buildToolResultSessionContentBlocks}from"./tool-result-blocks.js";export function projectBlocksToToolResultProjection(t){const e=[],o=[];for(const l of t.blocks){const t=l.content;"resource_link"===t.type&&t.uri?o.push({uri:t.uri,name:t.name??"file",...t.mimeType?{mimeType:t.mimeType}:{}}):"text"===t.type&&t.text&&e.push(t.text)}const l=e.join("\n");return buildProjection({toolCallId:t.toolCallId,toolName:t.toolName,outputText:l,resourceLinks:o,rawOutput:t.rawOutput,timestamp:t.timestamp})}export function projectToolResultPayload(t){let e=[];const o=t.rawResult??t.payload,l=t.payload??t.rawResult;if(void 0!==l&&(e=buildToolResultSessionContentBlocks(t.toolName,l)),0===e.length&&t.rawText?.trim()){const o=t.rawText.trim();try{const l=buildToolResultSessionContentBlocks(t.toolName,JSON.parse(o));e=l.length>0?l:[{type:"content",content:{type:"text",text:o}}]}catch{e=[{type:"content",content:{type:"text",text:o}}]}}return projectBlocksToToolResultProjection({toolCallId:t.toolCallId,toolName:t.toolName,blocks:e,rawOutput:o,timestamp:t.timestamp})}export function projectPersistedToolResultForReplay(t){return projectToolResultPayload(t)}export function toReplayFiles(t){if(t?.length)return t.map(t=>({uri:t.uri,...t.name?{name:t.name}:{},...t.mimeType?{mimeType:t.mimeType}:{}}))}export function toolResultProjectionKey(t){const e=[...t.resourceLinks??[]].map(t=>({uri:t.uri,name:t.name,mimeType:t.mimeType??""})).sort((t,e)=>{const o=`${t.uri}\0${t.name}\0${t.mimeType}`,l=`${e.uri}\0${e.name}\0${e.mimeType}`;return o.localeCompare(l)});return createHash("sha1").update(JSON.stringify({toolCallId:t.toolCallId??"",outputText:t.outputText,resourceLinks:e})).digest("hex")}function buildProjection(t){const e=toolResultProjectionKey({toolCallId:t.toolCallId,outputText:t.outputText,resourceLinks:t.resourceLinks});return{...t.toolCallId?{toolCallId:t.toolCallId}:{},toolName:t.toolName,outputText:t.outputText,...t.resourceLinks.length>0?{resourceLinks:t.resourceLinks}:{},...void 0!==t.rawOutput?{rawOutput:t.rawOutput}:{},...t.timestamp?{timestamp:t.timestamp}:{},projectionKey:e}}

package/dist/acp-gateway/tool-result-projection.test.js

@@ -0,0 +1 @@
+import{describe,expect,it}from"vitest";import{buildToolResultSessionContentBlocks}from"./tool-result-blocks.js";import{projectBlocksToToolResultProjection,projectPersistedToolResultForReplay,projectToolResultPayload,toReplayFiles}from"./tool-result-projection.js";describe("tool result projection",()=>{it("projects structured files into resource links",()=>{const e=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]}});expect(e.outputText).toBe(""),expect(e.resourceLinks).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}])}),it("projects wrapped content JSON files into resource links",()=>{const e=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{content:JSON.stringify({result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]})}});expect(e.outputText).toBe(""),expect(e.resourceLinks).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}])}),it("uses the same projection key for equivalent resource blocks",()=>{const e=buildToolResultSessionContentBlocks("beeos_get_task",{content:[{type:"resource_link",uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]}),o=buildToolResultSessionContentBlocks("beeos_get_task",{content:[{type:"resource_link",uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]}),t=projectBlocksToToolResultProjection({toolCallId:"tc-1",toolName:"beeos_get_task",blocks:e}),l=projectBlocksToToolResultProjection({toolCallId:"tc-1",toolName:"beeos_get_task",blocks:o});expect(t.resourceLinks).toEqual(l.resourceLinks),expect(t.projectionKey).toBe(l.projectionKey)}),it("filters raw URI text when result equals the file URI",()=>{const e=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{result:"beeos-file://file-1",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]}});expect(e.outputText).toBe(""),expect(e.resourceLinks).toHaveLength(1)}),it("keeps ordinary text alongside structured files",()=>{const e=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{result:"Screenshot captured.",files:[{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}]}});expect(e.outputText).toBe("Screenshot captured."),expect(toReplayFiles(e.resourceLinks)).toEqual([{uri:"beeos-file://file-1",name:"screenshot.jpeg",mimeType:"image/jpeg"}])}),it("does not infer text-only BeeOS file URIs as resource links",()=>{const e=projectPersistedToolResultForReplay({toolCallId:"tc-1",toolName:"beeos_get_task",rawText:"beeos-file://file-1"});expect(e.outputText).toBe("beeos-file://file-1"),expect(e.resourceLinks).toBeUndefined()}),it("uses a stable projection key for semantically identical files",()=>{const e=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{files:[{uri:"beeos-file://b",name:"b.jpeg",mimeType:"image/jpeg"},{uri:"beeos-file://a",name:"a.jpeg",mimeType:"image/jpeg"}]}}),o=projectToolResultPayload({toolCallId:"tc-1",toolName:"beeos_get_task",payload:{files:[{mimeType:"image/jpeg",name:"a.jpeg",uri:"beeos-file://a"},{mimeType:"image/jpeg",name:"b.jpeg",uri:"beeos-file://b"}]}});expect(e.projectionKey).toBe(o.projectionKey)})});

package/dist/acp-gateway/tool-result-transcript.js

@@ -0,0 +1 @@
+import{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";import{projectPersistedToolResultForReplay}from"./tool-result-projection.js";export{extractPersistedToolResultEnvelope}from"./persisted-tool-result-envelope.js";export function findLocalHistoryEntryIndexByMessageId(t,o){for(let e=t.length-1;e>=0;e--){const r=t[e];if(!r)continue;const n=r.__openclaw;if(isRecord(n)&&n.id===o)return e;if(r.id===o)return e}return-1}export function findCurrentUserTurnStart(t,o){for(let e=o;e>=0;e--){const o=t[e]?.role;if("user"===o)return e+1}return 0}export function collectToolCallsFromTurnWindow(t){const o=[];for(const e of t){if("assistant"!==e.role)continue;const t=Array.isArray(e.content)?e.content:[];for(const e of t)isRecord(e)&&"toolCall"===asString(e.type)&&o.push({toolCallId:resolveToolCallId(e),toolName:asString(e.name)??asString(e.toolName)??asString(e.tool_name)??"tool"})}return o}export function collectToolResultsFromTurnWindow(t){const{entries:o,currentIndex:e,turnId:r,toolCallTurns:n,timestamp:l}=t;if(e<0)return[];const s=findCurrentUserTurnStart(o,e),i=o.slice(s,e+1),a=[];for(const t of i){const o=t.role;if("toolResult"!==o&&"tool"!==o)continue;const e=extractPersistedToolResultEnvelope(t);if(!e?.toolCallId)continue;const s=n?.get(e.toolCallId);s?.turnId===r&&a.push(projectPersistedToolResultForReplay({toolCallId:e.toolCallId,toolName:e.toolName||s.toolName||"tool",...e.rawText?{rawText:e.rawText}:{},...e.rawResult?{rawResult:e.rawResult}:{},...e.timestamp??l?{timestamp:e.timestamp??l}:{}}))}return a}export function findPersistedToolResultEnvelopeByMessageId(t,o){const e=findLocalHistoryEntryIndexByMessageId(t,o);if(e<0)return;const r=t[e];if(!r)return;const n=r.role;return"toolResult"===n||"tool"===n?extractPersistedToolResultEnvelope(r):void 0}export function resolveToolCallId(t){const o=asString(t.toolCallId)??asString(t.tool_call_id)??asString(t.id);return o||`reconcile_${hashStable(JSON.stringify(t))}`}export function resolveToolArgs(t){const o=[t.arguments,t.args,t.input];for(const t of o){if(isRecord(t))return t;if("string"==typeof t)try{const o=JSON.parse(t);if(isRecord(o))return o}catch{}}return{}}function isRecord(t){return!!t&&"object"==typeof t&&!Array.isArray(t)}function asString(t){if("string"==typeof t&&t.length>0)return t}function hashStable(t){let o=5381;for(let e=0;e<t.length;e++)o=(o<<5)+o+t.charCodeAt(e)|0;return(o>>>0).toString(16)}

package/dist/files/beeos-file-uri.js

@@ -1 +1 @@
-export const BEEOS_FILE_URI_PREFIX="beeos-file://";export const BEEOS_FILE_RESOURCE_ROUTING_RULE="BeeOS file URIs are platform resources, not paths or HTTP URLs. Do not fetch, upload, browser-open, web_fetch, or shell them for display. The runtime presents structured file artifacts. Never write MEDIA:. Fetch only for local byte analysis.";export function isBeeosFileUri(e){return e.startsWith("beeos-file://")}export function parseBeeosFileUri(e){if(!isBeeosFileUri(e))return{};const r=e.slice(13).trim();return r?{fileId:r}:{error:"beeos-file uri requires file_id"}}
+export const BEEOS_FILE_URI_PREFIX="beeos-file://";export const BEEOS_FILE_RESOURCE_ROUTING_RULE="BeeOS file URIs are platform resources, not paths or HTTP URLs. Do not fetch, upload, browser-open, web_fetch, or shell them for display. Never write MEDIA:. Fetch only for local byte analysis.";export function isBeeosFileUri(e){return e.startsWith("beeos-file://")}export function parseBeeosFileUri(e){if(!isBeeosFileUri(e))return{};const r=e.slice(13).trim();return r?{fileId:r}:{error:"beeos-file uri requires file_id"}}

package/dist/media/image-provider.js

@@ -1 +1 @@
-import{AROUTER_PROVIDER_ID,DEFAULT_AROUTER_IMAGE_MODEL,arouterAuthHeaders,arouterFetch,readErrorBody,resolveArouterApiKey,resolveArouterBaseUrl}from"./arouter-config.js";const IMAGE_MODELS=[DEFAULT_AROUTER_IMAGE_MODEL],DEFAULT_IMAGE_TIMEOUT_MS=12e4;function inferImageMimeType(e){return e.length>=8&&137===e[0]&&80===e[1]?"image/png":e.length>=3&&255===e[0]&&216===e[1]&&255===e[2]?"image/jpeg":e.length>=12&&"RIFF"===e.toString("ascii",0,4)&&"WEBP"===e.toString("ascii",8,12)?"image/webp":"image/png"}async function assetFromEntry(e,r,t){let o=null;if(e.b64_json)o=Buffer.from(e.b64_json,"base64");else if(e.url){const r=await arouterFetch(e.url,{deadlineAt:t});if(!r.ok)throw new Error(`ARouter image download failed (${r.status}): ${await readErrorBody(r)}`);o=Buffer.from(await r.arrayBuffer())}if(!o||0===o.length)return null;const a=inferImageMimeType(o);return{buffer:o,mimeType:a,fileName:`image-${r+1}.${"image/jpeg"===a?"jpg":"image/webp"===a?"webp":"png"}`,...e.revised_prompt?{revisedPrompt:e.revised_prompt}:{}}}export function createArouterImageProvider(){return{id:AROUTER_PROVIDER_ID,label:"ARouter Image",defaultModel:DEFAULT_AROUTER_IMAGE_MODEL,defaultTimeoutMs:12e4,models:IMAGE_MODELS,capabilities:{generate:{maxCount:1,supportsSize:!0},edit:{enabled:!1}},isConfigured:()=>Boolean(resolveArouterApiKey()),async generateImage(e){const r=resolveArouterApiKey();if(!r)throw new Error("ARouter image generation: AROUTER_API_KEY is not configured.");const t=resolveArouterBaseUrl(e.cfg),o=e.model?.trim()||DEFAULT_AROUTER_IMAGE_MODEL,a=Date.now()+(e.timeoutMs??12e4),i={model:o,prompt:e.prompt};e.size?.trim()&&(i.size=e.size.trim());const n=e.count&&e.count>1?Math.floor(e.count):1;n>1&&(i.n=n);const s=await arouterFetch(`${t}/images/generations`,{method:"POST",headers:arouterAuthHeaders(r),body:JSON.stringify(i),deadlineAt:a});if(!s.ok)throw new Error(`ARouter image generation failed (${s.status}): ${await readErrorBody(s)}`);const u=await s.json(),g=u.data??[],m=[];for(let e=0;e<g.length;e+=1){const r=await assetFromEntry(g[e],e,a);r&&m.push(r)}if(0===m.length)throw new Error("ARouter image generation response missing image data.");return{images:m,model:o,...u.usage?{metadata:{usage:u.usage}}:{}}}}}
+import{AROUTER_PROVIDER_ID,DEFAULT_AROUTER_IMAGE_MODEL,arouterAuthHeaders,arouterFetch,readErrorBody,resolveArouterApiKey,resolveArouterBaseUrl}from"./arouter-config.js";const IMAGE_MODELS=[DEFAULT_AROUTER_IMAGE_MODEL],DEFAULT_IMAGE_TIMEOUT_MS=12e4,SUPPORTED_ASPECT_RATIOS=["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9"],SUPPORTED_RESOLUTIONS=["1K","2K","4K"];function isRecord(e){return Boolean(e&&"object"==typeof e&&!Array.isArray(e))}function inferImageMimeType(e){return e.length>=8&&137===e[0]&&80===e[1]?"image/png":e.length>=3&&255===e[0]&&216===e[1]&&255===e[2]?"image/jpeg":e.length>=12&&"RIFF"===e.toString("ascii",0,4)&&"WEBP"===e.toString("ascii",8,12)?"image/webp":"image/png"}function toImageDataUrl(e){return`data:${e.mimeType};base64,${e.buffer.toString("base64")}`}function isGeminiImageModel(e){return/gemini/i.test(e)}function buildMessageContent(e){const t=e.inputImages??[];return 0===t.length?e.prompt:[{type:"text",text:e.prompt},...t.map(e=>({type:"image_url",image_url:{url:toImageDataUrl(e)}}))]}function buildImageConfig(e,t){if(!isGeminiImageModel(t))return{};const r={},o=e.aspectRatio?.trim();o&&(r.aspect_ratio=o);const a=e.resolution?.trim();return a&&(r.image_size=a),r}function decodeDataUrl(e){const t=/^data:([^;,]+)?(;base64)?,([\s\S]*)$/u.exec(e);if(!t)return null;const r=t[1]?.trim()||"image/png",o=Boolean(t[2]),a=t[3]??"",n=o?Buffer.from(a,"base64"):Buffer.from(decodeURIComponent(a),"utf8");return 0===n.length?null:{buffer:n,mimeType:r}}function collectImageUrls(e){const t=[];for(const r of e.choices??[]){const e=r?.message;if(!e)continue;for(const r of e.images??[]){const e=(r.image_url??r.imageUrl)?.url;"string"==typeof e&&e.length>0&&t.push(e)}const o=e.content;if("string"==typeof o&&o.length>0){const e=/data:image\/[^;]+;base64,[A-Za-z0-9+/=]+/gu;for(const r of o.matchAll(e))t.push(r[0])}else if(Array.isArray(o))for(const e of o)if(isRecord(e)&&"image_url"===e.type&&isRecord(e.image_url)){const r=e.image_url.url;"string"==typeof r&&r.length>0&&t.push(r)}}return t}async function assetFromUrl(e,t,r){let o,a=null;if(e.startsWith("data:")){const t=decodeDataUrl(e);t&&(a=t.buffer,o=t.mimeType)}else{const t=await arouterFetch(e,{deadlineAt:r});if(!t.ok)throw new Error(`ARouter image download failed (${t.status}): ${await readErrorBody(t)}`);a=Buffer.from(await t.arrayBuffer())}if(!a||0===a.length)return null;const n=o??inferImageMimeType(a);return{buffer:a,mimeType:n,fileName:`image-${t+1}.${"image/jpeg"===n?"jpg":"image/webp"===n?"webp":"png"}`}}export function createArouterImageProvider(){return{id:AROUTER_PROVIDER_ID,label:"ARouter Image",defaultModel:DEFAULT_AROUTER_IMAGE_MODEL,defaultTimeoutMs:12e4,models:IMAGE_MODELS,capabilities:{generate:{maxCount:1,supportsSize:!1,supportsAspectRatio:!0,supportsResolution:!0},edit:{enabled:!1},geometry:{aspectRatios:[...SUPPORTED_ASPECT_RATIOS],resolutions:[...SUPPORTED_RESOLUTIONS]}},isConfigured:()=>Boolean(resolveArouterApiKey()),async generateImage(e){const t=resolveArouterApiKey();if(!t)throw new Error("ARouter image generation: AROUTER_API_KEY is not configured.");const r=resolveArouterBaseUrl(e.cfg),o=e.model?.trim()||DEFAULT_AROUTER_IMAGE_MODEL,a=Date.now()+(e.timeoutMs??12e4),n=buildImageConfig(e,o),i={model:o,messages:[{role:"user",content:buildMessageContent(e)}],modalities:["image","text"]},s=e.count&&e.count>1?Math.floor(e.count):1;s>1&&(i.n=s),Object.keys(n).length>0&&(i.image_config=n);const u=await arouterFetch(`${r}/chat/completions`,{method:"POST",headers:arouterAuthHeaders(t),body:JSON.stringify(i),deadlineAt:a});if(!u.ok)throw new Error(`ARouter image generation failed (${u.status}): ${await readErrorBody(u)}`);const g=await u.json(),l=collectImageUrls(g),m=[];for(let e=0;e<l.length;e+=1){const t=await assetFromUrl(l[e],e,a);t&&m.push(t)}if(0===m.length)throw new Error("ARouter image generation response missing image data.");return{images:m,model:o,...g.usage?{metadata:{usage:g.usage}}:{}}}}}

package/dist/media/image-provider.test.js

@@ -1 +1 @@
-import{afterEach,beforeEach,describe,expect,it,vi}from"vitest";import{createArouterImageProvider}from"./image-provider.js";const PNG_BYTES=Buffer.from([137,80,78,71,13,10,26,10,0]);function jsonResponse(e,t=200){return new Response(JSON.stringify(e),{status:t,headers:{"content-type":"application/json"}})}describe("createArouterImageProvider",()=>{const e=process.env.AROUTER_API_KEY;beforeEach(()=>{process.env.AROUTER_API_KEY="test-key"}),afterEach(()=>{void 0===e?delete process.env.AROUTER_API_KEY:process.env.AROUTER_API_KEY=e,vi.restoreAllMocks()}),it("isConfigured reflects AROUTER_API_KEY presence",()=>{const e=createArouterImageProvider();expect(e.isConfigured?.({})).toBe(!0),delete process.env.AROUTER_API_KEY,expect(e.isConfigured?.({})).toBe(!1)}),it("posts to /images/generations and decodes data[0].b64_json",async()=>{const e=vi.fn(async(e,t)=>{expect(e).toBe("https://api.arouter.ai/v1/images/generations"),expect(t?.method).toBe("POST");const r=new Headers(t?.headers);expect(r.get("authorization")).toBe("Bearer test-key");const o=JSON.parse(String(t?.body));return expect(o).toMatchObject({model:"gemini-2.5-flash-image",prompt:"a cat"}),jsonResponse({created:1,data:[{b64_json:PNG_BYTES.toString("base64")}],usage:{cost:.01}})});vi.stubGlobal("fetch",e);const t=createArouterImageProvider(),r=await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"a cat",cfg:{models:{providers:{arouter:{baseUrl:"https://api.arouter.ai/v1"}}}}});expect(r.images).toHaveLength(1),expect(r.images[0].mimeType).toBe("image/png"),expect(r.images[0].buffer.equals(PNG_BYTES)).toBe(!0),expect(r.model).toBe("gemini-2.5-flash-image"),expect(e).toHaveBeenCalledTimes(1)}),it("throws a descriptive error on non-2xx",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>new Response("bad model",{status:400})));const e=createArouterImageProvider();await expect(e.generateImage({provider:"arouter",model:"x",prompt:"p"})).rejects.toThrow(/ARouter image generation failed \(400\)/)}),it("throws when no image data is returned",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>jsonResponse({data:[]})));const e=createArouterImageProvider();await expect(e.generateImage({provider:"arouter",model:"x",prompt:"p"})).rejects.toThrow(/missing image data/)})});
+import{afterEach,beforeEach,describe,expect,it,vi}from"vitest";import{createArouterImageProvider}from"./image-provider.js";const PNG_BYTES=Buffer.from([137,80,78,71,13,10,26,10,0]),PNG_DATA_URL=`data:image/png;base64,${PNG_BYTES.toString("base64")}`;function jsonResponse(e,t=200){return new Response(JSON.stringify(e),{status:t,headers:{"content-type":"application/json"}})}function chatImageResponse(e){return{choices:[{message:{role:"assistant",images:[{image_url:{url:e}}]}}],usage:{cost:.01}}}describe("createArouterImageProvider",()=>{const e=process.env.AROUTER_API_KEY;beforeEach(()=>{process.env.AROUTER_API_KEY="test-key"}),afterEach(()=>{void 0===e?delete process.env.AROUTER_API_KEY:process.env.AROUTER_API_KEY=e,vi.restoreAllMocks()}),it("isConfigured reflects AROUTER_API_KEY presence",()=>{const e=createArouterImageProvider();expect(e.isConfigured?.({})).toBe(!0),delete process.env.AROUTER_API_KEY,expect(e.isConfigured?.({})).toBe(!1)}),it("declares aspectRatio capability + geometry so normalization keeps aspectRatio",()=>{const e=createArouterImageProvider();expect(e.capabilities.generate.supportsAspectRatio).toBe(!0),expect(e.capabilities.generate.supportsSize).toBe(!1),expect(e.capabilities.geometry?.aspectRatios).toContain("3:4"),expect(e.capabilities.geometry?.aspectRatios).toEqual(expect.arrayContaining(["1:1","3:4","16:9","21:9"]))}),it("posts chat/completions with modalities + image_config.aspect_ratio",async()=>{const e=vi.fn(async(e,t)=>{expect(e).toBe("https://api.arouter.ai/v1/chat/completions"),expect(t?.method).toBe("POST");const a=new Headers(t?.headers);expect(a.get("authorization")).toBe("Bearer test-key");const o=JSON.parse(String(t?.body));return expect(o.model).toBe("gemini-2.5-flash-image"),expect(o.messages).toEqual([{role:"user",content:"a cat"}]),expect(o.modalities).toEqual(["image","text"]),expect(o.image_config).toEqual({aspect_ratio:"3:4"}),jsonResponse(chatImageResponse(PNG_DATA_URL))});vi.stubGlobal("fetch",e);const t=createArouterImageProvider(),a=await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"a cat",aspectRatio:"3:4",cfg:{models:{providers:{arouter:{baseUrl:"https://api.arouter.ai/v1"}}}}});expect(a.images).toHaveLength(1),expect(a.images[0].mimeType).toBe("image/png"),expect(a.images[0].buffer.equals(PNG_BYTES)).toBe(!0),expect(a.images[0].fileName).toBe("image-1.png"),expect(a.model).toBe("gemini-2.5-flash-image"),expect(a.metadata).toEqual({usage:{cost:.01}}),expect(e).toHaveBeenCalledTimes(1)}),it("forwards resolution as image_config.image_size",async()=>{const e=vi.fn(async(e,t)=>{const a=JSON.parse(String(t?.body));return expect(a.image_config).toEqual({aspect_ratio:"3:4",image_size:"2K"}),jsonResponse(chatImageResponse(PNG_DATA_URL))});vi.stubGlobal("fetch",e);const t=createArouterImageProvider();await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"a cat",aspectRatio:"3:4",resolution:"2K"}),expect(e).toHaveBeenCalledTimes(1)}),it("omits image_config when neither aspectRatio nor resolution is set",async()=>{const e=vi.fn(async(e,t)=>{const a=JSON.parse(String(t?.body));return expect("image_config"in a).toBe(!1),jsonResponse(chatImageResponse(PNG_DATA_URL))});vi.stubGlobal("fetch",e);const t=createArouterImageProvider();await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"a cat"}),expect(e).toHaveBeenCalledTimes(1)}),it("builds multimodal content when input images are provided",async()=>{const e=vi.fn(async(e,t)=>{const a=JSON.parse(String(t?.body));return expect(a.messages[0].content).toEqual([{type:"text",text:"make it blue"},{type:"image_url",image_url:{url:`data:image/png;base64,${PNG_BYTES.toString("base64")}`}}]),jsonResponse(chatImageResponse(PNG_DATA_URL))});vi.stubGlobal("fetch",e);const t=createArouterImageProvider();await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"make it blue",inputImages:[{buffer:PNG_BYTES,mimeType:"image/png"}]}),expect(e).toHaveBeenCalledTimes(1)}),it("parses images from message.images[].image_url.url data URL into a Buffer",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>jsonResponse(chatImageResponse(PNG_DATA_URL))));const e=createArouterImageProvider(),t=await e.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"p"});expect(t.images).toHaveLength(1),expect(t.images[0].buffer.equals(PNG_BYTES)).toBe(!0)}),it("falls back to data URLs embedded in message.content",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>jsonResponse({choices:[{message:{role:"assistant",content:`here you go ${PNG_DATA_URL}`}}]})));const e=createArouterImageProvider(),t=await e.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"p"});expect(t.images).toHaveLength(1),expect(t.images[0].buffer.equals(PNG_BYTES)).toBe(!0)}),it("downloads http(s) image URLs via arouterFetch as a fallback",async()=>{const e=vi.fn(async e=>"https://cdn.arouter.ai/img/1.png"===e?new Response(PNG_BYTES,{status:200}):jsonResponse(chatImageResponse("https://cdn.arouter.ai/img/1.png")));vi.stubGlobal("fetch",e);const t=createArouterImageProvider(),a=await t.generateImage({provider:"arouter",model:"gemini-2.5-flash-image",prompt:"p"});expect(a.images).toHaveLength(1),expect(a.images[0].buffer.equals(PNG_BYTES)).toBe(!0),expect(e).toHaveBeenCalledTimes(2)}),it("throws a descriptive error on non-2xx",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>new Response("bad model",{status:400})));const e=createArouterImageProvider();await expect(e.generateImage({provider:"arouter",model:"x",prompt:"p"})).rejects.toThrow(/ARouter image generation failed \(400\)/)}),it("throws when no image data is returned",async()=>{vi.stubGlobal("fetch",vi.fn(async()=>jsonResponse({choices:[{message:{role:"assistant",content:""}}]})));const e=createArouterImageProvider();await expect(e.generateImage({provider:"arouter",model:"x",prompt:"p"})).rejects.toThrow(/missing image data/)})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beeos-claw",
-  "version": "0.5.36",
+  "version": "0.5.38",
   "description": "OpenClaw plugin that bridges the BeeOS platform with the local OpenClaw Gateway, providing file transfer, ACP bridge, and observability.",
   "license": "MIT",
   "author": "BeeOS <dev@beeos.ai>",