dominds 1.18.2 → 1.19.2

package/dist/persistence.d.ts

@@ -8,25 +8,25 @@ import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-hea
 import type { NativeToolCallPayload, WebSearchCallAction, WebSearchCallSource } from '@longrun-ai/kernel/types/dialog';
 import type { DialogRuntimePrompt } from '@longrun-ai/kernel/types/drive-intent';
 import type { LanguageCode } from '@longrun-ai/kernel/types/language';
-import type { DialogLatestFile, DialogMetadataFile, HumanQuestion, HumanTextRecord, PendingSubdialogStateRecord, PersistedDialogRecord, ProviderData, ReasoningPayload, ReconciledRecordWriteTarget, RootDialogMetadataFile, RootGenerationAnchor, SubdialogMetadataFile, SubdialogRegistryStateRecord, SubdialogResponseStateRecord, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
+import type { DialogAskerStackState, DialogLatestFile, DialogMetadataFile, HumanQuestion, HumanTextRecord, MainDialogMetadataFile, PendingSideDialogStateRecord, PersistedDialogRecord, ProviderData, ReasoningPayload, ReconciledRecordWriteTarget, RootGenerationAnchor, SideDialogAssignmentFromAsker, SideDialogMetadataFile, SideDialogRegistryStateRecord, SideDialogResponseStateRecord, 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 type { PendingSideDialog } from './dialog';
+import { Dialog, DialogID, DialogStore, MainDialog, SideDialog } from './dialog';
 import { ChatMessage, FuncResultMsg, TellaskCarryoverMsg, TellaskResultMsg } from './llm/client';
 import type { ToolResultImageIngest, UserImageIngest } from './llm/gen';
 import { Reminder } from './tool';
 export declare function setDialogsQuarantinedBroadcaster(fn: ((msg: DialogsQuarantinedMessage) => void) | null): void;
 export declare function setPrepareDialogQuarantineHook(fn: ((args: {
     dialogId: DialogID;
-    rootDialogId: DialogID;
+    mainDialogId: DialogID;
     status: DialogStatusKind;
     reason: string;
     error: Error;
 }) => Promise<void> | void) | null): void;
 export declare function setFinalizeDialogQuarantineHook(fn: ((args: {
     dialogId: DialogID;
-    rootDialogId: DialogID;
+    mainDialogId: DialogID;
     status: DialogStatusKind;
     reason: string;
     error: Error;
@@ -52,17 +52,17 @@ export declare class DiskFileDialogStore extends DialogStore {
     private readonly dialogId;
     constructor(dialogId: DialogID);
     /**
-     * Create subdialog with automatic persistence
+     * Create sideDialog with automatic persistence
      */
-    createSubDialog(callerDialog: Dialog, targetAgentId: string, mentionList: string[] | undefined, tellaskContent: string, options: {
+    createSideDialog(askerDialog: Dialog, targetAgentId: string, mentionList: string[] | undefined, tellaskContent: string, options: {
         callName: 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning';
         originMemberId: string;
-        callerDialogId: string;
+        askerDialogId: string;
         callId: string;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;
-    }): Promise<SubDialog>;
+    }): Promise<SideDialog>;
     /**
      * Receive and handle function call results (includes logging)
      */
@@ -70,11 +70,13 @@ export declare class DiskFileDialogStore extends DialogStore {
     receiveTellaskResult(dialog: Dialog, result: TellaskResultMsg): Promise<void>;
     receiveTellaskCarryover(dialog: Dialog, result: TellaskCarryoverMsg): Promise<void>;
     /**
-     * Ensure subdialog directory exists (delegate to DialogPersistence)
+     * Ensure sideDialog directory exists (delegate to DialogPersistence)
      */
-    private ensureSubdialogDirectory;
+    private ensureSideDialogDirectory;
     private findExistingFuncResultRecord;
+    private findExistingCallRecord;
     private findExistingTellaskResultRecord;
+    private raiseDuplicateCallInvariantViolation;
     private raiseDuplicateCallResultInvariantViolation;
     /**
      * Append event to course JSONL file (delegate to DialogPersistence)
@@ -110,7 +112,6 @@ export declare class DiskFileDialogStore extends DialogStore {
         sessionSlug?: string;
         tellaskContent: string;
     }): Promise<void>;
-    funcCallRequested(dialog: Dialog, funcId: string, funcName: string, argumentsStr: string): Promise<void>;
     webSearchCall(dialog: Dialog, payload: {
         source?: WebSearchCallSource;
         phase: 'added' | 'done';
@@ -158,15 +159,6 @@ export declare class DiskFileDialogStore extends DialogStore {
     persistTellaskCall(dialog: Dialog, id: string, name: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'replyTellask' | 'replyTellaskSessionless' | 'replyTellaskBack' | 'askHuman' | 'freshBootsReasoning', rawArgumentsText: string, genseq: number, options?: {
         deliveryMode?: 'tellask_call_start' | 'func_call_requested';
     }): Promise<void>;
-    persistFunctionCallResultPair(dialog: Dialog, id: string, name: string, rawArgumentsText: string, genseq: number, result: FuncResultMsg): Promise<void>;
-    persistTellaskCallResultPair(dialog: Dialog, args: {
-        id: string;
-        name: TellaskCallRecordName;
-        rawArgumentsText: string;
-        genseq: number;
-        result: TellaskResultMsg | FuncResultMsg;
-        deliveryMode: 'tellask_call_start' | 'func_call_requested';
-    }): Promise<void>;
     /**
      * Update questions for human state (exceptional overwrite pattern)
      */
@@ -176,14 +168,15 @@ export declare class DiskFileDialogStore extends DialogStore {
      */
     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<{
+    loadSideDialogAssignmentFromAsker(dialogId: DialogID, status: DialogStatusKind): Promise<SideDialogAssignmentFromAsker | null>;
+    loadPendingSideDialogs(mainDialogId: DialogID, status: DialogStatusKind): Promise<PendingSideDialog[]>;
+    saveSideDialogRegistry(dialog: MainDialog, mainDialogId: DialogID, entries: Array<{
         key: string;
-        subdialogId: DialogID;
+        sideDialogId: DialogID;
         agentId: string;
         sessionSlug?: string;
     }>, status: DialogStatusKind): Promise<void>;
-    loadSubdialogRegistry(rootDialog: RootDialog, status: DialogStatusKind): Promise<void>;
+    loadSideDialogRegistry(mainDialog: MainDialog, status: DialogStatusKind): Promise<void>;
     /**
      * Clear Questions for Human state in storage
      */
@@ -242,27 +235,27 @@ type Q4HMutateOutcome = {
     questions: HumanQuestion[];
     removedQuestion?: HumanQuestion;
 };
-type PendingSubdialogsMutation = {
+type PendingSideDialogsMutation = {
     kind: 'noop';
 } | {
     kind: 'append';
-    record: PendingSubdialogStateRecord;
+    record: PendingSideDialogStateRecord;
 } | {
-    kind: 'removeBySubdialogId';
-    subdialogId: string;
+    kind: 'removeBySideDialogId';
+    sideDialogId: string;
 } | {
-    kind: 'removeBySubdialogIds';
-    subdialogIds: string[];
+    kind: 'removeBySideDialogIds';
+    sideDialogIds: string[];
 } | {
     kind: 'replace';
-    records: PendingSubdialogStateRecord[];
+    records: PendingSideDialogStateRecord[];
 } | {
     kind: 'clear';
 };
-type PendingSubdialogsMutateOutcome = {
-    previousRecords: PendingSubdialogStateRecord[];
-    records: PendingSubdialogStateRecord[];
-    removedRecords: PendingSubdialogStateRecord[];
+type PendingSideDialogsMutateOutcome = {
+    previousRecords: PendingSideDialogStateRecord[];
+    records: PendingSideDialogStateRecord[];
+    removedRecords: PendingSideDialogStateRecord[];
 };
 type DialogLatestPatch = Partial<Omit<DialogLatestFile, 'currentCourse' | 'lastModified'>> & {
     currentCourse?: number;
@@ -277,10 +270,10 @@ type DialogLatestMutation = {
     kind: 'replace';
     next: DialogLatestFile;
 };
-type RootDialogWriteBackCancellationToken = Readonly<{
+type MainDialogWriteBackCancellationToken = Readonly<{
     scopeKey: string;
     generation: number;
-    rootDialogId: string;
+    mainDialogId: string;
     status: DialogStatusKind;
 }>;
 /**
@@ -292,44 +285,45 @@ export declare class DialogPersistence {
     private static readonly RUN_DIR;
     private static readonly DONE_DIR;
     private static readonly ARCHIVE_DIR;
-    private static readonly SUBDIALOGS_DIR;
-    private static readonly quarantinedRootDialogScopes;
+    private static readonly SIDE_DIALOGS_DIR;
+    private static readonly quarantinedMainDialogScopes;
     private static readonly LATEST_WRITEBACK_WINDOW_MS;
     private static readonly Q4H_WRITEBACK_WINDOW_MS;
-    private static readonly PENDING_SUBDIALOGS_WRITEBACK_WINDOW_MS;
+    private static readonly PENDING_SIDE_DIALOGS_WRITEBACK_WINDOW_MS;
     private static readonly latestWriteBackMutexes;
     private static readonly latestWriteBack;
     private static readonly q4hWriteBackMutexes;
     private static readonly q4hWriteBack;
-    private static readonly pendingSubdialogsWriteBackMutexes;
-    private static readonly pendingSubdialogsWriteBack;
+    private static readonly pendingSideDialogsWriteBackMutexes;
+    private static readonly pendingSideDialogsWriteBack;
     private static readonly courseAppendMutexes;
-    private static readonly rootDialogWriteBackCancelGenerations;
+    private static readonly mainDialogWriteBackCancelGenerations;
     private static getLatestWriteBackMutex;
     private static getQ4HWriteBackMutex;
     private static getCourseAppendMutex;
     private static getCourseAppendMutexKey;
-    private static getPendingSubdialogsWriteBackMutex;
+    private static getPendingSideDialogsWriteBackMutex;
     private static getLatestWriteBackKey;
     private static getQ4HWriteBackKey;
-    private static getPendingSubdialogsWriteBackKey;
-    private static getRootDialogWriteBackCancelScopeKey;
-    private static createRootDialogWriteBackCancellationToken;
-    private static assertRootDialogWriteBackNotCanceled;
+    private static getPendingSideDialogsWriteBackKey;
+    private static getMainDialogWriteBackCancelScopeKey;
+    private static createMainDialogWriteBackCancellationToken;
+    private static assertMainDialogWriteBackNotCanceled;
     private static rethrowWriteBackPathMissingAsCanceled;
-    private static cancelRootDialogWriteBacks;
+    private static cancelMainDialogWriteBacks;
     private static getDialogMetadataPath;
+    private static getDialogAskerStackPath;
     private static assertDialogMetadataExistsForAppend;
     private static cleanupCanceledAppendPlaceholder;
-    private static clonePendingSubdialogRecords;
+    private static clonePendingSideDialogRecords;
     private static cloneQuestions4Human;
     private static cloneRegistryEntries;
-    private static cloneSubdialogResponses;
+    private static cloneSideDialogResponses;
     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>;
+    static appendPendingSideDialogsReconciledRecord(dialogId: DialogID, pendingSideDialogs: readonly PendingSideDialogStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendSideDialogRegistryReconciledRecord(dialogId: DialogID, entries: readonly SideDialogRegistryStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
+    static appendSideDialogResponsesReconciledRecord(dialogId: DialogID, responses: readonly SideDialogResponseStateRecord[], writeTarget: ReconciledRecordWriteTarget, status: DialogStatusKind): Promise<void>;
     /**
      * Get the base dialogs directory path
      */
@@ -337,39 +331,39 @@ export declare class DialogPersistence {
     /**
      * Get the full path for a dialog directory
      */
-    static getRootDialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
+    static getMainDialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
-     * Get the events/state directory for a dialog (composite ID for subdialogs)
+     * Get the events/state directory for a dialog (composite ID for sideDialogs)
      */
     static getDialogEventsPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
-     * Get the path for a subdialog within a supdialog
+     * Get the path for a sideDialog within an askerDialog
      */
-    static getSubdialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
-    private static getMalformedRootDialogPath;
-    private static inferRootDialogIdFromMetadataRelativeDir;
+    static getSideDialogPath(dialogId: DialogID, status?: DialogStatusKind): string;
+    private static getMalformedMainDialogPath;
+    private static inferMainDialogIdFromMetadataRelativeDir;
     private static inferExpectedDialogIdFromMetadataRelativeDir;
-    private static listSubdialogIdsUnderRoot;
+    private static listSideDialogIdsUnderRoot;
     private static pathExists;
     private static clearLatestWriteBackState;
-    private static clearWriteBackEntriesForRootDialog;
+    private static clearWriteBackEntriesForMainDialog;
     private static quarantineMalformedDialog;
     private static rethrowAfterQuarantiningDialogPersistenceProblem;
     private static parseDialogLatestYaml;
     /**
      * Ensure dialog directory structure exists
      */
-    static ensureRootDialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
+    static ensureMainDialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
     /**
-     * Ensure subdialog directory structure exists
+     * Ensure sideDialog directory structure exists
      */
-    static ensureSubdialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
+    static ensureSideDialogDirectory(dialogId: DialogID, status?: DialogStatusKind): Promise<string>;
     /**
      * Mark a dialog as completed
      */
     static markDialogCompleted(dialogId: DialogID): Promise<void>;
     /**
-     * List candidate root dialog IDs by scanning `dialog.yaml`.
+     * List candidate main 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
@@ -378,8 +372,8 @@ export declare class DialogPersistence {
      */
     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
+     * List all dialog IDs (main dialogs + sideDialogs) together with their root IDs.
+     * This is the only safe way to enumerate sideDialogs because their directory names
      * are not guaranteed to be their selfId.
      *
      * Like `listDialogs()`, this is a candidate scanner rather than a full metadata validator.
@@ -462,41 +456,40 @@ export declare class DialogPersistence {
     }>>;
     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.
+     * Save pending sideDialogs that have an outstanding tellask/reply delivery.
      */
-    static savePendingSubdialogs(rootDialogId: DialogID, pendingSubdialogs: PendingSubdialogStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static savePendingSideDialogs(mainDialogId: DialogID, pendingSideDialogs: PendingSideDialogStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
     /**
-     * Load pending subdialogs for Type A supply mechanism.
+     * Load pending sideDialogs that have an outstanding tellask/reply delivery.
      */
-    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?: 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;
+    static loadPendingSideDialogs(mainDialogId: DialogID, status?: DialogStatusKind): Promise<PendingSideDialogStateRecord[]>;
+    private static isPendingSideDialogRecord;
+    private static assertNoDuplicateSessionedTellaskPendingRecords;
+    private static loadPendingSideDialogsFromDisk;
+    static mutatePendingSideDialogs(mainDialogId: DialogID, mutator: (previous: PendingSideDialogStateRecord[]) => PendingSideDialogsMutation, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<PendingSideDialogsMutateOutcome>;
+    static appendPendingSideDialog(mainDialogId: DialogID, record: PendingSideDialogStateRecord, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static removePendingSideDialog(mainDialogId: DialogID, sideDialogId: string, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static clearPendingSideDialogs(mainDialogId: DialogID, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    private static flushPendingSideDialogsWriteBack;
+    private static writePendingSideDialogsToDisk;
     /**
-     * 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.
+     * Get the path for storing sideDialog responses (supports both main dialog and sideDialog tellaskers).
+     * For Type C sideDialogs created inside another sideDialog, responses are stored at the parent's level.
      */
     static getDialogResponsesPath(dialogId: DialogID, status?: DialogStatusKind): string;
     /**
-     * Save subdialog responses for Type A supply mechanism.
-     * Tracks responses from completed subdialogs.
+     * Save responses delivered back from completed sideDialogs.
      */
-    static saveSubdialogResponses(rootDialogId: DialogID, responses: SubdialogResponseStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static saveSideDialogResponses(mainDialogId: DialogID, responses: SideDialogResponseStateRecord[], rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
     /**
-     * Load subdialog responses for Type A supply mechanism.
+     * Load responses delivered back from completed sideDialogs.
      */
-    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<{
+    static loadSideDialogResponses(mainDialogId: DialogID, status?: DialogStatusKind): Promise<SideDialogResponseStateRecord[]>;
+    static loadSideDialogResponsesQueue(dialogId: DialogID, status?: DialogStatusKind): Promise<SideDialogResponseStateRecord[]>;
+    static appendSideDialogResponse(dialogId: DialogID, response: SideDialogResponseStateRecord, rootAnchor?: RootGenerationAnchor, status?: DialogStatusKind): Promise<void>;
+    static takeSideDialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<Array<{
         responseId: string;
-        subdialogId: string;
+        sideDialogId: string;
         response: string;
         completedAt: string;
         status?: 'completed' | 'failed';
@@ -508,35 +501,47 @@ export declare class DialogPersistence {
         originMemberId: string;
         callId: string;
     }>>;
-    static commitTakenSubdialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
-    static rollbackTakenSubdialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
+    static commitTakenSideDialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
+    static rollbackTakenSideDialogResponses(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
     /**
-     * Save root dialog metadata (write-once pattern)
+     * Save main dialog metadata (write-once pattern)
      */
-    static saveRootDialogMetadata(dialogId: DialogID, metadata: RootDialogMetadataFile, status?: DialogStatusKind): Promise<void>;
+    static saveMainDialogMetadata(dialogId: DialogID, metadata: MainDialogMetadataFile, status?: DialogStatusKind): Promise<void>;
     /**
      * Save dialog metadata (universal - works with any DialogID)
      */
     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?: DialogStatusKind): Promise<void>;
-    /**
-     * Save subdialog metadata under the supdialog's .subdialogs directory
+     * Save sideDialog metadata under the root dialog's sideDialogs directory.
      */
-    static saveSubdialogMetadata(dialogId: DialogID, metadata: SubdialogMetadataFile, status?: DialogStatusKind): Promise<void>;
+    static saveSideDialogMetadata(dialogId: DialogID, metadata: SideDialogMetadataFile, status?: DialogStatusKind): Promise<void>;
+    static saveSideDialogAskerStackState(dialogId: DialogID, state: DialogAskerStackState, status?: DialogStatusKind): Promise<void>;
+    static loadSideDialogAskerStackState(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogAskerStackState | null>;
+    static loadSideDialogAssignmentFromAsker(dialogId: DialogID, status?: DialogStatusKind): Promise<SideDialogAssignmentFromAsker>;
+    private static parseDialogAskerStackJsonlRows;
+    private static appendDialogAskerStackFrames;
+    static saveDialogAskerStack(dialogId: DialogID, state: DialogAskerStackState, status?: DialogStatusKind): Promise<void>;
+    static loadDialogAskerStack(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogAskerStackState>;
+    private static loadDialogAskerStackRows;
+    private static truncateDialogAskerStackToDepth;
+    private static replaceDialogAskerStackFrameAndAppend;
+    static pushTellaskReplyObligation(dialogId: DialogID, obligation: TellaskReplyDirective, status?: DialogStatusKind): Promise<void>;
+    static setActiveTellaskReplyObligation(dialogId: DialogID, obligation: TellaskReplyDirective | undefined, status?: DialogStatusKind): Promise<void>;
+    static loadActiveTellaskReplyObligation(dialogId: DialogID, status?: DialogStatusKind): Promise<TellaskReplyDirective | undefined>;
+    private static requireSideDialogAskerStackState;
     /**
-     * Update assignmentFromSup for an existing subdialog.
+     * Update assignmentFromAsker for an existing sideDialog.
      */
-    static updateSubdialogAssignment(dialogId: DialogID, assignment: SubdialogMetadataFile['assignmentFromSup'], status?: DialogStatusKind): Promise<void>;
+    static updateSideDialogAssignment(dialogId: DialogID, assignment: SideDialogAssignmentFromAsker, status?: DialogStatusKind, options?: Readonly<{
+        replacePendingCallId?: string;
+        replacePendingAskerDialogId?: string;
+    }>): Promise<void>;
     /**
-     * Load root dialog metadata
+     * Load main dialog metadata
      */
-    static loadRootDialogMetadata(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogMetadataFile | null>;
+    static loadMainDialogMetadata(dialogId: DialogID, status?: DialogStatusKind): Promise<MainDialogMetadataFile | null>;
     /**
-     * Load dialog metadata (universal - works with any DialogID)
+     * Load dialog metadata from the path implied by the DialogID.
      */
     static loadDialogMetadata(dialogId: DialogID, status?: DialogStatusKind): Promise<DialogMetadataFile | null>;
     /**
@@ -558,7 +563,7 @@ 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?: DialogStatusKind, cancellationToken?: RootDialogWriteBackCancellationToken): Promise<DialogLatestFile>;
+    static mutateDialogLatest(dialogId: DialogID, mutator: (previous: DialogLatestFile) => DialogLatestMutation, status?: DialogStatusKind, cancellationToken?: MainDialogWriteBackCancellationToken): Promise<DialogLatestFile>;
     private static loadDialogLatestFromDisk;
     private static flushLatestWriteBack;
     static setNeedsDrive(dialogId: DialogID, needsDrive: boolean, status?: DialogStatusKind): Promise<void>;
@@ -580,13 +585,13 @@ export declare class DialogPersistence {
     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)
+     * Count sideDialogs under a main dialog (no single-layer listing exposed)
      */
-    static countAllSubdialogsUnderRoot(rootDialogId: DialogID, status?: DialogStatusKind): Promise<number>;
+    static countAllSideDialogsUnderRoot(mainDialogId: DialogID, status?: DialogStatusKind): Promise<number>;
     /**
      * Restore complete dialog tree from disk
      */
-    static restoreDialogTree(rootDialogId: DialogID, status?: DialogStatusKind): Promise<DialogPersistenceState | null>;
+    static restoreDialogTree(mainDialogId: 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
@@ -608,25 +613,25 @@ export declare class DialogPersistence {
      */
     static moveDialogStatus(dialogId: DialogID, fromStatus: DialogStatusKind, toStatus: DialogStatusKind): Promise<void>;
     /**
-     * Delete a root dialog directory (including subdialogs) from disk.
+     * Delete a main dialog directory (including sideDialogs) from disk.
      * Caller must provide the source status explicitly.
      */
-    static deleteRootDialog(rootDialogId: DialogID, fromStatus: DialogStatusKind): Promise<boolean>;
+    static deleteMainDialog(mainDialogId: DialogID, fromStatus: DialogStatusKind): Promise<boolean>;
     /**
-     * Save subdialog registry (TYPE B entries).
+     * Save sideDialog registry (TYPE B entries).
      */
-    static saveSubdialogRegistry(rootDialogId: DialogID, entries: Array<{
+    static saveSideDialogRegistry(mainDialogId: DialogID, entries: Array<{
         key: string;
-        subdialogId: DialogID;
+        sideDialogId: DialogID;
         agentId: string;
         sessionSlug?: string;
     }>, status?: DialogStatusKind): Promise<void>;
     /**
-     * Load subdialog registry.
+     * Load sideDialog registry.
      */
-    static loadSubdialogRegistry(rootDialogId: DialogID, status?: DialogStatusKind): Promise<Array<{
+    static loadSideDialogRegistry(mainDialogId: DialogID, status?: DialogStatusKind): Promise<Array<{
         key: string;
-        subdialogId: DialogID;
+        sideDialogId: DialogID;
         agentId: string;
         sessionSlug?: string;
     }>>;