@spexcode/spec-cli 0.6.5

package/dist/codex-runtime-generations.d.ts

@@ -0,0 +1,53 @@
+export type CodexGenerationEndpoint = Readonly<{
+    id: string;
+    pidFile: string;
+    receiptFile: string;
+    logFile: string;
+    socketPath: string;
+}>;
+type CodexGenerationState = 'current' | 'draining' | 'reclaimed' | 'starting';
+type GenerationReservation = Readonly<{
+    pid: number;
+    startToken: string;
+}>;
+type CodexGeneration = Readonly<{
+    state: CodexGenerationState;
+    endpoint: CodexGenerationEndpoint;
+    reservation?: GenerationReservation;
+}>;
+export type CodexGenerationBinding = Readonly<{
+    generationId: string;
+    threadId: string;
+    phase?: 'record-pending' | 'record-removing';
+}>;
+export type CodexGenerationLedger = Readonly<{
+    version: 3;
+    revision: number;
+    current: string | null;
+    pending: string | null;
+    generations: Record<string, CodexGeneration>;
+    bindings: Record<string, CodexGenerationBinding>;
+}>;
+export declare function codexGenerationSocketPath(root: string, generationId?: string): string;
+export declare function legacyCodexGenerationEndpoint(root: string): CodexGenerationEndpoint;
+export declare function readCodexGenerationLedger(root: string): CodexGenerationLedger;
+export declare function ensureCodexCurrentGeneration(root: string, start: (endpoint: CodexGenerationEndpoint) => Promise<void>): Promise<CodexGenerationEndpoint>;
+export declare function bindCodexGeneration(root: string, sessionId: string, threadId: string, generationId: string | null): void;
+export declare function prepareCodexGenerationRegistration(root: string, sessionId: string, threadId: string, generationId: string): void;
+export declare function commitCodexGenerationRegistration(root: string, sessionId: string, threadId: string, generationId: string): void;
+export declare function prepareCodexGenerationClose(root: string, sessionId: string, threadId: string): void;
+export declare function repinCodexGeneration(root: string, sessionId: string, threadId: string, generationId: string): void;
+export declare function resolveCodexGenerationForResume(root: string, sessionId: string, threadId: string, start: (endpoint: CodexGenerationEndpoint) => Promise<void>): Promise<CodexGenerationEndpoint | null>;
+export declare function resolveCodexGenerationForSession(root: string, sessionId: string, threadId: string): CodexGenerationEndpoint | null;
+export declare function codexGenerationBindingForSession(root: string, sessionId: string): CodexGenerationBinding | null;
+export declare function currentCodexGeneration(root: string): CodexGenerationEndpoint | null;
+export declare function codexGenerationEndpoints(root: string): CodexGenerationEndpoint[];
+export declare function reclaimDrainingCodexGeneration(root: string, generationId: string, census: (endpoint: CodexGenerationEndpoint) => Promise<{
+    healthy: boolean;
+    referenceIds: string[];
+    peerCount: number;
+}>): Promise<{
+    reclaimed: boolean;
+    reason: string;
+}>;
+export {};