@alvin0/ai-agent-sdk-core 0.1.0

package/dist/agent/team/common.d.ts

@@ -0,0 +1,26 @@
+//#region src/agent/team/common.d.ts
+/**
+ * How long `wait_agents` waits before reporting back instead.
+ *
+ * A bounded wait is what keeps a coordinator informed: it gets the roster
+ * back and decides whether to wait again, message the agent, or close it. An
+ * unbounded one made a slow agent indistinguishable from a hung one.
+ */
+declare const DEFAULT_WAIT_TIMEOUT_MS = 30000;
+/**
+ * Shortest wait a `wait_agents` call can ask for.
+ *
+ * A tool call may ask for less than the default but not for a wait too short
+ * to be one. A lead that asks for a second gets the roster back unchanged, has
+ * learned nothing, and has spent a model round to learn it — observed in this
+ * project as `wait_agents({ timeoutMs: 1000 })` issued immediately after three
+ * spawns. Codex clamps the same argument for the same reason
+ * (`multi_agents_common.rs`, `MIN_WAIT_TIMEOUT_MS`).
+ *
+ * Asking for less is not an error: a lead should not need to know the floor to
+ * write a valid call, so the request is raised to it rather than rejected.
+ */
+declare const DEFAULT_MIN_WAIT_TIMEOUT_MS = 5000;
+//#endregion
+export { DEFAULT_MIN_WAIT_TIMEOUT_MS, DEFAULT_WAIT_TIMEOUT_MS };
+//# sourceMappingURL=common.d.ts.map

package/dist/agent/team/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","names":[],"sources":["../../../src/agent/team/common.ts"],"mappings":";;;;;;;;cAwCa;;;;;;;;;;;;;;cAeA"}

package/dist/agent/team/common.js

