@alvin0/ai-agent-sdk-core 0.1.5 → 0.1.7

package/dist/agent/team/team.js

@@ -1,2 +1,2 @@
-import{waitForSettlement as e}from"../../async/settlement.js";import{timeoutValue as t}from"../../platform/config.js";import{AgentSdkError as n}from"../../errors/agent-sdk-error.js";import{createUserMessage as r}from"../../message/message.js";import{defineTool as i}from"../tool/definition.js";import{TEAM_TOOL_NAMES as a,abortable as o,asJson as s,boundedString as c,byteLength as l,combineSignals as u,deepCloneFreeze as d,emptyObject as f,errorMessage as p,memberName as m,messageContent as h,messageToolSchema as g,newMessageId as _,newTeamId as v,parseMessageTool as y,parseWaitTool as b,positiveInteger as x,withTimeout as S}from"./common.js";var C=class{ownRemoteTask;id;maxMembers;maxMessageBytes;maxLinkedResultBytes;maxMessages;maxMailboxBytes;maxMetadataBytes;disposeTimeoutMs;operationTimeoutMs;observerTimeoutMs;waitTimeoutMs;minWaitTimeoutMs;onEvent;onAgentEvent;roster=new Map;links=new Map;mailbox=[];mailboxBytes=0;pendingMessages=0;pendingMailboxBytes=0;lifecycle=new AbortController;waitEdges=new Map;disposed=!1;disposeTask;constructor(e={},n){this.ownRemoteTask=n,this.id=c(e.id??v(),`team id`,1024),this.maxMembers=x(e.maxMembers??8,`maxMembers`),this.maxMessageBytes=x(e.maxMessageBytes??65536,`maxMessageBytes`),this.maxLinkedResultBytes=x(e.maxLinkedResultBytes??1048576,`maxLinkedResultBytes`),this.maxMessages=x(e.maxMessages??1e4,`maxMessages`),this.maxMailboxBytes=x(e.maxMailboxBytes??67108864,`maxMailboxBytes`),this.maxMetadataBytes=x(e.maxMetadataBytes??8192,`maxMetadataBytes`),this.disposeTimeoutMs=t(e.disposeTimeoutMs??3e4),this.operationTimeoutMs=t(e.operationTimeoutMs??6e5),this.observerTimeoutMs=t(e.observerTimeoutMs??1e3),this.waitTimeoutMs=t(e.waitTimeoutMs??3e4),this.minWaitTimeoutMs=Math.min(t(e.minWaitTimeoutMs??5e3),this.waitTimeoutMs),this.onEvent=e.onEvent,this.onAgentEvent=e.onAgentEvent}attach(e,t={}){this.assertActive();let n=m(t.name??e.definition.id);this.assertAddressAvailable(n),this.assertCapacity();let r=t.role??(this.roster.size===0?`lead`:`peer`);if(r===`lead`&&[...this.roster.values()].some(e=>e.role===`lead`))throw Error(`A2A team '${this.id}' already has a lead`);let i={kind:`local`,name:n,role:r,access:t.tools===!1?!1:t.tools===`reporting`?`reporting`:`full`,session:e,wakeRequestedSeq:0,wakeConsumedSeq:0,wakeTask:void 0,wakeController:void 0,error:void 0,outcome:void 0,pendingStart:void 0,steerController:void 0,...t.description===void 0?{}:{description:c(t.description,`member description`,this.maxMetadataBytes)},...t.instructions===void 0?{}:{instructions:c(t.instructions,`member instructions`,this.maxMetadataBytes)}};this.roster.set(n,i),this.emit({type:`member-attached`,member:this.view(i)})}linkAgent(e){this.assertActive();let t=m(e.name);if(this.assertAddressAvailable(t),this.assertCapacity(),typeof e.transport?.send!=`function`)throw TypeError(`linked agent transport must implement send()`);let n={kind:`remote`,name:t,role:`peer`,transport:e.transport,tail:Promise.resolve(),pending:0,controllers:new Set,error:void 0,...e.description===void 0?{}:{description:c(e.description,`linked agent description`,this.maxMetadataBytes)}};return this.links.set(t,n),this.emit({type:`member-linked`,member:this.view(n)}),()=>{if(this.links.get(t)===n){if(n.pending>0)throw Error(`cannot unlink running A2A member '${t}'`);this.links.delete(t)}}}detach(e){this.assertActive();let t=this.requireLocalMember(e);if(t.session.isRunning||t.wakeTask!==void 0)throw Error(`cannot detach running A2A member '${t.name}'`);this.roster.delete(t.name)}members(){return Object.freeze([...this.roster.values(),...this.links.values()].map(e=>this.view(e)))}messages(){return d(this.mailbox)}async sendMessage(e){this.assertActive(),e.signal?.throwIfAborted();let t=this.requireLocalMember(e.from),n=this.requireAddress(e.target);if(n.kind===`local`&&t===n)throw Error(`an A2A member cannot message itself`);let i=e.delivery??`quiet`;if(i!==`quiet`&&i!==`wakeup`)throw TypeError(`A2A delivery must be 'quiet' or 'wakeup'`);if(n.kind===`remote`&&i===`quiet`)throw Error(`remote A2A member '${n.name}' cannot accept quiet injection; use followup_task or delivery 'wakeup'`);let a=_(),o=h(e.message,this.maxMessageBytes),s=d([{type:`text`,text:`A2A message ${a} from ${t.name}:`},...o]),c=l(s);if(c>this.maxMessageBytes)throw Error(`A2A message exceeds the ${this.maxMessageBytes}-byte limit`);let u=n.kind===`remote`?c+this.maxLinkedResultBytes:c,f=this.reserveMailbox(u),p;try{if(n.kind===`local`){let e=r({source:{kind:`agent-message`,teamId:this.id,messageId:a,sender:t.name,senderAgentId:t.session.definition.id},content:s}),o=n.session.inject(e);i===`wakeup`&&this.scheduleWake(n,o)}else p=await this.dispatchRemote(n,{teamId:this.id,messageId:a,sender:t.name,senderAgentId:t.session.definition.id,content:s,...e.signal===void 0?{}:{signal:e.signal}});let o=d({id:a,teamId:this.id,sender:t.name,senderAgentId:t.session.definition.id,target:n.name,targetAgentId:n.kind===`local`?n.session.definition.id:n.transport.agentId,delivery:i,content:s,status:`accepted`,createdAt:new Date().toISOString(),...p===void 0?{}:{result:p}}),u=c+(p===void 0?0:l(p));return this.mailbox.push(o),this.mailboxBytes+=u,this.emit({type:`message-accepted`,message:d(o)}),d({messageId:a,status:`accepted`,delivery:i,target:n.name,...p===void 0?{}:{result:p}})}finally{f()}}followup(e,t,n,r){return this.sendMessage({from:e,target:t,message:n,delivery:`wakeup`,...r===void 0?{}:{signal:r}})}async whenIdle(e,t){let n=this.requireAddress(e);if(n.kind===`remote`){for(;;){let e=n.tail;if(await o(e,t),e===n.tail&&n.pending===0)break}return}for(;;){let e=n.wakeRequestedSeq,r=n.wakeTask,i=n.pendingStart;if(i!==void 0&&await o(i,t),r!==void 0&&await o(r,t),await n.session.whenIdle(t),n.wakeTask===void 0&&!n.session.isRunning&&n.pendingStart===void 0&&n.wakeConsumedSeq>=n.wakeRequestedSeq&&e===n.wakeRequestedSeq)return}}notifySteer(e){let t=this.requireLocalMember(e),n=t.steerController;t.steerController=void 0,n?.abort(Error(`user input steered into the active turn`))}wake(e){let t=this.requireLocalMember(e);this.scheduleWake(t,t.wakeRequestedSeq+1)}async cancel(e,t=Error(`A2A member work cancelled`)){let n=this.requireAddress(e);if(n.kind===`remote`){for(let e of n.controllers)e.abort(t);await S(n.tail,this.disposeTimeoutMs,`A2A member '${n.name}' did not cancel within ${this.disposeTimeoutMs}ms`,`TEAM_CANCELLATION_TIMEOUT`);return}n.wakeConsumedSeq=n.wakeRequestedSeq;let r=n.wakeController,i=n.wakeTask;r?.abort(t),i!==void 0&&await S(i,this.disposeTimeoutMs,`A2A member '${n.name}' did not cancel within ${this.disposeTimeoutMs}ms`,`TEAM_CANCELLATION_TIMEOUT`)}dispose(e=Error(`A2A team disposed`)){if(this.disposeTask!==void 0)return this.disposeTask;this.disposed=!0,this.lifecycle.abort(e);let t=Promise.allSettled([...[...this.roster.values()].map(t=>this.cancel(t.name,e)),...[...this.links.values()].map(t=>this.cancel(t.name,e))]).then(e=>{this.roster.clear(),this.links.clear(),this.emit({type:`team-disposed`,teamId:this.id}),this.mailbox.length=0,this.mailboxBytes=0,this.waitEdges.clear(),this.onEvent=void 0,this.onAgentEvent=void 0;let t=e.find(e=>e.status===`rejected`);if(t!==void 0)throw new n(`A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,`TEAM_DISPOSE_TIMEOUT`,{cause:t.reason})});return this.disposeTask=S(t,this.disposeTimeoutMs,`A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,`TEAM_DISPOSE_TIMEOUT`),this.disposeTask}toolsFor(e,n=`full`){this.assertActive();let r=m(e),o=n===`full`;return Object.freeze([i({name:a.list,budgetExempt:!0,description:`List local and remote addressable agents, their protocols, supported delivery modes, and status.`,parameters:{type:`object`,properties:{},additionalProperties:!1},parse:e=>f(e,`list_agents`),execute:()=>s(this.members()),isConcurrencySafe:()=>!0}),i({name:a.send,budgetExempt:!0,description:`Send quiet context to another local agent from list_agents, other than yourself. This does not start a task or return its final result. Remote A2A peers require followup_task.`,parameters:g(`Message to add to the target context.`),parse:y,execute:async({target:e,message:t},n)=>s(await this.sendMessage({from:r,target:e,message:t,delivery:`quiet`,signal:n.signal}))}),...o?[i({name:a.followup,budgetExempt:!0,description:`Send active work to a local agent or interoperable remote A2A peer and wait for its accepted result.`,parameters:g(`Follow-up instruction the target must process.`),parse:y,execute:async({target:e,message:t},n)=>s(await this.followup(r,e,t,n.signal))})]:[],...o?[i({name:a.wait,budgetExempt:!0,description:`Wait until one of the selected local or remote agents finishes its scheduled work, then return their current roster state. Returns early with interrupted=true when the user sends you something while you wait, so read that before waiting again.`,parameters:{type:`object`,properties:{targets:{type:`array`,items:{type:`string`},minItems:1,description:`Exact agent names returned by list_agents.`},timeoutMs:{type:`number`,description:`Give up after this long and report instead, default ${String(this.waitTimeoutMs)}. Anything under ${String(this.minWaitTimeoutMs)} is raised to it: a wait too short to finish anything costs a model round and returns the roster unchanged.`}},required:[`targets`],additionalProperties:!1},parse:b,execute:async({targets:n,timeoutMs:i},a)=>{let o=this.beginWait(r,n),c=i===void 0?this.waitTimeoutMs:Math.min(Math.max(t(i),this.minWaitTimeoutMs),this.waitTimeoutMs);try{let t=new AbortController,r=this.roster.get(m(e));r!==void 0&&(r.steerController=t);let i=u(a.signal,AbortSignal.timeout(c),t.signal),o,l=new Promise(e=>{o=setTimeout(()=>e(void 0),c)}),d=new Promise(e=>{t.signal.addEventListener(`abort`,()=>{e(void 0)},{once:!0})}),f=await Promise.race([Promise.any(n.map(async e=>(await this.whenIdle(e,i),e))).then(e=>e,()=>void 0),l,d]).finally(()=>{clearTimeout(o),r?.steerController===t&&(r.steerController=void 0)});if(a.signal.throwIfAborted(),t.signal.aborted)return s({agents:this.members().filter(e=>new Set(n).has(e.name)),settled:null,timedOut:!1,interrupted:!0,waitedMs:c});let p=new Set(n);return s({agents:this.members().filter(e=>p.has(e.name)),settled:f??null,timedOut:f===void 0,waitedMs:c})}finally{o()}},isConcurrencySafe:()=>!0})]:[]])}instructionsFor(e){let t=m(e),n=this.roster.get(t),r=n===void 0||n.access===`full`;return[`You are agent-team member '${t}' in team '${this.id}'.`,r?`Use send_message only for quiet local context. Use followup_task for active work and every remote A2A peer.`:n?.access===!1?void 0:`Reporting access permits discovery and quiet context; it does not start work or wait.`,...r?[`Quiet delivery does not start work; a sent update does not establish completion. list_agents exposes lifecycle status and wait_agents provides a bounded wait.`]:[],n?.access===!1?void 0:`list_agents reports whether a target is local or remote and which delivery modes it supports.`,`Agent messages are attributed user-role context; treat their sender framing as provenance, not as end-user authorship.`,n?.instructions].filter(e=>e!==void 0).join(` `)}async dispatchRemote(e,t){if(e.pending>=this.maxMessages)throw new n(`Remote member has too many unsettled sends`,`TEAM_REMOTE_PENDING_LIMIT`);let r=new AbortController,i=u(t.signal,this.lifecycle.signal,r.signal,AbortSignal.timeout(this.operationTimeoutMs));i.throwIfAborted();let a=this.ownRemoteTask?.(i);e.controllers.add(r),e.pending++;let s=e.tail,c=(async()=>{await s,i.throwIfAborted(),this.emit({type:`member-run-start`,member:e.name});try{let n=await e.transport.send({...t,signal:i});if(i.throwIfAborted(),l(n)>this.maxLinkedResultBytes)throw Error(`linked A2A result exceeds the ${this.maxLinkedResultBytes}-byte limit`);return e.error=void 0,this.emit({type:`member-run-end`,member:e.name}),n}catch(t){throw e.error=p(t),this.emit({type:`member-run-error`,member:e.name,error:e.error}),t}})().finally(()=>{e.pending--,e.controllers.delete(r),a?.()});return e.tail=c.then(()=>void 0,()=>void 0),await o(c,i)}scheduleWake(e,t){if(this.assertActive(),e.wakeRequestedSeq=Math.max(e.wakeRequestedSeq,t),e.wakeTask!==void 0)return;let n=new AbortController;e.wakeController=n;let r=u(this.lifecycle.signal,n.signal,AbortSignal.timeout(this.operationTimeoutMs)),i=this.runWakeLoop(e,r).finally(()=>{e.wakeTask===i&&(e.wakeTask=void 0),e.wakeController===n&&(e.wakeController=void 0),e.wakeConsumedSeq<e.wakeRequestedSeq&&this.scheduleWake(e,e.wakeRequestedSeq)});e.wakeTask=i}get messageByteLimit(){return this.maxMessageBytes}async runWakeLoop(e,t){let n=!1;try{for(;e.wakeConsumedSeq<e.wakeRequestedSeq;){t.throwIfAborted(),await e.session.whenIdle(t);let r=e.wakeRequestedSeq;this.emit({type:`member-run-start`,member:e.name});try{let i=await e.session.runPending({signal:t,onEvent:t=>this.observeAgentEvent(e.name,t)});if(t.aborted){e.wakeConsumedSeq=r,this.emit({type:`member-run-cancelled`,member:e.name}),n=!0;continue}e.error=void 0;let a=T(i);e.error=a,e.outcome=a===void 0?{kind:`completed`,text:w(i)}:{kind:`failed`,message:a,...w(i)===``?{}:{text:w(i)}},e.wakeConsumedSeq=r,a===void 0?this.emit({type:`member-run-end`,member:e.name}):this.emit({type:`member-run-error`,member:e.name,error:a})}catch(i){if(t.aborted){e.error=void 0,e.wakeConsumedSeq=r,this.emit({type:`member-run-cancelled`,member:e.name}),n=!0;continue}if(e.session.isRunning)continue;e.error=p(i),e.outcome={kind:`failed`,message:e.error},e.wakeConsumedSeq=r,this.emit({type:`member-run-error`,member:e.name,error:e.error})}}}catch(r){if(!t.aborted)throw r;e.error=void 0,e.wakeConsumedSeq=e.wakeRequestedSeq,n||this.emit({type:`member-run-cancelled`,member:e.name})}}requireLocalMember(e){let t=m(e),n=this.roster.get(t);if(n===void 0)throw Error(`unknown local A2A member '${t}'`);return n}beginWait(e,t){for(let r of t)if(this.requireAddress(r),r===e||this.hasWaitPath(r,e,new Set))throw new n(`wait_agents would create a coordination cycle`,`TEAM_WAIT_CYCLE`);let r=this.waitEdges.get(e);r===void 0&&(r=new Map,this.waitEdges.set(e,r));for(let e of t)r.set(e,(r.get(e)??0)+1);let i=!0;return()=>{if(!i)return;i=!1;let n=this.waitEdges.get(e);if(n!==void 0){for(let e of t){let t=n.get(e)??0;t<=1?n.delete(e):n.set(e,t-1)}n.size===0&&this.waitEdges.delete(e)}}}hasWaitPath(e,t,n){if(e===t)return!0;if(n.has(e))return!1;n.add(e);for(let r of this.waitEdges.get(e)?.keys()??[])if(this.hasWaitPath(r,t,n))return!0;return!1}requireAddress(e){let t=m(e),n=this.roster.get(t)??this.links.get(t);if(n===void 0)throw Error(`unknown A2A member '${t}'`);return n}assertAddressAvailable(e){if(this.roster.has(e)||this.links.has(e))throw Error(`A2A member '${e}' is already attached or linked`)}assertCapacity(){if(this.roster.size+this.links.size>=this.maxMembers)throw Error(`A2A team '${this.id}' reached its ${this.maxMembers}-member limit`)}assertActive(){if(this.disposed)throw Error(`A2A team '${this.id}' is disposed`)}reserveMailbox(e){if(this.mailbox.length+this.pendingMessages>=this.maxMessages)throw Error(`A2A team '${this.id}' reached its ${this.maxMessages}-message mailbox limit`);if(this.mailboxBytes+this.pendingMailboxBytes+e>this.maxMailboxBytes)throw Error(`A2A team '${this.id}' reached its ${this.maxMailboxBytes}-byte mailbox limit`);this.pendingMessages++,this.pendingMailboxBytes+=e;let t=!1;return()=>{t||(t=!0,this.pendingMessages--,this.pendingMailboxBytes-=e)}}recordOutcome(e,t){let n=this.requireLocalMember(e);n.outcome=t,n.error=t.kind===`failed`?t.message:void 0}markPending(e,t){this.requireLocalMember(e).pendingStart=t}view(e){return e.kind===`remote`?Object.freeze({name:e.name,agentId:e.transport.agentId,kind:`remote`,role:e.role,status:e.error===void 0?e.pending>0?`running`:`idle`:`failed`,protocol:e.transport.protocol,deliveries:Object.freeze([`wakeup`]),...e.description===void 0?{}:{description:e.description},...e.error===void 0?{}:{error:e.error}}):Object.freeze({name:e.name,agentId:e.session.definition.id,kind:`local`,conversationId:e.session.conversationId,role:e.role,status:e.error===void 0?e.pendingStart===void 0?e.session.isRunning||e.wakeTask!==void 0?`running`:`idle`:`pending`:`failed`,protocol:`in-process`,deliveries:Object.freeze([`quiet`,`wakeup`]),...e.description===void 0?{}:{description:e.description},...e.error===void 0?{}:{error:e.error},...e.outcome===void 0?{}:{outcome:e.outcome}})}emit(e){try{this.onEvent?.(e)}catch{}}async observeAgentEvent(t,n){if(this.onAgentEvent===void 0)return;let r=Promise.resolve().then(()=>this.onAgentEvent?.(t,n));await e(r,this.observerTimeoutMs)}};function w(e){let t=e?.text;return typeof t==`string`?t:``}function T(e){if(typeof e!=`object`||!e)return;let t=e,n=t.outcome?.reason??t.stopReason;if(t.outcome?.completed===!1||t.completed===!1||n?.kind===`error`||n?.kind===`max-tokens`||n?.kind===`aborted`||n?.kind===`usage-unavailable`){let e=t.outcome?.reason?.failure?.message;return typeof e==`string`?e:`member run did not complete (${String(n?.kind??`unknown`)})`}}export{C as AgentTeam};
+import{waitForSettlement as e}from"../../async/settlement.js";import{timeoutValue as t}from"../../platform/config.js";import{AgentSdkError as n}from"../../errors/agent-sdk-error.js";import{createUserMessage as r}from"../../message/message.js";import{defineTool as i}from"../tool/definition.js";import{isManagedTeamNoticeRequest as a}from"../history/input-work.js";import{TEAM_TOOL_NAMES as o,abortable as s,asJson as c,boundedString as l,byteLength as u,combineSignals as d,deepCloneFreeze as f,emptyObject as p,errorMessage as m,memberName as h,messageContent as g,messageToolSchema as _,newMessageId as v,newTeamId as y,parseMessageTool as b,parseWaitTool as x,positiveInteger as S,withTimeout as C}from"./common.js";var w=class{ownRemoteTask;id;maxMembers;maxMessageBytes;maxLinkedResultBytes;maxMessages;maxMailboxBytes;maxMetadataBytes;disposeTimeoutMs;operationTimeoutMs;observerTimeoutMs;waitTimeoutMs;minWaitTimeoutMs;onEvent;onAgentEvent;roster=new Map;links=new Map;mailbox=[];mailboxBytes=0;pendingMessages=0;pendingMailboxBytes=0;lifecycle=new AbortController;waitEdges=new Map;disposed=!1;disposeTask;constructor(e={},n){this.ownRemoteTask=n,this.id=l(e.id??y(),`team id`,1024),this.maxMembers=S(e.maxMembers??8,`maxMembers`),this.maxMessageBytes=S(e.maxMessageBytes??65536,`maxMessageBytes`),this.maxLinkedResultBytes=S(e.maxLinkedResultBytes??1048576,`maxLinkedResultBytes`),this.maxMessages=S(e.maxMessages??1e4,`maxMessages`),this.maxMailboxBytes=S(e.maxMailboxBytes??67108864,`maxMailboxBytes`),this.maxMetadataBytes=S(e.maxMetadataBytes??8192,`maxMetadataBytes`),this.disposeTimeoutMs=t(e.disposeTimeoutMs??3e4),this.operationTimeoutMs=t(e.operationTimeoutMs??6e5),this.observerTimeoutMs=t(e.observerTimeoutMs??1e3),this.waitTimeoutMs=t(e.waitTimeoutMs??3e4),this.minWaitTimeoutMs=Math.min(t(e.minWaitTimeoutMs??5e3),this.waitTimeoutMs),this.onEvent=e.onEvent,this.onAgentEvent=e.onAgentEvent}attach(e,t={}){this.assertActive();let n=h(t.name??e.definition.id);this.assertAddressAvailable(n),this.assertCapacity();let r=t.role??(this.roster.size===0?`lead`:`peer`);if(r===`lead`&&[...this.roster.values()].some(e=>e.role===`lead`))throw Error(`A2A team '${this.id}' already has a lead`);let i={kind:`local`,name:n,role:r,access:t.tools===!1?!1:t.tools===`reporting`?`reporting`:`full`,session:e,wakeRequestedSeq:0,wakeConsumedSeq:0,wakeTask:void 0,wakeController:void 0,error:void 0,outcome:void 0,pendingStart:void 0,steerController:void 0,...t.description===void 0?{}:{description:l(t.description,`member description`,this.maxMetadataBytes)},...t.instructions===void 0?{}:{instructions:l(t.instructions,`member instructions`,this.maxMetadataBytes)}};this.roster.set(n,i),this.emit({type:`member-attached`,member:this.view(i)})}linkAgent(e){this.assertActive();let t=h(e.name);if(this.assertAddressAvailable(t),this.assertCapacity(),typeof e.transport?.send!=`function`)throw TypeError(`linked agent transport must implement send()`);let n={kind:`remote`,name:t,role:`peer`,transport:e.transport,tail:Promise.resolve(),pending:0,controllers:new Set,error:void 0,...e.description===void 0?{}:{description:l(e.description,`linked agent description`,this.maxMetadataBytes)}};return this.links.set(t,n),this.emit({type:`member-linked`,member:this.view(n)}),()=>{if(this.links.get(t)===n){if(n.pending>0)throw Error(`cannot unlink running A2A member '${t}'`);this.links.delete(t)}}}detach(e){this.assertActive();let t=this.requireLocalMember(e);if(t.session.isRunning||t.wakeTask!==void 0)throw Error(`cannot detach running A2A member '${t.name}'`);this.roster.delete(t.name)}members(){return Object.freeze([...this.roster.values(),...this.links.values()].map(e=>this.view(e)))}messages(){return f(this.mailbox)}async sendMessage(e){this.assertActive(),e.signal?.throwIfAborted();let t=this.requireLocalMember(e.from),n=this.requireAddress(e.target);if(n.kind===`local`&&t===n)throw Error(`an A2A member cannot message itself`);let i=e.delivery??`quiet`;if(i!==`quiet`&&i!==`wakeup`)throw TypeError(`A2A delivery must be 'quiet' or 'wakeup'`);if(n.kind===`remote`&&i===`quiet`)throw Error(`remote A2A member '${n.name}' cannot accept quiet injection; use followup_task or delivery 'wakeup'`);let o=v(),s=g(e.message,this.maxMessageBytes),c=f([{type:`text`,text:`A2A message ${o} from ${t.name}:`},...s]),l=u(c);if(l>this.maxMessageBytes)throw Error(`A2A message exceeds the ${this.maxMessageBytes}-byte limit`);let d=n.kind===`remote`?l+this.maxLinkedResultBytes:l,p=this.reserveMailbox(d),m;try{if(n.kind===`local`){let s=r({source:a(e)?{kind:`app`,producer:`managed-team`}:{kind:`agent-message`,teamId:this.id,messageId:o,sender:t.name,senderAgentId:t.session.definition.id},content:c}),l=n.session.inject(s);i===`wakeup`&&this.scheduleWake(n,l)}else m=await this.dispatchRemote(n,{teamId:this.id,messageId:o,sender:t.name,senderAgentId:t.session.definition.id,content:c,...e.signal===void 0?{}:{signal:e.signal}});let s=f({id:o,teamId:this.id,sender:t.name,senderAgentId:t.session.definition.id,target:n.name,targetAgentId:n.kind===`local`?n.session.definition.id:n.transport.agentId,delivery:i,content:c,status:`accepted`,createdAt:new Date().toISOString(),...m===void 0?{}:{result:m}}),d=l+(m===void 0?0:u(m));return this.mailbox.push(s),this.mailboxBytes+=d,this.emit({type:`message-accepted`,message:f(s)}),f({messageId:o,status:`accepted`,delivery:i,target:n.name,...m===void 0?{}:{result:m}})}finally{p()}}followup(e,t,n,r){return this.sendMessage({from:e,target:t,message:n,delivery:`wakeup`,...r===void 0?{}:{signal:r}})}async whenIdle(e,t){let n=this.requireAddress(e);if(n.kind===`remote`){for(;;){let e=n.tail;if(await s(e,t),e===n.tail&&n.pending===0)break}return}for(;;){let e=n.wakeRequestedSeq,r=n.wakeTask,i=n.pendingStart;if(i!==void 0&&await s(i,t),r!==void 0&&await s(r,t),await n.session.whenIdle(t),n.wakeTask===void 0&&!n.session.isRunning&&n.pendingStart===void 0&&n.wakeConsumedSeq>=n.wakeRequestedSeq&&e===n.wakeRequestedSeq)return}}notifySteer(e){let t=this.requireLocalMember(e),n=t.steerController;t.steerController=void 0,n?.abort(Error(`user input steered into the active turn`))}wake(e){let t=this.requireLocalMember(e);this.scheduleWake(t,t.wakeRequestedSeq+1)}async cancel(e,t=Error(`A2A member work cancelled`)){let n=this.requireAddress(e);if(n.kind===`remote`){for(let e of n.controllers)e.abort(t);await C(n.tail,this.disposeTimeoutMs,`A2A member '${n.name}' did not cancel within ${this.disposeTimeoutMs}ms`,`TEAM_CANCELLATION_TIMEOUT`);return}n.wakeConsumedSeq=n.wakeRequestedSeq;let r=n.wakeController,i=n.wakeTask;r?.abort(t),i!==void 0&&await C(i,this.disposeTimeoutMs,`A2A member '${n.name}' did not cancel within ${this.disposeTimeoutMs}ms`,`TEAM_CANCELLATION_TIMEOUT`)}dispose(e=Error(`A2A team disposed`)){if(this.disposeTask!==void 0)return this.disposeTask;this.disposed=!0,this.lifecycle.abort(e);let t=Promise.allSettled([...[...this.roster.values()].map(t=>this.cancel(t.name,e)),...[...this.links.values()].map(t=>this.cancel(t.name,e))]).then(e=>{this.roster.clear(),this.links.clear(),this.emit({type:`team-disposed`,teamId:this.id}),this.mailbox.length=0,this.mailboxBytes=0,this.waitEdges.clear(),this.onEvent=void 0,this.onAgentEvent=void 0;let t=e.find(e=>e.status===`rejected`);if(t!==void 0)throw new n(`A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,`TEAM_DISPOSE_TIMEOUT`,{cause:t.reason})});return this.disposeTask=C(t,this.disposeTimeoutMs,`A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,`TEAM_DISPOSE_TIMEOUT`),this.disposeTask}toolsFor(e,n=`full`){this.assertActive();let r=h(e),a=n===`full`;return Object.freeze([i({name:o.list,budgetExempt:!0,description:`List local and remote addressable agents, their protocols, supported delivery modes, and status.`,parameters:{type:`object`,properties:{},additionalProperties:!1},parse:e=>p(e,`list_agents`),execute:()=>c(this.members()),isConcurrencySafe:()=>!0}),i({name:o.send,budgetExempt:!0,description:`Send quiet context to another local agent from list_agents, other than yourself. This does not start a task or return its final result. Remote A2A peers require followup_task.`,parameters:_(`Message to add to the target context.`),parse:b,execute:async({target:e,message:t},n)=>c(await this.sendMessage({from:r,target:e,message:t,delivery:`quiet`,signal:n.signal}))}),...a?[i({name:o.followup,budgetExempt:!0,description:`Send active work to a local agent or interoperable remote A2A peer and wait for its accepted result.`,parameters:_(`Follow-up instruction the target must process.`),parse:b,execute:async({target:e,message:t},n)=>c(await this.followup(r,e,t,n.signal))})]:[],...a?[i({name:o.wait,budgetExempt:!0,description:`Wait until one of the selected local or remote agents finishes its scheduled work, then return their current roster state. Returns early with interrupted=true when the user sends you something while you wait, so read that before waiting again.`,parameters:{type:`object`,properties:{targets:{type:`array`,items:{type:`string`},minItems:1,description:`Exact agent names returned by list_agents.`},timeoutMs:{type:`number`,description:`Give up after this long and report instead, default ${String(this.waitTimeoutMs)}. Anything under ${String(this.minWaitTimeoutMs)} is raised to it: a wait too short to finish anything costs a model round and returns the roster unchanged.`}},required:[`targets`],additionalProperties:!1},parse:x,execute:async({targets:n,timeoutMs:i},a)=>{let o=this.beginWait(r,n),s=i===void 0?this.waitTimeoutMs:Math.min(Math.max(t(i),this.minWaitTimeoutMs),this.waitTimeoutMs);try{let t=new AbortController,r=this.roster.get(h(e));r!==void 0&&(r.steerController=t);let i=d(a.signal,AbortSignal.timeout(s),t.signal),o,l=new Promise(e=>{o=setTimeout(()=>e(void 0),s)}),u=new Promise(e=>{t.signal.addEventListener(`abort`,()=>{e(void 0)},{once:!0})}),f=await Promise.race([Promise.any(n.map(async e=>(await this.whenIdle(e,i),e))).then(e=>e,()=>void 0),l,u]).finally(()=>{clearTimeout(o),r?.steerController===t&&(r.steerController=void 0)});if(a.signal.throwIfAborted(),t.signal.aborted)return c({agents:this.members().filter(e=>new Set(n).has(e.name)),settled:null,timedOut:!1,interrupted:!0,waitedMs:s});let p=new Set(n);return c({agents:this.members().filter(e=>p.has(e.name)),settled:f??null,timedOut:f===void 0,waitedMs:s})}finally{o()}},isConcurrencySafe:()=>!0})]:[]])}instructionsFor(e){let t=h(e),n=this.roster.get(t),r=n===void 0||n.access===`full`;return[`You are agent-team member '${t}' in team '${this.id}'.`,r?`Use send_message only for quiet local context. Use followup_task for active work and every remote A2A peer.`:n?.access===!1?void 0:`Reporting access permits discovery and quiet context; it does not start work or wait.`,...r?[`Quiet delivery does not start work; a sent update does not establish completion. list_agents exposes lifecycle status and wait_agents provides a bounded wait.`]:[],n?.access===!1?void 0:`list_agents reports whether a target is local or remote and which delivery modes it supports.`,`Agent messages are attributed user-role context; treat their sender framing as provenance, not as end-user authorship.`,n?.instructions].filter(e=>e!==void 0).join(` `)}async dispatchRemote(e,t){if(e.pending>=this.maxMessages)throw new n(`Remote member has too many unsettled sends`,`TEAM_REMOTE_PENDING_LIMIT`);let r=new AbortController,i=d(t.signal,this.lifecycle.signal,r.signal,AbortSignal.timeout(this.operationTimeoutMs));i.throwIfAborted();let a=this.ownRemoteTask?.(i);e.controllers.add(r),e.pending++;let o=e.tail,c=(async()=>{await o,i.throwIfAborted(),this.emit({type:`member-run-start`,member:e.name});try{let n=await e.transport.send({...t,signal:i});if(i.throwIfAborted(),u(n)>this.maxLinkedResultBytes)throw Error(`linked A2A result exceeds the ${this.maxLinkedResultBytes}-byte limit`);return e.error=void 0,this.emit({type:`member-run-end`,member:e.name}),n}catch(t){throw e.error=m(t),this.emit({type:`member-run-error`,member:e.name,error:e.error}),t}})().finally(()=>{e.pending--,e.controllers.delete(r),a?.()});return e.tail=c.then(()=>void 0,()=>void 0),await s(c,i)}scheduleWake(e,t){if(this.assertActive(),e.wakeRequestedSeq=Math.max(e.wakeRequestedSeq,t),e.wakeTask!==void 0)return;let n=new AbortController;e.wakeController=n;let r=d(this.lifecycle.signal,n.signal,AbortSignal.timeout(this.operationTimeoutMs)),i=this.runWakeLoop(e,r).finally(()=>{e.wakeTask===i&&(e.wakeTask=void 0),e.wakeController===n&&(e.wakeController=void 0),e.wakeConsumedSeq<e.wakeRequestedSeq&&this.scheduleWake(e,e.wakeRequestedSeq)});e.wakeTask=i}get messageByteLimit(){return this.maxMessageBytes}async runWakeLoop(e,t){let n=!1;try{for(;e.wakeConsumedSeq<e.wakeRequestedSeq;){t.throwIfAborted(),await e.session.whenIdle(t);let r=e.wakeRequestedSeq;if(e.session.hasUnansweredInput?.()===!1){let t=e.session.lastOutcome?.();if(t!==void 0){let n=E(t);e.error=n,e.outcome=n===void 0?{kind:`completed`,text:t.text}:{kind:`failed`,message:n,...t.text===``?{}:{text:t.text}}}e.wakeConsumedSeq=r;continue}this.emit({type:`member-run-start`,member:e.name});try{let i=await e.session.runPending({signal:t,onEvent:t=>this.observeAgentEvent(e.name,t)});if(t.aborted){e.wakeConsumedSeq=r,this.emit({type:`member-run-cancelled`,member:e.name}),n=!0;continue}e.error=void 0;let a=E(i);e.error=a,e.outcome=a===void 0?{kind:`completed`,text:T(i)}:{kind:`failed`,message:a,...T(i)===``?{}:{text:T(i)}},e.wakeConsumedSeq=r,a===void 0?this.emit({type:`member-run-end`,member:e.name}):this.emit({type:`member-run-error`,member:e.name,error:a})}catch(i){if(t.aborted){e.error=void 0,e.wakeConsumedSeq=r,this.emit({type:`member-run-cancelled`,member:e.name}),n=!0;continue}if(e.session.isRunning)continue;e.error=m(i),e.outcome={kind:`failed`,message:e.error},e.wakeConsumedSeq=r,this.emit({type:`member-run-error`,member:e.name,error:e.error})}}}catch(r){if(!t.aborted)throw r;e.error=void 0,e.wakeConsumedSeq=e.wakeRequestedSeq,n||this.emit({type:`member-run-cancelled`,member:e.name})}}requireLocalMember(e){let t=h(e),n=this.roster.get(t);if(n===void 0)throw Error(`unknown local A2A member '${t}'`);return n}beginWait(e,t){for(let r of t)if(this.requireAddress(r),r===e||this.hasWaitPath(r,e,new Set))throw new n(`wait_agents would create a coordination cycle`,`TEAM_WAIT_CYCLE`);let r=this.waitEdges.get(e);r===void 0&&(r=new Map,this.waitEdges.set(e,r));for(let e of t)r.set(e,(r.get(e)??0)+1);let i=!0;return()=>{if(!i)return;i=!1;let n=this.waitEdges.get(e);if(n!==void 0){for(let e of t){let t=n.get(e)??0;t<=1?n.delete(e):n.set(e,t-1)}n.size===0&&this.waitEdges.delete(e)}}}hasWaitPath(e,t,n){if(e===t)return!0;if(n.has(e))return!1;n.add(e);for(let r of this.waitEdges.get(e)?.keys()??[])if(this.hasWaitPath(r,t,n))return!0;return!1}requireAddress(e){let t=h(e),n=this.roster.get(t)??this.links.get(t);if(n===void 0)throw Error(`unknown A2A member '${t}'`);return n}assertAddressAvailable(e){if(this.roster.has(e)||this.links.has(e))throw Error(`A2A member '${e}' is already attached or linked`)}assertCapacity(){if(this.roster.size+this.links.size>=this.maxMembers)throw Error(`A2A team '${this.id}' reached its ${this.maxMembers}-member limit`)}assertActive(){if(this.disposed)throw Error(`A2A team '${this.id}' is disposed`)}reserveMailbox(e){if(this.mailbox.length+this.pendingMessages>=this.maxMessages)throw Error(`A2A team '${this.id}' reached its ${this.maxMessages}-message mailbox limit`);if(this.mailboxBytes+this.pendingMailboxBytes+e>this.maxMailboxBytes)throw Error(`A2A team '${this.id}' reached its ${this.maxMailboxBytes}-byte mailbox limit`);this.pendingMessages++,this.pendingMailboxBytes+=e;let t=!1;return()=>{t||(t=!0,this.pendingMessages--,this.pendingMailboxBytes-=e)}}recordOutcome(e,t){let n=this.requireLocalMember(e);n.outcome=t,n.error=t.kind===`failed`?t.message:void 0}markPending(e,t){this.requireLocalMember(e).pendingStart=t}view(e){return e.kind===`remote`?Object.freeze({name:e.name,agentId:e.transport.agentId,kind:`remote`,role:e.role,status:e.error===void 0?e.pending>0?`running`:`idle`:`failed`,protocol:e.transport.protocol,deliveries:Object.freeze([`wakeup`]),...e.description===void 0?{}:{description:e.description},...e.error===void 0?{}:{error:e.error}}):Object.freeze({name:e.name,agentId:e.session.definition.id,kind:`local`,conversationId:e.session.conversationId,role:e.role,status:e.error===void 0?e.pendingStart===void 0?e.session.isRunning||e.wakeTask!==void 0?`running`:`idle`:`pending`:`failed`,protocol:`in-process`,deliveries:Object.freeze([`quiet`,`wakeup`]),...e.description===void 0?{}:{description:e.description},...e.error===void 0?{}:{error:e.error},...e.outcome===void 0?{}:{outcome:e.outcome}})}emit(e){try{this.onEvent?.(e)}catch{}}async observeAgentEvent(t,n){if(n.type===`agent-end`){let e=this.roster.get(t);if(e!==void 0){let t=E(n.outcome);e.error=t,e.outcome=t===void 0?{kind:`completed`,text:n.outcome.text}:{kind:`failed`,message:t,...n.outcome.text===``?{}:{text:n.outcome.text}}}}if(this.onAgentEvent===void 0)return;let r=Promise.resolve().then(()=>this.onAgentEvent?.(t,n));await e(r,this.observerTimeoutMs)}};function T(e){let t=e?.text;return typeof t==`string`?t:``}function E(e){if(typeof e!=`object`||!e)return;let t=e,n=t.outcome?.reason??t.stopReason;if(t.outcome?.completed===!1||t.completed===!1||n?.kind===`error`||n?.kind===`max-tokens`||n?.kind===`aborted`||n?.kind===`usage-unavailable`){let e=t.outcome?.reason?.failure?.message;return typeof e==`string`?e:`member run did not complete (${String(n?.kind??`unknown`)})`}}export{w as AgentTeam};
 //# sourceMappingURL=team.js.map

package/dist/agent/team/team.js.map

@@ -1 +1 @@
-{"version":3,"file":"team.js","names":[],"sources":["../../../src/agent/team/team.ts"],"sourcesContent":["import type { AgentRunEvent } from '../mode/run-agent.ts'\nimport { defineTool, type ToolDefinition } from '../tool/definition.ts'\nimport type { ContentBlock } from '../../message/index.ts'\nimport { createUserMessage } from '../../message/index.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { AgentSdkError } from '../../errors/index.ts'\nimport { timeoutValue } from '../../platform/config.ts'\nimport type {\n  TeamMemberAttachmentOptions, TeamPort, TeamSessionPort, TeamToolAccess,\n} from './contracts.ts'\nimport type {\n  AgentMemberOutcome, AgentMessageRecord, AgentTeamEvent, AgentTeamMember, AgentTeamOptions,\n  LinkAgentOptions, LinkedAgentResult, SendAgentMessageRequest, SendAgentMessageResult,\n} from './types.ts'\nimport {\n  messageToolSchema, parseMessageTool, parseWaitTool, emptyObject, messageContent, memberName,\n  boundedString, positiveInteger, byteLength, errorMessage, asJson, deepCloneFreeze, newTeamId,\n  newMessageId, abortable, combineSignals, withTimeout, TEAM_TOOL_NAMES,\n  DEFAULT_MIN_WAIT_TIMEOUT_MS,\n  DEFAULT_WAIT_TIMEOUT_MS,\n} from './common.ts'\n\n/** Shared control plane for local sessions and interoperable remote A2A peers. */\n\ninterface LocalMemberRuntime {\n  readonly kind: 'local'\n  readonly name: string\n  readonly description?: string\n  readonly instructions?: string\n  readonly role: 'lead' | 'peer'\n  /** Which team verbs it was attached with; shapes its routing guidance. */\n  readonly access: TeamToolAccess | false\n  readonly session: TeamSessionPort\n  wakeRequestedSeq: number\n  wakeConsumedSeq: number\n  wakeTask: Promise<void> | undefined\n  wakeController: AbortController | undefined\n  error: string | undefined\n  /** How its last run ended, for a coordinator that did not await the run. */\n  outcome: AgentMemberOutcome | undefined\n  /**\n   * Set while the host is holding this member back, and resolved when it lets\n   * it start. See {@link AgentTeam.markPending}.\n   */\n  pendingStart: Promise<void> | undefined\n  /**\n   * Aborted when the user steers something into this member mid-turn.\n   *\n   * A member parked in `wait_agents` is not listening to its own conversation:\n   * the wait is bounded by its own budget, so a correction typed while it waits\n   * sits unread for as long as that budget lasts. Codex's `wait_agent` \"ends\n   * early when new user input is steered into the active turn\" for the same\n   * reason. Replaced after each notification, so one interruption ends one\n   * wait.\n   */\n  steerController: AbortController | undefined\n}\n\ninterface RemoteMemberRuntime {\n  readonly kind: 'remote'\n  readonly name: string\n  readonly description?: string\n  readonly role: 'peer'\n  readonly transport: LinkAgentOptions['transport']\n  tail: Promise<void>\n  pending: number\n  readonly controllers: Set<AbortController>\n  error: string | undefined\n}\n\ntype AddressableMember = LocalMemberRuntime | RemoteMemberRuntime\n\n\n/**\n * Connect long-lived local AgentSessions and remote protocol peers behind one\n * roster and one model-facing messaging surface.\n */\nexport class AgentTeam implements TeamPort {\n  readonly id: string\n  private readonly maxMembers: number\n  private readonly maxMessageBytes: number\n  private readonly maxLinkedResultBytes: number\n  private readonly maxMessages: number\n  private readonly maxMailboxBytes: number\n  private readonly maxMetadataBytes: number\n  private readonly disposeTimeoutMs: number\n  private readonly operationTimeoutMs: number\n  private readonly observerTimeoutMs: number\n  private readonly waitTimeoutMs: number\n  private readonly minWaitTimeoutMs: number\n  private onEvent: ((event: AgentTeamEvent) => void) | undefined\n  private onAgentEvent: AgentTeamOptions['onAgentEvent']\n  private readonly roster = new Map<string, LocalMemberRuntime>()\n  private readonly links = new Map<string, RemoteMemberRuntime>()\n  private readonly mailbox: AgentMessageRecord[] = []\n  private mailboxBytes = 0\n  private pendingMessages = 0\n  private pendingMailboxBytes = 0\n  private readonly lifecycle = new AbortController()\n  private readonly waitEdges = new Map<string, Map<string, number>>()\n  private disposed = false\n  private disposeTask: Promise<void> | undefined\n\n  constructor(\n    options: AgentTeamOptions = {},\n    private readonly ownRemoteTask?: (signal: AbortSignal) => () => void,\n  ) {\n    this.id = boundedString(options.id ?? newTeamId(), 'team id', 1024)\n    this.maxMembers = positiveInteger(options.maxMembers ?? 8, 'maxMembers')\n    this.maxMessageBytes = positiveInteger(options.maxMessageBytes ?? 64 * 1024, 'maxMessageBytes')\n    this.maxLinkedResultBytes = positiveInteger(\n      options.maxLinkedResultBytes ?? 1024 * 1024,\n      'maxLinkedResultBytes',\n    )\n    this.maxMessages = positiveInteger(options.maxMessages ?? 10_000, 'maxMessages')\n    this.maxMailboxBytes = positiveInteger(options.maxMailboxBytes ?? 64 * 1024 * 1024, 'maxMailboxBytes')\n    this.maxMetadataBytes = positiveInteger(options.maxMetadataBytes ?? 8 * 1024, 'maxMetadataBytes')\n    this.disposeTimeoutMs = timeoutValue(options.disposeTimeoutMs ?? 30_000)\n    this.operationTimeoutMs = timeoutValue(options.operationTimeoutMs ?? 10 * 60_000)\n    this.observerTimeoutMs = timeoutValue(options.observerTimeoutMs ?? 1_000)\n    this.waitTimeoutMs = timeoutValue(options.waitTimeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS)\n    // A floor above the ceiling would clamp every call up to a budget the host\n    // said was too long; the host's own maximum wins.\n    this.minWaitTimeoutMs = Math.min(\n      timeoutValue(options.minWaitTimeoutMs ?? DEFAULT_MIN_WAIT_TIMEOUT_MS),\n      this.waitTimeoutMs,\n    )\n    this.onEvent = options.onEvent\n    this.onAgentEvent = options.onAgentEvent\n  }\n\n  /** Called by AgentSession after its tool catalog is assembled. */\n  attach(session: TeamSessionPort, options: TeamMemberAttachmentOptions = {}): void {\n    this.assertActive()\n    const name = memberName(options.name ?? session.definition.id)\n    this.assertAddressAvailable(name)\n    this.assertCapacity()\n    const role = options.role ?? (this.roster.size === 0 ? 'lead' : 'peer')\n    if (role === 'lead' && [...this.roster.values()].some(member => member.role === 'lead')) {\n      throw new Error(`A2A team '${this.id}' already has a lead`)\n    }\n    const access: TeamToolAccess | false = options.tools === false ? false : options.tools === 'reporting' ? 'reporting' : 'full'\n    const member: LocalMemberRuntime = {\n      kind: 'local', name, role, access, session,\n      wakeRequestedSeq: 0, wakeConsumedSeq: 0,\n      wakeTask: undefined, wakeController: undefined, error: undefined, outcome: undefined,\n      pendingStart: undefined, steerController: undefined,\n      ...(options.description === undefined ? {} : {\n        description: boundedString(options.description, 'member description', this.maxMetadataBytes),\n      }),\n      ...(options.instructions === undefined ? {} : {\n        instructions: boundedString(options.instructions, 'member instructions', this.maxMetadataBytes),\n      }),\n    }\n    this.roster.set(name, member)\n    this.emit({ type: 'member-attached', member: this.view(member) })\n  }\n\n  /** Link one remote transport, including an official A2A protocol client. */\n  linkAgent(options: LinkAgentOptions): () => void {\n    this.assertActive()\n    const name = memberName(options.name)\n    this.assertAddressAvailable(name)\n    this.assertCapacity()\n    if (typeof options.transport?.send !== 'function') {\n      throw new TypeError('linked agent transport must implement send()')\n    }\n    const member: RemoteMemberRuntime = {\n      kind: 'remote', name, role: 'peer', transport: options.transport,\n      tail: Promise.resolve(), pending: 0, controllers: new Set(), error: undefined,\n      ...(options.description === undefined ? {} : {\n        description: boundedString(options.description, 'linked agent description', this.maxMetadataBytes),\n      }),\n    }\n    this.links.set(name, member)\n    this.emit({ type: 'member-linked', member: this.view(member) })\n    return () => {\n      if (this.links.get(name) !== member) return\n      if (member.pending > 0) throw new Error(`cannot unlink running A2A member '${name}'`)\n      this.links.delete(name)\n    }\n  }\n\n  /** Remove exactly one idle local session registration. */\n  detach(name: string): void {\n    this.assertActive()\n    const member = this.requireLocalMember(name)\n    if (member.session.isRunning || member.wakeTask !== undefined) {\n      throw new Error(`cannot detach running A2A member '${member.name}'`)\n    }\n    this.roster.delete(member.name)\n  }\n\n  /** Current detached roster: local members first, then remote links. */\n  members(): readonly AgentTeamMember[] {\n    return Object.freeze([\n      ...this.roster.values(),\n      ...this.links.values(),\n    ].map(member => this.view(member)))\n  }\n\n  /** Immutable audit log. Local target history remains its resumable receipt. */\n  messages(): readonly AgentMessageRecord[] {\n    return deepCloneFreeze(this.mailbox)\n  }\n\n  /** Deliver to a local mailbox or dispatch through a linked remote transport. */\n  async sendMessage(request: SendAgentMessageRequest): Promise<SendAgentMessageResult> {\n    this.assertActive()\n    request.signal?.throwIfAborted()\n    const sender = this.requireLocalMember(request.from)\n    const target = this.requireAddress(request.target)\n    if (target.kind === 'local' && sender === target) throw new Error('an A2A member cannot message itself')\n    const delivery = request.delivery ?? 'quiet'\n    if (delivery !== 'quiet' && delivery !== 'wakeup') {\n      throw new TypeError(\"A2A delivery must be 'quiet' or 'wakeup'\")\n    }\n    if (target.kind === 'remote' && delivery === 'quiet') {\n      throw new Error(\n        `remote A2A member '${target.name}' cannot accept quiet injection; use followup_task or delivery 'wakeup'`,\n      )\n    }\n    const id = newMessageId()\n    const content = messageContent(request.message, this.maxMessageBytes)\n    const framed = deepCloneFreeze([\n      { type: 'text' as const, text: `A2A message ${id} from ${sender.name}:` },\n      ...content,\n    ])\n    const contentBytes = byteLength(framed)\n    if (contentBytes > this.maxMessageBytes) {\n      throw new Error(`A2A message exceeds the ${this.maxMessageBytes}-byte limit`)\n    }\n    const reservedBytes = target.kind === 'remote'\n      ? contentBytes + this.maxLinkedResultBytes\n      : contentBytes\n    const releaseReservation = this.reserveMailbox(reservedBytes)\n\n    let result: LinkedAgentResult | undefined\n    try {\n      if (target.kind === 'local') {\n        const message = createUserMessage({\n          source: {\n            kind: 'agent-message' as const,\n            teamId: this.id, messageId: id, sender: sender.name,\n            senderAgentId: sender.session.definition.id,\n          },\n          content: framed,\n        })\n        const seq = target.session.inject(message)\n        if (delivery === 'wakeup') this.scheduleWake(target, seq)\n      } else {\n        result = await this.dispatchRemote(target, {\n          teamId: this.id, messageId: id, sender: sender.name,\n          senderAgentId: sender.session.definition.id, content: framed,\n          ...(request.signal === undefined ? {} : { signal: request.signal }),\n        })\n      }\n\n      const record: AgentMessageRecord = deepCloneFreeze({\n        id, teamId: this.id, sender: sender.name,\n        senderAgentId: sender.session.definition.id,\n        target: target.name,\n        targetAgentId: target.kind === 'local'\n          ? target.session.definition.id\n          : target.transport.agentId,\n        delivery, content: framed, status: 'accepted' as const,\n        createdAt: new Date().toISOString(),\n        ...(result === undefined ? {} : { result }),\n      })\n      const retainedBytes = contentBytes + (result === undefined ? 0 : byteLength(result))\n      this.mailbox.push(record)\n      this.mailboxBytes += retainedBytes\n      this.emit({ type: 'message-accepted', message: deepCloneFreeze(record) })\n      return deepCloneFreeze({\n        messageId: id, status: 'accepted' as const, delivery, target: target.name,\n        ...(result === undefined ? {} : { result }),\n      })\n    } finally {\n      releaseReservation()\n    }\n  }\n\n  /** Wake-up alias used by hosts and model tools. */\n  followup(\n    from: string,\n    target: string,\n    message: string | readonly ContentBlock[],\n    signal?: AbortSignal,\n  ): Promise<SendAgentMessageResult> {\n    return this.sendMessage({\n      from, target, message, delivery: 'wakeup',\n      ...(signal === undefined ? {} : { signal }),\n    })\n  }\n\n  /** Wait until all local wake-up work or remote dispatches settle. */\n  async whenIdle(name: string, signal?: AbortSignal): Promise<void> {\n    const member = this.requireAddress(name)\n    if (member.kind === 'remote') {\n      while (true) {\n        const tail = member.tail\n        await abortable(tail, signal)\n        if (tail === member.tail && member.pending === 0) break\n      }\n      return\n    }\n    while (true) {\n      const requested = member.wakeRequestedSeq\n      const task = member.wakeTask\n      // A member the host is holding back has not finished; it has not begun.\n      // Waiting on its session would be answered at once, and the waiter would\n      // read that as work completed.\n      const held = member.pendingStart\n      if (held !== undefined) await abortable(held, signal)\n      if (task !== undefined) await abortable(task, signal)\n      await member.session.whenIdle(signal)\n      if (member.wakeTask === undefined && !member.session.isRunning\n        && member.pendingStart === undefined\n        && member.wakeConsumedSeq >= member.wakeRequestedSeq\n        && requested === member.wakeRequestedSeq) return\n    }\n  }\n\n  /**\n   * Report that the user steered something into a local member mid-turn.\n   *\n   * Ends whatever that member is currently waiting on. A member parked in\n   * `wait_agents` would otherwise finish its budget before reading a correction\n   * that has been sitting in its history the whole time; Codex ends its\n   * `wait_agent` early on steered input for the same reason.\n   * @param name - Local member address.\n   */\n  notifySteer(name: string): void {\n    const member = this.requireLocalMember(name)\n    const controller = member.steerController\n    member.steerController = undefined\n    controller?.abort(new Error('user input steered into the active turn'))\n  }\n\n  /**\n   * Schedule one turn for a local member over context it already has.\n   *\n   * A wake-up delivery carries a message; this carries nothing. It exists for\n   * the case where the context arrived earlier and quietly — appended to a\n   * member that was mid-turn, on the assumption its next model round would read\n   * it — and that round never came. Without this the message sits in history\n   * with nothing left to read it.\n   * @param name - Local member address.\n   */\n  wake(name: string): void {\n    const member = this.requireLocalMember(name)\n    this.scheduleWake(member, member.wakeRequestedSeq + 1)\n  }\n\n  /** Cancel team-owned scheduled work for one member without mutating its history. */\n  async cancel(name: string, reason: unknown = new Error('A2A member work cancelled')): Promise<void> {\n    const member = this.requireAddress(name)\n    if (member.kind === 'remote') {\n      for (const controller of member.controllers) controller.abort(reason)\n      await withTimeout(\n        member.tail,\n        this.disposeTimeoutMs,\n        `A2A member '${member.name}' did not cancel within ${this.disposeTimeoutMs}ms`,\n        'TEAM_CANCELLATION_TIMEOUT',\n      )\n      return\n    }\n    member.wakeConsumedSeq = member.wakeRequestedSeq\n    const controller = member.wakeController\n    const task = member.wakeTask\n    controller?.abort(reason)\n    if (task !== undefined) {\n      await withTimeout(\n        task,\n        this.disposeTimeoutMs,\n        `A2A member '${member.name}' did not cancel within ${this.disposeTimeoutMs}ms`,\n        'TEAM_CANCELLATION_TIMEOUT',\n      )\n    }\n  }\n\n  /** Permanently close this control plane and cancel every team-owned operation. */\n  dispose(reason: unknown = new Error('A2A team disposed')): Promise<void> {\n    if (this.disposeTask !== undefined) return this.disposeTask\n    this.disposed = true\n    this.lifecycle.abort(reason)\n    const settling = Promise.allSettled([\n      ...[...this.roster.values()].map(member => this.cancel(member.name, reason)),\n      ...[...this.links.values()].map(member => this.cancel(member.name, reason)),\n    ]).then(results => {\n      this.roster.clear()\n      this.links.clear()\n      this.emit({ type: 'team-disposed', teamId: this.id })\n      this.mailbox.length = 0\n      this.mailboxBytes = 0\n      this.waitEdges.clear()\n      this.onEvent = undefined\n      this.onAgentEvent = undefined\n      const failure = results.find((result): result is PromiseRejectedResult => result.status === 'rejected')\n      if (failure !== undefined) {\n        throw new AgentSdkError(\n          `A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,\n          'TEAM_DISPOSE_TIMEOUT',\n          { cause: failure.reason },\n        )\n      }\n    })\n    this.disposeTask = withTimeout(\n      settling,\n      this.disposeTimeoutMs,\n      `A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,\n      'TEAM_DISPOSE_TIMEOUT',\n    )\n    return this.disposeTask\n  }\n\n  /** Model-facing tools bound to one immutable local sender identity. */\n  toolsFor(sender: string, access: TeamToolAccess = 'full'): readonly ToolDefinition<any>[] {\n    this.assertActive()\n    const name = memberName(sender)\n    // Called before `attach`, so the access level arrives as an argument\n    // rather than being looked up on the member that does not exist yet.\n    const coordinating = access === 'full'\n    // Coordination is not exploration. A lead that has spent its tool budget\n    // still has to be able to hand the work over and collect it; blocking\n    // these is what strands a team run with finished members and no report.\n    return Object.freeze([\n      defineTool({\n        name: TEAM_TOOL_NAMES.list,\n        budgetExempt: true,\n        description: 'List local and remote addressable agents, their protocols, supported delivery modes, and status.',\n        parameters: { type: 'object', properties: {}, additionalProperties: false },\n        parse: raw => emptyObject(raw, 'list_agents'),\n        execute: () => asJson(this.members()),\n        isConcurrencySafe: () => true,\n      }),\n      defineTool({\n        name: TEAM_TOOL_NAMES.send,\n        budgetExempt: true,\n        description: 'Send quiet context to another local agent from list_agents, other than yourself.'\n          + ' This does not start a task or return its final result. Remote A2A peers require followup_task.',\n        parameters: messageToolSchema('Message to add to the target context.'),\n        parse: parseMessageTool,\n        execute: async ({ target, message }, ctx) => asJson(await this.sendMessage({\n          from: name, target, message, delivery: 'quiet', signal: ctx.signal,\n        })),\n      }),\n      ...!coordinating ? [] : [defineTool({\n        name: TEAM_TOOL_NAMES.followup,\n        budgetExempt: true,\n        description: 'Send active work to a local agent or interoperable remote A2A peer and wait for its accepted result.',\n        parameters: messageToolSchema('Follow-up instruction the target must process.'),\n        parse: parseMessageTool,\n        execute: async ({ target, message }, ctx) => asJson(\n          await this.followup(name, target, message, ctx.signal),\n        ),\n      })],\n      ...!coordinating ? [] : [defineTool({\n        name: TEAM_TOOL_NAMES.wait,\n        budgetExempt: true,\n        description: 'Wait until one of the selected local or remote agents finishes its scheduled'\n          + ' work, then return their current roster state. Returns early with interrupted=true when'\n          + ' the user sends you something while you wait, so read that before waiting again.',\n        parameters: {\n          type: 'object',\n          properties: {\n            targets: {\n              type: 'array', items: { type: 'string' }, minItems: 1,\n              description: 'Exact agent names returned by list_agents.',\n            },\n            timeoutMs: {\n              type: 'number',\n              description:\n                `Give up after this long and report instead, default ${String(this.waitTimeoutMs)}.`\n                + ` Anything under ${String(this.minWaitTimeoutMs)} is raised to it: a wait too short to`\n                + ` finish anything costs a model round and returns the roster unchanged.`,\n            },\n          },\n          required: ['targets'], additionalProperties: false,\n        },\n        parse: parseWaitTool,\n        execute: async ({ targets, timeoutMs }, ctx) => {\n          const release = this.beginWait(name, targets)\n          const budget = timeoutMs === undefined\n            ? this.waitTimeoutMs\n            : Math.min(\n              Math.max(timeoutValue(timeoutMs), this.minWaitTimeoutMs),\n              this.waitTimeoutMs,\n            )\n          try {\n            // Returns as soon as the FIRST target settles, and always within\n            // the budget. Waiting for all of them, forever, is what turned one\n            // slow agent into a window that looked hung: a coordinator that\n            // gets the roster back can decide for itself whether to wait again.\n            //\n            // The budget is enforced HERE rather than only by handing members a\n            // deadline signal: a member that does not honour the signal would\n            // otherwise hold the wait open past its own timeout, and a timeout\n            // a callee can ignore is not a timeout.\n            // A wait that cannot be interrupted is a wait the user cannot\n            // correct: the caller is parked here, so its own new input has\n            // nothing else to end it before the budget runs out.\n            const steer = new AbortController()\n            const caller = this.roster.get(memberName(sender))\n            if (caller !== undefined) caller.steerController = steer\n            const signal = combineSignals(ctx.signal, AbortSignal.timeout(budget), steer.signal)\n            let timer: ReturnType<typeof setTimeout> | undefined\n            const expiry = new Promise<undefined>((resolve) => {\n              timer = setTimeout(() => resolve(undefined), budget)\n            })\n            const interrupted = new Promise<undefined>((resolve) => {\n              steer.signal.addEventListener('abort', () => { resolve(undefined) }, { once: true })\n            })\n            const settled = await Promise.race([\n              Promise.any(targets.map(async (target) => {\n                await this.whenIdle(target, signal)\n                return target\n              })).then(target => target, () => undefined),\n              expiry,\n              interrupted,\n            ]).finally(() => {\n              clearTimeout(timer)\n              if (caller?.steerController === steer) caller.steerController = undefined\n            })\n            // The caller's own cancellation still wins; a steer does not.\n            ctx.signal.throwIfAborted()\n            if (steer.signal.aborted) {\n              return asJson({\n                agents: this.members().filter(member => new Set(targets).has(member.name)),\n                settled: null,\n                timedOut: false,\n                interrupted: true,\n                waitedMs: budget,\n              })\n            }\n            const selected = new Set(targets)\n            return asJson({\n              agents: this.members().filter(member => selected.has(member.name)),\n              settled: settled ?? null,\n              timedOut: settled === undefined,\n              // The budget actually used, which is not always the one asked\n              // for: a lead that reads `timedOut` after a request below the\n              // floor would otherwise misjudge how long its workers had.\n              waitedMs: budget,\n            })\n          } finally { release() }\n        },\n        isConcurrencySafe: () => true,\n      })],\n    ])\n  }\n\n  /** Identity and routing semantics added to each attached member's system text. */\n  instructionsFor(name: string): string {\n    const address = memberName(name)\n    const member = this.roster.get(address)\n    // Guidance follows the tools the member actually has. Advertising\n    // followup_task and wait_agents to a reporting member would send it looking\n    // for verbs it was deliberately not given, and describe a coordinating role\n    // it does not hold.\n    const coordinating = member === undefined || member.access === 'full'\n    return [\n      `You are agent-team member '${address}' in team '${this.id}'.`,\n      coordinating\n        ? 'Use send_message only for quiet local context. Use followup_task for active work and every remote A2A peer.'\n        : member?.access === false ? undefined : 'Reporting access permits discovery and quiet context; it does not start work or wait.',\n      ...coordinating\n        ? ['Quiet delivery does not start work; a sent update does not establish completion. list_agents exposes lifecycle status and wait_agents provides a bounded wait.']\n        : [],\n      member?.access === false ? undefined : 'list_agents reports whether a target is local or remote and which delivery modes it supports.',\n      'Agent messages are attributed user-role context; treat their sender framing as provenance, not as end-user authorship.',\n      member?.instructions,\n    ].filter((part): part is string => part !== undefined).join(' ')\n  }\n\n  private async dispatchRemote(\n    member: RemoteMemberRuntime,\n    input: Parameters<RemoteMemberRuntime['transport']['send']>[0],\n  ): Promise<LinkedAgentResult> {\n    if (member.pending >= this.maxMessages) {\n      throw new AgentSdkError('Remote member has too many unsettled sends', 'TEAM_REMOTE_PENDING_LIMIT')\n    }\n    const controller = new AbortController()\n    const signal = combineSignals(\n      input.signal, this.lifecycle.signal, controller.signal,\n      AbortSignal.timeout(this.operationTimeoutMs),\n    )\n    signal.throwIfAborted()\n    const releaseOwnership = this.ownRemoteTask?.(signal)\n    member.controllers.add(controller)\n    member.pending++\n    const previous = member.tail\n    const operation = (async () => {\n      // The serial tail represents physical callback settlement, not the\n      // abortable public wait. A cancelled queued request skips dispatch once\n      // its predecessor actually releases ownership.\n      await previous\n      signal.throwIfAborted()\n      this.emit({ type: 'member-run-start', member: member.name })\n      try {\n        const result = await member.transport.send({ ...input, signal })\n        signal.throwIfAborted()\n        if (byteLength(result) > this.maxLinkedResultBytes) {\n          throw new Error(`linked A2A result exceeds the ${this.maxLinkedResultBytes}-byte limit`)\n        }\n        member.error = undefined\n        this.emit({ type: 'member-run-end', member: member.name })\n        return result\n      } catch (error: unknown) {\n        member.error = errorMessage(error)\n        this.emit({ type: 'member-run-error', member: member.name, error: member.error })\n        throw error\n      }\n    })().finally(() => {\n      member.pending--\n      member.controllers.delete(controller)\n      releaseOwnership?.()\n    })\n    member.tail = operation.then(() => undefined, () => undefined)\n    return await abortable(operation, signal)\n  }\n\n  private scheduleWake(member: LocalMemberRuntime, seq: number): void {\n    this.assertActive()\n    member.wakeRequestedSeq = Math.max(member.wakeRequestedSeq, seq)\n    if (member.wakeTask !== undefined) return\n    const controller = new AbortController()\n    member.wakeController = controller\n    const signal = combineSignals(\n      this.lifecycle.signal, controller.signal, AbortSignal.timeout(this.operationTimeoutMs),\n    )\n    const task = this.runWakeLoop(member, signal).finally(() => {\n      if (member.wakeTask === task) member.wakeTask = undefined\n      if (member.wakeController === controller) member.wakeController = undefined\n      if (member.wakeConsumedSeq < member.wakeRequestedSeq) {\n        this.scheduleWake(member, member.wakeRequestedSeq)\n      }\n    })\n    member.wakeTask = task\n  }\n\n  /** Serialized content ceiling used by host-generated notifications. */\n  get messageByteLimit(): number { return this.maxMessageBytes }\n\n  private async runWakeLoop(member: LocalMemberRuntime, signal: AbortSignal): Promise<void> {\n    let cancellationReported = false\n    try {\n      while (member.wakeConsumedSeq < member.wakeRequestedSeq) {\n        signal.throwIfAborted()\n        await member.session.whenIdle(signal)\n        const through = member.wakeRequestedSeq\n        this.emit({ type: 'member-run-start', member: member.name })\n        try {\n          const response = await member.session.runPending({\n            signal,\n            onEvent: event => this.observeAgentEvent(member.name, event),\n          })\n          if (signal.aborted) {\n            member.wakeConsumedSeq = through\n            this.emit({ type: 'member-run-cancelled', member: member.name })\n            cancellationReported = true\n            continue\n          }\n          member.error = undefined\n          // Recorded so a coordinator can read the member's answer from the\n          // roster. `runPending` hands it to whoever awaited the run, and with\n          // a wake-up delivery that is nobody.\n          const failure = responseFailure(response)\n          member.error = failure\n          member.outcome = failure === undefined\n            ? { kind: 'completed', text: responseText(response) }\n            : { kind: 'failed', message: failure, ...(responseText(response) === '' ? {} : { text: responseText(response) }) }\n          member.wakeConsumedSeq = through\n          if (failure === undefined) this.emit({ type: 'member-run-end', member: member.name })\n          else this.emit({ type: 'member-run-error', member: member.name, error: failure })\n        } catch (error: unknown) {\n          if (signal.aborted) {\n            member.error = undefined\n            member.wakeConsumedSeq = through\n            this.emit({ type: 'member-run-cancelled', member: member.name })\n            cancellationReported = true\n            continue\n          }\n          if (member.session.isRunning) continue\n          member.error = errorMessage(error)\n          member.outcome = { kind: 'failed', message: member.error }\n          member.wakeConsumedSeq = through\n          this.emit({ type: 'member-run-error', member: member.name, error: member.error })\n        }\n      }\n    } catch (error: unknown) {\n      if (!signal.aborted) throw error\n      member.error = undefined\n      member.wakeConsumedSeq = member.wakeRequestedSeq\n      if (!cancellationReported) this.emit({ type: 'member-run-cancelled', member: member.name })\n    }\n  }\n\n  private requireLocalMember(value: string): LocalMemberRuntime {\n    const name = memberName(value)\n    const member = this.roster.get(name)\n    if (member === undefined) throw new Error(`unknown local A2A member '${name}'`)\n    return member\n  }\n\n  /**\n   * Record that `sender` is blocked until `targets` are idle.\n   *\n   * The `wait_agents` tool calls this, and so must any HOST that blocks one\n   * member on another. An unrecorded edge is invisible here, which is worse\n   * than having no detection at all: the cycle it completes gets waved through,\n   * and both sides then wait for each other until a timeout expires.\n   *\n   * `spawn_agent` used to be such a host — it awaited the worker it created —\n   * and needed an edge declared for it. It no longer waits, so the cycle it\n   * could close no longer exists.\n   * @param sender - The member that will block.\n   * @param targets - Members it is waiting for.\n   * @returns A release; call it when the wait ends, however it ends.\n   * @throws `TEAM_WAIT_CYCLE` when the wait would close a cycle.\n   */\n  beginWait(sender: string, targets: readonly string[]): () => void {\n    for (const target of targets) {\n      this.requireAddress(target)\n      if (target === sender || this.hasWaitPath(target, sender, new Set())) {\n        throw new AgentSdkError('wait_agents would create a coordination cycle', 'TEAM_WAIT_CYCLE')\n      }\n    }\n    let outgoing = this.waitEdges.get(sender)\n    if (outgoing === undefined) {\n      outgoing = new Map()\n      this.waitEdges.set(sender, outgoing)\n    }\n    for (const target of targets) outgoing.set(target, (outgoing.get(target) ?? 0) + 1)\n    let active = true\n    return () => {\n      if (!active) return\n      active = false\n      const edges = this.waitEdges.get(sender)\n      if (edges === undefined) return\n      for (const target of targets) {\n        const count = edges.get(target) ?? 0\n        if (count <= 1) edges.delete(target); else edges.set(target, count - 1)\n      }\n      if (edges.size === 0) this.waitEdges.delete(sender)\n    }\n  }\n\n  private hasWaitPath(from: string, target: string, visited: Set<string>): boolean {\n    if (from === target) return true\n    if (visited.has(from)) return false\n    visited.add(from)\n    for (const next of this.waitEdges.get(from)?.keys() ?? []) {\n      if (this.hasWaitPath(next, target, visited)) return true\n    }\n    return false\n  }\n\n  private requireAddress(value: string): AddressableMember {\n    const name = memberName(value)\n    const member = this.roster.get(name) ?? this.links.get(name)\n    if (member === undefined) throw new Error(`unknown A2A member '${name}'`)\n    return member\n  }\n\n  private assertAddressAvailable(name: string): void {\n    if (this.roster.has(name) || this.links.has(name)) {\n      throw new Error(`A2A member '${name}' is already attached or linked`)\n    }\n  }\n\n  private assertCapacity(): void {\n    if (this.roster.size + this.links.size >= this.maxMembers) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMembers}-member limit`)\n    }\n  }\n\n  private assertActive(): void {\n    if (this.disposed) throw new Error(`A2A team '${this.id}' is disposed`)\n  }\n\n  private reserveMailbox(contentBytes: number): () => void {\n    if (this.mailbox.length + this.pendingMessages >= this.maxMessages) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMessages}-message mailbox limit`)\n    }\n    if (this.mailboxBytes + this.pendingMailboxBytes + contentBytes > this.maxMailboxBytes) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMailboxBytes}-byte mailbox limit`)\n    }\n    this.pendingMessages++\n    this.pendingMailboxBytes += contentBytes\n    let released = false\n    return () => {\n      if (released) return\n      released = true\n      this.pendingMessages--\n      this.pendingMailboxBytes -= contentBytes\n    }\n  }\n\n  /**\n   * Record how a member's run ended.\n   *\n   * For a host that starts a member's run itself and therefore owns the result\n   * the member's own bookkeeping never sees — `spawn_agent` running a worker\n   * concurrently. Without this the roster could report that a worker had\n   * stopped but not what it concluded, which is the whole point of asking.\n   * @param name - Member address.\n   * @param outcome - How the run ended.\n   */\n  recordOutcome(name: string, outcome: AgentMemberOutcome): void {\n    const member = this.requireLocalMember(name)\n    member.outcome = outcome\n    member.error = outcome.kind === 'failed' ? outcome.message : undefined\n  }\n\n  /**\n   * Declare that a member exists but has deliberately not been started.\n   *\n   * A host that orders work — starting one member only once another has\n   * finished — needs the roster to say so, and `wait_agents` to believe it. A\n   * member whose session has never run looks exactly like one that has\n   * finished: idle, not running, nothing outstanding. A coordinator told that\n   * would wait on it, be answered at once, read no outcome, and conclude the\n   * work was done.\n   *\n   * The promise is what `whenIdle` waits on, so the pending state cannot be a\n   * flag that a waiter has to poll.\n   * @param name - Local member address.\n   * @param until - Resolves when the host starts it; undefined clears the state.\n   */\n  markPending(name: string, until: Promise<void> | undefined): void {\n    this.requireLocalMember(name).pendingStart = until\n  }\n\n  private view(member: AddressableMember): AgentTeamMember {\n    if (member.kind === 'remote') {\n      return Object.freeze({\n        name: member.name, agentId: member.transport.agentId, kind: 'remote' as const,\n        role: member.role,\n        status: member.error === undefined ? (member.pending > 0 ? 'running' : 'idle') : 'failed',\n        protocol: member.transport.protocol,\n        deliveries: Object.freeze(['wakeup'] as const),\n        ...(member.description === undefined ? {} : { description: member.description }),\n        ...(member.error === undefined ? {} : { error: member.error }),\n      })\n    }\n    return Object.freeze({\n      name: member.name, agentId: member.session.definition.id, kind: 'local' as const,\n      conversationId: member.session.conversationId, role: member.role,\n      status: member.error !== undefined\n        ? 'failed'\n        : member.pendingStart !== undefined\n          ? 'pending'\n          : member.session.isRunning || member.wakeTask !== undefined ? 'running' : 'idle',\n      protocol: 'in-process', deliveries: Object.freeze(['quiet', 'wakeup'] as const),\n      ...(member.description === undefined ? {} : { description: member.description }),\n      ...(member.error === undefined ? {} : { error: member.error }),\n      ...(member.outcome === undefined ? {} : { outcome: member.outcome }),\n    })\n  }\n\n  private emit(event: AgentTeamEvent): void {\n    try { this.onEvent?.(event) } catch { /* observers do not own control-plane correctness */ }\n  }\n\n  private async observeAgentEvent(member: string, event: AgentRunEvent): Promise<void> {\n    if (this.onAgentEvent === undefined) return\n    const observer = Promise.resolve().then(() => this.onAgentEvent?.(member, event))\n    await waitForSettlement(observer, this.observerTimeoutMs)\n  }\n}\n\n/**\n * The answer text out of a run result.\n *\n * `TeamSessionPort.runPending` returns `unknown` on purpose — the port exists so\n * the control plane does not depend on the concrete session — so the one field\n * needed here is read structurally.\n * @param response - Whatever the member's run resolved with.\n * @returns Its text, or the empty string.\n */\nfunction responseText(response: unknown): string {\n  const text = (response as { text?: unknown } | null)?.text\n  return typeof text === 'string' ? text : ''\n}\n\n/** Session implementations may resolve an incomplete terminal response rather than reject. */\nfunction responseFailure(response: unknown): string | undefined {\n  if (response === null || typeof response !== 'object') return undefined\n  const value = response as { completed?: unknown; outcome?: { completed?: unknown; reason?: { kind?: unknown; failure?: { message?: unknown } } }; stopReason?: { kind?: unknown } }\n  const reason = value.outcome?.reason ?? value.stopReason\n  if (value.outcome?.completed === false || value.completed === false\n    || reason?.kind === 'error' || reason?.kind === 'max-tokens' || reason?.kind === 'aborted' || reason?.kind === 'usage-unavailable') {\n    const message = value.outcome?.reason?.failure?.message\n    return typeof message === 'string' ? message : `member run did not complete (${String(reason?.kind ?? 'unknown')})`\n  }\n  return undefined\n}\n"],"mappings":"yoBA6EA,IAAa,EAAb,KAA2C,CA4BtB,cA3BnB,GACA,WACA,gBACA,qBACA,YACA,gBACA,iBACA,iBACA,mBACA,kBACA,cACA,iBACA,QACA,aACA,OAA0B,IAAI,IAC9B,MAAyB,IAAI,IAC7B,QAAiD,CAAC,EAClD,aAAuB,EACvB,gBAA0B,EAC1B,oBAA8B,EAC9B,UAA6B,IAAI,gBACjC,UAA6B,IAAI,IACjC,SAAmB,GACnB,YAEA,YACE,EAA4B,CAAC,EAC7B,EACA,CADiB,KAAA,cAAA,EAEjB,KAAK,GAAK,EAAc,EAAQ,IAAM,EAAU,EAAG,UAAW,IAAI,EAClE,KAAK,WAAa,EAAgB,EAAQ,YAAc,EAAG,YAAY,EACvE,KAAK,gBAAkB,EAAgB,EAAQ,iBAAmB,MAAW,iBAAiB,EAC9F,KAAK,qBAAuB,EAC1B,EAAQ,sBAAwB,QAChC,sBACF,EACA,KAAK,YAAc,EAAgB,EAAQ,aAAe,IAAQ,aAAa,EAC/E,KAAK,gBAAkB,EAAgB,EAAQ,iBAAmB,SAAkB,iBAAiB,EACrG,KAAK,iBAAmB,EAAgB,EAAQ,kBAAoB,KAAU,kBAAkB,EAChG,KAAK,iBAAmB,EAAa,EAAQ,kBAAoB,GAAM,EACvE,KAAK,mBAAqB,EAAa,EAAQ,oBAAsB,GAAW,EAChF,KAAK,kBAAoB,EAAa,EAAQ,mBAAqB,GAAK,EACxE,KAAK,cAAgB,EAAa,EAAQ,eAAA,GAAwC,EAGlF,KAAK,iBAAmB,KAAK,IAC3B,EAAa,EAAQ,kBAAA,GAA+C,EACpE,KAAK,aACP,EACA,KAAK,QAAU,EAAQ,QACvB,KAAK,aAAe,EAAQ,YAC9B,CAGA,OAAO,EAA0B,EAAuC,CAAC,EAAS,CAChF,KAAK,aAAa,EAClB,IAAM,EAAO,EAAW,EAAQ,MAAQ,EAAQ,WAAW,EAAE,EAC7D,KAAK,uBAAuB,CAAI,EAChC,KAAK,eAAe,EACpB,IAAM,EAAO,EAAQ,OAAS,KAAK,OAAO,OAAS,EAAI,OAAS,QAChE,GAAI,IAAS,QAAU,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,GAAU,EAAO,OAAS,MAAM,EACpF,MAAU,MAAM,aAAa,KAAK,GAAG,qBAAqB,EAG5D,IAAM,EAA6B,CACjC,KAAM,QAAS,OAAM,OAAM,OAFU,EAAQ,QAAU,GAAQ,GAAQ,EAAQ,QAAU,YAAc,YAAc,OAElF,UACnC,iBAAkB,EAAG,gBAAiB,EACtC,SAAU,IAAA,GAAW,eAAgB,IAAA,GAAW,MAAO,IAAA,GAAW,QAAS,IAAA,GAC3E,aAAc,IAAA,GAAW,gBAAiB,IAAA,GAC1C,GAAI,EAAQ,cAAgB,IAAA,GAAY,CAAC,EAAI,CAC3C,YAAa,EAAc,EAAQ,YAAa,qBAAsB,KAAK,gBAAgB,CAC7F,EACA,GAAI,EAAQ,eAAiB,IAAA,GAAY,CAAC,EAAI,CAC5C,aAAc,EAAc,EAAQ,aAAc,sBAAuB,KAAK,gBAAgB,CAChG,CACF,EACA,KAAK,OAAO,IAAI,EAAM,CAAM,EAC5B,KAAK,KAAK,CAAE,KAAM,kBAAmB,OAAQ,KAAK,KAAK,CAAM,CAAE,CAAC,CAClE,CAGA,UAAU,EAAuC,CAC/C,KAAK,aAAa,EAClB,IAAM,EAAO,EAAW,EAAQ,IAAI,EAGpC,GAFA,KAAK,uBAAuB,CAAI,EAChC,KAAK,eAAe,EAChB,OAAO,EAAQ,WAAW,MAAS,WACrC,MAAU,UAAU,8CAA8C,EAEpE,IAAM,EAA8B,CAClC,KAAM,SAAU,OAAM,KAAM,OAAQ,UAAW,EAAQ,UACvD,KAAM,QAAQ,QAAQ,EAAG,QAAS,EAAG,YAAa,IAAI,IAAO,MAAO,IAAA,GACpE,GAAI,EAAQ,cAAgB,IAAA,GAAY,CAAC,EAAI,CAC3C,YAAa,EAAc,EAAQ,YAAa,2BAA4B,KAAK,gBAAgB,CACnG,CACF,EAGA,OAFA,KAAK,MAAM,IAAI,EAAM,CAAM,EAC3B,KAAK,KAAK,CAAE,KAAM,gBAAiB,OAAQ,KAAK,KAAK,CAAM,CAAE,CAAC,MACjD,CACP,QAAK,MAAM,IAAI,CAAI,IAAM,EAC7B,IAAI,EAAO,QAAU,EAAG,MAAU,MAAM,qCAAqC,EAAK,EAAE,EACpF,KAAK,MAAM,OAAO,CAAI,CAD8D,CAEtF,CACF,CAGA,OAAO,EAAoB,CACzB,KAAK,aAAa,EAClB,IAAM,EAAS,KAAK,mBAAmB,CAAI,EAC3C,GAAI,EAAO,QAAQ,WAAa,EAAO,WAAa,IAAA,GAClD,MAAU,MAAM,qCAAqC,EAAO,KAAK,EAAE,EAErE,KAAK,OAAO,OAAO,EAAO,IAAI,CAChC,CAGA,SAAsC,CACpC,OAAO,OAAO,OAAO,CACnB,GAAG,KAAK,OAAO,OAAO,EACtB,GAAG,KAAK,MAAM,OAAO,CACvB,CAAC,CAAC,IAAI,GAAU,KAAK,KAAK,CAAM,CAAC,CAAC,CACpC,CAGA,UAA0C,CACxC,OAAO,EAAgB,KAAK,OAAO,CACrC,CAGA,MAAM,YAAY,EAAmE,CACnF,KAAK,aAAa,EAClB,EAAQ,QAAQ,eAAe,EAC/B,IAAM,EAAS,KAAK,mBAAmB,EAAQ,IAAI,EAC7C,EAAS,KAAK,eAAe,EAAQ,MAAM,EACjD,GAAI,EAAO,OAAS,SAAW,IAAW,EAAQ,MAAU,MAAM,qCAAqC,EACvG,IAAM,EAAW,EAAQ,UAAY,QACrC,GAAI,IAAa,SAAW,IAAa,SACvC,MAAU,UAAU,0CAA0C,EAEhE,GAAI,EAAO,OAAS,UAAY,IAAa,QAC3C,MAAU,MACR,sBAAsB,EAAO,KAAK,wEACpC,EAEF,IAAM,EAAK,EAAa,EAClB,EAAU,EAAe,EAAQ,QAAS,KAAK,eAAe,EAC9D,EAAS,EAAgB,CAC7B,CAAE,KAAM,OAAiB,KAAM,eAAe,EAAG,QAAQ,EAAO,KAAK,EAAG,EACxE,GAAG,CACL,CAAC,EACK,EAAe,EAAW,CAAM,EACtC,GAAI,EAAe,KAAK,gBACtB,MAAU,MAAM,2BAA2B,KAAK,gBAAgB,YAAY,EAE9E,IAAM,EAAgB,EAAO,OAAS,SAClC,EAAe,KAAK,qBACpB,EACE,EAAqB,KAAK,eAAe,CAAa,EAExD,EACJ,GAAI,CACF,GAAI,EAAO,OAAS,QAAS,CAC3B,IAAM,EAAU,EAAkB,CAChC,OAAQ,CACN,KAAM,gBACN,OAAQ,KAAK,GAAI,UAAW,EAAI,OAAQ,EAAO,KAC/C,cAAe,EAAO,QAAQ,WAAW,EAC3C,EACA,QAAS,CACX,CAAC,EACK,EAAM,EAAO,QAAQ,OAAO,CAAO,EACrC,IAAa,UAAU,KAAK,aAAa,EAAQ,CAAG,CAC1D,KACE,GAAS,MAAM,KAAK,eAAe,EAAQ,CACzC,OAAQ,KAAK,GAAI,UAAW,EAAI,OAAQ,EAAO,KAC/C,cAAe,EAAO,QAAQ,WAAW,GAAI,QAAS,EACtD,GAAI,EAAQ,SAAW,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAAQ,MAAO,CACnE,CAAC,EAGH,IAAM,EAA6B,EAAgB,CACjD,KAAI,OAAQ,KAAK,GAAI,OAAQ,EAAO,KACpC,cAAe,EAAO,QAAQ,WAAW,GACzC,OAAQ,EAAO,KACf,cAAe,EAAO,OAAS,QAC3B,EAAO,QAAQ,WAAW,GAC1B,EAAO,UAAU,QACrB,WAAU,QAAS,EAAQ,OAAQ,WACnC,UAAW,IAAI,KAAK,CAAA,CAAE,YAAY,EAClC,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,CAC3C,CAAC,EACK,EAAgB,GAAgB,IAAW,IAAA,GAAY,EAAI,EAAW,CAAM,GAIlF,OAHA,KAAK,QAAQ,KAAK,CAAM,EACxB,KAAK,cAAgB,EACrB,KAAK,KAAK,CAAE,KAAM,mBAAoB,QAAS,EAAgB,CAAM,CAAE,CAAC,EACjE,EAAgB,CACrB,UAAW,EAAI,OAAQ,WAAqB,WAAU,OAAQ,EAAO,KACrE,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,CAC3C,CAAC,CACH,QAAU,CACR,EAAmB,CACrB,CACF,CAGA,SACE,EACA,EACA,EACA,EACiC,CACjC,OAAO,KAAK,YAAY,CACtB,OAAM,SAAQ,UAAS,SAAU,SACjC,GAAI,IAAW,IAAA,GAAY,CAAC,EAAI,CAAE,QAAO,CAC3C,CAAC,CACH,CAGA,MAAM,SAAS,EAAc,EAAqC,CAChE,IAAM,EAAS,KAAK,eAAe,CAAI,EACvC,GAAI,EAAO,OAAS,SAAU,CAC5B,OAAa,CACX,IAAM,EAAO,EAAO,KAEpB,GADA,MAAM,EAAU,EAAM,CAAM,EACxB,IAAS,EAAO,MAAQ,EAAO,UAAY,EAAG,KACpD,CACA,MACF,CACA,OAAa,CACX,IAAM,EAAY,EAAO,iBACnB,EAAO,EAAO,SAId,EAAO,EAAO,aAIpB,GAHI,IAAS,IAAA,IAAW,MAAM,EAAU,EAAM,CAAM,EAChD,IAAS,IAAA,IAAW,MAAM,EAAU,EAAM,CAAM,EACpD,MAAM,EAAO,QAAQ,SAAS,CAAM,EAChC,EAAO,WAAa,IAAA,IAAa,CAAC,EAAO,QAAQ,WAChD,EAAO,eAAiB,IAAA,IACxB,EAAO,iBAAmB,EAAO,kBACjC,IAAc,EAAO,iBAAkB,MAC9C,CACF,CAWA,YAAY,EAAoB,CAC9B,IAAM,EAAS,KAAK,mBAAmB,CAAI,EACrC,EAAa,EAAO,gBAC1B,EAAO,gBAAkB,IAAA,GACzB,GAAY,MAAU,MAAM,yCAAyC,CAAC,CACxE,CAYA,KAAK,EAAoB,CACvB,IAAM,EAAS,KAAK,mBAAmB,CAAI,EAC3C,KAAK,aAAa,EAAQ,EAAO,iBAAmB,CAAC,CACvD,CAGA,MAAM,OAAO,EAAc,EAAsB,MAAM,2BAA2B,EAAkB,CAClG,IAAM,EAAS,KAAK,eAAe,CAAI,EACvC,GAAI,EAAO,OAAS,SAAU,CAC5B,IAAK,IAAM,KAAc,EAAO,YAAa,EAAW,MAAM,CAAM,EACpE,MAAM,EACJ,EAAO,KACP,KAAK,iBACL,eAAe,EAAO,KAAK,0BAA0B,KAAK,iBAAiB,IAC3E,2BACF,EACA,MACF,CACA,EAAO,gBAAkB,EAAO,iBAChC,IAAM,EAAa,EAAO,eACpB,EAAO,EAAO,SACpB,GAAY,MAAM,CAAM,EACpB,IAAS,IAAA,IACX,MAAM,EACJ,EACA,KAAK,iBACL,eAAe,EAAO,KAAK,0BAA0B,KAAK,iBAAiB,IAC3E,2BACF,CAEJ,CAGA,QAAQ,EAAsB,MAAM,mBAAmB,EAAkB,CACvE,GAAI,KAAK,cAAgB,IAAA,GAAW,OAAO,KAAK,YAChD,KAAK,SAAW,GAChB,KAAK,UAAU,MAAM,CAAM,EAC3B,IAAM,EAAW,QAAQ,WAAW,CAClC,GAAG,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,GAAU,KAAK,OAAO,EAAO,KAAM,CAAM,CAAC,EAC3E,GAAG,CAAC,GAAG,KAAK,MAAM,OAAO,CAAC,CAAC,CAAC,IAAI,GAAU,KAAK,OAAO,EAAO,KAAM,CAAM,CAAC,CAC5E,CAAC,CAAC,CAAC,KAAK,GAAW,CACjB,KAAK,OAAO,MAAM,EAClB,KAAK,MAAM,MAAM,EACjB,KAAK,KAAK,CAAE,KAAM,gBAAiB,OAAQ,KAAK,EAAG,CAAC,EACpD,KAAK,QAAQ,OAAS,EACtB,KAAK,aAAe,EACpB,KAAK,UAAU,MAAM,EACrB,KAAK,QAAU,IAAA,GACf,KAAK,aAAe,IAAA,GACpB,IAAM,EAAU,EAAQ,KAAM,GAA4C,EAAO,SAAW,UAAU,EACtG,GAAI,IAAY,IAAA,GACd,MAAM,IAAI,EACR,aAAa,KAAK,GAAG,2BAA2B,KAAK,iBAAiB,IACtE,uBACA,CAAE,MAAO,EAAQ,MAAO,CAC1B,CAEJ,CAAC,EAOD,MANA,MAAK,YAAc,EACjB,EACA,KAAK,iBACL,aAAa,KAAK,GAAG,2BAA2B,KAAK,iBAAiB,IACtE,sBACF,EACO,KAAK,WACd,CAGA,SAAS,EAAgB,EAAyB,OAAwC,CACxF,KAAK,aAAa,EAClB,IAAM,EAAO,EAAW,CAAM,EAGxB,EAAe,IAAW,OAIhC,OAAO,OAAO,OAAO,CACnB,EAAW,CACT,KAAM,EAAgB,KACtB,aAAc,GACd,YAAa,mGACb,WAAY,CAAE,KAAM,SAAU,WAAY,CAAC,EAAG,qBAAsB,EAAM,EAC1E,MAAO,GAAO,EAAY,EAAK,aAAa,EAC5C,YAAe,EAAO,KAAK,QAAQ,CAAC,EACpC,sBAAyB,EAC3B,CAAC,EACD,EAAW,CACT,KAAM,EAAgB,KACtB,aAAc,GACd,YAAa,kLAEb,WAAY,EAAkB,uCAAuC,EACrE,MAAO,EACP,QAAS,MAAO,CAAE,SAAQ,WAAW,IAAQ,EAAO,MAAM,KAAK,YAAY,CACzE,KAAM,EAAM,SAAQ,UAAS,SAAU,QAAS,OAAQ,EAAI,MAC9D,CAAC,CAAC,CACJ,CAAC,EACD,GAAI,EAAoB,CAAC,EAAW,CAClC,KAAM,EAAgB,SACtB,aAAc,GACd,YAAa,uGACb,WAAY,EAAkB,gDAAgD,EAC9E,MAAO,EACP,QAAS,MAAO,CAAE,SAAQ,WAAW,IAAQ,EAC3C,MAAM,KAAK,SAAS,EAAM,EAAQ,EAAS,EAAI,MAAM,CACvD,CACF,CAAC,CAAC,EATiB,CAAC,EAUpB,GAAI,EAAoB,CAAC,EAAW,CAClC,KAAM,EAAgB,KACtB,aAAc,GACd,YAAa,sPAGb,WAAY,CACV,KAAM,SACN,WAAY,CACV,QAAS,CACP,KAAM,QAAS,MAAO,CAAE,KAAM,QAAS,EAAG,SAAU,EACpD,YAAa,4CACf,EACA,UAAW,CACT,KAAM,SACN,YACE,uDAAuD,OAAO,KAAK,aAAa,EAAE,mBAC7D,OAAO,KAAK,gBAAgB,EAAE,4GAEvD,CACF,EACA,SAAU,CAAC,SAAS,EAAG,qBAAsB,EAC/C,EACA,MAAO,EACP,QAAS,MAAO,CAAE,UAAS,aAAa,IAAQ,CAC9C,IAAM,EAAU,KAAK,UAAU,EAAM,CAAO,EACtC,EAAS,IAAc,IAAA,GACzB,KAAK,cACL,KAAK,IACL,KAAK,IAAI,EAAa,CAAS,EAAG,KAAK,gBAAgB,EACvD,KAAK,aACP,EACF,GAAI,CAaF,IAAM,EAAQ,IAAI,gBACZ,EAAS,KAAK,OAAO,IAAI,EAAW,CAAM,CAAC,EAC7C,IAAW,IAAA,KAAW,EAAO,gBAAkB,GACnD,IAAM,EAAS,EAAe,EAAI,OAAQ,YAAY,QAAQ,CAAM,EAAG,EAAM,MAAM,EAC/E,EACE,EAAS,IAAI,QAAoB,GAAY,CACjD,EAAQ,eAAiB,EAAQ,IAAA,EAAS,EAAG,CAAM,CACrD,CAAC,EACK,EAAc,IAAI,QAAoB,GAAY,CACtD,EAAM,OAAO,iBAAiB,YAAe,CAAE,EAAQ,IAAA,EAAS,CAAE,EAAG,CAAE,KAAM,EAAK,CAAC,CACrF,CAAC,EACK,EAAU,MAAM,QAAQ,KAAK,CACjC,QAAQ,IAAI,EAAQ,IAAI,KAAO,KAC7B,MAAM,KAAK,SAAS,EAAQ,CAAM,EAC3B,EACR,CAAC,CAAC,CAAC,KAAK,GAAU,MAAc,IAAA,EAAS,EAC1C,EACA,CACF,CAAC,CAAC,CAAC,YAAc,CACf,aAAa,CAAK,EACd,GAAQ,kBAAoB,IAAO,EAAO,gBAAkB,IAAA,GAClE,CAAC,EAGD,GADA,EAAI,OAAO,eAAe,EACtB,EAAM,OAAO,QACf,OAAO,EAAO,CACZ,OAAQ,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAU,IAAI,IAAI,CAAO,CAAC,CAAC,IAAI,EAAO,IAAI,CAAC,EACzE,QAAS,KACT,SAAU,GACV,YAAa,GACb,SAAU,CACZ,CAAC,EAEH,IAAM,EAAW,IAAI,IAAI,CAAO,EAChC,OAAO,EAAO,CACZ,OAAQ,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAU,EAAS,IAAI,EAAO,IAAI,CAAC,EACjE,QAAS,GAAW,KACpB,SAAU,IAAY,IAAA,GAItB,SAAU,CACZ,CAAC,CACH,QAAU,CAAE,EAAQ,CAAE,CACxB,EACA,sBAAyB,EAC3B,CAAC,CAAC,EA3FiB,CAAC,CA4FtB,CAAC,CACH,CAGA,gBAAgB,EAAsB,CACpC,IAAM,EAAU,EAAW,CAAI,EACzB,EAAS,KAAK,OAAO,IAAI,CAAO,EAKhC,EAAe,IAAW,IAAA,IAAa,EAAO,SAAW,OAC/D,MAAO,CACL,8BAA8B,EAAQ,aAAa,KAAK,GAAG,IAC3D,EACI,8GACA,GAAQ,SAAW,GAAQ,IAAA,GAAY,wFAC3C,GAAG,EACC,CAAC,gKAAgK,EACjK,CAAC,EACL,GAAQ,SAAW,GAAQ,IAAA,GAAY,gGACvC,yHACA,GAAQ,YACV,CAAC,CAAC,OAAQ,GAAyB,IAAS,IAAA,EAAS,CAAC,CAAC,KAAK,GAAG,CACjE,CAEA,MAAc,eACZ,EACA,EAC4B,CAC5B,GAAI,EAAO,SAAW,KAAK,YACzB,MAAM,IAAI,EAAc,6CAA8C,2BAA2B,EAEnG,IAAM,EAAa,IAAI,gBACjB,EAAS,EACb,EAAM,OAAQ,KAAK,UAAU,OAAQ,EAAW,OAChD,YAAY,QAAQ,KAAK,kBAAkB,CAC7C,EACA,EAAO,eAAe,EACtB,IAAM,EAAmB,KAAK,gBAAgB,CAAM,EACpD,EAAO,YAAY,IAAI,CAAU,EACjC,EAAO,UACP,IAAM,EAAW,EAAO,KAClB,GAAa,SAAY,CAI7B,MAAM,EACN,EAAO,eAAe,EACtB,KAAK,KAAK,CAAE,KAAM,mBAAoB,OAAQ,EAAO,IAAK,CAAC,EAC3D,GAAI,CACF,IAAM,EAAS,MAAM,EAAO,UAAU,KAAK,CAAE,GAAG,EAAO,QAAO,CAAC,EAE/D,GADA,EAAO,eAAe,EAClB,EAAW,CAAM,EAAI,KAAK,qBAC5B,MAAU,MAAM,iCAAiC,KAAK,qBAAqB,YAAY,EAIzF,MAFA,GAAO,MAAQ,IAAA,GACf,KAAK,KAAK,CAAE,KAAM,iBAAkB,OAAQ,EAAO,IAAK,CAAC,EAClD,CACT,OAAS,EAAgB,CAGvB,KAFA,GAAO,MAAQ,EAAa,CAAK,EACjC,KAAK,KAAK,CAAE,KAAM,mBAAoB,OAAQ,EAAO,KAAM,MAAO,EAAO,KAAM,CAAC,EAC1E,CACR,CACF,EAAA,CAAG,CAAC,CAAC,YAAc,CACjB,EAAO,UACP,EAAO,YAAY,OAAO,CAAU,EACpC,IAAmB,CACrB,CAAC,EAED,MADA,GAAO,KAAO,EAAU,SAAW,IAAA,OAAiB,IAAA,EAAS,EACtD,MAAM,EAAU,EAAW,CAAM,CAC1C,CAEA,aAAqB,EAA4B,EAAmB,CAGlE,GAFA,KAAK,aAAa,EAClB,EAAO,iBAAmB,KAAK,IAAI,EAAO,iBAAkB,CAAG,EAC3D,EAAO,WAAa,IAAA,GAAW,OACnC,IAAM,EAAa,IAAI,gBACvB,EAAO,eAAiB,EACxB,IAAM,EAAS,EACb,KAAK,UAAU,OAAQ,EAAW,OAAQ,YAAY,QAAQ,KAAK,kBAAkB,CACvF,EACM,EAAO,KAAK,YAAY,EAAQ,CAAM,CAAC,CAAC,YAAc,CACtD,EAAO,WAAa,IAAM,EAAO,SAAW,IAAA,IAC5C,EAAO,iBAAmB,IAAY,EAAO,eAAiB,IAAA,IAC9D,EAAO,gBAAkB,EAAO,kBAClC,KAAK,aAAa,EAAQ,EAAO,gBAAgB,CAErD,CAAC,EACD,EAAO,SAAW,CACpB,CAGA,IAAI,kBAA2B,CAAE,OAAO,KAAK,eAAgB,CAE7D,MAAc,YAAY,EAA4B,EAAoC,CACxF,IAAI,EAAuB,GAC3B,GAAI,CACF,KAAO,EAAO,gBAAkB,EAAO,kBAAkB,CACvD,EAAO,eAAe,EACtB,MAAM,EAAO,QAAQ,SAAS,CAAM,EACpC,IAAM,EAAU,EAAO,iBACvB,KAAK,KAAK,CAAE,KAAM,mBAAoB,OAAQ,EAAO,IAAK,CAAC,EAC3D,GAAI,CACF,IAAM,EAAW,MAAM,EAAO,QAAQ,WAAW,CAC/C,SACA,QAAS,GAAS,KAAK,kBAAkB,EAAO,KAAM,CAAK,CAC7D,CAAC,EACD,GAAI,EAAO,QAAS,CAClB,EAAO,gBAAkB,EACzB,KAAK,KAAK,CAAE,KAAM,uBAAwB,OAAQ,EAAO,IAAK,CAAC,EAC/D,EAAuB,GACvB,QACF,CACA,EAAO,MAAQ,IAAA,GAIf,IAAM,EAAU,EAAgB,CAAQ,EACxC,EAAO,MAAQ,EACf,EAAO,QAAU,IAAY,IAAA,GACzB,CAAE,KAAM,YAAa,KAAM,EAAa,CAAQ,CAAE,EAClD,CAAE,KAAM,SAAU,QAAS,EAAS,GAAI,EAAa,CAAQ,IAAM,GAAK,CAAC,EAAI,CAAE,KAAM,EAAa,CAAQ,CAAE,CAAG,EACnH,EAAO,gBAAkB,EACrB,IAAY,IAAA,GAAW,KAAK,KAAK,CAAE,KAAM,iBAAkB,OAAQ,EAAO,IAAK,CAAC,EAC/E,KAAK,KAAK,CAAE,KAAM,mBAAoB,OAAQ,EAAO,KAAM,MAAO,CAAQ,CAAC,CAClF,OAAS,EAAgB,CACvB,GAAI,EAAO,QAAS,CAClB,EAAO,MAAQ,IAAA,GACf,EAAO,gBAAkB,EACzB,KAAK,KAAK,CAAE,KAAM,uBAAwB,OAAQ,EAAO,IAAK,CAAC,EAC/D,EAAuB,GACvB,QACF,CACA,GAAI,EAAO,QAAQ,UAAW,SAC9B,EAAO,MAAQ,EAAa,CAAK,EACjC,EAAO,QAAU,CAAE,KAAM,SAAU,QAAS,EAAO,KAAM,EACzD,EAAO,gBAAkB,EACzB,KAAK,KAAK,CAAE,KAAM,mBAAoB,OAAQ,EAAO,KAAM,MAAO,EAAO,KAAM,CAAC,CAClF,CACF,CACF,OAAS,EAAgB,CACvB,GAAI,CAAC,EAAO,QAAS,MAAM,EAC3B,EAAO,MAAQ,IAAA,GACf,EAAO,gBAAkB,EAAO,iBAC3B,GAAsB,KAAK,KAAK,CAAE,KAAM,uBAAwB,OAAQ,EAAO,IAAK,CAAC,CAC5F,CACF,CAEA,mBAA2B,EAAmC,CAC5D,IAAM,EAAO,EAAW,CAAK,EACvB,EAAS,KAAK,OAAO,IAAI,CAAI,EACnC,GAAI,IAAW,IAAA,GAAW,MAAU,MAAM,6BAA6B,EAAK,EAAE,EAC9E,OAAO,CACT,CAkBA,UAAU,EAAgB,EAAwC,CAChE,IAAK,IAAM,KAAU,EAEnB,GADA,KAAK,eAAe,CAAM,EACtB,IAAW,GAAU,KAAK,YAAY,EAAQ,EAAQ,IAAI,GAAK,EACjE,MAAM,IAAI,EAAc,gDAAiD,iBAAiB,EAG9F,IAAI,EAAW,KAAK,UAAU,IAAI,CAAM,EACpC,IAAa,IAAA,KACf,EAAW,IAAI,IACf,KAAK,UAAU,IAAI,EAAQ,CAAQ,GAErC,IAAK,IAAM,KAAU,EAAS,EAAS,IAAI,GAAS,EAAS,IAAI,CAAM,GAAK,GAAK,CAAC,EAClF,IAAI,EAAS,GACb,UAAa,CACX,GAAI,CAAC,EAAQ,OACb,EAAS,GACT,IAAM,EAAQ,KAAK,UAAU,IAAI,CAAM,EACnC,OAAU,IAAA,GACd,KAAK,IAAM,KAAU,EAAS,CAC5B,IAAM,EAAQ,EAAM,IAAI,CAAM,GAAK,EAC/B,GAAS,EAAG,EAAM,OAAO,CAAM,EAAQ,EAAM,IAAI,EAAQ,EAAQ,CAAC,CACxE,CACI,EAAM,OAAS,GAAG,KAAK,UAAU,OAAO,CAAM,CADlD,CAEF,CACF,CAEA,YAAoB,EAAc,EAAgB,EAA+B,CAC/E,GAAI,IAAS,EAAQ,MAAO,GAC5B,GAAI,EAAQ,IAAI,CAAI,EAAG,MAAO,GAC9B,EAAQ,IAAI,CAAI,EAChB,IAAK,IAAM,KAAQ,KAAK,UAAU,IAAI,CAAI,CAAC,EAAE,KAAK,GAAK,CAAC,EACtD,GAAI,KAAK,YAAY,EAAM,EAAQ,CAAO,EAAG,MAAO,GAEtD,MAAO,EACT,CAEA,eAAuB,EAAkC,CACvD,IAAM,EAAO,EAAW,CAAK,EACvB,EAAS,KAAK,OAAO,IAAI,CAAI,GAAK,KAAK,MAAM,IAAI,CAAI,EAC3D,GAAI,IAAW,IAAA,GAAW,MAAU,MAAM,uBAAuB,EAAK,EAAE,EACxE,OAAO,CACT,CAEA,uBAA+B,EAAoB,CACjD,GAAI,KAAK,OAAO,IAAI,CAAI,GAAK,KAAK,MAAM,IAAI,CAAI,EAC9C,MAAU,MAAM,eAAe,EAAK,gCAAgC,CAExE,CAEA,gBAA+B,CAC7B,GAAI,KAAK,OAAO,KAAO,KAAK,MAAM,MAAQ,KAAK,WAC7C,MAAU,MAAM,aAAa,KAAK,GAAG,gBAAgB,KAAK,WAAW,cAAc,CAEvF,CAEA,cAA6B,CAC3B,GAAI,KAAK,SAAU,MAAU,MAAM,aAAa,KAAK,GAAG,cAAc,CACxE,CAEA,eAAuB,EAAkC,CACvD,GAAI,KAAK,QAAQ,OAAS,KAAK,iBAAmB,KAAK,YACrD,MAAU,MAAM,aAAa,KAAK,GAAG,gBAAgB,KAAK,YAAY,uBAAuB,EAE/F,GAAI,KAAK,aAAe,KAAK,oBAAsB,EAAe,KAAK,gBACrE,MAAU,MAAM,aAAa,KAAK,GAAG,gBAAgB,KAAK,gBAAgB,oBAAoB,EAEhG,KAAK,kBACL,KAAK,qBAAuB,EAC5B,IAAI,EAAW,GACf,UAAa,CACP,IACJ,EAAW,GACX,KAAK,kBACL,KAAK,qBAAuB,EAC9B,CACF,CAYA,cAAc,EAAc,EAAmC,CAC7D,IAAM,EAAS,KAAK,mBAAmB,CAAI,EAC3C,EAAO,QAAU,EACjB,EAAO,MAAQ,EAAQ,OAAS,SAAW,EAAQ,QAAU,IAAA,EAC/D,CAiBA,YAAY,EAAc,EAAwC,CAChE,KAAK,mBAAmB,CAAI,CAAC,CAAC,aAAe,CAC/C,CAEA,KAAa,EAA4C,CAYvD,OAXI,EAAO,OAAS,SACX,OAAO,OAAO,CACnB,KAAM,EAAO,KAAM,QAAS,EAAO,UAAU,QAAS,KAAM,SAC5D,KAAM,EAAO,KACb,OAAQ,EAAO,QAAU,IAAA,GAAa,EAAO,QAAU,EAAI,UAAY,OAAU,SACjF,SAAU,EAAO,UAAU,SAC3B,WAAY,OAAO,OAAO,CAAC,QAAQ,CAAU,EAC7C,GAAI,EAAO,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAO,WAAY,EAC9E,GAAI,EAAO,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,EAAO,KAAM,CAC9D,CAAC,EAEI,OAAO,OAAO,CACnB,KAAM,EAAO,KAAM,QAAS,EAAO,QAAQ,WAAW,GAAI,KAAM,QAChE,eAAgB,EAAO,QAAQ,eAAgB,KAAM,EAAO,KAC5D,OAAQ,EAAO,QAAU,IAAA,GAErB,EAAO,eAAiB,IAAA,GAEtB,EAAO,QAAQ,WAAa,EAAO,WAAa,IAAA,GAAY,UAAY,OADxE,UAFF,SAIJ,SAAU,aAAc,WAAY,OAAO,OAAO,CAAC,QAAS,QAAQ,CAAU,EAC9E,GAAI,EAAO,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAO,WAAY,EAC9E,GAAI,EAAO,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,EAAO,KAAM,EAC5D,GAAI,EAAO,UAAY,IAAA,GAAY,CAAC,EAAI,CAAE,QAAS,EAAO,OAAQ,CACpE,CAAC,CACH,CAEA,KAAa,EAA6B,CACxC,GAAI,CAAE,KAAK,UAAU,CAAK,CAAE,MAAQ,CAAuD,CAC7F,CAEA,MAAc,kBAAkB,EAAgB,EAAqC,CACnF,GAAI,KAAK,eAAiB,IAAA,GAAW,OACrC,IAAM,EAAW,QAAQ,QAAQ,CAAC,CAAC,SAAW,KAAK,eAAe,EAAQ,CAAK,CAAC,EAChF,MAAM,EAAkB,EAAU,KAAK,iBAAiB,CAC1D,CACF,EAWA,SAAS,EAAa,EAA2B,CAC/C,IAAM,EAAQ,GAAwC,KACtD,OAAO,OAAO,GAAS,SAAW,EAAO,EAC3C,CAGA,SAAS,EAAgB,EAAuC,CAC9D,GAAyB,OAAO,GAAa,WAAzC,EAAmD,OACvD,IAAM,EAAQ,EACR,EAAS,EAAM,SAAS,QAAU,EAAM,WAC9C,GAAI,EAAM,SAAS,YAAc,IAAS,EAAM,YAAc,IACzD,GAAQ,OAAS,SAAW,GAAQ,OAAS,cAAgB,GAAQ,OAAS,WAAa,GAAQ,OAAS,oBAAqB,CACpI,IAAM,EAAU,EAAM,SAAS,QAAQ,SAAS,QAChD,OAAO,OAAO,GAAY,SAAW,EAAU,gCAAgC,OAAO,GAAQ,MAAQ,SAAS,EAAE,EACnH,CAEF"}
+{"version":3,"file":"team.js","names":[],"sources":["../../../src/agent/team/team.ts"],"sourcesContent":["import type { AgentRunEvent } from '../mode/run-agent.ts'\nimport { defineTool, type ToolDefinition } from '../tool/definition.ts'\nimport type { ContentBlock } from '../../message/index.ts'\nimport { createUserMessage } from '../../message/index.ts'\nimport { isManagedTeamNoticeRequest } from '../history/input-work.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { AgentSdkError } from '../../errors/index.ts'\nimport { timeoutValue } from '../../platform/config.ts'\nimport type {\n  TeamMemberAttachmentOptions, TeamPort, TeamSessionPort, TeamToolAccess,\n} from './contracts.ts'\nimport type {\n  AgentMemberOutcome, AgentMessageRecord, AgentTeamEvent, AgentTeamMember, AgentTeamOptions,\n  LinkAgentOptions, LinkedAgentResult, SendAgentMessageRequest, SendAgentMessageResult,\n} from './types.ts'\nimport {\n  messageToolSchema, parseMessageTool, parseWaitTool, emptyObject, messageContent, memberName,\n  boundedString, positiveInteger, byteLength, errorMessage, asJson, deepCloneFreeze, newTeamId,\n  newMessageId, abortable, combineSignals, withTimeout, TEAM_TOOL_NAMES,\n  DEFAULT_MIN_WAIT_TIMEOUT_MS,\n  DEFAULT_WAIT_TIMEOUT_MS,\n} from './common.ts'\n\n/** Shared control plane for local sessions and interoperable remote A2A peers. */\n\ninterface LocalMemberRuntime {\n  readonly kind: 'local'\n  readonly name: string\n  readonly description?: string\n  readonly instructions?: string\n  readonly role: 'lead' | 'peer'\n  /** Which team verbs it was attached with; shapes its routing guidance. */\n  readonly access: TeamToolAccess | false\n  readonly session: TeamSessionPort\n  wakeRequestedSeq: number\n  wakeConsumedSeq: number\n  wakeTask: Promise<void> | undefined\n  wakeController: AbortController | undefined\n  error: string | undefined\n  /** How its last run ended, for a coordinator that did not await the run. */\n  outcome: AgentMemberOutcome | undefined\n  /**\n   * Set while the host is holding this member back, and resolved when it lets\n   * it start. See {@link AgentTeam.markPending}.\n   */\n  pendingStart: Promise<void> | undefined\n  /**\n   * Aborted when the user steers something into this member mid-turn.\n   *\n   * A member parked in `wait_agents` is not listening to its own conversation:\n   * the wait is bounded by its own budget, so a correction typed while it waits\n   * sits unread for as long as that budget lasts. Codex's `wait_agent` \"ends\n   * early when new user input is steered into the active turn\" for the same\n   * reason. Replaced after each notification, so one interruption ends one\n   * wait.\n   */\n  steerController: AbortController | undefined\n}\n\ninterface RemoteMemberRuntime {\n  readonly kind: 'remote'\n  readonly name: string\n  readonly description?: string\n  readonly role: 'peer'\n  readonly transport: LinkAgentOptions['transport']\n  tail: Promise<void>\n  pending: number\n  readonly controllers: Set<AbortController>\n  error: string | undefined\n}\n\ntype AddressableMember = LocalMemberRuntime | RemoteMemberRuntime\n\n\n/**\n * Connect long-lived local AgentSessions and remote protocol peers behind one\n * roster and one model-facing messaging surface.\n */\nexport class AgentTeam implements TeamPort {\n  readonly id: string\n  private readonly maxMembers: number\n  private readonly maxMessageBytes: number\n  private readonly maxLinkedResultBytes: number\n  private readonly maxMessages: number\n  private readonly maxMailboxBytes: number\n  private readonly maxMetadataBytes: number\n  private readonly disposeTimeoutMs: number\n  private readonly operationTimeoutMs: number\n  private readonly observerTimeoutMs: number\n  private readonly waitTimeoutMs: number\n  private readonly minWaitTimeoutMs: number\n  private onEvent: ((event: AgentTeamEvent) => void) | undefined\n  private onAgentEvent: AgentTeamOptions['onAgentEvent']\n  private readonly roster = new Map<string, LocalMemberRuntime>()\n  private readonly links = new Map<string, RemoteMemberRuntime>()\n  private readonly mailbox: AgentMessageRecord[] = []\n  private mailboxBytes = 0\n  private pendingMessages = 0\n  private pendingMailboxBytes = 0\n  private readonly lifecycle = new AbortController()\n  private readonly waitEdges = new Map<string, Map<string, number>>()\n  private disposed = false\n  private disposeTask: Promise<void> | undefined\n\n  constructor(\n    options: AgentTeamOptions = {},\n    private readonly ownRemoteTask?: (signal: AbortSignal) => () => void,\n  ) {\n    this.id = boundedString(options.id ?? newTeamId(), 'team id', 1024)\n    this.maxMembers = positiveInteger(options.maxMembers ?? 8, 'maxMembers')\n    this.maxMessageBytes = positiveInteger(options.maxMessageBytes ?? 64 * 1024, 'maxMessageBytes')\n    this.maxLinkedResultBytes = positiveInteger(\n      options.maxLinkedResultBytes ?? 1024 * 1024,\n      'maxLinkedResultBytes',\n    )\n    this.maxMessages = positiveInteger(options.maxMessages ?? 10_000, 'maxMessages')\n    this.maxMailboxBytes = positiveInteger(options.maxMailboxBytes ?? 64 * 1024 * 1024, 'maxMailboxBytes')\n    this.maxMetadataBytes = positiveInteger(options.maxMetadataBytes ?? 8 * 1024, 'maxMetadataBytes')\n    this.disposeTimeoutMs = timeoutValue(options.disposeTimeoutMs ?? 30_000)\n    this.operationTimeoutMs = timeoutValue(options.operationTimeoutMs ?? 10 * 60_000)\n    this.observerTimeoutMs = timeoutValue(options.observerTimeoutMs ?? 1_000)\n    this.waitTimeoutMs = timeoutValue(options.waitTimeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS)\n    // A floor above the ceiling would clamp every call up to a budget the host\n    // said was too long; the host's own maximum wins.\n    this.minWaitTimeoutMs = Math.min(\n      timeoutValue(options.minWaitTimeoutMs ?? DEFAULT_MIN_WAIT_TIMEOUT_MS),\n      this.waitTimeoutMs,\n    )\n    this.onEvent = options.onEvent\n    this.onAgentEvent = options.onAgentEvent\n  }\n\n  /** Called by AgentSession after its tool catalog is assembled. */\n  attach(session: TeamSessionPort, options: TeamMemberAttachmentOptions = {}): void {\n    this.assertActive()\n    const name = memberName(options.name ?? session.definition.id)\n    this.assertAddressAvailable(name)\n    this.assertCapacity()\n    const role = options.role ?? (this.roster.size === 0 ? 'lead' : 'peer')\n    if (role === 'lead' && [...this.roster.values()].some(member => member.role === 'lead')) {\n      throw new Error(`A2A team '${this.id}' already has a lead`)\n    }\n    const access: TeamToolAccess | false = options.tools === false ? false : options.tools === 'reporting' ? 'reporting' : 'full'\n    const member: LocalMemberRuntime = {\n      kind: 'local', name, role, access, session,\n      wakeRequestedSeq: 0, wakeConsumedSeq: 0,\n      wakeTask: undefined, wakeController: undefined, error: undefined, outcome: undefined,\n      pendingStart: undefined, steerController: undefined,\n      ...(options.description === undefined ? {} : {\n        description: boundedString(options.description, 'member description', this.maxMetadataBytes),\n      }),\n      ...(options.instructions === undefined ? {} : {\n        instructions: boundedString(options.instructions, 'member instructions', this.maxMetadataBytes),\n      }),\n    }\n    this.roster.set(name, member)\n    this.emit({ type: 'member-attached', member: this.view(member) })\n  }\n\n  /** Link one remote transport, including an official A2A protocol client. */\n  linkAgent(options: LinkAgentOptions): () => void {\n    this.assertActive()\n    const name = memberName(options.name)\n    this.assertAddressAvailable(name)\n    this.assertCapacity()\n    if (typeof options.transport?.send !== 'function') {\n      throw new TypeError('linked agent transport must implement send()')\n    }\n    const member: RemoteMemberRuntime = {\n      kind: 'remote', name, role: 'peer', transport: options.transport,\n      tail: Promise.resolve(), pending: 0, controllers: new Set(), error: undefined,\n      ...(options.description === undefined ? {} : {\n        description: boundedString(options.description, 'linked agent description', this.maxMetadataBytes),\n      }),\n    }\n    this.links.set(name, member)\n    this.emit({ type: 'member-linked', member: this.view(member) })\n    return () => {\n      if (this.links.get(name) !== member) return\n      if (member.pending > 0) throw new Error(`cannot unlink running A2A member '${name}'`)\n      this.links.delete(name)\n    }\n  }\n\n  /** Remove exactly one idle local session registration. */\n  detach(name: string): void {\n    this.assertActive()\n    const member = this.requireLocalMember(name)\n    if (member.session.isRunning || member.wakeTask !== undefined) {\n      throw new Error(`cannot detach running A2A member '${member.name}'`)\n    }\n    this.roster.delete(member.name)\n  }\n\n  /** Current detached roster: local members first, then remote links. */\n  members(): readonly AgentTeamMember[] {\n    return Object.freeze([\n      ...this.roster.values(),\n      ...this.links.values(),\n    ].map(member => this.view(member)))\n  }\n\n  /** Immutable audit log. Local target history remains its resumable receipt. */\n  messages(): readonly AgentMessageRecord[] {\n    return deepCloneFreeze(this.mailbox)\n  }\n\n  /** Deliver to a local mailbox or dispatch through a linked remote transport. */\n  async sendMessage(request: SendAgentMessageRequest): Promise<SendAgentMessageResult> {\n    this.assertActive()\n    request.signal?.throwIfAborted()\n    const sender = this.requireLocalMember(request.from)\n    const target = this.requireAddress(request.target)\n    if (target.kind === 'local' && sender === target) throw new Error('an A2A member cannot message itself')\n    const delivery = request.delivery ?? 'quiet'\n    if (delivery !== 'quiet' && delivery !== 'wakeup') {\n      throw new TypeError(\"A2A delivery must be 'quiet' or 'wakeup'\")\n    }\n    if (target.kind === 'remote' && delivery === 'quiet') {\n      throw new Error(\n        `remote A2A member '${target.name}' cannot accept quiet injection; use followup_task or delivery 'wakeup'`,\n      )\n    }\n    const id = newMessageId()\n    const content = messageContent(request.message, this.maxMessageBytes)\n    const framed = deepCloneFreeze([\n      { type: 'text' as const, text: `A2A message ${id} from ${sender.name}:` },\n      ...content,\n    ])\n    const contentBytes = byteLength(framed)\n    if (contentBytes > this.maxMessageBytes) {\n      throw new Error(`A2A message exceeds the ${this.maxMessageBytes}-byte limit`)\n    }\n    const reservedBytes = target.kind === 'remote'\n      ? contentBytes + this.maxLinkedResultBytes\n      : contentBytes\n    const releaseReservation = this.reserveMailbox(reservedBytes)\n\n    let result: LinkedAgentResult | undefined\n    try {\n      if (target.kind === 'local') {\n        const message = createUserMessage({\n          source: isManagedTeamNoticeRequest(request) ? { kind: 'app' as const, producer: 'managed-team' } : {\n            kind: 'agent-message' as const,\n            teamId: this.id, messageId: id, sender: sender.name,\n            senderAgentId: sender.session.definition.id,\n          },\n          content: framed,\n        })\n        const seq = target.session.inject(message)\n        if (delivery === 'wakeup') this.scheduleWake(target, seq)\n      } else {\n        result = await this.dispatchRemote(target, {\n          teamId: this.id, messageId: id, sender: sender.name,\n          senderAgentId: sender.session.definition.id, content: framed,\n          ...(request.signal === undefined ? {} : { signal: request.signal }),\n        })\n      }\n\n      const record: AgentMessageRecord = deepCloneFreeze({\n        id, teamId: this.id, sender: sender.name,\n        senderAgentId: sender.session.definition.id,\n        target: target.name,\n        targetAgentId: target.kind === 'local'\n          ? target.session.definition.id\n          : target.transport.agentId,\n        delivery, content: framed, status: 'accepted' as const,\n        createdAt: new Date().toISOString(),\n        ...(result === undefined ? {} : { result }),\n      })\n      const retainedBytes = contentBytes + (result === undefined ? 0 : byteLength(result))\n      this.mailbox.push(record)\n      this.mailboxBytes += retainedBytes\n      this.emit({ type: 'message-accepted', message: deepCloneFreeze(record) })\n      return deepCloneFreeze({\n        messageId: id, status: 'accepted' as const, delivery, target: target.name,\n        ...(result === undefined ? {} : { result }),\n      })\n    } finally {\n      releaseReservation()\n    }\n  }\n\n  /** Wake-up alias used by hosts and model tools. */\n  followup(\n    from: string,\n    target: string,\n    message: string | readonly ContentBlock[],\n    signal?: AbortSignal,\n  ): Promise<SendAgentMessageResult> {\n    return this.sendMessage({\n      from, target, message, delivery: 'wakeup',\n      ...(signal === undefined ? {} : { signal }),\n    })\n  }\n\n  /** Wait until all local wake-up work or remote dispatches settle. */\n  async whenIdle(name: string, signal?: AbortSignal): Promise<void> {\n    const member = this.requireAddress(name)\n    if (member.kind === 'remote') {\n      while (true) {\n        const tail = member.tail\n        await abortable(tail, signal)\n        if (tail === member.tail && member.pending === 0) break\n      }\n      return\n    }\n    while (true) {\n      const requested = member.wakeRequestedSeq\n      const task = member.wakeTask\n      // A member the host is holding back has not finished; it has not begun.\n      // Waiting on its session would be answered at once, and the waiter would\n      // read that as work completed.\n      const held = member.pendingStart\n      if (held !== undefined) await abortable(held, signal)\n      if (task !== undefined) await abortable(task, signal)\n      await member.session.whenIdle(signal)\n      if (member.wakeTask === undefined && !member.session.isRunning\n        && member.pendingStart === undefined\n        && member.wakeConsumedSeq >= member.wakeRequestedSeq\n        && requested === member.wakeRequestedSeq) return\n    }\n  }\n\n  /**\n   * Report that the user steered something into a local member mid-turn.\n   *\n   * Ends whatever that member is currently waiting on. A member parked in\n   * `wait_agents` would otherwise finish its budget before reading a correction\n   * that has been sitting in its history the whole time; Codex ends its\n   * `wait_agent` early on steered input for the same reason.\n   * @param name - Local member address.\n   */\n  notifySteer(name: string): void {\n    const member = this.requireLocalMember(name)\n    const controller = member.steerController\n    member.steerController = undefined\n    controller?.abort(new Error('user input steered into the active turn'))\n  }\n\n  /**\n   * Schedule one turn for a local member over context it already has.\n   *\n   * A wake-up delivery carries a message; this carries nothing. It exists for\n   * the case where the context arrived earlier and quietly — appended to a\n   * member that was mid-turn, on the assumption its next model round would read\n   * it — and that round never came. Without this the message sits in history\n   * with nothing left to read it.\n   * @param name - Local member address.\n   */\n  wake(name: string): void {\n    const member = this.requireLocalMember(name)\n    this.scheduleWake(member, member.wakeRequestedSeq + 1)\n  }\n\n  /** Cancel team-owned scheduled work for one member without mutating its history. */\n  async cancel(name: string, reason: unknown = new Error('A2A member work cancelled')): Promise<void> {\n    const member = this.requireAddress(name)\n    if (member.kind === 'remote') {\n      for (const controller of member.controllers) controller.abort(reason)\n      await withTimeout(\n        member.tail,\n        this.disposeTimeoutMs,\n        `A2A member '${member.name}' did not cancel within ${this.disposeTimeoutMs}ms`,\n        'TEAM_CANCELLATION_TIMEOUT',\n      )\n      return\n    }\n    member.wakeConsumedSeq = member.wakeRequestedSeq\n    const controller = member.wakeController\n    const task = member.wakeTask\n    controller?.abort(reason)\n    if (task !== undefined) {\n      await withTimeout(\n        task,\n        this.disposeTimeoutMs,\n        `A2A member '${member.name}' did not cancel within ${this.disposeTimeoutMs}ms`,\n        'TEAM_CANCELLATION_TIMEOUT',\n      )\n    }\n  }\n\n  /** Permanently close this control plane and cancel every team-owned operation. */\n  dispose(reason: unknown = new Error('A2A team disposed')): Promise<void> {\n    if (this.disposeTask !== undefined) return this.disposeTask\n    this.disposed = true\n    this.lifecycle.abort(reason)\n    const settling = Promise.allSettled([\n      ...[...this.roster.values()].map(member => this.cancel(member.name, reason)),\n      ...[...this.links.values()].map(member => this.cancel(member.name, reason)),\n    ]).then(results => {\n      this.roster.clear()\n      this.links.clear()\n      this.emit({ type: 'team-disposed', teamId: this.id })\n      this.mailbox.length = 0\n      this.mailboxBytes = 0\n      this.waitEdges.clear()\n      this.onEvent = undefined\n      this.onAgentEvent = undefined\n      const failure = results.find((result): result is PromiseRejectedResult => result.status === 'rejected')\n      if (failure !== undefined) {\n        throw new AgentSdkError(\n          `A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,\n          'TEAM_DISPOSE_TIMEOUT',\n          { cause: failure.reason },\n        )\n      }\n    })\n    this.disposeTask = withTimeout(\n      settling,\n      this.disposeTimeoutMs,\n      `A2A team '${this.id}' did not dispose within ${this.disposeTimeoutMs}ms`,\n      'TEAM_DISPOSE_TIMEOUT',\n    )\n    return this.disposeTask\n  }\n\n  /** Model-facing tools bound to one immutable local sender identity. */\n  toolsFor(sender: string, access: TeamToolAccess = 'full'): readonly ToolDefinition<any>[] {\n    this.assertActive()\n    const name = memberName(sender)\n    // Called before `attach`, so the access level arrives as an argument\n    // rather than being looked up on the member that does not exist yet.\n    const coordinating = access === 'full'\n    // Coordination is not exploration. A lead that has spent its tool budget\n    // still has to be able to hand the work over and collect it; blocking\n    // these is what strands a team run with finished members and no report.\n    return Object.freeze([\n      defineTool({\n        name: TEAM_TOOL_NAMES.list,\n        budgetExempt: true,\n        description: 'List local and remote addressable agents, their protocols, supported delivery modes, and status.',\n        parameters: { type: 'object', properties: {}, additionalProperties: false },\n        parse: raw => emptyObject(raw, 'list_agents'),\n        execute: () => asJson(this.members()),\n        isConcurrencySafe: () => true,\n      }),\n      defineTool({\n        name: TEAM_TOOL_NAMES.send,\n        budgetExempt: true,\n        description: 'Send quiet context to another local agent from list_agents, other than yourself.'\n          + ' This does not start a task or return its final result. Remote A2A peers require followup_task.',\n        parameters: messageToolSchema('Message to add to the target context.'),\n        parse: parseMessageTool,\n        execute: async ({ target, message }, ctx) => asJson(await this.sendMessage({\n          from: name, target, message, delivery: 'quiet', signal: ctx.signal,\n        })),\n      }),\n      ...!coordinating ? [] : [defineTool({\n        name: TEAM_TOOL_NAMES.followup,\n        budgetExempt: true,\n        description: 'Send active work to a local agent or interoperable remote A2A peer and wait for its accepted result.',\n        parameters: messageToolSchema('Follow-up instruction the target must process.'),\n        parse: parseMessageTool,\n        execute: async ({ target, message }, ctx) => asJson(\n          await this.followup(name, target, message, ctx.signal),\n        ),\n      })],\n      ...!coordinating ? [] : [defineTool({\n        name: TEAM_TOOL_NAMES.wait,\n        budgetExempt: true,\n        description: 'Wait until one of the selected local or remote agents finishes its scheduled'\n          + ' work, then return their current roster state. Returns early with interrupted=true when'\n          + ' the user sends you something while you wait, so read that before waiting again.',\n        parameters: {\n          type: 'object',\n          properties: {\n            targets: {\n              type: 'array', items: { type: 'string' }, minItems: 1,\n              description: 'Exact agent names returned by list_agents.',\n            },\n            timeoutMs: {\n              type: 'number',\n              description:\n                `Give up after this long and report instead, default ${String(this.waitTimeoutMs)}.`\n                + ` Anything under ${String(this.minWaitTimeoutMs)} is raised to it: a wait too short to`\n                + ` finish anything costs a model round and returns the roster unchanged.`,\n            },\n          },\n          required: ['targets'], additionalProperties: false,\n        },\n        parse: parseWaitTool,\n        execute: async ({ targets, timeoutMs }, ctx) => {\n          const release = this.beginWait(name, targets)\n          const budget = timeoutMs === undefined\n            ? this.waitTimeoutMs\n            : Math.min(\n              Math.max(timeoutValue(timeoutMs), this.minWaitTimeoutMs),\n              this.waitTimeoutMs,\n            )\n          try {\n            // Returns as soon as the FIRST target settles, and always within\n            // the budget. Waiting for all of them, forever, is what turned one\n            // slow agent into a window that looked hung: a coordinator that\n            // gets the roster back can decide for itself whether to wait again.\n            //\n            // The budget is enforced HERE rather than only by handing members a\n            // deadline signal: a member that does not honour the signal would\n            // otherwise hold the wait open past its own timeout, and a timeout\n            // a callee can ignore is not a timeout.\n            // A wait that cannot be interrupted is a wait the user cannot\n            // correct: the caller is parked here, so its own new input has\n            // nothing else to end it before the budget runs out.\n            const steer = new AbortController()\n            const caller = this.roster.get(memberName(sender))\n            if (caller !== undefined) caller.steerController = steer\n            const signal = combineSignals(ctx.signal, AbortSignal.timeout(budget), steer.signal)\n            let timer: ReturnType<typeof setTimeout> | undefined\n            const expiry = new Promise<undefined>((resolve) => {\n              timer = setTimeout(() => resolve(undefined), budget)\n            })\n            const interrupted = new Promise<undefined>((resolve) => {\n              steer.signal.addEventListener('abort', () => { resolve(undefined) }, { once: true })\n            })\n            const settled = await Promise.race([\n              Promise.any(targets.map(async (target) => {\n                await this.whenIdle(target, signal)\n                return target\n              })).then(target => target, () => undefined),\n              expiry,\n              interrupted,\n            ]).finally(() => {\n              clearTimeout(timer)\n              if (caller?.steerController === steer) caller.steerController = undefined\n            })\n            // The caller's own cancellation still wins; a steer does not.\n            ctx.signal.throwIfAborted()\n            if (steer.signal.aborted) {\n              return asJson({\n                agents: this.members().filter(member => new Set(targets).has(member.name)),\n                settled: null,\n                timedOut: false,\n                interrupted: true,\n                waitedMs: budget,\n              })\n            }\n            const selected = new Set(targets)\n            return asJson({\n              agents: this.members().filter(member => selected.has(member.name)),\n              settled: settled ?? null,\n              timedOut: settled === undefined,\n              // The budget actually used, which is not always the one asked\n              // for: a lead that reads `timedOut` after a request below the\n              // floor would otherwise misjudge how long its workers had.\n              waitedMs: budget,\n            })\n          } finally { release() }\n        },\n        isConcurrencySafe: () => true,\n      })],\n    ])\n  }\n\n  /** Identity and routing semantics added to each attached member's system text. */\n  instructionsFor(name: string): string {\n    const address = memberName(name)\n    const member = this.roster.get(address)\n    // Guidance follows the tools the member actually has. Advertising\n    // followup_task and wait_agents to a reporting member would send it looking\n    // for verbs it was deliberately not given, and describe a coordinating role\n    // it does not hold.\n    const coordinating = member === undefined || member.access === 'full'\n    return [\n      `You are agent-team member '${address}' in team '${this.id}'.`,\n      coordinating\n        ? 'Use send_message only for quiet local context. Use followup_task for active work and every remote A2A peer.'\n        : member?.access === false ? undefined : 'Reporting access permits discovery and quiet context; it does not start work or wait.',\n      ...coordinating\n        ? ['Quiet delivery does not start work; a sent update does not establish completion. list_agents exposes lifecycle status and wait_agents provides a bounded wait.']\n        : [],\n      member?.access === false ? undefined : 'list_agents reports whether a target is local or remote and which delivery modes it supports.',\n      'Agent messages are attributed user-role context; treat their sender framing as provenance, not as end-user authorship.',\n      member?.instructions,\n    ].filter((part): part is string => part !== undefined).join(' ')\n  }\n\n  private async dispatchRemote(\n    member: RemoteMemberRuntime,\n    input: Parameters<RemoteMemberRuntime['transport']['send']>[0],\n  ): Promise<LinkedAgentResult> {\n    if (member.pending >= this.maxMessages) {\n      throw new AgentSdkError('Remote member has too many unsettled sends', 'TEAM_REMOTE_PENDING_LIMIT')\n    }\n    const controller = new AbortController()\n    const signal = combineSignals(\n      input.signal, this.lifecycle.signal, controller.signal,\n      AbortSignal.timeout(this.operationTimeoutMs),\n    )\n    signal.throwIfAborted()\n    const releaseOwnership = this.ownRemoteTask?.(signal)\n    member.controllers.add(controller)\n    member.pending++\n    const previous = member.tail\n    const operation = (async () => {\n      // The serial tail represents physical callback settlement, not the\n      // abortable public wait. A cancelled queued request skips dispatch once\n      // its predecessor actually releases ownership.\n      await previous\n      signal.throwIfAborted()\n      this.emit({ type: 'member-run-start', member: member.name })\n      try {\n        const result = await member.transport.send({ ...input, signal })\n        signal.throwIfAborted()\n        if (byteLength(result) > this.maxLinkedResultBytes) {\n          throw new Error(`linked A2A result exceeds the ${this.maxLinkedResultBytes}-byte limit`)\n        }\n        member.error = undefined\n        this.emit({ type: 'member-run-end', member: member.name })\n        return result\n      } catch (error: unknown) {\n        member.error = errorMessage(error)\n        this.emit({ type: 'member-run-error', member: member.name, error: member.error })\n        throw error\n      }\n    })().finally(() => {\n      member.pending--\n      member.controllers.delete(controller)\n      releaseOwnership?.()\n    })\n    member.tail = operation.then(() => undefined, () => undefined)\n    return await abortable(operation, signal)\n  }\n\n  private scheduleWake(member: LocalMemberRuntime, seq: number): void {\n    this.assertActive()\n    member.wakeRequestedSeq = Math.max(member.wakeRequestedSeq, seq)\n    if (member.wakeTask !== undefined) return\n    const controller = new AbortController()\n    member.wakeController = controller\n    const signal = combineSignals(\n      this.lifecycle.signal, controller.signal, AbortSignal.timeout(this.operationTimeoutMs),\n    )\n    const task = this.runWakeLoop(member, signal).finally(() => {\n      if (member.wakeTask === task) member.wakeTask = undefined\n      if (member.wakeController === controller) member.wakeController = undefined\n      if (member.wakeConsumedSeq < member.wakeRequestedSeq) {\n        this.scheduleWake(member, member.wakeRequestedSeq)\n      }\n    })\n    member.wakeTask = task\n  }\n\n  /** Serialized content ceiling used by host-generated notifications. */\n  get messageByteLimit(): number { return this.maxMessageBytes }\n\n  private async runWakeLoop(member: LocalMemberRuntime, signal: AbortSignal): Promise<void> {\n    let cancellationReported = false\n    try {\n      while (member.wakeConsumedSeq < member.wakeRequestedSeq) {\n        signal.throwIfAborted()\n        await member.session.whenIdle(signal)\n        const through = member.wakeRequestedSeq\n        // The run that was active may already have answered this delivery\n        // (it answers a person's queued input before it ends, and delivers\n        // anything queued with it). Running again would only repeat itself.\n        if (member.session.hasUnansweredInput?.() === false) {\n          const outcome = member.session.lastOutcome?.()\n          if (outcome !== undefined) {\n            const failure = responseFailure(outcome)\n            member.error = failure\n            member.outcome = failure === undefined\n              ? { kind: 'completed', text: outcome.text }\n              : { kind: 'failed', message: failure, ...(outcome.text === '' ? {} : { text: outcome.text }) }\n          }\n          member.wakeConsumedSeq = through\n          continue\n        }\n        this.emit({ type: 'member-run-start', member: member.name })\n        try {\n          const response = await member.session.runPending({\n            signal,\n            onEvent: event => this.observeAgentEvent(member.name, event),\n          })\n          if (signal.aborted) {\n            member.wakeConsumedSeq = through\n            this.emit({ type: 'member-run-cancelled', member: member.name })\n            cancellationReported = true\n            continue\n          }\n          member.error = undefined\n          // Recorded so a coordinator can read the member's answer from the\n          // roster. `runPending` hands it to whoever awaited the run, and with\n          // a wake-up delivery that is nobody.\n          const failure = responseFailure(response)\n          member.error = failure\n          member.outcome = failure === undefined\n            ? { kind: 'completed', text: responseText(response) }\n            : { kind: 'failed', message: failure, ...(responseText(response) === '' ? {} : { text: responseText(response) }) }\n          member.wakeConsumedSeq = through\n          if (failure === undefined) this.emit({ type: 'member-run-end', member: member.name })\n          else this.emit({ type: 'member-run-error', member: member.name, error: failure })\n        } catch (error: unknown) {\n          if (signal.aborted) {\n            member.error = undefined\n            member.wakeConsumedSeq = through\n            this.emit({ type: 'member-run-cancelled', member: member.name })\n            cancellationReported = true\n            continue\n          }\n          if (member.session.isRunning) continue\n          member.error = errorMessage(error)\n          member.outcome = { kind: 'failed', message: member.error }\n          member.wakeConsumedSeq = through\n          this.emit({ type: 'member-run-error', member: member.name, error: member.error })\n        }\n      }\n    } catch (error: unknown) {\n      if (!signal.aborted) throw error\n      member.error = undefined\n      member.wakeConsumedSeq = member.wakeRequestedSeq\n      if (!cancellationReported) this.emit({ type: 'member-run-cancelled', member: member.name })\n    }\n  }\n\n  private requireLocalMember(value: string): LocalMemberRuntime {\n    const name = memberName(value)\n    const member = this.roster.get(name)\n    if (member === undefined) throw new Error(`unknown local A2A member '${name}'`)\n    return member\n  }\n\n  /**\n   * Record that `sender` is blocked until `targets` are idle.\n   *\n   * The `wait_agents` tool calls this, and so must any HOST that blocks one\n   * member on another. An unrecorded edge is invisible here, which is worse\n   * than having no detection at all: the cycle it completes gets waved through,\n   * and both sides then wait for each other until a timeout expires.\n   *\n   * `spawn_agent` used to be such a host — it awaited the worker it created —\n   * and needed an edge declared for it. It no longer waits, so the cycle it\n   * could close no longer exists.\n   * @param sender - The member that will block.\n   * @param targets - Members it is waiting for.\n   * @returns A release; call it when the wait ends, however it ends.\n   * @throws `TEAM_WAIT_CYCLE` when the wait would close a cycle.\n   */\n  beginWait(sender: string, targets: readonly string[]): () => void {\n    for (const target of targets) {\n      this.requireAddress(target)\n      if (target === sender || this.hasWaitPath(target, sender, new Set())) {\n        throw new AgentSdkError('wait_agents would create a coordination cycle', 'TEAM_WAIT_CYCLE')\n      }\n    }\n    let outgoing = this.waitEdges.get(sender)\n    if (outgoing === undefined) {\n      outgoing = new Map()\n      this.waitEdges.set(sender, outgoing)\n    }\n    for (const target of targets) outgoing.set(target, (outgoing.get(target) ?? 0) + 1)\n    let active = true\n    return () => {\n      if (!active) return\n      active = false\n      const edges = this.waitEdges.get(sender)\n      if (edges === undefined) return\n      for (const target of targets) {\n        const count = edges.get(target) ?? 0\n        if (count <= 1) edges.delete(target); else edges.set(target, count - 1)\n      }\n      if (edges.size === 0) this.waitEdges.delete(sender)\n    }\n  }\n\n  private hasWaitPath(from: string, target: string, visited: Set<string>): boolean {\n    if (from === target) return true\n    if (visited.has(from)) return false\n    visited.add(from)\n    for (const next of this.waitEdges.get(from)?.keys() ?? []) {\n      if (this.hasWaitPath(next, target, visited)) return true\n    }\n    return false\n  }\n\n  private requireAddress(value: string): AddressableMember {\n    const name = memberName(value)\n    const member = this.roster.get(name) ?? this.links.get(name)\n    if (member === undefined) throw new Error(`unknown A2A member '${name}'`)\n    return member\n  }\n\n  private assertAddressAvailable(name: string): void {\n    if (this.roster.has(name) || this.links.has(name)) {\n      throw new Error(`A2A member '${name}' is already attached or linked`)\n    }\n  }\n\n  private assertCapacity(): void {\n    if (this.roster.size + this.links.size >= this.maxMembers) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMembers}-member limit`)\n    }\n  }\n\n  private assertActive(): void {\n    if (this.disposed) throw new Error(`A2A team '${this.id}' is disposed`)\n  }\n\n  private reserveMailbox(contentBytes: number): () => void {\n    if (this.mailbox.length + this.pendingMessages >= this.maxMessages) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMessages}-message mailbox limit`)\n    }\n    if (this.mailboxBytes + this.pendingMailboxBytes + contentBytes > this.maxMailboxBytes) {\n      throw new Error(`A2A team '${this.id}' reached its ${this.maxMailboxBytes}-byte mailbox limit`)\n    }\n    this.pendingMessages++\n    this.pendingMailboxBytes += contentBytes\n    let released = false\n    return () => {\n      if (released) return\n      released = true\n      this.pendingMessages--\n      this.pendingMailboxBytes -= contentBytes\n    }\n  }\n\n  /**\n   * Record how a member's run ended.\n   *\n   * For a host that starts a member's run itself and therefore owns the result\n   * the member's own bookkeeping never sees — `spawn_agent` running a worker\n   * concurrently. Without this the roster could report that a worker had\n   * stopped but not what it concluded, which is the whole point of asking.\n   * @param name - Member address.\n   * @param outcome - How the run ended.\n   */\n  recordOutcome(name: string, outcome: AgentMemberOutcome): void {\n    const member = this.requireLocalMember(name)\n    member.outcome = outcome\n    member.error = outcome.kind === 'failed' ? outcome.message : undefined\n  }\n\n  /**\n   * Declare that a member exists but has deliberately not been started.\n   *\n   * A host that orders work — starting one member only once another has\n   * finished — needs the roster to say so, and `wait_agents` to believe it. A\n   * member whose session has never run looks exactly like one that has\n   * finished: idle, not running, nothing outstanding. A coordinator told that\n   * would wait on it, be answered at once, read no outcome, and conclude the\n   * work was done.\n   *\n   * The promise is what `whenIdle` waits on, so the pending state cannot be a\n   * flag that a waiter has to poll.\n   * @param name - Local member address.\n   * @param until - Resolves when the host starts it; undefined clears the state.\n   */\n  markPending(name: string, until: Promise<void> | undefined): void {\n    this.requireLocalMember(name).pendingStart = until\n  }\n\n  private view(member: AddressableMember): AgentTeamMember {\n    if (member.kind === 'remote') {\n      return Object.freeze({\n        name: member.name, agentId: member.transport.agentId, kind: 'remote' as const,\n        role: member.role,\n        status: member.error === undefined ? (member.pending > 0 ? 'running' : 'idle') : 'failed',\n        protocol: member.transport.protocol,\n        deliveries: Object.freeze(['wakeup'] as const),\n        ...(member.description === undefined ? {} : { description: member.description }),\n        ...(member.error === undefined ? {} : { error: member.error }),\n      })\n    }\n    return Object.freeze({\n      name: member.name, agentId: member.session.definition.id, kind: 'local' as const,\n      conversationId: member.session.conversationId, role: member.role,\n      status: member.error !== undefined\n        ? 'failed'\n        : member.pendingStart !== undefined\n          ? 'pending'\n          : member.session.isRunning || member.wakeTask !== undefined ? 'running' : 'idle',\n      protocol: 'in-process', deliveries: Object.freeze(['quiet', 'wakeup'] as const),\n      ...(member.description === undefined ? {} : { description: member.description }),\n      ...(member.error === undefined ? {} : { error: member.error }),\n      ...(member.outcome === undefined ? {} : { outcome: member.outcome }),\n    })\n  }\n\n  private emit(event: AgentTeamEvent): void {\n    try { this.onEvent?.(event) } catch { /* observers do not own control-plane correctness */ }\n  }\n\n  private async observeAgentEvent(member: string, event: AgentRunEvent): Promise<void> {\n    if (event.type === 'agent-end') {\n      const runtime = this.roster.get(member)\n      if (runtime !== undefined) {\n        const failure = responseFailure(event.outcome)\n        runtime.error = failure\n        runtime.outcome = failure === undefined\n          ? { kind: 'completed', text: event.outcome.text }\n          : { kind: 'failed', message: failure, ...(event.outcome.text === '' ? {} : { text: event.outcome.text }) }\n      }\n    }\n    if (this.onAgentEvent === undefined) return\n    const observer = Promise.resolve().then(() => this.onAgentEvent?.(member, event))\n    await waitForSettlement(observer, this.observerTimeoutMs)\n  }\n}\n\n/**\n * The answer text out of a run result.\n *\n * `TeamSessionPort.runPending` returns `unknown` on purpose — the port exists so\n * the control plane does not depend on the concrete session — so the one field\n * needed here is read structurally.\n * @param response - Whatever the member's run resolved with.\n * @returns Its text, or the empty string.\n */\nfunction responseText(response: unknown): string {\n  const text = (response as { text?: unknown } | null)?.text\n  return typeof text === 'string' ? text : ''\n}\n\n/** Session implementations may resolve an incomplete terminal response rather than reject. */\nfunction responseFailure(response: unknown): string | undefined {\n  if (response === null || typeof response !== 'object') return undefined\n  const value = response as { completed?: unknown; outcome?: { completed?: unknown; reason?: { kind?: unknown; failure?: { message?: unknown } } }; stopReason?: { kind?: unknown } }\n  const reason = value.outcome?.reason ?? value.stopReason\n  if (value.outcome?.completed === false || value.completed === false\n    || reason?.kind === 'error' || reason?.kind === 'max-tokens' || reason?.kind === 'aborted' || reason?.kind === 'usage-unavailable') {\n    const message = value.outcome?.reason?.failure?.message\n    return typeof message === 'string' ? message : `member run did not complete (${String(reason?.kind ?? 'unknown')})`\n  }\n  return undefined\n}\n"],"mappings":"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"}

package/dist/agent/tool/pipeline.js

@@ -1,4 +1,4 @@
-import{isJsonValue as e}from"../../primitives/json.js";import{waitForSettlement as t}from"../../async/settlement.js";import{executionModeOf as n,renderJsonValue as r}from"./definition.js";import{TOOL_ERROR_CODES as i,ToolError as a,toolErrorDisposition as o}from"./errors.js";import{createApprovalRequest as s}from"./approval.js";import{bindNestedToolPort as c}from"./nested.js";function l(e,t,n={}){return{isError:!0,error:{message:e,code:t},content:[{type:`text`,text:`Error: ${e}`}],...n.meta===void 0?{}:{meta:n.meta},...n.additionalContext===void 0?{}:{additionalContext:n.additionalContext}}}function u(e){let{catalog:t,call:r,position:a,signal:o}=e,s=t.get(r.toolName),c,u;if(s===void 0)u=l(`no tool named "${r.toolName}" is available`,i.UNKNOWN_TOOL);else{let e=g(r.rawArguments);if(!e.ok)u=l(e.message,i.MALFORMED_ARGUMENTS);else if(s.parse===void 0)c=e.value;else try{c=s.parse(e.value)}catch(e){u=l(`invalid arguments: ${_(e)}`,i.INVALID_ARGUMENTS)}}return{options:e,context:{...a,callId:r.callId,toolName:r.toolName,tool:s,rawArguments:r.rawArguments,args:c,signal:o,...e.parentCallId===void 0?{}:{parentCallId:e.parentCallId},...e.logger===void 0?{}:{logger:e.logger}},...u===void 0?{}:{argumentFailure:u},mode:u===void 0?n(s,c):`exclusive`}}async function d(e){if(e.argumentFailure!==void 0)return{kind:`final`,result:e.argumentFailure};let t=await y(e.options.interceptors??[],t=>t.before?.bind(t,e.context),()=>Promise.resolve({kind:`allow`}))();if(t.kind===`deny`)return{kind:`final`,result:l(t.reason,i.DENIED)};if(t.kind===`ask`){let n=e.options.approvals;if(n===void 0)return{kind:`final`,result:l(t.reason??`this tool requires approval, and no approver is configured`,i.DENIED)};let r=s({...e.options.position,callId:e.context.callId,toolName:e.context.toolName,args:e.context.args,turn:e.context.turn,step:e.context.step,...t.reason===void 0?{}:{reason:t.reason}}),o=new AbortController,c=AbortSignal.any([e.context.signal,o.signal]),u=n.request(r,c);try{await e.options.onApprovalRequest?.(r)}catch(t){throw o.abort(t),await u.catch(()=>void 0),e.options.onApprovalSettled?.(`error`,t),t}let d;try{d=await u,e.options.onApprovalSettled?.(d===`abort`||e.context.signal.aborted?`aborted`:`success`)}catch(t){throw e.options.onApprovalSettled?.(e.context.signal.aborted?`aborted`:`error`,t),t}if(d!==`allow`&&d!==`deny`&&d!==`abort`)throw a.fatal(`invalid approval decision`,`INVALID_APPROVAL_DECISION`);if(d===`abort`)throw a.fatal(`the turn was withdrawn while awaiting approval`,i.ABORTED);if(d===`deny`)return{kind:`final`,result:l(t.reason??`the call to "${e.context.toolName}" was not approved`,i.DENIED)}}let n=e.context.tool;return n===void 0?{kind:`final`,result:l(`no tool named "${e.context.toolName}" is available`,i.UNKNOWN_TOOL)}:{kind:`authorized`,call:{...e,tool:n}}}async function f(t){let{context:n,tool:s}=t;if(n.signal.aborted)return l(`the call was cancelled before it started`,i.ABORTED_BEFORE_DISPATCH);let u=async u=>{let d=[],f=!1,p={...t.options.position,turn:n.turn,step:n.step,callId:n.callId,toolName:n.toolName,signal:u,...n.logger===void 0?{}:{logger:n.logger},concludeTurn:()=>{f=!0},addContext:e=>{typeof e==`string`?d.push({type:`text`,text:e}):d.push(...e)}};c(t,p);let m;try{let e=await s.execute(n.args,p);m=e===void 0?void 0:e}catch(e){if(o(e)===`fatal`)throw e;return u.aborted&&!(e instanceof a)?l(`the call was cancelled`,i.ABORTED):l(_(e),e instanceof a?e.code:i.FAILED,{additionalContext:d})}if(m!==void 0&&!e(m))return l(`tool "${s.name}" returned a value that is not lossless JSON; return plain objects, arrays, strings, finite numbers, booleans, or null`,i.INVALID_RESULT);let h,g;try{h=s.render===void 0?r(m):s.render(m,n.args),g=s.meta?.(m,n.args)}catch(e){return{isError:!1,value:m,content:r(m),...d.length===0?{}:{additionalContext:d},...f?{concludesTurn:!0}:{},meta:{renderError:_(e)}}}return{isError:!1,value:m,content:h,...g===void 0?{}:{meta:g},...d.length===0?{}:{additionalContext:d},...f?{concludesTurn:!0}:{}}},d=await y(t.options.interceptors??[],e=>e.around?.bind(e,n),()=>b(s.timeoutMs??t.options.defaultTimeoutMs,n.signal,u,t.options.teardownTimeoutMs??3e4))();if(!d.isError||d.meta!==void 0||s.meta===void 0)return d;try{let e=s.meta(void 0,n.args);return e===void 0?d:{...d,meta:e}}catch{return d}}async function p(e,t){let n=await y(e.options.interceptors??[],n=>n.after?.bind(n,e.context,t),()=>Promise.resolve({kind:`accept`}))();return n.kind===`accept`?t:n.kind===`replace`?t.isError?{isError:!0,error:{message:n.content.map(e=>e.type===`text`?e.text:``).filter(Boolean).join(`
+import{isJsonValue as e}from"../../primitives/json.js";import{waitForSettlement as t}from"../../async/settlement.js";import{executionModeOf as n,renderJsonValue as r}from"./definition.js";import{TOOL_ERROR_CODES as i,ToolError as a,toolErrorDisposition as o}from"./errors.js";import{createApprovalRequest as s}from"./approval.js";import{bindNestedToolPort as c}from"./nested.js";function l(e,t,n={}){return{isError:!0,error:{message:e,code:t},content:[{type:`text`,text:`Error: ${e}`}],...n.meta===void 0?{}:{meta:n.meta},...n.additionalContext===void 0?{}:{additionalContext:n.additionalContext}}}function u(e){let{catalog:t,call:r,position:a,signal:o}=e,s=t.get(r.toolName),c,u;if(s===void 0)u=l(`no tool named "${r.toolName}" is available`,i.UNKNOWN_TOOL);else{let e=g(r.rawArguments);if(!e.ok)u=l(e.message,i.MALFORMED_ARGUMENTS);else if(s.parse===void 0)c=e.value;else try{c=s.parse(e.value)}catch(e){u=l(`invalid arguments: ${_(e)}`,i.INVALID_ARGUMENTS)}}return{options:e,context:{...a,callId:r.callId,toolName:r.toolName,tool:s,rawArguments:r.rawArguments,args:c,signal:o,...e.parentCallId===void 0?{}:{parentCallId:e.parentCallId},...e.logger===void 0?{}:{logger:e.logger}},...u===void 0?{}:{argumentFailure:u},mode:u===void 0?n(s,c):`exclusive`}}async function d(e){if(e.argumentFailure!==void 0)return{kind:`final`,result:e.argumentFailure};let t=await y(e.options.interceptors??[],t=>t.before?.bind(t,e.context),()=>Promise.resolve({kind:`allow`}))();if(t.kind===`deny`)return{kind:`final`,result:l(t.reason,i.DENIED)};if(t.kind===`ask`){let n=e.options.approvals;if(n===void 0)return{kind:`final`,result:l(t.reason??`this tool requires approval, and no approver is configured`,i.DENIED)};let r=s({...e.options.position,callId:e.context.callId,toolName:e.context.toolName,args:e.context.args,turn:e.context.turn,step:e.context.step,...t.reason===void 0?{}:{reason:t.reason}}),o=new AbortController,c=AbortSignal.any([e.context.signal,o.signal]),u=n.request(r,c);try{await e.options.onApprovalRequest?.(r)}catch(t){throw o.abort(t),await u.catch(()=>void 0),e.options.onApprovalSettled?.(`error`,t),t}let d;try{d=await u,e.options.onApprovalSettled?.(d===`abort`||e.context.signal.aborted?`aborted`:`success`)}catch(t){throw e.options.onApprovalSettled?.(e.context.signal.aborted?`aborted`:`error`,t),t}if(d!==`allow`&&d!==`deny`&&d!==`abort`)throw a.fatal(`invalid approval decision`,`INVALID_APPROVAL_DECISION`);if(d===`abort`)throw a.fatal(`the turn was withdrawn while awaiting approval`,i.ABORTED);if(d===`deny`)return{kind:`final`,result:l(t.reason??`the call to "${e.context.toolName}" was not approved`,i.DENIED)}}let n=e.context.tool;return n===void 0?{kind:`final`,result:l(`no tool named "${e.context.toolName}" is available`,i.UNKNOWN_TOOL)}:{kind:`authorized`,call:{...e,tool:n}}}async function f(t){let{context:n,tool:s}=t;if(n.signal.aborted)return l(`the call was cancelled before it started`,i.ABORTED_BEFORE_DISPATCH);let u=async u=>{let d=[],f=!1,p={...t.options.position,turn:n.turn,step:n.step,callId:n.callId,toolName:n.toolName,signal:u,...n.logger===void 0?{}:{logger:n.logger},concludeTurn:()=>{f=!0},addContext:e=>{typeof e==`string`?d.push({type:`text`,text:e}):d.push(...e)}};c(t,p);let m;try{let e=await s.execute(n.args,p);m=e===void 0?void 0:e}catch(e){if(o(e)===`fatal`)throw e;return u.aborted&&!(e instanceof a)?l(`the call was cancelled`,i.ABORTED):l(_(e),e instanceof a?e.code:i.FAILED,{...d.length===0?{}:{additionalContext:d}})}if(m!==void 0&&!e(m))return l(`tool "${s.name}" returned a value that is not lossless JSON; return plain objects, arrays, strings, finite numbers, booleans, or null`,i.INVALID_RESULT);let h,g;try{h=s.render===void 0?r(m):s.render(m,n.args),g=s.meta?.(m,n.args)}catch(e){return{isError:!1,value:m,content:r(m),...d.length===0?{}:{additionalContext:d},...f?{concludesTurn:!0}:{},meta:{renderError:_(e)}}}return{isError:!1,value:m,content:h,...g===void 0?{}:{meta:g},...d.length===0?{}:{additionalContext:d},...f?{concludesTurn:!0}:{}}},d=await y(t.options.interceptors??[],e=>e.around?.bind(e,n),()=>b(s.timeoutMs??t.options.defaultTimeoutMs,n.signal,u,t.options.teardownTimeoutMs??3e4))();if(!d.isError||d.meta!==void 0||s.meta===void 0)return d;try{let e=s.meta(void 0,n.args);return e===void 0?d:{...d,meta:e}}catch{return d}}async function p(e,t){let n=await y(e.options.interceptors??[],n=>n.after?.bind(n,e.context,t),()=>Promise.resolve({kind:`accept`}))();return n.kind===`accept`?t:n.kind===`replace`?t.isError?{isError:!0,error:{message:n.content.map(e=>e.type===`text`?e.text:``).filter(Boolean).join(`
 `)||`the tool result was replaced by policy`,code:i.DENIED},content:n.content,...n.meta===void 0?{}:{meta:n.meta}}:{isError:!1,value:void 0,content:n.content,...n.meta===void 0?{}:{meta:n.meta},...t.concludesTurn===!0?{concludesTurn:!0}:{}}:{isError:!0,error:{message:n.feedback.map(e=>e.type===`text`?e.text:``).filter(Boolean).join(`
 `)||`the result was blocked by policy`,code:n.code??i.DENIED},content:n.feedback}}async function m(e){if(e.signal.aborted)return l(`the call was cancelled before it started`,i.ABORTED_BEFORE_DISPATCH);let n=v(e.defaultTimeoutMs??6e5,`defaultTimeoutMs`),r=v(e.teardownTimeoutMs??3e4,`teardownTimeoutMs`),o=AbortSignal.timeout(n),s=AbortSignal.any([e.signal,o]),c=h({...e,signal:s,defaultTimeoutMs:n,teardownTimeoutMs:r});try{return await x(c,s)}catch(u){if(!s.aborted)throw u;if(!await t(c,r))throw a.fatal(`tool pipeline ignored cancellation for more than ${r}ms; the in-process operation may still be running`,i.TEARDOWN_TIMEOUT,{cause:u});return o.aborted&&!e.signal.aborted?l(`the tool pipeline exceeded its ${n}ms time limit`,i.TIMEOUT):await c}}async function h(e){let t=await d(u(e));return t.kind===`final`?t.result:await p(t.call,await f(t.call))}function g(e){let t=e.trim();if(t.length===0)return{ok:!0,value:{}};try{return{ok:!0,value:JSON.parse(t)}}catch(e){return{ok:!1,message:`arguments were not valid JSON: ${_(e)}`}}}function _(e){if(e instanceof Error&&e.message.length>0)return e.message;let t=String(e);return t.length>0?t:`the tool failed without a message`}function v(e,t){if(!Number.isSafeInteger(e)||e<1)throw RangeError(`${t} must be a positive safe integer`);return e}function y(e,t,n){let r=n;for(let n=e.length-1;n>=0;n--){let i=e[n];if(i===void 0)continue;let a=t(i);if(a===void 0)continue;let o=r;r=()=>a(o)}return r}async function b(e,n,r,o){if(e===void 0)return await r(n);let s=new AbortController,c=!1,u=setTimeout(()=>{c=!0,s.abort(Error(`tool timed out after ${e}ms`))},e),d=r(AbortSignal.any([n,s.signal]));try{let t=await x(d,s.signal);return c?l(`the tool exceeded its ${e}ms time limit`,i.TIMEOUT):t}catch(n){if(!c)throw n;if(!await t(d,o))throw a.fatal(`tool ignored timeout cancellation for more than ${o}ms; the in-process operation may still be running`,i.TEARDOWN_TIMEOUT,{cause:n});return l(`the tool exceeded its ${e}ms time limit`,i.TIMEOUT)}finally{clearTimeout(u)}}async function x(e,t){if(t.aborted)throw t.reason??Error(`tool timed out`);return await new Promise((n,r)=>{let i=()=>{t.removeEventListener(`abort`,i),r(t.reason??Error(`tool timed out`))};t.addEventListener(`abort`,i,{once:!0}),e.then(e=>{t.removeEventListener(`abort`,i),n(e)},e=>{t.removeEventListener(`abort`,i),r(e)})})}export{d as authorizeToolCall,f as dispatchAuthorizedToolCall,m as dispatchToolCall,p as finalizeToolCall,u as prepareToolCall,l as toolFailure};
 //# sourceMappingURL=pipeline.js.map

package/dist/agent/tool/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/agent/tool/pipeline.ts"],"sourcesContent":["/** Staged tool dispatch: prepare/authorize/dispatch/finalize. */\nimport type { ContentBlock } from '../../message/index.ts'\nimport type { ToolCallId } from '../../primitives/index.ts'\nimport { isJsonValue, type JsonObject, type JsonValue } from '../../primitives/index.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { createApprovalRequest, type ApprovalBroker, type ApprovalRequest } from './approval.ts'\nimport {\n  executionModeOf, renderJsonValue, type ToolCallPosition, type ToolDefinition,\n  type ToolExecutionMode, type ToolExecutionResult, type ToolFailure, type ToolRunContext,\n  type ToolSuccess,\n} from './definition.ts'\nimport { TOOL_ERROR_CODES, ToolError, toolErrorDisposition } from './errors.ts'\nimport type { ToolCatalog } from './registry.ts'\nimport { bindNestedToolPort } from './nested.ts'\nimport type { SdkLogger } from '../../logging/types.ts'\n\nexport interface ToolCallRequest {\n  readonly callId: ToolCallId\n  readonly toolName: string\n  readonly rawArguments: string\n}\nexport interface ToolCallContext extends ToolCallPosition {\n  readonly callId: ToolCallId\n  /**\n   * Set only when a program tool made this call: the outer call's ID. Lets a\n   * policy or durable journal scope decisions and operation IDs to programs.\n   */\n  readonly parentCallId?: ToolCallId\n  readonly toolName: string\n  readonly tool: ToolDefinition | undefined\n  readonly rawArguments: string\n  readonly args: unknown\n  readonly signal: AbortSignal\n  readonly logger?: SdkLogger\n}\nexport type PreToolDecision =\n  | { kind: 'allow' }\n  | { kind: 'deny'; reason: string }\n  | { kind: 'ask'; reason?: string }\nexport type PostToolDecision =\n  | { kind: 'accept' }\n  | { kind: 'replace'; content: readonly ContentBlock[]; meta?: JsonObject }\n  | { kind: 'block'; feedback: readonly ContentBlock[]; code?: string }\nexport interface ToolInterceptor {\n  readonly name: string\n  readonly before?: (call: ToolCallContext, next: () => Promise<PreToolDecision>) => Promise<PreToolDecision>\n  readonly around?: (call: ToolCallContext, next: () => Promise<ToolExecutionResult>) => Promise<ToolExecutionResult>\n  readonly after?: (\n    call: ToolCallContext,\n    result: ToolExecutionResult,\n    next: () => Promise<PostToolDecision>,\n  ) => Promise<PostToolDecision>\n}\nexport interface DispatchToolCallOptions {\n  readonly catalog: ToolCatalog\n  readonly call: ToolCallRequest\n  readonly position: ToolCallPosition\n  readonly signal: AbortSignal\n  readonly logger?: SdkLogger\n  readonly interceptors?: readonly ToolInterceptor[]\n  readonly approvals?: ApprovalBroker\n  /** Maximum wait after a timed-out in-process tool ignores cancellation. */\n  readonly teardownTimeoutMs?: number\n  /** Timeout used when the tool definition does not declare one. */\n  readonly defaultTimeoutMs?: number\n  /** Called immediately before an approval broker is awaited. */\n  readonly onApprovalRequest?: (request: ApprovalRequest) => Promise<void> | void\n  /** Called exactly once after an approval wait settles or fails. */\n  readonly onApprovalSettled?: (status: 'success' | 'error' | 'aborted', error?: unknown) => void\n  /** The outer program call, when this call is a program's child. */\n  readonly parentCallId?: ToolCallId\n}\nexport interface PreparedToolCall {\n  readonly options: DispatchToolCallOptions\n  readonly context: ToolCallContext\n  readonly argumentFailure?: ToolFailure\n  readonly mode: ToolExecutionMode\n}\nexport interface AuthorizedToolCall extends PreparedToolCall { readonly tool: ToolDefinition }\nexport type AuthorizationOutcome =\n  | { readonly kind: 'authorized'; readonly call: AuthorizedToolCall }\n  | { readonly kind: 'final'; readonly result: ToolExecutionResult }\n\nexport function toolFailure(\n  message: string,\n  code: string,\n  extra: { meta?: JsonObject; additionalContext?: readonly ContentBlock[] } = {},\n): ToolFailure {\n  return {\n    isError: true,\n    error: { message, code },\n    content: [{ type: 'text', text: `Error: ${message}` }],\n    ...extra.meta === undefined ? {} : { meta: extra.meta },\n    ...extra.additionalContext === undefined ? {} : { additionalContext: extra.additionalContext },\n  }\n}\n\n/** Resolve, parse exactly once, validate and classify one call. */\nexport function prepareToolCall(options: DispatchToolCallOptions): PreparedToolCall {\n  const { catalog, call, position, signal } = options\n  const tool = catalog.get(call.toolName)\n  let args: unknown\n  let argumentFailure: ToolFailure | undefined\n  if (tool === undefined) {\n    argumentFailure = toolFailure(`no tool named \"${call.toolName}\" is available`, TOOL_ERROR_CODES.UNKNOWN_TOOL)\n  } else {\n    const parsed = parseRawArguments(call.rawArguments)\n    if (!parsed.ok) argumentFailure = toolFailure(parsed.message, TOOL_ERROR_CODES.MALFORMED_ARGUMENTS)\n    else if (tool.parse === undefined) args = parsed.value\n    else {\n      try { args = tool.parse(parsed.value) }\n      catch (error: unknown) {\n        argumentFailure = toolFailure(`invalid arguments: ${messageOf(error)}`, TOOL_ERROR_CODES.INVALID_ARGUMENTS)\n      }\n    }\n  }\n  const context: ToolCallContext = {\n    ...position, callId: call.callId, toolName: call.toolName, tool,\n    rawArguments: call.rawArguments, args, signal,\n    ...(options.parentCallId === undefined ? {} : { parentCallId: options.parentCallId }),\n    ...(options.logger === undefined ? {} : { logger: options.logger }),\n  }\n  return {\n    options, context,\n    ...argumentFailure === undefined ? {} : { argumentFailure },\n    mode: argumentFailure === undefined ? executionModeOf(tool, args) : 'exclusive',\n  }\n}\n\n/** Ordered pre-policy and approval stage. */\nexport async function authorizeToolCall(prepared: PreparedToolCall): Promise<AuthorizationOutcome> {\n  if (prepared.argumentFailure !== undefined) return { kind: 'final', result: prepared.argumentFailure }\n  const interceptors = prepared.options.interceptors ?? []\n  const decision = await chain<PreToolDecision>(\n    interceptors,\n    interceptor => interceptor.before?.bind(interceptor, prepared.context),\n    () => Promise.resolve({ kind: 'allow' } as const),\n  )()\n  if (decision.kind === 'deny') return { kind: 'final', result: toolFailure(decision.reason, TOOL_ERROR_CODES.DENIED) }\n  if (decision.kind === 'ask') {\n    const broker = prepared.options.approvals\n    if (broker === undefined) {\n      return { kind: 'final', result: toolFailure(\n        decision.reason ?? 'this tool requires approval, and no approver is configured',\n        TOOL_ERROR_CODES.DENIED,\n      ) }\n    }\n    const request = createApprovalRequest({\n      ...prepared.options.position,\n      callId: prepared.context.callId, toolName: prepared.context.toolName,\n      args: prepared.context.args, turn: prepared.context.turn, step: prepared.context.step,\n      ...decision.reason === undefined ? {} : { reason: decision.reason },\n    })\n    // Start the broker first. The streamed approval event is backpressured, and\n    // a UI is allowed to answer synchronously while handling it. Publishing\n    // before request() installs its waiter loses that answer and parks forever.\n    const publication = new AbortController()\n    const signal = AbortSignal.any([prepared.context.signal, publication.signal])\n    const pending = broker.request(request, signal)\n    try {\n      await prepared.options.onApprovalRequest?.(request)\n    } catch (error: unknown) {\n      publication.abort(error)\n      await pending.catch(() => undefined)\n      prepared.options.onApprovalSettled?.('error', error)\n      throw error\n    }\n    let answer: Awaited<typeof pending>\n    try {\n      answer = await pending\n      prepared.options.onApprovalSettled?.(\n        answer === 'abort' || prepared.context.signal.aborted ? 'aborted' : 'success',\n      )\n    } catch (error) {\n      prepared.options.onApprovalSettled?.(prepared.context.signal.aborted ? 'aborted' : 'error', error)\n      throw error\n    }\n    if (answer !== 'allow' && answer !== 'deny' && answer !== 'abort') throw ToolError.fatal('invalid approval decision', 'INVALID_APPROVAL_DECISION')\n    if (answer === 'abort') throw ToolError.fatal('the turn was withdrawn while awaiting approval', TOOL_ERROR_CODES.ABORTED)\n    if (answer === 'deny') return { kind: 'final', result: toolFailure(\n      decision.reason ?? `the call to \"${prepared.context.toolName}\" was not approved`,\n      TOOL_ERROR_CODES.DENIED,\n    ) }\n  }\n  const tool = prepared.context.tool\n  if (tool === undefined) return { kind: 'final', result: toolFailure(\n    `no tool named \"${prepared.context.toolName}\" is available`, TOOL_ERROR_CODES.UNKNOWN_TOOL,\n  ) }\n  return { kind: 'authorized', call: { ...prepared, tool } }\n}\n\n/** Body/around stage; this is the only stage the scheduler overlaps. */\nexport async function dispatchAuthorizedToolCall(call: AuthorizedToolCall): Promise<ToolExecutionResult> {\n  const { context, tool } = call\n  if (context.signal.aborted) return toolFailure(\n    'the call was cancelled before it started', TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH,\n  )\n  const body = async (signal: AbortSignal): Promise<ToolExecutionResult> => {\n    const extraContext: ContentBlock[] = []\n    let concludes = false\n    const runContext: ToolRunContext = {\n      ...call.options.position,\n      turn: context.turn, step: context.step, callId: context.callId,\n      toolName: context.toolName, signal,\n      ...(context.logger === undefined ? {} : { logger: context.logger }),\n      concludeTurn: () => { concludes = true },\n      addContext: content => {\n        if (typeof content === 'string') extraContext.push({ type: 'text', text: content })\n        else extraContext.push(...content)\n      },\n    }\n    bindNestedToolPort(call, runContext)\n    let value: JsonValue | undefined\n    try {\n      const returned = await tool.execute(context.args as never, runContext)\n      value = returned === undefined ? undefined : returned\n    } catch (error: unknown) {\n      if (toolErrorDisposition(error) === 'fatal') throw error\n      if (signal.aborted && !(error instanceof ToolError)) return toolFailure('the call was cancelled', TOOL_ERROR_CODES.ABORTED)\n      return toolFailure(messageOf(error), error instanceof ToolError ? error.code : TOOL_ERROR_CODES.FAILED, {\n        additionalContext: extraContext,\n      })\n    }\n    if (value !== undefined && !isJsonValue(value)) return toolFailure(\n      `tool \"${tool.name}\" returned a value that is not lossless JSON; return plain objects, arrays, strings, finite numbers, booleans, or null`,\n      TOOL_ERROR_CODES.INVALID_RESULT,\n    )\n    let content: readonly ContentBlock[]\n    let meta: JsonObject | undefined\n    try {\n      content = tool.render === undefined ? renderJsonValue(value) : tool.render(value, context.args as never)\n      meta = tool.meta?.(value, context.args as never)\n    } catch (error: unknown) {\n      return {\n        isError: false, value, content: renderJsonValue(value),\n        ...extraContext.length === 0 ? {} : { additionalContext: extraContext },\n        ...concludes ? { concludesTurn: true as const } : {},\n        meta: { renderError: messageOf(error) },\n      } satisfies ToolSuccess\n    }\n    return {\n      isError: false, value, content,\n      ...meta === undefined ? {} : { meta },\n      ...extraContext.length === 0 ? {} : { additionalContext: extraContext },\n      ...concludes ? { concludesTurn: true as const } : {},\n    } satisfies ToolSuccess\n  }\n  const executed = await chain<ToolExecutionResult>(\n    call.options.interceptors ?? [],\n    interceptor => interceptor.around?.bind(interceptor, context),\n    () => withTimeout(\n      tool.timeoutMs ?? call.options.defaultTimeoutMs,\n      context.signal,\n      body,\n      call.options.teardownTimeoutMs ?? 30_000,\n    ),\n  )()\n  if (!executed.isError || executed.meta !== undefined || tool.meta === undefined) return executed\n  // Provenance and UI metadata are just as important for a failed call as for a\n  // successful one. In particular, remote bridges use this to identify which\n  // integration produced the error. Metadata is a side channel, so a buggy\n  // metadata callback must never replace the original tool failure.\n  try {\n    const meta = tool.meta(undefined, context.args as never)\n    return meta === undefined ? executed : { ...executed, meta }\n  } catch {\n    return executed\n  }\n}\n\n/** Ordered post-policy stage. */\nexport async function finalizeToolCall(call: AuthorizedToolCall, executed: ToolExecutionResult): Promise<ToolExecutionResult> {\n  const verdict = await chain<PostToolDecision>(\n    call.options.interceptors ?? [],\n    interceptor => interceptor.after?.bind(interceptor, call.context, executed),\n    () => Promise.resolve({ kind: 'accept' } as const),\n  )()\n  if (verdict.kind === 'accept') return executed\n  if (verdict.kind === 'replace') {\n    // Replacement is a sanitization boundary, not a model-content-only edit.\n    // Rebuild the envelope so raw value, metadata, errors, and additional\n    // context cannot escape through public events, history, or telemetry.\n    if (executed.isError) {\n      const text = verdict.content.map(block => block.type === 'text' ? block.text : '').filter(Boolean).join('\\n')\n      return {\n        isError: true,\n        error: { message: text || 'the tool result was replaced by policy', code: TOOL_ERROR_CODES.DENIED },\n        content: verdict.content,\n        ...verdict.meta === undefined ? {} : { meta: verdict.meta },\n      }\n    }\n    return {\n      isError: false,\n      value: undefined,\n      content: verdict.content,\n      ...verdict.meta === undefined ? {} : { meta: verdict.meta },\n      ...executed.concludesTurn === true ? { concludesTurn: true as const } : {},\n    }\n  }\n  const text = verdict.feedback.map(block => block.type === 'text' ? block.text : '').filter(Boolean).join('\\n')\n  return {\n    isError: true,\n    error: { message: text || 'the result was blocked by policy', code: verdict.code ?? TOOL_ERROR_CODES.DENIED },\n    content: verdict.feedback,\n  }\n}\n\n/** Compatibility facade for callers that do not need scheduling. */\nexport async function dispatchToolCall(options: DispatchToolCallOptions): Promise<ToolExecutionResult> {\n  if (options.signal.aborted) {\n    return toolFailure('the call was cancelled before it started', TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH)\n  }\n  const timeoutMs = positiveSafeInteger(options.defaultTimeoutMs ?? 10 * 60_000, 'defaultTimeoutMs')\n  const teardownTimeoutMs = positiveSafeInteger(options.teardownTimeoutMs ?? 30_000, 'teardownTimeoutMs')\n  const deadline = AbortSignal.timeout(timeoutMs)\n  const signal = AbortSignal.any([options.signal, deadline])\n  const pending = dispatchToolCallInternal({\n    ...options, signal, defaultTimeoutMs: timeoutMs, teardownTimeoutMs,\n  })\n  try {\n    return await raceWithSignal(pending, signal)\n  } catch (error: unknown) {\n    if (!signal.aborted) throw error\n    const settled = await waitForSettlement(pending, teardownTimeoutMs)\n    if (!settled) {\n      throw ToolError.fatal(\n        `tool pipeline ignored cancellation for more than ${teardownTimeoutMs}ms; the in-process operation may still be running`,\n        TOOL_ERROR_CODES.TEARDOWN_TIMEOUT,\n        { cause: error },\n      )\n    }\n    if (deadline.aborted && !options.signal.aborted) {\n      return toolFailure(`the tool pipeline exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n    }\n    return await pending\n  }\n}\n\nasync function dispatchToolCallInternal(options: DispatchToolCallOptions): Promise<ToolExecutionResult> {\n  const authorization = await authorizeToolCall(prepareToolCall(options))\n  if (authorization.kind === 'final') return authorization.result\n  return await finalizeToolCall(authorization.call, await dispatchAuthorizedToolCall(authorization.call))\n}\n\nfunction parseRawArguments(raw: string): { ok: true; value: unknown } | { ok: false; message: string } {\n  const trimmed = raw.trim()\n  if (trimmed.length === 0) return { ok: true, value: {} }\n  try { return { ok: true, value: JSON.parse(trimmed) as unknown } }\n  catch (error: unknown) { return { ok: false, message: `arguments were not valid JSON: ${messageOf(error)}` } }\n}\nfunction messageOf(value: unknown): string {\n  if (value instanceof Error && value.message.length > 0) return value.message\n  const rendered = String(value)\n  return rendered.length > 0 ? rendered : 'the tool failed without a message'\n}\nfunction positiveSafeInteger(value: number, field: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) throw new RangeError(`${field} must be a positive safe integer`)\n  return value\n}\nfunction chain<T>(\n  interceptors: readonly ToolInterceptor[],\n  pick: (interceptor: ToolInterceptor) => ((next: () => Promise<T>) => Promise<T>) | undefined,\n  terminal: () => Promise<T>,\n): () => Promise<T> {\n  let next = terminal\n  for (let index = interceptors.length - 1; index >= 0; index--) {\n    const interceptor = interceptors[index]\n    if (interceptor === undefined) continue\n    const hook = pick(interceptor)\n    if (hook === undefined) continue\n    const inner = next\n    next = () => hook(inner)\n  }\n  return next\n}\nasync function withTimeout(\n  timeoutMs: number | undefined,\n  outer: AbortSignal,\n  run: (signal: AbortSignal) => Promise<ToolExecutionResult>,\n  teardownTimeoutMs: number,\n): Promise<ToolExecutionResult> {\n  if (timeoutMs === undefined) return await run(outer)\n  const expiry = new AbortController()\n  let expired = false\n  const timer = setTimeout(() => {\n    expired = true\n    expiry.abort(new Error(`tool timed out after ${timeoutMs}ms`))\n  }, timeoutMs)\n  const pending = run(AbortSignal.any([outer, expiry.signal]))\n  try {\n    const result = await raceWithSignal(pending, expiry.signal)\n    return expired\n      ? toolFailure(`the tool exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n      : result\n  } catch (error: unknown) {\n    if (!expired) throw error\n    const settled = await waitForSettlement(pending, teardownTimeoutMs)\n    if (!settled) {\n      throw ToolError.fatal(\n        `tool ignored timeout cancellation for more than ${teardownTimeoutMs}ms; the in-process operation may still be running`,\n        TOOL_ERROR_CODES.TEARDOWN_TIMEOUT,\n        { cause: error },\n      )\n    }\n    return toolFailure(`the tool exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n  } finally { clearTimeout(timer) }\n}\n\nasync function raceWithSignal<T>(pending: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) throw signal.reason ?? new Error('tool timed out')\n  return await new Promise<T>((resolve, reject) => {\n    const abort = () => {\n      signal.removeEventListener('abort', abort)\n      reject(signal.reason ?? new Error('tool timed out'))\n    }\n    signal.addEventListener('abort', abort, { once: true })\n    void pending.then(\n      value => { signal.removeEventListener('abort', abort); resolve(value) },\n      error => { signal.removeEventListener('abort', abort); reject(error) },\n    )\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"pipeline.js","names":[],"sources":["../../../src/agent/tool/pipeline.ts"],"sourcesContent":["/** Staged tool dispatch: prepare/authorize/dispatch/finalize. */\nimport type { ContentBlock } from '../../message/index.ts'\nimport type { ToolCallId } from '../../primitives/index.ts'\nimport { isJsonValue, type JsonObject, type JsonValue } from '../../primitives/index.ts'\nimport { waitForSettlement } from '../../async/index.ts'\nimport { createApprovalRequest, type ApprovalBroker, type ApprovalRequest } from './approval.ts'\nimport {\n  executionModeOf, renderJsonValue, type ToolCallPosition, type ToolDefinition,\n  type ToolExecutionMode, type ToolExecutionResult, type ToolFailure, type ToolRunContext,\n  type ToolSuccess,\n} from './definition.ts'\nimport { TOOL_ERROR_CODES, ToolError, toolErrorDisposition } from './errors.ts'\nimport type { ToolCatalog } from './registry.ts'\nimport { bindNestedToolPort } from './nested.ts'\nimport type { SdkLogger } from '../../logging/types.ts'\n\nexport interface ToolCallRequest {\n  readonly callId: ToolCallId\n  readonly toolName: string\n  readonly rawArguments: string\n}\nexport interface ToolCallContext extends ToolCallPosition {\n  readonly callId: ToolCallId\n  /**\n   * Set only when a program tool made this call: the outer call's ID. Lets a\n   * policy or durable journal scope decisions and operation IDs to programs.\n   */\n  readonly parentCallId?: ToolCallId\n  readonly toolName: string\n  readonly tool: ToolDefinition | undefined\n  readonly rawArguments: string\n  readonly args: unknown\n  readonly signal: AbortSignal\n  readonly logger?: SdkLogger\n}\nexport type PreToolDecision =\n  | { kind: 'allow' }\n  | { kind: 'deny'; reason: string }\n  | { kind: 'ask'; reason?: string }\nexport type PostToolDecision =\n  | { kind: 'accept' }\n  | { kind: 'replace'; content: readonly ContentBlock[]; meta?: JsonObject }\n  | { kind: 'block'; feedback: readonly ContentBlock[]; code?: string }\nexport interface ToolInterceptor {\n  readonly name: string\n  readonly before?: (call: ToolCallContext, next: () => Promise<PreToolDecision>) => Promise<PreToolDecision>\n  readonly around?: (call: ToolCallContext, next: () => Promise<ToolExecutionResult>) => Promise<ToolExecutionResult>\n  readonly after?: (\n    call: ToolCallContext,\n    result: ToolExecutionResult,\n    next: () => Promise<PostToolDecision>,\n  ) => Promise<PostToolDecision>\n}\nexport interface DispatchToolCallOptions {\n  readonly catalog: ToolCatalog\n  readonly call: ToolCallRequest\n  readonly position: ToolCallPosition\n  readonly signal: AbortSignal\n  readonly logger?: SdkLogger\n  readonly interceptors?: readonly ToolInterceptor[]\n  readonly approvals?: ApprovalBroker\n  /** Maximum wait after a timed-out in-process tool ignores cancellation. */\n  readonly teardownTimeoutMs?: number\n  /** Timeout used when the tool definition does not declare one. */\n  readonly defaultTimeoutMs?: number\n  /** Called immediately before an approval broker is awaited. */\n  readonly onApprovalRequest?: (request: ApprovalRequest) => Promise<void> | void\n  /** Called exactly once after an approval wait settles or fails. */\n  readonly onApprovalSettled?: (status: 'success' | 'error' | 'aborted', error?: unknown) => void\n  /** The outer program call, when this call is a program's child. */\n  readonly parentCallId?: ToolCallId\n}\nexport interface PreparedToolCall {\n  readonly options: DispatchToolCallOptions\n  readonly context: ToolCallContext\n  readonly argumentFailure?: ToolFailure\n  readonly mode: ToolExecutionMode\n}\nexport interface AuthorizedToolCall extends PreparedToolCall { readonly tool: ToolDefinition }\nexport type AuthorizationOutcome =\n  | { readonly kind: 'authorized'; readonly call: AuthorizedToolCall }\n  | { readonly kind: 'final'; readonly result: ToolExecutionResult }\n\nexport function toolFailure(\n  message: string,\n  code: string,\n  extra: { meta?: JsonObject; additionalContext?: readonly ContentBlock[] } = {},\n): ToolFailure {\n  return {\n    isError: true,\n    error: { message, code },\n    content: [{ type: 'text', text: `Error: ${message}` }],\n    ...extra.meta === undefined ? {} : { meta: extra.meta },\n    ...extra.additionalContext === undefined ? {} : { additionalContext: extra.additionalContext },\n  }\n}\n\n/** Resolve, parse exactly once, validate and classify one call. */\nexport function prepareToolCall(options: DispatchToolCallOptions): PreparedToolCall {\n  const { catalog, call, position, signal } = options\n  const tool = catalog.get(call.toolName)\n  let args: unknown\n  let argumentFailure: ToolFailure | undefined\n  if (tool === undefined) {\n    argumentFailure = toolFailure(`no tool named \"${call.toolName}\" is available`, TOOL_ERROR_CODES.UNKNOWN_TOOL)\n  } else {\n    const parsed = parseRawArguments(call.rawArguments)\n    if (!parsed.ok) argumentFailure = toolFailure(parsed.message, TOOL_ERROR_CODES.MALFORMED_ARGUMENTS)\n    else if (tool.parse === undefined) args = parsed.value\n    else {\n      try { args = tool.parse(parsed.value) }\n      catch (error: unknown) {\n        argumentFailure = toolFailure(`invalid arguments: ${messageOf(error)}`, TOOL_ERROR_CODES.INVALID_ARGUMENTS)\n      }\n    }\n  }\n  const context: ToolCallContext = {\n    ...position, callId: call.callId, toolName: call.toolName, tool,\n    rawArguments: call.rawArguments, args, signal,\n    ...(options.parentCallId === undefined ? {} : { parentCallId: options.parentCallId }),\n    ...(options.logger === undefined ? {} : { logger: options.logger }),\n  }\n  return {\n    options, context,\n    ...argumentFailure === undefined ? {} : { argumentFailure },\n    mode: argumentFailure === undefined ? executionModeOf(tool, args) : 'exclusive',\n  }\n}\n\n/** Ordered pre-policy and approval stage. */\nexport async function authorizeToolCall(prepared: PreparedToolCall): Promise<AuthorizationOutcome> {\n  if (prepared.argumentFailure !== undefined) return { kind: 'final', result: prepared.argumentFailure }\n  const interceptors = prepared.options.interceptors ?? []\n  const decision = await chain<PreToolDecision>(\n    interceptors,\n    interceptor => interceptor.before?.bind(interceptor, prepared.context),\n    () => Promise.resolve({ kind: 'allow' } as const),\n  )()\n  if (decision.kind === 'deny') return { kind: 'final', result: toolFailure(decision.reason, TOOL_ERROR_CODES.DENIED) }\n  if (decision.kind === 'ask') {\n    const broker = prepared.options.approvals\n    if (broker === undefined) {\n      return { kind: 'final', result: toolFailure(\n        decision.reason ?? 'this tool requires approval, and no approver is configured',\n        TOOL_ERROR_CODES.DENIED,\n      ) }\n    }\n    const request = createApprovalRequest({\n      ...prepared.options.position,\n      callId: prepared.context.callId, toolName: prepared.context.toolName,\n      args: prepared.context.args, turn: prepared.context.turn, step: prepared.context.step,\n      ...decision.reason === undefined ? {} : { reason: decision.reason },\n    })\n    // Start the broker first. The streamed approval event is backpressured, and\n    // a UI is allowed to answer synchronously while handling it. Publishing\n    // before request() installs its waiter loses that answer and parks forever.\n    const publication = new AbortController()\n    const signal = AbortSignal.any([prepared.context.signal, publication.signal])\n    const pending = broker.request(request, signal)\n    try {\n      await prepared.options.onApprovalRequest?.(request)\n    } catch (error: unknown) {\n      publication.abort(error)\n      await pending.catch(() => undefined)\n      prepared.options.onApprovalSettled?.('error', error)\n      throw error\n    }\n    let answer: Awaited<typeof pending>\n    try {\n      answer = await pending\n      prepared.options.onApprovalSettled?.(\n        answer === 'abort' || prepared.context.signal.aborted ? 'aborted' : 'success',\n      )\n    } catch (error) {\n      prepared.options.onApprovalSettled?.(prepared.context.signal.aborted ? 'aborted' : 'error', error)\n      throw error\n    }\n    if (answer !== 'allow' && answer !== 'deny' && answer !== 'abort') throw ToolError.fatal('invalid approval decision', 'INVALID_APPROVAL_DECISION')\n    if (answer === 'abort') throw ToolError.fatal('the turn was withdrawn while awaiting approval', TOOL_ERROR_CODES.ABORTED)\n    if (answer === 'deny') return { kind: 'final', result: toolFailure(\n      decision.reason ?? `the call to \"${prepared.context.toolName}\" was not approved`,\n      TOOL_ERROR_CODES.DENIED,\n    ) }\n  }\n  const tool = prepared.context.tool\n  if (tool === undefined) return { kind: 'final', result: toolFailure(\n    `no tool named \"${prepared.context.toolName}\" is available`, TOOL_ERROR_CODES.UNKNOWN_TOOL,\n  ) }\n  return { kind: 'authorized', call: { ...prepared, tool } }\n}\n\n/** Body/around stage; this is the only stage the scheduler overlaps. */\nexport async function dispatchAuthorizedToolCall(call: AuthorizedToolCall): Promise<ToolExecutionResult> {\n  const { context, tool } = call\n  if (context.signal.aborted) return toolFailure(\n    'the call was cancelled before it started', TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH,\n  )\n  const body = async (signal: AbortSignal): Promise<ToolExecutionResult> => {\n    const extraContext: ContentBlock[] = []\n    let concludes = false\n    const runContext: ToolRunContext = {\n      ...call.options.position,\n      turn: context.turn, step: context.step, callId: context.callId,\n      toolName: context.toolName, signal,\n      ...(context.logger === undefined ? {} : { logger: context.logger }),\n      concludeTurn: () => { concludes = true },\n      addContext: content => {\n        if (typeof content === 'string') extraContext.push({ type: 'text', text: content })\n        else extraContext.push(...content)\n      },\n    }\n    bindNestedToolPort(call, runContext)\n    let value: JsonValue | undefined\n    try {\n      const returned = await tool.execute(context.args as never, runContext)\n      value = returned === undefined ? undefined : returned\n    } catch (error: unknown) {\n      if (toolErrorDisposition(error) === 'fatal') throw error\n      if (signal.aborted && !(error instanceof ToolError)) return toolFailure('the call was cancelled', TOOL_ERROR_CODES.ABORTED)\n      return toolFailure(messageOf(error), error instanceof ToolError ? error.code : TOOL_ERROR_CODES.FAILED, {\n        ...extraContext.length === 0 ? {} : { additionalContext: extraContext },\n      })\n    }\n    if (value !== undefined && !isJsonValue(value)) return toolFailure(\n      `tool \"${tool.name}\" returned a value that is not lossless JSON; return plain objects, arrays, strings, finite numbers, booleans, or null`,\n      TOOL_ERROR_CODES.INVALID_RESULT,\n    )\n    let content: readonly ContentBlock[]\n    let meta: JsonObject | undefined\n    try {\n      content = tool.render === undefined ? renderJsonValue(value) : tool.render(value, context.args as never)\n      meta = tool.meta?.(value, context.args as never)\n    } catch (error: unknown) {\n      return {\n        isError: false, value, content: renderJsonValue(value),\n        ...extraContext.length === 0 ? {} : { additionalContext: extraContext },\n        ...concludes ? { concludesTurn: true as const } : {},\n        meta: { renderError: messageOf(error) },\n      } satisfies ToolSuccess\n    }\n    return {\n      isError: false, value, content,\n      ...meta === undefined ? {} : { meta },\n      ...extraContext.length === 0 ? {} : { additionalContext: extraContext },\n      ...concludes ? { concludesTurn: true as const } : {},\n    } satisfies ToolSuccess\n  }\n  const executed = await chain<ToolExecutionResult>(\n    call.options.interceptors ?? [],\n    interceptor => interceptor.around?.bind(interceptor, context),\n    () => withTimeout(\n      tool.timeoutMs ?? call.options.defaultTimeoutMs,\n      context.signal,\n      body,\n      call.options.teardownTimeoutMs ?? 30_000,\n    ),\n  )()\n  if (!executed.isError || executed.meta !== undefined || tool.meta === undefined) return executed\n  // Provenance and UI metadata are just as important for a failed call as for a\n  // successful one. In particular, remote bridges use this to identify which\n  // integration produced the error. Metadata is a side channel, so a buggy\n  // metadata callback must never replace the original tool failure.\n  try {\n    const meta = tool.meta(undefined, context.args as never)\n    return meta === undefined ? executed : { ...executed, meta }\n  } catch {\n    return executed\n  }\n}\n\n/** Ordered post-policy stage. */\nexport async function finalizeToolCall(call: AuthorizedToolCall, executed: ToolExecutionResult): Promise<ToolExecutionResult> {\n  const verdict = await chain<PostToolDecision>(\n    call.options.interceptors ?? [],\n    interceptor => interceptor.after?.bind(interceptor, call.context, executed),\n    () => Promise.resolve({ kind: 'accept' } as const),\n  )()\n  if (verdict.kind === 'accept') return executed\n  if (verdict.kind === 'replace') {\n    // Replacement is a sanitization boundary, not a model-content-only edit.\n    // Rebuild the envelope so raw value, metadata, errors, and additional\n    // context cannot escape through public events, history, or telemetry.\n    if (executed.isError) {\n      const text = verdict.content.map(block => block.type === 'text' ? block.text : '').filter(Boolean).join('\\n')\n      return {\n        isError: true,\n        error: { message: text || 'the tool result was replaced by policy', code: TOOL_ERROR_CODES.DENIED },\n        content: verdict.content,\n        ...verdict.meta === undefined ? {} : { meta: verdict.meta },\n      }\n    }\n    return {\n      isError: false,\n      value: undefined,\n      content: verdict.content,\n      ...verdict.meta === undefined ? {} : { meta: verdict.meta },\n      ...executed.concludesTurn === true ? { concludesTurn: true as const } : {},\n    }\n  }\n  const text = verdict.feedback.map(block => block.type === 'text' ? block.text : '').filter(Boolean).join('\\n')\n  return {\n    isError: true,\n    error: { message: text || 'the result was blocked by policy', code: verdict.code ?? TOOL_ERROR_CODES.DENIED },\n    content: verdict.feedback,\n  }\n}\n\n/** Compatibility facade for callers that do not need scheduling. */\nexport async function dispatchToolCall(options: DispatchToolCallOptions): Promise<ToolExecutionResult> {\n  if (options.signal.aborted) {\n    return toolFailure('the call was cancelled before it started', TOOL_ERROR_CODES.ABORTED_BEFORE_DISPATCH)\n  }\n  const timeoutMs = positiveSafeInteger(options.defaultTimeoutMs ?? 10 * 60_000, 'defaultTimeoutMs')\n  const teardownTimeoutMs = positiveSafeInteger(options.teardownTimeoutMs ?? 30_000, 'teardownTimeoutMs')\n  const deadline = AbortSignal.timeout(timeoutMs)\n  const signal = AbortSignal.any([options.signal, deadline])\n  const pending = dispatchToolCallInternal({\n    ...options, signal, defaultTimeoutMs: timeoutMs, teardownTimeoutMs,\n  })\n  try {\n    return await raceWithSignal(pending, signal)\n  } catch (error: unknown) {\n    if (!signal.aborted) throw error\n    const settled = await waitForSettlement(pending, teardownTimeoutMs)\n    if (!settled) {\n      throw ToolError.fatal(\n        `tool pipeline ignored cancellation for more than ${teardownTimeoutMs}ms; the in-process operation may still be running`,\n        TOOL_ERROR_CODES.TEARDOWN_TIMEOUT,\n        { cause: error },\n      )\n    }\n    if (deadline.aborted && !options.signal.aborted) {\n      return toolFailure(`the tool pipeline exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n    }\n    return await pending\n  }\n}\n\nasync function dispatchToolCallInternal(options: DispatchToolCallOptions): Promise<ToolExecutionResult> {\n  const authorization = await authorizeToolCall(prepareToolCall(options))\n  if (authorization.kind === 'final') return authorization.result\n  return await finalizeToolCall(authorization.call, await dispatchAuthorizedToolCall(authorization.call))\n}\n\nfunction parseRawArguments(raw: string): { ok: true; value: unknown } | { ok: false; message: string } {\n  const trimmed = raw.trim()\n  if (trimmed.length === 0) return { ok: true, value: {} }\n  try { return { ok: true, value: JSON.parse(trimmed) as unknown } }\n  catch (error: unknown) { return { ok: false, message: `arguments were not valid JSON: ${messageOf(error)}` } }\n}\nfunction messageOf(value: unknown): string {\n  if (value instanceof Error && value.message.length > 0) return value.message\n  const rendered = String(value)\n  return rendered.length > 0 ? rendered : 'the tool failed without a message'\n}\nfunction positiveSafeInteger(value: number, field: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) throw new RangeError(`${field} must be a positive safe integer`)\n  return value\n}\nfunction chain<T>(\n  interceptors: readonly ToolInterceptor[],\n  pick: (interceptor: ToolInterceptor) => ((next: () => Promise<T>) => Promise<T>) | undefined,\n  terminal: () => Promise<T>,\n): () => Promise<T> {\n  let next = terminal\n  for (let index = interceptors.length - 1; index >= 0; index--) {\n    const interceptor = interceptors[index]\n    if (interceptor === undefined) continue\n    const hook = pick(interceptor)\n    if (hook === undefined) continue\n    const inner = next\n    next = () => hook(inner)\n  }\n  return next\n}\nasync function withTimeout(\n  timeoutMs: number | undefined,\n  outer: AbortSignal,\n  run: (signal: AbortSignal) => Promise<ToolExecutionResult>,\n  teardownTimeoutMs: number,\n): Promise<ToolExecutionResult> {\n  if (timeoutMs === undefined) return await run(outer)\n  const expiry = new AbortController()\n  let expired = false\n  const timer = setTimeout(() => {\n    expired = true\n    expiry.abort(new Error(`tool timed out after ${timeoutMs}ms`))\n  }, timeoutMs)\n  const pending = run(AbortSignal.any([outer, expiry.signal]))\n  try {\n    const result = await raceWithSignal(pending, expiry.signal)\n    return expired\n      ? toolFailure(`the tool exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n      : result\n  } catch (error: unknown) {\n    if (!expired) throw error\n    const settled = await waitForSettlement(pending, teardownTimeoutMs)\n    if (!settled) {\n      throw ToolError.fatal(\n        `tool ignored timeout cancellation for more than ${teardownTimeoutMs}ms; the in-process operation may still be running`,\n        TOOL_ERROR_CODES.TEARDOWN_TIMEOUT,\n        { cause: error },\n      )\n    }\n    return toolFailure(`the tool exceeded its ${timeoutMs}ms time limit`, TOOL_ERROR_CODES.TIMEOUT)\n  } finally { clearTimeout(timer) }\n}\n\nasync function raceWithSignal<T>(pending: Promise<T>, signal: AbortSignal): Promise<T> {\n  if (signal.aborted) throw signal.reason ?? new Error('tool timed out')\n  return await new Promise<T>((resolve, reject) => {\n    const abort = () => {\n      signal.removeEventListener('abort', abort)\n      reject(signal.reason ?? new Error('tool timed out'))\n    }\n    signal.addEventListener('abort', abort, { once: true })\n    void pending.then(\n      value => { signal.removeEventListener('abort', abort); resolve(value) },\n      error => { signal.removeEventListener('abort', abort); reject(error) },\n    )\n  })\n}\n"],"mappings":"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"}

package/dist/agent.d.ts

@@ -17,8 +17,9 @@ import { ExperimentalProgramGrant, NESTED_TOOL_ERROR_CODES, NestedCallOptions, N
 import { ModelCallPolicyDecision, RunAccountingPort } from "./agent/accounting/contracts.js";
 import { RunTurnOptions } from "./agent/loop/turn/types.js";
 import { runTurn } from "./agent/loop/run-turn.js";
+import { UNCHANGED_ANSWER_MARKER } from "./agent/loop/control-text.js";
 import { InteractiveUserInputBroker, InteractiveUserInputBrokerOptions, UserInputAnswer, UserInputBroker, UserInputDecision, UserInputOption, UserInputQuestion, UserInputRequest, UserInputResponse, createUserInputBroker, fixedUserInputBroker } from "./agent/mode/user-input.js";
-import { AGENT_CONTROL_TOOLS, AgentMode, AgentRunEvent, AgentRunOutcome, BasicAgentOptions, CompletionSubmission, DeepAgentOptions, HumanInLoopAgentOptions, RunAgentOptions, UNCHANGED_ANSWER_MARKER, runAgent } from "./agent/mode/run-agent.js";
+import { AGENT_CONTROL_TOOLS, AgentMode, AgentRunEvent, AgentRunOutcome, BasicAgentOptions, CompletionSubmission, DeepAgentOptions, HumanInLoopAgentOptions, RunAgentOptions, runAgent } from "./agent/mode/run-agent.js";
 import { TeamMemberAttachmentOptions, TeamPort, TeamSessionPort, TeamToolAccess } from "./agent/team/contracts.js";
 import { AgentCompactionConfig, AgentCompactionOptions, resolveCompactionConfig } from "./agent/memory/compaction-config.js";
 import { RunReport, RunTerminalRecord } from "./agent/accounting/delivery-types.js";

package/dist/agent.js

@@ -1 +1 @@
-import{AgentMemory as e,resolveMemoryConfig as t}from"./agent/memory/memory.js";import{normalizeToolPairing as n}from"./agent/history/normalize.js";import{estimateContextTokens as r,estimateMessageTokens as i}from"./agent/memory/token-estimator.js";import{selectCompactablePrefix as a}from"./agent/memory/surface-compaction.js";import{COMPACTION_INSTRUCTION as o,ContextCompactor as s}from"./agent/memory/compaction.js";import{resolveCompactionConfig as c}from"./agent/memory/compaction-config.js";import{projectHistorySurface as l,projectMessages as u}from"./agent/history/project.js";import{defineTool as d,executionModeOf as f,renderJsonValue as p}from"./agent/tool/definition.js";import{SPILL_TOOL_NAME as m,createMemorySpillStore as h,estimateTextBlockTokens as g,estimateTextTokens as _,previewForSpill as v,readSpillTool as y,truncateMiddleToTokens as b}from"./agent/tool/output-budget.js";import{createModelEvidenceReducer as x,diagnosticLineNumbers as S,reduceEvidence as C}from"./agent/tool/evidence-reducer.js";import{createContextOptimizer as w}from"./agent/memory/context-optimizer.js";import{MAX_SKILL_DESCRIPTION_CHARS as T,MAX_SKILL_ID_CHARS as E,MAX_SKILL_INSTRUCTIONS_CHARS as D,MAX_SKILL_NAME_CHARS as O,MAX_SKILL_RESOURCE_CHARS as k,MAX_SKILL_RESOURCE_PATH_CHARS as A,SKILL_ID_PATTERN as j,defineSkill as M,defineSkillProvider as N,validateCandidate as P,validateSkillId as F,validateSkillResourcePath as I,validateSkillSource as L}from"./agent/skill/definition.js";import{SkillCatalog as R}from"./agent/skill/catalog.js";import{SKILL_TOOL_NAMES as z,createSkillTools as B,renderSkillCatalog as V,resolveSkillOptions as H}from"./agent/skill/tools.js";import{authoritativeTokenUsage as U,budgetTokenTotal as W,summarizeModelCallUsage as G}from"./agent/accounting/usage.js";import{REGISTRY_ERROR_CODES as K,ToolRegistry as q}from"./agent/tool/registry.js";import{History as J}from"./agent/history/history.js";import{AGENT_ACCOUNTING_ERROR_CODES as Y,AgentRunError as X}from"./agent/accounting/error.js";import{buildTraceTree as Z}from"./agent/trace/trace.js";import{TOOL_ERROR_CODES as Q,ToolError as $,toolErrorDisposition as ee}from"./agent/tool/errors.js";import{createApprovalBroker as te,createApprovalRequest as ne,fixedApprovalBroker as re,withApprovalPersistence as ie}from"./agent/tool/approval.js";import{NESTED_TOOL_ERROR_CODES as ae,nestedToolPort as oe}from"./agent/tool/nested.js";import{authorizeToolCall as se,dispatchAuthorizedToolCall as ce,dispatchToolCall as le,finalizeToolCall as ue,prepareToolCall as de,toolFailure as fe}from"./agent/tool/pipeline.js";import{runToolCalls as pe}from"./agent/loop/schedule.js";import{runTurn as me}from"./agent/loop/run-turn.js";import{AGENT_CONTROL_TOOLS as he,UNCHANGED_ANSWER_MARKER as ge,runAgent as _e}from"./agent/mode/run-agent.js";import{AgentSession as ve}from"./agent/define/session.js";import{DEFAULT_MIN_WAIT_TIMEOUT_MS as ye,DEFAULT_WAIT_TIMEOUT_MS as be}from"./agent/team/common.js";import{AgentTeam as xe}from"./agent/team/team.js";import{createAgentRuntime as Se}from"./composition/runtime/public.js";import{cloneAgent as Ce,defineAgent as we}from"./composition/agent/author.js";import{createUserInputBroker as Te,fixedUserInputBroker as Ee}from"./agent/mode/user-input.js";import{defineToolFromSchema as De}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as Oe,localToolExecutionBackend as ke}from"./agent/tool/execution.js";import{DefinedAgentTeam as Ae,createDefinedAgentTeam as je}from"./agent/team/composed.js";import{DEFAULT_SPAWN_SETUP_TIMEOUT_MS as Me,DEFAULT_WORKER_CLOSE_TIMEOUT_MS as Ne,ManagedAgentTeam as Pe,completedHistoryPrefix as Fe,createManagedAgentTeam as Ie}from"./agent/team/managed.js";import{defineActionFusion as Le}from"./agent/tool/action-fusion.js";export{Y as AGENT_ACCOUNTING_ERROR_CODES,he as AGENT_CONTROL_TOOLS,e as AgentMemory,X as AgentRunError,ve as AgentSession,xe as AgentTeam,o as COMPACTION_INSTRUCTION,s as ContextCompactor,ye as DEFAULT_MIN_WAIT_TIMEOUT_MS,Me as DEFAULT_SPAWN_SETUP_TIMEOUT_MS,be as DEFAULT_WAIT_TIMEOUT_MS,Ne as DEFAULT_WORKER_CLOSE_TIMEOUT_MS,Ae as DefinedAgentTeam,ae as EXPERIMENTAL_NESTED_TOOL_ERROR_CODES,J as History,T as MAX_SKILL_DESCRIPTION_CHARS,E as MAX_SKILL_ID_CHARS,D as MAX_SKILL_INSTRUCTIONS_CHARS,O as MAX_SKILL_NAME_CHARS,k as MAX_SKILL_RESOURCE_CHARS,A as MAX_SKILL_RESOURCE_PATH_CHARS,Pe as ManagedAgentTeam,j as SKILL_ID_PATTERN,z as SKILL_TOOL_NAMES,m as SPILL_TOOL_NAME,R as SkillCatalog,Q as TOOL_ERROR_CODES,K as TOOL_REGISTRY_ERROR_CODES,$ as ToolError,q as ToolRegistry,ge as UNCHANGED_ANSWER_MARKER,U as authoritativeTokenUsage,se as authorizeToolCall,W as budgetTokenTotal,Z as buildTraceTree,Ce as cloneAgent,Fe as completedHistoryPrefix,Se as createAgentRuntime,te as createApprovalBroker,ne as createApprovalRequest,w as createContextOptimizer,je as createDefinedAgentTeam,Ie as createManagedAgentTeam,h as createMemorySpillStore,x as createModelEvidenceReducer,B as createSkillTools,Oe as createToolExecutionInterceptor,Te as createUserInputBroker,Le as defineActionFusion,we as defineAgent,M as defineSkill,N as defineSkillProvider,d as defineTool,De as defineToolFromSchema,S as diagnosticLineNumbers,ce as dispatchAuthorizedToolCall,le as dispatchToolCall,r as estimateContextTokens,i as estimateMessageTokens,g as estimateTextBlockTokens,_ as estimateTextTokens,f as executionModeOf,oe as experimentalNestedToolPort,ue as finalizeToolCall,re as fixedApprovalBroker,Ee as fixedUserInputBroker,ke as localToolExecutionBackend,n as normalizeToolPairing,de as prepareToolCall,v as previewForSpill,l as projectHistorySurface,u as projectMessages,y as readSpillTool,C as reduceEvidence,p as renderJsonValue,V as renderSkillCatalog,c as resolveCompactionConfig,t as resolveMemoryConfig,H as resolveSkillOptions,_e as runAgent,pe as runToolCalls,me as runTurn,a as selectCompactablePrefix,G as summarizeModelCallUsage,ee as toolErrorDisposition,fe as toolFailure,b as truncateMiddleToTokens,P as validateCandidate,F as validateSkillId,I as validateSkillResourcePath,L as validateSkillSource,ie as withApprovalPersistence};
+import{AgentMemory as e,resolveMemoryConfig as t}from"./agent/memory/memory.js";import{normalizeToolPairing as n}from"./agent/history/normalize.js";import{estimateContextTokens as r,estimateMessageTokens as i}from"./agent/memory/token-estimator.js";import{selectCompactablePrefix as a}from"./agent/memory/surface-compaction.js";import{COMPACTION_INSTRUCTION as o,ContextCompactor as s}from"./agent/memory/compaction.js";import{resolveCompactionConfig as c}from"./agent/memory/compaction-config.js";import{projectHistorySurface as l,projectMessages as u}from"./agent/history/project.js";import{defineTool as d,executionModeOf as f,renderJsonValue as p}from"./agent/tool/definition.js";import{SPILL_TOOL_NAME as m,createMemorySpillStore as h,estimateTextBlockTokens as g,estimateTextTokens as _,previewForSpill as v,readSpillTool as y,truncateMiddleToTokens as b}from"./agent/tool/output-budget.js";import{createModelEvidenceReducer as x,diagnosticLineNumbers as S,reduceEvidence as C}from"./agent/tool/evidence-reducer.js";import{createContextOptimizer as w}from"./agent/memory/context-optimizer.js";import{MAX_SKILL_DESCRIPTION_CHARS as T,MAX_SKILL_ID_CHARS as E,MAX_SKILL_INSTRUCTIONS_CHARS as D,MAX_SKILL_NAME_CHARS as O,MAX_SKILL_RESOURCE_CHARS as k,MAX_SKILL_RESOURCE_PATH_CHARS as A,SKILL_ID_PATTERN as j,defineSkill as M,defineSkillProvider as N,validateCandidate as P,validateSkillId as F,validateSkillResourcePath as I,validateSkillSource as L}from"./agent/skill/definition.js";import{SkillCatalog as R}from"./agent/skill/catalog.js";import{SKILL_TOOL_NAMES as z,createSkillTools as B,renderSkillCatalog as V,resolveSkillOptions as H}from"./agent/skill/tools.js";import{authoritativeTokenUsage as U,budgetTokenTotal as W,summarizeModelCallUsage as G}from"./agent/accounting/usage.js";import{REGISTRY_ERROR_CODES as K,ToolRegistry as q}from"./agent/tool/registry.js";import{History as J}from"./agent/history/history.js";import{AGENT_ACCOUNTING_ERROR_CODES as Y,AgentRunError as X}from"./agent/accounting/error.js";import{buildTraceTree as Z}from"./agent/trace/trace.js";import{TOOL_ERROR_CODES as Q,ToolError as $,toolErrorDisposition as ee}from"./agent/tool/errors.js";import{createApprovalBroker as te,createApprovalRequest as ne,fixedApprovalBroker as re,withApprovalPersistence as ie}from"./agent/tool/approval.js";import{NESTED_TOOL_ERROR_CODES as ae,nestedToolPort as oe}from"./agent/tool/nested.js";import{authorizeToolCall as se,dispatchAuthorizedToolCall as ce,dispatchToolCall as le,finalizeToolCall as ue,prepareToolCall as de,toolFailure as fe}from"./agent/tool/pipeline.js";import{runToolCalls as pe}from"./agent/loop/schedule.js";import{UNCHANGED_ANSWER_MARKER as me}from"./agent/loop/control-text.js";import{runTurn as he}from"./agent/loop/run-turn.js";import{AGENT_CONTROL_TOOLS as ge,runAgent as _e}from"./agent/mode/run-agent.js";import{AgentSession as ve}from"./agent/define/session.js";import{DEFAULT_MIN_WAIT_TIMEOUT_MS as ye,DEFAULT_WAIT_TIMEOUT_MS as be}from"./agent/team/common.js";import{AgentTeam as xe}from"./agent/team/team.js";import{createAgentRuntime as Se}from"./composition/runtime/public.js";import{cloneAgent as Ce,defineAgent as we}from"./composition/agent/author.js";import{createUserInputBroker as Te,fixedUserInputBroker as Ee}from"./agent/mode/user-input.js";import{defineToolFromSchema as De}from"./agent/tool/schema.js";import{createToolExecutionInterceptor as Oe,localToolExecutionBackend as ke}from"./agent/tool/execution.js";import{DefinedAgentTeam as Ae,createDefinedAgentTeam as je}from"./agent/team/composed.js";import{DEFAULT_SPAWN_SETUP_TIMEOUT_MS as Me,DEFAULT_WORKER_CLOSE_TIMEOUT_MS as Ne,ManagedAgentTeam as Pe,completedHistoryPrefix as Fe,createManagedAgentTeam as Ie}from"./agent/team/managed.js";import{defineActionFusion as Le}from"./agent/tool/action-fusion.js";export{Y as AGENT_ACCOUNTING_ERROR_CODES,ge as AGENT_CONTROL_TOOLS,e as AgentMemory,X as AgentRunError,ve as AgentSession,xe as AgentTeam,o as COMPACTION_INSTRUCTION,s as ContextCompactor,ye as DEFAULT_MIN_WAIT_TIMEOUT_MS,Me as DEFAULT_SPAWN_SETUP_TIMEOUT_MS,be as DEFAULT_WAIT_TIMEOUT_MS,Ne as DEFAULT_WORKER_CLOSE_TIMEOUT_MS,Ae as DefinedAgentTeam,ae as EXPERIMENTAL_NESTED_TOOL_ERROR_CODES,J as History,T as MAX_SKILL_DESCRIPTION_CHARS,E as MAX_SKILL_ID_CHARS,D as MAX_SKILL_INSTRUCTIONS_CHARS,O as MAX_SKILL_NAME_CHARS,k as MAX_SKILL_RESOURCE_CHARS,A as MAX_SKILL_RESOURCE_PATH_CHARS,Pe as ManagedAgentTeam,j as SKILL_ID_PATTERN,z as SKILL_TOOL_NAMES,m as SPILL_TOOL_NAME,R as SkillCatalog,Q as TOOL_ERROR_CODES,K as TOOL_REGISTRY_ERROR_CODES,$ as ToolError,q as ToolRegistry,me as UNCHANGED_ANSWER_MARKER,U as authoritativeTokenUsage,se as authorizeToolCall,W as budgetTokenTotal,Z as buildTraceTree,Ce as cloneAgent,Fe as completedHistoryPrefix,Se as createAgentRuntime,te as createApprovalBroker,ne as createApprovalRequest,w as createContextOptimizer,je as createDefinedAgentTeam,Ie as createManagedAgentTeam,h as createMemorySpillStore,x as createModelEvidenceReducer,B as createSkillTools,Oe as createToolExecutionInterceptor,Te as createUserInputBroker,Le as defineActionFusion,we as defineAgent,M as defineSkill,N as defineSkillProvider,d as defineTool,De as defineToolFromSchema,S as diagnosticLineNumbers,ce as dispatchAuthorizedToolCall,le as dispatchToolCall,r as estimateContextTokens,i as estimateMessageTokens,g as estimateTextBlockTokens,_ as estimateTextTokens,f as executionModeOf,oe as experimentalNestedToolPort,ue as finalizeToolCall,re as fixedApprovalBroker,Ee as fixedUserInputBroker,ke as localToolExecutionBackend,n as normalizeToolPairing,de as prepareToolCall,v as previewForSpill,l as projectHistorySurface,u as projectMessages,y as readSpillTool,C as reduceEvidence,p as renderJsonValue,V as renderSkillCatalog,c as resolveCompactionConfig,t as resolveMemoryConfig,H as resolveSkillOptions,_e as runAgent,pe as runToolCalls,he as runTurn,a as selectCompactablePrefix,G as summarizeModelCallUsage,ee as toolErrorDisposition,fe as toolFailure,b as truncateMiddleToTokens,P as validateCandidate,F as validateSkillId,I as validateSkillResourcePath,L as validateSkillSource,ie as withApprovalPersistence};