@qduc/term2 0.11.1 → 0.12.0

package/dist/services/models/model-catalog-session.js

@@ -0,0 +1,70 @@
+import { clearModelCache, fetchModels } from '../model-service.js';
+import { getProviderIds, sortProvidersByOrder } from '../../providers/index.js';
+/** Owns model-catalog traversal, per-open caching, failed-provider suppression, and stale loads. */
+export class ModelCatalogSession {
+    #settingsService;
+    #loggingService;
+    #fetcher;
+    #modelsByProvider = new Map();
+    #failedProviders = new Set();
+    #requestId = 0;
+    constructor(deps) {
+        this.#settingsService = deps.settingsService;
+        this.#loggingService = deps.loggingService;
+        this.#fetcher = deps.fetcher ?? ((provider) => fetchModels(deps, provider));
+    }
+    getCached(provider) {
+        return this.#modelsByProvider.get(provider);
+    }
+    async load(provider) {
+        const cached = this.#modelsByProvider.get(provider);
+        if (cached)
+            return { kind: 'cached', models: cached };
+        const requestId = ++this.#requestId;
+        try {
+            const models = await this.#fetcher(provider);
+            if (requestId !== this.#requestId)
+                return { kind: 'stale', models: [] };
+            this.#modelsByProvider.set(provider, models);
+            return { kind: 'loaded', models };
+        }
+        catch (error) {
+            if (requestId !== this.#requestId)
+                return { kind: 'stale', models: [] };
+            this.#failedProviders.add(provider);
+            const message = error instanceof Error ? error.message : String(error);
+            this.#loggingService.warn(`Model selection fetch failed for ${provider}`, { error: message });
+            throw error;
+        }
+    }
+    shouldRetry(provider, initialLoad) {
+        return initialLoad || !this.#failedProviders.has(provider);
+    }
+    begin() {
+        this.#requestId++;
+        this.#failedProviders.clear();
+    }
+    refresh(provider) {
+        this.#failedProviders.delete(provider);
+        this.#modelsByProvider.delete(provider);
+        ++this.#requestId;
+        clearModelCache(provider);
+    }
+    nextProvider(current, direction) {
+        const ids = getProviderIds();
+        const order = this.#settingsService.getDynamic('providerOrder') ?? [];
+        const ordered = order.length > 0 ? sortProvidersByOrder(ids, order) : ids;
+        if (ordered.length === 0)
+            return undefined;
+        const currentIndex = ordered.indexOf(current ?? '');
+        const safeIndex = currentIndex >= 0 ? currentIndex : 0;
+        const offset = direction === 'prev' ? -1 : 1;
+        return ordered[(safeIndex + offset + ordered.length) % ordered.length];
+    }
+    clear() {
+        this.#requestId++;
+        this.#modelsByProvider.clear();
+        this.#failedProviders.clear();
+    }
+}
+//# sourceMappingURL=model-catalog-session.js.map

package/dist/services/models/model-catalog-session.js.map

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

package/dist/services/openai-candidate-observer.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderRequestCapture, OpenAIRequestLifecycleObservation } from '../providers/provider-request-capture.js';
+import type { ProviderContinuity } from './provider-continuity.js';
+import type { OpenAIRootCheckpointLifecycleObserver } from './openai-root-checkpoint-lifecycle-observer.js';
+import type { OpenAIRootProviderIdentity } from './openai-root-provider-identity.js';
+/**
+ * Session-owned, fail-closed bridge from the OpenAI private lifecycle seam to
+ * the continuity candidate lifecycle. Promotion remains SessionStreamProcessor's
+ * responsibility after the authoritative history commit.
+ */
+export declare class OpenAICandidateObserver implements ProviderRequestCapture {
+    private readonly continuity;
+    private readonly lifecycleObserver?;
+    private readonly rootProviderIdentity?;
+    constructor(continuity: ProviderContinuity, lifecycleObserver?: OpenAIRootCheckpointLifecycleObserver | undefined, rootProviderIdentity?: OpenAIRootProviderIdentity | undefined);
+    record(): void;
+    observe(observation: OpenAIRequestLifecycleObservation): void;
+}
+//# sourceMappingURL=openai-candidate-observer.d.ts.map

package/dist/services/openai-candidate-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-candidate-observer.d.ts","sourceRoot":"","sources":["../../source/services/openai-candidate-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAErF;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IAElE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAHxC,YACmB,UAAU,EAAE,kBAAkB,EAC9B,iBAAiB,CAAC,EAAE,qCAAqC,YAAA,EACzD,oBAAoB,CAAC,EAAE,0BAA0B,YAAA,EAChE;IAEJ,MAAM,IAAI,IAAI,CAEb;IAED,OAAO,CAAC,WAAW,EAAE,iCAAiC,GAAG,IAAI,CAkC5D;CACF"}

package/dist/services/openai-candidate-observer.js

@@ -0,0 +1,56 @@
+/**
+ * Session-owned, fail-closed bridge from the OpenAI private lifecycle seam to
+ * the continuity candidate lifecycle. Promotion remains SessionStreamProcessor's
+ * responsibility after the authoritative history commit.
+ */
+export class OpenAICandidateObserver {
+    continuity;
+    lifecycleObserver;
+    rootProviderIdentity;
+    constructor(continuity, lifecycleObserver, rootProviderIdentity) {
+        this.continuity = continuity;
+        this.lifecycleObserver = lifecycleObserver;
+        this.rootProviderIdentity = rootProviderIdentity;
+    }
+    record() {
+        // Candidate observation intentionally ignores request-projection telemetry.
+    }
+    observe(observation) {
+        if (observation.phase !== 'terminal')
+            return;
+        if (!observation.prefixBinding) {
+            this.lifecycleObserver?.candidate(observation.prefixBindingOutcome ?? 'missing_prefix_binding');
+            return;
+        }
+        if (!observation.responseId) {
+            this.lifecycleObserver?.candidate('missing_response_id');
+            return;
+        }
+        if (typeof observation.prefixBinding.lineage !== 'number') {
+            this.lifecycleObserver?.candidate('invalid_lineage');
+            return;
+        }
+        try {
+            const identity = {
+                provider: observation.provider,
+                endpoint: observation.endpoint,
+                model: observation.model,
+            };
+            this.rootProviderIdentity?.observe(identity);
+            const observed = this.continuity.observeCandidate({
+                identity,
+                prefix: {
+                    identity: observation.prefixBinding.snapshotIdentity,
+                    revision: observation.prefixBinding.snapshotRevision,
+                },
+                lineage: observation.prefixBinding.lineage,
+                responseId: observation.responseId,
+            });
+            this.lifecycleObserver?.candidate(observed ? 'observed' : 'lineage_rejected');
+        }
+        catch {
+            // Provider observation must never alter a request or terminal stream.
+        }
+    }
+}
+//# sourceMappingURL=openai-candidate-observer.js.map

package/dist/services/openai-candidate-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-candidate-observer.js","sourceRoot":"","sources":["../../source/services/openai-candidate-observer.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAEf,UAAU;IACV,iBAAiB;IACjB,oBAAoB;IAHvC,YACmB,UAA8B,EAC9B,iBAAyD,EACzD,oBAAiD;0BAFjD,UAAU;iCACV,iBAAiB;oCACjB,oBAAoB;IACpC,CAAC;IAEJ,MAAM;QACJ,4EAA4E;IAC9E,CAAC;IAED,OAAO,CAAC,WAA8C;QACpD,IAAI,WAAW,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO;QAC7C,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAC/B,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,WAAW,CAAC,oBAAoB,IAAI,wBAAwB,CAAC,CAAC;YAChG,OAAO;QACT,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,qBAAqB,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,WAAW,CAAC,aAAa,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1D,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG;gBACf,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;aACzB,CAAC;YACF,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;gBAChD,QAAQ;gBACR,MAAM,EAAE;oBACN,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,gBAAgB;oBACpD,QAAQ,EAAE,WAAW,CAAC,aAAa,CAAC,gBAAgB;iBACrD;gBACD,OAAO,EAAE,WAAW,CAAC,aAAa,CAAC,OAAO;gBAC1C,UAAU,EAAE,WAAW,CAAC,UAAU;aACnC,CAAC,CAAC;YACH,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC;CACF"}

package/dist/services/openai-root-checkpoint-lifecycle-observer.d.ts

@@ -0,0 +1,20 @@
+/** Sanitized, durable evidence for the OpenAI root checkpoint lifecycle. */
+export type OpenAIRootCheckpointLifecycleEvidence = {
+    type: 'openai_root_checkpoint_lifecycle';
+    version: 1;
+    stage: 'candidate' | 'publication';
+    outcome: 'observed' | 'missing_prefix_binding' | 'not_prepared' | 'already_consumed' | 'input_mismatch' | 'missing_response_id' | 'invalid_lineage' | 'lineage_rejected' | 'promoted' | 'history_not_committed' | 'candidate_not_promoted';
+};
+/** Root-owned OpenAI diagnostics only; it retains no provider or request data. */
+export interface OpenAIRootCheckpointLifecycleObserver {
+    setEvidenceRecorder?(recorder: (evidence: OpenAIRootCheckpointLifecycleEvidence) => void): void;
+    candidate(outcome: Extract<OpenAIRootCheckpointLifecycleEvidence['outcome'], 'observed' | 'missing_prefix_binding' | 'missing_response_id' | 'invalid_lineage' | 'lineage_rejected' | 'not_prepared' | 'already_consumed' | 'input_mismatch'>): void;
+    publication(outcome: Extract<OpenAIRootCheckpointLifecycleEvidence['outcome'], 'promoted' | 'history_not_committed' | 'candidate_not_promoted'>): void;
+}
+export declare class DefaultOpenAIRootCheckpointLifecycleObserver implements OpenAIRootCheckpointLifecycleObserver {
+    #private;
+    setEvidenceRecorder(recorder: (evidence: OpenAIRootCheckpointLifecycleEvidence) => void): void;
+    candidate(outcome: Parameters<OpenAIRootCheckpointLifecycleObserver['candidate']>[0]): void;
+    publication(outcome: Parameters<OpenAIRootCheckpointLifecycleObserver['publication']>[0]): void;
+}
+//# sourceMappingURL=openai-root-checkpoint-lifecycle-observer.d.ts.map

package/dist/services/openai-root-checkpoint-lifecycle-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-checkpoint-lifecycle-observer.d.ts","sourceRoot":"","sources":["../../source/services/openai-root-checkpoint-lifecycle-observer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;IACnC,OAAO,EACH,UAAU,GACV,wBAAwB,GACxB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,uBAAuB,GACvB,wBAAwB,CAAC;CAC9B,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,qCAAqC,KAAK,IAAI,GAAG,IAAI,CAAC;IAChG,SAAS,CACP,OAAO,EAAE,OAAO,CACd,qCAAqC,CAAC,SAAS,CAAC,EAC9C,UAAU,GACV,wBAAwB,GACxB,qBAAqB,GACrB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,CACnB,GACA,IAAI,CAAC;IACR,WAAW,CACT,OAAO,EAAE,OAAO,CACd,qCAAqC,CAAC,SAAS,CAAC,EAChD,UAAU,GAAG,uBAAuB,GAAG,wBAAwB,CAChE,GACA,IAAI,CAAC;CACT;AAED,qBAAa,4CAA6C,YAAW,qCAAqC;;IAGxG,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,qCAAqC,KAAK,IAAI,GAAG,IAAI,CAE7F;IAED,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,qCAAqC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE1F;IAED,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,qCAAqC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAE9F;CAYF"}

package/dist/services/openai-root-checkpoint-lifecycle-observer.js

@@ -0,0 +1,21 @@
+export class DefaultOpenAIRootCheckpointLifecycleObserver {
+    #recordEvidence = () => { };
+    setEvidenceRecorder(recorder) {
+        this.#recordEvidence = recorder;
+    }
+    candidate(outcome) {
+        this.#record('candidate', outcome);
+    }
+    publication(outcome) {
+        this.#record('publication', outcome);
+    }
+    #record(stage, outcome) {
+        try {
+            this.#recordEvidence(Object.freeze({ type: 'openai_root_checkpoint_lifecycle', version: 1, stage, outcome }));
+        }
+        catch {
+            // Diagnostics must never affect the existing provider or stream path.
+        }
+    }
+}
+//# sourceMappingURL=openai-root-checkpoint-lifecycle-observer.js.map

