nolo-cli 0.1.29 → 0.1.31

package/server/handlers/agentRun/saveDialog.ts

@@ -1,10 +1,11 @@
 // packages/server/handlers/agentRun/saveDialog.ts
 // 将 agentRun 执行结果持久化为真实 Dialog（含完整消息轨迹），所有调用方含 localhost。
 
-import { formatISO } from "date-fns";
-import { monotonicFactory } from "ulid";
-import serverDb from "../../../database/server/db";
-import { createKey, createDialogKey, createDialogMessageKeyAndId } from "../../../database/keys";
+import { formatISO } from "date-fns";
+import { monotonicFactory } from "ulid";
+import { getServerAuthorityStore } from "../../../database/server/db";
+import { writeStoreOps } from "../../../database/server/storeBatchCompat";
+import { createKey, createDialogKey, createDialogMessageKeyAndId } from "../../../database/keys";
 import { extractCustomId } from "../../../core/prefix";
 import { DataType } from "../../../create/types";
 import { createSpaceKey } from "../../../create/space/spaceKeys";
@@ -29,24 +30,27 @@ import type {
 } from "../../../app/types";
 import { buildDialogRuntimeBinding } from "./runtimeBinding";
 import type { AgentRunRuntimeContext } from "./types";
+
+const getSaveDialogStore = () => getServerAuthorityStore();
 
 /**
  * 将 Dialog 注册到 Space 的 contents 中，使其在侧边栏可见。
  * 如果 spaceId 不存在或 space 记录读不到，静默跳过。
  */