@@ -0,0 +1,2 @@
+import{deepFreeze as e}from"../../primitives/freeze.js";import{systemRandomId as t}from"../../platform/adapter.js";import{AgentSdkError as n}from"../../errors/agent-sdk-error.js";const r=/^[a-zA-Z][a-zA-Z0-9_-]*$/,i=Object.freeze({list:`list_agents`,send:`send_message`,followup:`followup_task`,wait:`wait_agents`});function a(e){return{type:`object`,properties:{target:{type:`string`,description:`Exact agent name returned by list_agents.`},message:{type:`string`,description:e}},required:[`target`,`message`],additionalProperties:!1}}function o(e){let t=p(e,`A2A tool arguments`);if(Object.keys(t).some(e=>e!==`target`&&e!==`message`))throw TypeError(`A2A tool arguments contain unknown fields`);return{target:f(t.target),message:m(t.message,`message`)}}const s=3e4,c=5e3;function l(e){let t=p(e,`wait_agents arguments`);if(Object.keys(t).some(e=>e!==`targets`&&e!==`timeoutMs`))throw TypeError(`wait_agents arguments contain unknown fields`);if(!Array.isArray(t.targets)||t.targets.length===0)throw TypeError(`wait_agents targets must be a non-empty array`);let n=t.targets.map(f);if(new Set(n).size!==n.length)throw TypeError(`wait_agents targets must be unique`);let r=t.timeoutMs;if(r!==void 0&&typeof r!=`number`)throw TypeError(`wait_agents timeoutMs must be a number`);return{targets:Object.freeze(n),...r===void 0?{}:{timeoutMs:r}}}function u(e,t){let n=p(e,`${t} arguments`);if(Object.keys(n).length>0)throw TypeError(`${t} takes no arguments`);return n}function d(e,t){if(_(e)>t)throw TypeError(`A2A message exceeds the ${t}-byte limit`);if(typeof e==`string`)return b([{type:`text`,text:m(e,`message`)}]);if(!Array.isArray(e)||e.length===0)throw TypeError(`A2A message content must not be empty`);return b(e)}function f(e){let t=m(e,`A2A member name`);if(!r.test(t))throw TypeError(`A2A member name must start with a letter and contain only letters, digits, _ or -`);if(t.length>128)throw TypeError(`A2A member name must not exceed 128 characters`);return t}function p(e,t){if(typeof e!=`object`||!e||Array.isArray(e))throw TypeError(`${t} must be an object`);return e}function m(e,t){if(typeof e!=`string`||e.trim().length===0)throw TypeError(`${t} must be a non-empty string`);return e}function h(e,t,n){let r=m(e,t);if(new TextEncoder().encode(r).byteLength>n)throw TypeError(`${t} must not exceed ${n} bytes`);return r}function g(e,t){if(!Number.isSafeInteger(e)||e<1)throw TypeError(`${t} must be a positive integer`);return e}function _(e){return new TextEncoder().encode(JSON.stringify(e)).byteLength}function v(e){return e instanceof Error?e.message:String(e)}function y(e){return e}function b(e){return x(structuredClone(e))}function x(t){return e(t)}function S(){return t()}function C(){return t()}async function w(e,t){return t===void 0?e:(t.throwIfAborted(),new Promise((n,r)=>{let i=()=>r(t.reason);t.addEventListener(`abort`,i,{once:!0}),e.then(n,r).finally(()=>t.removeEventListener(`abort`,i))}))}function T(...e){let t=e.filter(e=>e!==void 0);return t.length===1?t[0]:AbortSignal.any(t)}function E(e,t,r,i=`TEAM_OPERATION_TIMEOUT`){return new Promise((a,o)=>{let s=setTimeout(()=>o(new n(r,i)),t);e.then(a,o).finally(()=>clearTimeout(s))})}export{c as DEFAULT_MIN_WAIT_TIMEOUT_MS,s as DEFAULT_WAIT_TIMEOUT_MS,r as MEMBER_NAME,i as TEAM_TOOL_NAMES,w as abortable,y as asJson,h as boundedString,_ as byteLength,T as combineSignals,b as deepCloneFreeze,x as deepFreeze,u as emptyObject,v as errorMessage,f as memberName,d as messageContent,a as messageToolSchema,C as newMessageId,S as newTeamId,m as nonEmpty,p as object,o as parseMessageTool,l as parseWaitTool,g as positiveInteger,E as withTimeout};
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":["freezeDeep"],"sources":["../../../src/agent/team/common.ts"],"sourcesContent":["import { systemRandomId } from '../../platform/adapter.ts'\nimport type { ContentBlock } from '../../message/index.ts'\nimport type { JsonValue } from '../../primitives/index.ts'\nimport { deepFreeze as freezeDeep } from '../../primitives/index.ts'\nimport { AgentSdkError } from '../../errors/index.ts'\n\nexport const MEMBER_NAME = /^[a-zA-Z][a-zA-Z0-9_-]*$/\nexport const MAX_MEMBER_NAME_LENGTH = 128\nexport const TEAM_TOOL_NAMES = Object.freeze({\n  list: 'list_agents',\n  send: 'send_message',\n  followup: 'followup_task',\n  wait: 'wait_agents',\n} as const)\nexport function messageToolSchema(messageDescription: string): Record<string, unknown> {\n  return {\n    type: 'object',\n    properties: {\n      target: { type: 'string', description: 'Exact agent name returned by list_agents.' },\n      message: { type: 'string', description: messageDescription },\n    },\n    required: ['target', 'message'], additionalProperties: false,\n  }\n}\n\nexport function parseMessageTool(raw: unknown): { target: string; message: string } {\n  const value = object(raw, 'A2A tool arguments')\n  if (Object.keys(value).some(key => key !== 'target' && key !== 'message')) {\n    throw new TypeError('A2A tool arguments contain unknown fields')\n  }\n  return { target: memberName(value.target), message: nonEmpty(value.message, 'message') }\n}\n\n/**\n * How long `wait_agents` waits before reporting back instead.\n *\n * A bounded wait is what keeps a coordinator informed: it gets the roster\n * back and decides whether to wait again, message the agent, or close it. An\n * unbounded one made a slow agent indistinguishable from a hung one.\n */\nexport const DEFAULT_WAIT_TIMEOUT_MS = 30_000\n\n/**\n * Shortest wait a `wait_agents` call can ask for.\n *\n * A tool call may ask for less than the default but not for a wait too short\n * to be one. A lead that asks for a second gets the roster back unchanged, has\n * learned nothing, and has spent a model round to learn it — observed in this\n * project as `wait_agents({ timeoutMs: 1000 })` issued immediately after three\n * spawns. Codex clamps the same argument for the same reason\n * (`multi_agents_common.rs`, `MIN_WAIT_TIMEOUT_MS`).\n *\n * Asking for less is not an error: a lead should not need to know the floor to\n * write a valid call, so the request is raised to it rather than rejected.\n */\nexport const DEFAULT_MIN_WAIT_TIMEOUT_MS = 5_000\n\nexport function parseWaitTool(\n  raw: unknown,\n): { targets: readonly string[]; timeoutMs?: number } {\n  const value = object(raw, 'wait_agents arguments')\n  if (Object.keys(value).some(key => key !== 'targets' && key !== 'timeoutMs')) {\n    throw new TypeError('wait_agents arguments contain unknown fields')\n  }\n  if (!Array.isArray(value.targets) || value.targets.length === 0) {\n    throw new TypeError('wait_agents targets must be a non-empty array')\n  }\n  const targets = value.targets.map(memberName)\n  if (new Set(targets).size !== targets.length) {\n    throw new TypeError('wait_agents targets must be unique')\n  }\n  const timeoutMs = value.timeoutMs\n  if (timeoutMs !== undefined && typeof timeoutMs !== 'number') {\n    throw new TypeError('wait_agents timeoutMs must be a number')\n  }\n  return {\n    targets: Object.freeze(targets),\n    ...(timeoutMs === undefined ? {} : { timeoutMs }),\n  }\n}\n\nexport function emptyObject(raw: unknown, label: string): Record<string, never> {\n  const value = object(raw, `${label} arguments`)\n  if (Object.keys(value).length > 0) throw new TypeError(`${label} takes no arguments`)\n  return value as Record<string, never>\n}\n\nexport function messageContent(\n  value: string | readonly ContentBlock[],\n  maxBytes: number,\n): readonly ContentBlock[] {\n  if (byteLength(value) > maxBytes) throw new TypeError(`A2A message exceeds the ${maxBytes}-byte limit`)\n  if (typeof value === 'string') return deepCloneFreeze([{ type: 'text', text: nonEmpty(value, 'message') }])\n  if (!Array.isArray(value) || value.length === 0) throw new TypeError('A2A message content must not be empty')\n  return deepCloneFreeze(value)\n}\n\nexport function memberName(value: unknown): string {\n  const name = nonEmpty(value, 'A2A member name')\n  if (!MEMBER_NAME.test(name)) {\n    throw new TypeError('A2A member name must start with a letter and contain only letters, digits, _ or -')\n  }\n  if (name.length > MAX_MEMBER_NAME_LENGTH) {\n    throw new TypeError(`A2A member name must not exceed ${MAX_MEMBER_NAME_LENGTH} characters`)\n  }\n  return name\n}\n\nexport function object(value: unknown, label: string): Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) throw new TypeError(`${label} must be an object`)\n  return value as Record<string, unknown>\n}\n\nexport function nonEmpty(value: unknown, label: string): string {\n  if (typeof value !== 'string' || value.trim().length === 0) throw new TypeError(`${label} must be a non-empty string`)\n  return value\n}\n\nexport function boundedString(value: unknown, label: string, maxBytes: number): string {\n  const text = nonEmpty(value, label)\n  if (new TextEncoder().encode(text).byteLength > maxBytes) {\n    throw new TypeError(`${label} must not exceed ${maxBytes} bytes`)\n  }\n  return text\n}\n\nexport function positiveInteger(value: number, label: string): number {\n  if (!Number.isSafeInteger(value) || value < 1) throw new TypeError(`${label} must be a positive integer`)\n  return value\n}\n\nexport function byteLength(value: unknown): number {\n  return new TextEncoder().encode(JSON.stringify(value)).byteLength\n}\n\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n\nexport function asJson(value: unknown): JsonValue { return value as JsonValue }\n\nexport function deepCloneFreeze<T>(value: T): T {\n  return deepFreeze(structuredClone(value))\n}\n\nexport function deepFreeze<T>(value: T): T {\n  return freezeDeep(value)\n}\n\nexport function newTeamId(): string {\n  return systemRandomId()\n}\n\nexport function newMessageId(): string {\n  return systemRandomId()\n}\n\nexport async function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {\n  if (signal === undefined) return promise\n  signal.throwIfAborted()\n  return new Promise<T>((resolve, reject) => {\n    const abort = (): void => reject(signal.reason)\n    signal.addEventListener('abort', abort, { once: true })\n    promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort))\n  })\n}\n\nexport function combineSignals(...signals: readonly (AbortSignal | undefined)[]): AbortSignal {\n  const active = signals.filter((signal): signal is AbortSignal => signal !== undefined)\n  if (active.length === 1) return active[0]!\n  return AbortSignal.any(active)\n}\n\nexport function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  message: string,\n  code = 'TEAM_OPERATION_TIMEOUT',\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => reject(new AgentSdkError(message, code)), timeoutMs)\n    promise.then(resolve, reject).finally(() => clearTimeout(timer))\n  })\n}\n"],"mappings":"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"}