package/dist/services/openai-root-checkpoint-lifecycle-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-checkpoint-lifecycle-observer.js","sourceRoot":"","sources":["../../source/services/openai-root-checkpoint-lifecycle-observer.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,4CAA4C;IACvD,eAAe,GAA8D,GAAG,EAAE,GAAE,CAAC,CAAC;IAEtF,mBAAmB,CAAC,QAAmE;QACrF,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,OAA0E;QAClF,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,WAAW,CAAC,OAA4E;QACtF,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CACL,KAAqD,EACrD,OAAyD;QAEzD,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAChH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC;CACF"}

package/dist/services/openai-root-provider-identity.d.ts

@@ -0,0 +1,11 @@
+import type { ProviderCheckpointIdentity } from './provider-continuity.js';
+/**
+ * Root-owned, resolved OpenAI provider identity shared by lifecycle observation
+ * and selector-parity assessment. It contains no credentials or request data.
+ */
+export declare class OpenAIRootProviderIdentity {
+    #private;
+    get current(): Readonly<ProviderCheckpointIdentity> | null;
+    observe(identity: ProviderCheckpointIdentity): void;
+}
+//# sourceMappingURL=openai-root-provider-identity.d.ts.map

package/dist/services/openai-root-provider-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-provider-identity.d.ts","sourceRoot":"","sources":["../../source/services/openai-root-provider-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,0BAA0B;;IAGrC,IAAI,OAAO,IAAI,QAAQ,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAEzD;IAED,OAAO,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAGlD;CACF"}

