@gkorepanov/ccodex 0.4.9 → 0.4.10

package/dist/handoff/providerEpochs.d.ts

@@ -1,18 +1,32 @@
 import type { Thread } from "../codex/generated/v2/Thread.js";
 import type { Turn } from "../codex/generated/v2/Turn.js";
-import { HandoffStore, type LogicalThread, type NewLogicalTurn, type ProviderEpoch, type ProviderKind } from "./store.js";
+import { LineageStore, type EpochBoundary, type NewTranscriptSegment, type TranscriptSegment } from "./lineageStore.js";
+import { HandoffStore, type LogicalThread, type ProviderEpoch, type ProviderKind } from "./store.js";
 export interface ResolvedProviderEpoch {
     readonly logical: LogicalThread;
     readonly epoch: ProviderEpoch;
 }
+export interface LegacyProviderSnapshots {
+    readonly threads: ReadonlyMap<string, Thread>;
+    readonly epochs: ReadonlyMap<string, ProviderEpoch>;
+}
+export declare function stockSwitchThreadSource(jobId: string, source: string | null): string;
 export declare class ProviderEpochs {
-    private readonly store;
-    constructor(store: HandoffStore);
+    private readonly lineage;
+    private readonly legacyMirror?;
+    private readonly legacySnapshots?;
+    constructor(lineage: LineageStore, legacyMirror?: HandoffStore | undefined, legacySnapshots?: LegacyProviderSnapshots | undefined);
     resolve(publicThreadId: string): ResolvedProviderEpoch | undefined;
     publicId(provider: ProviderKind, backendThreadId: string): string | undefined;
     hiddenBackendIds(provider?: ProviderKind): Set<string>;
+    mappings(): EpochBoundary[];
+    segments(publicThreadId: string): TranscriptSegment[];
+    epoch(epochId: string): EpochBoundary | undefined;
+    configuredEpoch(epochId: string): ProviderEpoch | undefined;
+    belongs(publicThreadId: string, epochId: string): boolean;
     seed(thread: Thread, provider: ProviderKind, model: string, settings: Record<string, unknown>): ResolvedProviderEpoch;
+    createFork(thread: Thread, backendThreadId: string, provider: ProviderKind, model: string, settings: Record<string, unknown>, inheritedSegments: readonly NewTranscriptSegment[]): ResolvedProviderEpoch;
+    projectThread(publicThreadId: string, backend: Thread, includeTurns: boolean, historicalTurns?: readonly Turn[]): Thread;
+    /** Legacy-test helper; production history is assembled from provider segments. */
     visibleTurns(publicThreadId: string, currentBackendTurns: readonly Turn[]): Turn[];
-    snapshotTurns(publicThreadId: string, currentBackendTurns: readonly Turn[]): NewLogicalTurn[];
-    projectThread(publicThreadId: string, backend: Thread, includeTurns: boolean): Thread;
 }

package/dist/handoff/providerEpochs.js

@@ -1,65 +1,102 @@
 import { v7 as uuidv7 } from "uuid";
