@qduc/term2 0.11.0 → 0.12.0

package/dist/services/provider-continuity.js

@@ -1,3 +1,5 @@
+var _a;
+import { isDeepStrictEqual } from 'node:util';
 /**
  * Owns provider-side response chaining state: previousResponseId and
  * whether chaining has been broken (e.g. by transport downgrade).
@@ -8,24 +10,192 @@
 export class ProviderContinuity {
     #previousResponseId = null;
     #chainingBroken = false;
+    #lineage = 0;
+    #checkpoint = null;
+    #retiredCheckpoints = [];
     get previousResponseId() {
         return this.#previousResponseId;
     }
     get chainingBroken() {
         return this.#chainingBroken;
     }
+    get checkpoint() {
+        return this.#checkpoint;
+    }
+    get lineage() {
+        return this.#lineage;
+    }
+    get retiredCheckpoints() {
+        return this.#retiredCheckpoints;
+    }
+    /**
+     * Records a provider response observed before its terminal history is
+     * committed. This deliberately does not update previousResponseId: existing
+     * wire continuity remains owned by update().
+     */
+    observeCandidate(candidate) {
+        if (candidate.lineage !== undefined && candidate.lineage !== this.#lineage) {
+            return false;
+        }
+        this.#retireCheckpoint('superseded');
+        this.#checkpoint = {
+            ...candidate,
+            lineage: this.#lineage,
+            state: 'candidate',
+        };
+        return true;
+    }
+    /**
+     * Accepts only the candidate for this exact terminal response and binding.
+     * Call this in the same current-generation callback that committed history.
+     */
+    promoteCandidate(responseId, binding) {
+        const checkpoint = this.#checkpoint;
+        if (!checkpoint ||
+            checkpoint.state !== 'candidate' ||
+            checkpoint.lineage !== this.#lineage ||
+            checkpoint.responseId !== responseId) {
+            return false;
+        }
+        if (binding) {
+            const retirement = _a.#bindingMismatch(checkpoint, binding);
+            if (retirement) {
+                this.#retireCheckpoint(retirement);
+                return false;
+            }
+        }
+        this.#checkpoint = { ...checkpoint, state: 'accepted' };
+        return true;
+    }
     update(responseId) {
         this.#previousResponseId = responseId;
     }
+    /**
+     * Publishes the terminal response ID using the established legacy state and,
+     * only after an authoritative history commit, accepts a matching observed
+     * checkpoint as corroborating evidence. This does not select a checkpoint
+     * for a future request.
+     */
+    publishTerminalResponse(responseId, historyCommitted, postCommitSnapshot) {
+        this.update(responseId);
+        const promoted = historyCommitted && this.promoteCandidate(responseId);
+        if (promoted && postCommitSnapshot) {
+            this.#attachSuccessorProof(postCommitSnapshot);
+        }
+        return promoted;
+    }
+    /**
+     * Pure, fail-closed characterization for a future OpenAI-private selector.
+     * A successor must preserve the committed transcript exactly and add to it;
+     * this does not select or publish a previous response ID.
+     */
+    isEligibleForSuccessor(identity, lineage, plannedSnapshot) {
+        return this.assessSuccessorEligibility(identity, lineage, plannedSnapshot).eligible;
+    }
+    /**
+     * Read-only, fail-closed eligibility assessment for bounded diagnostics.
+     * Its fixed failure enum contains no provider IDs, history, or request data.
+     */
+    assessSuccessorEligibility(identity, lineage, plannedSnapshot) {
+        const checkpoint = this.#checkpoint;
+        const proof = checkpoint?.successorProof;
+        if (!checkpoint || checkpoint.state !== 'accepted')
+            return { eligible: false, failure: 'no_accepted_checkpoint' };
+        if (checkpoint.lineage !== lineage)
+            return { eligible: false, failure: 'lineage_mismatch' };
+        if (!proof)
+            return { eligible: false, failure: 'missing_successor_proof' };
+        if (!_a.#isSnapshotProof(plannedSnapshot)) {
+            return { eligible: false, failure: 'invalid_planned_snapshot' };
+        }
+        if (!_a.#identityMatches(checkpoint.identity, identity)) {
+            return { eligible: false, failure: 'identity_mismatch' };
+        }
+        if (!proof.origin || proof.origin !== plannedSnapshot.origin)
+            return { eligible: false, failure: 'origin_mismatch' };
+        if (plannedSnapshot.revision <= proof.revision)
+            return { eligible: false, failure: 'revision_not_advanced' };
+        if (plannedSnapshot.history.length <= proof.history.length)
+            return { eligible: false, failure: 'history_not_extended' };
+        try {
+            return proof.history.every((item, index) => isDeepStrictEqual(item, plannedSnapshot.history[index]))
+                ? { eligible: true }
+                : { eligible: false, failure: 'history_prefix_mismatch' };
+        }
+        catch {
+            return { eligible: false, failure: 'history_prefix_mismatch' };
+        }
+    }
     clear() {
         this.#previousResponseId = null;
+        this.#retireCheckpoint('reset');
+        this.#lineage++;
     }
     breakChaining() {
         this.#previousResponseId = null;
         this.#chainingBroken = true;
+        this.#retireCheckpoint('chaining_broken');
     }
     isChainingAvailable(historyLength) {
         return !this.#chainingBroken && (this.#previousResponseId !== null || (historyLength ?? 0) <= 1);
     }
