dominds 1.13.2 → 1.15.2

package/dist/bootstrap/global-dialog-event-broadcaster.d.ts

@@ -0,0 +1,18 @@
+import type { TypedDialogEvent } from '@longrun-ai/kernel/types/dialog';
+export type GlobalDialogEventRecorder = Readonly<{
+    label: string;
+    snapshot: () => readonly TypedDialogEvent[];
+    clear: () => void;
+}>;
+export declare function installGlobalDialogEventBroadcaster(args: {
+    label: string;
+    publish: (evt: TypedDialogEvent) => void;
+}): void;
+export declare function installRecordingGlobalDialogEventBroadcaster(args?: {
+    label?: string;
+    publish?: (evt: TypedDialogEvent) => void;
+}): GlobalDialogEventRecorder;
+export declare function clearInstalledGlobalDialogEventBroadcaster(): void;
+export declare function assertGlobalDialogEventBroadcasterInstalled(where: string): void;
+export declare function getRecordingGlobalDialogEventRecorder(): GlobalDialogEventRecorder | null;
+export declare function requireRecordingGlobalDialogEventRecorder(where: string): GlobalDialogEventRecorder;

package/dist/bootstrap/global-dialog-event-broadcaster.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installGlobalDialogEventBroadcaster = installGlobalDialogEventBroadcaster;
+exports.installRecordingGlobalDialogEventBroadcaster = installRecordingGlobalDialogEventBroadcaster;
+exports.clearInstalledGlobalDialogEventBroadcaster = clearInstalledGlobalDialogEventBroadcaster;
+exports.assertGlobalDialogEventBroadcasterInstalled = assertGlobalDialogEventBroadcasterInstalled;
+exports.getRecordingGlobalDialogEventRecorder = getRecordingGlobalDialogEventRecorder;
+exports.requireRecordingGlobalDialogEventRecorder = requireRecordingGlobalDialogEventRecorder;
+const evt_registry_1 = require("../evt-registry");
+const log_1 = require("../log");
+const log = (0, log_1.createLogger)('global-dialog-event-broadcaster');
+let installedBroadcasterState = { kind: 'uninitialized' };
+function buildRecorder(label, events) {
+    return {
+        label,
+        snapshot: () => [...events],
+        clear: () => {
+            events.length = 0;
+        },
+    };
+}
+function installGlobalDialogEventBroadcaster(args) {
+    installedBroadcasterState = {
+        kind: 'custom',
+        label: args.label,
+        publish: args.publish,
+    };
+    (0, evt_registry_1.setGlobalDialogEventBroadcaster)(args.publish);
+    log.debug('Installed global dialog event broadcaster', undefined, {
+        label: args.label,
+        kind: 'custom',
+    });
+}
+function installRecordingGlobalDialogEventBroadcaster(args) {
+    const label = args?.label?.trim() || 'recording-broadcaster';
+    const events = [];
+    const publish = (evt) => {
+        events.push(evt);
+        args?.publish?.(evt);
+    };
+    installedBroadcasterState = {
+        kind: 'recording',
+        label,
+        events,
+        publish: args?.publish,
+    };
+    (0, evt_registry_1.setGlobalDialogEventBroadcaster)(publish);
+    log.debug('Installed recording global dialog event broadcaster', undefined, {
+        label,
+        kind: 'recording',
+    });
+    return buildRecorder(label, events);
+}
+function clearInstalledGlobalDialogEventBroadcaster() {
+    const previousKind = installedBroadcasterState.kind;
+    installedBroadcasterState = { kind: 'uninitialized' };
+    (0, evt_registry_1.setGlobalDialogEventBroadcaster)(null);
+    log.debug('Cleared global dialog event broadcaster', undefined, {
+        previousKind,
+    });
+}
+function assertGlobalDialogEventBroadcasterInstalled(where) {
+    if (installedBroadcasterState.kind !== 'uninitialized') {
+        return;
+    }
+    throw new Error(`Global dialog event broadcaster runtime missing: ${where} must install the broadcaster during runtime bootstrap before dialog logic runs`);
+}
+function getRecordingGlobalDialogEventRecorder() {
+    if (installedBroadcasterState.kind !== 'recording') {
+        return null;
+    }
+    return buildRecorder(installedBroadcasterState.label, installedBroadcasterState.events);
+}
+function requireRecordingGlobalDialogEventRecorder(where) {
+    const recorder = getRecordingGlobalDialogEventRecorder();
+    if (recorder) {
+        return recorder;
+    }
+    const currentKind = installedBroadcasterState.kind;
+    throw new Error(`Global dialog event recorder missing: ${where} requires a recording broadcaster, but runtime installed '${currentKind}'`);
+}

