@qduc/term2 0.11.0 → 0.11.1

package/dist/services/subagents/subagent-notification-store.d.ts

@@ -1,6 +1,9 @@
 import type { ConversationEvent } from '../conversation/conversation-events.js';
-/** A background subagent run that finished and still owes the main agent a notification. */
-export interface BackgroundSubagentNotification {
+/** A completed background run that still owes the main agent a notification. */
+export interface BackgroundSubagentCompletionNotification {
+    kind: 'completion';
+    /** Stable per logical run, so replay cannot duplicate a completion. */
+    messageId: string;
     runId: string;
     role: string;
     status: 'completed' | 'failed' | 'cancelled';
@@ -8,7 +11,25 @@ export interface BackgroundSubagentNotification {
     error?: string;
     completedAt: number;
 }
+/** A live execution segment's bounded request for its owning orchestrator. */
+export interface BackgroundSubagentQuestionNotification {
+    kind: 'question';
+    messageId: string;
+    runId: string;
+    name?: string;
+    role: string;
+    question: string;
+    askedAt: number;
+}
+/** A message-id-keyed queue item for a background async subagent. */
+export type BackgroundSubagentNotification = BackgroundSubagentCompletionNotification | BackgroundSubagentQuestionNotification;
 export type BackgroundSubagentTaskStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+/** The single most recent tool call observed for a live background run. */
+export interface BackgroundSubagentTaskTool {
+    /** Display-ready command line, e.g. `grep "TODO" src/`. */
+    label: string;
+    state: 'running' | 'success' | 'failed';
+}
 /** Conversation-scoped projection of one background subagent lifecycle. */
 export interface BackgroundSubagentTask {
     runId: string;
@@ -17,6 +38,8 @@ export interface BackgroundSubagentTask {
     status: BackgroundSubagentTaskStatus;
     startedAt: number;
     completedAt?: number;
+    /** Absent until the run calls its first tool; dropped once the run settles. */
+    lastTool?: BackgroundSubagentTaskTool;
 }
 /**
  * The delivery half of {@link SubagentNotificationStore}, for callers that hand
@@ -38,9 +61,9 @@ export interface SubagentNotificationStoreDeps {
     /** How long terminal tasks remain visible in the background overview. */
     recentTaskRetentionMs?: number;
     /**
-     * Upper bound on remembered run ids. The async registry caps sessions at 50
-     * and TTLs terminal runs out after 30 minutes, so a few hundred ids covers
-     * every run that could still be replayed while staying O(1) in memory.
+     * Upper bound on remembered notification ids. The async registry caps
+     * sessions at 50 and TTLs terminal runs out after 30 minutes, so a few
+     * hundred ids covers replay protection while staying O(1) in memory.
      */
     deliveredIdCap?: number;
 }
@@ -49,36 +72,31 @@ export declare const BACKGROUND_TASK_RECENT_RETENTION_MS = 5000;
  * Pending notifications for background (async) subagent runs.
  *
  * Owns three invariants the callers must not have to re-derive:
- *  - Only `subagent_completed` events flagged `async: true` are notifiable.
- *    Foreground and nested runs emit the same event type without the flag and
- *    must never surface a notification.
- *  - A run is announced at most once, ever. The registry already guards against
- *    double-settling a run, so the duplicates guarded here come from buffered
- *    event flushes and conversation replay, which can re-present an event long
- *    after it was first seen — including after it was already delivered.
+ *  - Only async completions and async registry questions are notifiable.
+ *    Foreground and nested activity has no async flag and never surfaces here.
+ *  - A message is announced at most once, ever. Completion ids are stable per
+ *    run while each question has its own id, allowing one live run to ask more
+ *    than once over its lifetime without replaying either message.
  *  - Delivery is confirmed by the caller, not by reading. `drain()` hands over
  *    the pending batch and clears it; a caller whose delivery failed calls
  *    `retain()` to put the batch back at the front of the queue. Drain/retain
  *    was chosen over peek/commit because the common path (delivery succeeds) is
  *    then a single call, and because retained notifications are handed back as
- *    values rather than leaving the store holding provisional state. A run id
- *    stays deduped across both paths, so a retained notification is redelivered
- *    exactly once and a replayed event for it is still dropped.
+ *    values rather than leaving the store holding provisional state. A message
+ *    id stays deduped across both paths, so a retained notification is
+ *    redelivered exactly once and a replayed event for it is still dropped.
  */
 export declare class SubagentNotificationStore implements BackgroundSubagentNotificationPort {
     #private;
     constructor(deps?: SubagentNotificationStoreDeps);
     /**
-     * Updates the read-only task projection for async starts and completions.
-     * Internal tool events intentionally do not enter this state.
+     * Updates the read-only task projection for async starts, tool activity, and
+     * completions. Only the newest tool call of a live run is kept: the overview
+     * answers "what is it doing now", not "what has it done".
      */
     recordLifecycle(event: ConversationEvent): boolean;
     getTaskSnapshot(): readonly BackgroundSubagentTask[];
-    /**
-     * Records a completion event when it belongs to a background run that has not
-     * been seen before. Returns whether the notification was novel, so a caller
-     * can act (wake a turn) only on first sight.
-     */
+    /** Records one novel async completion or question, returning whether it woke the queue. */
     enqueue(event: ConversationEvent): boolean;
     get pendingCount(): number;
     /** Hands over every pending notification in completion order and clears them. */

package/dist/services/subagents/subagent-notification-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-notification-store.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-notification-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAIhF,4FAA4F;AAC5F,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5F,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,KAAK,IAAI,8BAA8B,EAAE,CAAC;IAC1C,MAAM,CAAC,aAAa,EAAE,SAAS,8BAA8B,EAAE,GAAG,IAAI,CAAC;CACxE;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,WAAW,IAAI,SAAS,sBAAsB,EAAE,CAAC;IACjD,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAA0B,YAAW,kCAAkC;;IASlF,YAAY,IAAI,GAAE,6BAAkC,EAInD;IAED;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CA2CjD;IAED,eAAe,IAAI,SAAS,sBAAsB,EAAE,CAQnD;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAkBzC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,iFAAiF;IACjF,KAAK,IAAI,8BAA8B,EAAE,CAOxC;IAED,+EAA+E;IAC/E,MAAM,CAAC,aAAa,EAAE,SAAS,8BAA8B,EAAE,GAAG,IAAI,CASrE;CAiBF"}
+{"version":3,"file":"subagent-notification-store.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-notification-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,wCAAwC,CAAC;AAKhD,gFAAgF;AAChF,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,YAAY,CAAC;IACnB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8EAA8E;AAC9E,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,MAAM,8BAA8B,GACtC,wCAAwC,GACxC,sCAAsC,CAAC;AAE3C,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5F,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CACzC;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,KAAK,IAAI,8BAA8B,EAAE,CAAC;IAC1C,MAAM,CAAC,aAAa,EAAE,SAAS,8BAA8B,EAAE,GAAG,IAAI,CAAC;CACxE;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,WAAW,IAAI,SAAS,sBAAsB,EAAE,CAAC;IACjD,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,yBAA0B,YAAW,kCAAkC;;IASlF,YAAY,IAAI,GAAE,6BAAkC,EAInD;IAED;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CA+CjD;IA6BD,eAAe,IAAI,SAAS,sBAAsB,EAAE,CAQnD;IAED,2FAA2F;IAC3F,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAQzC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,iFAAiF;IACjF,KAAK,IAAI,8BAA8B,EAAE,CAOxC;IAED,+EAA+E;IAC/E,MAAM,CAAC,aAAa,EAAE,SAAS,8BAA8B,EAAE,GAAG,IAAI,CASrE;CA+CF"}

package/dist/services/subagents/subagent-notification-store.js

@@ -1,3 +1,4 @@
+import { formatToolCommand, parseToolArguments } from '../../utils/conversation/conversation-utils.js';
 import { truncatePreview } from './utils.js';
 const DEFAULT_DELIVERED_ID_CAP = 256;
 export const BACKGROUND_TASK_RECENT_RETENTION_MS = 5_000;
@@ -5,21 +6,19 @@ export const BACKGROUND_TASK_RECENT_RETENTION_MS = 5_000;
  * Pending notifications for background (async) subagent runs.
  *
  * Owns three invariants the callers must not have to re-derive:
- *  - Only `subagent_completed` events flagged `async: true` are notifiable.
- *    Foreground and nested runs emit the same event type without the flag and
- *    must never surface a notification.
- *  - A run is announced at most once, ever. The registry already guards against
- *    double-settling a run, so the duplicates guarded here come from buffered
- *    event flushes and conversation replay, which can re-present an event long
- *    after it was first seen — including after it was already delivered.
+ *  - Only async completions and async registry questions are notifiable.
+ *    Foreground and nested activity has no async flag and never surfaces here.
+ *  - A message is announced at most once, ever. Completion ids are stable per
+ *    run while each question has its own id, allowing one live run to ask more
+ *    than once over its lifetime without replaying either message.
  *  - Delivery is confirmed by the caller, not by reading. `drain()` hands over
  *    the pending batch and clears it; a caller whose delivery failed calls
  *    `retain()` to put the batch back at the front of the queue. Drain/retain
  *    was chosen over peek/commit because the common path (delivery succeeds) is
  *    then a single call, and because retained notifications are handed back as
- *    values rather than leaving the store holding provisional state. A run id
- *    stays deduped across both paths, so a retained notification is redelivered
- *    exactly once and a replayed event for it is still dropped.
+ *    values rather than leaving the store holding provisional state. A message
+ *    id stays deduped across both paths, so a retained notification is
+ *    redelivered exactly once and a replayed event for it is still dropped.
  */
 export class SubagentNotificationStore {
     #pending = new Map();
@@ -35,10 +34,14 @@ export class SubagentNotificationStore {
         this.#recentTaskRetentionMs = Math.max(0, deps.recentTaskRetentionMs ?? BACKGROUND_TASK_RECENT_RETENTION_MS);
     }
     /**
-     * Updates the read-only task projection for async starts and completions.
-     * Internal tool events intentionally do not enter this state.
+     * Updates the read-only task projection for async starts, tool activity, and
+     * completions. Only the newest tool call of a live run is kept: the overview
+     * answers "what is it doing now", not "what has it done".
      */
     recordLifecycle(event) {
+        if (event.type === 'subagent_tool_started' || event.type === 'subagent_command_message') {
+            return this.#recordToolActivity(event);
+        }
         if (event.type === 'subagent_started' && event.async === true) {
             if (this.#settledTaskIds.has(event.agentId))
                 return false;
@@ -85,6 +88,31 @@ export class SubagentNotificationStore {
         }
         return true;
     }
+    /**
+     * Projects the newest tool call of a live run. Tool events carry no `async`
+     * flag, so membership in the running task map is what scopes this to
+     * background runs — foreground and nested activity never registers a task.
+     */
+    #recordToolActivity(event) {
+        const task = this.#tasks.get(event.agentId);
+        if (!task || task.status !== 'running')
+            return false;
+        const lastTool = event.type === 'subagent_tool_started'
+            ? {
+                label: formatToolCommand(event.toolName, parseToolArguments(event.arguments)),
+                state: 'running',
+            }
+            : {
+                label: event.message?.command ?? '',
+                state: event.message?.success === false ? 'failed' : 'success',
+            };
+        if (!lastTool.label)
+            return false;
+        if (task.lastTool?.label === lastTool.label && task.lastTool.state === lastTool.state)
+            return false;
+        this.#tasks.set(event.agentId, { ...task, lastTool });
+        return true;
+    }
     getTaskSnapshot() {
         const now = this.#now();
         for (const [runId, task] of this.#tasks) {
@@ -94,29 +122,13 @@ export class SubagentNotificationStore {
         }
         return [...this.#tasks.values()];
     }
-    /**
-     * Records a completion event when it belongs to a background run that has not
-     * been seen before. Returns whether the notification was novel, so a caller
-     * can act (wake a turn) only on first sight.
-     */
+    /** Records one novel async completion or question, returning whether it woke the queue. */
     enqueue(event) {
-        if (event?.type !== 'subagent_completed' || event.async !== true)
-            return false;
-        const result = event.result;
-        const runId = result?.agentId;
-        if (!result || !runId)
+        const notification = this.#notificationFor(event);
+        if (!notification || this.#seen.has(notification.messageId))
             return false;
-        if (this.#seen.has(runId))
-            return false;
-        this.#pending.set(runId, {
-            runId,
-            role: result.role,
-            status: result.status,
-            preview: truncatePreview(result.finalText || result.error),
-            ...(result.error ? { error: result.error } : {}),
-            completedAt: this.#now(),
-        });
-        this.#seen.add(runId);
+        this.#pending.set(notification.messageId, notification);
+        this.#seen.add(notification.messageId);
         this.#evictOldestSeen();
         return true;
     }
@@ -139,11 +151,11 @@ export class SubagentNotificationStore {
         const newer = [...this.#pending.values()];
         this.#pending.clear();
         for (const notification of notifications) {
-            this.#pending.set(notification.runId, notification);
-            this.#seen.add(notification.runId);
+            this.#pending.set(notification.messageId, notification);
+            this.#seen.add(notification.messageId);
         }
         for (const notification of newer)
-            this.#pending.set(notification.runId, notification);
+            this.#pending.set(notification.messageId, notification);
     }
     /**
      * Drops the oldest remembered ids once the cap is exceeded, skipping runs that
@@ -155,13 +167,43 @@ export class SubagentNotificationStore {
     #evictOldestSeen() {
         if (this.#seen.size <= this.#deliveredIdCap)
             return;
-        for (const runId of this.#seen) {
+        for (const messageId of this.#seen) {
             if (this.#seen.size <= this.#deliveredIdCap)
                 return;
-            if (this.#pending.has(runId))
+            if (this.#pending.has(messageId))
                 continue;
-            this.#seen.delete(runId);
+            this.#seen.delete(messageId);
+        }
+    }
+    #notificationFor(event) {
+        if (event.type === 'subagent_completed' && event.async === true) {
+            const result = event.result;
+            const runId = result?.agentId;
+            if (!result || !runId)
+                return undefined;
+            return {
+                kind: 'completion',
+                messageId: `completion:${runId}`,
+                runId,
+                role: result.role,
+                status: result.status,
+                preview: truncatePreview(result.finalText || result.error),
+                ...(result.error ? { error: result.error } : {}),
+                completedAt: this.#now(),
+            };
+        }
+        if (event.type === 'subagent_question' && event.async === true && event.messageId && event.runId) {
+            return {
+                kind: 'question',
+                messageId: event.messageId,
+                runId: event.runId,
+                ...(event.name !== undefined ? { name: event.name } : {}),
+                role: event.role,
+                question: event.question,
+                askedAt: this.#now(),
+            };
         }
+        return undefined;
     }
 }
 //# sourceMappingURL=subagent-notification-store.js.map

package/dist/services/subagents/subagent-notification-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-notification-store.js","sourceRoot":"","sources":["../../../source/services/subagents/subagent-notification-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"subagent-notification-store.js","sourceRoot":"","sources":["../../../source/services/subagents/subagent-notification-store.ts"],"names":[],"mappings":"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"}

package/dist/services/subagents/subagent-run-control.d.ts

@@ -0,0 +1,41 @@
+export interface SubagentRunControlOptions {
+    maxMailboxMessages?: number;
+    maxMailboxCharacters?: number;
+    maxContinuationSegments?: number;
+    createQuestionId?: () => string;
+}
+export interface PendingSubagentQuestion {
+    messageId: string;
+    question: string;
+}
+export interface AskedSubagentQuestion extends PendingSubagentQuestion {
+    answer: Promise<string>;
+}
+/**
+ * Per-logical-run coordination state. The registry owns lifecycle and identity;
+ * runners receive only the narrow callbacks they need for a segment.
+ */
+export declare class SubagentRunControl {
+    #private;
+    constructor(options?: SubagentRunControlOptions);
+    get currentSegmentController(): AbortController | undefined;
+    get activeToolCount(): number;
+    get cancellationRequested(): boolean;
+    get hasQueuedSteering(): boolean;
+    get currentSegmentAbortReason(): 'steer' | 'cancel' | undefined;
+    get continuationSegments(): number;
+    canStartContinuation(): boolean;
+    startContinuation(): boolean;
+    get pendingQuestion(): PendingSubagentQuestion | undefined;
+    beginSegment(): AbortController;
+    endSegment(controller: AbortController): void;
+    onToolStart(): void;
+    onToolComplete(): void;
+    enqueueSteering(message: string): void;
+    consumeSteering(): string | undefined;
+    ask(question: string): AskedSubagentQuestion;
+    answer(messageId: string, answer: string): boolean;
+    requestCancellation(): void;
+    settle(reason?: Error): void;
+}
+//# sourceMappingURL=subagent-run-control.d.ts.map

package/dist/services/subagents/subagent-run-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-run-control.d.ts","sourceRoot":"","sources":["../../../source/services/subagents/subagent-run-control.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAOD;;;GAGG;AACH,qBAAa,kBAAkB;;IAgB7B,YAAY,OAAO,GAAE,yBAA8B,EAKlD;IAED,IAAI,wBAAwB,IAAI,eAAe,GAAG,SAAS,CAE1D;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,qBAAqB,IAAI,OAAO,CAEnC;IAED,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,IAAI,yBAAyB,IAAI,OAAO,GAAG,QAAQ,GAAG,SAAS,CAE9D;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,oBAAoB,IAAI,OAAO,CAE9B;IAED,iBAAiB,IAAI,OAAO,CAI3B;IAED,IAAI,eAAe,IAAI,uBAAuB,GAAG,SAAS,CAEzD;IAED,YAAY,IAAI,eAAe,CAO9B;IAED,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAM5C;IAED,WAAW,IAAI,IAAI,CAElB;IAED,cAAc,IAAI,IAAI,CAIrB;IAED,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAarC;IAED,eAAe,IAAI,MAAM,GAAG,SAAS,CAQpC;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAe3C;IAED,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAMjD;IAED,mBAAmB,IAAI,IAAI,CAO1B;IAED,MAAM,CAAC,MAAM,QAA+C,GAAG,IAAI,CAKlE;CAaF"}

package/dist/services/subagents/subagent-run-control.js

@@ -0,0 +1,166 @@
+import { randomUUID } from 'node:crypto';
+const DEFAULT_MAX_MAILBOX_MESSAGES = 4;
+const DEFAULT_MAX_MAILBOX_CHARACTERS = 4_000;
+const DEFAULT_MAX_CONTINUATION_SEGMENTS = 3;
+const MAX_QUESTION_CHARACTERS = 1_200;
+const TRUNCATION_MARKER = '[Earlier steering omitted]';
+/**
+ * Per-logical-run coordination state. The registry owns lifecycle and identity;
+ * runners receive only the narrow callbacks they need for a segment.
+ */
+export class SubagentRunControl {
+    #maxMailboxMessages;
+    #maxMailboxCharacters;
+    #maxContinuationSegments;
+    #createQuestionId;
+    #controller;
+    #abortReason;
+    #activeToolCount = 0;
+    #interruptWhenToolsIdle = false;
+    #cancellationRequested = false;
+    #mailbox = [];
+    #mailboxCharacters = 0;
+    #mailboxTruncated = false;
+    #continuationSegments = 0;
+    #question;
+    constructor(options = {}) {
+        this.#maxMailboxMessages = options.maxMailboxMessages ?? DEFAULT_MAX_MAILBOX_MESSAGES;
+        this.#maxMailboxCharacters = options.maxMailboxCharacters ?? DEFAULT_MAX_MAILBOX_CHARACTERS;
+        this.#maxContinuationSegments = options.maxContinuationSegments ?? DEFAULT_MAX_CONTINUATION_SEGMENTS;
+        this.#createQuestionId = options.createQuestionId ?? randomUUID;
+    }
+    get currentSegmentController() {
+        return this.#controller;
+    }
+    get activeToolCount() {
+        return this.#activeToolCount;
+    }
+    get cancellationRequested() {
+        return this.#cancellationRequested;
+    }
+    get hasQueuedSteering() {
+        return this.#mailbox.length > 0;
+    }
+    get currentSegmentAbortReason() {
+        return this.#abortReason;
+    }
+    get continuationSegments() {
+        return this.#continuationSegments;
+    }
+    canStartContinuation() {
+        return !this.#cancellationRequested && this.#continuationSegments < this.#maxContinuationSegments;
+    }
+    startContinuation() {
+        if (!this.canStartContinuation())
+            return false;
+        this.#continuationSegments++;
+        return true;
+    }
+    get pendingQuestion() {
+        return this.#question && { messageId: this.#question.messageId, question: this.#question.question };
+    }
+    beginSegment() {
+        if (this.#controller)
+            throw new Error('A subagent segment is already active.');
+        const controller = new AbortController();
+        this.#controller = controller;
+        this.#abortReason = undefined;
+        if (this.#cancellationRequested)
+            this.#abortCurrentSegment('cancel');
+        return controller;
+    }
+    endSegment(controller) {
+        if (this.#controller !== controller)
+            return;
+        this.#controller = undefined;
+        this.#abortReason = undefined;
+        this.#activeToolCount = 0;
+        this.#interruptWhenToolsIdle = false;
+    }
+    onToolStart() {
+        this.#activeToolCount++;
+    }
+    onToolComplete() {
+        if (this.#activeToolCount === 0)
+            return;
+        this.#activeToolCount--;
+        if (this.#activeToolCount === 0 && this.#interruptWhenToolsIdle)
+            this.#abortCurrentSegment();
+    }
+    enqueueSteering(message) {
+        this.#mailbox.push(message);
+        this.#mailboxCharacters += message.length;
+        while (this.#mailbox.length > this.#maxMailboxMessages ||
+            (this.#mailbox.length > 1 && this.#mailboxCharacters > this.#maxMailboxCharacters)) {
+            const removed = this.#mailbox.shift();
+            this.#mailboxCharacters -= removed?.length ?? 0;
+            this.#mailboxTruncated = true;
+        }
+        this.#interruptWhenToolsIdle = true;
+        if (this.#activeToolCount === 0)
+            this.#abortCurrentSegment();
+    }
+    consumeSteering() {
+        if (this.#mailbox.length === 0)
+            return undefined;
+        const messages = this.#mailbox;
+        const truncated = this.#mailboxTruncated;
+        this.#mailbox = [];
+        this.#mailboxCharacters = 0;
+        this.#mailboxTruncated = false;
+        return [truncated ? TRUNCATION_MARKER : undefined, ...messages].filter(Boolean).join('\n');
+    }
+    ask(question) {
+        const boundedQuestion = question.trim();
+        if (boundedQuestion.length === 0)
+            throw new Error('A subagent question cannot be empty.');
+        if (boundedQuestion.length > MAX_QUESTION_CHARACTERS)
+            throw new Error(`Question exceeds ${MAX_QUESTION_CHARACTERS} characters.`);
+        if (this.#question)
+            throw new Error('A subagent question is already pending.');
+        let resolve;
+        let reject;
+        const answer = new Promise((resolveAnswer, rejectAnswer) => {
+            resolve = resolveAnswer;
+            reject = rejectAnswer;
+        });
+        const pending = { messageId: this.#createQuestionId(), question: boundedQuestion, resolve, reject };
+        this.#question = pending;
+        return { messageId: pending.messageId, question: boundedQuestion, answer };
+    }
+    answer(messageId, answer) {
+        if (!this.#question || this.#question.messageId !== messageId)
+            return false;
+        const pending = this.#question;
+        this.#question = undefined;
+        pending.resolve(answer);
+        return true;
+    }
+    requestCancellation() {
+        this.#cancellationRequested = true;
+        this.#mailbox = [];
+        this.#mailboxCharacters = 0;
+        this.#mailboxTruncated = false;
+        this.#rejectPendingQuestion(new Error('The subagent run was cancelled.'));
+        this.#abortCurrentSegment('cancel');
+    }
+    settle(reason = new Error('The subagent run was cancelled.')) {
+        this.#mailbox = [];
+        this.#mailboxCharacters = 0;
+        this.#mailboxTruncated = false;
+        this.#rejectPendingQuestion(reason);
+    }
+    #rejectPendingQuestion(reason) {
+        if (!this.#question)
+            return;
+        const pending = this.#question;
+        this.#question = undefined;
+        pending.reject(reason);
+    }
+    #abortCurrentSegment(reason = 'steer') {
+        this.#abortReason = reason;
+        if (this.#controller && !this.#controller.signal.aborted)
+            this.#controller.abort();
+    }
+}
+//# sourceMappingURL=subagent-run-control.js.map

package/dist/services/subagents/subagent-run-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-run-control.js","sourceRoot":"","sources":["../../../source/services/subagents/subagent-run-control.ts"],"names":[],"mappings":"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"}

package/dist/services/subagents/tool-policy.d.ts

@@ -1,10 +1,14 @@
 import { type Tool, type RunContext } from '@openai/agents';
 import type { ILoggingService, ISettingsService, ISessionContextService } from '../service-interfaces.js';
 import type { ExecutionContext } from '../execution-context.js';
-import type { SubagentDefinition, SupportedSubagentRole } from './types.js';
+import type { SubagentDefinition, SupportedSubagentRole, ValidationEvidence } from './types.js';
 import type { CommandMessage, ToolDefinition } from '../../tools/types.js';
 import type { SkillsService } from '../skills/skills-service.js';
 import type { ISubagentClient } from './subagent-client-types.js';
+/** A mutable holder for the last validation evidence captured from a shell run. */
+export interface ValidationCapture {
+    value?: ValidationEvidence;
+}
 export type SubagentRunContext = {
     agentId: string;
     role: SupportedSubagentRole;
@@ -14,9 +18,19 @@ export type SubagentRunContext = {
     activeCommandMessages: Record<string, CommandMessage[]>;
     turnCount: number;
     maxTurns: number;
+    /** Per-file line deltas for diffStat, captured from editor-tool writes. */
+    diffDeltas?: Map<string, {
+        added: number;
+        deleted: number;
+    }>;
+    /** Last validation-shaped shell command evidence. */
+    lastValidation?: ValidationCapture;
 };
 export declare function getSubagentRunContext(context: unknown): SubagentRunContext | undefined;
 export declare function formatRunningCommandMessages(definition: ToolDefinition, params: unknown): CommandMessage[];
+declare function isValidationCommand(command: string): boolean;
+export declare function captureValidationIfMatch(capture: ValidationCapture | undefined, command: string, result: unknown): void;
+export { isValidationCommand };
 export declare class SubagentToolPolicy {
     #private;
     constructor(deps: {
@@ -31,10 +45,13 @@ export declare class SubagentToolPolicy {
     extractPathsFromCommand(command: string, cwd: string): string[];
     extractSuccessfulWritePaths(result: unknown): string[];
     isYellowCommandApproved(command: string, taskContext: string): Promise<boolean>;
-    wrapShellTool(definition: ToolDefinition, cwd: string, filesChanged: string[], taskContext: string): ToolDefinition;
+    wrapShellTool(definition: ToolDefinition, cwd: string, filesChanged: string[], taskContext: string, validationCapture?: ValidationCapture): ToolDefinition;
     wrapNestedShellTool(definition: ToolDefinition, cwd: string): ToolDefinition;
     wrapReadOnlyShellTool(definition: ToolDefinition): ToolDefinition;
-    wrapWriteTool(definition: ToolDefinition, cwd: string, filesChanged: string[], extractPaths: (params: any) => string[], nestedApprovals?: boolean): ToolDefinition;
+    wrapWriteTool(definition: ToolDefinition, cwd: string, filesChanged: string[], extractPaths: (params: any) => string[], nestedApprovals?: boolean, diffDeltas?: Map<string, {
+        added: number;
+        deleted: number;
+    }>): ToolDefinition;
     /**
      * Wrap a read tool with filesystem scope enforcement.
      * When `scopePatterns` is defined (non-undefined), every path read must
@@ -89,7 +106,10 @@ export declare class SubagentToolFactory {
         toolPolicy: SubagentToolPolicy;
         skillsService?: SkillsService;
     });
-    buildToolDefinitions(definition: SubagentDefinition, filesChanged: string[], taskContext: string, searchViaShell: boolean, nestedApprovals?: boolean): ToolDefinition[];
+    buildToolDefinitions(definition: SubagentDefinition, filesChanged: string[], taskContext: string, searchViaShell: boolean, nestedApprovals?: boolean, diffDeltas?: Map<string, {
+        added: number;
+        deleted: number;
+    }>, validationCapture?: ValidationCapture, askOrchestrator?: (question: string) => Promise<string>): ToolDefinition[];
     buildAgentTools(toolDefinitions: ToolDefinition[], options: {
         providerId: string;
         onToolStart?: (toolName: string, params: unknown, commandMessages: CommandMessage[], context?: RunContext<unknown>, details?: unknown) => void;