dominds 1.20.4 → 1.20.5

package/dist/dialog-factory.d.ts

@@ -4,6 +4,7 @@
  * Factory for creating Dialog instances with proper type hierarchy.
  * Provides a single point of dialog creation to ensure consistent initialization.
  */
+import type { CallSiteCourseNo, CallSiteGenseqNo } from '@longrun-ai/kernel/types/storage';
 import { Dialog, DialogID, DialogInitParams, DialogStore, MainDialog, SideDialog } from './dialog';
 /**
  * Factory for creating Dialog instances.
@@ -22,6 +23,8 @@ export declare class DialogFactory {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;

package/dist/dialog-factory.js

@@ -1,12 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DialogFactory = void 0;
-/**
- * Module: dialog-factory
- *
- * Factory for creating Dialog instances with proper type hierarchy.
- * Provides a single point of dialog creation to ensure consistent initialization.
- */
 const dialog_1 = require("./dialog");
 const dialog_global_registry_1 = require("./dialog-global-registry");
 const id_1 = require("./utils/id");
@@ -45,6 +39,8 @@ class DialogFactory {
                 originMemberId: options.originMemberId,
                 askerDialogId: options.askerDialogId,
                 callId: options.callId,
+                callSiteCourse: options.callSiteCourse,
+                callSiteGenseq: options.callSiteGenseq,
                 collectiveTargets: options.collectiveTargets,
                 effectiveFbrEffort: options.effectiveFbrEffort,
             },

package/dist/dialog-fork.js

