dominds 1.25.3 → 1.25.4

package/dist/persistence.d.ts

@@ -8,7 +8,7 @@ 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 { ActiveCalleeDispatchRecord, ActiveCalleesFile, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogCourseNumber, DialogLatestFile, DialogMetadataFile, DialogNextStepTrigger, DialogNextStepTriggerDraft, DialogTellaskCallState, HumanQuestion, HumanTextRecord, MainDialogMetadataFile, PersistedDialogRecord, ProviderData, ReasoningPayload, ReconciledRecordWriteTarget, RootGenerationAnchor, SideDialogAssignmentFromAsker, SideDialogMetadataFile, SideDialogRegistryStateRecord, SideDialogResponseStateRecord, TellaskCallRecord, TellaskReplyDirective, TellaskResultRecord } from '@longrun-ai/kernel/types/storage';
+import type { ActiveCalleeDispatchRecord, ActiveCalleesFile, AnswerToHumanItem, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogCourseNumber, DialogLatestFile, DialogMetadataFile, DialogNextStepTrigger, DialogNextStepTriggerDraft, DialogTellaskCallState, HumanQuestion, HumanTextRecord, MainDialogMetadataFile, PersistedDialogRecord, ProviderData, ReasoningPayload, ReconciledRecordWriteTarget, RootGenerationAnchor, SideDialogAssignmentFromAsker, SideDialogMetadataFile, SideDialogRegistryStateRecord, SideDialogResponseStateRecord, TellaskCallRecord, TellaskReplyDirective, TellaskResultRecord } from '@longrun-ai/kernel/types/storage';
 import type { DialogsQuarantinedMessage, DialogStatusKind } from '@longrun-ai/kernel/types/wire';
 import { WebSocket } from 'ws';
 import type { ActiveCalleeDispatch } from './dialog';
@@ -238,6 +238,25 @@ type Q4HMutateOutcome = {
     questions: HumanQuestion[];
     removedQuestion?: HumanQuestion;
 };
+type A2HMutation = {
+    kind: 'noop';
+} | {
+    kind: 'append';
+    answer: AnswerToHumanItem;
+} | {
+    kind: 'remove';
+    answerId: string;
+} | {
+    kind: 'replace';
+    answers: AnswerToHumanItem[];
+} | {
+    kind: 'clear';
+};
+type A2HMutateOutcome = {
+    previousAnswers: AnswerToHumanItem[];
+    answers: AnswerToHumanItem[];
+    removedAnswer?: AnswerToHumanItem;
+};
 type ActiveCalleeResolveOutcome = Readonly<{
     batchId: string;
     callSiteCourse: CallSiteCourseNo;
@@ -338,10 +357,13 @@ export declare class DialogPersistence {
     private static readonly quarantinedMainDialogScopes;
     private static readonly LATEST_WRITEBACK_WINDOW_MS;
     private static readonly Q4H_WRITEBACK_WINDOW_MS;
+    private static readonly A2H_WRITEBACK_WINDOW_MS;
     private static readonly latestWriteBackMutexes;
     private static readonly latestWriteBack;
     private static readonly q4hWriteBackMutexes;
     private static readonly q4hWriteBack;
+    private static readonly a2hWriteBackMutexes;
+    private static readonly a2hWriteBack;
     private static readonly activeCalleesMutexes;
     private static readonly wakeQueueMutexes;
     private static readonly backendDriveStallMutexes;
@@ -349,6 +371,7 @@ export declare class DialogPersistence {
     private static readonly mainDialogWriteBackCancelGenerations;
     private static getLatestWriteBackMutex;
     private static getQ4HWriteBackMutex;
+    private static getA2HWriteBackMutex;
     private static getCourseAppendMutex;
     private static getCourseAppendMutexKey;
     private static getActiveCalleesMutex;
@@ -358,6 +381,7 @@ export declare class DialogPersistence {
     private static getWakeQueueKey;
     private static getBackendDriveStallKey;
     private static getQ4HWriteBackKey;
+    private static getA2HWriteBackKey;
     private static getActiveCalleesKey;
     private static getMainDialogWriteBackCancelScopeKey;
     private static createMainDialogWriteBackCancellationToken;
@@ -490,8 +514,19 @@ export declare class DialogPersistence {
         remainingQuestions: HumanQuestion[];
         removedQuestion?: HumanQuestion;
     }>;
+    static loadAnswersToHumanState(dialogId: DialogID, status?: DialogStatusKind): Promise<AnswerToHumanItem[]>;
+    private static loadAnswersToHumanStateFromDisk;
+    static mutateAnswersToHumanState(dialogId: DialogID, mutator: (previous: AnswerToHumanItem[]) => A2HMutation, status?: DialogStatusKind): Promise<A2HMutateOutcome>;
+    static appendAnswerToHumanState(dialogId: DialogID, answer: AnswerToHumanItem, status?: DialogStatusKind): Promise<void>;
+    static acknowledgeAnswerToHumanState(dialogId: DialogID, answerId: string, status?: DialogStatusKind): Promise<{
+        found: boolean;
+        remainingAnswers: AnswerToHumanItem[];
+        removedAnswer?: AnswerToHumanItem;
+    }>;
     private static flushQ4HWriteBack;
     private static writeQ4HStateToDisk;
+    private static flushA2HWriteBack;
+    private static writeA2HStateToDisk;
     /**
      * Load all Q4H questions from all running dialogs (for global Q4H display)
      * Returns array of questions with their dialog context for frontend display
@@ -510,6 +545,12 @@ export declare class DialogPersistence {
             messageIndex: number;
         };
     }>>;
+    static loadAllA2HState(): Promise<Array<AnswerToHumanItem & {
+        selfId: string;
+        rootId: string;
+        agentId: string;
+        taskDocPath: string;
+    }>>;
     static clearQuestions4HumanState(dialogId: DialogID, status?: DialogStatusKind): Promise<void>;
     /**
      * Load active callee dispatches projected from active-callees.json.
@@ -702,6 +743,14 @@ export declare class DialogPersistence {
      * Load specific course events for UI navigation (on-demand)
      */
     static loadCourseEvents(dialogId: DialogID, course: number, status?: DialogStatusKind): Promise<PersistedDialogRecord[]>;
+    static resolvePendingUserInterjectionReplyFromCourseEvents(events: readonly PersistedDialogRecord[], course: number): DialogLatestFile['pendingUserInterjectionReply'];
+    static resolveAnsweredUserInterjectionA2HFromCourseEvents(args: {
+        dialogId: DialogID;
+        events: readonly PersistedDialogRecord[];
+        course: number;
+        pending: DialogLatestFile['pendingUserInterjectionReply'];
+    }): AnswerToHumanItem | undefined;
+    private static normalizeDialogLatestPendingUserInterjectionReply;
     /**
      * Reconstruct dialog state from JSONL events (optimized: only latest course needed).
      */