package/dist/agent/team/composed.d.ts

@@ -0,0 +1,45 @@
+import { ModelRegistry } from "../../runtime/registry.js";
+import { DefinedAgent } from "../define/definition.js";
+import { AgentInput, AgentInvocationOptions, AgentResponse, AgentSessionOptions } from "../define/session/types.js";
+import { AgentSession } from "../define/session.js";
+import { AgentTeamOptions } from "./types.js";
+import { AgentTeam } from "./team.js";
+//#region src/agent/team/composed.d.ts
+type DetachedSessionOptions = Omit<AgentSessionOptions, 'registry' | 'team'>;
+interface DefinedAgentTeamMemberInput {
+  readonly agent: DefinedAgent;
+  /** Model-facing team address; defaults to agent.id. */
+  readonly name?: string;
+  readonly description?: string;
+  readonly collaborationInstructions?: string;
+  readonly role?: 'lead' | 'peer';
+  readonly tools?: boolean;
+  /** Override the shared registry for this member. */
+  readonly registry?: ModelRegistry;
+  readonly sessionOptions?: DetachedSessionOptions;
+}
+interface DefinedAgentTeamOptions {
+  readonly registry: ModelRegistry;
+  readonly members: readonly DefinedAgentTeamMemberInput[];
+  readonly team?: AgentTeam | AgentTeamOptions;
+  readonly sessionOptions?: DetachedSessionOptions;
+}
+/**
+ * A stable graph of agent definitions instantiated as connected sessions.
+ * Remote A2A peers can be added later through the exposed AgentTeam.
+ */
+declare class DefinedAgentTeam {
+  readonly team: AgentTeam;
+  private readonly sessions;
+  constructor(options: DefinedAgentTeamOptions);
+  /** Resolve one connected local session by its exact team address. */
+  session(name: string): AgentSession;
+  /** Run one member without bypassing its persistent team session. */
+  run(name: string, input: AgentInput, invocation?: AgentInvocationOptions): Promise<AgentResponse>;
+  /** Detached list of locally composed session addresses. */
+  sessionNames(): readonly string[];
+}
+declare function createDefinedAgentTeam(options: DefinedAgentTeamOptions): DefinedAgentTeam;
+//#endregion
+export { DefinedAgentTeam, DefinedAgentTeamMemberInput, DefinedAgentTeamOptions, createDefinedAgentTeam };
+//# sourceMappingURL=composed.d.ts.map