package/dist/services/openai-root-provider-identity.js

@@ -0,0 +1,16 @@
+/**
+ * Root-owned, resolved OpenAI provider identity shared by lifecycle observation
+ * and selector-parity assessment. It contains no credentials or request data.
+ */
+export class OpenAIRootProviderIdentity {
+    #identity = null;
+    get current() {
+        return this.#identity;
+    }
+    observe(identity) {
+        if (!identity.provider || !identity.endpoint || !identity.model)
+            return;
+        this.#identity = Object.freeze({ ...identity });
+    }
+}
+//# sourceMappingURL=openai-root-provider-identity.js.map

package/dist/services/openai-root-provider-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-provider-identity.js","sourceRoot":"","sources":["../../source/services/openai-root-provider-identity.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IACrC,SAAS,GAAgD,IAAI,CAAC;IAE9D,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,QAAoC;QAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK;YAAE,OAAO;QACxE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/services/openai-root-selector-parity-observer.d.ts

@@ -0,0 +1,53 @@
+import type { ProviderHistorySnapshot } from './conversation/conversation-store.js';
+import type { ProviderCheckpointIdentity, ProviderContinuity, ProviderSuccessorEligibilityFailure } from './provider-continuity.js';
+export type OpenAIRootSelectorParityFailure = ProviderSuccessorEligibilityFailure | 'model_unavailable' | 'identity_unavailable';
+/** Read-only evidence from a normal owned-root OpenAI turn, never a selector. */
+export type OpenAIRootFreshTurnSelectorParityObservation = {
+    eligible: boolean;
+    legacyPreviousResponseId: string;
+    acceptedCheckpointResponseId: string | null;
+    matches: boolean;
+};
+/**
+ * The durable diagnostic shape intentionally excludes response IDs and all
+ * request/transcript data. It is evidence for a later review, never selector
+ * input or continuity state.
+ */
+export type OpenAIRootFreshTurnSelectorParityEvidence = {
+    type: 'openai_root_selector_parity';
+    version: 2;
+    eligible: boolean;
+    matches: boolean;
+    /** Present only for an ineligible observation; a fixed diagnostic enum. */
+    failure?: OpenAIRootSelectorParityFailure;
+};
+export interface OpenAIRootFreshTurnSelectorParityObserver {
+    /** Most recent bounded observation; no transcript or request metadata is retained. */
+    readonly latestObservation: Readonly<OpenAIRootFreshTurnSelectorParityObservation> | null;
+    setEvidenceRecorder?(recorder: (evidence: OpenAIRootFreshTurnSelectorParityEvidence) => void): void;
+    /**
+     * Computes parity for this exact request snapshot. Callers may use the
+     * returned observation immediately, but must retain legacy selection unless
+     * the accepted checkpoint is both eligible and equal to the legacy ID.
+     */
+    observe(input: {
+        legacyPreviousResponseId: string;
+        plannedSnapshot: ProviderHistorySnapshot;
+    }): Readonly<OpenAIRootFreshTurnSelectorParityObservation>;
+}
+/** Owned-root-only, fail-closed checkpoint/legacy parity observation. */
+export declare class ProviderContinuityOpenAIRootSelectorParityObserver implements OpenAIRootFreshTurnSelectorParityObserver {
+    #private;
+    private readonly continuity;
+    private readonly getModel;
+    private recordEvidence;
+    private readonly getResolvedIdentity;
+    constructor(continuity: ProviderContinuity, getModel: () => string | undefined, recordEvidence?: (evidence: OpenAIRootFreshTurnSelectorParityEvidence) => void, getResolvedIdentity?: () => Readonly<ProviderCheckpointIdentity> | null);
+    get latestObservation(): Readonly<OpenAIRootFreshTurnSelectorParityObservation> | null;
+    setEvidenceRecorder(recorder: (evidence: OpenAIRootFreshTurnSelectorParityEvidence) => void): void;
+    observe({ legacyPreviousResponseId, plannedSnapshot, }: {
+        legacyPreviousResponseId: string;
+        plannedSnapshot: ProviderHistorySnapshot;
+    }): Readonly<OpenAIRootFreshTurnSelectorParityObservation>;
+}
+//# sourceMappingURL=openai-root-selector-parity-observer.d.ts.map