+    #retireCheckpoint(code) {
+        if (!this.#checkpoint)
+            return;
+        this.#retiredCheckpoints.push({ ...this.#checkpoint, state: 'retired', retirement: { code } });
+        this.#checkpoint = null;
+    }
+    #attachSuccessorProof(snapshot) {
+        const checkpoint = this.#checkpoint;
+        if (!checkpoint || checkpoint.state !== 'accepted')
+            return;
+        try {
+            const proof = _a.#freezeSnapshot(snapshot);
+            this.#checkpoint = { ...checkpoint, successorProof: proof };
+        }
+        catch {
+            // This is characterization evidence only. A cloning failure must not
+            // change the already-established terminal publication behavior.
+        }
+    }
+    static #freezeSnapshot(snapshot) {
+        return Object.freeze({
+            revision: snapshot.revision,
+            identity: snapshot.identity,
+            origin: snapshot.origin,
+            history: _a.#deepFreeze(structuredClone(snapshot.history)),
+        });
+    }
+    static #deepFreeze(value, seen = new WeakSet()) {
+        if (!value || typeof value !== 'object' || seen.has(value))
+            return value;
+        seen.add(value);
+        for (const child of Object.values(value))
+            _a.#deepFreeze(child, seen);
+        return Object.freeze(value);
+    }
+    static #identityMatches(left, right) {
+        return left.provider === right.provider && left.endpoint === right.endpoint && left.model === right.model;
+    }
+    static #isSnapshotProof(value) {
+        const snapshot = value;
+        return !!(snapshot &&
+            Number.isSafeInteger(snapshot.revision) &&
+            typeof snapshot.identity === 'string' &&
+            snapshot.identity.length > 0 &&
+            typeof snapshot.origin === 'string' &&
+            snapshot.origin.length > 0 &&
+            Array.isArray(snapshot.history));
+    }
+    static #bindingMismatch(left, right) {
+        if (!_a.#identityMatches(left.identity, right.identity)) {
+            return 'identity_mismatch';
+        }
+        if (left.prefix.revision !== right.prefix.revision || left.prefix.identity !== right.prefix.identity) {
+            return 'prefix_mismatch';
+        }
+        return null;
+    }
 }
+_a = ProviderContinuity;
 //# sourceMappingURL=provider-continuity.js.map

package/dist/services/provider-continuity.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-continuity.js","sourceRoot":"","sources":["../../source/services/provider-continuity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,mBAAmB,GAAkB,IAAI,CAAC;IAC1C,eAAe,GAAG,KAAK,CAAC;IAExB,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,UAAyB;QAC9B,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC;IACxC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAClC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,mBAAmB,CAAC,aAAsB;QACxC,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,mBAAmB,KAAK,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnG,CAAC;CACF"}
+{"version":3,"file":"provider-continuity.js","sourceRoot":"","sources":["../../source/services/provider-continuity.ts"],"names":[],"mappings":"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"}

package/dist/services/providers/provider-management-session.d.ts

@@ -0,0 +1,12 @@
+import type { ISettingsService } from '../service-interfaces.js';
+import { type CustomProviderDraft, type ProviderSelectionItem, type SaveProviderResult } from '../../providers/provider-service.js';
+/** Public policy seam for provider management; Ink owns selection and display state. */
+export declare class ProviderManagementSession {
+    #private;
+    constructor(settings: ISettingsService);
+    list(): ProviderSelectionItem[];
+    save(draft: CustomProviderDraft, editingOriginalName: string | null): SaveProviderResult;
+    delete(providerId: string): void;
+    saveOrder(providerIds: readonly string[]): void;
+}
+//# sourceMappingURL=provider-management-session.d.ts.map

