dominds 1.16.1 → 1.16.2

package/dist/persistence.d.ts

@@ -8,11 +8,28 @@ import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-hea
 import type { NativeToolCallPayload, WebSearchCallAction, WebSearchCallSource } from '@longrun-ai/kernel/types/dialog';
 import type { LanguageCode } from '@longrun-ai/kernel/types/language';
 import type { DialogLatestFile, DialogMetadataFile, HumanQuestion, PendingSubdialogStateRecord, PersistedDialogRecord, ProviderData, ReasoningPayload, ReconciledRecordWriteTarget, RootDialogMetadataFile, RootGenerationAnchor, SubdialogMetadataFile, SubdialogRegistryStateRecord, SubdialogResponseStateRecord, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
+import type { DialogsQuarantinedMessage, DialogStatusKind } from '@longrun-ai/kernel/types/wire';
 import { WebSocket } from 'ws';
 import type { PendingSubdialog } from './dialog';
 import { Dialog, DialogID, DialogStore, RootDialog, SubDialog } from './dialog';
 import { ChatMessage, FuncResultMsg, TellaskCarryoverMsg, TellaskResultMsg } from './llm/client';
 import { Reminder } from './tool';
+export declare function setDialogsQuarantinedBroadcaster(fn: ((msg: DialogsQuarantinedMessage) => void) | null): void;
+export declare function setPrepareDialogQuarantineHook(fn: ((args: {
+    dialogId: DialogID;
+    rootDialogId: DialogID;
+    status: DialogStatusKind;
+    reason: string;
+    error: Error;
+}) => Promise<void> | void) | null): void;
+export declare function setFinalizeDialogQuarantineHook(fn: ((args: {
+    dialogId: DialogID;
+    rootDialogId: DialogID;
+    status: DialogStatusKind;
+    reason: string;
+    error: Error;
+    quarantined: boolean;
+}) => Promise<void> | void) | null): void;
 export interface DialogPersistenceState {
     metadata: DialogMetadataFile;
     currentCourse: number;
@@ -150,16 +167,16 @@ export declare class DiskFileDialogStore extends DialogStore {
     /**
      * Load Questions for Human state from storage
      */
-    loadQuestions4Human(dialogId: DialogID, status: 'running' | 'completed' | 'archived'): Promise<HumanQuestion[]>;
-    loadDialogMetadata(dialogId: DialogID, status: 'running' | 'completed' | 'archived'): Promise<DialogMetadataFile | null>;
-    loadPendingSubdialogs(rootDialogId: DialogID, status: 'running' | 'completed' | 'archived'): Promise<PendingSubdialog[]>;
+    loadQuestions4Human(dialogId: DialogID, status: DialogStatusKind): Promise<HumanQuestion[]>;
+    loadDialogMetadata(dialogId: DialogID, status: DialogStatusKind): Promise<DialogMetadataFile | null>;
+    loadPendingSubdialogs(rootDialogId: DialogID, status: DialogStatusKind): Promise<PendingSubdialog[]>;
     saveSubdialogRegistry(dialog: RootDialog, rootDialogId: DialogID, entries: Array<{
         key: string;
         subdialogId: DialogID;
         agentId: string;
         sessionSlug?: string;
-    }>, status: 'running' | 'completed' | 'archived'): Promise<void>;
-    loadSubdialogRegistry(rootDialog: RootDialog, status: 'running' | 'completed' | 'archived'): Promise<void>;
+    }>, status: DialogStatusKind): Promise<void>;
+    loadSubdialogRegistry(rootDialog: RootDialog, status: DialogStatusKind): Promise<void>;
     /**
      * Clear Questions for Human state in storage
      */
@@ -185,7 +202,7 @@ export declare class DiskFileDialogStore extends DialogStore {
      * @param course - Optional course number (uses dialog.currentCourse if not provided)
      * @param totalCourses - Optional total courses count (defaults to course/currentCourse)
      */
-    sendDialogEventsDirectly(ws: WebSocket, dialog: Dialog, course?: number, totalCourses?: number, status?: 'running' | 'completed' | 'archived', options?: {
+    sendDialogEventsDirectly(ws: WebSocket, dialog: Dialog, course?: number, totalCourses?: number, status?: DialogStatusKind, options?: {
         showPrimingEventsInUi?: boolean;
     }): Promise<void>;
     /**
@@ -253,6 +270,12 @@ type DialogLatestMutation = {
     kind: 'replace';
     next: DialogLatestFile;
 };
+type RootDialogWriteBackCancellationToken = Readonly<{
+    scopeKey: string;
+    generation: number;
+    rootDialogId: string;
+    status: DialogStatusKind;
+}>;
 /**
  * Utility class for managing dialog persistence
  */
@@ -263,6 +286,7 @@ export declare class DialogPersistence {
     private static readonly DONE_DIR;
     private static readonly ARCHIVE_DIR;
     private static readonly SUBDIALOGS_DIR;
+    private static readonly quarantinedRootDialogScopes;
     private static readonly LATEST_WRITEBACK_WINDOW_MS;
     private static readonly Q4H_WRITEBACK_WINDOW_MS;
     private static readonly PENDING_SUBDIALOGS_WRITEBACK_WINDOW_MS;
@@ -273,6 +297,7 @@ export declare class DialogPersistence {
     private static readonly pendingSubdialogsWriteBackMutexes;
     private static readonly pendingSubdialogsWriteBack;
     private static readonly courseAppendMutexes;
+    private static readonly rootDialogWriteBackCancelGenerations;
     private static getLatestWriteBackMutex;
     private static getQ4HWriteBackMutex;
     private static getCourseAppendMutex;
@@ -281,116 +306,129 @@ export declare class DialogPersistence {
     private static getLatestWriteBackKey;
     private static getQ4HWriteBackKey;
     private static getPendingSubdialogsWriteBackKey;
+    private static getRootDialogWriteBackCancelScopeKey;
+    private static createRootDialogWriteBackCancellationToken;
+    private static assertRootDialogWriteBackNotCanceled;
+    private static rethrowWriteBackPathMissingAsCanceled;
+    private static cancelRootDialogWriteBacks;
+    private static getDialogMetadataPath;
+    private static assertDialogMetadataExistsForAppend;
+    private static cleanupCanceledAppendPlaceholder;
     private static clonePendingSubdialogRecords;
     private static cloneQuestions4Human;
     private static cloneRegistryEntries;
     private static cloneSubdialogResponses;
-    static appendRemindersReconciledRecord(dialogId: DialogID, reminders: readonly Reminder[], writeTarget: ReconciledRecordWriteTarget, status: 'running' | 'completed' | 'archived'): Promise<void>;
-    static appendQuestions4HumanReconciledRecord(dialogId: DialogID, questions: readonly HumanQuestion[], writeTarget: ReconciledRecordWriteTarget, status: 'running' | 'completed' | 'archived'): Promise<void>;
-    static appendPendingSubdialogsReconciledRecord(dialogId: DialogID, pendingSubdialogs: readonly PendingSubdialogStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: 'running' | 'completed' | 'archived'): Promise<void>;
-    static appendSubdialogRegistryReconciledRecord(dialogId: DialogID, entries: readonly SubdialogRegistryStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: 'running' | 'completed' | 'archived'): Promise<void>;
-    static appendSubdialogResponsesReconciledRecord(dialogId: DialogID, responses: readonly SubdialogResponseStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: 'running' | 'completed' | 'archived'): Promise<void>;
+    static appendRemindersReconciledRecord(dialogId: DialogID, reminders: readonly Reminder[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendQuestions4HumanReconciledRecord(dialogId: DialogID, questions: readonly HumanQuestion[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendPendingSubdialogsReconciledRecord(dialogId: DialogID, pendingSubdialogs: readonly PendingSubdialogStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendSubdialogRegistryReconciledRecord(dialogId: DialogID, entries: readonly SubdialogRegistryStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendSubdialogResponsesReconciledRecord(dialogId: DialogID, responses: readonly SubdialogResponseStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
     /**
      * Get the base dialogs directory path
      */
     static getDialogsRootDir(): string;
-    /**
-     * Save dialog state to JSON file for persistence (internal use only)
-     */
-    private static saveDialogState;
-    /**
-     * Load dialog state from JSON file
-     */
-    static loadDialogState(dialogId: DialogID): Promise<DialogPersistenceState | null>;
     /**
      * Get the full path for a dialog directory
      */
-    static getRootDialogPath(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): string;
+    static getRootDialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
      * Get the events/state directory for a dialog (composite ID for subdialogs)
      */
-    static getDialogEventsPath(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): string;
+    static getDialogEventsPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
      * Get the path for a subdialog within a supdialog
      */
-    static getSubdialogPath(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): string;
-    private static isMalformedDialogLoadError;
+    static getSubdialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
     private static getMalformedRootDialogPath;
+    private static inferRootDialogIdFromMetadataRelativeDir;
+    private static inferExpectedDialogIdFromMetadataRelativeDir;
+    private static listSubdialogIdsUnderRoot;
     private static pathExists;
     private static clearLatestWriteBackState;
-    private static quarantineMalformedRootDialog;
+    private static clearWriteBackEntriesForRootDialog;
+    private static quarantineMalformedDialog;
+    private static rethrowAfterQuarantiningDialogPersistenceProblem;
     private static parseDialogLatestYaml;
     /**
      * Ensure dialog directory structure exists
      */
-    static ensureRootDialogDirectory(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<string>;
+    static ensureRootDialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
     /**
      * Ensure subdialog directory structure exists
      */
-    static ensureSubdialogDirectory(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<string>;
+    static ensureSubdialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
     /**
      * Mark a dialog as completed
      */
     static markDialogCompleted(dialogId: DialogID): Promise<void>;
     /**
-     * List all dialog IDs by scanning for dialog.yaml files and validating their IDs
+     * List candidate root dialog IDs by scanning `dialog.yaml`.
+     *
+     * This scanner intentionally stays lightweight: it only validates the path<->id identity needed
+     * for safe enumeration, and leaves full metadata shape validation to the subsequent lazy-load
+     * step. Callers iterating these candidate IDs must therefore tolerate per-dialog load failures
+     * and continue after a malformed dialog is quarantined.
      */
-    static listDialogs(status?: 'running' | 'completed' | 'archived'): Promise<string[]>;
+    static listDialogs(status?: DialogStatusKind): Promise<string[]>;
     /**
      * List all dialog IDs (root + subdialogs) together with their root IDs.
      * This is the only safe way to enumerate subdialogs because their directory names
      * are not guaranteed to be their selfId.
+     *
+     * Like `listDialogs()`, this is a candidate scanner rather than a full metadata validator.
+     * Callers must treat later metadata/latest loads as lazy, per-dialog operations that can still
+     * quarantine one dialog without invalidating the rest of the enumeration.
      */
-    static listAllDialogIds(status?: 'running' | 'completed' | 'archived'): Promise<DialogID[]>;
+    static listAllDialogIds(status?: DialogStatusKind): Promise<DialogID[]>;
     /**
      * Append event to course JSONL file (append-only pattern)
      */
-    static appendEvents(dialogId: DialogID, course: number, events: readonly PersistedDialogRecord[], status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static appendEvent(dialogId: DialogID, course: number, event: PersistedDialogRecord, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static appendEvents(dialogId: DialogID, course: number, events: readonly PersistedDialogRecord[], status?: DialogStatusKind): Promise<void>;
+    static appendEvent(dialogId: DialogID, course: number, event: PersistedDialogRecord, status?: DialogStatusKind): Promise<void>;
     static persistRuntimeGuide(dialog: Dialog, content: string, genseq: number): Promise<void>;
     /**
      * Capture the current byte offset of a course JSONL file.
      * Used as rollback checkpoint before a streaming LLM attempt.
      */
-    static captureCourseFileOffset(dialogId: DialogID, course: number, status?: 'running' | 'completed' | 'archived'): Promise<number>;
+    static captureCourseFileOffset(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<number>;
     /**
      * Rollback a course JSONL file to a previously captured byte offset.
      * This is used to discard partial streaming artifacts before retrying.
      */
-    static rollbackCourseFileToOffset(dialogId: DialogID, course: number, offset: number, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static rollbackCourseFileToOffset(dialogId: DialogID, course: number, offset: number, status?: DialogStatusKind): Promise<void>;
     /**
      * Read all events from course JSONL file
      */
-    static readCourseEvents(dialogId: DialogID, course: number, status?: 'running' | 'completed' | 'archived'): Promise<PersistedDialogRecord[]>;
+    static readCourseEvents(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<PersistedDialogRecord[]>;
     /**
      * Compute next sequence number for a course by scanning existing events
      */
-    static getNextSeq(dialogId: DialogID, course: number, status?: 'running' | 'completed' | 'archived'): Promise<number>;
+    static getNextSeq(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<number>;
     /**
      * Get current course number from latest.yaml (performance optimization)
      * UI navigation can assume natural numbering schema back to 1
      */
-    static getCurrentCourseNumber(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<number>;
+    static getCurrentCourseNumber(dialogId: DialogID, status?: DialogStatusKind): Promise<number>;
     /**
      * Save reminder state (exceptional overwrite pattern) (internal use only)
      */
-    static _saveReminderState(dialogId: DialogID, reminders: Reminder[], status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static _saveReminderState(dialogId: DialogID, reminders: Reminder[], status?: DialogStatusKind): Promise<void>;
     /**
      * Load reminder state
      */
-    static loadReminderState(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<Reminder[]>;
+    static loadReminderState(dialogId: DialogID, status?: DialogStatusKind): Promise<Reminder[]>;
     /**
      * Save questions for human state (exceptional overwrite pattern) (internal use only)
      */
-    static _saveQuestions4HumanState(dialogId: DialogID, questions: HumanQuestion[], status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static _saveQuestions4HumanState(dialogId: DialogID, questions: HumanQuestion[], status?: DialogStatusKind): Promise<void>;
     /**
      * Load questions for human state
      */
-    static loadQuestions4HumanState(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<HumanQuestion[]>;
+    static loadQuestions4HumanState(dialogId: DialogID, status?: DialogStatusKind): Promise<HumanQuestion[]>;
     private static loadQuestions4HumanStateFromDisk;
-    static mutateQuestions4HumanState(dialogId: DialogID, mutator: (previous: HumanQuestion[]) => Q4HMutation, status?: 'running' | 'completed' | 'archived'): Promise<Q4HMutateOutcome>;
-    static appendQuestion4HumanState(dialogId: DialogID, question: HumanQuestion, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static removeQuestion4HumanState(dialogId: DialogID, questionId: string, status?: 'running' | 'completed' | 'archived'): Promise<{
+    static mutateQuestions4HumanState(dialogId: DialogID, mutator: (previous: HumanQuestion[]) => Q4HMutation, status?: DialogStatusKind): Promise<Q4HMutateOutcome>;
+    static appendQuestion4HumanState(dialogId: DialogID, question: HumanQuestion, status?: DialogStatusKind): Promise<void>;
+    static removeQuestion4HumanState(dialogId: DialogID, questionId: string, status?: DialogStatusKind): Promise<{
         found: boolean;
         remainingQuestions: HumanQuestion[];
         removedQuestion?: HumanQuestion;
@@ -415,41 +453,41 @@ export declare class DialogPersistence {
             messageIndex: number;
         };
     }>>;
-    static clearQuestions4HumanState(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static clearQuestions4HumanState(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
     /**
      * Save pending subdialogs for Type A supply mechanism.
      * Tracks subdialogs that were created but not yet completed.
      */
-    static savePendingSubdialogs(rootDialogId: DialogID, pendingSubdialogs: PendingSubdialogStateRecord[], rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static savePendingSubdialogs(rootDialogId: DialogID, pendingSubdialogs: PendingSubdialogStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
     /**
      * Load pending subdialogs for Type A supply mechanism.
      */
-    static loadPendingSubdialogs(rootDialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<PendingSubdialogStateRecord[]>;
+    static loadPendingSubdialogs(rootDialogId: DialogID, status?: DialogStatusKind): Promise<PendingSubdialogStateRecord[]>;
     private static isPendingSubdialogRecord;
     private static loadPendingSubdialogsFromDisk;
-    static mutatePendingSubdialogs(rootDialogId: DialogID, mutator: (previous: PendingSubdialogStateRecord[]) => PendingSubdialogsMutation, rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<PendingSubdialogsMutateOutcome>;
-    static appendPendingSubdialog(rootDialogId: DialogID, record: PendingSubdialogStateRecord, rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static removePendingSubdialog(rootDialogId: DialogID, subdialogId: string, rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static clearPendingSubdialogs(rootDialogId: DialogID, rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static mutatePendingSubdialogs(rootDialogId: DialogID, mutator: (previous: PendingSubdialogStateRecord[]) => PendingSubdialogsMutation, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<PendingSubdialogsMutateOutcome>;
+    static appendPendingSubdialog(rootDialogId: DialogID, record: PendingSubdialogStateRecord, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static removePendingSubdialog(rootDialogId: DialogID, subdialogId: string, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static clearPendingSubdialogs(rootDialogId: DialogID, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
     private static flushPendingSubdialogsWriteBack;
     private static writePendingSubdialogsToDisk;
     /**
      * Get the path for storing subdialog responses (supports both root and subdialog parents).
      * For Type C subdialogs created inside another subdialog, responses are stored at the parent's level.
      */
-    static getDialogResponsesPath(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): string;
+    static getDialogResponsesPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
      * Save subdialog responses for Type A supply mechanism.
      * Tracks responses from completed subdialogs.
      */
-    static saveSubdialogResponses(rootDialogId: DialogID, responses: SubdialogResponseStateRecord[], rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static saveSubdialogResponses(rootDialogId: DialogID, responses: SubdialogResponseStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
     /**
      * Load subdialog responses for Type A supply mechanism.
      */
-    static loadSubdialogResponses(rootDialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<SubdialogResponseStateRecord[]>;
-    static loadSubdialogResponsesQueue(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<SubdialogResponseStateRecord[]>;
-    static appendSubdialogResponse(dialogId: DialogID, response: SubdialogResponseStateRecord, rootAnchor?: RootGenerationAnchor, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static takeSubdialogResponses(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<Array<{
+    static loadSubdialogResponses(rootDialogId: DialogID, status?: DialogStatusKind): Promise<SubdialogResponseStateRecord[]>;
+    static loadSubdialogResponsesQueue(dialogId: DialogID, status?: DialogStatusKind): Promise<SubdialogResponseStateRecord[]>;
+    static appendSubdialogResponse(dialogId: DialogID, response: SubdialogResponseStateRecord, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static takeSubdialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<Array<{
         responseId: string;
         subdialogId: string;
         response: string;
@@ -463,38 +501,37 @@ export declare class DialogPersistence {
         originMemberId: string;
         callId: string;
     }>>;
-    static commitTakenSubdialogResponses(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static rollbackTakenSubdialogResponses(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static commitTakenSubdialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
+    static rollbackTakenSubdialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
     /**
      * Save root dialog metadata (write-once pattern)
      */
-    static saveRootDialogMetadata(dialogId: DialogID, metadata: RootDialogMetadataFile, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static saveRootDialogMetadata(dialogId: DialogID, metadata: RootDialogMetadataFile, status?: DialogStatusKind): Promise<void>;
     /**
      * Save dialog metadata (universal - works with any DialogID)
      */
-    static saveDialogMetadata(dialogId: DialogID, metadata: DialogMetadataFile, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static saveDialogMetadata(dialogId: DialogID, metadata: DialogMetadataFile, status?: DialogStatusKind): Promise<void>;
     /**
      * Save dialog metadata (legacy - use saveRootDialogMetadata instead)
      * @deprecated
      */
-    static _saveDialogMetadata(dialogId: DialogID, metadata: RootDialogMetadataFile, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static _saveDialogMetadata(dialogId: DialogID, metadata: RootDialogMetadataFile, status?: DialogStatusKind): Promise<void>;
     /**
      * Save subdialog metadata under the supdialog's .subdialogs directory
      */
-    static saveSubdialogMetadata(dialogId: DialogID, metadata: SubdialogMetadataFile, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static saveSubdialogMetadata(dialogId: DialogID, metadata: SubdialogMetadataFile, status?: DialogStatusKind): Promise<void>;
     /**
      * Update assignmentFromSup for an existing subdialog.
-     * Persists both subdialog metadata locations for consistency.
      */
-    static updateSubdialogAssignment(dialogId: DialogID, assignment: SubdialogMetadataFile['assignmentFromSup'], status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    static updateSubdialogAssignment(dialogId: DialogID, assignment: SubdialogMetadataFile['assignmentFromSup'], status?: DialogStatusKind): Promise<void>;
     /**
      * Load root dialog metadata
      */
-    static loadRootDialogMetadata(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogMetadataFile | null>;
+    static loadRootDialogMetadata(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogMetadataFile | null>;
     /**
      * Load dialog metadata (universal - works with any DialogID)
      */
-    static loadDialogMetadata(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogMetadataFile | null>;
+    static loadDialogMetadata(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogMetadataFile | null>;
     /**
      * Save latest.yaml with current course and lastModified info
      */
@@ -506,7 +543,7 @@ export declare class DialogPersistence {
     /**
      * Load latest.yaml for current course and lastModified info
      */
-    static loadDialogLatest(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogLatestFile | null>;
+    static loadDialogLatest(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogLatestFile | null>;
     /**
      * Delta-only latest.yaml update API.
      *
@@ -514,13 +551,13 @@ export declare class DialogPersistence {
      * staged state (or disk fallback). This avoids read-modify-write races in user code
      * and allows lock-free-ish coalescing to disk via the write-back buffer.
      */
-    static mutateDialogLatest(dialogId: DialogID, mutator: (previous: DialogLatestFile) => DialogLatestMutation, status?: 'running' | 'completed' | 'archived'): Promise<DialogLatestFile>;
+    static mutateDialogLatest(dialogId: DialogID, mutator: (previous: DialogLatestFile) => DialogLatestMutation, status?: DialogStatusKind, cancellationToken?: RootDialogWriteBackCancellationToken): Promise<DialogLatestFile>;
     private static loadDialogLatestFromDisk;
     private static flushLatestWriteBack;
-    static setNeedsDrive(dialogId: DialogID, needsDrive: boolean, status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static getNeedsDrive(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<boolean>;
-    static setDeferredReplyReassertion(dialogId: DialogID, deferredReplyReassertion: DialogLatestFile['deferredReplyReassertion'], status?: 'running' | 'completed' | 'archived'): Promise<void>;
-    static getDeferredReplyReassertion(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogLatestFile['deferredReplyReassertion']>;
+    static setNeedsDrive(dialogId: DialogID, needsDrive: boolean, status?: DialogStatusKind): Promise<void>;
+    static getNeedsDrive(dialogId: DialogID, status?: DialogStatusKind): Promise<boolean>;
+    static setDeferredReplyReassertion(dialogId: DialogID, deferredReplyReassertion: DialogLatestFile['deferredReplyReassertion'], status?: DialogStatusKind): Promise<void>;
+    static getDeferredReplyReassertion(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogLatestFile['deferredReplyReassertion']>;
     /**
      * Get course filename from course number
      */
@@ -532,16 +569,16 @@ export declare class DialogPersistence {
     /**
      * Get dialog status from file system path
      */
-    static getStatusFromPath(dialogPath: string): 'running' | 'completed' | 'archived';
-    static loadQuestions4Human(dialogId: DialogID, course: number, status?: 'running' | 'completed' | 'archived'): Promise<Questions4Human | null>;
+    static getStatusFromPath(dialogPath: string): DialogStatusKind;
+    static loadQuestions4Human(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<Questions4Human | null>;
     /**
      * Count subdialogs under a root dialog (no single-layer listing exposed)
      */
-    static countAllSubdialogsUnderRoot(rootDialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<number>;
+    static countAllSubdialogsUnderRoot(rootDialogId: DialogID, status?: DialogStatusKind): Promise<number>;
     /**
      * Restore complete dialog tree from disk
      */
-    static restoreDialogTree(rootDialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogPersistenceState | null>;
+    static restoreDialogTree(rootDialogId: DialogID, status?: DialogStatusKind): Promise<DialogPersistenceState | null>;
     /**
      * Restore dialog from disk using JSONL events (optimized: only latest course loaded).
      * Historical-course ask/tellask context that still matters to the current round must already be
@@ -549,11 +586,11 @@ export declare class DialogPersistence {
      * LLM context during restore. For historical courses, use loadCourseEvents() on-demand for UI
      * navigation.
      */
-    static restoreDialog(dialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<DialogPersistenceState | null>;
+    static restoreDialog(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogPersistenceState | null>;
     /**
      * Load specific course events for UI navigation (on-demand)
      */
-    static loadCourseEvents(dialogId: DialogID, course: number, status?: 'running' | 'completed' | 'archived'): Promise<PersistedDialogRecord[]>;
+    static loadCourseEvents(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<PersistedDialogRecord[]>;
     /**
      * Reconstruct dialog state from JSONL events (optimized: only latest course needed).
      */
@@ -561,12 +598,12 @@ export declare class DialogPersistence {
     /**
      * Move dialog between status directories (run/done/archive)
      */
-    static moveDialogStatus(dialogId: DialogID, fromStatus: 'running' | 'completed' | 'archived', toStatus: 'running' | 'completed' | 'archived'): Promise<void>;
+    static moveDialogStatus(dialogId: DialogID, fromStatus: DialogStatusKind, toStatus: DialogStatusKind): Promise<void>;
     /**
      * Delete a root dialog directory (including subdialogs) from disk.
      * Caller must provide the source status explicitly.
      */
-    static deleteRootDialog(rootDialogId: DialogID, fromStatus: 'running' | 'completed' | 'archived'): Promise<boolean>;
+    static deleteRootDialog(rootDialogId: DialogID, fromStatus: DialogStatusKind): Promise<boolean>;
     /**
      * Save subdialog registry (TYPE B entries).
      */
@@ -575,11 +612,11 @@ export declare class DialogPersistence {
         subdialogId: DialogID;
         agentId: string;
         sessionSlug?: string;
-    }>, status?: 'running' | 'completed' | 'archived'): Promise<void>;
+    }>, status?: DialogStatusKind): Promise<void>;
     /**
      * Load subdialog registry.
      */
-    static loadSubdialogRegistry(rootDialogId: DialogID, status?: 'running' | 'completed' | 'archived'): Promise<Array<{
+    static loadSubdialogRegistry(rootDialogId: DialogID, status?: DialogStatusKind): Promise<Array<{
         key: string;
         subdialogId: DialogID;
         agentId: string;