dominds 1.24.3 → 1.25.0

package/dist/dialog.d.ts

@@ -16,7 +16,7 @@ import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-hea
 import type { DialogEvent, NativeToolCallPayload, ReminderContent, WebSearchCallAction, WebSearchCallSource } from '@longrun-ai/kernel/types/dialog';
 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 { ActiveCalleesFile, CalleeCourseNumber, CalleeGenerationSeqNumber, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogLatestFile, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
+import type { ActiveCalleesFile, CalleeCourseNumber, CalleeGenerationSeqNumber, CallSiteCourseNo, CallSiteGenseqNo, DialogAskerStackState, DialogLatestFile, DialogMetadataFile, DialogNextStepTrigger, 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';
@@ -150,7 +150,7 @@ export declare abstract class Dialog {
     protected _lastUserLanguageCode: LanguageCode;
     protected _lastContextHealth?: ContextHealthSnapshot;
     protected _lastContextHealthGenseq?: number;
-    protected _upNextQueue: DialogQueuedPromptState[];
+    protected _queuedPrompts: DialogQueuedPromptState[];
     protected _driveIntents: DriveIntent[];
     protected _activeRunControlSpec?: DialogRunControlSpec;
     protected _newCourseHook?: NewCourseHook;
@@ -327,7 +327,7 @@ export declare abstract class Dialog {
     private setPendingRuntimePrompt;
     private mergePromptQ4HAnswerCallId;
     private enqueueQueuedPromptState;
-    private peekLatestUpNext;
+    private peekLatestQueuedPrompt;
     queueUserPromptAtGenerationBoundary(options: {
         prompt: string;
         contentItems?: DialogQueuedUserGenerationBoundaryState['contentItems'];
@@ -372,9 +372,9 @@ export declare abstract class Dialog {
         skipTaskdoc?: boolean;
         calleeDialogReplyTarget: DialogCalleeReplyTarget;
     }): Promise<DialogQueuedPromptState>;
-    hasUpNext(): boolean;
-    peekUpNext(): DialogQueuedPromptState | undefined;
-    takeUpNext(): DialogQueuedPromptState | undefined;
+    hasQueuedPrompt(): boolean;
+    peekQueuedPrompt(): DialogQueuedPromptState | undefined;
+    takeQueuedPrompt(): DialogQueuedPromptState | undefined;
     setActiveRunControlSpec(spec?: DialogRunControlSpec): void;
     getActiveRunControlSpec(): DialogRunControlSpec | undefined;
     setNewCourseHook(hook?: NewCourseHook): void;
@@ -392,7 +392,7 @@ export declare abstract class Dialog {
         reason?: string;
         skipRunControlHook?: boolean;
         skipEnqueueIntent?: boolean;
-    }): Promise<void>;
+    }): Promise<DialogRuntimePrompt>;
     receiveFuncResult(result: FuncResultMsg): Promise<void>;
     receiveTellaskResult(result: TellaskResultMsg): Promise<void>;
     receiveTellaskCarryover(result: TellaskCarryoverMsg): Promise<void>;
@@ -413,7 +413,7 @@ export declare abstract class Dialog {
         calleeCourse?: CalleeCourseNumber;
         calleeGenseq?: CalleeGenerationSeqNumber;
     }): Promise<TellaskResultMsg | TellaskCarryoverMsg>;
-    notifyGeneratingStart(msgId?: string): Promise<void>;
+    notifyGeneratingStart(msgId?: string): Promise<readonly DialogNextStepTrigger[]>;
     notifyGeneratingFinish(contextHealth?: ContextHealthSnapshot, llmGenModel?: string): Promise<void>;
     streamError(error: string): Promise<void>;
     thinkingStart(): Promise<void>;
@@ -600,7 +600,7 @@ export declare abstract class DialogStore {
     /**
      * Notify start of LLM generation lifecycle (generating_start_evt)
      */
-    notifyGeneratingStart(_dialog: Dialog, _msgId?: string): Promise<void>;
+    notifyGeneratingStart(_dialog: Dialog, _msgId?: string): Promise<readonly DialogNextStepTrigger[]>;
     /**
      * Notify end of LLM generation lifecycle (generating_finish_evt)
      */

package/dist/dialog.js

@@ -48,9 +48,9 @@ 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) {
+async function queueRootDialogDrive(rootId, meta) {
     const { globalDialogRegistry } = await Promise.resolve().then(() => __importStar(require('./dialog-global-registry')));
-    globalDialogRegistry.wakeDrive(rootId, meta);
+    globalDialogRegistry.queueRootDrive(rootId, meta);
 }
 class InvalidReminderIndexError extends Error {
     constructor(index, total) {
@@ -228,7 +228,7 @@ class Dialog {
         this._currentCourse = 1;
         this._remindersVer = 0;
         // Prompts queued for future drives (set by startNewCourse or deferred-resume flows).
-        this._upNextQueue = [];
+        this._queuedPrompts = [];
         this._driveIntents = [];
         this._driveIntentMode = 'legacy';
         // Course prefix messages injected into LLM context on every course.
@@ -243,7 +243,7 @@ class Dialog {
         // Track the generation sequence when _generationStarted was set
         // Used to ensure proper ordering when multiple generations occur
         this._generationStartedGenseq = 0;
-        // Pending sideDialog IDs (for auto-revive tracking)
+        // Pending sideDialog IDs (for active callee tracking)
         this._activeCalleeDialogIds = [];
         // Phase 11: Suspension state for Type A sideDialog mechanism
         // Tracks whether this dialog is in normal state, suspended, or resuming from suspension
@@ -755,11 +755,11 @@ class Dialog {
         return this._updatedAt;
     }
     replaceQueuedPromptState(existingMsgId, nextPrompt) {
-        const queueIndex = this._upNextQueue.findIndex((prompt) => prompt.msgId === existingMsgId);
+        const queueIndex = this._queuedPrompts.findIndex((prompt) => prompt.msgId === existingMsgId);
         if (queueIndex < 0) {
-            throw new Error(`UpNext prompt replacement invariant violation: dialog=${this.id.valueOf()} existingMsgId=${existingMsgId}`);
+            throw new Error(`Queued prompt replacement invariant violation: dialog=${this.id.valueOf()} existingMsgId=${existingMsgId}`);
         }
-        this._upNextQueue[queueIndex] = nextPrompt;
+        this._queuedPrompts[queueIndex] = nextPrompt;
         for (let index = this._driveIntents.length - 1; index >= 0; index -= 1) {
             const intent = this._driveIntents[index];
             if (intent.kind !== 'prompt' || intent.prompt.msgId !== existingMsgId)
@@ -822,7 +822,7 @@ class Dialog {
                         }
                         default: {
                             const _exhaustive = nextPrompt;
-                            throw new Error(`UpNext prompt replacement invariant violation: unsupported queued prompt`);
+                            throw new Error(`Queued prompt replacement invariant violation: unsupported queued prompt`);
                         }
                     }
                 })(),
@@ -830,7 +830,7 @@ class Dialog {
             };
             return nextPrompt;
         }
-        throw new Error(`UpNext prompt replacement invariant violation: missing drive intent dialog=${this.id.valueOf()} existingMsgId=${existingMsgId}`);
+        throw new Error(`Queued prompt replacement invariant violation: missing drive intent dialog=${this.id.valueOf()} existingMsgId=${existingMsgId}`);
     }
     setPendingRuntimePrompt(prompt) {
         const prepared = typeof prompt === 'string'
@@ -875,7 +875,7 @@ class Dialog {
                     const prompt = runtimeCommon;
                     return prompt;
                 })();
-        this._upNextQueue = [
+        this._queuedPrompts = [
             normalized.calleeDialogReplyTarget !== undefined
                 ? {
                     kind: 'new_course_runtime_sideDialog',
@@ -927,7 +927,7 @@ class Dialog {
         return normalizedExisting;
     }
     enqueueQueuedPromptState(state) {
-        this._upNextQueue.push(state);
+        this._queuedPrompts.push(state);
         const promptCommon = {
             content: state.prompt,
             ...(state.contentItems === undefined ? {} : { contentItems: state.contentItems }),
@@ -980,7 +980,7 @@ class Dialog {
                     }
                     default: {
                         const _exhaustive = state;
-                        throw new Error(`UpNext enqueue invariant violation: unsupported queued prompt`);
+                        throw new Error(`Queued prompt enqueue invariant violation: unsupported queued prompt`);
                     }
                 }
             })(),
@@ -988,14 +988,14 @@ class Dialog {
         });
         this._updatedAt = (0, time_1.formatUnifiedTimestamp)(new Date());
     }
-    peekLatestUpNext() {
-        if (this._upNextQueue.length === 0) {
+    peekLatestQueuedPrompt() {
+        if (this._queuedPrompts.length === 0) {
             return undefined;
         }
-        return this._upNextQueue[this._upNextQueue.length - 1];
+        return this._queuedPrompts[this._queuedPrompts.length - 1];
     }
     queueUserPromptAtGenerationBoundary(options) {
-        const existing = this.peekLatestUpNext();
+        const existing = this.peekLatestQueuedPrompt();
         const trimmed = options.prompt.trim();
         if (!trimmed) {
             throw new Error('Prompt is required to queue generation-boundary user prompt');
@@ -1050,7 +1050,7 @@ class Dialog {
         return created;
     }
     queueRegisteredAssignmentUpdatePrompt(options) {
-        const existing = this.peekLatestUpNext();
+        const existing = this.peekLatestQueuedPrompt();
         const trimmed = options.prompt.trim();
         if (!trimmed) {
             throw new Error('Prompt is required to queue registered assignment update');
@@ -1093,7 +1093,7 @@ class Dialog {
     async persistPendingRuntimePrompt(prompt) {
         await this.dlgStore.persistPendingRuntimePrompt(this, prompt);
         if (this.id.selfId === this.id.rootId) {
-            await wakeRootDialogDrive(this.id.rootId, {
+            await queueRootDialogDrive(this.id.rootId, {
                 source: 'dialog_runtime_prompt',
                 reason: `queued_runtime_prompt:${prompt.msgId}`,
             });
@@ -1155,14 +1155,14 @@ class Dialog {
         });
         return created;
     }
-    hasUpNext() {
-        return this._upNextQueue.length > 0;
+    hasQueuedPrompt() {
+        return this._queuedPrompts.length > 0;
     }
-    peekUpNext() {
-        return this._upNextQueue[0];
+    peekQueuedPrompt() {
+        return this._queuedPrompts[0];
     }
-    takeUpNext() {
-        return this._upNextQueue.shift();
+    takeQueuedPrompt() {
+        return this._queuedPrompts.shift();
     }
     setActiveRunControlSpec(spec) {
         this._activeRunControlSpec = spec;
@@ -1244,7 +1244,7 @@ class Dialog {
             await this.dlgStore.startNewCourse(this, nextPrompt);
         }
         if (this.id.selfId === this.id.rootId) {
-            await wakeRootDialogDrive(this.id.rootId, {
+            await queueRootDialogDrive(this.id.rootId, {
                 source: 'dialog_start_new_course',
                 reason: `queued_runtime_prompt:${nextPrompt.msgId}`,
             });
@@ -1265,6 +1265,7 @@ class Dialog {
                 runControl: runControlSpec,
             });
         }
+        return normalized;
     }
     // Proxy methods for DialogStore - route calls through dialog object instead of direct dlgStore access
     async receiveFuncResult(result) {
@@ -1498,7 +1499,15 @@ class Dialog {
         // Mark generation as started with the actual genseq
         // This ensures sideDialog_final_response_evt waits for both user_text and generating_start_evt
         this.markGenerationStarted();
-        await this.dlgStore.notifyGeneratingStart(this, msgId);
+        try {
+            return await this.dlgStore.notifyGeneratingStart(this, msgId);
+        }
+        catch (err) {
+            this._generationStarted = false;
+            this._generationStartedGenseq = 0;
+            this._activeGenCourse = undefined;
+            throw err;
+        }
     }
     async notifyGeneratingFinish(contextHealth, llmGenModel) {
         if (contextHealth) {
@@ -1507,17 +1516,12 @@ class Dialog {
         try {
             await this.dlgStore.notifyGeneratingFinish(this, contextHealth, llmGenModel);
         }
-        catch (err) {
-            log_1.log.warn('notifyGeneratingFinish failed', undefined, {
-                genseq: this._activeGenSeq,
-                error: err,
-                message: err instanceof Error ? err.message : String(err),
-            });
+        finally {
+            // Reset generation tracking for the next course even when persistence fails loudly.
+            this._generationStarted = false;
+            this._generationStartedGenseq = 0;
+            this._activeGenCourse = undefined;
         }
-        // Reset generation tracking for the next course
-        this._generationStarted = false;
-        this._generationStartedGenseq = 0;
-        this._activeGenCourse = undefined;
     }
     async streamError(error) {
         if (this.dlgStore) {
@@ -1958,7 +1962,9 @@ class DialogStore {
     /**
      * Notify start of LLM generation lifecycle (generating_start_evt)
      */
-    async notifyGeneratingStart(_dialog, _msgId) { }
+    async notifyGeneratingStart(_dialog, _msgId) {
+        return [];
+    }
     /**
      * Notify end of LLM generation lifecycle (generating_finish_evt)
      */

package/dist/docs/dialog-system.md

@@ -729,7 +729,7 @@ sequenceDiagram
   Side-->>Store: persist final response
   Driver-->>Asker: supply result-arrival fact + clear pending callee
   opt result arrival creates an explicit drive source
-    Driver-->>Asker: set needsDrive=true
+    Driver-->>Asker: upsert result_arrival trigger + wake queue
   end
 ```
 
@@ -1231,7 +1231,7 @@ Dominds' runtime does **not** persist a single enum-like “awaiting …” stat
 driven is derived from persisted facts:
 
 - Persisted status (API/index): `running | completed | archived`
-- Persisted `latest.yaml`: `status`, `needsDrive`, `generating`
+- Persisted `latest.yaml`: `status`, `nextStep.triggers`, `generating`
 - Derived gates: `hasPendingQ4H()`; active callee dispatches are background callee facts, not a drive gate
 
 **Persisted status lifecycle:**
@@ -1250,12 +1250,12 @@ stateDiagram-v2
 flowchart TD
   A[status=running] --> B{canDrive?\\n(no pending Q4H)}
   B -- no --> S[Suspended\\n(waiting on Q4H)]
-  S -->|Q4H answered| C{needsDrive?}
+  S -->|Q4H answered| C{nextStep trigger?}
   R[result arrival] --> C
-  B -- yes --> C{needsDrive?}
+  B -- yes --> C{nextStep trigger?}
   C -- no --> I[Idle\\n(waiting for trigger)]
   C -- yes --> D[Drive loop\\n(generating=true while streaming)]
-  D --> E{hasUpNext?}
+  D --> E{hasQueuedPrompt?}
   E -- yes --> C
   E -- no --> I
 ```
@@ -1306,7 +1306,7 @@ sequenceDiagram
   Side-->>Driver: final response
   Driver-->>Tellasker: supply result-arrival fact + clear pending callee
   opt result arrival creates an explicit drive source
-    Driver-->>Tellasker: set `needsDrive=true`
+    Driver-->>Tellasker: upsert result_arrival trigger + wake queue
   end
 ```
 
@@ -1381,7 +1381,7 @@ sequenceDiagram
   Side-->>Asker: sideDialog response supplied to tellasker (result-arrival fact; clears this pending callee)
 
   opt Asker has a result-arrival drive source
-    Asker-->>Asker: set needsDrive=true (result-arrival handling)
+    Asker-->>Asker: upsert result_arrival trigger + wake queue (result-arrival handling)
   end
 ```
 

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

@@ -714,7 +714,7 @@ sequenceDiagram
   Side-->>Store: 持久化最终响应
   Driver-->>Asker: 供应结果到达事实 + 清除 pending callee
   opt 结果到达形成显式驱动源
-    Driver-->>Asker: 设置 needsDrive=true
+    Driver-->>Asker: 写入 result_arrival trigger + Wake Queue
   end
 ```
 
@@ -1214,7 +1214,7 @@ Dominds 的运行时**不**持久化单一的类似枚举的 "awaiting …" 状
 驱动是从持久化的事实派生的：
 
 - 持久化状态（API/索引）：`running | completed | archived`
-- 持久化 `latest.yaml`：`status`、`needsDrive`、`generating`
+- 持久化 `latest.yaml`：`status`、`nextStep.triggers`、`generating`
 - 派生的门控：`hasPendingQ4H()`；active callee dispatches 是后台被诉请者事实，不是驱动门控
 
 **持久化状态生命周期**：
@@ -1286,7 +1286,7 @@ sequenceDiagram
   Side-->>Driver: 最终响应
   Driver-->>Tellasker: 供应结果到达事实 + 清除 pending callee
   opt 结果到达形成显式驱动源
-    Driver-->>Tellasker: 设置 needsDrive=true（结果到达处理）
+    Driver-->>Tellasker: 写入 result_arrival trigger + Wake Queue（结果到达处理）
   end
 ```
 
@@ -1358,7 +1358,7 @@ sequenceDiagram
   Side-->>Asker: callee 响应供应给诉请者（结果到达事实；清除该 pending callee）
 
   opt 诉请者有 result-arrival 驱动事实
-    Asker-->>Asker: 设置 needsDrive=true（结果到达处理）
+    Asker-->>Asker: 写入 result_arrival trigger + Wake Queue（结果到达处理）
   end
 ```