package/dist/services/openai-root-selector-parity-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-selector-parity-observer.d.ts","sourceRoot":"","sources":["../../source/services/openai-root-selector-parity-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,mCAAmC,EACpC,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,+BAA+B,GACvC,mCAAmC,GACnC,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B,iFAAiF;AACjF,MAAM,MAAM,4CAA4C,GAAG;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;IACjC,4BAA4B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG;IACtD,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,+BAA+B,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,yCAAyC;IACxD,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,4CAA4C,CAAC,GAAG,IAAI,CAAC;IAC1F,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,yCAAyC,KAAK,IAAI,GAAG,IAAI,CAAC;IACpG;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE;QACb,wBAAwB,EAAE,MAAM,CAAC;QACjC,eAAe,EAAE,uBAAuB,CAAC;KAC1C,GAAG,QAAQ,CAAC,4CAA4C,CAAC,CAAC;CAC5D;AAED,yEAAyE;AACzE,qBAAa,kDAAmD,YAAW,yCAAyC;;IAIhH,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAJtC,YACmB,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,EAC3C,cAAc,GAAE,CAAC,QAAQ,EAAE,yCAAyC,KAAK,IAAe,EAC/E,mBAAmB,GAAE,MAAM,QAAQ,CAAC,0BAA0B,CAAC,GAAG,IAAiB,EAClG;IAEJ,IAAI,iBAAiB,IAAI,QAAQ,CAAC,4CAA4C,CAAC,GAAG,IAAI,CAErF;IAED,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,yCAAyC,KAAK,IAAI,GAAG,IAAI,CAEjG;IAED,OAAO,CAAC,EACN,wBAAwB,EACxB,eAAe,GAChB,EAAE;QACD,wBAAwB,EAAE,MAAM,CAAC;QACjC,eAAe,EAAE,uBAAuB,CAAC;KAC1C,GAAG,QAAQ,CAAC,4CAA4C,CAAC,CA+CzD;CACF"}