-function providerTurns(epochId, turns) {
-    return turns.map((turn) => ({
-        publicTurnId: turn.id,
-        epochId,
-        providerTurnId: turn.id,
-        turn,
-        kind: "provider",
-    }));
+const STOCK_SWITCH_SOURCE_PREFIX = "ccodexProviderSwitch:";
+export function stockSwitchThreadSource(jobId, source) {
+    return `${STOCK_SWITCH_SOURCE_PREFIX}${jobId}|${encodeURIComponent(source ?? "")}`;
+}
+function publicThreadSource(source) {
+    if (!source?.startsWith(STOCK_SWITCH_SOURCE_PREFIX))
+        return source;
+    const separator = source.indexOf("|", STOCK_SWITCH_SOURCE_PREFIX.length);
+    if (separator < 0)
+        return source;
+    return decodeURIComponent(source.slice(separator + 1)) || null;
 }
 export class ProviderEpochs {
-    store;
-    constructor(store) {
-        this.store = store;
+    lineage;
+    legacyMirror;
+    legacySnapshots;
+    constructor(lineage, legacyMirror, legacySnapshots) {
+        this.lineage = lineage;
+        this.legacyMirror = legacyMirror;
+        this.legacySnapshots = legacySnapshots;
     }
     resolve(publicThreadId) {
-        const logical = this.store.getLogicalThread(publicThreadId);
-        const epoch = logical && this.store.getEpoch(logical.currentEpochId);
-        return logical && epoch ? { logical, epoch } : undefined;
+        const task = this.lineage.getTask(publicThreadId);
+        const boundary = task && this.lineage.getEpoch(task.currentEpochId);
+        if (!task || !boundary)
+            return undefined;
+        return {
+            logical: logicalTask(task, this.legacySnapshots?.threads.get(publicThreadId)),
+            epoch: providerEpoch(boundary, this.legacySnapshots?.epochs.get(boundary.epochId) ?? this.legacyMirror?.getEpoch(boundary.epochId)),
+        };
     }
     publicId(provider, backendThreadId) {
-        const epoch = this.store.findEpochByBackend(provider, backendThreadId);
-        return epoch?.state === "current" ? epoch.publicThreadId : undefined;
+        const epoch = this.lineage.findEpoch(provider, backendThreadId);
+        const task = epoch && this.lineage.getTask(epoch.publicThreadId);
+        return epoch && task?.currentEpochId === epoch.epochId ? epoch.publicThreadId : undefined;
     }
     hiddenBackendIds(provider) {
-        return new Set(this.store.listBackendMappings()
+        return new Set(this.lineage.listMappings()
             .filter((mapping) => provider === undefined || mapping.provider === provider)
             .map((mapping) => mapping.backendThreadId));
     }
+    mappings() { return this.lineage.listMappings(); }
+    segments(publicThreadId) { return this.lineage.listSegments(publicThreadId); }
+    epoch(epochId) { return this.lineage.getEpoch(epochId); }
+    configuredEpoch(epochId) { return this.legacySnapshots?.epochs.get(epochId); }
+    belongs(publicThreadId, epochId) {
+        return this.lineage.epochBelongsToLineage(publicThreadId, epochId);
+    }
     seed(thread, provider, model, settings) {
         const existing = this.resolve(thread.id);
         if (existing)
             return existing;
         const epochId = uuidv7();
-        const logical = this.store.createLogicalThread({
+        this.lineage.createTask({
+            publicThreadId: thread.id,
+            currentEpochId: epochId,
+            sessionId: thread.sessionId,
+            ...(thread.forkedFromId ? { forkedFromId: thread.forkedFromId } : {}),
+            ...(thread.parentThreadId ? { parentThreadId: thread.parentThreadId } : {}),
+            createdAt: thread.createdAt,
+        }, { epochId, provider, backendThreadId: thread.id });
+        // Operational compatibility mirror: provider payloads are scrubbed by HandoffStore.
+        this.legacyMirror?.createLogicalThread({
             thread,
             epoch: { id: epochId, provider, backendThreadId: thread.id, model, settings },
         });
+        this.legacySnapshots?.threads?.set(thread.id, thread);
+        this.legacySnapshots?.epochs?.set(epochId, {
+            id: epochId,
+            publicThreadId: thread.id,
+            ordinal: 0,
+            provider,
+            backendThreadId: thread.id,
+            model,
+            settings,
+            state: "current",
+            createdAt: Date.now(),
+        });
         return this.resolve(thread.id);
     }
-    visibleTurns(publicThreadId, currentBackendTurns) {
-        return [
-            ...this.store.listLogicalTurns(publicThreadId).map((turn) => turn.turn),
-            ...currentBackendTurns,
-        ];
-    }
-    snapshotTurns(publicThreadId, currentBackendTurns) {
-        const resolved = this.resolve(publicThreadId);
-        if (!resolved)
-            throw new Error(`Unknown logical thread '${publicThreadId}'.`);
-        return [
-            ...this.store.listLogicalTurns(publicThreadId).map((turn) => ({
-                publicTurnId: turn.publicTurnId,
-                ...(turn.epochId ? { epochId: turn.epochId } : {}),
-                ...(turn.providerTurnId ? { providerTurnId: turn.providerTurnId } : {}),
-                turn: turn.turn,
-                kind: turn.kind,
-            })),
-            ...providerTurns(resolved.epoch.id, currentBackendTurns),
-        ];
+    createFork(thread, backendThreadId, provider, model, settings, inheritedSegments) {
+        const epochId = uuidv7();
+        this.lineage.createForkTask({
+            publicThreadId: thread.id,
+            currentEpochId: epochId,
+            sessionId: thread.sessionId,
+            ...(thread.forkedFromId ? { forkedFromId: thread.forkedFromId } : {}),
+            ...(thread.parentThreadId ? { parentThreadId: thread.parentThreadId } : {}),
+            createdAt: thread.createdAt,
+        }, { epochId, provider, backendThreadId }, inheritedSegments);
+        this.legacyMirror?.createLogicalThread({
+            thread,
+            epoch: { id: epochId, provider, backendThreadId, model, settings },
+        });
+        this.legacySnapshots?.threads?.set(thread.id, thread);
+        return this.resolve(thread.id);
     }
-    projectThread(publicThreadId, backend, includeTurns) {
+    projectThread(publicThreadId, backend, includeTurns, historicalTurns = []) {
         const resolved = this.resolve(publicThreadId);
         if (!resolved)
             throw new Error(`Unknown logical thread '${publicThreadId}'.`);
@@ -67,11 +104,52 @@ export class ProviderEpochs {
         return {
             ...backend,
             id: publicThreadId,
+            sessionId: base.sessionId,
             forkedFromId: base.forkedFromId,
-            name: base.name ?? backend.name,
+            parentThreadId: base.parentThreadId,
             createdAt: base.createdAt,
-            turns: includeTurns ? this.visibleTurns(publicThreadId, backend.turns) : [],
+            threadSource: publicThreadSource(backend.threadSource),
+            turns: includeTurns ? [...historicalTurns, ...backend.turns] : [],
         };
     }
+    /** Legacy-test helper; production history is assembled from provider segments. */
+    visibleTurns(publicThreadId, currentBackendTurns) {
+        return [
+            ...(this.legacyMirror?.listLogicalTurns(publicThreadId).map((turn) => turn.turn) ?? []),
+            ...currentBackendTurns,
+        ];
+    }
+}
+function logicalTask(task, snapshot) {
+    return {
+        publicThreadId: task.publicThreadId,
+        currentEpochId: task.currentEpochId,
+        revision: task.revision,
+        createdAt: task.createdAt * 1_000,
+        updatedAt: task.createdAt * 1_000,
+        thread: snapshot ? { ...snapshot, id: task.publicThreadId, turns: [] } : {
+            id: task.publicThreadId,
+            sessionId: task.sessionId,
+            forkedFromId: task.forkedFromId ?? null,
+            parentThreadId: task.parentThreadId ?? null,
+            createdAt: task.createdAt,
+            turns: [],
+        },
+    };
+}
+function providerEpoch(boundary, mirror) {
+    return {
+        id: boundary.epochId,
+        publicThreadId: boundary.publicThreadId,
+        ordinal: boundary.ordinal,
+        provider: boundary.provider,
+        backendThreadId: boundary.backendThreadId,
+        model: mirror?.model ?? "",
+        settings: mirror?.settings ?? {},
+        state: boundary.state,
+        createdAt: mirror?.createdAt ?? 0,
+        archivePending: boundary.archivePending,
+        deleteDone: boundary.deleteDone,
+    };
 }
 //# sourceMappingURL=providerEpochs.js.map

package/dist/handoff/providerEpochs.js.map

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

package/dist/handoff/service.d.ts

@@ -22,6 +22,7 @@ import type { StockRpc } from "../gateway/stockRpc.js";
 import type { SubscriptionHub } from "../gateway/subscriptions.js";
 import { HandoffStore, type PendingProviderSwitch, type ProviderKind, type StockHistoryOverlay } from "./store.js";
 import { type ResolvedProviderEpoch } from "./providerEpochs.js";
+import { LineageStore } from "./lineageStore.js";
 export declare const HANDOFF_DAEMON_CONNECTION_ID = "ccodex-handoff-daemon";
 export interface LogicalRequestResult {
     readonly provider: ProviderKind;
@@ -44,14 +45,18 @@ export declare class CrossProviderForks {
     private readonly stockServerRequests;
     private readonly stockServerRequestAliases;
     private readonly recentDurableProviders;
+    private readonly adminTails;
+    private readonly lineage;
+    private readonly legacyMirror;
     private daemonStock?;
     private subscriptions?;
     private jobTail;
-    constructor(store: HandoffStore, claude: ClaudeService, renamePrompt?: string | null);
+    constructor(store: HandoffStore, claude: ClaudeService, renamePrompt?: string | null, lineage?: LineageStore);
     pending(threadId: string): PendingProviderSwitch | undefined;
     logical(threadId: string): ResolvedProviderEpoch | undefined;
     hiddenBackendIds(provider?: ProviderKind): Set<string>;
-    sideSnapshot(params: ThreadForkParams, targetThreadId: string): ThreadForkResponse | undefined;
+    catalogTombstones(): string[];
+    sideSnapshot(params: ThreadForkParams, targetThreadId: string): Promise<ThreadForkResponse | undefined>;
     projectThreadCatalog(stockThreads: Thread[], claudeThreads: Thread[], params?: ThreadListParams): Thread[];
     projectLoadedThreadIds(stockIds: string[], claudeIds: string[]): string[];
     projectStockMessage(message: {
@@ -120,6 +125,11 @@ export declare class CrossProviderForks {
     close(): void;
     private seedProviderSwitch;
     private currentBackendTurns;
+    private hydrate;
+    private hydrateEpoch;
+    private historicalTurns;
+    private visibleTurns;
+    private snapshotTurns;
     private patchLogicalThread;
     private updateLogicalEpochFromParams;
     private deleteLogicalThread;
@@ -127,7 +137,11 @@ export declare class CrossProviderForks {
     private providerSwitchMaterial;
     private providerSwitchSummary;
     private targetThreadStart;
+    private finalizeProviderSwitch;
     private commitProviderSwitch;
+    private archiveSealedStockEpoch;
+    private settlePendingStockArchives;
+    private withAdminLock;
     private summarizeStock;
     private registerInternalStockThread;
     private waitStockTurn;