package/dist/agent/team/composed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed.d.ts","names":[],"sources":["../../../src/agent/team/composed.ts"],"mappings":";;;;;;;KAcK,yBAAyB,KAAK;UAElB;WACN,OAAO;;WAEP;WACA;WACA;WACA;WACA;;WAEA,WAAW;WACX,iBAAiB;;UAGX;WACN,UAAU;WACV,kBAAkB;WAClB,OAAO,YAAY;WACnB,iBAAiB;;;;;;cAOf;WACF,MAAM;mBACE;EAEjB,YAAY,SAAS;;EA0CrB,QAAQ,eAAe;;EAOjB,IACJ,cACA,OAAO,YACP,aAAY,yBACX,QAAQ;;EAKX;;iBAKc,uBAAuB,SAAS,0BAA0B"}

package/dist/agent/team/composed.js

@@ -0,0 +1,2 @@
+import{AgentTeam as e}from"./team.js";var t=class{team;sessions=new Map;constructor(t){if(!Array.isArray(t.members)||t.members.length===0)throw TypeError(`defined agent team requires at least one member`);let n=t.members.filter(e=>e.role===`lead`);if(n.length>1)throw TypeError(`defined agent team can have only one lead`);this.team=t.team instanceof e?t.team:new e(t.team);let r=n.length===1,i=[];try{for(let e of t.members){let n=e.name??e.agent.id,a=e.role??(r?`peer`:void 0),o=e.agent.createSession({...t.sessionOptions,...e.sessionOptions,registry:e.registry??t.registry,team:{team:this.team,name:n,...e.description===void 0?{}:{description:e.description},...e.collaborationInstructions===void 0?{}:{instructions:e.collaborationInstructions},...a===void 0?{}:{role:a},...e.tools===void 0?{}:{tools:e.tools}}});this.sessions.set(n,o),i.push(n)}}catch(e){for(let e of i.reverse())this.team.detach(e);throw this.sessions.clear(),e}}session(e){let t=this.sessions.get(e);if(t===void 0)throw Error(`unknown defined team member '${e}'`);return t}async run(e,t,n={}){return this.session(e).run(t,n)}sessionNames(){return Object.freeze([...this.sessions.keys()])}};function n(e){return new t(e)}export{t as DefinedAgentTeam,n as createDefinedAgentTeam};
+//# sourceMappingURL=composed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composed.js","names":[],"sources":["../../../src/agent/team/composed.ts"],"sourcesContent":["/** Composition root for teams made from pre-defined, long-lived agents. */\n\nimport type { ModelRegistry } from '../../runtime/index.ts'\nimport type { DefinedAgent } from '../define/definition.ts'\nimport {\n  type AgentInput,\n  type AgentInvocationOptions,\n  type AgentResponse,\n  type AgentSession,\n  type AgentSessionOptions,\n} from '../define/session.ts'\nimport { AgentTeam } from './team.ts'\nimport type { AgentTeamOptions } from './types.ts'\n\ntype DetachedSessionOptions = Omit<AgentSessionOptions, 'registry' | 'team'>\n\nexport interface DefinedAgentTeamMemberInput {\n  readonly agent: DefinedAgent\n  /** Model-facing team address; defaults to agent.id. */\n  readonly name?: string\n  readonly description?: string\n  readonly collaborationInstructions?: string\n  readonly role?: 'lead' | 'peer'\n  readonly tools?: boolean\n  /** Override the shared registry for this member. */\n  readonly registry?: ModelRegistry\n  readonly sessionOptions?: DetachedSessionOptions\n}\n\nexport interface DefinedAgentTeamOptions {\n  readonly registry: ModelRegistry\n  readonly members: readonly DefinedAgentTeamMemberInput[]\n  readonly team?: AgentTeam | AgentTeamOptions\n  readonly sessionOptions?: DetachedSessionOptions\n}\n\n/**\n * A stable graph of agent definitions instantiated as connected sessions.\n * Remote A2A peers can be added later through the exposed AgentTeam.\n */\nexport class DefinedAgentTeam {\n  readonly team: AgentTeam\n  private readonly sessions = new Map<string, AgentSession>()\n\n  constructor(options: DefinedAgentTeamOptions) {\n    if (!Array.isArray(options.members) || options.members.length === 0) {\n      throw new TypeError('defined agent team requires at least one member')\n    }\n    const explicitLeads = options.members.filter(member => member.role === 'lead')\n    if (explicitLeads.length > 1) throw new TypeError('defined agent team can have only one lead')\n\n    this.team = options.team instanceof AgentTeam\n      ? options.team\n      : new AgentTeam(options.team)\n    const hasExplicitLead = explicitLeads.length === 1\n    const attached: string[] = []\n    try {\n      for (const member of options.members) {\n        const name = member.name ?? member.agent.id\n        const role = member.role ?? (hasExplicitLead ? 'peer' : undefined)\n        const session = member.agent.createSession({\n          ...options.sessionOptions,\n          ...member.sessionOptions,\n          registry: member.registry ?? options.registry,\n          team: {\n            team: this.team,\n            name,\n            ...(member.description === undefined ? {} : { description: member.description }),\n            ...(member.collaborationInstructions === undefined\n              ? {}\n              : { instructions: member.collaborationInstructions }),\n            ...(role === undefined ? {} : { role }),\n            ...(member.tools === undefined ? {} : { tools: member.tools }),\n          },\n        })\n        this.sessions.set(name, session)\n        attached.push(name)\n      }\n    } catch (error: unknown) {\n      for (const name of attached.reverse()) this.team.detach(name)\n      this.sessions.clear()\n      throw error\n    }\n  }\n\n  /** Resolve one connected local session by its exact team address. */\n  session(name: string): AgentSession {\n    const session = this.sessions.get(name)\n    if (session === undefined) throw new Error(`unknown defined team member '${name}'`)\n    return session\n  }\n\n  /** Run one member without bypassing its persistent team session. */\n  async run(\n    name: string,\n    input: AgentInput,\n    invocation: AgentInvocationOptions = {},\n  ): Promise<AgentResponse> {\n    return this.session(name).run(input, invocation)\n  }\n\n  /** Detached list of locally composed session addresses. */\n  sessionNames(): readonly string[] {\n    return Object.freeze([...this.sessions.keys()])\n  }\n}\n\nexport function createDefinedAgentTeam(options: DefinedAgentTeamOptions): DefinedAgentTeam {\n  return new DefinedAgentTeam(options)\n}\n"],"mappings":"sCAwCA,IAAa,EAAb,KAA8B,CAC5B,KACA,SAA4B,IAAI,IAEhC,YAAY,EAAkC,CAC5C,GAAI,CAAC,MAAM,QAAQ,EAAQ,OAAO,GAAK,EAAQ,QAAQ,SAAW,EAChE,MAAU,UAAU,iDAAiD,EAEvE,IAAM,EAAgB,EAAQ,QAAQ,OAAO,GAAU,EAAO,OAAS,MAAM,EAC7E,GAAI,EAAc,OAAS,EAAG,MAAU,UAAU,2CAA2C,EAE7F,KAAK,KAAO,EAAQ,gBAAgB,EAChC,EAAQ,KACR,IAAI,EAAU,EAAQ,IAAI,EAC9B,IAAM,EAAkB,EAAc,SAAW,EAC3C,EAAqB,CAAC,EAC5B,GAAI,CACF,IAAK,IAAM,KAAU,EAAQ,QAAS,CACpC,IAAM,EAAO,EAAO,MAAQ,EAAO,MAAM,GACnC,EAAO,EAAO,OAAS,EAAkB,OAAS,IAAA,IAClD,EAAU,EAAO,MAAM,cAAc,CACzC,GAAG,EAAQ,eACX,GAAG,EAAO,eACV,SAAU,EAAO,UAAY,EAAQ,SACrC,KAAM,CACJ,KAAM,KAAK,KACX,OACA,GAAI,EAAO,cAAgB,IAAA,GAAY,CAAC,EAAI,CAAE,YAAa,EAAO,WAAY,EAC9E,GAAI,EAAO,4BAA8B,IAAA,GACrC,CAAC,EACD,CAAE,aAAc,EAAO,yBAA0B,EACrD,GAAI,IAAS,IAAA,GAAY,CAAC,EAAI,CAAE,MAAK,EACrC,GAAI,EAAO,QAAU,IAAA,GAAY,CAAC,EAAI,CAAE,MAAO,EAAO,KAAM,CAC9D,CACF,CAAC,EACD,KAAK,SAAS,IAAI,EAAM,CAAO,EAC/B,EAAS,KAAK,CAAI,CACpB,CACF,OAAS,EAAgB,CACvB,IAAK,IAAM,KAAQ,EAAS,QAAQ,EAAG,KAAK,KAAK,OAAO,CAAI,EAE5D,MADA,KAAK,SAAS,MAAM,EACd,CACR,CACF,CAGA,QAAQ,EAA4B,CAClC,IAAM,EAAU,KAAK,SAAS,IAAI,CAAI,EACtC,GAAI,IAAY,IAAA,GAAW,MAAU,MAAM,gCAAgC,EAAK,EAAE,EAClF,OAAO,CACT,CAGA,MAAM,IACJ,EACA,EACA,EAAqC,CAAC,EACd,CACxB,OAAO,KAAK,QAAQ,CAAI,CAAC,CAAC,IAAI,EAAO,CAAU,CACjD,CAGA,cAAkC,CAChC,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,SAAS,KAAK,CAAC,CAAC,CAChD,CACF,EAEA,SAAgB,EAAuB,EAAoD,CACzF,OAAO,IAAI,EAAiB,CAAO,CACrC"}

