@qduc/term2 0.11.1 → 0.13.0

package/dist/services/model-service.js

@@ -1,5 +1,6 @@
 import { scoreSubsequence } from '../utils/subsequence-filter.js';
 import { getProvider } from '../providers/index.js';
+import { getModelContextWindow } from '../providers/model-catalog/catalog.js';
 const cache = new Map();
 export async function fetchModels(deps, providerOverride, fetchImpl = fetch) {
     const { settingsService, loggingService } = deps;
@@ -13,10 +14,11 @@ export async function fetchModels(deps, providerOverride, fetchImpl = fetch) {
         if (!providerDef) {
             throw new Error(`Provider '${provider}' is not registered`);
         }
-        const rawModels = await providerDef.fetchModels({ settingsService, loggingService }, fetchImpl);
+        const rawModels = await providerDef.fetchModels({ settingsService, loggingService, signal: deps.signal }, fetchImpl);
         const models = rawModels.map((m) => ({
             ...m,
             provider,
+            contextWindow: getModelContextWindow(provider, m.id),
         }));
         cache.set(cacheKey, models);
         return models;
@@ -55,6 +57,27 @@ export function getModelDefaultReasoningLevel(provider, modelId) {
     const model = models.find((m) => m.id === modelId);
     return model?.default_reasoning_level;
 }
+// Providers that reason only when the request explicitly asks them to, and that
+// expose no `default_reasoning_level` in their /models response for
+// getModelDefaultReasoningLevel() to read. Keyed by lowercased provider id, so a
+// custom provider entry named 'Neuralwatt' or 'neuralwatt' both match.
+//
+// Neuralwatt: verified against api.neuralwatt.com — a bare deepseek-v4-flash
+// request returns message keys ['role','content','function_call'] and stream
+// deltas ['content','role'], with no reasoning anywhere. Adding
+// reasoning_effort makes the model emit a `reasoning` field (note: `reasoning`,
+// not `reasoning_content`) on both the message and the deltas.
+const PROVIDER_DEFAULT_REASONING_LEVEL = {
+    neuralwatt: 'high',
+};
+/**
+ * Effort to use for a provider when the user's `agent.reasoningEffort` is
+ * 'default'. 'default' otherwise means "send no reasoning_effort and let the
+ * API choose", which for these providers means no reasoning at all.
+ */
+export function getProviderDefaultReasoningLevel(provider) {
+    return PROVIDER_DEFAULT_REASONING_LEVEL[provider.toLowerCase()];
+}
 export function filterModels(models, query) {
     const trimmed = query.trim();
     if (!trimmed) {

package/dist/services/model-service.js.map

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

package/dist/services/models/model-catalog-session.d.ts

@@ -0,0 +1,26 @@
+import { type ModelInfo } from '../model-service.js';
+import type { ILoggingService, ISettingsService } from '../service-interfaces.js';
+type ModelFetcher = (provider: string) => Promise<ModelInfo[]>;
+/** Owns model-catalog traversal, per-open caching, failed-provider suppression, and stale loads. */
+export declare class ModelCatalogSession {
+    #private;
+    constructor(deps: {
+        settingsService: ISettingsService;
+        loggingService: ILoggingService;
+        fetcher?: ModelFetcher;
+    });
+    getCached(provider: string): ModelInfo[] | undefined;
+    load(provider: string): Promise<{
+        kind: 'loaded' | 'cached' | 'stale';
+        models: ModelInfo[];
+    }>;
+    shouldRetry(provider: string, initialLoad: boolean): boolean;
+    begin(): void;
+    refresh(provider: string): void;
+    /** Invalidate provider state when its credential/readiness boundary changes. */
+    invalidate(provider: string): void;
+    nextProvider(current: string | null, direction: 'next' | 'prev'): string | undefined;
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=model-catalog-session.d.ts.map

package/dist/services/models/model-catalog-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog-session.d.ts","sourceRoot":"","sources":["../../../source/services/models/model-catalog-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,KAAK,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;AAE/D,oGAAoG;AACpG,qBAAa,mBAAmB;;IAQ9B,YAAY,IAAI,EAAE;QAAE,eAAe,EAAE,gBAAgB,CAAC;QAAC,cAAc,EAAE,eAAe,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE,EAI/G;IAED,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,CAEnD;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC,CAgBlG;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAE3D;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE9B;IAED,gFAAgF;IAChF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKjC;IAED,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnF;IAED,KAAK,IAAI,IAAI,CAIZ;CACF"}

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

@@ -0,0 +1,77 @@
+import { clearModelCache, fetchModels } from '../model-service.js';
+import { getProviderIds, sortProvidersByOrder } from '../../providers/index.js';
+import { getAvailableProviderIds } from '../../utils/ai/provider-credentials.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.invalidate(provider);
+    }
+    /** Invalidate provider state when its credential/readiness boundary changes. */
+    invalidate(provider) {
+        this.#failedProviders.delete(provider);
+        this.#modelsByProvider.delete(provider);
+        ++this.#requestId;
+        clearModelCache(provider);
+    }
+    nextProvider(current, direction) {
+        const ids = getAvailableProviderIds(this.#settingsService, 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 ?? '');
+        if (currentIndex < 0)
+            return direction === 'prev' ? ordered.at(-1) : ordered[0];
+        const safeIndex = currentIndex;
+        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,15 +1,109 @@
+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).
  *
  * This is the single source of truth for provider continuity. All other
  * collaborators read from this object rather than storing their own copy.
+ *
+ * ## Chain settlement
+ *
+ * When a published response issued function calls, the next request must
+ * supply matching tool outputs or the chain must be dropped. Outstanding
+ * call ids are the local record of that unpaid server debt. Clear them only
+ * when a later terminal response replaces them, or when continuity is reset.
  */
 export declare class ProviderContinuity {
     #private;
     get previousResponseId(): string | null;
     get chainingBroken(): boolean;
+    get checkpoint(): ProviderCheckpoint | null;
+    get lineage(): number;
+    get retiredCheckpoints(): readonly ProviderCheckpoint[];
+    /** Call ids the current chain still needs tool outputs for. */
+    get outstandingToolCallIds(): readonly string[];
+    hasOutstandingToolDebt(): boolean;
+    /**
+     * Replace the unpaid tool-call set for the current chain. Pass an empty
+     * list when the latest terminal response left no open function calls.
+     */
+    replaceOutstandingToolCallIds(callIds: readonly string[]): void;
+    /**
+     * 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;