package/dist/services/openai-root-selector-parity-observer.js

@@ -0,0 +1,62 @@
+/** Owned-root-only, fail-closed checkpoint/legacy parity observation. */
+export class ProviderContinuityOpenAIRootSelectorParityObserver {
+    continuity;
+    getModel;
+    recordEvidence;
+    getResolvedIdentity;
+    #latestObservation = null;
+    constructor(continuity, getModel, recordEvidence = () => { }, getResolvedIdentity = () => null) {
+        this.continuity = continuity;
+        this.getModel = getModel;
+        this.recordEvidence = recordEvidence;
+        this.getResolvedIdentity = getResolvedIdentity;
+    }
+    get latestObservation() {
+        return this.#latestObservation;
+    }
+    setEvidenceRecorder(recorder) {
+        this.recordEvidence = recorder;
+    }
+    observe({ legacyPreviousResponseId, plannedSnapshot, }) {
+        try {
+            const model = this.getModel();
+            const resolvedIdentity = this.getResolvedIdentity();
+            const checkpoint = this.continuity.checkpoint;
+            const acceptedCheckpointResponseId = checkpoint?.state === 'accepted' ? checkpoint.responseId : null;
+            const assessment = typeof model === 'string' && model.length > 0 && resolvedIdentity
+                ? this.continuity.assessSuccessorEligibility({ ...resolvedIdentity, model }, this.continuity.lineage, plannedSnapshot)
+                : {
+                    eligible: false,
+                    failure: typeof model === 'string' && model.length > 0
+                        ? 'identity_unavailable'
+                        : 'model_unavailable',
+                };
+            const eligible = assessment.eligible;
+            const observation = Object.freeze({
+                eligible,
+                legacyPreviousResponseId,
+                acceptedCheckpointResponseId,
+                matches: eligible && acceptedCheckpointResponseId === legacyPreviousResponseId,
+            });
+            this.#latestObservation = observation;
+            this.recordEvidence(Object.freeze({
+                type: 'openai_root_selector_parity',
+                version: 2,
+                eligible,
+                matches: observation.matches,
+                ...(!eligible ? { failure: assessment.failure } : {}),
+            }));
+            return observation;
+        }
+        catch {
+            // Observation must never affect an established request.
+            return Object.freeze({
+                eligible: false,
+                legacyPreviousResponseId,
+                acceptedCheckpointResponseId: null,
+                matches: false,
+            });
+        }
+    }
+}
+//# sourceMappingURL=openai-root-selector-parity-observer.js.map