package/dist/dialog-fork.js

@@ -45,7 +45,6 @@ function cloneReminderSnapshot(snapshot) {
 function cloneQuestions(questions) {
     return questions.map((question) => ({
         ...question,
-        remainingCallIds: question.remainingCallIds ? [...question.remainingCallIds] : undefined,
         callSiteRef: { ...question.callSiteRef },
     }));
 }
@@ -105,16 +104,17 @@ function isPersistedMessageRecord(record) {
         case 'runtime_guide_record':
         case 'human_text_record':
         case 'func_call_record':
-        case 'tellask_special_call_record':
+        case 'tellask_call_record':
         case 'func_result_record':
-        case 'tellask_call_result_record':
-        case 'tellask_response_record':
-        case 'tellask_carryover_result_record':
+        case 'tellask_result_record':
+        case 'tellask_carryover_record':
             return true;
+        // UI-only timeline records belong to the retained transcript for replay/forking, but they do
+        // not contribute to message-count / context reconstruction semantics.
         case 'web_search_call_record':
+        case 'native_tool_call_record':
         case 'quest_for_sup_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_carryover_record':
         case 'tellask_call_anchor_record':
         case 'gen_start_record':
         case 'gen_finish_record':
@@ -180,16 +180,17 @@ function rewriteRecordForFork(record, newRootId) {
         case 'ui_only_markdown_record':
         case 'runtime_guide_record':
         case 'func_call_record':
-        case 'tellask_special_call_record':
+        case 'tellask_call_record':
+        // UI-only transcript records are safe to copy verbatim into the forked transcript. They are
+        // not part of baseline state reconciliation and must not make forking fail.
         case 'web_search_call_record':
+        case 'native_tool_call_record':
         case 'human_text_record':
         case 'quest_for_sup_record':
-        case 'tellask_call_result_record':
+        case 'tellask_result_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_carryover_record':
         case 'tellask_call_anchor_record':
-        case 'tellask_response_record':
-        case 'tellask_carryover_result_record':
+        case 'tellask_carryover_record':
         case 'gen_start_record':
         case 'gen_finish_record':
             return record;
@@ -223,7 +224,7 @@ function countMessages(events) {
 function countFunctionCalls(events) {
     let count = 0;
     for (const event of events) {
-        if (event.type === 'func_call_record' || event.type === 'tellask_special_call_record') {
+        if (event.type === 'func_call_record' || event.type === 'tellask_call_record') {
             count += 1;
         }
     }

package/dist/dialog.d.ts

@@ -13,11 +13,11 @@
  * - `SubDialog` - Subdialog with root dialog reference and dynamic supdialog resolution
  */
 import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-health';
-import type { DialogEvent, ReminderContent, WebSearchCallAction } from '@longrun-ai/kernel/types/dialog';
+import type { DialogEvent, NativeToolCallPayload, ReminderContent, WebSearchCallAction, WebSearchCallSource } from '@longrun-ai/kernel/types/dialog';
 import type { DialogPrompt, DialogRunControlSpec, DialogSubdialogReplyTarget, DriveIntent } from '@longrun-ai/kernel/types/drive-intent';
 import type { LanguageCode } from '@longrun-ai/kernel/types/language';
-import type { CalleeCourseNumber, CalleeGenerationSeqNumber, CallingCourseNumber, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, ToolArguments as StoredToolArguments, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
-import { ChatMessage, FuncResultMsg } from './llm/client';
+import type { CalleeCourseNumber, CalleeGenerationSeqNumber, CallingCourseNumber, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, TellaskCallRecordName, TellaskReplyDirective } from '@longrun-ai/kernel/types/storage';
+import { ChatMessage, FuncResultMsg, TellaskCarryoverMsg, TellaskResultMsg } from './llm/client';
 import type { JsonValue } from './tool';
 import { Reminder, ReminderOptions, ReminderOwner } from './tool';
 type NewCourseHookResult = {
@@ -34,7 +34,7 @@ type UpNextPromptState = {
     grammar?: 'markdown';
     userLanguageCode?: LanguageCode;
     origin: 'user' | 'diligence_push' | 'runtime';
-    q4hAnswerCallIds?: string[];
+    q4hAnswerCallId?: string;
     tellaskReplyDirective?: TellaskReplyDirective;
     skipTaskdoc?: boolean;
     subdialogReplyTarget?: DialogSubdialogReplyTarget;
@@ -322,7 +322,7 @@ export declare abstract class Dialog {
     private buildUpNextPromptState;
     private replaceQueuedPromptState;
     private setNewCourseStartPrompt;
-    private mergePromptQ4HAnswerCallIds;
+    private mergePromptQ4HAnswerCallId;
     private enqueueQueuedPromptState;
     private peekLatestUpNext;
     queueUserPromptAtGenerationBoundary(options: {
@@ -330,21 +330,21 @@ export declare abstract class Dialog {
         msgId: string;
         grammar: 'markdown';
         userLanguageCode?: LanguageCode;
-        q4hAnswerCallIds?: string[];
+        q4hAnswerCallId?: string;
     }): UpNextPromptState;
     queueDeferredQ4HAnswerPrompt(options: {
         prompt: string;
         msgId: string;
         grammar: 'markdown';
         userLanguageCode?: LanguageCode;
-        q4hAnswerCallIds?: string[];
+        q4hAnswerCallId?: string;
     }): UpNextPromptState;
     queueRegisteredAssignmentUpdatePrompt(options: {
         prompt: string;
         msgId: string;
         grammar: 'markdown';
         userLanguageCode?: LanguageCode;
-        q4hAnswerCallIds?: string[];
+        q4hAnswerCallId?: string;
         tellaskReplyDirective?: TellaskReplyDirective;
         skipTaskdoc?: boolean;
         subdialogReplyTarget?: DialogSubdialogReplyTarget;
@@ -371,6 +371,20 @@ export declare abstract class Dialog {
         skipEnqueueIntent?: boolean;
     }): Promise<void>;
     receiveFuncResult(result: FuncResultMsg): Promise<void>;
+    receiveTellaskResult(result: TellaskResultMsg): Promise<void>;
+    receiveTellaskCarryover(result: TellaskCarryoverMsg): Promise<void>;
+    receiveTellaskCallResult(responderId: string, callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning', mentionList: string[] | undefined, tellaskContent: string, result: string, status: 'completed' | 'failed', callId: string): Promise<void>;
+    receiveTellaskResponse(responderId: string, callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning', mentionList: string[] | undefined, tellaskContent: string, status: 'completed' | 'failed', subdialogId: DialogID | undefined, options: {
+        response: string;
+        agentId: string;
+        callId: string;
+        originMemberId: string;
+        originCourse?: CallingCourseNumber;
+        carryoverContent?: string;
+        sessionSlug?: string;
+        calleeCourse?: CalleeCourseNumber;
+        calleeGenseq?: CalleeGenerationSeqNumber;
+    }): Promise<TellaskResultMsg | TellaskCarryoverMsg>;
     notifyGeneratingStart(msgId?: string): Promise<void>;
     notifyGeneratingFinish(contextHealth?: ContextHealthSnapshot, llmGenModel?: string): Promise<void>;
     streamError(error: string): Promise<void>;
@@ -385,11 +399,13 @@ export declare abstract class Dialog {
     sayingFinish(): Promise<void>;
     funcCallRequested(funcId: string, funcName: string, argumentsStr: string): Promise<void>;
     webSearchCall(payload: {
+        source?: WebSearchCallSource;
         phase: 'added' | 'done';
         itemId: string;
         status?: string;
         action?: WebSearchCallAction;
     }): Promise<void>;
+    nativeToolCall(payload: NativeToolCallPayload): Promise<void>;
     callingStart(payload: {
         callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning';
         callId: string;
@@ -397,26 +413,13 @@ export declare abstract class Dialog {
         sessionSlug?: string;
         tellaskContent: string;
     }): Promise<void>;
-    /**
-     * Receive call result with callId for inline correlation
-     */
-    receiveTellaskCallResult(responderId: string, callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning', mentionList: string[] | undefined, tellaskContent: string, result: string, status: 'completed' | 'failed', callId: string): Promise<void>;
-    /**
-     * Receive tellask response (separate bubble for tellask sideline replies)
-     */
-    receiveTellaskResponse(responderId: string, callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning', mentionList: string[] | undefined, tellaskContent: string, status: 'completed' | 'failed', subdialogId: DialogID | undefined, options: {
-        response: string;
-        agentId: string;
-        callId: string;
-        originMemberId: string;
-        originCourse?: CallingCourseNumber;
-        carryoverContent?: string;
-        sessionSlug?: string;
-        calleeCourse?: CalleeCourseNumber;
-        calleeGenseq?: CalleeGenerationSeqNumber;
-    }): Promise<void>;
     updateQuestions4Human(questions: HumanQuestion[]): Promise<void>;
-    persistUserMessage(content: string, msgId: string, grammar: 'markdown', origin: 'user' | 'diligence_push' | 'runtime' | undefined, userLanguageCode?: LanguageCode, q4hAnswerCallIds?: string[], tellaskReplyDirective?: TellaskReplyDirective): Promise<void>;
+    persistUserMessage(content: string, msgId: string, grammar: 'markdown', origin: 'user' | 'diligence_push' | 'runtime' | undefined, userLanguageCode?: LanguageCode, q4hAnswerCallId?: string, tellaskReplyDirective?: TellaskReplyDirective): Promise<void>;
+    receiveHumanReply(args: {
+        content: string;
+        userLanguageCode?: LanguageCode;
+        q4hAnswerCallId: string;
+    }): Promise<void>;
     appendTellaskReplyResolution(payload: {
         callId: string;
         replyCallName: 'replyTellask' | 'replyTellaskSessionless' | 'replyTellaskBack';
@@ -424,8 +427,19 @@ export declare abstract class Dialog {
     }): Promise<void>;
     persistAgentMessage(content: string, genseq: number, type: 'thinking_msg' | 'saying_msg', provider_data?: ProviderData, reasoning?: ReasoningPayload): Promise<void>;
     persistUiOnlyMarkdown(content: string, genseq: number): Promise<void>;
-    persistFunctionCall(id: string, name: string, arguments_: StoredToolArguments, genseq: number): Promise<void>;
-    persistTellaskSpecialCall(id: string, name: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'replyTellask' | 'replyTellaskSessionless' | 'replyTellaskBack' | 'askHuman' | 'freshBootsReasoning', arguments_: StoredToolArguments, genseq: number): Promise<void>;
+    persistFunctionCall(id: string, name: string, rawArgumentsText: string, genseq: number): Promise<void>;
+    persistTellaskCall(id: string, name: TellaskCallRecordName, rawArgumentsText: string, genseq: number, options?: {
+        deliveryMode?: 'tellask_call_start' | 'func_call_requested';
+    }): Promise<void>;
+    persistFunctionCallResultPair(id: string, name: string, rawArgumentsText: string, genseq: number, result: FuncResultMsg): Promise<void>;
+    persistTellaskCallResultPair(args: {
+        id: string;
+        name: TellaskCallRecordName;
+        rawArgumentsText: string;
+        genseq: number;
+        result: TellaskResultMsg | FuncResultMsg;
+        deliveryMode: 'tellask_call_start' | 'func_call_requested';
+    }): Promise<void>;
     /**
      * Post subdialog completion response to this dialog.
      * Phase 14: No wait - emit immediately with virtual gen markers for Type C subdialogs
@@ -574,24 +588,8 @@ export declare abstract class DialogStore {
     sayingChunk(_dialog: Dialog, _chunk: string): void;
     sayingFinish(_dialog: Dialog): void;
     receiveFuncResult(_dialog: Dialog, _funcResult: FuncResultMsg): Promise<void>;
-    /**
-     * Receive call result with callId for inline correlation
-     */
-    receiveTellaskCallResult(_dialog: Dialog, _responderId: string, _callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'askHuman' | 'freshBootsReasoning', _mentionList: string[] | undefined, _tellaskContent: string, _result: string, _status: 'completed' | 'failed', _callId: string): Promise<void>;
-    /**
-     * Receive tellask response (separate bubble for tellask sideline replies)
-     */
-    receiveTellaskResponse(_dialog: Dialog, _responderId: string, _callName: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'freshBootsReasoning', _mentionList: string[] | undefined, _tellaskContent: string, _status: 'completed' | 'failed', _subdialogId: DialogID | undefined, _options: {
-        response: string;
-        agentId: string;
-        callId: string;
-        originMemberId: string;
-        originCourse?: CallingCourseNumber;
-        carryoverContent?: string;
-        sessionSlug?: string;
-        calleeCourse?: CalleeCourseNumber;
-        calleeGenseq?: CalleeGenerationSeqNumber;
-    }): Promise<void>;
+    receiveTellaskResult(_dialog: Dialog, _funcResult: TellaskResultMsg): Promise<void>;
+    receiveTellaskCarryover(_dialog: Dialog, _result: TellaskCarryoverMsg): Promise<void>;
     updateQuestions4Human(_dialog: Dialog, _questions: HumanQuestion[]): Promise<void>;
     /**
      * Load Questions for Human state from storage
@@ -619,11 +617,13 @@ export declare abstract class DialogStore {
     }): Promise<void>;
     funcCallRequested(_dialog: Dialog, _funcId: string, _funcName: string, _argumentsStr: string): Promise<void>;
     webSearchCall(_dialog: Dialog, _payload: {
+        source?: WebSearchCallSource;
         phase: 'added' | 'done';
         itemId: string;
         status?: string;
         action?: WebSearchCallAction;
     }): Promise<void>;
+    nativeToolCall(_dialog: Dialog, _payload: NativeToolCallPayload): Promise<void>;
     /**
      * Load current course number from persisted metadata
      * This method should be implemented by subclasses to read from storage
@@ -641,7 +641,7 @@ export declare abstract class DialogStore {
     /**
      * Persist a user message to storage
      */
-    persistUserMessage(_dialog: Dialog, _content: string, _msgId: string, _grammar: 'markdown', _origin: 'user' | 'diligence_push' | 'runtime' | undefined, _userLanguageCode?: LanguageCode, _q4hAnswerCallIds?: string[], _tellaskReplyDirective?: TellaskReplyDirective): Promise<void>;
+    persistUserMessage(_dialog: Dialog, _content: string, _msgId: string, _grammar: 'markdown', _origin: 'user' | 'diligence_push' | 'runtime' | undefined, _userLanguageCode?: LanguageCode, _q4hAnswerCallId?: string, _tellaskReplyDirective?: TellaskReplyDirective): Promise<void>;
     appendTellaskReplyResolution(_dialog: Dialog, _payload: {
         callId: string;
         replyCallName: 'replyTellask' | 'replyTellaskSessionless' | 'replyTellaskBack';
@@ -659,8 +659,19 @@ export declare abstract class DialogStore {
     /**
      * Persist a function call to storage
      */
-    persistFunctionCall(_dialog: Dialog, _id: string, _name: string, _arguments: StoredToolArguments, _genseq: number): Promise<void>;
-    persistTellaskSpecialCall(_dialog: Dialog, _id: string, _name: 'tellaskBack' | 'tellask' | 'tellaskSessionless' | 'replyTellask' | 'replyTellaskSessionless' | 'replyTellaskBack' | 'askHuman' | 'freshBootsReasoning', _arguments: StoredToolArguments, _genseq: number): Promise<void>;
+    persistFunctionCall(_dialog: Dialog, _id: string, _name: string, _rawArgumentsText: string, _genseq: number): Promise<void>;
+    persistTellaskCall(_dialog: Dialog, _id: string, _name: TellaskCallRecordName, _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>;
     /**
      * Start a new course in storage
      */