@qduc/term2 0.11.1 → 0.13.0

package/dist/services/session/turn-status-machine.d.ts

@@ -17,6 +17,15 @@ export type TurnCommand = {
 } | {
     kind: 'none';
 };
+export type TurnStatusObserver = (transition: {
+    previous: SessionStatus;
+    current: SessionStatus;
+}) => void;
+/** Opaque admission lease for the currently active foreground turn. */
+export type TurnLease = {
+    readonly generation: number;
+    readonly __turnLease: unique symbol;
+};
 /**
  * Transition validator for turn status.
  *
@@ -26,20 +35,26 @@ export type TurnCommand = {
 export declare class TurnStatusMachine {
     #private;
     private status;
+    private nextGeneration;
+    private activeLease;
+    private observer;
+    constructor(observer?: TurnStatusObserver);
+    setObserver(observer: TurnStatusObserver | undefined): void;
     get current(): SessionStatus;
     is(status: SessionStatus): boolean;
-    beginTurn(): void;
-    requestApproval(): void;
-    beginContinuation(): void;
+    beginTurn(): TurnLease;
+    requestApproval(lease: TurnLease): void;
+    beginContinuation(): TurnLease;
     /**
      * Transitions to idle when the current status is streaming or continuing.
      * When the status is awaiting_approval this is a no-op so the caller can
      * safely call complete() in a finally block without losing the pending
      * approval state.
      */
-    complete(): void;
+    complete(lease: TurnLease): void;
     abort(): void;
-    completeOutcome(outcome: TurnOutcome): TurnCommand;
-    completeContinuationOutcome(outcome: TurnOutcome): TurnCommand;
+    completeOutcome(outcome: TurnOutcome, lease: TurnLease): TurnCommand;
+    completeContinuationOutcome(outcome: TurnOutcome, lease: TurnLease): TurnCommand;
+    owns(lease: TurnLease): boolean;
 }
 //# sourceMappingURL=turn-status-machine.d.ts.map

package/dist/services/session/turn-status-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-status-machine.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAEtF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAC5B,OAAO,CAAC,MAAM,CAAyB;IAEvC,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,EAAE,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEjC;IAED,SAAS,IAAI,IAAI,CAGhB;IAED,eAAe,IAAI,IAAI,CAKtB;IAED,iBAAiB,IAAI,IAAI,CAGxB;IAED;;;;;OAKG;IACH,QAAQ,IAAI,IAAI,CAIf;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAcjD;IAED,2BAA2B,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAa7D;CAOF"}
+{"version":3,"file":"turn-status-machine.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,mBAAmB,GAAG,YAAY,CAAC;AAEtF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvG,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,KAAK,IAAI,CAAC;AAE3G,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAE7F;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAC5B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAiC;IAEjD,YAAY,QAAQ,CAAC,EAAE,kBAAkB,EAExC;IAED,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAE1D;IAED,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,EAAE,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEjC;IAED,SAAS,IAAI,SAAS,CAKrB;IAED,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAMtC;IAED,iBAAiB,IAAI,SAAS,CAI7B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAM/B;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAenE;IAED,2BAA2B,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAc/E;IAED,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE9B;CAkBF"}

package/dist/services/session/turn-status-machine.js