package/dist/services/providers/provider-management-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-management-session.d.ts","sourceRoot":"","sources":["../../../source/services/providers/provider-management-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,qCAAqC,CAAC;AAE7C,wFAAwF;AACxF,qBAAa,yBAAyB;;IAGpC,YAAY,QAAQ,EAAE,gBAAgB,EAErC;IAED,IAAI,IAAI,qBAAqB,EAAE,CAE9B;IAED,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,CAEvF;IAED,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAE9C;CACF"}

package/dist/services/providers/provider-management-session.js

@@ -0,0 +1,21 @@
+import { deleteCustomProvider, loadProviderItems, saveProvider, } from '../../providers/provider-service.js';
+/** Public policy seam for provider management; Ink owns selection and display state. */
+export class ProviderManagementSession {
+    #settings;
+    constructor(settings) {
+        this.#settings = settings;
+    }
+    list() {
+        return loadProviderItems(this.#settings);
+    }
+    save(draft, editingOriginalName) {
+        return saveProvider(this.#settings, draft, editingOriginalName);
+    }
+    delete(providerId) {
+        deleteCustomProvider(this.#settings, providerId);
+    }
+    saveOrder(providerIds) {
+        this.#settings.setPersistent('providerOrder', [...providerIds]);
+    }
+}
+//# sourceMappingURL=provider-management-session.js.map

package/dist/services/providers/provider-management-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-management-session.js","sourceRoot":"","sources":["../../../source/services/providers/provider-management-session.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GAIb,MAAM,qCAAqC,CAAC;AAE7C,wFAAwF;AACxF,MAAM,OAAO,yBAAyB;IAC3B,SAAS,CAAmB;IAErC,YAAY,QAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,KAA0B,EAAE,mBAAkC;QACjE,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,UAAkB;QACvB,oBAAoB,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,SAAS,CAAC,WAA8B;QACtC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/services/queue/queue-controller.d.ts

@@ -50,6 +50,8 @@ export interface PersistedQueueItem {
     readonly text: string;
     readonly sequence: number;
     readonly submittedAt: string;
+    /** Submitted as a steer, so it runs ahead of follow-ups queued before it. */
+    readonly steer?: boolean;
     readonly preflight?: {
         readonly actionId: string;
         readonly kind: PreflightKind;
@@ -60,6 +62,8 @@ export interface QueueItem {
     readonly text: string;
     readonly sequence: number;
     readonly submittedAt: string;
+    /** Submitted as a steer, so it runs ahead of follow-ups queued before it. */
+    readonly steer?: boolean;
     readonly preflight?: {
         readonly actionId: ActionId;
         readonly kind: PreflightKind;
@@ -112,6 +116,11 @@ export type QueueState<Snapshot> = {
 export type QueueCommand = {
     readonly kind: 'submit';
     readonly text: string;
+    readonly id?: string;
+} | {
+    readonly kind: 'steer';
+    readonly text: string;
+    readonly id?: string;
 } | {
     readonly kind: 'cancel';
 } | {
@@ -155,9 +164,6 @@ export type TurnEvent<Terminal = unknown> = {
     readonly kind: 'failed';
     readonly executionId: ExecutionId;
     readonly failure: unknown;
-} | {
-    readonly kind: 'cancelled';
-    readonly executionId: ExecutionId;
 } | {
     readonly kind: 'tool_approval_requested';
     readonly executionId: ExecutionId;
@@ -177,19 +183,9 @@ export type QueueCommandResult = {
 } | {
     readonly kind: 'no_op';
 };
-export interface ToolApprovalResolution {
-    readonly approved: boolean;
-}
-export interface AskUserResolution {
-    readonly value: string;
-}
 export interface QueueTurnDriver<Snapshot> {
     start(execution: ActiveExecution<Snapshot>): void | Promise<void>;
-    cancel(execution: ActiveExecution<Snapshot>): void | Promise<void>;
-    continueAfterAction?(execution: ActiveExecution<Snapshot>, pendingAction: {
-        actionId: string;
-        kind: ActiveActionKind;
-    }, resolution: ToolApprovalResolution | AskUserResolution): void | Promise<void>;
+    cancel(execution: ActiveExecution<Snapshot>): void | boolean | Promise<void | boolean>;
 }
 export interface QueueControllerOptions<Snapshot, Terminal = unknown> {
     readonly driver: QueueTurnDriver<Snapshot>;

package/dist/services/queue/queue-controller.d.ts.map

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

package/dist/services/queue/queue-controller.js

@@ -19,7 +19,8 @@ const isPersistedQueueItem = (value) => {
         !Number.isSafeInteger(item.sequence) ||
         item.sequence <= 0 ||
         !isNonEmptyString(item.submittedAt) ||
-        Number.isNaN(Date.parse(item.submittedAt))) {
+        Number.isNaN(Date.parse(item.submittedAt)) ||
+        (item.steer !== undefined && typeof item.steer !== 'boolean')) {
         return false;
     }
     if (item.preflight !== undefined) {
@@ -90,6 +91,7 @@ const queueItemToPersisted = (item) => ({
     text: item.text,
     sequence: item.sequence,
     submittedAt: item.submittedAt,
+    ...(item.steer ? { steer: true } : {}),
     preflight: item.preflight ? { actionId: item.preflight.actionId, kind: item.preflight.kind } : undefined,
 });
 export class QueueController {
@@ -110,6 +112,7 @@ export class QueueController {
     #pendingAction;
     #pauseReason;
     #recovery;
+    #persistenceWrites = Promise.resolve();
     constructor(options) {
         this.#driver = options.driver;
         this.#snapshotFactory = options.snapshotFactory;
@@ -155,21 +158,10 @@ export class QueueController {
     }
     async command(cmd) {
         switch (cmd.kind) {
-            case 'submit': {
-                if (!cmd.text.trim())
-                    return { kind: 'rejected', reason: 'invalid' };
-                if (this.#queue.length >= this.#capacity)
-                    return { kind: 'rejected', reason: 'capacity' };
-                this.#queue.push(freeze({
-                    id: this.#itemId(),
-                    text: cmd.text,
-                    sequence: this.#nextSequence++,
-                    submittedAt: this.#now(),
-                }));
-                await this.#persist();
-                await this.#dispatch();
-                return { kind: 'accepted' };
-            }
+            case 'submit':
+                return this.#submit(cmd);
+            case 'steer':
+                return this.#submit(cmd);
             case 'cancel':
                 return this.#cancel();
             case 'answer_preflight': {
@@ -196,7 +188,7 @@ export class QueueController {
                     this.#pendingAction.kind !== 'tool_approval') {
                     return { kind: 'rejected', reason: 'stale' };
                 }
-                return this.#resolveAction(cmd);
+                return this.#resolveAction();
             }
             case 'answer_ask_user': {
                 if (this.#phase !== 'awaiting_active_action')
@@ -206,7 +198,7 @@ export class QueueController {
                     this.#pendingAction.kind !== 'ask_user') {
                     return { kind: 'rejected', reason: 'stale' };
                 }
-                return this.#resolveAction(cmd);
+                return this.#resolveAction();
             }
             case 'resume_queue':
                 if (this.#phase !== 'paused')
@@ -252,6 +244,39 @@ export class QueueController {
                 return { kind: 'accepted' };
         }
     }
+    async #submit(cmd) {
+        if (!cmd.text.trim())
+            return { kind: 'rejected', reason: 'invalid' };
+        if (this.#queue.length >= this.#capacity)
+            return { kind: 'rejected', reason: 'capacity' };
+        const id = cmd.id ?? this.#itemId();
+        if (!isNonEmptyString(id) || this.#queue.some((item) => item.id === id) || this.#active?.item.id === id) {
+            return { kind: 'rejected', reason: 'invalid' };
+        }
+        const item = freeze({
+            id: id,
+            text: cmd.text,
+            sequence: this.#nextSequence++,
+            submittedAt: this.#now(),
+            ...(cmd.kind === 'steer' ? { steer: true } : {}),
+        });
+        if (cmd.kind === 'steer') {
+            // A steer that reaches the queue could not be delivered into the running
+            // turn, so it runs as its own turn — ahead of the follow-ups queued
+            // before it, which is the priority the user expressed by steering, and
+            // behind steers they sent earlier, which is the order they said it in.
+            const firstFollowUp = this.#queue.findIndex((queued) => !queued.steer);
+            const insertAt = firstFollowUp < 0 ? this.#queue.length : firstFollowUp;
+            this.#queue = [...this.#queue.slice(0, insertAt), item, ...this.#queue.slice(insertAt)].map((queued) => freeze({ ...queued, sequence: this.#nextSequence++ }));
+            await this.#persist();
+            await this.#dispatch();
+            return { kind: 'accepted' };
+        }
+        this.#queue.push(item);
+        await this.#persist();
+        await this.#dispatch();
+        return { kind: 'accepted' };
+    }
     async event(event) {
         if (event.kind === 'tool_approval_requested' || event.kind === 'ask_user_requested') {
             if (!this.#active || this.#active.executionId !== event.executionId || this.#phase !== 'running')
@@ -272,9 +297,8 @@ export class QueueController {
         if (event.kind === 'failed') {
             this.#active = undefined;
             this.#pendingAction = undefined;
-            // Invariant: a paused queue must contain retained work. If the failure
-            // leaves no queued items behind, there is nothing to retain and the
-            // controller returns to idle instead of pausing with an empty queue.
+            // Failure policy: do not auto-advance. Pause with retained work so the
+            // user can resume or discard; only return to idle when nothing remains.
             if (this.#queue.length === 0) {
                 this.#phase = 'idle';
                 this.#pauseReason = undefined;
@@ -299,24 +323,10 @@ export class QueueController {
         await this.#persist();
         await this.#dispatch();
     }
-    async #resolveAction(cmd) {
-        const execution = this.#active;
-        const pendingAction = this.#pendingAction;
+    async #resolveAction() {
         this.#phase = 'running';
         this.#pendingAction = undefined;
         await this.#persist();
-        if (this.#driver.continueAfterAction) {
-            const resolution = 'approved' in cmd ? { approved: cmd.approved } : { value: cmd.value };
-            try {
-                await this.#driver.continueAfterAction(execution, pendingAction, resolution);
-            }
-            catch {
-                this.#active = undefined;
-                this.#phase = 'paused';
-                this.#pauseReason = 'failure';
-                await this.#persist();
-            }
-        }
         return { kind: 'accepted' };
     }
     async #acceptPreflight() {
@@ -329,16 +339,9 @@ export class QueueController {
         this.#active = active;
         this.#phase = 'running';
         await this.#persist();
-        try {
-            await this.#driver.start(active);
-        }
-        catch {
-            this.#queue.unshift(item);
-            this.#active = undefined;
-            this.#phase = 'paused';
-            this.#pauseReason = 'failure';
-            await this.#persist();
-        }
+        // Driver failure is handled by the 'failed' event handler (line ~473), not by
+        // synchronous exceptions here. The driver returns void and kicks off async work.
+        await this.#driver.start(active);
         return { kind: 'accepted' };
     }
     async #cancel() {
@@ -354,6 +357,12 @@ export class QueueController {
             return { kind: 'no_op' };
         }
         const active = this.#active;
+        // Capture how much work was already queued when the user stopped. A manual
+        // pause exists only to retain that pre-existing work; items submitted
+        // after the stop (including ones raced in while cancel cleanup awaits the
+        // active turn) reflect fresh intent and must run, not stick behind an
+        // empty pause with nothing to resume.
+        const retainedQueueLength = this.#queue.length;
         this.#phase = 'cancelling';
         this.#pendingAction = undefined;
         await this.#persist();
@@ -363,9 +372,23 @@ export class QueueController {
         finally {
             if (this.#active?.executionId === active.executionId) {
                 this.#active = undefined;
-                this.#phase = 'paused';
-                this.#pauseReason = 'manual';
+                // Invariant: a paused queue must contain retained work. When nothing
+                // was queued at stop time, return to idle so the next submission
+                // starts immediately instead of being queued behind a manual pause
+                // with nothing to resume. A submission raced in during cleanup is
+                // dispatched below.
+                if (retainedQueueLength === 0) {
+                    this.#phase = 'idle';
+                    this.#pauseReason = undefined;
+                }
+                else {
+                    this.#phase = 'paused';
+                    this.#pauseReason = 'manual';
+                }
                 await this.#persist();
+                if (retainedQueueLength === 0) {
+                    await this.#dispatch();
+                }
             }
         }
         return { kind: 'accepted' };
@@ -396,16 +419,9 @@ export class QueueController {
         this.#active = active;
         this.#phase = 'running';
         await this.#persist();
-        try {
-            await this.#driver.start(active);
-        }
-        catch {
-            this.#queue.unshift(item);
-            this.#active = undefined;
-            this.#phase = 'paused';
-            this.#pauseReason = 'failure';
-            await this.#persist();
-        }
+        // Driver failure is handled by the 'failed' event handler (line ~473), not by
+        // synchronous exceptions here. The driver returns void and kicks off async work.
+        await this.#driver.start(active);
     }
     #restore() {
         if (!this.#persistence)
@@ -486,8 +502,10 @@ export class QueueController {
             ...(this.#phase === 'paused' ? { pause: { reason: this.#pauseReason } } : {}),
             ...(active ? { active } : {}),
         };
+        const write = this.#persistenceWrites.then(() => this.#persistence.replace(record));
+        this.#persistenceWrites = write.then(() => undefined, () => undefined);
         try {
-            await this.#persistence.replace(record);
+            await write;
         }
         catch (error) {
             this.#recovery = { kind: 'persistence_failed', detail: error instanceof Error ? error.message : String(error) };