-async function addDialogToSpace(
-    spaceId: string,
-    dialogKey: string,
-    title: string,
-    categoryId?: string
-): Promise<void> {
-    const spaceKey = createSpaceKey.space(spaceId);
-    let spaceData: any;
-    try {
-        spaceData = await serverDb.get(spaceKey);
-    } catch (_) {
-        return; // space 不存在，跳过
-    }
+async function addDialogToSpace(
+    spaceId: string,
+    dialogKey: string,
+    title: string,
+    categoryId?: string
+): Promise<void> {
+    const db = getSaveDialogStore();
+    const spaceKey = createSpaceKey.space(spaceId);
+    let spaceData: any;
+    try {
+        spaceData = await db.get(spaceKey);
+    } catch (_) {
+        return; // space 不存在，跳过
+    }
     if (!spaceData) return;
     const existingContent = spaceData?.contents?.[dialogKey];
     if (
@@ -73,23 +77,24 @@ async function addDialogToSpace(
     if (categoryId) {
         nextContent.categoryId = categoryId;
     }
-    await serverDb.put(spaceKey, {
-        ...spaceData,
-        updatedAt: now,
-        contents: {
+    await db.put(spaceKey, {
+        ...spaceData,
+        updatedAt: now,
+        contents: {
             ...(spaceData.contents ?? {}),
             [dialogKey]: nextContent,
         },
     });
 }
 
-async function resolveSpaceName(spaceId?: string): Promise<string | undefined> {
-    if (!spaceId) return undefined;
-    try {
-        const space = await serverDb.get(createSpaceKey.space(spaceId));
-        if (typeof space?.name === "string" && space.name.trim()) {
-            return space.name;
-        }
+async function resolveSpaceName(spaceId?: string): Promise<string | undefined> {
+    if (!spaceId) return undefined;
+    const db = getSaveDialogStore();
+    try {
+        const space = await db.get(createSpaceKey.space(spaceId));
+        if (typeof space?.name === "string" && space.name.trim()) {
+            return space.name;
+        }
     } catch (_) { }
     return undefined;
 }
@@ -539,17 +544,17 @@ function parseUiAskChoiceContent(rawContent: unknown): {
     };
 }
 
-async function findRecentUiAskChoiceSelection(opts: {
-    dialogId: string;
-    userInput: string;
-}): Promise<UiAskChoiceSelection | null> {
+async function findRecentUiAskChoiceSelection(opts: {
+    dialogId: string;
+    userInput: string;
+}): Promise<UiAskChoiceSelection | null> {
     const normalizedUserInput = opts.userInput.trim();
     if (!normalizedUserInput) return null;
 
-    const previousMessages = await fetchMessages(serverDb, opts.dialogId, {
-        limit: 12,
-        throwOnError: true,
-    });
+    const previousMessages = await fetchMessages(getSaveDialogStore(), opts.dialogId, {
+        limit: 12,
+        throwOnError: true,
+    });
 
     for (const message of previousMessages) {
         if (message.role !== "tool") continue;
@@ -609,11 +614,12 @@ async function buildDialogLineageFields(opts: {
             ? { parentDialogId: explicitParentDialogId, rootDialogId: explicitParentDialogId }
             : {};
     }
-
+
     let inheritedFromDialogTitle: string | undefined;
     let parentDialog: any;
+    const db = getSaveDialogStore();
     try {
-        parentDialog = await serverDb.get(inheritedFromDialogKey);
+        parentDialog = await db.get(inheritedFromDialogKey);
         if (typeof parentDialog?.title === "string" && parentDialog.title.trim()) {
             inheritedFromDialogTitle = parentDialog.title.trim();
         }
@@ -638,7 +644,7 @@ async function buildDialogLineageFields(opts: {
 /**
  * 立即写入 status=pending 的 Dialog 骨架，供 background 模式先返回 dialogId。
  */
-export async function createPendingDialog(opts: {
+export async function createPendingDialog(opts: {
     agentKey: string;
     userId: string | null;
     callerType: "jwt" | "localhost";
@@ -681,14 +687,15 @@ export async function createPendingDialog(opts: {
         runtimeToolPolicySnapshot: opts.runtimeToolPolicySnapshot,
         workspaceLease: opts.workspaceLease,
     });
-    const dialogTags = mergeDialogTags(undefined, [
-        `trigger:${triggerType}`,
-        "mode:background",
-    ]);
-
-    await serverDb.put(dialogKey, {
-        id: dialogId,
-        dbKey: dialogKey,
+    const dialogTags = mergeDialogTags(undefined, [
+        `trigger:${triggerType}`,
+        "mode:background",
+    ]);
+    const db = getSaveDialogStore();
+
+    await db.put(dialogKey, {
+        id: dialogId,
+        dbKey: dialogKey,
         type: DataType.DIALOG,
         cybots: [agentKey],
         primaryAgentKey: agentKey,
@@ -708,11 +715,11 @@ export async function createPendingDialog(opts: {
         ...(dialogTags ? { tags: dialogTags } : {}),
     });
 
-    // 先写用户消息（在执行前就可见）
-    const userMsgInfo = createDialogMessageKeyAndId(dialogId);
-    await serverDb.put(userMsgInfo.key, {
-        id: userMsgInfo.messageId,
-        dbKey: userMsgInfo.key,
+    // 先写用户消息（在执行前就可见）
+    const userMsgInfo = createDialogMessageKeyAndId(dialogId);
+    await db.put(userMsgInfo.key, {
+        id: userMsgInfo.messageId,
+        dbKey: userMsgInfo.key,
         role: "user",
         content: userInput,
         userId: effectiveUserId,
@@ -753,13 +760,14 @@ export async function finalizeDialog(opts: {
 }): Promise<void> {
     const { dialogId, dialogKey, agentKey, result, startedAt, status = "done" } = opts;
     const defaultTraceAgentKey = opts.traceAgentKey ?? agentKey;
-    const now = Date.now();
-    const nowIso = formatISO(new Date(now));
-    const durationMs = now - startedAt;
-
-    // 更新 Dialog 元信息
-    let existing: any = {};
-    try { existing = await serverDb.get(dialogKey); } catch (_) { }
+    const now = Date.now();
+    const nowIso = formatISO(new Date(now));
+    const durationMs = now - startedAt;
+    const db = getSaveDialogStore();
+
+    // 更新 Dialog 元信息
+    let existing: any = {};
+    try { existing = await db.get(dialogKey); } catch (_) { }
     const effectiveUserId = extractDialogUserId(dialogKey, dialogId) ?? existing.userId ?? null;
     const effectiveSpaceId = existing.spaceId;
     const runtimeBinding = buildDialogRuntimeBinding({
@@ -810,7 +818,7 @@ export async function finalizeDialog(opts: {
     }
     const toolTraceFacts = buildToolTraceFacts({ trace, toolCallIdToName });
 
-    await serverDb.put(dialogKey, {
+    await db.put(dialogKey, {
         ...existing,
         primaryAgentKey: existing.primaryAgentKey ?? agentKey,
         ...(taskLabel ? { taskLabel } : {}),
@@ -838,7 +846,7 @@ export async function finalizeDialog(opts: {
             ? toolCallIdToName.get((msg as any).tool_call_id)
             : undefined;
 
-        await serverDb.put(info.key, buildPersistedTraceMessage({
+        await db.put(info.key, buildPersistedTraceMessage({
             info,
             msg,
             nowIso,
@@ -866,8 +874,8 @@ export async function finalizeDialog(opts: {
             })
             : undefined;
     if (runtimeCheckpoint) {
-        await serverDb.put(dialogKey, {
-            ...(await serverDb.get(dialogKey).catch(() => ({}))),
+        await db.put(dialogKey, {
+            ...(await db.get(dialogKey).catch(() => ({}))),
             toolCallCount: runtimeCheckpoint.toolCallCount,
             runtimeCheckpoint,
         });
@@ -892,10 +900,10 @@ export async function finalizeDialog(opts: {
             dialogId,
             userInput: opts.userInput,
         });
-        await captureUnderstandingMemoryFromDialog({
-            db: serverDb,
-            userId: opts.userId ?? null,
-            spaceId: opts.spaceId ?? effectiveSpaceId,
+        await captureUnderstandingMemoryFromDialog({
+            db,
+            userId: opts.userId ?? null,
+            spaceId: opts.spaceId ?? effectiveSpaceId,
             agentKey,
             dialogId,
             userInput: opts.userInput,
@@ -961,12 +969,13 @@ export async function saveRunAsDialog(opts: {
         runtimeToolPolicySnapshot: opts.runtimeToolPolicySnapshot,
         workspaceLease: opts.workspaceLease,
     });
-    const dialogTags = mergeDialogTags(undefined, [
-        `trigger:${triggerType}`,
-        "mode:foreground",
-    ]);
-
-    // 使用单调递增 ULID 工厂保证 user + trace 消息的 key 顺序 == 写入/逻辑顺序
+    const dialogTags = mergeDialogTags(undefined, [
+        `trigger:${triggerType}`,
+        "mode:foreground",
+    ]);
+    const db = getSaveDialogStore();
+
+    // 使用单调递增 ULID 工厂保证 user + trace 消息的 key 顺序 == 写入/逻辑顺序
     const mono = monotonicFactory();
 
     const userMsgInfo = createDialogMessageKeyAndId(dialogId, mono);
@@ -1067,7 +1076,7 @@ export async function saveRunAsDialog(opts: {
         previousRuntimeCheckpoint: undefined,
     });
 
-    await serverDb.batch(ops);
+    await writeStoreOps(db, ops);
 
     // 绑定到 Space（使 Dialog 在侧边栏可见）
     // 同步模式直接推 dialog.done，让前端直接跳过 running 状态
@@ -1100,10 +1109,10 @@ export async function saveRunAsDialog(opts: {
         dialogId,
         userInput,
     });
-    await captureUnderstandingMemoryFromDialog({
-        db: serverDb,
-        userId,
-        spaceId,
+    await captureUnderstandingMemoryFromDialog({
+        db,
+        userId,
+        spaceId,
         agentKey,
         dialogId,
         userInput,
@@ -1152,7 +1161,8 @@ export async function appendToExistingDialog(opts: {
     const now = Date.now();
     const nowIso = formatISO(new Date(now));
     const defaultTraceAgentKey = traceAgentKey ?? agentKey;
-    const fallbackDialogTitle = buildDialogFallbackTitleFromUserInput(userInput);
+    const fallbackDialogTitle = buildDialogFallbackTitleFromUserInput(userInput);
+    const db = getSaveDialogStore();
 
     // 重建 dialogKey（结构：DIALOG-{userId}-{dialogId}）
     const dialogKey =
@@ -1163,9 +1173,9 @@ export async function appendToExistingDialog(opts: {
         extractDialogUserId(dialogKey, dialogId) ??
         "server";
 
-    // 更新 dialog 元数据（累加 toolCallCount / durationMs）
-    let existing: any = null;
-    try { existing = await serverDb.get(dialogKey); } catch (_) { }
+    // 更新 dialog 元数据（累加 toolCallCount / durationMs）
+    let existing: any = null;
+    try { existing = await db.get(dialogKey); } catch (_) { }
     const existingDialog =
         existing && typeof existing === "object" ? existing : {};
     const effectiveSpaceId = existingDialog.spaceId ?? spaceId;
@@ -1313,7 +1323,7 @@ export async function appendToExistingDialog(opts: {
         ops[0]!.value.runtimeCheckpoint?.toolCallCount ?? 0,
     );
 
-    await serverDb.batch(ops);
+    await writeStoreOps(db, ops);
 
     if (effectiveSpaceId) {
         pushEvent(`space-${effectiveSpaceId}`, { type: "dialog.done", dialogId });
@@ -1337,10 +1347,10 @@ export async function appendToExistingDialog(opts: {
         dialogId,
         userInput,
     });
-    await captureUnderstandingMemoryFromDialog({
-        db: serverDb,
-        userId,
-        spaceId: effectiveSpaceId,
+    await captureUnderstandingMemoryFromDialog({
+        db,
+        userId,
+        spaceId: effectiveSpaceId,
         agentKey,
         dialogId,
         userInput,

package/server/handlers/agentRun/taskRunToolHandler.ts

@@ -1,6 +1,6 @@
-import serverDb, { ensureServerDbOpen } from "../../../database/server/db";
+import { ensureServerDbOpen, getServerAuthorityStore } from "../../../database/server/db";
 import { rowKey } from "../../../database/keys";
-import { handleToken } from "../../../auth/server/token";
+import { readUserFromRequest } from "../../../auth/server/token";
 import { fetchMessages } from "../../../chat/messages/fetchMessages";
 import {
   clearTaskRunBlocker,
@@ -131,8 +131,9 @@ function collectDialogIdsFromRow(row: any, meta: any): string[] {
 }
 
 async function summarizeDialogEvidence(dialogId: string, userId: string) {
+  const store = getServerAuthorityStore();
   const dialogKey = `dialog-${userId}-${dialogId}`;
-  const dialog = await serverDb.get(dialogKey).catch(() => null);
+  const dialog = await store.get(dialogKey).catch(() => null);
   if (!dialog || dialog.deletedAt) {
     return {
       dialogId,
@@ -142,7 +143,7 @@ async function summarizeDialogEvidence(dialogId: string, userId: string) {
     };
   }
 
-  const messages = await fetchMessages(serverDb, dialogId, {
+  const messages = await fetchMessages(store, dialogId, {
     limit: EVIDENCE_DIALOG_LIMIT,
   });
   const ordered = [...messages].reverse();
@@ -213,7 +214,7 @@ async function getUserIdFromToken(authToken: string): Promise<string> {
         name.toLowerCase() === "authorization" ? `Bearer ${authToken}` : null,
     },
   };
-  const user = await handleToken(req, {});
+  const user = await readUserFromRequest(req);
   if (!user?.userId) throw new Error("Unauthorized: userId not found");
   return user.userId;
 }
@@ -323,11 +324,12 @@ function ensureSelfWorkItem(args: {
 export async function runTaskRunToolForUser(args: TaskRunToolArgs, userId: string): Promise<string> {
   try {
     await ensureServerDbOpen();
+    const store = getServerAuthorityStore();
     const action = args.action;
     if (!action) throw new Error("taskRun.action is required.");
 
     const rowDbKey = resolveTaskRowDbKey(args);
-    const row = await serverDb.get(rowDbKey).catch(() => null);
+    const row = await store.get(rowDbKey).catch(() => null);
     if (!row || row.deletedAt) throw new Error(`Task row not found: ${rowDbKey}`);
     if (row.tenantId !== userId) throw new Error("Forbidden: task row tenant mismatch");
 
@@ -558,7 +560,7 @@ export async function runTaskRunToolForUser(args: TaskRunToolArgs, userId: strin
     }
 
     const updated = { ...row, meta, updatedAt: now };
-    await serverDb.put(rowDbKey, updated);
+    await store.put(rowDbKey, updated);
     return json({
       ok: true,
       action,

package/server/handlers/agentRun/toolExecutor.ts

@@ -63,10 +63,9 @@ import {
     summarizeParallelBudget,
     summarizeParallelCosts,
 } from "../../../ai/tools/agent/parallelBudget";
-import {
-    extractAgentRuntimeServerBase,
-    normalizeServerOrigin,
-} from "../../../ai/agent/runtimeServerBase";
+import {
+    normalizeServerOrigin,
+} from "../../../ai/agent/serverOrigin";
 import { extractEmailVerificationArtifacts } from "../../../ai/tools/emailTools";
 import { convertMarxistsBookToOfflineHtml } from "../../../ai/tools/marxistsOfflineBook";
 import { formatMarxistsOfflineBookDisplayData } from "../../../ai/tools/convertMarxistsBookTool";
@@ -84,7 +83,7 @@ import {
     clampDialogSearchNumber,
     normalizeDialogSearchText,
 } from "../../../ai/tools/dialogMessageSearch";
-import serverDb from "../../../database/server/db";
+import { getServerAuthorityStore } from "../../../database/server/db";
 import { createSpaceKey } from "../../../create/space/spaceKeys";
 import {
     buildDeleteSpacesPreview,
@@ -105,6 +104,8 @@ import {
 import { runTaskRunTool } from "./taskRunToolHandler";
 import { projectDialogActivityToSubjectRows } from "./tableActivityProjection";
 import { resolveExistingDialogRef } from "./dialogLookup";
+
+const getToolExecutorStore = () => getServerAuthorityStore();
 
 const APP_DEPLOY_POLL_INTERVAL_MS = 250;
 const APP_DEPLOY_POLL_TIMEOUT_MS = 60_000;
@@ -451,7 +452,7 @@ export const resolveDelegatedServerBase = (
     };
 };
 
-export { extractAgentRuntimeServerBase, normalizeServerOrigin };
+export { normalizeServerOrigin };
 
 const buildDelegatedAgentInput = (task: string, input: unknown): string => {
     if (input === undefined || input === null) return task;
@@ -701,10 +702,11 @@ async function buildReferencedDialogEvidenceLines(args: {
 }
 
 async function countDialogMessages(dialogId: string, max = 200): Promise<{ count: number; truncated: boolean }> {
+    const store = getToolExecutorStore();
     let count = 0;
     const gte = createKey(DataType.DIALOG, dialogId, "msg", "");
     const lte = createKey(DataType.DIALOG, dialogId, "msg", "\uffff");
-    for await (const _ of serverDb.iterator({ gte, lte })) {
+    for await (const _ of store.iterator({ gte, lte })) {
         count += 1;
         if (count > max) return { count: max, truncated: true };
     }
@@ -1000,45 +1002,14 @@ export async function executeToolOnServer(
             idempotencyKey?: string;
         },
     ) => {
-        let effectiveRequestedServerBase = requestedServerBase;
-        let autoRouted = false;
-        const allowedRemoteServerBases = getAllowedRemoteServerBases();
-        if (
-            allowedRemoteServerBases.length > 0 &&
-            (typeof requestedServerBase !== "string" || !requestedServerBase.trim())
-        ) {
-            try {
-                const res = await fetch(`${mainBase}/api/v1/db/read/${encodeURIComponent(agentKey)}`, {
-                    headers: buildAuthHeaders(),
-                });
-                if (res.ok) {
-                    const raw = await res.json();
-                    const agentRecord = raw?.data ?? raw;
-                    const runtimeServerBase = extractAgentRuntimeServerBase(agentRecord);
-                    const runtimeOrigin = runtimeServerBase
-                        ? normalizeServerOrigin(runtimeServerBase)
-                        : null;
-                    const mainOrigin = normalizeServerOrigin(mainBase);
-                    if (runtimeOrigin && runtimeOrigin !== mainOrigin) {
-                        effectiveRequestedServerBase = runtimeOrigin;
-                        autoRouted = true;
-                    }
-                }
-            } catch {
-                // Best effort only. If metadata cannot be read, run on the current server.
-            }
-        }
-
-        const target = resolveDelegatedServerBase(effectiveRequestedServerBase, mainBase);
-        if (!target.ok) {
-            return {
-                ok: false as const,
-                status: 400,
-                error: autoRouted
-                    ? `${target.error} Target agent declares this runtime serverBase in its delegation metadata.`
-                    : target.error,
-            };
-        }
+        const target = resolveDelegatedServerBase(requestedServerBase, mainBase);
+        if (!target.ok) {
+            return {
+                ok: false as const,
+                status: 400,
+                error: target.error,
+            };
+        }
 
         const childRunBase = resolveSameOriginChildRunBase(target.base, mainBase);
         const childSubjectRefs = mergeSubjectRefs(
@@ -1083,14 +1054,11 @@ export async function executeToolOnServer(
             };
         }
         const payload = await res.json();
-        return {
-            ok: true as const,
-            payload,
-            ...(typeof effectiveRequestedServerBase === "string" && effectiveRequestedServerBase.trim()
-                ? { serverBase: target.base }
-                : {}),
-            ...(autoRouted ? { autoRouted: true } : {}),
-        };
+        return {
+            ok: true as const,
+            payload,
+            serverBase: target.base,
+        };
     };
 
     const waitForAppDeployResult = async (jobId: string) => {
@@ -1469,13 +1437,12 @@ export async function executeToolOnServer(
                 });
             }
             const payload = childRun.payload;
-            return JSON.stringify({
-                success: true,
-                agentKey,
-                ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
-                ...(childRun.autoRouted ? { autoRouted: true } : {}),
-                dialogId: payload?.dialogId ?? null,
-                model: payload?.model ?? null,
+            return JSON.stringify({
+                success: true,
+                agentKey,
+                ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
+                dialogId: payload?.dialogId ?? null,
+                model: payload?.model ?? null,
                 provider: payload?.provider ?? null,
                 content: typeof payload?.content === "string" ? payload.content : "",
                 usage: payload?.usage ?? null,
@@ -1503,8 +1470,7 @@ export async function executeToolOnServer(
                 success: true,
                 handoff: true,
                 agentKey,
-                ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
-                ...(childRun.autoRouted ? { autoRouted: true } : {}),
+                ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
                 dialogId: payload?.dialogId ?? null,
                 ...(payload?.dialogKey ? { dialogKey: payload.dialogKey } : {}),
                 model: payload?.model ?? null,
@@ -1587,7 +1553,7 @@ export async function executeToolOnServer(
                 : undefined;
             const activityProjection = childDialogId
                 ? await projectDialogActivityToSubjectRows({
-                    db: serverDb,
+                    db: getToolExecutorStore(),
                     subjectRefs: childSubjectRefs,
                     activityRef: {
                         type: "dialog",
@@ -1611,7 +1577,6 @@ export async function executeToolOnServer(
                 childDialogKey: childDialogKey ?? null,
                 ...(parentDialogId ? { parentDialogId } : {}),
                 ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
-                ...(childRun.autoRouted ? { autoRouted: true } : {}),
                 ...(activityProjection && activityProjection.updatedRowDbKeys.length
                     ? {
                         activityProjection: {
@@ -1709,19 +1674,18 @@ export async function executeToolOnServer(
                                     : null,
                         },
                     });
-                    return {
-                        ok: true,
-                        label,
-                        branchId,
-                        parallelSessionId,
-                        parallelIndex: index,
-                        agentKey,
-                        agentName: label,
-                        ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
-                        ...(childRun.autoRouted ? { autoRouted: true } : {}),
-                        dialogId: payload?.dialogId ?? null,
-                        model: payload?.model ?? null,
-                        provider: payload?.provider ?? null,
+                    return {
+                        ok: true,
+                        label,
+                        branchId,
+                        parallelSessionId,
+                        parallelIndex: index,
+                        agentKey,
+                        agentName: label,
+                        ...(childRun.serverBase ? { serverBase: childRun.serverBase } : {}),
+                        dialogId: payload?.dialogId ?? null,
+                        model: payload?.model ?? null,
+                        provider: payload?.provider ?? null,
                         content:
                             typeof payload?.content === "string" ? payload.content.trim() : "",
                         usage: payload?.usage ?? null,

package/server/handlers/agentRun/types.ts

@@ -35,7 +35,7 @@ export interface AgentRunRequest {
                 };
             }
         >;
-    messages?: ChatMessage[]; // 历史对话，调用方自行管理（不持久化）
+    messages?: ChatMessage[]; // 调用方携带的消息历史；continueDialogId 存在时仅作为加载 persisted history 失败时的 fallback
     runtimeContext?: AgentRunRuntimeContext;
     stream?: boolean;
     maxRounds?: number; // 兼容旧客户端保留，服务端当前不再按工具轮次限制
@@ -74,6 +74,7 @@ export interface AgentRunRuntimeContext {
 export interface LoopResult extends Omit<AgentRuntimeResult, "policyState"> {
     policyState?: DialogPolicyState;
     artifacts?: unknown;
+    providerCallIds?: string[];
 }
 
 export interface ToolPolicyRuntimeState {