@@ -6,6 +6,15 @@
  */
 export class TurnStatusMachine {
     status = 'idle';
+    nextGeneration = 0;
+    activeLease;
+    observer;
+    constructor(observer) {
+        this.observer = observer;
+    }
+    setObserver(observer) {
+        this.observer = observer;
+    }
     get current() {
         return this.status;
     }
@@ -14,17 +23,22 @@ export class TurnStatusMachine {
     }
     beginTurn() {
         this.#assertTransition('idle', 'streaming');
-        this.status = 'streaming';
+        this.#setStatus('streaming');
+        this.activeLease = { generation: ++this.nextGeneration };
+        return this.activeLease;
     }
-    requestApproval() {
+    requestApproval(lease) {
+        if (!this.owns(lease))
+            return;
         if (this.status !== 'streaming' && this.status !== 'continuing') {
             throw new Error(`Cannot request approval from ${this.status}`);
         }
-        this.status = 'awaiting_approval';
+        this.#setStatus('awaiting_approval');
     }
     beginContinuation() {
         this.#assertTransition('awaiting_approval', 'continuing');
-        this.status = 'continuing';
+        this.#setStatus('continuing');
+        return this.activeLease;
     }
     /**
      * Transitions to idle when the current status is streaming or continuing.
@@ -32,32 +46,40 @@ export class TurnStatusMachine {
      * safely call complete() in a finally block without losing the pending
      * approval state.
      */
-    complete() {
+    complete(lease) {
+        if (!this.owns(lease))
+            return;
         if (this.status === 'streaming' || this.status === 'continuing') {
-            this.status = 'idle';
+            this.#setStatus('idle');
+            this.activeLease = undefined;
         }
     }
     abort() {
-        this.status = 'idle';
+        this.#setStatus('idle');
+        this.activeLease = undefined;
     }
-    completeOutcome(outcome) {
+    completeOutcome(outcome, lease) {
+        if (!this.owns(lease))
+            return { kind: 'none' };
         switch (outcome.kind) {
             case 'response':
-                this.complete();
+                this.complete(lease);
                 return { kind: 'emit_terminal', terminal: outcome.terminal };
             case 'approval_required':
-                this.requestApproval();
+                this.requestApproval(lease);
                 return { kind: 'emit_terminal', terminal: outcome.terminal };
             case 'stale':
                 return { kind: 'none' };
             case 'failed':
-                this.complete();
+                this.complete(lease);
                 return { kind: 'none' };
         }
     }
-    completeContinuationOutcome(outcome) {
+    completeContinuationOutcome(outcome, lease) {
+        if (!this.owns(lease))
+            return { kind: 'none' };
         if (this.status === 'continuing' || this.status === 'streaming') {
-            return this.completeOutcome(outcome);
+            return this.completeOutcome(outcome, lease);
         }
         switch (outcome.kind) {
             case 'response':
@@ -68,10 +90,25 @@ export class TurnStatusMachine {
                 return { kind: 'none' };
         }
     }
+    owns(lease) {
+        return lease === this.activeLease;
+    }
     #assertTransition(from, to) {
         if (this.status !== from) {
             throw new Error(`Invalid transition: ${this.status} -> ${to}`);
         }
     }
+    #setStatus(next) {
+        if (this.status === next)
+            return;
+        const previous = this.status;
+        this.status = next;
+        try {
+            this.observer?.({ previous, current: next });
+        }
+        catch {
+            // Observers are diagnostic/lifecycle projections, never status owners.
+        }
+    }
 }
 //# sourceMappingURL=turn-status-machine.js.map

package/dist/services/session/turn-status-machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-status-machine.js","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,GAAkB,MAAM,CAAC;IAEvC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,EAAE,CAAC,MAAqB;QACtB,OAAO,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;IAChC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC;IACpC,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,eAAe,CAAC,OAAoB;QAClC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,UAAU;gBACb,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC/D,KAAK,mBAAmB;gBACtB,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC/D,KAAK,OAAO;gBACV,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1B,KAAK,QAAQ;gBACX,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,2BAA2B,CAAC,OAAoB;QAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,UAAU,CAAC;YAChB,KAAK,mBAAmB;gBACtB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC/D,KAAK,OAAO,CAAC;YACb,KAAK,QAAQ;gBACX,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,IAAmB,EAAE,EAAiB;QACtD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,MAAM,OAAO,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"turn-status-machine.js","sourceRoot":"","sources":["../../../source/services/session/turn-status-machine.ts"],"names":[],"mappings":"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"}

package/dist/services/session/turn-workflow.d.ts

@@ -1,3 +1,5 @@
+import type { ProviderInputItem } from '../../contracts/provider-input.js';
+import type { SteerOutcome } from '../agent-runtime/application-run-loop.js';
 import type { ConversationEvent } from '../conversation/conversation-events.js';
 import type { ILoggingService } from '../service-interfaces.js';
 import type { SessionToolTracker } from './session-tool-tracker.js';
@@ -51,6 +53,11 @@ import { type ContinuationInit } from './continuation-state.js';
 import { ToolApprovalBatchCoordinator } from '../approval/tool-approval-batch-coordinator.js';
 import type { ProviderContinuity } from '../provider-continuity.js';
 import type { SessionStreamProcessor } from './session-stream-processor.js';
+import type { PostExecutePendingRegistry } from './post-execute-pending-registry.js';
+import type { SessionAccessState } from './session-access-state.js';
+import type { OpenAIRootFreshTurnSelectorParityObserver } from '../openai-root-selector-parity-observer.js';
+import type { HookLifecyclePort } from '../hooks/hook-service.js';
+import type { HookEventFactory } from '../hooks/hook-event-factory.js';
 export interface TurnWorkflowDeps {
     agentClient: ConversationAgentClient;
     logger: ILoggingService;
@@ -70,15 +77,43 @@ export interface TurnWorkflowDeps {
     planApplier: ContinuationPlanApplier;
     continuationRecoveryHandler: ContinuationRecoveryHandler;
     providerContinuity: ProviderContinuity;
+    /** Omitted for caller-owned, nested, and transient clients. */
+    openAIRootFreshTurnSelectorParityObserver?: OpenAIRootFreshTurnSelectorParityObserver;
+    /** Handle-owned root capability; omitted only by nested compatibility callers. */
+    sessionAccess?: SessionAccessState;
     batchCoordinator?: ToolApprovalBatchCoordinator;
+    postExecutePending: PostExecutePendingRegistry;
+    setActivePostExecuteRunId?: (runId: string | null) => void;
+    hookLifecycle?: HookLifecyclePort;
+    hookEvents?: HookEventFactory;
 }
 export declare class TurnWorkflow {
     #private;
     private readonly deps;
     constructor(deps: TurnWorkflowDeps);
+    /**
+     * Tell the run loop where this turn begins and ends, so a message steered
+     * into it survives the gaps between its streams — the preparation before the
+     * first request, and the backoff before a retry restarts one.
+     */
+    openTurn(): void;
+    closeTurn(): void;
+    steer(items: readonly ProviderInputItem[], options?: {
+        id?: string;
+    }): Promise<SteerOutcome>;
+    /** Drop a still-waiting steer. False when it was already admitted. */
+    retractSteer(id: string): boolean;
+    /** Replace a waiting steer's items in place, keeping its position. */
+    editSteer(id: string, items: readonly ProviderInputItem[]): boolean;
+    /** Internal composition seam for correlating physical tool calls to a turn. */
+    setHookTurnId(turnId: string | undefined): void;
     executeInitial(attemptOrInput: TurnAttempt | string | UserTurn, options?: InitialTurnRunOptions): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
     executeContinuation(init: ContinuationInit, policy?: ApprovalDecisionPolicy): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
+    /** Re-observe an already-running post-execute stream without involving SDK approvals. */
+    continuePostExecute(): AsyncGenerator<ConversationEvent, TurnOutcome, void>;
     executeInitialAttempt(attemptOrInput: TurnAttempt | string | UserTurn, options?: InitialTurnRunOptions): AsyncGenerator<ConversationEvent, InternalTurnOutcome, void>;
     executeContinuationAttempt(init: ContinuationInit, policy?: ApprovalDecisionPolicy): AsyncGenerator<ConversationEvent, InternalTurnOutcome, void>;
+    abortLiveRun(): void;
+    get activePostExecuteRunId(): string | null;
 }
 //# sourceMappingURL=turn-workflow.d.ts.map

package/dist/services/session/turn-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-workflow.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn-workflow.d.ts","sourceRoot":"","sources":["../../../source/services/session/turn-workflow.ts"],"names":[],"mappings":"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"}