package/dist/services/openai-root-selector-parity-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-root-selector-parity-observer.js","sourceRoot":"","sources":["../../source/services/openai-root-selector-parity-observer.ts"],"names":[],"mappings":"AAiDA,yEAAyE;AACzE,MAAM,OAAO,kDAAkD;IAI1C,UAAU;IACV,QAAQ;IACjB,cAAc;IACL,mBAAmB;IANtC,kBAAkB,GAAkE,IAAI,CAAC;IAEzF,YACmB,UAA8B,EAC9B,QAAkC,EAC3C,cAAc,GAAkE,GAAG,EAAE,GAAE,CAAC,EAC/E,mBAAmB,GAAsD,GAAG,EAAE,CAAC,IAAI;0BAHnF,UAAU;wBACV,QAAQ;8BACjB,cAAc;mCACL,mBAAmB;IACnC,CAAC;IAEJ,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,mBAAmB,CAAC,QAAuE;QACzF,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,EACN,wBAAwB,EACxB,eAAe,GAIhB;QACC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC9C,MAAM,4BAA4B,GAAG,UAAU,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YACrG,MAAM,UAAU,GACd,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB;gBAC/D,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,0BAA0B,CACxC,EAAE,GAAG,gBAAgB,EAAE,KAAK,EAAE,EAC9B,IAAI,CAAC,UAAU,CAAC,OAAO,EACvB,eAAe,CAChB;gBACH,CAAC,CAAC;oBACE,QAAQ,EAAE,KAAc;oBACxB,OAAO,EACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;wBAC3C,CAAC,CAAE,sBAAgC;wBACnC,CAAC,CAAE,mBAA6B;iBACrC,CAAC;YACR,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;YACrC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;gBAChC,QAAQ;gBACR,wBAAwB;gBACxB,4BAA4B;gBAC5B,OAAO,EAAE,QAAQ,IAAI,4BAA4B,KAAK,wBAAwB;aAC/E,CAAC,CAAC;YACH,IAAI,CAAC,kBAAkB,GAAG,WAAW,CAAC;YACtC,IAAI,CAAC,cAAc,CACjB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,6BAA6B;gBACnC,OAAO,EAAE,CAAC;gBACV,QAAQ;gBACR,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC,CACH,CAAC;YACF,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,QAAQ,EAAE,KAAK;gBACf,wBAAwB;gBACxB,4BAA4B,EAAE,IAAI;gBAClC,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/services/plan-mode-interceptor.js