@@ -140,7 +140,8 @@ function isPersistedMessageRecord(record) {
         case 'user_image_ingest_record':
         case 'sideDialog_request_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_anchor_record':
+        case 'tellask_anchor_record':
+        case 'tellask_callee_record':
         case 'gen_start_record':
         case 'gen_finish_record':
         case 'sideDialog_created_record':
@@ -212,7 +213,8 @@ function rewriteRecordForFork(record, newRootId) {
         case 'native_tool_call_record':
         case 'sideDialog_request_record':
         case 'tellask_reply_resolution_record':
-        case 'tellask_call_anchor_record':
+        case 'tellask_anchor_record':
+        case 'tellask_callee_record':
         case 'gen_start_record':
         case 'gen_finish_record':
             return record;

package/dist/dialog.d.ts

@@ -122,6 +122,8 @@ export interface AssignmentFromAsker {
     originMemberId: string;
     askerDialogId: string;
     callId: string;
+    callSiteCourse: CallSiteCourseNo;
+    callSiteGenseq: CallSiteGenseqNo;
     collectiveTargets?: string[];
     effectiveFbrEffort?: number;
 }
@@ -253,8 +255,11 @@ export declare abstract class Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
+        effectiveFbrEffort?: number;
     }): Promise<SideDialog>;
     /**
      * Post a dialog event using the standard event registry.
@@ -468,6 +473,8 @@ export declare class SideDialog extends Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;
@@ -528,6 +535,8 @@ export declare class MainDialog extends Dialog {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;
@@ -561,6 +570,8 @@ export declare abstract class DialogStore {
         originMemberId: string;
         askerDialogId: string;
         callId: string;
+        callSiteCourse: CallSiteCourseNo;
+        callSiteGenseq: CallSiteGenseqNo;
         sessionSlug?: string;
         collectiveTargets?: string[];
         effectiveFbrEffort?: number;

package/dist/dialog.js

@@ -126,6 +126,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     ownerDialogId: assignment.askerDialogId,
                     callType: 'B',
                     callId: assignment.callId,
+                    callSiteCourse: assignment.callSiteCourse,
+                    callSiteGenseq: assignment.callSiteGenseq,
                 },
             };
         case 'tellaskSessionless':
@@ -141,6 +143,8 @@ function buildSideDialogAssignmentPromptMeta(sideDialog) {
                     ownerDialogId: assignment.askerDialogId,
                     callType: 'C',
                     callId: assignment.callId,
+                    callSiteCourse: assignment.callSiteCourse,
+                    callSiteGenseq: assignment.callSiteGenseq,
                 },
             };
     }
@@ -1791,6 +1795,8 @@ class DialogStore {
             originMemberId: options.originMemberId,
             askerDialogId: options.askerDialogId,
             callId: options.callId,
+            callSiteCourse: options.callSiteCourse,
+            callSiteGenseq: options.callSiteGenseq,
             collectiveTargets: options.collectiveTargets,
             effectiveFbrEffort: options.effectiveFbrEffort,
         };

package/dist/docs/dialog-system.md

@@ -1305,6 +1305,21 @@ sequenceDiagram
   end
 ```
 
+Call-site correspondence invariant: every `tellask` call-site `callId` must later have a
+same-`callId` historical correspondence point in the tellasker's dialog. A normal sideDialog reply,
+cross-course carryover, or registered-session replacement notice can close the call; silently removing
+or overwriting a pending round cannot.
+
+WebUI external-link invariant: every `/dl/*` URL must be generated at the business call site with the
+target semantics written out there; avoid generic deep-link helpers. `/dl/callsite` only means the
+originating bubble in the tellasker's dialog: `selfId/course` are tellasker-dialog coordinates, and
+`callId` is that dialog's function-call id. SideDialog assignment/update targets are not call sites;
+they use `/dl/dialog` for the sideDialog, or `/dl/genseq` once the delivered assignment `genseq` is
+known.
+When an existing registered sideDialog is reused, the WebUI first links the new call-site bubble to
+the sideDialog via `tellask_call_callee_evt`; the later `tellask_call_anchor_evt` upgrades that target
+to the delivered sideDialog `genseq`.
+
 #### TYPE C: Transient SideDialog Tellask (`Fresh Tellask`) (`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`; `freshBootsReasoning({ tellaskContent: "..." })` is FBR tool-less)
 
 ```mermaid

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

@@ -1287,6 +1287,17 @@ sequenceDiagram
   end
 ```
 
+call-site 呼应不变量：每个 `tellask` 发起点的 `callId`，后续都必须在诉请者对话历史里留下同
+`callId` 的呼应点。正常支线回复、跨程 carryover、已注册会话被更新后的替代通知都可以结束这次
+call；不能静默删除或覆盖 pending 轮次。
+
+WebUI 外链不变量：生成 `/dl/*` URL 时必须在业务现场显式写出目标语义，避免复用泛化 deep-link
+helper。`/dl/callsite` 只表示诉请者对话里的发起气泡：`selfId/course` 是诉请者对话坐标，`callId`
+是该对话内的 function-call id。支线投递/更新目标不是 call-site，应使用 `/dl/dialog` 指向支线对话，
+或在投递 `genseq` 已知后使用 `/dl/genseq` 指向支线对话内的投递生成。
+复用已有注册支线时，WebUI 先用 `tellask_call_callee_evt` 把新发起气泡连到支线对话；后续
+`tellask_call_anchor_evt` 到达后再升级为支线投递 `genseq`。
+
 #### TYPE C：瞬态支线对话诉请（一次性诉请）（`tellaskSessionless({ targetAgentId: "agentId", tellaskContent: "..." })`，或 `freshBootsReasoning({ tellaskContent: "..." })`）
 
 ```mermaid

package/dist/docs/q4h.md

@@ -68,13 +68,15 @@ When a message bubble has a meaningful call site reference (e.g. “response ↔
 
 ### Query parameter schema
 
-The WebUI recognizes `window.location.search` deep link parameters.
+The WebUI recognizes deep links by `/dl/<kind>` paths plus `window.location.search` parameters.
 
-Common parameters:
+Implementation rule: external-link generation must write the `/dl/*` URL and every field's business
+meaning directly at the generating call site; avoid generic deep-link helpers. For `/dl/callsite`,
+`selfId/course/callId` only identify the originating bubble in the tellasker's dialog. SideDialog
+assignment/update targets must use `/dl/dialog`, or `/dl/genseq` once the delivered assignment
+`genseq` is known.
 
-- `dl`: deep link kind (`q4h` | `callsite`)
-
-#### `dl=q4h` (Q4H question deep link)
+#### `/dl/q4h` (Q4H question deep link)
 
 Required:
 
@@ -95,7 +97,7 @@ Behavior:
 - If the Q4H is not pending (already answered/cleared), the WebUI still scrolls to the call site but does **not**
   enter answer mode (no selection); it may show a toast indicating the question is no longer pending.
 
-#### `dl=callsite` (generic tellask call site deep link)
+#### `/dl/callsite` (generic tellask call site deep link)
 
 Required:
 
@@ -109,7 +111,7 @@ Behavior:
 - The WebUI navigates to the dialog + course and scrolls to the calling section with `data-call-id=callId`.
 - The input is focused (normal message mode).
 
-#### `dl=genseq` (generation bubble deep link)
+#### `/dl/genseq` (generation bubble deep link)
 
 Required:
 
@@ -126,9 +128,11 @@ Behavior:
 ### URL examples
 
 ```text
-/?dl=q4h&qid=q4h-abc123&rootId=R1&selfId=S2&course=3&callId=call-xyz&msg=12
+/dl/q4h?qid=q4h-abc123&rootId=R1&selfId=S2&course=3&callId=call-xyz&msg=12
+
+/dl/callsite?rootId=R1&selfId=R1&course=1&callId=call-xyz
 
-/?dl=callsite&rootId=R1&selfId=R1&course=1&callId=call-xyz
+/dl/genseq?rootId=R1&selfId=S2&course=3&genseq=42
 ```
 
 Notes:
@@ -159,7 +163,7 @@ Back-compat:
 
 - `dominds-q4h-panel`:
   - Keeps internal navigation (same tab).
-  - Adds an external icon action that opens a deep link (`dl=q4h`) in a new tab/window.
+  - Adds an external icon action that opens a deep link (`/dl/q4h`) in a new tab/window.
 - `dominds-app`:
   - Parses deep link parameters once at startup and stores a pending deep link intent.
   - Applies the intent after dialogs and (when needed) Q4H state are available.

package/dist/docs/q4h.zh.md

@@ -69,15 +69,15 @@ Q4H 是 Dominds 的运行时机制：在任何对话中通过向 `askHuman({ tel
 
 ## Deep Link 契约（WebUI）
 
-### Query 参数约定
+### URL 约定
 
-WebUI 通过 `window.location.search` 识别 deep link 参数。
+WebUI 通过 `/dl/<kind>` 路径和 `window.location.search` 参数识别 deep link。
 
-通用参数：
+实现规则：生成外链的代码必须在生成现场直接写出 `/dl/*` URL 和每个字段的业务含义，避免泛化
+deep-link helper。`/dl/callsite` 的 `selfId/course/callId` 只表示诉请者对话里的发起气泡；支线投递
+或更新目标应使用 `/dl/dialog` 或已知投递 `genseq` 后的 `/dl/genseq`。
 
-- `dl`：deep link 类型（`q4h` | `callsite`）
-
-#### `dl=q4h`（Q4H 提问点 deep link）
+#### `/dl/q4h`（Q4H 提问点 deep link）
 
 必需：
 
@@ -97,7 +97,7 @@ WebUI 通过 `window.location.search` 识别 deep link 参数。
 - 若该 Q4H 仍待处理：输入框选中 `qid`（回答模式）并聚焦。
 - 若该 Q4H 已不再待处理（已回答/已清理）：仍定位/高亮提问点，但**不进入回答模式**（不选中问题）；可提示“已不再待处理”。
 
-#### `dl=callsite`（通用 tellask call site deep link）
+#### `/dl/callsite`（通用 tellask call site deep link）
 
 必需：
 
@@ -111,7 +111,7 @@ WebUI 通过 `window.location.search` 识别 deep link 参数。
 - WebUI 切换到目标对话 + course，并滚动到 `data-call-id=callId` 对应的 calling section。
 - 输入框聚焦（普通消息模式）。
 
-#### `dl=genseq`（生成气泡 deep link）
+#### `/dl/genseq`（生成气泡 deep link）
 
 必需：
 
@@ -128,9 +128,11 @@ WebUI 通过 `window.location.search` 识别 deep link 参数。
 ### URL 示例
 
 ```text
-/?dl=q4h&qid=q4h-abc123&rootId=R1&selfId=S2&course=3&callId=call-xyz&msg=12
+/dl/q4h?qid=q4h-abc123&rootId=R1&selfId=S2&course=3&callId=call-xyz&msg=12
+
+/dl/callsite?rootId=R1&selfId=R1&course=1&callId=call-xyz
 
-/?dl=callsite&rootId=R1&selfId=R1&course=1&callId=call-xyz
+/dl/genseq?rootId=R1&selfId=S2&course=3&genseq=42
 ```
 
 说明：
@@ -161,7 +163,7 @@ WebUI 通过 `window.location.search` 识别 deep link 参数。
 
 - `dominds-q4h-panel`：
   - 保留内链“去提问点”。
-  - 增加外链图标按钮：打开 `dl=q4h` deep link（新 tab/窗口）。
+  - 增加外链图标按钮：打开 `/dl/q4h` deep link（新 tab/窗口）。
 - `dominds-app`：
   - 启动时解析 deep link，并保存“待执行导航意图”。
   - 在 dialogs / Q4H state 到齐后尝试执行意图。

package/dist/docs/tellask-revive-context-refactor.zh.md

@@ -406,6 +406,7 @@ auto-revive 能因为某个 wait-group 齐活而继续 drive，并不等于 owne
 replace pending 不是 silent overwrite，也不是 failed-result fallback。它是显式栈操作：
 
 - 定位旧 frame 的匹配键必须稳定，倾向使用 `askerDialogId + targetCallId` / `ownerDialogId + callId`，具体以 pending record 与 reply directive 对齐后的字段为准；
+- 每个 `tellask` call-site 的 `callId` 最终都必须在诉请者对话历史里有同 `callId` 的呼应点；被替换时，这个呼应点就是替代通知 / carryover result，而不是等支线对话后续回复时才补；
 - 如果 replace 找不到旧 frame，必须 loud fail，不允许降级成普通 push；
 - 因为持久文件采用 append/truncate-only JSONL，replace 的落盘算法是：
   1. 读取 stack frames 与每行 byte offset；

package/dist/llm/kernel-driver/drive.js

@@ -1579,7 +1579,7 @@ async function driveDialogStreamCore(dlg, callbacks, humanPrompt, driveOptions)
                             }
                             const record = {
                                 ts: (0, time_1.formatUnifiedTimestamp)(new Date()),
-                                type: 'tellask_call_anchor_record',
+                                type: 'tellask_anchor_record',
                                 anchorRole: 'assignment',
                                 callId: normalizedCallId,
                                 genseq: dlg.activeGenSeq,
@@ -1590,6 +1590,37 @@ async function driveDialogStreamCore(dlg, callbacks, humanPrompt, driveOptions)
                             };
                             const course = dlg.activeGenCourseOrUndefined ?? dlg.currentCourse;
                             await persistence_1.DialogPersistence.appendEvent(dlg.id, course, record, dlg.status);
+                            if (dlg instanceof dialog_1.SideDialog) {
+                                const ownerDialogId = new dialog_1.DialogID(replyTarget.ownerDialogId, dlg.id.rootId);
+                                const ownerDialogStatus = ownerDialogId.selfId === dlg.mainDialog.id.selfId
+                                    ? dlg.mainDialog.status
+                                    : dlg.status;
+                                const calleeCourse = (0, storage_1.toCalleeCourseNumber)(course);
+                                const calleeGenseq = (0, storage_1.toCalleeGenerationSeqNumber)(dlg.activeGenSeq);
+                                const calleeRecord = {
+                                    ts: (0, time_1.formatUnifiedTimestamp)(new Date()),
+                                    type: 'tellask_callee_record',
+                                    ...(0, storage_1.toRootGenerationAnchor)({
+                                        rootCourse: dlg.mainDialog.currentCourse,
+                                        rootGenseq: dlg.mainDialog.activeGenSeqOrUndefined ?? 0,
+                                    }),
+                                    genseq: replyTarget.callSiteGenseq,
+                                    callId: normalizedCallId,
+                                    calleeDialogId: dlg.id.selfId,
+                                    calleeCourse,
+                                    calleeGenseq,
+                                };
+                                await persistence_1.DialogPersistence.appendEvent(ownerDialogId, replyTarget.callSiteCourse, calleeRecord, ownerDialogStatus);
+                                (0, evt_registry_1.postDialogEventById)(ownerDialogId, {
+                                    type: 'tellask_callee_evt',
+                                    course: replyTarget.callSiteCourse,
+                                    genseq: replyTarget.callSiteGenseq,
+                                    callId: normalizedCallId,
+                                    calleeDialogId: dlg.id.selfId,
+                                    calleeCourse,
+                                    calleeGenseq,
+                                });
+                            }
                         }
                     }
                     await dlg.processReminderUpdates();

package/dist/llm/kernel-driver/flow.js

@@ -273,7 +273,7 @@ async function inspectNoPromptSideDialogDrive(args) {
         }
         return courseEvents[courseEvents.length - 1];
     })();
-    const lastEvent = rawLastEvent?.type === 'tellask_call_anchor_record'
+    const lastEvent = rawLastEvent?.type === 'tellask_anchor_record'
         ? { type: rawLastEvent.type, anchorRole: rawLastEvent.anchorRole }
         : rawLastEvent
             ? { type: rawLastEvent.type }
@@ -282,7 +282,7 @@ async function inspectNoPromptSideDialogDrive(args) {
         latest?.executionMarker?.kind === 'interrupted';
     const supplyResponseParentReviveAllowed = source === 'kernel_driver_supply_response_parent_revive' &&
         hasNoPromptSideDialogResumeEntitlement(args.dialog, args.driveOptions);
-    if (lastEvent?.type === 'tellask_call_anchor_record' && lastEvent.anchorRole === 'response') {
+    if (lastEvent?.type === 'tellask_anchor_record' && lastEvent.anchorRole === 'response') {
         return {
             shouldReject: true,
             source,

package/dist/llm/kernel-driver/sideDialog.d.ts

@@ -1,8 +1,17 @@
 import { type AskerCourseNumber } from '@longrun-ai/kernel/types/storage';
 import { Dialog, DialogID, SideDialog } from '../../dialog';
+import { type DialogPersistenceStatus } from '../../dialog-instance-registry';
 import type { KernelDriverDriveCallOptions, KernelDriverSideDialogReplyTarget } from './types';
 export type SideDialogReplyTarget = KernelDriverSideDialogReplyTarget;
 export type ScheduleDriveFn = (dialog: Dialog, options: KernelDriverDriveCallOptions) => void;
+export declare function resolveLatestAssignmentAnchorRef(args: {
+    calleeDialogId: DialogID;
+    callId: string;
+    status: DialogPersistenceStatus;
+}): Promise<{
+    course: number;
+    genseq: number;
+} | undefined>;
 export declare function supplyResponseToAskerDialog(args: {
     parentDialog: Dialog;
     sideDialogId: DialogID;

package/dist/llm/kernel-driver/sideDialog.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLatestAssignmentAnchorRef = resolveLatestAssignmentAnchorRef;
 exports.supplyResponseToAskerDialog = supplyResponseToAskerDialog;
 exports.supplySideDialogResponseToSpecificAskerIfPendingV2 = supplySideDialogResponseToSpecificAskerIfPendingV2;
 exports.supplySideDialogResponseToAssignedAskerIfPendingV2 = supplySideDialogResponseToAssignedAskerIfPendingV2;
@@ -130,7 +131,7 @@ async function resolveLatestAssignmentAnchorRef(args) {
         const courseEvents = await persistence_1.DialogPersistence.loadCourseEvents(args.calleeDialogId, course, args.status);
         for (let i = courseEvents.length - 1; i >= 0; i -= 1) {
             const event = courseEvents[i];
-            if (event.type !== 'tellask_call_anchor_record') {
+            if (event.type !== 'tellask_anchor_record') {
                 continue;
             }
             if (event.anchorRole !== 'assignment') {
@@ -347,7 +348,7 @@ async function supplyResponseToAskerDialog(args) {
             }
             const anchorRecord = {
                 ts: (0, time_1.formatUnifiedTimestamp)(new Date()),
-                type: 'tellask_call_anchor_record',
+                type: 'tellask_anchor_record',
                 anchorRole: 'response',
                 callId: resolvedCallId,
                 genseq: calleeResponseRef.genseq,
@@ -369,6 +370,7 @@ async function supplyResponseToAskerDialog(args) {
             await persistence_1.DialogPersistence.appendEvent(sideDialogId, calleeResponseRef.course, anchorRecord, parentDialog.status);
         }
         await syncPendingTellaskReminderBestEffort(parentDialog, 'kernel-driver:supplyResponseToAskerDialog');
+        const responseRouteRef = calleeResponseRef;
         await parentDialog.receiveTellaskResponse(result.responderId, result.callName, result.mentionList, result.tellaskContent, status, sideDialogId, {
             response: tellaskerResponseText,
             agentId: result.responderAgentId ?? result.responderId,
@@ -382,11 +384,11 @@ async function supplyResponseToAskerDialog(args) {
                     : undefined,
             carryoverContent,
             sessionSlug: result.sessionSlug,
-            calleeCourse: calleeResponseRef !== undefined
-                ? (0, storage_1.toCalleeCourseNumber)(calleeResponseRef.course)
+            calleeCourse: responseRouteRef !== undefined
+                ? (0, storage_1.toCalleeCourseNumber)(responseRouteRef.course)
                 : undefined,
-            calleeGenseq: calleeResponseRef !== undefined
-                ? (0, storage_1.toCalleeGenerationSeqNumber)(calleeResponseRef.genseq)
+            calleeGenseq: responseRouteRef !== undefined
+                ? (0, storage_1.toCalleeGenerationSeqNumber)(responseRouteRef.genseq)
                 : undefined,
         });
         const immediateMirror = carryoverContent !== undefined
@@ -415,11 +417,11 @@ async function supplyResponseToAskerDialog(args) {
                             mentionList: result.mentionList ?? [],
                         }
                         : {}),
-                ...(calleeResponseRef !== undefined
+                ...(responseRouteRef !== undefined
                     ? {
                         calleeDialogId: sideDialogId.selfId,
-                        calleeCourse: calleeResponseRef.course,
-                        calleeGenseq: calleeResponseRef.genseq,
+                        calleeCourse: responseRouteRef.course,
+                        calleeGenseq: responseRouteRef.genseq,
                     }
                     : {
                         calleeDialogId: sideDialogId.selfId,
@@ -461,10 +463,10 @@ async function supplyResponseToAskerDialog(args) {
                 },
                 route: {
                     calleeDialogId: sideDialogId.selfId,
-                    ...(calleeResponseRef !== undefined
+                    ...(responseRouteRef !== undefined
                         ? {
-                            calleeCourse: calleeResponseRef.course,
-                            calleeGenseq: calleeResponseRef.genseq,
+                            calleeCourse: responseRouteRef.course,
+                            calleeGenseq: responseRouteRef.genseq,
                         }
                         : {}),
                 },