@robota-sdk/agent-transport 3.0.0-beta.82 → 3.0.0-beta.84

package/dist/node/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e,t,o){if(o.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(o.filter)});return}if(o.type===`get-background-task`){n(e,t,o);return}if(o.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(o.type===`get-background-job-group`){i(e,t,o);return}if(o.type===`wait-background-job-group`){a(e,t,o);return}r(e,t,o)}function t(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){s(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){s(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}o(e,t,n)}function n(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function r(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function i(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function a(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function o(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}s(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function s(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function c(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const l=e=>typeof e==`string`,u=e=>typeof e==`string`&&e.length>0,d=e=>typeof e==`boolean`,f=e=>typeof e==`number`&&Number.isFinite(e),p=e=>t=>t===void 0||e(t),m=e=>Array.isArray(e)&&e.every(c),h=e=>e===null||c(e),g=e=>t=>typeof t==`string`&&e.includes(t),_=[`agent`,`process`,`scheduled`],v=[`foreground`,`background`],y=[`queued`,`running`,`waiting_permission`,`sleeping`,`paused`,`completed`,`failed`,`cancelled`],b=[`cancel`,`close`,`send`],x={submit:{prompt:u},command:{name:u,args:p(l)},abort:{},"cancel-queue":{},"get-messages":{},"get-context":{},"get-usage-report":{},"get-personal-usage-report":{requestId:u,period:g([`7d`,`30d`]),timezone:u},"get-stored-session-usage-report":{requestId:u,sessionId:u},"get-executing":{},"get-pending":{},"get-execution-workspace":{},"get-background-tasks":{filter:p(e=>c(e)&&p(g(_))(e.kind)&&p(g(y))(e.status)&&p(g(v))(e.mode)&&p(d)(e.includeClosed))},"get-background-task":{taskId:u},"get-background-job-groups":{},"get-background-job-group":{groupId:u},"wait-background-job-group":{groupId:u},"cancel-background-task":{taskId:u,reason:p(l)},"close-background-task":{taskId:u},"send-background-task":{taskId:u,input:e=>c(e)&&p(l)(e.prompt)&&p(l)(e.stdin)},"read-background-task-log":{taskId:u,cursor:p(e=>c(e)&&f(e.offset))},"permission-response":{id:u,result:e=>d(e)||e===`allow-session`||e===`allow-project`},"ask-response":{id:u,response:e=>c(e)&&(e.type===`answer`&&Array.isArray(e.values)&&e.values.every(l)&&p(l)(e.text)||e.type===`cancelled`&&e.values===void 0&&e.text===void 0)},resume:{lastSeq:f},ack:{seq:f}},S={driverId:p(l)},C={text_delta:{delta:l,...S},user_message:{content:l,...S},tool_start:{state:c,...S},tool_end:{state:c,...S},thinking:{isThinking:d,...S},complete:{result:c,...S},interrupted:{result:c,...S},error:{message:l,...S},command_result:{name:l,message:l,success:d},messages:{messages:m},context:{state:c},usage_report:{report:c},personal_usage_report:{requestId:u,report:c},personal_usage_report_error:{requestId:u,code:g([`not_available`,`report_failed`]),message:l},stored_session_usage_report:{requestId:u,sessionId:u,report:c},stored_session_usage_report_error:{requestId:u,sessionId:u,code:g([`not_available`,`report_failed`]),message:l},executing:{executing:d},pending:{pending:e=>e===null||l(e)},execution_workspace_event:{snapshot:c},background_task_event:{event:c},background_job_group_event:{event:c},plan_event:{event:c},context_file_refreshed:{event:c},branch_event:{event:c},background_tasks:{tasks:m},background_task:{taskId:l,task:h},background_job_groups:{groups:m},background_job_group:{groupId:l,group:h},background_task_log:{taskId:l,page:c},permission_request:{event:c},ask_request:{event:c},prompt_resolved:{event:c},ui_intent:{event:c},session_renamed:{event:c},history_cleared:{},background_task_control_result:{action:g(b),taskId:l,success:d,message:p(l)},protocol_error:{message:l},resume_gap:{}};function w(e,t,n){if(!c(e))return{ok:!1,reason:`message must be a JSON object`};let r=e.type;if(!l(r))return{ok:!1,reason:`message type must be a string`};let i=Object.prototype.hasOwnProperty.call(t,r)?t[r]:void 0;if(i===void 0)return{ok:!1,reason:`Unknown message type: ${r}`};for(let[t,r]of Object.entries(i))if(!r(e[t]))return{ok:!1,reason:n(t)};return{ok:!0,message:e}}function T(e){return w(e,x,e=>e===`prompt`?`prompt must be a non-empty string`:`${e} has an invalid shape`)}function E(e){return w(e,C,e=>`${e} has an invalid shape`)}function D(e,t){if(e.length>4194304)return{ok:!1,reason:`Frame too large`};let n;try{n=JSON.parse(e)}catch{return{ok:!1,reason:`Invalid JSON`}}return t(n)}function ee(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function O(e){return typeof e==`string`&&e.length>0?e:void 0}function te(e){if(!(new TextEncoder().encode(e).byteLength>4194304))try{let t=JSON.parse(e);if(!ee(t))return;let n=O(t.requestId);if(!n)return;if(t.type===`get-personal-usage-report`)return{type:`personal`,requestId:n};let r=O(t.sessionId);return t.type===`get-stored-session-usage-report`&&r?{type:`stored-session`,requestId:n,sessionId:r}:void 0}catch{return}}function ne(e,t,n,r){return n.type===`get-personal-usage-report`?(ae(t,n,r.personalUsageReporter),!0):n.type===`get-stored-session-usage-report`?(ie(t,n,r.storedSessionUsageReporter),!0):n.type===`get-usage-report`?(re(e,t,r.usageReporter),!0):!1}function re(e,t,n){if(!n){t({type:`protocol_error`,message:`Per-session usage reporting is not available on this host.`});return}try{Promise.resolve(n(e)).then(e=>t({type:`usage_report`,report:e}),e=>t({type:`protocol_error`,message:j(e)}))}catch(e){t({type:`protocol_error`,message:j(e instanceof Error?e:String(e))})}}function ie(e,t,n){if(!n){k(e,t,`not_available`,`Stored-session usage reporting is not available on this host.`);return}try{Promise.resolve(n(t.sessionId)).then(n=>e({type:`stored_session_usage_report`,requestId:t.requestId,sessionId:t.sessionId,report:n}),n=>k(e,t,`report_failed`,j(n)))}catch(n){k(e,t,`report_failed`,j(n instanceof Error?n:String(n)))}}function k(e,t,n,r){e({type:`stored_session_usage_report_error`,requestId:t.requestId,sessionId:t.sessionId,code:n,message:r})}function ae(e,t,n){if(!n){A(e,t.requestId,`not_available`,`Personal usage reporting is not available on this host.`);return}try{Promise.resolve(n({period:t.period,timezone:t.timezone})).then(n=>e({type:`personal_usage_report`,requestId:t.requestId,report:n}),n=>A(e,t.requestId,`report_failed`,j(n)))}catch(n){A(e,t.requestId,`report_failed`,j(n instanceof Error?n:String(n)))}}function A(e,t,n,r){e({type:`personal_usage_report_error`,requestId:t,code:n,message:r})}function j(e){return e instanceof Error?e.message:String(e)}function M(e,t){let n=D(e,T);if(n.ok)return n.message;let r=te(e);return r?.type===`personal`?(t({type:`personal_usage_report_error`,requestId:r.requestId,code:`report_failed`,message:`Invalid personal usage report request.`}),null):r?.type===`stored-session`?(t({type:`stored_session_usage_report_error`,requestId:r.requestId,sessionId:r.sessionId,code:`report_failed`,message:`Invalid stored-session usage report request.`}),null):(t({type:`protocol_error`,message:n.reason}),null)}const oe={text_delta:`forwarded`,tool_start:`forwarded`,tool_end:`forwarded`,thinking:`forwarded`,complete:`forwarded`,error:`forwarded`,context_update:`non-surface`,compact:`non-surface`,interrupted:`forwarded`,skill_activation:`non-surface`,background_task_event:`forwarded`,background_job_group_event:`forwarded`,execution_workspace_event:`forwarded`,user_message:`forwarded`,turn_source:`non-surface`,context_file_refreshed:`forwarded`,memory_event:`non-surface`,goal_event:`non-surface`,plan_event:`forwarded`,branch_event:`forwarded`,permission_request:`forwarded`,ask_request:`forwarded`,prompt_resolved:`forwarded`,ui_intent:`requester-routed`,session_renamed:`forwarded`,history_cleared:`forwarded`};function N(e,t,n={}){let r=()=>{let t=e.getActiveDriverId();return t?{driverId:t}:{}},i=e=>t({type:`user_message`,content:e,...r()}),a=e=>t({type:`text_delta`,delta:e,...r()}),o=e=>t({type:`tool_start`,state:e,...r()}),s=e=>t({type:`tool_end`,state:e,...r()}),c=e=>t({type:`thinking`,isThinking:e,...r()}),l=e=>t({type:`complete`,result:e,...r()}),u=e=>t({type:`interrupted`,result:e,...r()}),d=e=>t({type:`error`,message:e.message,...r()}),f=e=>t({type:`background_task_event`,event:e}),p=e=>t({type:`background_job_group_event`,event:e}),m=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot}),h=e=>t({type:`plan_event`,event:e}),g=e=>t({type:`context_file_refreshed`,event:e}),_=e=>t({type:`branch_event`,event:e}),v=e=>t({type:`permission_request`,event:e}),y=e=>t({type:`ask_request`,event:e}),b=e=>t({type:`prompt_resolved`,event:e}),x=e=>{(e.requesterDriverId===void 0||e.requesterDriverId===n.getSurfaceDriverId?.())&&t({type:`ui_intent`,event:e})},S=e=>t({type:`session_renamed`,event:e}),C=()=>t({type:`history_cleared`});return e.on(`user_message`,i),e.on(`text_delta`,a),e.on(`tool_start`,o),e.on(`tool_end`,s),e.on(`thinking`,c),e.on(`complete`,l),e.on(`interrupted`,u),e.on(`error`,d),e.on(`background_task_event`,f),e.on(`background_job_group_event`,p),e.on(`execution_workspace_event`,m),e.on(`plan_event`,h),e.on(`context_file_refreshed`,g),e.on(`branch_event`,_),e.on(`permission_request`,v),e.on(`ask_request`,y),e.on(`prompt_resolved`,b),e.on(`ui_intent`,x),e.on(`session_renamed`,S),e.on(`history_cleared`,C),()=>{e.off(`user_message`,i),e.off(`text_delta`,a),e.off(`tool_start`,o),e.off(`tool_end`,s),e.off(`thinking`,c),e.off(`complete`,l),e.off(`interrupted`,u),e.off(`error`,d),e.off(`background_task_event`,f),e.off(`background_job_group_event`,p),e.off(`execution_workspace_event`,m),e.off(`plan_event`,h),e.off(`context_file_refreshed`,g),e.off(`branch_event`,_),e.off(`permission_request`,v),e.off(`ask_request`,y),e.off(`prompt_resolved`,b),e.off(`ui_intent`,x),e.off(`session_renamed`,S),e.off(`history_cleared`,C)}}function se(e){return e.type===`get-messages`||e.type===`get-context`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`}function ce(e,t,n){n.type===`get-messages`?t({type:`messages`,messages:e.getMessages()}):n.type===`get-context`?t({type:`context`,state:e.getContextState()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):t({type:`pending`,pending:e.getPendingPrompt()})}function le(e){let t=N(e.session,e.deliver,{getSurfaceDriverId:()=>e.driverId});return{onMessage:ue(e.session,e.deliver,e.driverId,{personalUsageReporter:e.personalUsageReporter,usageReporter:e.usageReporter,storedSessionUsageReporter:e.storedSessionUsageReporter},e.surface),cleanup:t}}function ue(e,t,n,r=P,i){return a=>{let o=M(a,t);o&&F(e,t,o,n,r,i)}}const P={personalUsageReporter:void 0,usageReporter:void 0,storedSessionUsageReporter:void 0};function F(n,r,i,a,o=P,s){if(ne(n,r,i,o))return;if(de(i)){R(n,r,i,a,s);return}if(se(i)){ce(n,r,i);return}if(fe(i)){e(n,r,i);return}if(pe(i)){t(n,r,i);return}if(I(i)){L(n,i,a);return}let c=i.type;r({type:`protocol_error`,message:`Unknown message type: ${c}`})}function de(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function fe(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function pe(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function I(e){return e.type===`permission-response`||e.type===`ask-response`}function L(e,t,n){t.type===`permission-response`?e.resolvePermission(t.id,t.result,n):e.resolveAsk(t.id,t.response,n)}function R(e,t,n,r,i){if(n.type===`submit`){if(typeof n.prompt!=`string`||n.prompt.length===0){t({type:`protocol_error`,message:`prompt must be a non-empty string`});return}let a={...r?{driverId:r}:{},...i?{surface:i}:{}};e.submit(n.prompt,void 0,void 0,Object.keys(a).length>0?a:void 0).catch(e=>{t({type:`protocol_error`,message:e.message})})}else if(n.type===`command`){if(!n.name){t({type:`protocol_error`,message:`name is required`});return}e.executeCommand(n.name,n.args??``,`remote`,r).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data})},e=>{t({type:`protocol_error`,message:e.message})})}else n.type===`abort`?e.abort():e.cancelQueue()}const z=8*1048576;function B(e,t=z){return e!==void 0&&e>t}const V=120*1e3;function H(e=V,t=Date.now){let n;return{maxPendingMs:e,observe(r){if(r===void 0)return;if(r===0){n=void 0;return}let i=t();n??=i;let a=i-n;return a>e?a:void 0}}}function U(e,t,n,r=z,i=H()){let a=!1,o=t=>{if(a)return;let o=n?.();if(B(o,r)){a=!0,s(Error(`outbound backpressure budget exceeded: ${o} byte(s) pending, limit ${r}. The peer has accepted frames it is not reading.`),t.type);return}let c=i.observe(o);if(c!==void 0){a=!0,s(Error(`outbound drain budget exceeded: ${o} byte(s) pending for ${c} ms, limit ${i.maxPendingMs} ms. The peer is reading too slowly to ever drain what it accepted.`),t.type);return}try{e(t)}catch(e){a=!0,s(e instanceof Error?e:Error(String(e)),t.type)}};function s(e,n){try{t(e,n)}catch{}}return Object.assign(o,{pendingBytes:()=>n?.()})}var W=class{frames=[];sizes=[];nextSeq=1;bytes=0;maxFrames;maxBytes;sizeOf;constructor(e={}){this.maxFrames=e.maxFrames??512,this.maxBytes=e.maxBytes??4194304,this.sizeOf=e.sizeOf??(e=>JSON.stringify(e).length)}append(e){let t=this.nextSeq;this.nextSeq+=1;let n=this.sizeOf(e);return this.frames.push({seq:t,message:e}),this.sizes.push(n),this.bytes+=n,this.evict(),t}ackThrough(e){let t=0;for(;t<this.frames.length&&this.frames[t].seq<=e;)t+=1;this.removeOldest(t)}tailAfter(e){return this.frames.length===0?e>=this.nextSeq-1?{kind:`tail`,frames:[]}:{kind:`overrun`}:e<this.frames[0].seq-1?{kind:`overrun`}:{kind:`tail`,frames:this.frames.filter(t=>t.seq>e)}}get lastSeq(){return this.nextSeq-1}get size(){return this.frames.length}evict(){let e=0,t=this.bytes;for(;this.frames.length-e>this.maxFrames||t>this.maxBytes&&this.frames.length-e>1;)t-=this.sizes[e],e+=1;this.removeOldest(e)}removeOldest(e){if(!(e<=0)){for(let t=0;t<e;t+=1)this.bytes-=this.sizes[t]??0;this.frames.splice(0,e),this.sizes.splice(0,e),this.frames.length===0&&(this.bytes=0)}}};const G=new TextEncoder,K=new TextDecoder,q=G.encode(`RBF`),J=4294967295;function Y(e,t){let n=G.encode(e);if(n.byteLength===0||n.byteLength>255)throw Error(`channel name must be 1..255 UTF-8 bytes (got ${n.byteLength})`);if(!Number.isInteger(t)||t<0||t>J)throw Error(`seq must be an integer in 0..${J} (got ${t})`);return n}function X(e,t,n,r){e.set(q,0),e[3]=1,e[4]=t,e[5]=n.byteLength,e.set(n,6);let i=6+n.byteLength;return new DataView(e.buffer,e.byteOffset,e.byteLength).setUint32(i,r,!1),i+4}function me(e){let t=Y(e.channel,e.seq),n=new Uint8Array(6+t.byteLength+4+e.payload.byteLength),r=X(n,1,t,e.seq);return n.set(e.payload,r),n}function he(e){let t=Y(e.channel,e.seq),n=G.encode(JSON.stringify({event:e.event,payload:e.payload})),r=new Uint8Array(6+t.byteLength+4+n.byteLength),i=X(r,2,t,e.seq);return r.set(n,i),r}function Z(e){return e.byteLength<q.length?!1:q.every((t,n)=>e[n]===t)}function Q(e){let t=K.decode(e),n;try{n=JSON.parse(t)}catch{return{ok:!1,error:`channel frame: malformed JSON body`}}if(typeof n!=`object`||!n||Array.isArray(n))return{ok:!1,error:`channel frame: event body must be a JSON object`};let{event:r,payload:i}=n;return typeof r!=`string`||r.length===0?{ok:!1,error:"channel frame: event body is missing a non-empty `event` name"}:{ok:!0,event:r,payload:i??null}}function ge(e){if(!Z(e))return{ok:!1,error:`channel frame: bad magic (not a channel frame)`};if(e.byteLength<6)return{ok:!1,error:`channel frame: truncated header`};if(e[3]!==1)return{ok:!1,error:`channel frame: unsupported version ${String(e[3])}`};let t=e[4],n=e[5]??0;if(n===0)return{ok:!1,error:`channel frame: empty channel name`};let r=6+n,i=r+4;if(e.byteLength<i)return{ok:!1,error:`channel frame: truncated (header longer than the frame)`};let a=K.decode(e.subarray(6,r)),o=new DataView(e.buffer,e.byteOffset,e.byteLength).getUint32(r,!1),s=e.subarray(i);if(t===1)return{ok:!0,frame:{kind:`binary`,channel:a,seq:o,payload:Uint8Array.from(s)}};if(t===2){let e=Q(s);return e.ok?{ok:!0,frame:{kind:`event`,channel:a,seq:o,event:e.event,payload:e.payload}}:{ok:!1,error:e.error}}return{ok:!1,error:`channel frame: unknown kind ${String(t)}`}}var _e=class{session;buffer;driverId;reporters;surface;unsubscribe;onDeliveryError;outbound;emitBoundary;disposed=!1;holding=!1;constructor(e){this.session=e.session,this.buffer=new W(e.buffer),this.driverId=e.driverId,this.surface=e.surface,this.reporters={personalUsageReporter:e.personalUsageReporter,usageReporter:e.usageReporter,storedSessionUsageReporter:e.storedSessionUsageReporter},this.emitBoundary=U(e=>this.emit(e),(e,t)=>this.reportDeliveryError(e,t)),this.unsubscribe=N(this.session,this.emitBoundary,{getSurfaceDriverId:()=>this.driverId})}attach(e,t){this.disposed||(this.onDeliveryError=t.onDeliveryError,this.outbound=U(t=>e(JSON.stringify(t)),(e,t)=>this.reportDeliveryError(e,t),t.pendingBytes),this.holding=t.awaitResume===!0)}detach(){this.outbound=void 0,this.onDeliveryError=void 0}setDriverId(e){this.driverId=e}onClientMessage(e){if(this.disposed)return;let t=M(e,this.emitBoundary);if(t){if(t.type===`resume`){this.replay(t.lastSeq);return}if(t.type===`ack`){this.buffer.ackThrough(t.seq);return}F(this.session,this.emitBoundary,t,this.driverId,this.reporters,this.surface)}}dispose(){this.disposed||(this.disposed=!0,this.detach(),this.unsubscribe())}get lastSeq(){return this.buffer.lastSeq}emit(e){if(this.disposed)return;let t=this.buffer.append(e);this.holding||this.deliverFrame({...e,seq:t})}replay(e){let t=this.buffer.tailAfter(e);if(t.kind===`overrun`){this.deliverFrame({type:`resume_gap`}),this.holding=!1;return}for(let e of t.frames)this.deliverFrame({...e.message,seq:e.seq});this.holding=!1}deliverFrame(e){this.outbound?.(e)}reportDeliveryError(e,t){let n=this.onDeliveryError;this.detach();try{n?.(e,t)}catch{}}};function ve(){return{origins:new Map}}function ye(e,t,n){let r=t.origin.sessionId,i=e.origins.get(r);i===void 0&&(i={highestSequence:0,delivered:new Set,issued:new Map},e.origins.set(r,i));let a=i.issued.get(t.id);if(a!==void 0)return{ack:{...a,state:`duplicate`},deliver:!1};if(n!==void 0){let e={id:t.id,sequence:t.sequence,state:n.state,reason:n.reason};return i.issued.set(t.id,e),{ack:e,deliver:!1}}if(i.delivered.has(t.sequence)){let e={id:t.id,sequence:t.sequence,state:`refused`,reason:`sequence ${t.sequence} was already delivered by this origin under a different message id. A retry must repeat its id; a new id on a delivered sequence cannot be ordered against what the receiver already has.`};return i.issued.set(t.id,e),{ack:e,deliver:!1}}let o=i.highestSequence+1,s=t.sequence>o?o:void 0,c={id:t.id,sequence:t.sequence,state:`delivered`};return i.issued.set(t.id,c),i.delivered.add(t.sequence),i.highestSequence=Math.max(i.highestSequence,t.sequence),s===void 0?{ack:c,deliver:!0}:{ack:c,deliver:!0,gapBefore:s}}function be(e,t,n){let r=e.origins.get(t),i=r?.issued.get(n);if(r===void 0||i===void 0||i.state!==`delivered`)return;let a={...i,state:`acknowledged`};return r.issued.set(n,a),a}function xe(e,t){e.origins.delete(t)}const $=16*1024;function Se(e,t,n=$){if(!Number.isInteger(n)||n<1)throw Error(`handoff chunking: maxChunkBytes must be a positive integer, got ${n}. A zero or negative budget produces an infinite sequence of empty chunks, which presents as a hang rather than as the configuration error it is.`);let r=Buffer.from(t,`utf8`),i=Math.max(1,Math.ceil(r.byteLength/n)),a=[];for(let t=0;t<i;t+=1){let o=r.subarray(t*n,(t+1)*n);a.push({handoffId:e,index:t,total:i,data:o.toString(`base64`)})}return a}var Ce=class{handoffId;chunks=new Map;declaredTotal;constructor(e){this.handoffId=e}get received(){return this.chunks.size}get expected(){return this.declaredTotal}accept(e){let t=e=>({outcome:`refused`,rejection:e,received:this.chunks.size,...this.declaredTotal===void 0?{}:{expected:this.declaredTotal}});if(e.handoffId!==this.handoffId)return t(`wrong-handoff`);if(!Number.isInteger(e.total)||e.total<1||this.declaredTotal!==void 0&&e.total!==this.declaredTotal)return t(`inconsistent-total`);if(!Number.isInteger(e.index)||e.index<0||e.index>=e.total)return t(`out-of-range`);let n=Buffer.from(e.data,`base64`);if(n.toString(`base64`)!==e.data)return t(`undecodable`);this.declaredTotal=e.total;let r=this.chunks.get(e.index);return r===void 0?(this.chunks.set(e.index,n),this.chunks.size<e.total?{outcome:`accepted`,received:this.chunks.size,expected:e.total}:{outcome:`complete`,serialized:this.reassemble(e.total),received:this.chunks.size,expected:e.total}):r.equals(n)?{outcome:`duplicate`,received:this.chunks.size,expected:e.total}:t(`inconsistent-total`)}missing(){if(this.declaredTotal===void 0)return[];let e=[];for(let t=0;t<this.declaredTotal;t+=1)this.chunks.has(t)||e.push(t);return e}discard(){this.chunks.clear(),this.declaredTotal=void 0}reassemble(e){let t=[];for(let n=0;n<e;n+=1){let r=this.chunks.get(n);if(r===void 0)throw Error(`handoff chunking: chunk ${n} of ${e} is missing at reassembly.`);t.push(r)}return Buffer.concat(t).toString(`utf8`)}};function we(e,t=$){return Math.max(1,Math.ceil(e.byteLength/t))}exports.CHANNEL_FRAME_MAGIC=q,exports.CHANNEL_FRAME_VERSION=1,exports.DEFAULT_MAX_CHUNK_BYTES=$,exports.DEFAULT_MAX_PENDING_BYTES=z,exports.DEFAULT_MAX_PENDING_MS=V,exports.HandoffChunkAssembler=Ce,exports.MAX_INBOUND_FRAME_BYTES=4194304,exports.PROTOCOL_SESSION_EVENT_CLASSIFICATION=oe,exports.ResumeBuffer=W,exports.SessionResumeBridge=_e,exports.acknowledgePeerMessage=be,exports.admitPeerMessage=ye,exports.chunkCountFor=we,exports.chunkHandoffPayload=Se,exports.createOutboundDelivery=U,exports.createPeerMessageLedger=ve,exports.createPendingStallClock=H,exports.createSessionMessageHandler=le,exports.decodeChannelFrame=ge,exports.decodeClientMessage=T,exports.decodeFrame=D,exports.decodeServerMessage=E,exports.encodeBinaryFrame=me,exports.encodeChannelEventFrame=he,exports.forgetPeerOrigin=xe,exports.isChannelFrame=Z,exports.isOverPendingBudget=B;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@robota-sdk/agent-interface-session"),t=require("@robota-sdk/agent-core");function n(e,t,n){if(n.type===`get-background-tasks`){t({type:`background_tasks`,tasks:e.listBackgroundTasks(n.filter)});return}if(n.type===`get-background-task`){i(e,t,n);return}if(n.type===`get-background-job-groups`){t({type:`background_job_groups`,groups:e.listBackgroundJobGroups()});return}if(n.type===`get-background-job-group`){o(e,t,n);return}if(n.type===`wait-background-job-group`){s(e,t,n);return}a(e,t,n)}function r(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}if(n.type===`cancel-background-task`){l(t,`cancel`,n.taskId,e.cancelBackgroundTask(n.taskId,n.reason));return}if(n.type===`close-background-task`){l(t,`close`,n.taskId,e.closeBackgroundTask(n.taskId));return}c(e,t,n)}function i(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}t({type:`background_task`,taskId:n.taskId,task:e.getBackgroundTask(n.taskId)??null})}function a(e,t,n){if(!n.taskId){t({type:`protocol_error`,message:`taskId is required`});return}e.readBackgroundTaskLog(n.taskId,n.cursor).then(e=>t({type:`background_task_log`,taskId:n.taskId,page:e}),e=>t({type:`protocol_error`,message:e.message}))}function o(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}t({type:`background_job_group`,groupId:n.groupId,group:e.getBackgroundJobGroup(n.groupId)??null})}function s(e,t,n){if(!n.groupId){t({type:`protocol_error`,message:`groupId is required`});return}e.waitBackgroundJobGroup(n.groupId).then(e=>t({type:`background_job_group`,groupId:n.groupId,group:e}),e=>t({type:`protocol_error`,message:e.message}))}function c(e,t,n){if(!n.input){t({type:`protocol_error`,message:`input is required`});return}l(t,`send`,n.taskId,e.sendBackgroundTask(n.taskId,n.input))}function l(e,t,n,r){r.then(()=>e({type:`background_task_control_result`,action:t,taskId:n,success:!0}),r=>e({type:`background_task_control_result`,action:t,taskId:n,success:!1,message:r.message}))}function u(e){return e.type===`stop-waiting-loop`}function d(e,t,n){let{requestId:r}=n;e.stopWaitingSelfPacedLoop().then(e=>t({type:`waiting_loop_stop`,requestId:r,outcome:e}),e=>t({type:`waiting_loop_stop`,requestId:r,outcome:{kind:`failed`,message:f(e)}}))}function f(e){return e instanceof Error?e.message:String(e)}function p(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const m=e=>typeof e==`string`,h=e=>typeof e==`string`&&e.length>0,g=e=>typeof e==`boolean`,_=e=>typeof e==`number`&&Number.isFinite(e),v=e=>Number.isSafeInteger(e)&&e>=0,y=e=>t=>t===void 0||e(t),b=e=>Array.isArray(e)&&e.every(p),x=e=>e===null||p(e),S=e=>t=>typeof t==`string`&&e.includes(t),C={user:!0,"agent-wakeup":!0,peer:!0,external:!0},w=e=>p(e)&&m(e.id)&&m(e.timestamp)&&m(e.category)&&m(e.type),T=e=>Array.isArray(e)&&e.every(w),E=e=>p(e)&&m(e.name)&&m(e.description)&&m(e.definedIn),D=e=>Array.isArray(e)&&e.every(E),O=[`agent`,`process`,`scheduled`],k=[`foreground`,`background`],A=[`queued`,`running`,`waiting_permission`,`sleeping`,`paused`,`completed`,`failed`,`cancelled`],ee=[`cancel`,`close`,`send`],te=e=>p(e)&&y(S(O))(e.kind)&&y(S(A))(e.status)&&y(S(k))(e.mode)&&y(g)(e.includeClosed),ne=e=>p(e)&&y(m)(e.prompt)&&y(m)(e.stdin),re=e=>p(e)&&_(e.offset),ie=e=>p(e)&&v(e.offset),ae=e=>g(e)||e===`allow-session`||e===`allow-project`,oe=e=>p(e)&&(e.type===`answer`&&Array.isArray(e.values)&&e.values.every(m)&&y(m)(e.text)||e.type===`cancelled`&&e.values===void 0&&e.text===void 0),j={language:{language:h},outputStyle:{styleId:h},preset:{presetId:h},permissionMode:{mode:h},sandbox:{enabled:g},removePermissionRule:{scope:h,kind:S([`allow`,`deny`,`ask`]),pattern:h},mcpServerEnabled:{serverId:h,enabled:g},reloadMcpServers:{},pluginEnabled:{pluginId:h,enabled:g},reloadPlugins:{},installPlugin:{pluginId:h},uninstallPlugin:{pluginId:h},providerProfile:{profileName:h},providerModel:{profileName:h,modelId:h},deleteProviderProfile:{profileName:h}},se=e=>{if(!p(e)||!m(e.field))return!1;let t=e.field;if(!Object.prototype.hasOwnProperty.call(j,t))return!1;let n=j[t];return Object.entries(n).every(([t,n])=>n(e[t]))},ce={none:{},several:{message:m},stopped:{loopId:h,message:y(m)},failed:{loopId:y(h),message:m}},le=e=>{if(!p(e)||!m(e.kind))return!1;let t=e.kind;if(!Object.prototype.hasOwnProperty.call(ce,t))return!1;let n=ce[t];return Object.entries(n).every(([t,n])=>n(e[t]))};function M(e){return t=>{if(!p(t)||!m(t.kind))return!1;let n=Object.prototype.hasOwnProperty.call(e,t.kind)?e[t.kind]:void 0;return n!==void 0&&Object.entries(n).every(([e,n])=>n(t[e]))}}const ue=[`Added`,`Modified`,`Deleted`,`Renamed`,`Copied`,`Untracked`,`Conflicted`],de=e=>p(e)&&h(e.path)&&S(ue)(e.status)&&y(h)(e.renamedFrom)&&y(_)(e.added)&&y(_)(e.removed),fe=M({status:{branch:y(m),unborn:g,files:e=>Array.isArray(e)&&e.every(de),truncated:g},"not-a-repository":{},failed:{message:m}}),pe=[`add`,`remove`,`context`,`hunk`],me=e=>p(e)&&S(pe)(e.type)&&m(e.text)&&_(e.lineNumber),he=M({diff:{diffLines:e=>Array.isArray(e)&&e.every(me),truncated:g},"not-a-repository":{},"outside-workspace":{},failed:{message:m}}),ge=M({memory:{content:m,path:h,truncated:g},unavailable:{message:m}}),_e={submit:{prompt:h},command:{name:h,args:y(m),requestId:y(h)},abort:{},"cancel-queue":{},"get-messages":{},"get-history":{fromIndex:y(v)},"get-prompts":{},"get-context":{},"get-commands":{},"get-status":{},"list-models":{requestId:h},"get-agent-definitions":{requestId:h},"list-sessions":{requestId:h},"new-session":{requestId:y(h)},"switch-session":{sessionId:h,requestId:y(h)},"rename-session":{sessionId:h,name:h,requestId:h},"delete-session":{sessionId:h,requestId:h},"get-usage-report":{},"get-personal-usage-report":{requestId:h,period:S([`7d`,`30d`]),timezone:h},"get-stored-session-usage-report":{requestId:h,sessionId:h},"get-executing":{},"get-pending":{},"get-execution-workspace":{},"read-execution-detail":{requestId:h,entryId:h,cursor:y(ie)},"stop-waiting-loop":{requestId:h},"project-status":{requestId:h},"project-diff":{requestId:h,path:h},"project-memory":{requestId:h},"get-background-tasks":{filter:y(te)},"get-background-task":{taskId:h},"get-background-job-groups":{},"get-background-job-group":{groupId:h},"wait-background-job-group":{groupId:h},"cancel-background-task":{taskId:h,reason:y(m)},"close-background-task":{taskId:h},"send-background-task":{taskId:h,input:ne},"read-background-task-log":{taskId:h,cursor:y(re)},"permission-response":{id:h,result:ae},"ask-response":{id:h,response:oe},resume:{lastSeq:_},ack:{seq:_},"get-settings":{requestId:h},"update-settings":{requestId:h,patch:se}},N={driverId:y(m)},ve={text_delta:{delta:m,...N},user_message:{content:m,...N},tool_start:{state:p,...N},tool_end:{state:p,...N},thinking:{isThinking:g,...N},complete:{result:p,...N},interrupted:{result:p,...N},error:{message:m,code:y(S([`auth`,`rate_limit`,`model_unavailable`,`network`,`provider`])),provider:y(m),retryAfterSeconds:y(_),model:y(m),...N},command_result:{name:m,message:m,success:g,requestId:y(m)},messages:{messages:b,display:y(b),...N},history:{startIndex:v,total:v,entries:T},context:{state:p},history_changed:{},turn_source:{source:S(Object.keys(C))},commands:{commands:b,skills:b},session_status:{status:p},model_list:{requestId:h,groups:b,currentProfile:y(m),currentModel:m},agent_definitions:{requestId:h,agents:D,current:h},sessions:{requestId:h,listing:p},sessions_error:{requestId:h,code:S([`not_available`,`list_failed`]),message:m},session_switched:{event:p},session_change_failed:{code:S(e.SESSION_CHANGE_REFUSAL_CODES),message:m,requestId:y(m)},session_renamed_in_list:{requestId:h,sessionId:m,name:m},session_rename_failed:{requestId:h,message:m},session_deleted:{requestId:h,sessionId:m},session_delete_failed:{requestId:h,code:S(e.SESSION_DELETE_REFUSAL_CODES),message:m},usage_report:{report:p},personal_usage_report:{requestId:h,report:p},personal_usage_report_error:{requestId:h,code:S([`not_available`,`report_failed`]),message:m},stored_session_usage_report:{requestId:h,sessionId:h,report:p},stored_session_usage_report_error:{requestId:h,sessionId:h,code:S([`not_available`,`report_failed`]),message:m},executing:{executing:g},pending:{pending:e=>e===null||m(e),pendingCount:y(v)},execution_workspace_event:{snapshot:p},execution_detail:{requestId:h,page:p},execution_detail_error:{requestId:h,message:m},waiting_loop_stop:{requestId:h,outcome:le},project_status:{requestId:h,result:fe},project_diff:{requestId:h,result:he},project_memory:{requestId:h,result:ge},background_task_event:{event:p},background_job_group_event:{event:p},plan_event:{event:p},context_file_refreshed:{event:p},branch_event:{event:p},background_tasks:{tasks:b},background_task:{taskId:m,task:x},background_job_groups:{groups:b},background_job_group:{groupId:m,group:x},background_task_log:{taskId:m,page:p},permission_request:{event:p},ask_request:{event:p},prompt_resolved:{event:p},ui_intent:{event:p},session_renamed:{event:p},history_cleared:{},background_task_control_result:{action:S(ee),taskId:m,success:g,message:y(m)},protocol_error:{message:m,requestId:y(m)},resume_gap:{},settings:{requestId:h,settings:p},settings_error:{requestId:h,code:S([`not_available`,`invalid`,`refused`,`update_failed`]),message:m}};function P(e,t,n){if(!p(e))return{ok:!1,reason:`message must be a JSON object`};let r=e.type;if(!m(r))return{ok:!1,reason:`message type must be a string`};let i=Object.prototype.hasOwnProperty.call(t,r)?t[r]:void 0;if(i===void 0)return{ok:!1,reason:`Unknown message type: ${r}`};for(let[t,r]of Object.entries(i))if(!r(e[t]))return{ok:!1,reason:n(t)};return{ok:!0,message:e}}function F(e){return P(e,_e,e=>e===`prompt`?`prompt must be a non-empty string`:`${e} has an invalid shape`)}function ye(e){return P(e,ve,e=>`${e} has an invalid shape`)}function be(e,t){if(e.length>4194304)return{ok:!1,reason:`Frame too large`};let n;try{n=JSON.parse(e)}catch{return{ok:!1,reason:`Invalid JSON`}}return t(n)}function xe(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Se(e){return typeof e==`string`&&e.length>0?e:void 0}function Ce(e){if(!(new TextEncoder().encode(e).byteLength>4194304))try{let t=JSON.parse(e);if(!xe(t))return;let n=Se(t.requestId);if(!n)return;if(t.type===`get-personal-usage-report`)return{type:`personal`,requestId:n};let r=Se(t.sessionId);return t.type===`get-stored-session-usage-report`&&r?{type:`stored-session`,requestId:n,sessionId:r}:void 0}catch{return}}function we(e,t,n,r){return n.type===`get-personal-usage-report`?(De(t,n,r.personalUsageReporter),!0):n.type===`get-stored-session-usage-report`?(Ee(t,n,r.storedSessionUsageReporter),!0):n.type===`get-usage-report`?(Te(e,t,r.usageReporter),!0):!1}function Te(e,t,n){if(!n){t({type:`protocol_error`,message:`Per-session usage reporting is not available on this host.`});return}try{Promise.resolve(n(e)).then(e=>t({type:`usage_report`,report:e}),e=>t({type:`protocol_error`,message:R(e)}))}catch(e){t({type:`protocol_error`,message:R(e instanceof Error?e:String(e))})}}function Ee(e,t,n){if(!n){I(e,t,`not_available`,`Stored-session usage reporting is not available on this host.`);return}try{Promise.resolve(n(t.sessionId)).then(n=>e({type:`stored_session_usage_report`,requestId:t.requestId,sessionId:t.sessionId,report:n}),n=>I(e,t,`report_failed`,R(n)))}catch(n){I(e,t,`report_failed`,R(n instanceof Error?n:String(n)))}}function I(e,t,n,r){e({type:`stored_session_usage_report_error`,requestId:t.requestId,sessionId:t.sessionId,code:n,message:r})}function De(e,t,n){if(!n){L(e,t.requestId,`not_available`,`Personal usage reporting is not available on this host.`);return}try{Promise.resolve(n({period:t.period,timezone:t.timezone})).then(n=>e({type:`personal_usage_report`,requestId:t.requestId,report:n}),n=>L(e,t.requestId,`report_failed`,R(n)))}catch(n){L(e,t.requestId,`report_failed`,R(n instanceof Error?n:String(n)))}}function L(e,t,n,r){e({type:`personal_usage_report_error`,requestId:t,code:n,message:r})}function R(e){return e instanceof Error?e.message:String(e)}function Oe(e,t){let n=be(e,F);if(n.ok)return n.message;let r=Ce(e);return r?.type===`personal`?(t({type:`personal_usage_report_error`,requestId:r.requestId,code:`report_failed`,message:`Invalid personal usage report request.`}),null):r?.type===`stored-session`?(t({type:`stored_session_usage_report_error`,requestId:r.requestId,sessionId:r.sessionId,code:`report_failed`,message:`Invalid stored-session usage report request.`}),null):(t({type:`protocol_error`,message:n.reason}),null)}const ke=new Set([`get-messages`,`get-history`,`get-context`,`get-status`,`get-commands`,`list-models`,`get-executing`,`get-pending`,`get-execution-workspace`,`read-execution-detail`,`get-agent-definitions`,`get-usage-report`,`list-sessions`,`get-background-tasks`,`get-background-task`,`get-background-job-groups`,`get-background-job-group`,`wait-background-job-group`,`read-background-task-log`,`get-settings`,`project-status`,`project-diff`,`project-memory`]);function Ae(e){return ke.has(e)}function je(e){return e.type===`project-status`||e.type===`project-diff`||e.type===`project-memory`}function z(e,t){e({type:`protocol_error`,message:`This host does not support the Project panel.`,requestId:t})}function Me(e,t,n){let{requestId:r}=n;if(n.type===`project-status`){if(!e.readProjectStatus)return z(t,r);e.readProjectStatus().then(e=>t({type:`project_status`,requestId:r,result:e}),e=>t({type:`project_status`,requestId:r,result:{kind:`failed`,message:e instanceof Error?e.message:String(e)}}))}else if(n.type===`project-diff`){if(!e.readProjectDiff)return z(t,r);e.readProjectDiff(n.path).then(e=>t({type:`project_diff`,requestId:r,result:e}),e=>t({type:`project_diff`,requestId:r,result:{kind:`failed`,message:e instanceof Error?e.message:String(e)}}))}else{if(!e.readProjectMemory)return z(t,r);e.readProjectMemory().then(e=>t({type:`project_memory`,requestId:r,result:e}),e=>t({type:`project_memory`,requestId:r,result:{kind:`unavailable`,message:e instanceof Error?e.message:String(e)}}))}}function Ne(e){return e.type===`list-sessions`||e.type===`new-session`||e.type===`switch-session`}function Pe(e){return e.type===`rename-session`}function Fe(e){return e.type===`delete-session`}function Ie(t,n,r){if(n.type===`list-sessions`){Le(t,n.requestId,r);return}let i=n.requestId===void 0?{}:{requestId:n.requestId};if(!r){t({type:`session_change_failed`,code:`not_available`,message:`Sessions cannot be switched on this host.`,...i});return}Promise.resolve().then(()=>n.type===`new-session`?r.newSession():r.switchSession(n.sessionId)).catch(n=>t({type:`session_change_failed`,code:(0,e.isSessionChangeRefusal)(n)?n.code:`failed`,message:B(n),...i}))}function Le(e,t,n){if(!n){e({type:`sessions_error`,requestId:t,code:`not_available`,message:`Session listing is not available on this host.`});return}try{e({type:`sessions`,requestId:t,listing:n.listSessions()})}catch(n){e({type:`sessions_error`,requestId:t,code:`list_failed`,message:B(n instanceof Error?n:String(n))})}}function B(e){return e instanceof Error?e.message:String(e)}function Re(e,t,n){if(!n){e({type:`session_rename_failed`,requestId:t.requestId,message:`Sessions cannot be renamed on this host.`});return}n.renameSession(t.sessionId,t.name).then(()=>e({type:`session_renamed_in_list`,requestId:t.requestId,sessionId:t.sessionId,name:t.name}),n=>e({type:`session_rename_failed`,requestId:t.requestId,message:B(n)}))}function ze(t,n,r){if(!r){t({type:`session_delete_failed`,requestId:n.requestId,code:`not_available`,message:`Sessions cannot be deleted on this host.`});return}r.deleteSession(n.sessionId).then(()=>t({type:`session_deleted`,requestId:n.requestId,sessionId:n.sessionId}),r=>t({type:`session_delete_failed`,requestId:n.requestId,code:(0,e.isSessionDeleteRefusal)(r)?r.code:`failed`,message:B(r)}))}const V=new WeakMap;function Be(e){let t=V.get(e);t===void 0&&(t={frames:new Map,holders:0},V.set(e,t));let n=t;n.holders+=1;let r=!1;return{record:e=>{r||n.frames.set(e.event.id,e)},forget:e=>{n.frames.delete(e)},clear:()=>{n.frames.clear()},release:()=>{r||(r=!0,--n.holders,n.holders===0&&V.get(e)===n&&V.delete(e))}}}function Ve(e){return[...V.get(e)?.frames.values()??[]]}function He(e){let t=[],n=new Set,r=[e];for(let e=0;e<=8&&r.length>0;e++){let e=[];for(let i of r)if(!(i==null||n.has(i))&&(n.add(i),t.push(i),typeof i==`object`)){let t=i;e.push(t.originalError,t.cause)}r=e}return t}function Ue(e){let n;for(let r of He(e)){if(r instanceof t.AuthenticationError)return{code:`auth`,...r.provider!==void 0&&{provider:r.provider}};if(r instanceof t.RateLimitError)return{code:`rate_limit`,...r.provider!==void 0&&{provider:r.provider},...r.retryAfter!==void 0&&{retryAfterSeconds:r.retryAfter}};if(r instanceof t.ModelNotAvailableError)return{code:`model_unavailable`,provider:r.provider,...r.model!==void 0&&{model:r.model}};if(r instanceof t.NetworkError)return{code:`network`,...r.provider!==void 0&&{provider:r.provider}};n===void 0&&r instanceof t.ProviderError&&(n={code:`provider`,provider:r.provider})}return n??{}}const We={text_delta:`forwarded`,tool_start:`forwarded`,tool_end:`forwarded`,thinking:`forwarded`,complete:`forwarded`,error:`forwarded`,context_update:`forwarded`,compact:`forwarded`,interrupted:`forwarded`,skill_activation:`forwarded`,background_task_event:`forwarded`,background_job_group_event:`forwarded`,execution_workspace_event:`forwarded`,user_message:`forwarded`,turn_source:`forwarded`,context_file_refreshed:`forwarded`,memory_event:`forwarded`,goal_event:`non-surface`,plan_event:`forwarded`,branch_event:`forwarded`,permission_request:`forwarded`,ask_request:`forwarded`,prompt_resolved:`forwarded`,ui_intent:`requester-routed`,session_renamed:`forwarded`,history_cleared:`forwarded`,session_switched:`forwarded`,status_changed:`forwarded`};function H(e,t,n={}){let r=()=>{let t=e.getActiveDriverId();return t?{driverId:t}:{}},i=e=>t({type:`user_message`,content:e,...r()}),a=e=>t({type:`text_delta`,delta:e,...r()}),o=e=>t({type:`tool_start`,state:e,...r()}),s=e=>t({type:`tool_end`,state:e,...r()}),c=e=>t({type:`thinking`,isThinking:e,...r()}),l=e=>t({type:`complete`,result:U(e),...r()}),u=e=>t({type:`interrupted`,result:U(e),...r()}),d=e=>t({type:`error`,message:e.message,...Ue(e),...r()}),f=e=>t({type:`background_task_event`,event:e}),p=e=>t({type:`background_job_group_event`,event:e}),m=e=>t({type:`execution_workspace_event`,snapshot:e.snapshot}),h=e=>t({type:`plan_event`,event:e}),g=e=>t({type:`context_file_refreshed`,event:e}),_=e=>t({type:`branch_event`,event:e}),v=n.receivePrompts??!0,y=v?Be(e):void 0,b=e=>{let n={type:`permission_request`,event:e};y?.record(n),t(n)},x=e=>{let n={type:`ask_request`,event:e};y?.record(n),t(n)},S=e=>{y?.forget(e.id),t({type:`prompt_resolved`,event:e})},C=e=>{(e.requesterDriverId===void 0||e.requesterDriverId===n.getSurfaceDriverId?.())&&t({type:`ui_intent`,event:e})},w=e=>t({type:`session_renamed`,event:e}),T=()=>t({type:`history_cleared`}),E=e=>{y?.clear(),t({type:`session_switched`,event:e})},D=e=>t({type:`context`,state:e}),O=()=>t({type:`history_changed`}),k=e=>t({type:`turn_source`,source:e}),A=e=>t({type:`session_status`,status:e});return e.on(`user_message`,i),e.on(`text_delta`,a),e.on(`tool_start`,o),e.on(`tool_end`,s),e.on(`thinking`,c),e.on(`complete`,l),e.on(`interrupted`,u),e.on(`error`,d),e.on(`background_task_event`,f),e.on(`background_job_group_event`,p),e.on(`execution_workspace_event`,m),e.on(`plan_event`,h),e.on(`context_file_refreshed`,g),e.on(`branch_event`,_),v&&(e.on(`permission_request`,b),e.on(`ask_request`,x)),e.on(`prompt_resolved`,S),e.on(`ui_intent`,C),e.on(`session_renamed`,w),e.on(`history_cleared`,T),e.on(`session_switched`,E),e.on(`context_update`,D),e.on(`compact`,O),e.on(`skill_activation`,O),e.on(`memory_event`,O),e.on(`turn_source`,k),e.on(`status_changed`,A),()=>{e.off(`user_message`,i),e.off(`text_delta`,a),e.off(`tool_start`,o),e.off(`tool_end`,s),e.off(`thinking`,c),e.off(`complete`,l),e.off(`interrupted`,u),e.off(`error`,d),e.off(`background_task_event`,f),e.off(`background_job_group_event`,p),e.off(`execution_workspace_event`,m),e.off(`plan_event`,h),e.off(`context_file_refreshed`,g),e.off(`branch_event`,_),v&&(e.off(`permission_request`,b),e.off(`ask_request`,x)),e.off(`prompt_resolved`,S),e.off(`ui_intent`,C),e.off(`session_renamed`,w),e.off(`history_cleared`,T),e.off(`session_switched`,E),e.off(`context_update`,D),e.off(`compact`,O),e.off(`skill_activation`,O),e.off(`memory_event`,O),e.off(`turn_source`,k),e.off(`status_changed`,A),y?.release()}}function U(e){let{history:t,...n}=e;return n}const Ge=new TextEncoder;function Ke(e){return e.type===`get-messages`||e.type===`get-history`||e.type===`get-prompts`||e.type===`get-context`||e.type===`get-commands`||e.type===`get-status`||e.type===`list-models`||e.type===`get-agent-definitions`||e.type===`get-executing`||e.type===`get-pending`||e.type===`get-execution-workspace`||e.type===`read-execution-detail`}function qe(e,t,n){if(n.type===`get-messages`)t({type:`messages`,messages:e.getMessages(),display:e.getMessagesDisplay()});else if(n.type===`get-history`)t(Ye(e,n.fromIndex??0));else if(n.type===`get-prompts`)for(let n of Ve(e))t(n);else if(n.type===`get-context`)t({type:`context`,state:e.getContextState()});else if(n.type===`get-commands`)t({type:`commands`,commands:e.listCommands(),skills:e.listSkills()});else if(n.type===`get-status`)t({type:`session_status`,status:e.getStatusSnapshot()});else if(n.type===`list-models`){let r=e.listModels();t({type:`model_list`,requestId:n.requestId,...r})}else n.type===`get-agent-definitions`?t({type:`agent_definitions`,requestId:n.requestId,agents:e.listAgentDefinitions(),current:e.getDefaultAgentType()}):n.type===`get-executing`?t({type:`executing`,executing:e.isExecuting()}):n.type===`get-execution-workspace`?t({type:`execution_workspace_event`,snapshot:e.getExecutionWorkspaceSnapshot()}):n.type===`read-execution-detail`?Je(e,t,n):t(W(e))}function Je(e,t,n){let{requestId:r}=n;e.readExecutionWorkspaceDetail(n.entryId,n.cursor).then(e=>t({type:`execution_detail`,requestId:r,page:e}),e=>t({type:`execution_detail_error`,requestId:r,message:e instanceof Error?e.message:String(e)}))}function W(e){return{type:`pending`,pending:e.getPendingPrompt(),pendingCount:e.getPendingCount()}}function Ye(e,t){let n=e.getFullHistory(),r=n.length,i=Math.min(t,r),a=[],o=0;for(let e=i;e<r;e+=1){let t=Xe(n[e]),r=Ge.encode(JSON.stringify(t)).byteLength;if(a.length>0&&o+r>262144)break;a.push(t),o+=r}return{type:`history`,startIndex:i,total:r,entries:a}}function Xe(e){return{...e,timestamp:Ze(e.timestamp)}}function Ze(e){return typeof e==`string`?e:e.toISOString()}function G(e){return e.type===`get-settings`||e.type===`update-settings`}function K(e,t,n,r,i){if(!r){q(t,n.requestId,`not_available`,`Settings are not available on this host.`);return}try{if(n.type===`get-settings`){Promise.resolve(r.getSettings(e,i)).then(e=>t({type:`settings`,requestId:n.requestId,settings:e}),e=>q(t,n.requestId,`update_failed`,J(e)));return}Promise.resolve(r.updateSettings(e,n.patch,i)).then(e=>{e.ok?t({type:`settings`,requestId:n.requestId,settings:e.settings}):q(t,n.requestId,e.code,e.message)},e=>q(t,n.requestId,`update_failed`,J(e)))}catch(e){q(t,n.requestId,`update_failed`,J(e instanceof Error?e:String(e)))}}function q(e,t,n,r){e({type:`settings_error`,requestId:t,code:n,message:r})}function J(e){return e instanceof Error?e.message:String(e)}function Qe(e){let t=e.role??`drive`,n=H(e.session,e.deliver,{getSurfaceDriverId:()=>e.driverId,receivePrompts:t===`drive`});return{onMessage:$e(e.session,e.deliver,e.driverId,{personalUsageReporter:e.personalUsageReporter,usageReporter:e.usageReporter,storedSessionUsageReporter:e.storedSessionUsageReporter},e.surface,t,e.sessionDirectory,e.settingsReporter,e.commandSurfaceLocality),cleanup:n}}function $e(e,t,n,r=et,i,a=`drive`,o,s,c){return l=>{let u=Oe(l,t);if(u){if(a===`observe`&&!Ae(u.type)){t({type:`protocol_error`,message:`Not permitted for an observer: ${u.type}`});return}tt(e,t,u,n,r,i,o,s,c)}}}const et={personalUsageReporter:void 0,usageReporter:void 0,storedSessionUsageReporter:void 0};function tt(e,t,i,a,o=et,s,c,l,f){if(we(e,t,i,o))return;if(Ne(i)){Ie(t,i,c);return}if(G(i)){K(e,t,i,l,f);return}if(Pe(i)){Re(t,i,c);return}if(Fe(i)){ze(t,i,c);return}if(nt(i)){st(e,t,i,a,s,f);return}if(u(i)){d(e,t,i);return}if(Ke(i)){qe(e,t,i);return}if(je(i)){Me(e,t,i);return}if(rt(i)){n(e,t,i);return}if(it(i)){r(e,t,i);return}if(at(i)){ot(e,i,a);return}let p=i.type;t({type:`protocol_error`,message:`Unknown message type: ${p}`})}function nt(e){return e.type===`submit`||e.type===`command`||e.type===`abort`||e.type===`cancel-queue`}function rt(e){return e.type===`get-background-tasks`||e.type===`get-background-task`||e.type===`read-background-task-log`||e.type===`get-background-job-groups`||e.type===`get-background-job-group`||e.type===`wait-background-job-group`}function it(e){return e.type===`cancel-background-task`||e.type===`close-background-task`||e.type===`send-background-task`}function at(e){return e.type===`permission-response`||e.type===`ask-response`}function ot(e,t,n){t.type===`permission-response`?e.resolvePermission(t.id,t.result,n):e.resolveAsk(t.id,t.response,n)}function st(e,t,n,r,i,a){if(n.type===`submit`){if(typeof n.prompt!=`string`||n.prompt.length===0){t({type:`protocol_error`,message:`prompt must be a non-empty string`});return}let a={...r?{driverId:r}:{},...i?{surface:i}:{}};e.submit(n.prompt,void 0,void 0,Object.keys(a).length>0?a:void 0).then(()=>t(W(e)),e=>t({type:`protocol_error`,message:e.message}))}else if(n.type===`command`){let i=n.requestId===void 0?{}:{requestId:n.requestId};if(!n.name){t({type:`protocol_error`,message:`name is required`,...i});return}e.executeCommand(n.name,n.args??``,`remote`,r,a).then(e=>{t({type:`command_result`,name:n.name,message:e?.message??`Unknown command: ${n.name}`,success:e?.success??!1,data:e?.data,...i})},e=>{t({type:`protocol_error`,message:e.message,...i})})}else n.type===`abort`?e.abort():e.cancelQueue()}const Y=8*1048576;function ct(e,t=Y){return e!==void 0&&e>t}const lt=120*1e3;function ut(e=lt,t=Date.now){let n;return{maxPendingMs:e,observe(r){if(r===void 0)return;if(r===0){n=void 0;return}let i=t();n??=i;let a=i-n;return a>e?a:void 0}}}function X(e,t,n,r=Y,i=ut()){let a=!1,o=t=>{if(a)return;let o=n?.();if(ct(o,r)){a=!0,s(Error(`outbound backpressure budget exceeded: ${o} byte(s) pending, limit ${r}. The peer has accepted frames it is not reading.`),t.type);return}let c=i.observe(o);if(c!==void 0){a=!0,s(Error(`outbound drain budget exceeded: ${o} byte(s) pending for ${c} ms, limit ${i.maxPendingMs} ms. The peer is reading too slowly to ever drain what it accepted.`),t.type);return}try{e(t)}catch(e){a=!0,s(e instanceof Error?e:Error(String(e)),t.type)}};function s(e,n){try{t(e,n)}catch{}}return Object.assign(o,{pendingBytes:()=>n?.()})}var dt=class{frames=[];sizes=[];nextSeq=1;bytes=0;maxFrames;maxBytes;sizeOf;constructor(e={}){this.maxFrames=e.maxFrames??512,this.maxBytes=e.maxBytes??4194304,this.sizeOf=e.sizeOf??(e=>JSON.stringify(e).length)}append(e){let t=this.nextSeq;this.nextSeq+=1;let n=this.sizeOf(e);return this.frames.push({seq:t,message:e}),this.sizes.push(n),this.bytes+=n,this.evict(),t}ackThrough(e){let t=0;for(;t<this.frames.length&&this.frames[t].seq<=e;)t+=1;this.removeOldest(t)}tailAfter(e){return this.frames.length===0?e>=this.nextSeq-1?{kind:`tail`,frames:[]}:{kind:`overrun`}:e<this.frames[0].seq-1?{kind:`overrun`}:{kind:`tail`,frames:this.frames.filter(t=>t.seq>e)}}get lastSeq(){return this.nextSeq-1}get size(){return this.frames.length}evict(){let e=0,t=this.bytes;for(;this.frames.length-e>this.maxFrames||t>this.maxBytes&&this.frames.length-e>1;)t-=this.sizes[e],e+=1;this.removeOldest(e)}removeOldest(e){if(!(e<=0)){for(let t=0;t<e;t+=1)this.bytes-=this.sizes[t]??0;this.frames.splice(0,e),this.sizes.splice(0,e),this.frames.length===0&&(this.bytes=0)}}};const Z=new TextEncoder,ft=new TextDecoder,Q=Z.encode(`RBF`),pt=4294967295;function mt(e,t){let n=Z.encode(e);if(n.byteLength===0||n.byteLength>255)throw Error(`channel name must be 1..255 UTF-8 bytes (got ${n.byteLength})`);if(!Number.isInteger(t)||t<0||t>pt)throw Error(`seq must be an integer in 0..${pt} (got ${t})`);return n}function ht(e,t,n,r){e.set(Q,0),e[3]=1,e[4]=t,e[5]=n.byteLength,e.set(n,6);let i=6+n.byteLength;return new DataView(e.buffer,e.byteOffset,e.byteLength).setUint32(i,r,!1),i+4}function gt(e){let t=mt(e.channel,e.seq),n=new Uint8Array(6+t.byteLength+4+e.payload.byteLength),r=ht(n,1,t,e.seq);return n.set(e.payload,r),n}function _t(e){let t=mt(e.channel,e.seq),n=Z.encode(JSON.stringify({event:e.event,payload:e.payload})),r=new Uint8Array(6+t.byteLength+4+n.byteLength),i=ht(r,2,t,e.seq);return r.set(n,i),r}function vt(e){return e.byteLength<Q.length?!1:Q.every((t,n)=>e[n]===t)}function yt(e){let t=ft.decode(e),n;try{n=JSON.parse(t)}catch{return{ok:!1,error:`channel frame: malformed JSON body`}}if(typeof n!=`object`||!n||Array.isArray(n))return{ok:!1,error:`channel frame: event body must be a JSON object`};let{event:r,payload:i}=n;return typeof r!=`string`||r.length===0?{ok:!1,error:"channel frame: event body is missing a non-empty `event` name"}:{ok:!0,event:r,payload:i??null}}function bt(e){if(!vt(e))return{ok:!1,error:`channel frame: bad magic (not a channel frame)`};if(e.byteLength<6)return{ok:!1,error:`channel frame: truncated header`};if(e[3]!==1)return{ok:!1,error:`channel frame: unsupported version ${String(e[3])}`};let t=e[4],n=e[5]??0;if(n===0)return{ok:!1,error:`channel frame: empty channel name`};let r=6+n,i=r+4;if(e.byteLength<i)return{ok:!1,error:`channel frame: truncated (header longer than the frame)`};let a=ft.decode(e.subarray(6,r)),o=new DataView(e.buffer,e.byteOffset,e.byteLength).getUint32(r,!1),s=e.subarray(i);if(t===1)return{ok:!0,frame:{kind:`binary`,channel:a,seq:o,payload:Uint8Array.from(s)}};if(t===2){let e=yt(s);return e.ok?{ok:!0,frame:{kind:`event`,channel:a,seq:o,event:e.event,payload:e.payload}}:{ok:!1,error:e.error}}return{ok:!1,error:`channel frame: unknown kind ${String(t)}`}}var xt=class{session;buffer;driverId;reporters;surface;commandSurfaceLocality;unsubscribe;onDeliveryError;outbound;emitBoundary;disposed=!1;holding=!1;constructor(e){this.session=e.session,this.buffer=new dt(e.buffer),this.driverId=e.driverId,this.surface=e.surface,this.commandSurfaceLocality=e.commandSurfaceLocality,this.reporters={personalUsageReporter:e.personalUsageReporter,usageReporter:e.usageReporter,storedSessionUsageReporter:e.storedSessionUsageReporter},this.emitBoundary=X(e=>this.emit(e),(e,t)=>this.reportDeliveryError(e,t)),this.unsubscribe=H(this.session,this.emitBoundary,{getSurfaceDriverId:()=>this.driverId})}attach(e,t){this.disposed||(this.onDeliveryError=t.onDeliveryError,this.outbound=X(t=>e(JSON.stringify(t)),(e,t)=>this.reportDeliveryError(e,t),t.pendingBytes),this.holding=t.awaitResume===!0)}detach(){this.outbound=void 0,this.onDeliveryError=void 0}setDriverId(e){this.driverId=e}onClientMessage(e){if(this.disposed)return;let t=Oe(e,this.emitBoundary);if(t){if(t.type===`resume`){this.replay(t.lastSeq);return}if(t.type===`ack`){this.buffer.ackThrough(t.seq);return}tt(this.session,this.emitBoundary,t,this.driverId,this.reporters,this.surface,void 0,void 0,this.commandSurfaceLocality)}}dispose(){this.disposed||(this.disposed=!0,this.detach(),this.unsubscribe())}get lastSeq(){return this.buffer.lastSeq}emit(e){if(this.disposed)return;let t=this.buffer.append(e);this.holding||this.deliverFrame({...e,seq:t})}replay(e){let t=this.buffer.tailAfter(e);if(t.kind===`overrun`){this.deliverFrame({type:`resume_gap`}),this.holding=!1;return}for(let e of t.frames)this.deliverFrame({...e.message,seq:e.seq});this.holding=!1}deliverFrame(e){this.outbound?.(e)}reportDeliveryError(e,t){let n=this.onDeliveryError;this.detach();try{n?.(e,t)}catch{}}};function St(){return{origins:new Map}}function Ct(e,t,n){let r=t.origin.sessionId,i=e.origins.get(r);i===void 0&&(i={highestSequence:0,delivered:new Set,issued:new Map},e.origins.set(r,i));let a=i.issued.get(t.id);if(a!==void 0)return{ack:{...a,state:`duplicate`},deliver:!1};if(n!==void 0){let e={id:t.id,sequence:t.sequence,state:n.state,reason:n.reason};return i.issued.set(t.id,e),{ack:e,deliver:!1}}if(i.delivered.has(t.sequence)){let e={id:t.id,sequence:t.sequence,state:`refused`,reason:`sequence ${t.sequence} was already delivered by this origin under a different message id. A retry must repeat its id; a new id on a delivered sequence cannot be ordered against what the receiver already has.`};return i.issued.set(t.id,e),{ack:e,deliver:!1}}let o=i.highestSequence+1,s=t.sequence>o?o:void 0,c={id:t.id,sequence:t.sequence,state:`delivered`};return i.issued.set(t.id,c),i.delivered.add(t.sequence),i.highestSequence=Math.max(i.highestSequence,t.sequence),s===void 0?{ack:c,deliver:!0}:{ack:c,deliver:!0,gapBefore:s}}function wt(e,t,n){let r=e.origins.get(t),i=r?.issued.get(n);if(r===void 0||i===void 0||i.state!==`delivered`)return;let a={...i,state:`acknowledged`};return r.issued.set(n,a),a}function Tt(e,t){e.origins.delete(t)}const $=16*1024;function Et(e,t,n=$){if(!Number.isInteger(n)||n<1)throw Error(`handoff chunking: maxChunkBytes must be a positive integer, got ${n}. A zero or negative budget produces an infinite sequence of empty chunks, which presents as a hang rather than as the configuration error it is.`);let r=Buffer.from(t,`utf8`),i=Math.max(1,Math.ceil(r.byteLength/n)),a=[];for(let t=0;t<i;t+=1){let o=r.subarray(t*n,(t+1)*n);a.push({handoffId:e,index:t,total:i,data:o.toString(`base64`)})}return a}var Dt=class{handoffId;chunks=new Map;declaredTotal;constructor(e){this.handoffId=e}get received(){return this.chunks.size}get expected(){return this.declaredTotal}accept(e){let t=e=>({outcome:`refused`,rejection:e,received:this.chunks.size,...this.declaredTotal===void 0?{}:{expected:this.declaredTotal}});if(e.handoffId!==this.handoffId)return t(`wrong-handoff`);if(!Number.isInteger(e.total)||e.total<1||this.declaredTotal!==void 0&&e.total!==this.declaredTotal)return t(`inconsistent-total`);if(!Number.isInteger(e.index)||e.index<0||e.index>=e.total)return t(`out-of-range`);let n=Buffer.from(e.data,`base64`);if(n.toString(`base64`)!==e.data)return t(`undecodable`);this.declaredTotal=e.total;let r=this.chunks.get(e.index);return r===void 0?(this.chunks.set(e.index,n),this.chunks.size<e.total?{outcome:`accepted`,received:this.chunks.size,expected:e.total}:{outcome:`complete`,serialized:this.reassemble(e.total),received:this.chunks.size,expected:e.total}):r.equals(n)?{outcome:`duplicate`,received:this.chunks.size,expected:e.total}:t(`inconsistent-total`)}missing(){if(this.declaredTotal===void 0)return[];let e=[];for(let t=0;t<this.declaredTotal;t+=1)this.chunks.has(t)||e.push(t);return e}discard(){this.chunks.clear(),this.declaredTotal=void 0}reassemble(e){let t=[];for(let n=0;n<e;n+=1){let r=this.chunks.get(n);if(r===void 0)throw Error(`handoff chunking: chunk ${n} of ${e} is missing at reassembly.`);t.push(r)}return Buffer.concat(t).toString(`utf8`)}};function Ot(e,t=$){return Math.max(1,Math.ceil(e.byteLength/t))}exports.ATTACHED_SURFACE_MAX_PENDING_BYTES=1048576,exports.CHANNEL_FRAME_MAGIC=Q,exports.CHANNEL_FRAME_VERSION=1,exports.DEFAULT_MAX_CHUNK_BYTES=$,exports.DEFAULT_MAX_PENDING_BYTES=Y,exports.DEFAULT_MAX_PENDING_MS=lt,exports.HandoffChunkAssembler=Dt,exports.MAX_INBOUND_FRAME_BYTES=4194304,exports.PROTOCOL_SESSION_EVENT_CLASSIFICATION=We,exports.ResumeBuffer=dt,exports.SessionResumeBridge=xt,exports.acknowledgePeerMessage=wt,exports.admitPeerMessage=Ct,exports.chunkCountFor=Ot,exports.chunkHandoffPayload=Et,exports.createOutboundDelivery=X,exports.createPeerMessageLedger=St,exports.createPendingStallClock=ut,exports.createSessionMessageHandler=Qe,exports.decodeChannelFrame=bt,exports.decodeClientMessage=F,exports.decodeFrame=be,exports.decodeServerMessage=ye,exports.encodeBinaryFrame=gt,exports.encodeChannelEventFrame=_t,exports.forgetPeerOrigin=Tt,exports.handleSettingsMessage=K,exports.isChannelFrame=vt,exports.isObserverMessageType=Ae,exports.isOverPendingBudget=ct,exports.isSettingsMessage=G;

package/dist/node/index.d.cts

@@ -1,11 +1,35 @@
 import { IPersonalUsageReport, IPersonalUsageRequest, IUsageBySourceReport, TUsageSurface } from "@robota-sdk/agent-interface-analytics";
-import { ICommandResult } from "@robota-sdk/agent-interface-command";
-import { IBackgroundJobGroupState, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskState, IExecutionWorkspaceSnapshot, TBackgroundJobGroupEvent, TBackgroundTaskEvent } from "@robota-sdk/agent-interface-execution";
-import { IAskRequestEvent, IBranchEvent, IContextFileRefreshedEvent, IExecutionResult, IPermissionRequestEvent, IPlanApprovalEvent, IPromptResolvedEvent, ISessionBackgroundGroups, ISessionBackgroundTasks, ISessionCommands, ISessionConversationRead, ISessionDriverAttribution, ISessionEvents, ISessionExecutionState, ISessionExecutionWorkspace, ISessionPromptResolution, ISessionRenamedEvent, ISessionTurnControl, ISessionTurnSubmission, IToolState, IUiIntentEvent, TDriverId, TPermissionResultValue } from "@robota-sdk/agent-interface-session";
+import { ICommandListEntry, ICommandResult, ICommandSkillListEntry, TCommandSurfaceLocality } from "@robota-sdk/agent-interface-command";
+import { IBackgroundJobGroupState, IBackgroundTaskInput, IBackgroundTaskListFilter, IBackgroundTaskLogCursor, IBackgroundTaskLogPage, IBackgroundTaskState, IExecutionDetailCursor, IExecutionDetailPage, IExecutionWorkspaceSnapshot, TBackgroundJobGroupEvent, TBackgroundTaskEvent } from "@robota-sdk/agent-interface-execution";
+import { IAskRequestEvent, IBranchEvent, IContextFileRefreshedEvent, IExecutionResult, IModelListGroup, IPermissionRequestEvent, IPlanApprovalEvent, IPromptResolvedEvent, ISessionAgentJobs, ISessionBackgroundGroups, ISessionBackgroundTasks, ISessionCommands, ISessionConversationRead, ISessionDirectory, ISessionDriverAttribution, ISessionEvents, ISessionExecutionDetail, ISessionExecutionState, ISessionExecutionWorkspace, ISessionListing, ISessionProjectRead, ISessionPromptResolution, ISessionRenamedEvent, ISessionSelfPacedLoopControl, ISessionStatusRead, ISessionStatusSnapshot, ISessionSwitchedEvent, ISessionTurnControl, ISessionTurnSubmission, ISettingsSnapshot, IToolState, IUiIntentEvent, TDriverId, TPermissionResultValue, TProjectDiffRead, TProjectMemoryRead, TProjectStatusRead, TSessionChangeRefusalCode, TSessionDeleteRefusalCode, TSettingsPatch, TTurnSource, TWaitingLoopStopOutcome } from "@robota-sdk/agent-interface-session";
 import { IBinaryFrame, IChannelEventFrame, TActionResponse, TChannelReceiveResult } from "@robota-sdk/agent-interface-transport";
 import { IHandoffIntegrity, IPeerMessage, IPeerMessageAck, TPeerDeliveryState } from "@robota-sdk/agent-interface-session-mobility";
 //#region src/wire-messages.d.ts
 type TBackgroundControlAction = 'cancel' | 'close' | 'send';
+type THistoryEntry = ReturnType<ISessionConversationRead['getFullHistory']>[number];
+/**
+ * #3282 §4: one agent the switcher can offer. `definedIn` is a plain-words location — a discovered
+ * file's path, or "Built-in" — never a raw internal id.
+ */
+interface IWireAgentDefinitionSummary {
+  name: string;
+  description: string;
+  definedIn: string;
+}
+/**
+ * #3189: one entry of the session's full history as it crosses the wire. The same record the session
+ * keeps, except that `timestamp` is an ISO 8601 string: a `Date` does not survive JSON, and a
+ * declared `Date` that arrives as a string would let a client call `Date` methods on a string.
+ */
+interface IWireHistoryEntry extends Omit<THistoryEntry, 'timestamp'> {
+  /** ISO 8601. */
+  timestamp: string;
+}
+/**
+ * #3189: a turn's result as it crosses the wire. The session's whole history stays behind: it only
+ * grows, so a client reads it in bounded pages with `get-history` instead.
+ */
+type TWireExecutionResult = Omit<IExecutionResult, 'history'>;
 /** Inbound message from client to server. */
 type TClientMessage = {
   type: 'submit';
@@ -14,14 +38,49 @@ type TClientMessage = {
   type: 'command';
   name: string;
   args?: string;
+  requestId?: string;
 } | {
   type: 'abort';
 } | {
   type: 'cancel-queue';
 } | {
   type: 'get-messages';
+} | {
+  type: 'get-history';
+  fromIndex?: number;
+} | {
+  type: 'get-prompts';
 } | {
   type: 'get-context';
+} | {
+  type: 'get-commands';
+} | {
+  type: 'get-status';
+} | {
+  type: 'list-models';
+  requestId: string;
+} | {
+  type: 'get-agent-definitions';
+  requestId: string;
+} | {
+  type: 'list-sessions';
+  requestId: string;
+} | {
+  type: 'new-session';
+  requestId?: string;
+} | {
+  type: 'switch-session';
+  sessionId: string;
+  requestId?: string;
+} | {
+  type: 'rename-session';
+  sessionId: string;
+  name: string;
+  requestId: string;
+} | {
+  type: 'delete-session';
+  sessionId: string;
+  requestId: string;
 } | {
   type: 'get-usage-report';
 } | {
@@ -39,6 +98,24 @@ type TClientMessage = {
   type: 'get-pending';
 } | {
   type: 'get-execution-workspace';
+} | {
+  type: 'read-execution-detail';
+  requestId: string;
+  entryId: string;
+  cursor?: IExecutionDetailCursor;
+} | {
+  type: 'stop-waiting-loop';
+  requestId: string;
+} | {
+  type: 'project-status';
+  requestId: string;
+} | {
+  type: 'project-diff';
+  requestId: string;
+  path: string;
+} | {
+  type: 'project-memory';
+  requestId: string;
 } | {
   type: 'get-background-tasks';
   filter?: IBackgroundTaskListFilter;
@@ -82,6 +159,13 @@ type TClientMessage = {
 } | {
   type: 'ack';
   seq: number;
+} | {
+  type: 'get-settings';
+  requestId: string;
+} | {
+  type: 'update-settings';
+  requestId: string;
+  patch: TSettingsPatch;
 };
 /** Outbound message from server to client. */
 type TServerMessage = {
@@ -106,15 +190,32 @@ type TServerMessage = {
   driverId?: TDriverId;
 } | {
   type: 'complete';
-  result: IExecutionResult;
+  result: TWireExecutionResult;
   driverId?: TDriverId;
 } | {
   type: 'interrupted';
-  result: IExecutionResult;
+  result: TWireExecutionResult;
   driverId?: TDriverId;
 } | {
   type: 'error';
+  /** The raw failure text — kept for a "Details" disclosure; never the whole story on its own. */
   message: string;
+  /**
+   * What kind of failure this was, when it's known — so a renderer can say what happened and
+   * what to do next in plain words instead of showing `message` verbatim (#3289 §3). Additive:
+   * absent for a session error this classification does not recognize (unchanged behavior).
+   */
+  code?: 'auth' | 'rate_limit' | 'model_unavailable' | 'network' | 'provider';
+  /** The provider/profile name the failure came from, when `code` names one. */
+  provider?: string;
+  /** For `code: 'rate_limit'`, how long until a retry may succeed, when the provider said so. */
+  retryAfterSeconds?: number;
+  /**
+   * For `code: 'model_unavailable'`, the model the failed request tried — captured at the moment
+   * of failure so a renderer never has to fall back to whatever model is live by the time it
+   * draws this notice (which may already be a different one the person switched to).
+   */
+  model?: string;
   driverId?: TDriverId;
 } | {
   type: 'command_result';
@@ -122,12 +223,91 @@ type TServerMessage = {
   message: string;
   success: boolean;
   data?: ICommandResult['data'];
+  /** The `requestId` of the `command` this answers, when it carried one. */
+  requestId?: string;
 } | {
   type: 'messages';
   messages: ReturnType<ISessionConversationRead['getMessages']>;
+  /**
+   * #3288 §2: the SAME history, projected into display segments (text runs and finished tool
+   * calls, diffs included) — so a reload/reconnect/resume replay shows tool rows instead of bare
+   * text. Optional so an older host that has not grown `getMessagesDisplay()` yet still sends a
+   * valid frame; a client without this field falls back to `messages`-only (text bubbles), the
+   * same as before this existed.
+   */
+  display?: ReturnType<ISessionConversationRead['getMessagesDisplay']>;
+  /**
+   * #3289 §3: this connection's own server-assigned driver id, carried on the first frame every
+   * connection already gets — so a client can tell its OWN turns from a co-driver's instead of
+   * treating everything but the literal `'owner'` id as someone else (REMOTE-014 E5 display-only).
+   */
+  driverId?: TDriverId;
+} | {
+  type: 'history';
+  startIndex: number;
+  total: number;
+  entries: IWireHistoryEntry[];
 } | {
   type: 'context';
   state: ReturnType<ISessionConversationRead['getContextState']>;
+} | {
+  type: 'history_changed';
+} | {
+  type: 'turn_source';
+  source: TTurnSource;
+} | {
+  type: 'commands';
+  commands: ICommandListEntry[];
+  skills: ICommandSkillListEntry[];
+} | {
+  type: 'session_status';
+  status: ISessionStatusSnapshot;
+} | {
+  type: 'model_list';
+  requestId: string;
+  groups: readonly IModelListGroup[];
+  currentProfile?: string;
+  currentModel: string;
+} | {
+  type: 'agent_definitions';
+  requestId: string;
+  agents: readonly IWireAgentDefinitionSummary[];
+  current: string;
+} | {
+  type: 'sessions';
+  requestId: string;
+  listing: ISessionListing;
+} | {
+  type: 'sessions_error';
+  requestId: string;
+  code: 'not_available' | 'list_failed';
+  message: string;
+} | {
+  type: 'session_switched';
+  event: ISessionSwitchedEvent;
+} | {
+  type: 'session_change_failed';
+  code: TSessionChangeRefusalCode;
+  message: string;
+  requestId?: string;
+} | {
+  type: 'session_renamed_in_list';
+  requestId: string;
+  sessionId: string;
+  name: string;
+} | {
+  type: 'session_rename_failed';
+  requestId: string;
+  message: string;
+} | {
+  type: 'session_deleted';
+  requestId: string;
+  sessionId: string;
+} | {
+  type: 'session_delete_failed';
+  requestId: string;
+  code: TSessionDeleteRefusalCode;
+  message: string;
 } | {
   type: 'usage_report';
   report: IUsageBySourceReport;
@@ -157,9 +337,34 @@ type TServerMessage = {
 } | {
   type: 'pending';
   pending: string | null;
+  pendingCount?: number;
 } | {
   type: 'execution_workspace_event';
   snapshot: IExecutionWorkspaceSnapshot;
+} | {
+  type: 'execution_detail';
+  requestId: string;
+  page: IExecutionDetailPage;
+} | {
+  type: 'execution_detail_error';
+  requestId: string;
+  message: string;
+} | {
+  type: 'waiting_loop_stop';
+  requestId: string;
+  outcome: TWaitingLoopStopOutcome;
+} | {
+  type: 'project_status';
+  requestId: string;
+  result: TProjectStatusRead;
+} | {
+  type: 'project_diff';
+  requestId: string;
+  result: TProjectDiffRead;
+} | {
+  type: 'project_memory';
+  requestId: string;
+  result: TProjectMemoryRead;
 } | {
   type: 'background_task_event';
   event: TBackgroundTaskEvent;
@@ -219,8 +424,18 @@ type TServerMessage = {
 } | {
   type: 'protocol_error';
   message: string;
+  requestId?: string;
 } | {
   type: 'resume_gap';
+} | {
+  type: 'settings';
+  requestId: string;
+  settings: ISettingsSnapshot;
+} | {
+  type: 'settings_error';
+  requestId: string;
+  code: 'not_available' | 'invalid' | 'refused' | 'update_failed';
+  message: string;
 };
 /**
  * REMOTE-013 E4: a server message stamped with its monotonic session sequence number (added by the
@@ -262,14 +477,22 @@ type TOutboundDeliver = ((message: TServerMessage) => void) & {
 };
 /**
  * Observe THIS connection's first outbound delivery failure. `event` is the `type` of the frame that
- * could not be delivered — a session event's own name for the fan-out (they are identical), and the
- * reply's type for a reply (`command_result`, `protocol_error`, …).
+ * could not be delivered — for the fan-out, the frame a session event was forwarded as (usually, not
+ * always, the event's own name), and the reply's type for a reply (`command_result`, `protocol_error`, …).
  *
  * Required, never optional: a carrier that could opt out of observing its own delivery failures is the
  * silent-failure shape this boundary exists to remove.
  */
 type TDeliveryErrorHandler = (error: Error, event: TServerMessage['type']) => void;
 declare const DEFAULT_MAX_PENDING_BYTES: number;
+/**
+ * Backpressure budget for a terminal attached to a session on the same host, in either role.
+ *
+ * 1 MiB, tighter than the default: an attached terminal reads a local socket, so a backlog this large
+ * means it stopped reading rather than that a network is slow. Exceeding it closes that connection
+ * only; the session never waits for a reader, so other surfaces keep streaming.
+ */
+declare const ATTACHED_SURFACE_MAX_PENDING_BYTES: number;
 /**
  * Is this carrier holding more than the budget allows?
  *
@@ -315,7 +538,48 @@ declare function createOutboundDelivery(send: (message: TServerMessage) => void,
 //#endregion
 //#region src/protocol-session.d.ts
 /** Session roles required by the shared WebSocket/WebRTC protocol. */
-interface IProtocolSession extends ISessionTurnSubmission, ISessionTurnControl, ISessionCommands, ISessionEvents, ISessionPromptResolution, ISessionConversationRead, ISessionExecutionState, ISessionDriverAttribution, ISessionBackgroundTasks, ISessionBackgroundGroups, ISessionExecutionWorkspace {}
+interface IProtocolSession extends ISessionTurnSubmission, ISessionTurnControl, ISessionCommands, ISessionStatusRead, ISessionEvents, ISessionPromptResolution, ISessionConversationRead, ISessionExecutionState, ISessionDriverAttribution, ISessionBackgroundTasks, ISessionBackgroundGroups, ISessionExecutionWorkspace, ISessionExecutionDetail, ISessionSelfPacedLoopControl, ISessionAgentJobs {}
+/**
+ * #3282 §4c: a protocol session that ALSO answers the Project panel's reads. `Partial` (not a fourth
+ * mandatory role on {@link IProtocolSession} itself) deliberately: every existing test double and
+ * every other host that builds an `IProtocolSession` keeps type-checking unchanged, and the panel's
+ * three methods are runtime-probed (`typeof session.readProjectStatus === 'function'`) rather than
+ * assumed — `InteractiveSession` (the one production implementation) provides all three, satisfying
+ * this type with no further wiring.
+ */
+type TProjectReadCapableSession = IProtocolSession & Partial<ISessionProjectRead>;
+//#endregion
+//#region src/settings-messages.d.ts
+type TSettingsMessage = Extract<TClientMessage, {
+  type: 'get-settings' | 'update-settings';
+}>;
+declare function isSettingsMessage(msg: TClientMessage): msg is TSettingsMessage;
+/** What applying a patch did: the fresh snapshot, or why nothing was written. */
+type TSettingsUpdateOutcome = {
+  readonly ok: true;
+  readonly settings: ISettingsSnapshot;
+} | {
+  readonly ok: false;
+  readonly code: 'not_available' | 'invalid' | 'refused' | 'update_failed';
+  readonly message: string;
+};
+/**
+ * #3282 §4a: host-owned read/write for the Settings screen, supplied by the composition root the
+ * same way `IUsageQueryReporters` supplies usage reads — this package only correlates the request
+ * and carries the result. `updateSettings` applies through the SAME function the matching slash
+ * command uses (issue #3282 §4: "one code path, so the behavior matches the TUI"), so whatever a
+ * command would refuse on this surface is refused here too.
+ */
+interface ISettingsReporter {
+  getSettings(session: IProtocolSession, locality?: TCommandSurfaceLocality): ISettingsSnapshot | Promise<ISettingsSnapshot>;
+  /**
+   * Applies through the SAME function the matching slash command uses. `locality` (#3282 §4 part
+   * b-2) is forwarded to that command exactly as the transport received it, so a command that
+   * refuses a remote surface (installing a plugin) refuses identically here.
+   */
+  updateSettings(session: IProtocolSession, patch: TSettingsPatch, locality?: TCommandSurfaceLocality): TSettingsUpdateOutcome | Promise<TSettingsUpdateOutcome>;
+}
+declare function handleSettingsMessage(session: IProtocolSession, deliver: TOutboundDeliver, msg: TSettingsMessage, reporter: ISettingsReporter | undefined, locality?: TCommandSurfaceLocality): void;
 //#endregion
 //#region src/usage-messages.d.ts
 interface IUsageQueryReporters {
@@ -334,17 +598,17 @@ declare const PROTOCOL_SESSION_EVENT_CLASSIFICATION: {
   readonly thinking: "forwarded";
   readonly complete: "forwarded";
   readonly error: "forwarded";
-  readonly context_update: "non-surface";
-  readonly compact: "non-surface";
+  readonly context_update: "forwarded";
+  readonly compact: "forwarded";
   readonly interrupted: "forwarded";
-  readonly skill_activation: "non-surface";
+  readonly skill_activation: "forwarded";
   readonly background_task_event: "forwarded";
   readonly background_job_group_event: "forwarded";
   readonly execution_workspace_event: "forwarded";
   readonly user_message: "forwarded";
-  readonly turn_source: "non-surface";
+  readonly turn_source: "forwarded";
   readonly context_file_refreshed: "forwarded";
-  readonly memory_event: "non-surface";
+  readonly memory_event: "forwarded";
   readonly goal_event: "non-surface";
   readonly plan_event: "forwarded";
   readonly branch_event: "forwarded";
@@ -354,12 +618,20 @@ declare const PROTOCOL_SESSION_EVENT_CLASSIFICATION: {
   readonly ui_intent: "requester-routed";
   readonly session_renamed: "forwarded";
   readonly history_cleared: "forwarded";
+  readonly session_switched: "forwarded";
+  readonly status_changed: "forwarded";
 };
 //#endregion
 //#region src/session-message-handler.d.ts
+/**
+ * What a connected surface may do. `drive` sends prompts, answers questions and controls the session.
+ * `observe` is read-only: it follows this session's conversation and state, but never submits, answers,
+ * controls, or reads another session's records, and it never counts as a surface that can answer.
+ */
+type TSessionSurfaceRole = 'drive' | 'observe';
 interface ISessionMessageHandlerOptions {
-  /** IProtocolSession to expose. */
-  session: IProtocolSession;
+  /** IProtocolSession to expose — `Partial<ISessionProjectRead>` is probed, not assumed (#3282 §4c). */
+  session: TProjectReadCapableSession;
   /**
    * ARCH-030: the CARRIER's connection-scoped outbound delivery boundary — not a raw `send`, and not a
    * `send` plus an error callback for this handler to assemble into one. The carrier owns both the sink
@@ -376,12 +648,25 @@ interface ISessionMessageHandlerOptions {
   driverId?: TDriverId;
   /** Trusted carrier-owned product surface, kept separate from driver identity. */
   surface?: TUsageSurface;
+  /** Carrier-decided role of this connection; defaults to `drive`. The client never chooses it here. */
+  role?: TSessionSurfaceRole;
   /** Host-owned cross-session read model. The protocol only correlates and carries its result. */
   personalUsageReporter?: NonNullable<IUsageQueryReporters['personalUsageReporter']>;
   /** Host-owned current-session trace/cost producer for the pre-existing message family. */
   usageReporter?: NonNullable<IUsageQueryReporters['usageReporter']>;
   /** Host-owned stored-session producer used by cross-session drill-down. */
   storedSessionUsageReporter?: NonNullable<IUsageQueryReporters['storedSessionUsageReporter']>;
+  /** Host-owned session directory (#3189): list, start and switch the host's sessions. */
+  sessionDirectory?: ISessionDirectory;
+  /** #3282 §4a: host-owned read/write for the GUI Settings screen. */
+  settingsReporter?: ISettingsReporter;
+  /**
+   * #3282 §4 part b-2: carrier-decided, like `role` — whether THIS carrier's connections are
+   * provably on this machine. The loopback WS carrier is `'local'`; the device-mesh/WebRTC carrier
+   * sets `'remote'`. Absent → `'local'`, forwarded to `executeCommand` and the settings reporter so a
+   * command that runs code from outside the session (installing a plugin) can refuse a remote device.
+   */
+  commandSurfaceLocality?: TCommandSurfaceLocality;
 }
 /**
  * Create a carrier-neutral message handler for an IProtocolSession.
@@ -407,6 +692,10 @@ declare function createSessionMessageHandler(options: ISessionMessageHandlerOpti
   cleanup: () => void;
 };
 //#endregion
+//#region src/observer-messages.d.ts
+/** Whether an observer may send a message of this type. */
+declare function isObserverMessageType(type: string): boolean;
+//#endregion
 //#region src/message-decoders.d.ts
 type TMessageDecodeResult<TMessage> = {
   readonly ok: true;
@@ -528,6 +817,8 @@ interface ISessionResumeBridgeOptions {
   readonly personalUsageReporter?: IUsageQueryReporters['personalUsageReporter'];
   readonly usageReporter?: IUsageQueryReporters['usageReporter'];
   readonly storedSessionUsageReporter?: IUsageQueryReporters['storedSessionUsageReporter'];
+  /** #3282 §4 part b-2: this bridge is the reconnectable WebRTC path, so it is always `'remote'`. */
+  readonly commandSurfaceLocality?: TCommandSurfaceLocality;
 }
 declare class SessionResumeBridge {
   private readonly session;
@@ -535,6 +826,7 @@ declare class SessionResumeBridge {
   private driverId?;
   private readonly reporters;
   private readonly surface?;
+  private readonly commandSurfaceLocality?;
   private readonly unsubscribe;
   private onDeliveryError?;
   /**
@@ -762,5 +1054,5 @@ declare class HandoffChunkAssembler {
  */
 declare function chunkCountFor(integrity: IHandoffIntegrity, maxChunkBytes?: number): number;
 //#endregion
-export { CHANNEL_FRAME_MAGIC, CHANNEL_FRAME_VERSION, DEFAULT_MAX_CHUNK_BYTES, DEFAULT_MAX_PENDING_BYTES, DEFAULT_MAX_PENDING_MS, HandoffChunkAssembler, type IAttachOptions, type IBufferedFrame, type IChunkResult, type IHandoffChunk, type IPeerMessageLedger, type IPeerMessageRejection, type IPeerMessageVerdict, type IPendingStallClock, type IProtocolSession, type IResumeBufferOptions, type ISessionMessageHandlerOptions, type ISessionResumeBridgeOptions, MAX_INBOUND_FRAME_BYTES, PROTOCOL_SESSION_EVENT_CLASSIFICATION, ResumeBuffer, SessionResumeBridge, type TChunkOutcome, type TChunkRejection, type TClientMessage, type TDeliveryErrorHandler, type TMessageDecodeResult, type TOutboundDeliver, type TProtocolSessionEventClassification, type TResumeSink, type TResumeTail, type TSeqServerMessage, type TServerMessage, acknowledgePeerMessage, admitPeerMessage, chunkCountFor, chunkHandoffPayload, createOutboundDelivery, createPeerMessageLedger, createPendingStallClock, createSessionMessageHandler, decodeChannelFrame, decodeClientMessage, decodeFrame, decodeServerMessage, encodeBinaryFrame, encodeChannelEventFrame, forgetPeerOrigin, isChannelFrame, isOverPendingBudget };
+export { ATTACHED_SURFACE_MAX_PENDING_BYTES, CHANNEL_FRAME_MAGIC, CHANNEL_FRAME_VERSION, DEFAULT_MAX_CHUNK_BYTES, DEFAULT_MAX_PENDING_BYTES, DEFAULT_MAX_PENDING_MS, HandoffChunkAssembler, type IAttachOptions, type IBufferedFrame, type IChunkResult, type IHandoffChunk, type IPeerMessageLedger, type IPeerMessageRejection, type IPeerMessageVerdict, type IPendingStallClock, type IProtocolSession, type IResumeBufferOptions, type ISessionMessageHandlerOptions, type ISessionResumeBridgeOptions, type ISettingsReporter, type IWireAgentDefinitionSummary, type IWireHistoryEntry, MAX_INBOUND_FRAME_BYTES, PROTOCOL_SESSION_EVENT_CLASSIFICATION, ResumeBuffer, SessionResumeBridge, type TChunkOutcome, type TChunkRejection, type TClientMessage, type TDeliveryErrorHandler, type TMessageDecodeResult, type TOutboundDeliver, type TProtocolSessionEventClassification, type TResumeSink, type TResumeTail, type TSeqServerMessage, type TServerMessage, type TSessionSurfaceRole, type TSettingsUpdateOutcome, type TWireExecutionResult, acknowledgePeerMessage, admitPeerMessage, chunkCountFor, chunkHandoffPayload, createOutboundDelivery, createPeerMessageLedger, createPendingStallClock, createSessionMessageHandler, decodeChannelFrame, decodeClientMessage, decodeFrame, decodeServerMessage, encodeBinaryFrame, encodeChannelEventFrame, forgetPeerOrigin, handleSettingsMessage, isChannelFrame, isObserverMessageType, isOverPendingBudget, isSettingsMessage };
 //# sourceMappingURL=index.d.cts.map