@@ -1,7 +1,7 @@
 export const installPlanModeInterceptor = (agentClient, deps) => {
     // Subagent roles that cannot mutate the workspace (canWrite: false). The
     // `worker` role (and any future write-capable/custom role) is blocked.
-    const READ_ONLY_SUBAGENT_ROLES = new Set(['explorer', 'researcher', 'mentor', 'librarian']);
+    const READ_ONLY_SUBAGENT_ROLES = new Set(['explorer', 'mentor', 'librarian']);
     const extractRole = (params) => {
         let obj = params;
         if (typeof obj === 'string') {
@@ -28,7 +28,7 @@ export const installPlanModeInterceptor = (agentClient, deps) => {
             // Allow only read-only subagent roles; block worker and unknown roles
             // (an unknown role could be a write-capable custom subagent).
             if (!role || !READ_ONLY_SUBAGENT_ROLES.has(role)) {
-                return `Plan mode is active (read-only). The "${name}" tool is restricted to read-only roles (explorer, researcher, mentor) — the "${role ?? 'unknown'}" role is disabled. Use a read-only subagent to investigate, then present an ordered implementation plan. Tell the user to exit plan mode to execute it.`;
+                return `Plan mode is active (read-only). The "${name}" tool is restricted to read-only roles (explorer, mentor, librarian) — the "${role ?? 'unknown'}" role is disabled. Use a read-only subagent to investigate, then present an ordered implementation plan. Tell the user to exit plan mode to execute it.`;
             }
         }
         return null;

package/dist/services/plan-mode-interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan-mode-interceptor.js","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAqC,EACrC,IAA2C,EAC7B,EAAE;IAChB,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAE5F,MAAM,WAAW,GAAG,CAAC,MAAe,EAAsB,EAAE;QAC1D,IAAI,GAAG,GAAG,MAAM,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAI,GAAiC,EAAE,IAAI,CAAC;QACtD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,WAAW,GAAoB,KAAK,EAAE,IAAY,EAAE,MAAe,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAU,cAAc,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,yCAAyC,IAAI,wLAAwL,CAAC;QAC/O,CAAC;QAED,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,sEAAsE;YACtE,8DAA8D;YAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,OAAO,yCAAyC,IAAI,iFAClD,IAAI,IAAI,SACV,0JAA0J,CAAC;YAC7J,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC,CAAC"}
+{"version":3,"file":"plan-mode-interceptor.js","sourceRoot":"","sources":["../../source/services/plan-mode-interceptor.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,WAAqC,EACrC,IAA2C,EAC7B,EAAE;IAChB,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,MAAM,WAAW,GAAG,CAAC,MAAe,EAAsB,EAAE;QAC1D,IAAI,GAAG,GAAG,MAAM,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAI,GAAiC,EAAE,IAAI,CAAC;QACtD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,WAAW,GAAoB,KAAK,EAAE,IAAY,EAAE,MAAe,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,yCAAyC,IAAI,wLAAwL,CAAC;QAC/O,CAAC;QAED,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,sEAAsE;YACtE,8DAA8D;YAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,OAAO,yCAAyC,IAAI,gFAClD,IAAI,IAAI,SACV,0JAA0J,CAAC;YAC7J,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/services/provider-continuity.d.ts

@@ -1,3 +1,46 @@
+export type ProviderCheckpointIdentity = {
+    provider: string;
+    endpoint: string;
+    model: string;
+};
+export type ProviderCheckpointPrefix = {
+    revision: number;
+    identity: string;
+};
+export type ProviderCheckpointBinding = {
+    identity: ProviderCheckpointIdentity;
+    prefix: ProviderCheckpointPrefix;
+};
+export type ProviderCheckpointRetirement = {
+    code: 'reset' | 'superseded' | 'chaining_broken' | 'identity_mismatch' | 'prefix_mismatch';
+};
+export type ProviderCheckpointSuccessorProof = {
+    revision: number;
+    identity: string;
+    origin?: string;
+    history: readonly unknown[];
+};
+/** Fixed, non-sensitive explanation for why future-selector evidence is unavailable. */
+export type ProviderSuccessorEligibilityFailure = 'no_accepted_checkpoint' | 'missing_successor_proof' | 'lineage_mismatch' | 'invalid_planned_snapshot' | 'identity_mismatch' | 'origin_mismatch' | 'revision_not_advanced' | 'history_not_extended' | 'history_prefix_mismatch';
+export type ProviderSuccessorEligibility = {
+    eligible: true;
+} | {
+    eligible: false;
+    failure: ProviderSuccessorEligibilityFailure;
+};
+export type ProviderCheckpoint = ProviderCheckpointBinding & {
+    state: 'candidate' | 'accepted' | 'retired';
+    lineage: number;
+    responseId: string;
+    opaqueState?: unknown;
+    /**
+     * Immutable authoritative history captured immediately after the response was
+     * committed. It is evidence for a future provider-private selector only; it
+     * does not affect existing response-ID publication or wire selection.
+     */
+    successorProof?: ProviderCheckpointSuccessorProof;
+    retirement?: ProviderCheckpointRetirement;
+};
 /**
  * Owns provider-side response chaining state: previousResponseId and
  * whether chaining has been broken (e.g. by transport downgrade).
@@ -9,7 +52,43 @@ export declare class ProviderContinuity {
     #private;
     get previousResponseId(): string | null;
     get chainingBroken(): boolean;
+    get checkpoint(): ProviderCheckpoint | null;
+    get lineage(): number;
+    get retiredCheckpoints(): readonly ProviderCheckpoint[];
+    /**
+     * 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: ProviderCheckpointBinding & {
+        responseId: string;
+        opaqueState?: unknown;
+        lineage?: number;
+    }): boolean;
+    /**
+     * Accepts only the candidate for this exact terminal response and binding.
+     * Call this in the same current-generation callback that committed history.
+     */
+    promoteCandidate(responseId: string | null, binding?: ProviderCheckpointBinding): boolean;
     update(responseId: string | null): void;
+    /**
+     * 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: string | null, historyCommitted: boolean, postCommitSnapshot?: ProviderCheckpointSuccessorProof): boolean;
+    /**
+     * 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: ProviderCheckpointIdentity, lineage: number, plannedSnapshot: ProviderCheckpointSuccessorProof): boolean;
+    /**
+     * Read-only, fail-closed eligibility assessment for bounded diagnostics.
+     * Its fixed failure enum contains no provider IDs, history, or request data.
+     */
+    assessSuccessorEligibility(identity: ProviderCheckpointIdentity, lineage: number, plannedSnapshot: ProviderCheckpointSuccessorProof): ProviderSuccessorEligibility;
     clear(): void;
     breakChaining(): void;
     isChainingAvailable(historyLength?: number): boolean;

package/dist/services/provider-continuity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-continuity.d.ts","sourceRoot":"","sources":["../../source/services/provider-continuity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,kBAAkB;;IAI7B,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEtC;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,aAAa,IAAI,IAAI,CAGpB;IAED,mBAAmB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAEnD;CACF"}
+{"version":3,"file":"provider-continuity.d.ts","sourceRoot":"","sources":["../../source/services/provider-continuity.ts"],"names":[],"mappings":"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"}