@dsh-enhanced/assistant-delivery 0.1.62 → 0.1.64

package/lib/restart-store.d.ts

@@ -0,0 +1,132 @@
+import type { ConversationRef, ExternalPrincipalKey, ModelRouteRef } from './types.js';
+/** This is an operation journal, not another Agent or task scheduler. */
+export type RestartStatus = 'requested' | 'checkpoint' | 'ready' | 'restarting' | 'restarted' | 'resuming' | 'completed' | 'failed' | 'cancelled';
+export interface RestartBindingSnapshot {
+    id: string;
+    version: number;
+    generation: number;
+    sessionId: string;
+    workspace: string;
+    preset: string;
+    policyRef: string;
+    authorityHash: string;
+    conversation: ConversationRef;
+    principal: ExternalPrincipalKey;
+}
+export interface RestartTaskInput {
+    inboxId: string;
+    eventId: string;
+    binding: RestartBindingSnapshot;
+    owner: {
+        principalRecordId: string;
+        principalVersion: number;
+    };
+    /** The exact invocation that admitted the original foreground task. */
+    sourceInvocationId: string;
+    maxModelRequests: number;
+    maxToolCalls: number;
+    maxOutputTokens: number;
+    capabilityDigest: string;
+    deadline: number;
+}
+export interface RestartTask extends RestartTaskInput {
+    createdAt: number;
+    model?: ModelRouteRef;
+    modelRequests: number;
+    toolCalls: number;
+}
+export interface RestartCheckpoint {
+    sessionEventCount: number;
+    sessionDigest: string;
+    continuationMessageId: string;
+    continuationTextDigest: string;
+}
+export interface RestartRecord {
+    id: string;
+    inboxId: string;
+    requestKey: string;
+    reason: string;
+    status: RestartStatus;
+    sourceInvocationId: string;
+    restartInvocationId?: string;
+    restartHolderId?: string;
+    continuationHolderId?: string;
+    checkpoint?: RestartCheckpoint;
+    failureCode?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export type RestartStoreErrorCode = 'invalid' | 'conflict' | 'not-found' | 'deadline' | 'budget' | 'corrupt' | 'closed';
+export declare class RestartStoreError extends Error {
+    readonly code: RestartStoreErrorCode;
+    constructor(code: RestartStoreErrorCode, message: string);
+}
+interface RestartStoreOptions {
+    path: string;
+    now?: () => number;
+    readOnly?: boolean;
+}
+export declare class RestartStore {
+    private readonly database;
+    private readonly now;
+    private readonly readOnly;
+    private closed;
+    constructor(options: RestartStoreOptions);
+    private assertOpen;
+    private write;
+    private task;
+    getTask(inboxId: string): RestartTask | undefined;
+    private ineligibility;
+    private markIneligibleWithinWrite;
+    markIneligible(inboxId: string, reason: string): void;
+    isEligible(inboxId: string): boolean;
+    beginTask(input: RestartTaskInput): RestartTask;
+    captureModel(inboxId: string, input: ModelRouteRef): RestartTask;
+    /** A supplier change ends recovery eligibility without interrupting normal work. */
+    observeModel(inboxId: string, input: ModelRouteRef): RestartTask;
+    /** Normal foreground calls are observed durably, even after recovery becomes impossible. */
+    observe(inboxId: string, kind: 'model' | 'tool', operationId: string): RestartTask;
+    /** A held request/tool reservation is never refunded after an unknown result. */
+    reserve(inboxId: string, kind: 'model' | 'tool', operationId: string): RestartTask;
+    private requestById;
+    getRequest(id: string): RestartRecord | undefined;
+    getRequestForTask(inboxId: string): RestartRecord | undefined;
+    request(inboxId: string, input: {
+        reason: string;
+        requestKey: string;
+    }): RestartRecord;
+    private event;
+    private transition;
+    checkpoint(id: string, input: RestartCheckpoint): RestartRecord;
+    ready(id: string): RestartRecord;
+    claimRestart(id: string, input: {
+        holderId: string;
+        invocationId: string;
+    }): RestartRecord;
+    /** Observation only: this never grants another restart dispatch. */
+    markRestarted(id: string, input: {
+        invocationId: string;
+    }): RestartRecord;
+    claimContinuation(id: string, input: {
+        holderId: string;
+        invocationId: string;
+    }): RestartRecord;
+    complete(id: string): RestartRecord;
+    fail(id: string, code: string): RestartRecord;
+    cancelForBinding(bindingId: string): RestartRecord[];
+    listRequests(input?: {
+        statuses?: readonly RestartStatus[];
+        limit?: number;
+        after?: {
+            createdAt: number;
+            id: string;
+        };
+    }): RestartRecord[];
+    /** Count durable restart dispatch claims for an external global circuit breaker. */
+    countDispatchedSince(sinceMs: number): number;
+    hasReservation(inboxId: string, kind: 'model' | 'tool', operationId: string): boolean;
+    activeRequestForBinding(bindingId: string): RestartRecord | undefined;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=restart-store.d.ts.map

package/lib/restart-store.d.ts.map

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