@qilin-agent/experimental-agent-team 3.1.3 → 3.1.4

package/lib/typert.host.js

@@ -95,7 +95,7 @@ export const TYPERT = {
         typeSymbol: '@qilin-agent/experimental-agent-team/client#TeamTaskView',
         create: _qilin_agent_experimental_agent_team_agentTeams_createTask_result$schema,
       },
-      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":220,"column":9},
+      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":244,"column":9},
     },
     {
       id: '@qilin-agent/experimental-agent-team#agentTeams/updateTask',
@@ -136,7 +136,7 @@ export const TYPERT = {
         typeSymbol: '@qilin-agent/experimental-agent-team/client#TeamTaskView',
         create: _qilin_agent_experimental_agent_team_agentTeams_updateTask_result$schema,
       },
-      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":240,"column":9},
+      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":264,"column":9},
     },
   ],
   model: {
@@ -174,8 +174,8 @@ export const TYPERT = {
             "kind": "method",
             "name": "sendMessage",
             "signature": "async sendMessage(caller: Agent, request: SendTeamMessageRequest): Promise<SendTeamMessageResult>",
-            "summary": "Queue one durable peer message, then attempt immediate delivery.",
-            "jsDoc": "/**\n * Queue one durable peer message, then attempt immediate delivery.\n * @param caller - exact live sending Team member.\n * @param request - target name, content, and pre-queue cancellation.\n * @returns durable message identity and immediate-delivery observation.\n */"
+            "summary": "Steer one peer message into the target inbox or reject the attempt.",
+            "jsDoc": "/**\n * Steer one peer message into the target inbox or reject the attempt.\n * @param caller - exact live sending Team member.\n * @param request - target name, content, and cancellation before acceptance.\n * @returns accepted inbox identity; acceptance follows normal Agent persistence and does not await model processing.\n */"
           },
           {
             "kind": "method",
@@ -540,7 +540,7 @@ export const TYPERT = {
           },
           {
             "name": "MessageSourceMap",
-            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'sidechat-boundary': { kind: 'sidechat-boundary'; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'kylin-host-runner': { kind: 'kylin-host-runner'; };\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n}"
+            "declaration": "export interface MessageSourceMap {\n    user: { kind: 'user'; };\n    model: ModelMessageSource;\n    tool: ToolMessageSource;\n    'system-prompt': SystemPromptMessageSource;\n    'model-selection': { kind: 'model-selection'; } & ContextFormed;\n    'user-approval': { kind: 'user-approval'; } & ContextFormed;\n    'working-directory': { kind: 'working-directory'; };\n    'ptc-mode': { kind: 'ptc-mode'; };\n    'tool-registry': { kind: 'tool-registry'; };\n    'user-rpc': { kind: 'user'; rpcId: SessionRequestId; clientTimeZone?: string; };\n    'sidechat-boundary': { kind: 'sidechat-boundary'; };\n    'agent-message': AgentMessageSource;\n    'subagent-settled': SubagentSettledMessageSource;\n    'skill-invocation': SkillInvocationSource;\n    'team-message': TeamMessageSource;\n    goal: GoalMessageSource;\n    'kylin-host-runner': { kind: 'kylin-host-runner'; };\n    schedule: { kind: 'schedule'; } & ContextFormed;\n    'compact-checkpoint': CompactionCheckpointSource;\n    'session-reference': SessionReferenceSource;\n    'user-question-reply': { kind: 'user-question-reply'; callId: ToolCallId; outcome: 'answered'; };\n}"
           },
           {
             "name": "ModelMessageSource",
@@ -568,7 +568,7 @@ export const TYPERT = {
           },
           {
             "name": "PtcDispatchEventData",
-            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n    error?: { name: string; code: string; reason?: string; };\n}"
+            "declaration": "export interface PtcDispatchEventData extends PtcDispatchStartEventData {\n    isError: boolean;\n    content: ContentBlock[];\n    meta?: JsonValue;\n    error?: { name: string; code: string; reason?: string; };\n}"
           },
           {
             "name": "PtcDispatchStartEventData",
@@ -624,7 +624,7 @@ export const TYPERT = {
           },
           {
             "name": "SendTeamMessageResult",
-            "declaration": "export interface SendTeamMessageResult {\n    readonly messageId: TeamMessageId;\n    readonly status: 'accepted' | 'queued';\n}"
+            "declaration": "export interface SendTeamMessageResult {\n    readonly messageId: TeamMessageId;\n}"
           },
           {
             "name": "Session",
@@ -636,7 +636,7 @@ export const TYPERT = {
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@qilin-agent/session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'permission/preset': { preset: string; };\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'developer/message': { turn: number; step: number; message: DeveloperMessage; headerSeq?: SessionSeq; };\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; reason?: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'working-directory/change': { cwd: string; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@qilin-agent/session/types').SessionSeq; };\n    'image/offload': { targets: ImageOffloadTarget[]; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'permission/preset': { preset: string; };\n    'subagent/descriptor': SubagentDescriptorData;\n    'subagent/catalog': SubagentCatalogEvent;\n    'feedback/record': FeedbackRecord;\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'schedule/change': ScheduleChange;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -704,7 +704,7 @@ export const TYPERT = {
           },
           {
             "name": "SubagentCatalogEvent",
-            "declaration": "export type SubagentCatalogEvent = { readonly childId: SessionId; readonly childCreatedAt: number; } & (({ readonly version: 0; } & KnownCatalogMode) | ({ readonly version: 1; } & (KnownCatalogMode | { readonly mode: 'unknown'; readonly label?: string; })));"
+            "declaration": "export type SubagentCatalogEvent = { readonly childId: SessionId; readonly childCreatedAt: number; } & (({ readonly version: 0; } & KnownCatalogMode) | ({ readonly version: 1; } & (KnownCatalogMode | { readonly mode: 'unknown'; readonly label?: string; })) | { readonly version: 2; readonly mode: 'external'; readonly label?: string; });"
           },
           {
             "name": "SubagentDescriptorBase",

package/lib/typert.remote-client.js

@@ -92,7 +92,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@qilin-agent/experimental-agent-team/client#TeamTaskView',
         create: _qilin_agent_experimental_agent_team_agentTeams_createTask_result$schema,
       },
-      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":220,"column":9},
+      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":244,"column":9},
     },
     {
       id: '@qilin-agent/experimental-agent-team#agentTeams/updateTask',
@@ -133,7 +133,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@qilin-agent/experimental-agent-team/client#TeamTaskView',
         create: _qilin_agent_experimental_agent_team_agentTeams_updateTask_result$schema,
       },
-      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":240,"column":9},
+      sourceLocation: {"file":"packages/experimental/agent-team/src/index.ts","line":264,"column":9},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -1,4 +1,4 @@
-/** Agent Teams service façade over roster, mailbox, task, and runtime lifecycle owners. */
+/** Agent Teams service façade over roster, messaging, task, and runtime lifecycle owners. */
 import { Context } from '@qilin-agent/kylin';
 import z from '@qilin-agent/schemastery';
 import type { Agent } from '@qilin-agent/agent';
@@ -30,7 +30,6 @@ export declare class TeamService extends TypertRemoteService {
     private readonly lifecycle;
     private readonly journal;
     private readonly roster;
-    private readonly mailbox;
     private readonly tasks;
     constructor(ctx: Context, config?: Config);
     /**
@@ -53,12 +52,19 @@ export declare class TeamService extends TypertRemoteService {
      */
     spawnTeammate(caller: Agent, request: SpawnTeammateRequest): Promise<SpawnTeammateResult>;
     /**
-     * Queue one durable peer message, then attempt immediate delivery.
+     * Steer one peer message into the target inbox or reject the attempt.
      * @param caller - exact live sending Team member.
-     * @param request - target name, content, and pre-queue cancellation.
-     * @returns durable message identity and immediate-delivery observation.
+     * @param request - target name, content, and cancellation before acceptance.
+     * @returns accepted inbox identity; acceptance follows normal Agent persistence and does not await model processing.
      */
     sendMessage(caller: Agent, request: SendTeamMessageRequest): Promise<SendTeamMessageResult>;
+    /**
+     * Admit one peer message and steer it into the target's inbox.
+     * @param caller - exact live sending Team member.
+     * @param request - target name, content, and signal already joined with runtime cancellation.
+     * @returns the durable message identity carried by the delivered source.
+     */
+    private sendAdmitted;
     /**
      * Create one unowned pending task in the Team Lead log.
      * @param caller - exact live Team member creating the task.
@@ -133,7 +139,7 @@ export declare class TeamService extends TypertRemoteService {
     tryMembership(agent: Agent): TeamMembership | undefined;
     /** Queue one contained recovery pass after publication has unwound. */
     private scheduleRecovery;
-    /** Reconcile roster provisioning before retrying that member's pending mailbox. */
+    /** Reconcile roster provisioning when one Team member Session starts. */
     private recoverFor;
     /** Stop Team-owned live branches and release every waiter before service disposal completes. */
     private disposeRuntime;

package/lib/types/index.js

@@ -1,4 +1,4 @@
-/** Agent Teams service façade over roster, mailbox, task, and runtime lifecycle owners. */
+/** Agent Teams service façade over roster, messaging, task, and runtime lifecycle owners. */
 var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
     var useValue = arguments.length > 2;
     for (var i = 0; i < initializers.length; i++) {
@@ -33,23 +33,24 @@ var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn,
     if (target) Object.defineProperty(target, contextIn.name, descriptor);
     done = true;
 };
+import { randomUUID } from 'node:crypto';
 import z from '@qilin-agent/schemastery';
+import { createUserMessage } from '@qilin-agent/llm';
+import { steerHostSubagentPrompt } from '@qilin-agent/subagent/internal';
 import { Remote, TypertRemoteService } from '@qilin-agent/typert-protocol';
 import { TeamActivity } from "./activity.js";
 import { errorMessage, TeamError } from "./error.js";
 import { TeamJournal } from "./journal.js";
 import { TeamRuntimeLifecycle } from "./lifecycle.js";
-import { TeamMailbox } from "./mailbox.js";
 import { teamProjectionDefinition } from "./projection.js";
 import { teamWireError } from "./remote.js";
-import { TeamRoster } from "./roster.js";
+import { resolveActiveMember, TeamRoster } from "./roster.js";
 import { TeamTaskBoard } from "./task-board.js";
-import { TeamId } from "./types.js";
+import { TeamId, TeamMessageId } from "./types.js";
 export { TeamId, TeamMessageId, TeamTaskId } from "./types.js";
 export { TeamError } from "./error.js";
 const DEFAULT_MAX_MEMBERS = 16;
 const DEFAULT_MAX_TASKS = 256;
-const DEFAULT_MAX_PENDING_MESSAGES = 64;
 const DEFAULT_MAX_MESSAGE_BYTES = 65_536;
 const DEFAULT_DISPOSAL_TIMEOUT_MS = 5_000;
 /** Validate one positive safe-integer deployment limit. */
@@ -83,7 +84,6 @@ let TeamService = (() => {
         static Config = z.object({
             maxMembers: z.number().step(1).min(1).default(DEFAULT_MAX_MEMBERS),
             maxTasks: z.number().step(1).min(1).default(DEFAULT_MAX_TASKS),
-            maxPendingMessagesPerMember: z.number().step(1).min(1).default(DEFAULT_MAX_PENDING_MESSAGES),
             maxMessageBytes: z.number().step(1).min(1).default(DEFAULT_MAX_MESSAGE_BYTES),
             disposalTimeoutMs: z.number().step(1).min(1).default(DEFAULT_DISPOSAL_TIMEOUT_MS),
         });
@@ -93,14 +93,12 @@ let TeamService = (() => {
         lifecycle;
         journal;
         roster;
-        mailbox;
         tasks;
         constructor(ctx, config = {}) {
             super(ctx, 'agentTeams');
             this.config = {
                 maxMembers: positiveLimit('maxMembers', config.maxMembers ?? DEFAULT_MAX_MEMBERS),
                 maxTasks: positiveLimit('maxTasks', config.maxTasks ?? DEFAULT_MAX_TASKS),
-                maxPendingMessagesPerMember: positiveLimit('maxPendingMessagesPerMember', config.maxPendingMessagesPerMember ?? DEFAULT_MAX_PENDING_MESSAGES),
                 maxMessageBytes: positiveLimit('maxMessageBytes', config.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES),
                 disposalTimeoutMs: positiveLimit('disposalTimeoutMs', config.disposalTimeoutMs ?? DEFAULT_DISPOSAL_TIMEOUT_MS),
             };
@@ -108,9 +106,7 @@ let TeamService = (() => {
             this.lifecycle = new TeamRuntimeLifecycle(this.config.disposalTimeoutMs);
             this.journal = new TeamJournal(ctx, (root) => { this.activity.notify(TeamId(root.id)); });
             this.roster = new TeamRoster(ctx, this.journal, this.lifecycle, this.config.maxMembers);
-            this.mailbox = new TeamMailbox(ctx, this.journal, this.roster, this.lifecycle, this.config.maxPendingMessagesPerMember, this.config.maxMessageBytes);
             this.tasks = new TeamTaskBoard(this.journal, this.config.maxTasks);
-            ctx.on('session/event', (session, event) => { this.mailbox.observeSessionEvent(session, event); });
             ctx.on('agent/created', ({ agent }) => { this.scheduleRecovery(agent); });
             ctx.on('agent/status', ({ agent }) => {
                 const membership = this.roster.tryMembership(agent);
@@ -157,13 +153,53 @@ let TeamService = (() => {
             return await this.roster.spawn(caller, request);
         }
         /**
-         * Queue one durable peer message, then attempt immediate delivery.
+         * Steer one peer message into the target inbox or reject the attempt.
          * @param caller - exact live sending Team member.
-         * @param request - target name, content, and pre-queue cancellation.
-         * @returns durable message identity and immediate-delivery observation.
+         * @param request - target name, content, and cancellation before acceptance.
+         * @returns accepted inbox identity; acceptance follows normal Agent persistence and does not await model processing.
          */
         async sendMessage(caller, request) {
-            return await this.mailbox.send(caller, request);
+            if (this.lifecycle.disposed)
+                throw new TeamError('Agent Teams service is disposing', 'TEAM_DISPOSED');
+            return await this.lifecycle.track(this.sendAdmitted(caller, {
+                ...request,
+                signal: AbortSignal.any([request.signal, this.lifecycle.signal]),
+            }));
+        }
+        /**
+         * Admit one peer message and steer it into the target's inbox.
+         * @param caller - exact live sending Team member.
+         * @param request - target name, content, and signal already joined with runtime cancellation.
+         * @returns the durable message identity carried by the delivered source.
+         */
+        async sendAdmitted(caller, request) {
+            const membership = this.roster.membership(caller);
+            request.signal.throwIfAborted();
+            const { root } = membership;
+            const target = resolveActiveMember(root, this.journal.state(root), request.target);
+            if (target.id === caller.id)
+                throw new TeamError('a Team member cannot message itself', 'TEAM_SELF_MESSAGE');
+            const messageId = TeamMessageId(`team-message-${randomUUID()}`);
+            const source = {
+                kind: 'team-message',
+                teamId: TeamId(root.id),
+                messageId,
+                senderId: caller.id,
+                senderName: membership.name,
+            };
+            const content = [
+                { type: 'text', text: `Team message ${messageId} from ${membership.name}:` },
+                ...structuredClone(request.content),
+            ];
+            if (Buffer.byteLength(JSON.stringify(content), 'utf8') > this.config.maxMessageBytes) {
+                throw new TeamError(`team message exceeds ${this.config.maxMessageBytes} bytes`, 'TEAM_MESSAGE_TOO_LARGE');
+            }
+            if (target.id === root.id)
+                root.steer(createUserMessage({ content, source }));
+            else
+                await steerHostSubagentPrompt(this.ctx.subagents, root, target.id, content, source, request.signal);
+            this.activity.notify(membership.id);
+            return { messageId };
         }
         /**
          * Create one unowned pending task in the Team Lead log.
@@ -276,18 +312,16 @@ let TeamService = (() => {
                 });
             });
         }
-        /** Reconcile roster provisioning before retrying that member's pending mailbox. */
+        /** Reconcile roster provisioning when one Team member Session starts. */
         async recoverFor(agent) {
             await this.roster.recoverFor(agent, this.lifecycle.signal);
-            await this.mailbox.recoverFor(agent, this.lifecycle.signal);
         }
         /** Stop Team-owned live branches and release every waiter before service disposal completes. */
         async disposeRuntime() {
             this.lifecycle.close();
             this.activity.close();
             const failures = [];
-            await this.lifecycle.settle(this.roster.pendingCreations(), failures);
-            await this.lifecycle.settle(this.mailbox.pendingDispatches(), failures);
+            await this.lifecycle.settle(this.lifecycle.pending(), failures);
             for (const [root, childIds] of this.roster.liveChildrenByRoot()) {
                 try {
                     await this.roster.stopTeammates(root, childIds);

package/lib/types/lifecycle.d.ts

@@ -2,6 +2,7 @@
 /** Owns the single Team runtime cancellation fact and disposal timeout. */
 export declare class TeamRuntimeLifecycle {
     private readonly disposalTimeoutMs;
+    private readonly operations;
     private readonly controller;
     /**
      * @param disposalTimeoutMs - maximum wait for one disposal settlement operation.
@@ -17,6 +18,17 @@ export declare class TeamRuntimeLifecycle {
     private isCancellation;
     /** Close Team runtime admission and cancel admitted interruptible work. */
     close(): void;
+    /**
+     * Track an admitted send or complete creation transaction until it settles.
+     * @param operation - asynchronous work owned by this runtime.
+     * @returns the same operation.
+     */
+    track<T>(operation: Promise<T>): Promise<T>;
+    /**
+     * Capture outstanding operations after closing admission.
+     * @returns admitted work still awaiting settlement.
+     */
+    pending(): readonly Promise<unknown>[];
     /**
      * Await admitted operations and retain failures other than runtime cancellation.
      * @param operations - admitted operations captured after the admission cutoff.

package/lib/types/lifecycle.js

@@ -3,6 +3,7 @@ import { TeamError } from "./error.js";
 /** Owns the single Team runtime cancellation fact and disposal timeout. */
 export class TeamRuntimeLifecycle {
     disposalTimeoutMs;
+    operations = new Set();
     controller = new AbortController();
     /**
      * @param disposalTimeoutMs - maximum wait for one disposal settlement operation.
@@ -43,6 +44,23 @@ export class TeamRuntimeLifecycle {
     close() {
         this.controller.abort(new TeamError('Agent Teams service disposed', 'TEAM_DISPOSED'));
     }
+    /**
+     * Track an admitted send or complete creation transaction until it settles.
+     * @param operation - asynchronous work owned by this runtime.
+     * @returns the same operation.
+     */
+    track(operation) {
+        this.operations.add(operation);
+        void operation.then(() => { this.operations.delete(operation); }, () => { this.operations.delete(operation); });
+        return operation;
+    }
+    /**
+     * Capture outstanding operations after closing admission.
+     * @returns admitted work still awaiting settlement.
+     */
+    pending() {
+        return [...this.operations];
+    }
     /**
      * Await admitted operations and retain failures other than runtime cancellation.
      * @param operations - admitted operations captured after the admission cutoff.

package/lib/types/roster.d.ts

@@ -31,7 +31,6 @@ export declare class TeamRoster {
     private readonly journal;
     private readonly lifecycle;
     private readonly maxMembers;
-    private readonly inFlightCreations;
     /**
      * @param ctx - Team service context with Agent, Session, persistence, and subagent services.
      * @param journal - authoritative Lead-log transaction owner.
@@ -64,11 +63,6 @@ export declare class TeamRoster {
      * @returns the active roster row.
      */
     spawn(caller: Agent, request: SpawnTeammateRequest): Promise<SpawnTeammateResult>;
-    /**
-     * Return admitted creation operations captured for ordered disposal.
-     * @returns detached snapshot ordered only by Set insertion.
-     */
-    pendingCreations(): readonly Promise<unknown>[];
     /**
      * Reconcile provisioning state when one Team member Session starts.
      * @param agent - newly started exact live Agent.

package/lib/types/roster.js

@@ -31,7 +31,6 @@ export class TeamRoster {
     journal;
     lifecycle;
     maxMembers;
-    inFlightCreations = new Set();
     /**
      * @param ctx - Team service context with Agent, Session, persistence, and subagent services.
      * @param journal - authoritative Lead-log transaction owner.
@@ -142,21 +141,7 @@ export class TeamRoster {
     async spawn(caller, request) {
         if (this.lifecycle.disposed)
             throw new TeamError('Agent Teams service is disposing', 'TEAM_DISPOSED');
-        const operation = this.spawnAdmitted(caller, request);
-        this.inFlightCreations.add(operation);
-        try {
-            return await operation;
-        }
-        finally {
-            this.inFlightCreations.delete(operation);
-        }
-    }
-    /**
-     * Return admitted creation operations captured for ordered disposal.
-     * @returns detached snapshot ordered only by Set insertion.
-     */
-    pendingCreations() {
-        return [...this.inFlightCreations];
+        return await this.lifecycle.track(this.spawnAdmitted(caller, request));
     }
     /**
      * Reconcile provisioning state when one Team member Session starts.
@@ -216,7 +201,7 @@ export class TeamRoster {
      * @param childIds - selected roster child ids.
      */
     async stopTeammates(root, childIds) {
-        await this.lifecycle.withTimeout(this.ctx.subagents.drainContinuableChildren(root, childIds));
+        await this.lifecycle.withTimeout(this.ctx.subagents.drainChildren(root, childIds));
     }
     /** Perform one creation admitted before the Team runtime disposal cutoff. */
     async spawnAdmitted(caller, request) {
@@ -250,7 +235,7 @@ export class TeamRoster {
         });
         let started;
         try {
-            started = await this.ctx.subagents.startContinuable({
+            started = await this.ctx.subagents.startActivation({
                 childId,
                 provider: request.provider,
                 label: description,
@@ -259,7 +244,11 @@ export class TeamRoster {
                     parent: root,
                 },
                 signal,
+                delivery: 'parent',
             });
+            if (started.messageId === undefined) {
+                throw new TeamError('the spawned teammate accepted no initial prompt', 'TEAM_PROMPT_NOT_ACCEPTED');
+            }
             await this.checkpointInitialPrompt(childId, started.messageId, signal);
         }
         catch (error) {

package/lib/types/types.d.ts

@@ -128,8 +128,6 @@ export interface Config {
     readonly maxMembers?: number;
     /** Maximum non-deleted tasks retained by one Team. */
     readonly maxTasks?: number;
-    /** Maximum queued-minus-delivered messages for one target member. */
-    readonly maxPendingMessagesPerMember?: number;
     /** Maximum UTF-8 bytes in one complete sender-framed delivery. */
     readonly maxMessageBytes?: number;
     /** Maximum milliseconds allowed for Team-owned runtime disposal. */
@@ -154,10 +152,9 @@ export interface SendTeamMessageRequest {
     readonly content: ContentBlock[];
     readonly signal: AbortSignal;
 }
-/** Result after a peer message enters the durable mailbox. */
+/** Result after a peer message enters the target inbox. */
 export interface SendTeamMessageResult {
     readonly messageId: TeamMessageId;
-    readonly status: 'accepted' | 'queued';
 }
 /** Input for creating one shared task. */
 export interface CreateTeamTaskRequest {
@@ -197,13 +194,13 @@ declare module '@qilin-agent/session/types' {
             teamId: TeamId;
             task: TeamTaskSnapshot;
         };
-        /** Durable mailbox enqueue, stored before delivery is attempted. */
+        /** Historical mailbox enqueue; new sends use the target Agent inbox. */
         'team/message/queued': {
             version: 2;
             teamId: TeamId;
             message: TeamMessageSnapshot;
         };
-        /** Durable acknowledgement that the target Session recorded the message. */
+        /** Historical acknowledgement that the target Session recorded a queued message. */
         'team/message/delivered': {
             version: 2;
             teamId: TeamId;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/experimental-agent-team",
   "description": "Implicit-root Agent Teams roster, durable peer mailbox, and shared task DAG",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "publishConfig": {
     "access": "public"
   },
@@ -54,33 +54,33 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@qilin-agent/brand": "3.1.3",
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.3",
+    "@qilin-agent/brand": "3.1.4"
   },
   "peerDependencies": {
     "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/agent": "3.1.3",
-    "@qilin-agent/session-projection": "3.1.3",
-    "@qilin-agent/subagent": "3.1.3",
-    "@qilin-agent/session-persistence": "3.1.3",
-    "@qilin-agent/session": "3.1.3",
-    "@qilin-agent/typert-protocol": "3.1.3",
-    "@qilin-agent/llm": "3.1.3"
+    "@qilin-agent/agent": "3.1.4",
+    "@qilin-agent/session": "3.1.4",
+    "@qilin-agent/session-persistence": "3.1.4",
+    "@qilin-agent/llm": "3.1.4",
+    "@qilin-agent/session-projection": "3.1.4",
+    "@qilin-agent/subagent": "3.1.4",
+    "@qilin-agent/typert-protocol": "3.1.4"
   },
   "devDependencies": {
+    "@qilin-agent/agent-loop": "3.1.4",
+    "@qilin-agent/agent": "3.1.4",
+    "@qilin-agent/agent-loop-testkit": "3.1.4",
     "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/agent-loop": "3.1.3",
-    "@qilin-agent/agent-loop-testkit": "3.1.3",
-    "@qilin-agent/agent": "3.1.3",
-    "@qilin-agent/llm": "3.1.3",
-    "@qilin-agent/session": "3.1.3",
-    "@qilin-agent/session-persistence": "3.1.3",
-    "@qilin-agent/session-persistence-jsonl": "3.1.3",
-    "@qilin-agent/session-projection": "3.1.3",
-    "@qilin-agent/session-query": "3.1.3",
-    "@qilin-agent/subagent-fork-in-process": "3.1.3",
-    "@qilin-agent/subagent": "3.1.3",
-    "@qilin-agent/subagent-spawn-in-process": "3.1.3",
-    "@qilin-agent/typert-protocol": "3.1.3"
+    "@qilin-agent/llm": "3.1.4",
+    "@qilin-agent/session": "3.1.4",
+    "@qilin-agent/session-persistence": "3.1.4",
+    "@qilin-agent/session-persistence-jsonl": "3.1.4",
+    "@qilin-agent/session-projection": "3.1.4",
+    "@qilin-agent/subagent": "3.1.4",
+    "@qilin-agent/session-query": "3.1.4",
+    "@qilin-agent/subagent-fork-in-process": "3.1.4",
+    "@qilin-agent/typert-protocol": "3.1.4",
+    "@qilin-agent/subagent-spawn-in-process": "3.1.4"
   }
 }

package/lib/types/mailbox.d.ts

@@ -1,78 +0,0 @@
-/** Durable Team mailbox admission, target-local dispatch, acknowledgement, and recovery. */
-import type { Context } from '@qilin-agent/kylin';
-import type { Agent } from '@qilin-agent/agent';
-import type { Session, SessionEvent } from '@qilin-agent/session';
-import type { TeamJournal } from './journal.ts';
-import type { TeamRuntimeLifecycle } from './lifecycle.ts';
-import type { TeamRoster } from './roster.ts';
-import type { SendTeamMessageRequest, SendTeamMessageResult } from './types.ts';
-/** Owns every process-local state transition for the durable Team mailbox. */
-export declare class TeamMailbox {
-    private readonly ctx;
-    private readonly journal;
-    private readonly roster;
-    private readonly lifecycle;
-    private readonly maxPendingMessagesPerMember;
-    private readonly maxMessageBytes;
-    private readonly dispatchTails;
-    private readonly inFlightMessages;
-    private readonly inFlightDispatches;
-    /**
-     * @param ctx - Team service context with Agent, Session, persistence, and subagent services.
-     * @param journal - authoritative Lead-log transaction owner.
-     * @param roster - Team membership and member-name resolver.
-     * @param lifecycle - shared Team runtime admission cutoff.
-     * @param maxPendingMessagesPerMember - per-target queued-minus-delivered limit.
-     * @param maxMessageBytes - maximum complete sender-framed delivery size.
-     */
-    constructor(ctx: Context, journal: TeamJournal, roster: TeamRoster, lifecycle: TeamRuntimeLifecycle, maxPendingMessagesPerMember: number, maxMessageBytes: number);
-    /**
-     * Queue one durable peer message, then attempt immediate delivery.
-     * @param caller - exact live sending Team member.
-     * @param request - target name, content, and pre-queue cancellation.
-     * @returns durable message identity and immediate-delivery observation.
-     */
-    send(caller: Agent, request: SendTeamMessageRequest): Promise<SendTeamMessageResult>;
-    /**
-     * Observe target-side durable receipts and checkpoint their Lead-log acknowledgement.
-     * @param session - exact target Session receiving the event.
-     * @param event - newly appended Session event.
-     */
-    observeSessionEvent(session: Session, event: SessionEvent): void;
-    /**
-     * Retry durable pending messages relevant to one started Team member.
-     * @param agent - newly started exact live Agent.
-     * @param signal - shared runtime cancellation.
-     */
-    recoverFor(agent: Agent, signal: AbortSignal): Promise<void>;
-    /**
-     * Return admitted dispatch and acknowledgement operations captured for disposal.
-     * @returns detached snapshot ordered only by Set insertion.
-     */
-    pendingDispatches(): readonly Promise<unknown>[];
-    /** Queue and dispatch one mailbox item admitted before the disposal cutoff. */
-    private sendAdmitted;
-    /** Attempt one queued message exactly once in this process at a time. */
-    private tryDispatch;
-    /** Track one dispatch transaction through delivery admission or contained failure. */
-    private trackDispatch;
-    /** Attempt one queued message admitted before the service lifecycle cutoff. */
-    private tryDispatchAdmitted;
-    /** Serialize delivery admission for one durable target in queued order. */
-    private serializeDispatch;
-    /** Deliver every pending target message through `message` in durable queue order. */
-    private dispatchThrough;
-    /** Attempt one queued delivery after target-local ordering admits it. */
-    private dispatchOnce;
-    /** Flush one live target receipt before the Lead records its delivered edge. */
-    private checkpointDelivered;
-    /** Record delivery unless the acknowledgement already exists. */
-    private markDelivered;
-    /** Whether a target Session already contains the durable message identity. */
-    private targetRecorded;
-    /** Frame peer content with stable sender and message identity for the receiving model. */
-    private deliveryContent;
-    /** Read an inactive target's durable log before cold resume; uncertainty keeps the mailbox queued. */
-    private persistedTargetRecorded;
-}
-//# sourceMappingURL=mailbox.d.ts.map