dominds 1.23.10 → 1.24.2

package/dist/dialog.d.ts

@@ -14,9 +14,9 @@
  */
 import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-health';
 import type { DialogEvent, NativeToolCallPayload, ReminderContent, WebSearchCallAction, WebSearchCallSource } from '@longrun-ai/kernel/types/dialog';
-import type { DialogQueuedDeferredQ4HAnswerState, DialogQueuedPromptState, DialogQueuedUserGenerationBoundaryState, DialogRunControlSpec, DialogRuntimePrompt, DialogSideDialogReplyTarget, DialogUserPrompt, DriveIntent } from '@longrun-ai/kernel/types/drive-intent';
+import type { DialogCalleeReplyTarget, DialogQueuedDeferredQ4HAnswerState, DialogQueuedPromptState, DialogQueuedUserGenerationBoundaryState, DialogRunControlSpec, DialogRuntimePrompt, DialogUserPrompt, DriveIntent } from '@longrun-ai/kernel/types/drive-intent';
 import type { LanguageCode } from '@longrun-ai/kernel/types/language';
-import type { CalleeCourseNumber, CalleeGenerationSeqNumber, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
+import type { ActiveCalleesFile, CalleeCourseNumber, CalleeGenerationSeqNumber, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogLatestFile, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
 import { ChatMessage, FuncResultMsg, TellaskCarryoverMsg, TellaskResultMsg } from './llm/client';
 import type { ToolResultImageIngest, UserImageIngest } from './llm/gen';
 import type { JsonValue } from './tool';
@@ -38,9 +38,6 @@ type NewCourseHook = (args: {
     prompt: DialogRuntimePrompt;
     runControl?: DialogRunControlSpec;
 }) => Promise<NewCourseHookResult>;
-export type DialogSuspensionStatusOptions = Readonly<{
-    allowPendingSideDialogs?: boolean;
-}>;
 export declare class DialogID {
     readonly selfId: string;
     readonly rootId: string;
@@ -61,11 +58,11 @@ export declare class DialogID {
     hashCode(): string;
 }
 /**
- * Phase 6: Pending sideDialog record for Type A sideDialog supply mechanism.
- * Tracks a sideDialog that was created but not yet completed.
+ * Phase 6: Active callee dispatch record.
+ * Tracks a sideDialog that has been dispatched but not yet completed.
  */
-export interface PendingSideDialog {
-    sideDialogId: DialogID;
+export interface ActiveCalleeDispatch {
+    calleeDialogId: DialogID;
     createdAt: string;
     mentionList?: string[];
     tellaskContent: string;
@@ -86,6 +83,7 @@ export interface SideDialogResponse {
     completedAt: string;
     callType: 'A' | 'B' | 'C';
 }
+export declare function scheduleGlobalDialogMutexCleanupForRoot(rootId: string): void;
 /**
  * Common dialog initialization parameters (shared between MainDialog and SideDialog)
  */
@@ -99,7 +97,7 @@ export interface DialogInitParams {
         createdAt?: string;
         updatedAt?: string;
         contextHealth?: ContextHealthSnapshot;
-        pendingCourseStartPrompt?: DialogRuntimePrompt;
+        pendingRuntimePrompt?: DialogRuntimePrompt;
     };
 }
 export type VisibleReminderTarget = Readonly<{
@@ -161,7 +159,7 @@ export declare abstract class Dialog {
     protected _courseRuntimeNoticeMsgs: ChatMessage[];
     protected _generationStarted: boolean;
     protected _generationStartedGenseq: number;
-    protected _pendingSideDialogIds: DialogID[];
+    protected _activeCalleeDialogIds: DialogID[];
     protected _suspensionState: 'active' | 'suspended' | 'resumed';
     diligencePushRemainingBudget: number;
     disableDiligencePush: boolean;
@@ -217,35 +215,36 @@ export declare abstract class Dialog {
     isLocked(): boolean;
     /**
      * Check if dialog has pending Q4H questions.
-     * Queries persistence for current questions4Human state.
+     * Reads the dialog latest user-wait state; q4h.yaml remains the detailed question payload store.
      */
     hasPendingQ4H(): Promise<boolean>;
     /**
-     * Check if dialog has pending sideDialogs.
+     * Check if dialog has active callee dispatches.
      */
-    hasPendingSideDialogs(): Promise<boolean>;
+    hasActiveCalleeDispatches(): Promise<boolean>;
     /**
-     * Check if dialog can be driven (not suspended for Q4H or sideDialogs).
+     * Check if dialog can be driven.
+     *
+     * Active callee dispatches are background callee work: they are observable, but they must not
+     * block the caller dialog from continuing when some other concrete drive source exists.
      */
-    canDrive(options?: DialogSuspensionStatusOptions): Promise<boolean>;
+    canDrive(): Promise<boolean>;
     /**
      * Get suspension status for logging/debugging.
      */
-    getSuspensionStatus(options?: DialogSuspensionStatusOptions): Promise<{
+    getSuspensionStatus(): Promise<{
         q4h: boolean;
-        sideDialogs: boolean;
-        blockingSideDialogs: boolean;
+        backgroundCalleeDialogs: boolean;
         canDrive: boolean;
     }>;
-    get pendingSideDialogIds(): ReadonlyArray<DialogID>;
-    addPendingSideDialogs(ids: DialogID[]): void;
-    removePendingSideDialog(id: DialogID): void;
-    clearPendingSideDialogs(): void;
+    get activeCalleeDialogIds(): ReadonlyArray<DialogID>;
+    addActiveCalleeDialogs(ids: DialogID[]): void;
+    removeActiveCalleeDispatch(id: DialogID): void;
+    clearActiveCalleeDialogs(): void;
     /**
-     * Load pending sideDialogs from persistence into memory.
-     * Used during crash recovery to restore suspension state.
+     * Load active callee dispatches from persistence into memory.
      */
-    loadPendingSideDialogsFromPersistence(): Promise<void>;
+    loadActiveCalleeDispatchesFromPersistence(): Promise<void>;
     /**
      * Abstract method for creating sideDialogs.
      * Implemented by MainDialog to create SideDialog instances.
@@ -325,7 +324,7 @@ export declare abstract class Dialog {
     get createdAt(): string;
     get updatedAt(): string;
     private replaceQueuedPromptState;
-    private setNewCourseStartPrompt;
+    private setPendingRuntimePrompt;
     private mergePromptQ4HAnswerCallId;
     private enqueueQueuedPromptState;
     private peekLatestUpNext;
@@ -352,7 +351,7 @@ export declare abstract class Dialog {
         userLanguageCode?: LanguageCode;
         tellaskReplyDirective: TellaskReplyDirective;
         skipTaskdoc?: boolean;
-        sideDialogReplyTarget: DialogSideDialogReplyTarget;
+        calleeDialogReplyTarget: DialogCalleeReplyTarget;
     }): DialogQueuedPromptState;
     private persistPendingRuntimePrompt;
     private runtimePromptCommon;
@@ -371,7 +370,7 @@ export declare abstract class Dialog {
         userLanguageCode?: LanguageCode;
         tellaskReplyDirective: TellaskReplyDirective;
         skipTaskdoc?: boolean;
-        sideDialogReplyTarget: DialogSideDialogReplyTarget;
+        calleeDialogReplyTarget: DialogCalleeReplyTarget;
     }): Promise<DialogQueuedPromptState>;
     hasUpNext(): boolean;
     peekUpNext(): DialogQueuedPromptState | undefined;
@@ -623,9 +622,11 @@ export declare abstract class DialogStore {
      * Load Questions for Human state from storage
      */
     loadQuestions4Human(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<HumanQuestion[]>;
+    loadDialogLatest(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<DialogLatestFile | null>;
     loadDialogMetadata(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<DialogMetadataFile | null>;
     loadSideDialogAssignmentFromAsker(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<AssignmentFromAsker | null>;
-    loadPendingSideDialogs(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<PendingSideDialog[]>;
+    loadActiveCalleeDispatches(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<ActiveCalleeDispatch[]>;
+    loadActiveCallees(_dialogId: DialogID, _status: 'running' | 'completed' | 'archived'): Promise<ActiveCalleesFile>;
     saveSideDialogRegistry(_dialog: MainDialog, _mainDialogId: DialogID, _entries: Array<{
         key: string;
         sideDialogId: DialogID;

package/dist/dialog.js

@@ -1,6 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DialogStore = exports.MainDialog = exports.SideDialog = exports.Dialog = exports.DialogID = exports.InvalidReminderIndexError = void 0;
+exports.scheduleGlobalDialogMutexCleanupForRoot = scheduleGlobalDialogMutexCleanupForRoot;
 exports.buildSideDialogAskerStack = buildSideDialogAskerStack;
 const id_1 = require("@longrun-ai/kernel/utils/id");
 const time_1 = require("@longrun-ai/kernel/utils/time");
@@ -14,6 +48,10 @@ const work_language_1 = require("./runtime/work-language");
 const shared_reminders_1 = require("./shared-reminders");
 const tool_1 = require("./tool");
 const id_2 = require("./utils/id");
+async function wakeRootDialogDrive(rootId, meta) {
+    const { globalDialogRegistry } = await Promise.resolve().then(() => __importStar(require('./dialog-global-registry')));
+    globalDialogRegistry.wakeDrive(rootId, meta);
+}
 class InvalidReminderIndexError extends Error {
     constructor(index, total) {
         super(`Reminder target index ${index} is stale; current reminder count is ${total}`);
@@ -65,6 +103,7 @@ class DialogID {
 }
 exports.DialogID = DialogID;
 const globalDialogMutexes = new Map();
+const pendingGlobalDialogMutexCleanupRootIds = new Set();
 function getGlobalDialogMutex(dialogId) {
     const key = dialogId.key();
     const existing = globalDialogMutexes.get(key);
@@ -74,6 +113,36 @@ function getGlobalDialogMutex(dialogId) {
     globalDialogMutexes.set(key, created);
     return created;
 }
+function clearIdleGlobalDialogMutexesForRoot(rootId) {
+    const sideDialogPrefix = `${rootId}#`;
+    let hasRemainingMutex = false;
+    for (const [key, mutex] of globalDialogMutexes.entries()) {
+        if (key !== rootId && !key.startsWith(sideDialogPrefix)) {
+            continue;
+        }
+        if (!mutex.isLocked()) {
+            globalDialogMutexes.delete(key);
+        }
+        else {
+            hasRemainingMutex = true;
+        }
+    }
+    return hasRemainingMutex;
+}
+function scheduleGlobalDialogMutexCleanupForRoot(rootId) {
+    pendingGlobalDialogMutexCleanupRootIds.add(rootId);
+    if (!clearIdleGlobalDialogMutexesForRoot(rootId)) {
+        pendingGlobalDialogMutexCleanupRootIds.delete(rootId);
+    }
+}
+function cleanupPendingGlobalDialogMutexesForRoot(rootId) {
+    if (!pendingGlobalDialogMutexCleanupRootIds.has(rootId)) {
+        return;
+    }
+    if (!clearIdleGlobalDialogMutexesForRoot(rootId)) {
+        pendingGlobalDialogMutexCleanupRootIds.delete(rootId);
+    }
+}
 function compareVisibleReminderTargetOrder(a, b) {
     return (0, tool_1.compareReminderDisplayOrder)(a.reminder, b.reminder);
 }
@@ -122,8 +191,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     targetCallId: assignment.callId,
                     tellaskContent: assignment.tellaskContent,
                 },
-                sideDialogReplyTarget: {
-                    ownerDialogId: assignment.askerDialogId,
+                calleeDialogReplyTarget: {
+                    callerDialogId: assignment.askerDialogId,
                     callType: 'B',
                     callId: assignment.callId,
                     callSiteCourse: assignment.callSiteCourse,
@@ -139,8 +208,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     targetCallId: assignment.callId,
                     tellaskContent: assignment.tellaskContent,
                 },
-                sideDialogReplyTarget: {
-                    ownerDialogId: assignment.askerDialogId,
+                calleeDialogReplyTarget: {
+                    callerDialogId: assignment.askerDialogId,
                     callType: 'C',
                     callId: assignment.callId,
                     callSiteCourse: assignment.callSiteCourse,
@@ -175,7 +244,7 @@ class Dialog {
         // Used to ensure proper ordering when multiple generations occur
         this._generationStartedGenseq = 0;
         // Pending sideDialog IDs (for auto-revive tracking)
-        this._pendingSideDialogIds = [];
+        this._activeCalleeDialogIds = [];
         // Phase 11: Suspension state for Type A sideDialog mechanism
         // Tracks whether this dialog is in normal state, suspended, or resuming from suspension
         this._suspensionState = 'active';
@@ -214,8 +283,8 @@ class Dialog {
         this._lastUserLanguageCode = (0, work_language_1.getWorkLanguage)();
         this._lastContextHealth = initialState?.contextHealth;
         this._lastContextHealthGenseq = undefined;
-        if (initialState?.pendingCourseStartPrompt) {
-            this.setNewCourseStartPrompt(initialState.pendingCourseStartPrompt);
+        if (initialState?.pendingRuntimePrompt) {
+            this.setPendingRuntimePrompt(initialState.pendingRuntimePrompt);
         }
         this.resetCourseLanguageNotice();
     }
@@ -303,7 +372,11 @@ class Dialog {
      * FIFO queue ensures fairness when multiple callers wait.
      */
     async acquire() {
-        return await this._mutex.acquire();
+        const release = await this._mutex.acquire();
+        return () => {
+            release();
+            cleanupPendingGlobalDialogMutexesForRoot(this.id.rootId);
+        };
     }
     /**
      * Run an async function while holding the dialog mutex.
@@ -326,31 +399,30 @@ class Dialog {
     }
     /**
      * Check if dialog has pending Q4H questions.
-     * Queries persistence for current questions4Human state.
+     * Reads the dialog latest user-wait state; q4h.yaml remains the detailed question payload store.
      */
     async hasPendingQ4H() {
         try {
-            const questions = await this.dlgStore.loadQuestions4Human(this.id, this.status);
-            return questions.length > 0;
+            const latest = await this.dlgStore.loadDialogLatest(this.id, this.status);
+            return latest?.userWait?.kind === 'awaiting_user_answer';
         }
         catch (err) {
-            log_1.log.warn('Failed to load Q4H state for pending check', undefined, {
+            log_1.log.error('Failed to load Q4H state for pending check', err, {
                 dialogId: this.id.selfId,
-                error: err,
             });
-            return true;
+            throw err;
         }
     }
     /**
-     * Check if dialog has pending sideDialogs.
+     * Check if dialog has active callee dispatches.
      */
-    async hasPendingSideDialogs() {
+    async hasActiveCalleeDispatches() {
         try {
-            const pending = await this.dlgStore.loadPendingSideDialogs(this.id, this.status);
-            return pending.length > 0;
+            const activeCallees = await this.dlgStore.loadActiveCallees(this.id, this.status);
+            return activeCallees.batches.some((batch) => batch.callees.some((callee) => callee.status === 'pending'));
         }
         catch (err) {
-            log_1.log.warn('Failed to load pending sideDialogs for pending check', undefined, {
+            log_1.log.warn('Failed to load active callees for dispatch check', undefined, {
                 dialogId: this.id.selfId,
                 error: err,
             });
@@ -358,50 +430,50 @@ class Dialog {
         }
     }
     /**
-     * Check if dialog can be driven (not suspended for Q4H or sideDialogs).
+     * Check if dialog can be driven.
+     *
+     * Active callee dispatches are background callee work: they are observable, but they must not
+     * block the caller dialog from continuing when some other concrete drive source exists.
      */
-    async canDrive(options) {
-        const suspension = await this.getSuspensionStatus(options);
+    async canDrive() {
+        const suspension = await this.getSuspensionStatus();
         return suspension.canDrive;
     }
     /**
      * Get suspension status for logging/debugging.
      */
-    async getSuspensionStatus(options) {
+    async getSuspensionStatus() {
         const hasQ4H = await this.hasPendingQ4H();
-        const hasSideDialogs = await this.hasPendingSideDialogs();
-        const blockingSideDialogs = hasSideDialogs && options?.allowPendingSideDialogs !== true;
+        const hasBackgroundCalleeDialogs = await this.hasActiveCalleeDispatches();
         return {
             q4h: hasQ4H,
-            sideDialogs: hasSideDialogs,
-            blockingSideDialogs,
-            canDrive: !hasQ4H && !blockingSideDialogs,
+            backgroundCalleeDialogs: hasBackgroundCalleeDialogs,
+            canDrive: !hasQ4H,
         };
     }
-    get pendingSideDialogIds() {
-        return this._pendingSideDialogIds;
+    get activeCalleeDialogIds() {
+        return this._activeCalleeDialogIds;
     }
-    addPendingSideDialogs(ids) {
-        this._pendingSideDialogIds.push(...ids);
+    addActiveCalleeDialogs(ids) {
+        this._activeCalleeDialogIds.push(...ids);
     }
-    removePendingSideDialog(id) {
-        this._pendingSideDialogIds = this._pendingSideDialogIds.filter((pending) => pending.selfId !== id.selfId);
+    removeActiveCalleeDispatch(id) {
+        this._activeCalleeDialogIds = this._activeCalleeDialogIds.filter((activeCallee) => activeCallee.selfId !== id.selfId);
     }
-    clearPendingSideDialogs() {
-        this._pendingSideDialogIds = [];
+    clearActiveCalleeDialogs() {
+        this._activeCalleeDialogIds = [];
     }
     /**
-     * Load pending sideDialogs from persistence into memory.
-     * Used during crash recovery to restore suspension state.
+     * Load active callee dispatches from persistence into memory.
      */
-    async loadPendingSideDialogsFromPersistence() {
+    async loadActiveCalleeDispatchesFromPersistence() {
         try {
-            const pending = await this.dlgStore.loadPendingSideDialogs(this.id, this.status);
-            this.clearPendingSideDialogs();
-            this.addPendingSideDialogs(pending.map((record) => record.sideDialogId));
+            const activeCalleeDispatches = await this.dlgStore.loadActiveCalleeDispatches(this.id, this.status);
+            this.clearActiveCalleeDialogs();
+            this.addActiveCalleeDialogs(activeCalleeDispatches.map((record) => record.calleeDialogId));
         }
         catch (err) {
-            log_1.log.warn('Failed to load pending sideDialogs from persistence', undefined, {
+            log_1.log.warn('Failed to load active callee dispatches from persistence', undefined, {
                 dialogId: this.id.selfId,
                 error: err,
             });
@@ -723,7 +795,7 @@ class Dialog {
                                     ? {}
                                     : { skipTaskdoc: nextPrompt.skipTaskdoc }),
                                 tellaskReplyDirective: nextPrompt.tellaskReplyDirective,
-                                sideDialogReplyTarget: nextPrompt.sideDialogReplyTarget,
+                                calleeDialogReplyTarget: nextPrompt.calleeDialogReplyTarget,
                             };
                             return prompt;
                         }
@@ -760,7 +832,7 @@ class Dialog {
         }
         throw new Error(`UpNext prompt replacement invariant violation: missing drive intent dialog=${this.id.valueOf()} existingMsgId=${existingMsgId}`);
     }
-    setNewCourseStartPrompt(prompt) {
+    setPendingRuntimePrompt(prompt) {
         const prepared = typeof prompt === 'string'
             ? {
                 content: prompt,
@@ -782,12 +854,12 @@ class Dialog {
             origin: 'runtime',
             ...(prepared.skipTaskdoc === undefined ? {} : { skipTaskdoc: prepared.skipTaskdoc }),
         };
-        const normalized = prepared.sideDialogReplyTarget !== undefined
+        const normalized = prepared.calleeDialogReplyTarget !== undefined
             ? (() => {
                 const prompt = {
                     ...runtimeCommon,
                     tellaskReplyDirective: prepared.tellaskReplyDirective,
-                    sideDialogReplyTarget: prepared.sideDialogReplyTarget,
+                    calleeDialogReplyTarget: prepared.calleeDialogReplyTarget,
                 };
                 return prompt;
             })()
@@ -804,7 +876,7 @@ class Dialog {
                     return prompt;
                 })();
         this._upNextQueue = [
-            normalized.sideDialogReplyTarget !== undefined
+            normalized.calleeDialogReplyTarget !== undefined
                 ? {
                     kind: 'new_course_runtime_sideDialog',
                     prompt: normalized.content,
@@ -814,7 +886,7 @@ class Dialog {
                     origin: 'runtime',
                     tellaskReplyDirective: normalized.tellaskReplyDirective,
                     skipTaskdoc: normalized.skipTaskdoc,
-                    sideDialogReplyTarget: normalized.sideDialogReplyTarget,
+                    calleeDialogReplyTarget: normalized.calleeDialogReplyTarget,
                 }
                 : normalized.tellaskReplyDirective !== undefined
                     ? {
@@ -885,7 +957,7 @@ class Dialog {
                             origin: 'runtime',
                             ...(state.skipTaskdoc === undefined ? {} : { skipTaskdoc: state.skipTaskdoc }),
                             tellaskReplyDirective: state.tellaskReplyDirective,
-                            sideDialogReplyTarget: state.sideDialogReplyTarget,
+                            calleeDialogReplyTarget: state.calleeDialogReplyTarget,
                         };
                         return prompt;
                     }
@@ -997,7 +1069,7 @@ class Dialog {
                 origin: 'runtime',
                 tellaskReplyDirective: options.tellaskReplyDirective,
                 skipTaskdoc: options.skipTaskdoc,
-                sideDialogReplyTarget: options.sideDialogReplyTarget,
+                calleeDialogReplyTarget: options.calleeDialogReplyTarget,
                 runControl: undefined,
             };
             this.enqueueQueuedPromptState(created);
@@ -1011,7 +1083,7 @@ class Dialog {
             userLanguageCode: options.userLanguageCode ?? existing.userLanguageCode ?? this._lastUserLanguageCode,
             tellaskReplyDirective: options.tellaskReplyDirective,
             skipTaskdoc: options.skipTaskdoc ?? existing.skipTaskdoc,
-            sideDialogReplyTarget: options.sideDialogReplyTarget,
+            calleeDialogReplyTarget: options.calleeDialogReplyTarget,
             runControl: undefined,
         };
         this.replaceQueuedPromptState(existing.msgId, merged);
@@ -1020,6 +1092,12 @@ class Dialog {
     }
     async persistPendingRuntimePrompt(prompt) {
         await this.dlgStore.persistPendingRuntimePrompt(this, prompt);
+        if (this.id.selfId === this.id.rootId) {
+            await wakeRootDialogDrive(this.id.rootId, {
+                source: 'dialog_runtime_prompt',
+                reason: `queued_runtime_prompt:${prompt.msgId}`,
+            });
+        }
     }
     runtimePromptCommon(options) {
         const trimmed = options.prompt.trim();
@@ -1062,7 +1140,7 @@ class Dialog {
             kind: 'new_course_runtime_sideDialog',
             tellaskReplyDirective: options.tellaskReplyDirective,
             skipTaskdoc: options.skipTaskdoc,
-            sideDialogReplyTarget: options.sideDialogReplyTarget,
+            calleeDialogReplyTarget: options.calleeDialogReplyTarget,
         };
         this.enqueueQueuedPromptState(created);
         await this.persistPendingRuntimePrompt({
@@ -1073,7 +1151,7 @@ class Dialog {
             origin: 'runtime',
             tellaskReplyDirective: created.tellaskReplyDirective,
             skipTaskdoc: created.skipTaskdoc,
-            sideDialogReplyTarget: created.sideDialogReplyTarget,
+            calleeDialogReplyTarget: created.calleeDialogReplyTarget,
         });
         return created;
     }
@@ -1165,13 +1243,19 @@ class Dialog {
         if (this.dlgStore) {
             await this.dlgStore.startNewCourse(this, nextPrompt);
         }
+        if (this.id.selfId === this.id.rootId) {
+            await wakeRootDialogDrive(this.id.rootId, {
+                source: 'dialog_start_new_course',
+                reason: `queued_runtime_prompt:${nextPrompt.msgId}`,
+            });
+        }
         const storeCourse = this.dlgStore
             ? await this.dlgStore.loadCurrentCourse(this.id)
             : this._currentCourse + 1;
         this._currentCourse = storeCourse;
         this._updatedAt = (0, time_1.formatUnifiedTimestamp)(new Date());
         this.resetCourseLanguageNotice();
-        const normalized = this.setNewCourseStartPrompt(nextPrompt);
+        const normalized = this.setPendingRuntimePrompt(nextPrompt);
         if (options?.skipEnqueueIntent !== true) {
             this._driveIntents.length = 0;
             this._driveIntents.push({
@@ -1900,15 +1984,21 @@ class DialogStore {
     async loadQuestions4Human(_dialogId, _status) {
         return [];
     }
+    async loadDialogLatest(_dialogId, _status) {
+        return null;
+    }
     async loadDialogMetadata(_dialogId, _status) {
         return null;
     }
     async loadSideDialogAssignmentFromAsker(_dialogId, _status) {
         return null;
     }
-    async loadPendingSideDialogs(_dialogId, _status) {
+    async loadActiveCalleeDispatches(_dialogId, _status) {
         return [];
     }
+    async loadActiveCallees(_dialogId, _status) {
+        return { batches: [] };
+    }
     async saveSideDialogRegistry(_dialog, _mainDialogId, _entries, _status) { }
     async loadSideDialogRegistry(_mainDialog, _status) { }
     /**

package/dist/docs/agent-priming.md

@@ -20,7 +20,7 @@ reminder snapshot.
   - transcript / tool / tellask history records
   - current reminder snapshot
 - Explicitly dropped:
-  - pending sideDialogs
+  - active callee dispatches
   - questions4human
   - sideDialog registry / sideDialog responses
   - other runtime-only waiting / blocking / orchestration state

package/dist/docs/agent-priming.zh.md

@@ -19,7 +19,7 @@
   - transcript / tool / tellask 等历史 record
   - 当前 reminder 快照
 - 会明确丢弃：
-  - pending sideDialogs
+  - active callee dispatches
   - questions4human
   - sideDialog registry / sideDialog responses
   - 其它依赖运行中协程、阻塞关系、等待关系的 runtime state

package/dist/docs/app-constitution.md

@@ -380,7 +380,7 @@ So `Web Dev App` should make the `playwright-interactive` relationship explicit
 It must be explicit that **an app is not the same thing as a skill**, and that both are now first-class mechanisms in the current implementation:
 
 - An **app** is a Dominds install/resolve/composition unit. It has an `id`, a manifest (`.minds/app.yaml`), team-facing assets (`.minds/team.yaml`, persona/knowhow/pitfalls), env docs (`.minds/env.md`), and participates in rtws-level lock/configuration/resolution.
-- A **skill** is a pure-Markdown capability asset inside the rtws. It is currently loaded from `.minds/skills/team_shared/**` and `.minds/skills/individual/**`, selects `SKILL.cn.md` / `SKILL.en.md` / `SKILL.md` by work language preference, and injects the body directly into the agent system prompt. It is best suited for soft guidance, checklists, decision heuristics, and team-specific methods, not for distributable product capability that depends on a stable tool contract.
+- A **skill** is a pure-Markdown capability asset inside the rtws. It is currently loaded from `.minds/skills/team_shared/**` and `.minds/skills/individual/**`, selects `SKILL.cn.md` / `SKILL.en.md` / `SKILL.md` by work language preference, injects a skill index into the agent system prompt, and exposes the body on demand through `read_skill`. It is best suited for soft guidance, checklists, decision heuristics, and team-specific methods, not for distributable product capability that depends on a stable tool contract.
 - Skill frontmatter currently supports `name`, `description`, `allowed-tools`, `user-invocable`, and `disable-model-invocation`; the last three are currently compatibility/migration metadata only. They do not automatically grant tool permissions and do not replace team/toolset runtime policy.
 - A **toolset manual / app-bundled manual** is a better place for guidance that is shipped together with tools: it is skill-like in tone, but distributed together with dedicated tools, toolsets, and app identity. That is a better fit for something like `web-dev`.
 - `playwright-interactive/` should not be classified as that pure-Markdown rtws skill category. More precisely, it represents a guidance layer on top of built-in browser execution capability. In Dominds, the cleaner move is to package dedicated tools, toolset manual, recommended teammate definitions, and runtime state together as an app such as `@longrun-ai/web-dev`.

package/dist/docs/app-constitution.zh.md

@@ -374,7 +374,7 @@ Install JSON 是 app 与 Kernel/CLI 之间的**安装/运行握手载荷**。它
 这里必须明确 **app 与 skill 不是同一层概念**，而且两者在现有实现中都已经是正式机制：
 
 - **App** 是 Dominds 的安装/解析/组合单元：它有自己的 `id`、manifest（`.minds/app.yaml`）、团队资产（`.minds/team.yaml`、persona/knowhow/pitfalls）、环境说明（`.minds/env.md`），并可被 `dominds install` 纳入某个 rtws。
-- **Skill** 是 rtws 内的纯 Markdown 技能资产：当前从 `.minds/skills/team_shared/**` 与 `.minds/skills/individual/**` 读取，按工作语言优先选择 `SKILL.cn.md` / `SKILL.en.md` / `SKILL.md`，并把正文直接注入智能体系统提示词。它更适合承载软性的操作指导、检查清单、判断口诀与团队特定方法学，而不是承载需要稳定工具契约的可分发产品能力。
+- **Skill** 是 rtws 内的纯 Markdown 技能资产：当前从 `.minds/skills/team_shared/**` 与 `.minds/skills/individual/**` 读取，按工作语言优先选择 `SKILL.cn.md` / `SKILL.en.md` / `SKILL.md`，并把 skill 索引注入智能体系统提示词，正文按需通过 `read_skill` 读取。它更适合承载软性的操作指导、检查清单、判断口诀与团队特定方法学，而不是承载需要稳定工具契约的可分发产品能力。
 - Skill frontmatter 当前支持 `name`、`description`、`allowed-tools`、`user-invocable`、`disable-model-invocation`；其中后 3 项目前主要用于兼容/迁移语义，不会自动授予工具权限，也不会替代团队 / 工具集调度规则。
 - **工具集操作手册 / 随 App 附带的操作手册** 更适合表达“和工具一起分发的操作指导”：它的性质接近 skill，但会与专属工具、工具集和 App 身份一起打包，更适合像 `web-dev` 这种需要整体分发与安装解析的能力。
 - `playwright-interactive/` 不应被归类为上述“纯 Markdown rtws skill”；更准确地说，它体现的是“内置浏览器能力之上的指导层”。在 Dominds 中，更正交的做法是像 `@longrun-ai/web-dev` 这样，把专属工具、工具集操作手册、推荐智能体队友定义与运行态缓存一起封装成 app。

package/dist/docs/dialog-persistence.md

@@ -321,7 +321,7 @@ To support main dialog fork, persistence now records which root-generation viewp
   - marks when a sideDialog already exists on the root timeline, so fork can decide whether to include it
 - `reminders_reconciled_record`
 - `questions4human_reconciled_record`
-- `pending_sideDialogs_reconciled_record`
+- `active_callees_reconciled_record`
 - `sideDialog_registry_reconciled_record`
 - `sideDialog_responses_reconciled_record`
 
@@ -329,7 +329,7 @@ To support main dialog fork, persistence now records which root-generation viewp
 
 - These reconciliation records are state snapshots, not LLM transcript content; message reconstruction must skip them
 - Any sideDialog transcript record that participates in root-fork cutoff trimming must carry `rootCourse/rootGenseq`
-- When writing a forked main dialog, persistence appends a baseline reconciliation set into `course-1` so reminders / Q4H / pending sideDialogs / registry / responses are restored to the pre-cutoff state
+- When writing a forked main dialog, persistence appends a baseline reconciliation set into `course-1` so reminders / Q4H / active callee dispatches / registry / responses are restored to the pre-cutoff state
 
 ---
 

package/dist/docs/dialog-persistence.zh.md

@@ -318,7 +318,7 @@ status: 'active' # 当前对话状态
   - 记录某个支线对话何时在 root 时间线上已“存在”，供 fork 时判断是否应纳入新树
 - `reminders_reconciled_record`
 - `questions4human_reconciled_record`
-- `pending_sideDialogs_reconciled_record`
+- `active_callees_reconciled_record`
 - `sideDialog_registry_reconciled_record`
 - `sideDialog_responses_reconciled_record`
 
@@ -326,7 +326,7 @@ status: 'active' # 当前对话状态
 
 - 这些对账记录是状态快照，不属于 LLM transcript 内容；重建消息上下文时应跳过
 - 支线对话 transcript 中凡是需要参与 root fork 边界裁剪的记录，都必须带 `rootCourse/rootGenseq`
-- fork 写入新主线对话时，会在 `course-1` 追加一组 baseline 对账记录，用来把 reminders / Q4H / pending sideDialogs / registry / responses 恢复到切点前状态
+- fork 写入新主线对话时，会在 `course-1` 追加一组 baseline 对账记录，用来把 reminders / Q4H / active callee dispatch / registry / responses 恢复到切点前状态
 
 ---