package/dist/agent/team/contracts.d.ts

@@ -0,0 +1,54 @@
+import { UserMessage } from "../../message/message.js";
+import { ToolDefinition } from "../tool/definition.js";
+import { AgentRunEvent } from "../mode/run-agent.js";
+//#region src/agent/team/contracts.d.ts
+/**
+ * How much of the team tool set one member may use.
+ *
+ * `full` is every verb. `reporting` withholds the two that BLOCK or DELEGATE —
+ * `wait_agents` and `followup_task` — leaving `list_agents` and `send_message`.
+ *
+ * The distinction exists because an agent created to carry out one bounded task
+ * needs a stopping point, and the coordination verbs take it away: given them,
+ * a worker that wants guidance messages a peer and then waits, so its run ends
+ * only when something cancels it. Whoever is orchestrating keeps those verbs.
+ */
+type TeamToolAccess = 'full' | 'reporting';
+/** Team-owned metadata applied while attaching one local session. */
+interface TeamMemberAttachmentOptions {
+  readonly name?: string;
+  readonly description?: string;
+  readonly instructions?: string;
+  readonly role?: 'lead' | 'peer';
+  /** `false` attaches no team tools; a {@link TeamToolAccess} narrows them. */
+  readonly tools?: boolean | TeamToolAccess;
+}
+/**
+ * The smallest session surface required by local team orchestration.
+ *
+ * `AgentSession` satisfies this interface structurally. Keeping the concrete
+ * class out of the control plane prevents definition/session ownership from
+ * pointing back out to the team implementation.
+ */
+interface TeamSessionPort {
+  readonly definition: {
+    readonly id: string;
+  };
+  readonly conversationId: string;
+  readonly isRunning: boolean;
+  inject(input: UserMessage): number;
+  whenIdle(signal?: AbortSignal): Promise<void>;
+  runPending(invocation?: {
+    readonly signal?: AbortSignal;
+    readonly onEvent?: (event: AgentRunEvent) => void | Promise<void>;
+  }): Promise<unknown>;
+}
+/** Session-facing surface of a team control plane. */
+interface TeamPort {
+  attach(session: TeamSessionPort, options?: TeamMemberAttachmentOptions): void;
+  toolsFor(sender: string, access?: TeamToolAccess): readonly ToolDefinition<any>[];
+  instructionsFor(name: string): string;
+}
+//#endregion
+export { TeamMemberAttachmentOptions, TeamPort, TeamSessionPort, TeamToolAccess };
+//# sourceMappingURL=contracts.d.ts.map

package/dist/agent/team/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","names":[],"sources":["../../../src/agent/team/contracts.ts"],"mappings":";;;;;;;;;;;;;;;KAiBY;;UAGK;WACN;WACA;WACA;WACA;;WAEA,kBAAkB;;;;;;;;;UAUZ;WACN;aAAuB;;WACvB;WACA;EACT,OAAO,OAAO;EACd,SAAS,SAAS,cAAc;EAChC,WAAW;aACA,SAAS;aACT,WAAW,OAAO,yBAAyB;MAClD;;;UAIW;EACf,OAAO,SAAS,iBAAiB,UAAU;EAC3C,SAAS,gBAAgB,SAAS,0BAA0B;EAC5D,gBAAgB"}