@linnlabs/linnkit 0.8.0 → 0.10.0

package/dist/index.cjs

@@ -48,14 +48,18 @@ __export(runtime_kernel_exports, {
   UserNode: () => UserNode,
   WaitUserNode: () => WaitUserNode,
   agentHasToolTrigger: () => agentHasToolTrigger,
+  appendStreamingProviderReasoningDetails: () => appendStreamingProviderReasoningDetails,
   applySystemReminders: () => applySystemReminders,
   audit: () => audit_exports,
   budgetWarningTrigger: () => budgetWarningTrigger,
   childRunTrace: () => child_run_trace_exports,
   childRuns: () => child_runs_exports,
+  compactProviderReasoningDetails: () => compactProviderReasoningDetails,
+  compactReasoningDetailsInValue: () => compactReasoningDetailsInValue,
   computeToolIdempotencyKey: () => computeToolIdempotencyKey,
   consoleAudit: () => consoleAudit,
   contextBudgetWarningTemplate: () => contextBudgetWarningTemplate,
+  copyToolContextRuntimeCapability: () => copyToolContextRuntimeCapability,
   countToolCallsInCurrentRequest: () => countToolCallsInCurrentRequest,
   createCompositeAudit: () => createCompositeAudit,
   createConsoleAudit: () => createConsoleAudit,
@@ -561,6 +565,7 @@ var AgentSpecBudgetPolicy = zod.z.object({
 });
 var AgentSpecToolHistoryPolicy = zod.z.object({
   strategy: zod.z.enum(["per-pair", "per-run", "none"]).optional(),
+  retentionMode: zod.z.enum(["drop", "compress"]).optional(),
   keepLatestToolPairs: zod.z.number().int().nonnegative().optional(),
   keepLatestRuns: zod.z.number().int().nonnegative().optional(),
   maxInteractionGroups: zod.z.number().int().nonnegative().optional(),
@@ -683,12 +688,13 @@ var AgentSpecContextPolicy = zod.z.object({
 var DEFAULT_CONTEXT_POLICY = {
   profileId: "agent",
   budget: {
-    maxTokens: 12e4,
+    maxTokens: 232e3,
     reservedForResponse: 2400,
     workingMemoryBudgetPercentage: 0.7
   },
   toolHistory: {
     strategy: "per-run",
+    retentionMode: "drop",
     keepLatestToolPairs: 2,
     keepLatestRuns: 1,
     maxInteractionGroups: 12,
@@ -1540,6 +1546,17 @@ var logger = new Logger("GraphExecutor");
 function asLocalRecord(local) {
   return local && typeof local === "object" ? { ...local } : {};
 }
+function readNonEmptyString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+function readRuntimeConversationId(state) {
+  const local = state?.local && typeof state.local === "object" ? state.local : void 0;
+  return readNonEmptyString(local?.conversationId);
+}
+function readRuntimeTurnId(state) {
+  const local = state?.local && typeof state.local === "object" ? state.local : void 0;
+  return readNonEmptyString(local?.turnId);
+}
 var GraphExecutor = class {
   constructor(checkpointer, config = {}) {
     this.checkpointer = checkpointer;
@@ -1557,8 +1574,8 @@ var GraphExecutor = class {
   registerNode(node) {
     this.nodes.set(node.id, node);
   }
-  async peekCheckpoint(conversationId) {
-    return await this.checkpointer.load(conversationId);
+  async peekCheckpoint(checkpointKey) {
+    return await this.checkpointer.load(checkpointKey);
   }
   sanitize(state) {
     const local = asLocalRecord(state.local);
@@ -1570,8 +1587,8 @@ var GraphExecutor = class {
       local
     };
   }
-  async prime(conversationId, local, nodeId = "user") {
-    this.ephemeralLocals.set(conversationId, { ...local || {} });
+  async prime(checkpointKey, local, nodeId = "user") {
+    this.ephemeralLocals.set(checkpointKey, { ...local || {} });
     const localSansMemory = { ...local || {} };
     if ("memory" in localSansMemory) delete localSansMemory.memory;
     const state = {
@@ -1579,10 +1596,10 @@ var GraphExecutor = class {
       schemaVersion: ENGINE_STATE_SCHEMA_VERSION,
       local: localSansMemory
     };
-    await this.checkpointer.save(conversationId, state);
+    await this.checkpointer.save(checkpointKey, state);
   }
-  async setNode(conversationId, nodeId, localPatch) {
-    const current = await this.checkpointer.load(conversationId) || {
+  async setNode(checkpointKey, nodeId, localPatch) {
+    const current = await this.checkpointer.load(checkpointKey) || {
       schemaVersion: ENGINE_STATE_SCHEMA_VERSION,
       local: {}
     };
@@ -1593,19 +1610,46 @@ var GraphExecutor = class {
       schemaVersion: current.schemaVersion ?? ENGINE_STATE_SCHEMA_VERSION,
       local: mergedLocal
     };
-    await this.checkpointer.save(conversationId, next);
+    await this.checkpointer.save(checkpointKey, next);
   }
-  async runUntilYield(conversationId) {
+  async runUntilYield(checkpointKey) {
     const runId = `run_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
     let lifecyclePhase = "completed";
+    let initialState = null;
+    try {
+      initialState = await this.loadInitialState(checkpointKey);
+    } catch (err) {
+      lifecyclePhase = "failed";
+      this.telemetryPort.emit({
+        kind: "run_lifecycle",
+        runId,
+        phase: "spawned",
+        scope: {}
+      });
+      this.telemetryPort.emit({
+        kind: "run_lifecycle",
+        runId,
+        phase: lifecyclePhase,
+        scope: {}
+      });
+      throw err;
+    }
+    let lifecycleConversationId = readRuntimeConversationId(initialState);
+    let lifecycleTurnId = readRuntimeTurnId(initialState);
     this.telemetryPort.emit({
       kind: "run_lifecycle",
       runId,
       phase: "spawned",
-      scope: { conversationId: conversationId || void 0 }
+      scope: {
+        conversationId: lifecycleConversationId,
+        turnId: lifecycleTurnId
+      }
     });
     try {
-      return await this.runUntilYieldInternal(conversationId);
+      const result = await this.runUntilYieldInternal(checkpointKey, initialState);
+      lifecycleConversationId = readRuntimeConversationId(result.checkpoint);
+      lifecycleTurnId = readRuntimeTurnId(result.checkpoint);
+      return result;
     } catch (err) {
       lifecyclePhase = err?.name === "AbortError" ? "cancelled" : "failed";
       throw err;
@@ -1614,17 +1658,23 @@ var GraphExecutor = class {
         kind: "run_lifecycle",
         runId,
         phase: lifecyclePhase,
-        scope: { conversationId: conversationId || void 0 }
+        scope: {
+          conversationId: lifecycleConversationId,
+          turnId: lifecycleTurnId
+        }
       });
     }
   }
-  async runUntilYieldInternal(conversationId) {
-    let state = await this.checkpointer.load(conversationId) || {
+  async loadInitialState(checkpointKey) {
+    return await this.checkpointer.load(checkpointKey) || {
       nodeId: "user",
       schemaVersion: ENGINE_STATE_SCHEMA_VERSION,
       local: {}
     };
-    const ephemeral = this.ephemeralLocals.get(conversationId) || {};
+  }
+  async runUntilYieldInternal(checkpointKey, initialState) {
+    let state = initialState;
+    const ephemeral = this.ephemeralLocals.get(checkpointKey) || {};
     state = {
       ...state,
       schemaVersion: state.schemaVersion ?? ENGINE_STATE_SCHEMA_VERSION,
@@ -1653,7 +1703,7 @@ var GraphExecutor = class {
       const signalRaw = state.local?.signal;
       if (isAbortSignal2(signalRaw) && signalRaw.aborted) {
         logger.warn("[GraphExecutor] \u6536\u5230 AbortSignal\uFF0C\u7ACB\u5373\u505C\u6B62\u63A8\u7406\u5FAA\u73AF");
-        this.ephemeralLocals.delete(conversationId);
+        this.ephemeralLocals.delete(checkpointKey);
         throwAbortError();
       }
       const isLastStep = cycleStepCount >= this.config.maxSteps;
@@ -1701,8 +1751,8 @@ var GraphExecutor = class {
           checkpointCount
         });
         const cp2 = this.sanitize(state);
-        await this.checkpointer.save(conversationId, cp2);
-        this.ephemeralLocals.delete(conversationId);
+        await this.checkpointer.save(checkpointKey, cp2);
+        this.ephemeralLocals.delete(checkpointKey);
         return { events: allEvents, checkpoint: cp2, stepCount };
       }
       logger.info("[GraphExecutor] \u8282\u70B9\u5207\u6362", {
@@ -1713,18 +1763,18 @@ var GraphExecutor = class {
       });
       const nodeRunStartedAt = Date.now();
       const nodeIdForTelemetry = state.nodeId;
+      const conversationIdForTelemetry = readRuntimeConversationId(state);
       let result;
       try {
         result = await node.run(state);
       } finally {
-        const turnIdForTelemetry = typeof state.local?.turnId === "string" ? state.local.turnId : void 0;
         this.telemetryPort.emit({
           kind: "graph_node",
           nodeId: nodeIdForTelemetry,
           durationMs: Date.now() - nodeRunStartedAt,
           scope: {
-            conversationId: conversationId || void 0,
-            turnId: turnIdForTelemetry
+            conversationId: conversationIdForTelemetry,
+            turnId: readRuntimeTurnId(state)
           }
         });
       }
@@ -1763,7 +1813,7 @@ var GraphExecutor = class {
         });
         state = { ...state, nodeId: nextNodeId };
         const cp2 = this.sanitize(state);
-        await this.checkpointer.save(conversationId, cp2);
+        await this.checkpointer.save(checkpointKey, cp2);
         continue;
       }
       if (result.kind === "yield") {
@@ -1774,7 +1824,7 @@ var GraphExecutor = class {
           checkpointCount
         });
         const cp2 = this.sanitize(state);
-        await this.checkpointer.save(conversationId, cp2);
+        await this.checkpointer.save(checkpointKey, cp2);
         return { events: allEvents, checkpoint: cp2, stepCount };
       }
       if (result.kind === "pause") {
@@ -1785,7 +1835,7 @@ var GraphExecutor = class {
           checkpointCount
         });
         const cp2 = this.sanitize(state);
-        await this.checkpointer.save(conversationId, cp2);
+        await this.checkpointer.save(checkpointKey, cp2);
         return { events: allEvents, checkpoint: cp2, stepCount };
       }
     }
@@ -1796,8 +1846,8 @@ var GraphExecutor = class {
       checkpointCount
     });
     const cp = this.sanitize(state);
-    await this.checkpointer.save(conversationId, cp);
-    this.ephemeralLocals.delete(conversationId);
+    await this.checkpointer.save(checkpointKey, cp);
+    this.ephemeralLocals.delete(checkpointKey);
     return { events: allEvents, checkpoint: cp, stepCount };
   }
 };
@@ -1994,15 +2044,15 @@ function splitConcatenatedJsonObjects(input) {
 }
 
 // src/runtime-kernel/graph-engine/tick-pipeline/helpers.ts
-function readNonEmptyString(value) {
+function readNonEmptyString2(value) {
   if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
 function resolveConversationIdForRuntimeEvents(toolContext) {
-  const fromCamel = readNonEmptyString(toolContext?.conversationId);
+  const fromCamel = readNonEmptyString2(toolContext?.conversationId);
   if (fromCamel) return fromCamel;
-  const fromSnake = toolContext ? readNonEmptyString(toolContext["conversation_id"]) : void 0;
+  const fromSnake = toolContext ? readNonEmptyString2(toolContext["conversation_id"]) : void 0;
   if (fromSnake) return fromSnake;
   return generateMessageId();
 }
@@ -2384,7 +2434,7 @@ var runModelLockMiddleware = async (ctx, stage, next) => {
   if (stage.id !== "execute_llm") {
     return;
   }
-  const normalized = readNonEmptyString(ctx.cloudQuotaFallbackAppliedModelId);
+  const normalized = readNonEmptyString2(ctx.cloudQuotaFallbackAppliedModelId);
   if (!normalized) {
     return;
   }
@@ -2985,7 +3035,7 @@ function createExecuteLlmStage(dependencies) {
         streamEventHandler,
         ctx.signal,
         (fallbackModelId) => {
-          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString(fallbackModelId);
+          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString2(fallbackModelId);
         },
         (info) => {
           ctx.modelFallbackAudit = info;
@@ -3029,7 +3079,7 @@ function createPrepareCallStage(dependencies) {
   return {
     id: "prepare_call",
     async run(ctx) {
-      const lockedRunModelId = readNonEmptyString(ctx.executorLocal?.runLockedModelId);
+      const lockedRunModelId = readNonEmptyString2(ctx.executorLocal?.runLockedModelId);
       const requestedModelId = lockedRunModelId ?? ctx.request.model_id;
       ctx.modelId = dependencies.modelResolver.resolveModelId(requestedModelId);
       await emitAuditEnvelope(ctx.audit, {
@@ -3101,7 +3151,7 @@ var GraphAgentExecutor = class {
     this.llmCaller = dependencies.llmCaller;
     this.toolRuntime = dependencies.toolRuntime;
     this.contextBuilder = dependencies.contextBuilder;
-    this.cloudQuotaFallbackModelId = readNonEmptyString(dependencies.cloudQuotaFallbackModelId);
+    this.cloudQuotaFallbackModelId = readNonEmptyString2(dependencies.cloudQuotaFallbackModelId);
     this.modelCatalog = dependencies.modelCatalog ?? createEmptyModelCatalog();
     this.modelResolver = dependencies.modelResolver ?? new ModelResolver({
       modelCatalog: this.modelCatalog
@@ -3149,7 +3199,7 @@ var GraphAgentExecutor = class {
       llmMessages: [],
       mode: input.request.mode === "chat" ? "chat" : "agent",
       conversationId: resolveConversationIdForRuntimeEvents(input.toolContext),
-      turnId: readNonEmptyString(input.toolContext?.turnId) ?? `turn_${Date.now()}`,
+      turnId: readNonEmptyString2(input.toolContext?.turnId) ?? `turn_${Date.now()}`,
       telemetry: this.telemetryPort,
       audit: this.auditPort
     };
@@ -3199,18 +3249,18 @@ function isSummarizationCallbacks(value) {
 function isGraphSseSink(value) {
   return typeof value === "function";
 }
-function readNonEmptyString2(value) {
+function readNonEmptyString3(value) {
   if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
 function readGraphAgentLocal(local) {
   const source = local ?? {};
-  const answerId = readNonEmptyString2(source.answerId);
+  const answerId = readNonEmptyString3(source.answerId);
   const chunkSeq = Number.isInteger(source.chunkSeq) ? Number(source.chunkSeq) : 0;
   return {
-    conversationId: readNonEmptyString2(source.conversationId) ?? "",
-    turnId: readNonEmptyString2(source.turnId),
+    conversationId: readNonEmptyString3(source.conversationId) ?? "",
+    turnId: readNonEmptyString3(source.turnId),
     request: isAgentInvocationRequest(source.request) ? source.request : void 0,
     toolContext: isToolExecutionContext(source.toolContext) ? source.toolContext : void 0,
     history: isRuntimeEventArray(source.history) ? source.history : [],
@@ -3975,7 +4025,7 @@ var LlmNode = class {
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function readNonEmptyString3(value) {
+function readNonEmptyString4(value) {
   if (typeof value !== "string") {
     return void 0;
   }
@@ -3997,7 +4047,7 @@ function resolveFinalAnswerFromToolResult(toolName, parsedResult) {
     return void 0;
   }
   if (toolName === "write_report") {
-    const report = readNonEmptyString3(data.report);
+    const report = readNonEmptyString4(data.report);
     if (!report) {
       throw new Error("[write_report] \u5DE5\u5177\u8F93\u51FA\u7F3A\u5C11 data.report\uFF08\u5FC5\u987B\u63D0\u4F9B\u5B8C\u6574\u62A5\u544A\u6B63\u6587\uFF09");
     }
@@ -4007,7 +4057,7 @@ function resolveFinalAnswerFromToolResult(toolName, parsedResult) {
     if (data.success !== true) {
       return void 0;
     }
-    const finalAnswer = readNonEmptyString3(data.final_answer);
+    const finalAnswer = readNonEmptyString4(data.final_answer);
     if (!finalAnswer) {
       throw new Error("[research_run_writer] \u5DE5\u5177\u8F93\u51FA\u7F3A\u5C11 data.final_answer\uFF08success=true \u65F6\u5FC5\u987B\u63D0\u4F9B\u6700\u7EC8\u62A5\u544A\u6B63\u6587\uFF09");
     }
@@ -4557,6 +4607,31 @@ function ensureToolContextRuntimeCapability(params) {
 function getToolContextRuntimeBinding(context) {
   return readBinding(context);
 }
+function copyToolContextRuntimeCapability(source, target) {
+  const sourceBinding = readBinding(source);
+  if (!sourceBinding) {
+    return void 0;
+  }
+  const existingTargetBinding = readBinding(target);
+  if (existingTargetBinding) {
+    exposeCompatibilitySurface(target, existingTargetBinding);
+    return existingTargetBinding;
+  }
+  const targetBinding = createRuntimeBinding({
+    context: target,
+    persistedHistory: () => sourceBinding.getPersistedHistoryEvents(),
+    workingHistory: () => sourceBinding.getWorkingHistoryEvents(),
+    executionMeta: sourceBinding.readExecutionMeta()
+  });
+  Object.defineProperty(target, TOOL_CONTEXT_RUNTIME_BINDING_KEY, {
+    value: targetBinding,
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+  exposeCompatibilitySurface(target, targetBinding);
+  return targetBinding;
+}
 function readToolContextWorkingHistory(context) {
   if (context.conversationView) {
     return context.conversationView.getWorkingHistoryEvents();
@@ -4970,6 +5045,22 @@ var ToolNode = class {
     });
   }
   async run(state) {
+    const events = [];
+    while (true) {
+      const result = await this.runNextPendingToolCall(state);
+      if (Array.isArray(result.events) && result.events.length > 0) {
+        events.push(...result.events);
+      }
+      if (result.kind === "route" && result.nextNodeId === "tool") {
+        continue;
+      }
+      return {
+        ...result,
+        events
+      };
+    }
+  }
+  async runNextPendingToolCall(state) {
     const calls = state.local?.pendingToolCalls ?? [];
     const signalRaw = state.local?.signal;
     if (isAbortSignal(signalRaw) && signalRaw.aborted) {
@@ -5177,18 +5268,25 @@ var ToolNode = class {
       rawArguments: context.call.function?.arguments,
       parsedArguments: context.toolArgs
     });
+    const remainingCalls = context.calls.slice(1);
     context.state.local = buildErrorLocalState({
       local: context.local,
-      remainingCalls: context.calls.slice(1),
+      remainingCalls,
       conversationId: context.conversationId,
       turnId: context.turnId,
       runtimeEvents: context.bridge.getRuntimeEvents(),
       nextProtocolErrorCount: fuse.nextCount
     });
-    if (fuse.shouldFuse) {
+    if (fuse.shouldFuse && remainingCalls.length === 0) {
       throw createToolProtocolFuseError(fuse.nextCount, context.exec.error);
     }
-    return { kind: "route", nextNodeId: "llm", events: context.bridge.getRuntimeEvents() };
+    return {
+      kind: "route",
+      // 同一个 assistant.tool_calls batch 必须为每个 call 产出 tool_output。
+      // 出错时也继续消费剩余 call，ToolNode.run 会在本节点内 drain 完 batch 再回 LLM。
+      nextNodeId: remainingCalls.length > 0 ? "tool" : "llm",
+      events: context.bridge.getRuntimeEvents()
+    };
   }
 };
 
@@ -5385,12 +5483,12 @@ function asRecord(value) {
   }
   return value;
 }
-function summarizeCheckpoint(conversationId, state, savedAt) {
+function summarizeCheckpoint(checkpointKey, state, savedAt) {
   const local = asRecord(state.local);
   const executorLocal = asRecord(local?.executorLocal);
   const pendingToolCalls = local?.pendingToolCalls;
   return {
-    conversationId,
+    checkpointKey,
     schemaVersion: state.schemaVersion ?? 1,
     savedAt,
     currentNode: state.nodeId,
@@ -5409,25 +5507,25 @@ var MemoryCheckpointer = class {
       local: state.local && typeof state.local === "object" && !Array.isArray(state.local) ? { ...state.local } : state.local
     };
   }
-  async load(conversationId) {
-    const entry = this.store.get(conversationId);
+  async load(checkpointKey) {
+    const entry = this.store.get(checkpointKey);
     return entry ? this.cloneState(entry.state) : null;
   }
-  async save(conversationId, state) {
-    this.store.set(conversationId, {
+  async save(checkpointKey, state) {
+    this.store.set(checkpointKey, {
       state: this.cloneState(state),
       savedAt: Date.now()
     });
   }
-  async clear(conversationId) {
-    this.store.delete(conversationId);
+  async clear(checkpointKey) {
+    this.store.delete(checkpointKey);
   }
-  async peekMeta(conversationId) {
-    const entry = this.store.get(conversationId);
-    return entry ? summarizeCheckpoint(conversationId, entry.state, entry.savedAt) : null;
+  async peekMeta(checkpointKey) {
+    const entry = this.store.get(checkpointKey);
+    return entry ? summarizeCheckpoint(checkpointKey, entry.state, entry.savedAt) : null;
   }
   async list(filter = {}) {
-    const summaries = Array.from(this.store.entries()).map(([conversationId, entry]) => summarizeCheckpoint(conversationId, entry.state, entry.savedAt)).filter((summary) => filter.savedAfter === void 0 ? true : summary.savedAt > filter.savedAfter).sort((left, right) => right.savedAt - left.savedAt);
+    const summaries = Array.from(this.store.entries()).map(([checkpointKey, entry]) => summarizeCheckpoint(checkpointKey, entry.state, entry.savedAt)).filter((summary) => filter.savedAfter === void 0 ? true : summary.savedAt > filter.savedAfter).sort((left, right) => right.savedAt - left.savedAt);
     if (filter.limit === void 0) {
       return summaries;
     }
@@ -5499,6 +5597,7 @@ __export(tools_exports, {
   CommonParameterTypes: () => CommonParameterTypes,
   ContextCheckpointTool: () => ContextCheckpointTool,
   computeToolIdempotencyKey: () => computeToolIdempotencyKey,
+  copyToolContextRuntimeCapability: () => copyToolContextRuntimeCapability,
   createContextCheckpointTool: () => createContextCheckpointTool,
   ensureToolContextRuntimeCapability: () => ensureToolContextRuntimeCapability,
   findCachedToolOutputByIdempotencyKey: () => findCachedToolOutputByIdempotencyKey,
@@ -5692,7 +5791,7 @@ function createContextCheckpointTool(options) {
 function isRecord15(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
-function readNonEmptyString4(value) {
+function readNonEmptyString5(value) {
   if (typeof value !== "string") {
     return void 0;
   }
@@ -5712,13 +5811,13 @@ function readToolContextUserQuery(context) {
   if (!context) {
     return void 0;
   }
-  return readNonEmptyString4(context["user_query"]);
+  return readNonEmptyString5(context["user_query"]);
 }
 function readToolContextModelId(context) {
   if (!context) {
     return void 0;
   }
-  return readNonEmptyString4(context["modelId"]);
+  return readNonEmptyString5(context["modelId"]);
 }
 function readToolContextRunContext(context) {
   if (!context) {
@@ -5925,18 +6024,18 @@ function createClassification(category, reason, suggestedDelay, extras) {
 }
 var ErrorClassifier = class {
   static classify(error, context) {
-    const isRecord24 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+    const isRecord25 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
     const baseMsg = (error.message || "").toLowerCase();
     const causeMsg = (() => {
       const cause = error.cause;
       if (typeof cause === "string") return cause.toLowerCase();
       if (cause instanceof Error) return (cause.message || "").toLowerCase();
-      if (isRecord24(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
+      if (isRecord25(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
       return "";
     })();
     const causeCode = (() => {
       const cause = error.cause;
-      if (isRecord24(cause) && typeof cause["code"] === "string") return String(cause["code"]);
+      if (isRecord25(cause) && typeof cause["code"] === "string") return String(cause["code"]);
       return "";
     })();
     const errorMessage = `${baseMsg} ${causeMsg}`.trim();
@@ -6428,6 +6527,9 @@ __export(llm_exports, {
   LLMPolicyEngine: () => LLMPolicyEngine,
   LlmCaller: () => LlmCaller,
   ModelResolver: () => ModelResolver,
+  appendStreamingProviderReasoningDetails: () => appendStreamingProviderReasoningDetails,
+  compactProviderReasoningDetails: () => compactProviderReasoningDetails,
+  compactReasoningDetailsInValue: () => compactReasoningDetailsInValue,
   createDefaultTokenizerPort: () => createDefaultTokenizerPort,
   defaultPolicyEngine: () => defaultPolicyEngine
 });
@@ -6817,6 +6919,90 @@ function assertToolCallsHaveValidJsonArguments(toolCalls) {
   }
 }
 
+// src/runtime-kernel/llm/reasoning-details.ts
+var mergeableTextFields = ["reasoning_content"];
+function isRecord20(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function findMergeableTextField(detail) {
+  if (!isRecord20(detail)) return void 0;
+  if (typeof detail.provider !== "string") return void 0;
+  if (typeof detail.type !== "string") return void 0;
+  for (const field of mergeableTextFields) {
+    if (typeof detail[field] === "string") {
+      return field;
+    }
+  }
+  return void 0;
+}
+function hasOnlyStableTextDetailFields(detail, textField) {
+  const allowedKeys = /* @__PURE__ */ new Set(["provider", "type", textField]);
+  return Object.keys(detail).every((key) => allowedKeys.has(key));
+}
+function canMergeTextDetails(previous, incoming) {
+  if (!isRecord20(previous) || !isRecord20(incoming)) return false;
+  const previousField = findMergeableTextField(previous);
+  const incomingField = findMergeableTextField(incoming);
+  if (!previousField || previousField !== incomingField) return false;
+  return previous.provider === incoming.provider && previous.type === incoming.type && hasOnlyStableTextDetailFields(previous, previousField) && hasOnlyStableTextDetailFields(incoming, incomingField);
+}
+function mergeStreamingText(previous, incoming) {
+  if (!previous) return incoming;
+  if (!incoming) return previous;
+  if (incoming.startsWith(previous)) {
+    return incoming;
+  }
+  if (previous.endsWith(incoming)) {
+    return previous;
+  }
+  return `${previous}${incoming}`;
+}
+function appendStreamingProviderReasoningDetails(existing, incoming) {
+  const next = [...existing];
+  for (const detail of incoming) {
+    const previous = next[next.length - 1];
+    if (canMergeTextDetails(previous, detail)) {
+      const textField = findMergeableTextField(previous);
+      if (textField && isRecord20(detail)) {
+        const mergedText = mergeStreamingText(String(previous[textField]), String(detail[textField]));
+        if (mergedText === previous[textField]) {
+          continue;
+        }
+        next[next.length - 1] = {
+          ...previous,
+          [textField]: mergedText
+        };
+        continue;
+      }
+    }
+    next.push(detail);
+  }
+  return next;
+}
+function compactProviderReasoningDetails(reasoningDetails) {
+  return appendStreamingProviderReasoningDetails([], reasoningDetails);
+}
+function compactReasoningDetailsInValue(value) {
+  return compactValue(value);
+}
+function compactValue(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => compactValue(item));
+  }
+  if (!isRecord20(value)) {
+    return value;
+  }
+  const compacted = {};
+  for (const [key, childValue] of Object.entries(value)) {
+    if (key === "reasoning_details" && Array.isArray(childValue)) {
+      compacted[key] = compactProviderReasoningDetails(childValue);
+      continue;
+    }
+    compacted[key] = compactValue(childValue);
+  }
+  return compacted;
+}
+
 // src/runtime-kernel/llm/streaming-adapter.ts
 async function callLlmStream(params) {
   const {
@@ -6829,7 +7015,7 @@ async function callLlmStream(params) {
   } = params;
   let fullResponse = "";
   let streamError = null;
-  const reasoningDetails = [];
+  let reasoningDetails = [];
   const streamAnswerId = generateMessageId();
   let streamChunkSeq = 0;
   let capturedUsage = void 0;
@@ -6899,13 +7085,21 @@ async function callLlmStream(params) {
     const reasoning = isRecord19(chunk) ? chunk["reasoning_details"] : void 0;
     if (reasoning !== void 0) {
       const newReasoningDetails = Array.isArray(reasoning) ? reasoning : [reasoning];
-      reasoningDetails.push(...newReasoningDetails);
-      eventHandler({
-        type: "provider_sidecar",
-        id: generateMessageId(),
-        timestamp: Date.now(),
-        reasoning_details: newReasoningDetails
-      });
+      const previousReasoningDetails = reasoningDetails;
+      const previousLength = previousReasoningDetails.length;
+      const compactedReasoningDetails = appendStreamingProviderReasoningDetails(reasoningDetails, newReasoningDetails);
+      reasoningDetails = compactedReasoningDetails;
+      const previousLastChanged = previousLength > 0 && compactedReasoningDetails[previousLength - 1] !== previousReasoningDetails[previousLength - 1];
+      const emitFromIndex = previousLastChanged ? previousLength - 1 : previousLength;
+      const emittedReasoningDetails = compactedReasoningDetails.slice(Math.max(0, emitFromIndex));
+      if (emittedReasoningDetails.length > 0) {
+        eventHandler({
+          type: "provider_sidecar",
+          id: generateMessageId(),
+          timestamp: Date.now(),
+          reasoning_details: emittedReasoningDetails
+        });
+      }
     }
     if (chunk.tool_calls) {
       emitThoughtComplete(thoughtSegmenter.onBoundary());
@@ -7359,7 +7553,6 @@ __export(child_runs_exports, {
 
 // src/runtime-kernel/child-runs/childToolContext.ts
 function createChildRunToolContext(params) {
-  const inheritedConversationId = typeof params.parentToolContext.conversationId === "string" && params.parentToolContext.conversationId.trim().length > 0 ? params.parentToolContext.conversationId.trim() : void 0;
   const inheritedContext = stripRuntimeReservedToolContextPatch(params.parentToolContext);
   const childToolContext = {
     ...inheritedContext,
@@ -7371,7 +7564,7 @@ function createChildRunToolContext(params) {
     persistedHistory: params.seedHistory,
     workingHistory: params.seedHistory,
     executionMeta: {
-      conversationId: inheritedConversationId ?? params.internalConversationId,
+      conversationId: params.conversationId,
       turnId: params.turnId,
       runId: params.runId,
       parentRunId: params.parentRunId
@@ -7522,7 +7715,7 @@ var FinalAnswerCollector = class {
 };
 
 // src/runtime-kernel/child-runs/childRunTraceSink.ts
-function isRecord20(v) {
+function isRecord21(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
 function getString2(obj, key) {
@@ -7555,7 +7748,7 @@ function createChildRunTraceSink(params) {
   const { publisher, conversationId, turnId } = params;
   const finalAnswerCollector = new FinalAnswerCollector(conversationId, turnId);
   const sink = (evt) => {
-    if (!isRecord20(evt)) {
+    if (!isRecord21(evt)) {
       return [];
     }
     const type = getString2(evt, "type");
@@ -7691,7 +7884,7 @@ function readCheckpointHistory(checkpoint) {
   });
 }
 async function recoverChildRunEventsFromCheckpoint(params) {
-  const checkpoint = await params.checkpointer.load(params.conversationId);
+  const checkpoint = await params.checkpointer.load(params.checkpointKey);
   const history = readCheckpointHistory(checkpoint);
   if (history.length === 0) {
     return [];
@@ -7699,7 +7892,7 @@ async function recoverChildRunEventsFromCheckpoint(params) {
   if (hasSeedHistoryPrefix(history, params.seedHistory)) {
     return history.slice(params.seedHistory.length);
   }
-  return history.filter((event) => event.conversation_id === params.internalConversationId);
+  return history.filter((event) => event.conversation_id === params.childConversationId);
 }
 
 // src/runtime-kernel/child-runs/childRunInvoker.ts
@@ -7728,6 +7921,7 @@ var ChildRunInvoker = class {
       agentConfig,
       userMessage,
       parentToolContext,
+      conversationId,
       runId,
       parentRunId,
       subrunTracePublisher,
@@ -7736,12 +7930,18 @@ var ChildRunInvoker = class {
       modelId,
       abortSignal
     } = config;
-    const internalConversationId = `internal_${generateMessageId()}`;
+    const internalCheckpointKey = `internal_${generateMessageId()}`;
+    const runtimeConversationId = resolveChildRunConversationId({
+      explicitConversationId: conversationId,
+      parentToolContext,
+      fallbackConversationId: internalCheckpointKey
+    });
     const turnId = `turn_${Date.now()}`;
-    const childRunId = typeof runId === "string" && runId.trim().length > 0 ? runId.trim() : internalConversationId;
+    const childRunId = typeof runId === "string" && runId.trim().length > 0 ? runId.trim() : internalCheckpointKey;
     const resolvedParentRunId = typeof parentRunId === "string" && parentRunId.trim().length > 0 ? parentRunId.trim() : typeof parentToolContext.runId === "string" && parentToolContext.runId.trim().length > 0 ? parentToolContext.runId.trim() : void 0;
     logger13.info(`\u542F\u52A8 child-run: ${agentConfig.id}`, {
-      conversationId: internalConversationId,
+      conversationId: runtimeConversationId,
+      checkpointKey: internalCheckpointKey,
       maxSteps,
       userMessage: userMessage.slice(0, 100) + (userMessage.length > 100 ? "..." : "")
     });
@@ -7802,7 +8002,7 @@ var ChildRunInvoker = class {
     const seedHistory = Array.isArray(seedHistoryEvents) ? seedHistoryEvents : [];
     const childToolContext = createChildRunToolContext({
       parentToolContext,
-      internalConversationId,
+      conversationId: runtimeConversationId,
       turnId,
       runId: childRunId,
       parentRunId: resolvedParentRunId,
@@ -7811,13 +8011,13 @@ var ChildRunInvoker = class {
     });
     const subrunSseSink = subrunTracePublisher ? createChildRunTraceSink({
       publisher: subrunTracePublisher,
-      conversationId: internalConversationId,
+      conversationId: runtimeConversationId,
       turnId
     }) : void 0;
     const initialLocal = {
       request,
       history: seedHistory,
-      conversationId: internalConversationId,
+      conversationId: runtimeConversationId,
       turnId,
       toolContext: childToolContext,
       ...abortSignal ? { signal: abortSignal } : {},
@@ -7825,7 +8025,7 @@ var ChildRunInvoker = class {
       ...subrunSseSink ? { sseSink: subrunSseSink } : {},
       systemPrompt
     };
-    await graphExecutor.prime(internalConversationId, initialLocal, "llm");
+    await graphExecutor.prime(internalCheckpointKey, initialLocal, "llm");
     const allEvents = [];
     let stepCount = 0;
     let finalAnswer;
@@ -7837,7 +8037,7 @@ var ChildRunInvoker = class {
         err.name = "AbortError";
         throw err;
       }
-      const result = await graphExecutor.runUntilYield(internalConversationId);
+      const result = await graphExecutor.runUntilYield(internalCheckpointKey);
       appendUniqueEvents(allEvents, result.events);
       stepCount = result.stepCount;
       if (subrunSseSink && typeof subrunSseSink.finalize === "function") {
@@ -7871,8 +8071,8 @@ var ChildRunInvoker = class {
       }
       const recoveredEvents = await recoverChildRunEventsFromCheckpoint({
         checkpointer,
-        conversationId: internalConversationId,
-        internalConversationId,
+        checkpointKey: internalCheckpointKey,
+        childConversationId: runtimeConversationId,
         seedHistory
       });
       appendUniqueEvents(allEvents, recoveredEvents);
@@ -7889,7 +8089,7 @@ var ChildRunInvoker = class {
         stack: err.stack
       } : { error: String(err) });
     }
-    await checkpointer.clear(internalConversationId);
+    await checkpointer.clear(internalCheckpointKey);
     return {
       success: !error,
       runId: childRunId,
@@ -7902,6 +8102,16 @@ var ChildRunInvoker = class {
     };
   }
 };
+function readNonEmptyString6(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function resolveChildRunConversationId(params) {
+  return readNonEmptyString6(params.explicitConversationId) ?? readNonEmptyString6(params.parentToolContext.conversationId) ?? params.fallbackConversationId;
+}
 function resolveChildRunSystemReminderPolicy(agentConfig) {
   const configured = agentConfig.systemReminderPolicy ?? agentConfig.contextPolicy?.systemReminder;
   const threshold = agentConfig.stepPolicy?.lastStepsHintThreshold;
@@ -8092,7 +8302,7 @@ function cloneRunRecord(record) {
     ...record,
     iterationBudget: record.iterationBudget ? { ...record.iterationBudget } : void 0,
     errorIfAny: record.errorIfAny ? { ...record.errorIfAny } : void 0,
-    metadata: record.metadata ? { ...record.metadata } : void 0
+    metadata: record.metadata ? structuredClone(record.metadata) : void 0
   };
 }
 function matchesStatus(candidate, filter) {
@@ -8224,7 +8434,7 @@ function runRecordToMeta(record) {
     errorIfAny: record.errorIfAny ? { ...record.errorIfAny } : void 0
   };
 }
-function isRecord21(value) {
+function isRecord22(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStringField(record, key) {
@@ -8245,7 +8455,7 @@ function getRunIdFromMetadata(event) {
     return snakeCaseRunId;
   }
   const runContext = metadata["run_context"];
-  if (isRecord21(runContext)) {
+  if (isRecord22(runContext)) {
     return readStringField(runContext, "runId") ?? readStringField(runContext, "run_id");
   }
   return void 0;
@@ -8463,7 +8673,7 @@ function runMetaFromRecord(record) {
 }
 
 // src/runtime-kernel/run-supervisor/runSupervisor.ts
-function isRecord22(value) {
+function isRecord23(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStringField2(record, key) {
@@ -8480,7 +8690,7 @@ function readRunIdFromRuntimeEvent(event) {
     return directRunId;
   }
   const runContext = metadata["run_context"];
-  if (!isRecord22(runContext)) {
+  if (!isRecord23(runContext)) {
     return void 0;
   }
   return readStringField2(runContext, "runId") ?? readStringField2(runContext, "run_id");
@@ -8492,7 +8702,7 @@ function readAwaitingUserReason(event) {
   if (typeof event.prompt === "string" && event.prompt.trim().length > 0) {
     return event.prompt;
   }
-  if (isRecord22(event.form)) {
+  if (isRecord23(event.form)) {
     const prompt = readStringField2(event.form, "prompt");
     if (prompt && prompt.trim().length > 0) {
       return prompt;
@@ -8504,7 +8714,7 @@ function isTerminalStatus(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
 function cloneMetadata(metadata) {
-  return metadata ? { ...metadata } : void 0;
+  return metadata ? structuredClone(metadata) : void 0;
 }
 function recordToSnapshot(record) {
   return {
@@ -8591,7 +8801,7 @@ var DefaultRunSupervisor = class {
       startedAt,
       updatedAt: startedAt,
       iterationBudget: spec.iterationBudget ? { ...spec.iterationBudget } : void 0,
-      metadata: spec.metadata ? { ...spec.metadata } : void 0
+      metadata: cloneMetadata(spec.metadata)
     };
     await this.registryStore.save(record);
     const handle = new DefaultRunHandle({
@@ -8765,12 +8975,13 @@ var DefaultRunSupervisor = class {
     }
     try {
       await handle.markRunning({ currentNode: "detached" });
+      const registeredRecord = await this.registryStore.load(handle.runId);
       const executorOutcome = await this.executor.execute({
         runId: handle.runId,
-        parentRunId: spec.parentRunId,
-        conversationId: spec.conversationId,
-        agentSpec: spec.agentSpec,
-        request: spec.request,
+        parentRunId: handle.parentRunId,
+        conversationId: registeredRecord?.conversationId ?? spec.conversationId,
+        agentSpec: await handle.spec(),
+        request: await handle.request(),
         signal: handle.signal,
         eventBus: spec.eventBus,
         eventStore: spec.eventStore,
@@ -8779,7 +8990,7 @@ var DefaultRunSupervisor = class {
         contextFences: spec.contextFences,
         wakeSource: spec.wakeSource,
         ephemeral: spec.ephemeral,
-        metadata: spec.metadata
+        metadata: cloneMetadata(registeredRecord?.metadata ?? spec.metadata)
       });
       const outcome = await this.persistExecutorOutcome(handle, executorOutcome);
       this.notifyTerminalWaiters(outcome);
@@ -8843,10 +9054,14 @@ var DefaultRunSupervisor = class {
       await this.registryStore.save(record);
     }
     const completedAt = executorOutcome?.completedAt ?? this.now();
+    const fallbackMeta = record ? void 0 : await handle.meta();
     const outcome = recordToTerminalOutcome(record ?? {
       runId: handle.runId,
       parentRunId: handle.parentRunId,
-      status: executorOutcome?.status ?? "completed"}, completedAt);
+      conversationId: fallbackMeta?.conversationId ?? "",
+      agentSpecId: fallbackMeta?.agentSpecId,
+      status: executorOutcome?.status ?? "completed",
+      startedAt: fallbackMeta?.startedAt ?? completedAt}, completedAt);
     const nextOutcome = {
       ...outcome,
       metadata: {
@@ -9074,6 +9289,7 @@ function createGraphLoopHarness(options) {
   };
   return {
     async run() {
+      const checkpointKey = options.conversationId;
       const executor = createDefaultGraphExecutor({
         llmNode: options.createLlmNode({
           llmCaller: options.llmCaller,
@@ -9102,8 +9318,8 @@ function createGraphLoopHarness(options) {
         signal: options.signal ?? options.toolContext.abortSignal,
         executorLocal
       };
-      await executor.prime(options.conversationId, local, "user");
-      const result = await executor.runUntilYield(options.conversationId);
+      await executor.prime(checkpointKey, local, "user");
+      const result = await executor.runUntilYield(checkpointKey);
       return {
         checkpointNodeId: result.checkpoint.nodeId,
         stepCount: result.stepCount
@@ -9374,7 +9590,7 @@ function createQuickstartTelemetryPort(collector) {
 }
 
 // src/quickstart/runAgent.ts
-function isRecord23(value) {
+function isRecord24(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readString4(value) {
@@ -9388,7 +9604,7 @@ function resolveModelId(agent, options) {
   return modelId;
 }
 function isQuickstartStreamChunkEvent(value) {
-  return isRecord23(value) && value.type === "stream_chunk" && typeof value.content === "string";
+  return isRecord24(value) && value.type === "stream_chunk" && typeof value.content === "string";
 }
 function createNoopObservationPreview() {
   return {
@@ -9428,7 +9644,7 @@ function readFinalAnswer(events, checkpointLocal) {
   if (chunks.length > 0) {
     return chunks.join("");
   }
-  if (isRecord23(checkpointLocal)) {
+  if (isRecord24(checkpointLocal)) {
     const finalAnswer = checkpointLocal["finalAnswer"];
     if (typeof finalAnswer === "string") {
       return finalAnswer;
@@ -9437,7 +9653,7 @@ function readFinalAnswer(events, checkpointLocal) {
   return "";
 }
 function readContextTrace(checkpointLocal) {
-  if (!isRecord23(checkpointLocal)) return void 0;
+  if (!isRecord24(checkpointLocal)) return void 0;
   return checkpointLocal["contextTrace"];
 }
 async function emitRunEvent(event, sink) {
@@ -9446,6 +9662,7 @@ async function emitRunEvent(event, sink) {
 async function runAgent(agent, options) {
   const modelId = resolveModelId(agent, options);
   const conversationId = options.conversationId ?? `conv_${Date.now()}`;
+  const checkpointKey = conversationId;
   const runId = options.runId ?? generateRunId();
   const turnId = runId;
   const costCollector = new QuickstartRunCostCollector();
@@ -9500,7 +9717,7 @@ async function runAgent(agent, options) {
   };
   await handle.markRunning({ currentNode: "user" });
   try {
-    await executor.prime(conversationId, {
+    await executor.prime(checkpointKey, {
       conversationId,
       turnId,
       request: {
@@ -9525,7 +9742,7 @@ async function runAgent(agent, options) {
         return void 0;
       }
     });
-    const result = await executor.runUntilYield(conversationId);
+    const result = await executor.runUntilYield(checkpointKey);
     runtimeEvents.push(...result.events);
     for (const event of result.events) {
       if (event.type === "final_answer_chunk") continue;