@linnlabs/linnkit 0.8.0 → 0.10.0

package/dist/testkit.cjs

@@ -107,14 +107,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,
@@ -419,6 +423,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(),
@@ -1175,6 +1180,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;
@@ -1192,8 +1208,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);
@@ -1205,8 +1221,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 = {
@@ -1214,10 +1230,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: {}
     };
@@ -1228,19 +1244,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;
@@ -1249,17 +1292,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,
@@ -1288,7 +1337,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;
@@ -1336,8 +1385,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", {
@@ -1348,18 +1397,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)
           }
         });
       }
@@ -1398,7 +1447,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") {
@@ -1409,7 +1458,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") {
@@ -1420,7 +1469,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 };
       }
     }
@@ -1431,8 +1480,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 };
   }
 };
@@ -1629,15 +1678,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();
 }
@@ -1996,7 +2045,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;
   }
@@ -2597,7 +2646,7 @@ function createExecuteLlmStage(dependencies) {
         streamEventHandler,
         ctx.signal,
         (fallbackModelId) => {
-          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString(fallbackModelId);
+          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString2(fallbackModelId);
         },
         (info) => {
           ctx.modelFallbackAudit = info;
@@ -2641,7 +2690,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, {
@@ -2713,7 +2762,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
@@ -2761,7 +2810,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
     };
@@ -2811,18 +2860,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 : [],
@@ -3587,7 +3636,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;
   }
@@ -3609,7 +3658,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");
     }
@@ -3619,7 +3668,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");
     }
@@ -4164,6 +4213,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();
@@ -4577,6 +4651,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) {
@@ -4784,18 +4874,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()
+    };
   }
 };
 
@@ -4992,12 +5089,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,
@@ -5016,25 +5113,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;
     }
@@ -5106,6 +5203,7 @@ __export(tools_exports, {
   CommonParameterTypes: () => CommonParameterTypes,
   ContextCheckpointTool: () => ContextCheckpointTool,
   computeToolIdempotencyKey: () => computeToolIdempotencyKey,
+  copyToolContextRuntimeCapability: () => copyToolContextRuntimeCapability,
   createContextCheckpointTool: () => createContextCheckpointTool,
   ensureToolContextRuntimeCapability: () => ensureToolContextRuntimeCapability,
   findCachedToolOutputByIdempotencyKey: () => findCachedToolOutputByIdempotencyKey,
@@ -5299,7 +5397,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;
   }
@@ -5319,13 +5417,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) {
@@ -5532,18 +5630,18 @@ function createClassification(category, reason, suggestedDelay, extras) {
 }
 var ErrorClassifier = class {
   static classify(error, context) {
-    const isRecord26 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+    const isRecord27 = (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 (isRecord26(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
+      if (isRecord27(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
       return "";
     })();
     const causeCode = (() => {
       const cause = error.cause;
-      if (isRecord26(cause) && typeof cause["code"] === "string") return String(cause["code"]);
+      if (isRecord27(cause) && typeof cause["code"] === "string") return String(cause["code"]);
       return "";
     })();
     const errorMessage = `${baseMsg} ${causeMsg}`.trim();
@@ -6035,6 +6133,9 @@ __export(llm_exports, {
   LLMPolicyEngine: () => LLMPolicyEngine,
   LlmCaller: () => LlmCaller,
   ModelResolver: () => ModelResolver,
+  appendStreamingProviderReasoningDetails: () => appendStreamingProviderReasoningDetails,
+  compactProviderReasoningDetails: () => compactProviderReasoningDetails,
+  compactReasoningDetailsInValue: () => compactReasoningDetailsInValue,
   createDefaultTokenizerPort: () => createDefaultTokenizerPort,
   defaultPolicyEngine: () => defaultPolicyEngine
 });
@@ -6424,6 +6525,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 {
@@ -6436,7 +6621,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;
@@ -6506,13 +6691,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());
@@ -6966,7 +7159,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,
@@ -6978,7 +7170,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
@@ -7129,7 +7321,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) {
@@ -7162,7 +7354,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");
@@ -7298,7 +7490,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 [];
@@ -7306,7 +7498,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
@@ -7335,6 +7527,7 @@ var ChildRunInvoker = class {
       agentConfig,
       userMessage,
       parentToolContext,
+      conversationId,
       runId,
       parentRunId,
       subrunTracePublisher,
@@ -7343,12 +7536,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 ? "..." : "")
     });
@@ -7409,7 +7608,7 @@ var ChildRunInvoker = class {
     const seedHistory = Array.isArray(seedHistoryEvents) ? seedHistoryEvents : [];
     const childToolContext = createChildRunToolContext({
       parentToolContext,
-      internalConversationId,
+      conversationId: runtimeConversationId,
       turnId,
       runId: childRunId,
       parentRunId: resolvedParentRunId,
@@ -7418,13 +7617,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 } : {},
@@ -7432,7 +7631,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;
@@ -7444,7 +7643,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") {
@@ -7478,8 +7677,8 @@ var ChildRunInvoker = class {
       }
       const recoveredEvents = await recoverChildRunEventsFromCheckpoint({
         checkpointer,
-        conversationId: internalConversationId,
-        internalConversationId,
+        checkpointKey: internalCheckpointKey,
+        childConversationId: runtimeConversationId,
         seedHistory
       });
       appendUniqueEvents(allEvents, recoveredEvents);
@@ -7496,7 +7695,7 @@ var ChildRunInvoker = class {
         stack: err.stack
       } : { error: String(err) });
     }
-    await checkpointer.clear(internalConversationId);
+    await checkpointer.clear(internalCheckpointKey);
     return {
       success: !error,
       runId: childRunId,
@@ -7509,6 +7708,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;
@@ -7699,7 +7908,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) {
@@ -7831,7 +8040,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) {
@@ -7852,7 +8061,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;
@@ -8070,7 +8279,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) {
@@ -8087,7 +8296,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");
@@ -8099,7 +8308,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;
@@ -8111,7 +8320,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 {
@@ -8198,7 +8407,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({
@@ -8372,12 +8581,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,
@@ -8386,7 +8596,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);
@@ -8450,10 +8660,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: {
@@ -8681,6 +8895,7 @@ function createGraphLoopHarness(options) {
   };
   return {
     async run() {
+      const checkpointKey = options.conversationId;
       const executor = createDefaultGraphExecutor({
         llmNode: options.createLlmNode({
           llmCaller: options.llmCaller,
@@ -8709,8 +8924,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
@@ -8985,11 +9200,11 @@ new MessageFormatter();
 
 // src/context-manager/profiles/agent/utils/toolInteractionGroup.ts
 var CHECKPOINT_TOOL_NAME = "context_checkpoint";
-function isRecord23(value) {
+function isRecord24(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isToolCallRecord(value) {
-  if (!isRecord23(value)) {
+  if (!isRecord24(value)) {
     return false;
   }
   return typeof value.id === "string" && value.id.trim().length > 0;
@@ -9007,7 +9222,7 @@ function safeParseArgs(rawArgs) {
   }
   try {
     const parsed = JSON.parse(rawArgs);
-    return isRecord23(parsed) ? parsed : {};
+    return isRecord24(parsed) ? parsed : {};
   } catch {
     return {};
   }
@@ -9301,7 +9516,7 @@ var summarizeToolOutput = (toolName, output, toolSummaryProvider, toolArgs, conf
 };
 
 // src/context-manager/profiles/agent/utils/eventConverter.ts
-function isRecord24(value) {
+function isRecord25(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function isHistorySummaryEvent2(event) {
@@ -9359,10 +9574,10 @@ function convertEventToAiMessage(event) {
         timestamp: event.timestamp,
         metadata: {
           tool_calls: (() => {
-            const isRecord26 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+            const isRecord27 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
             const payload = event.payload;
             const toolCallsFromPayload = (() => {
-              if (!isRecord26(payload)) return void 0;
+              if (!isRecord27(payload)) return void 0;
               const raw = payload["tool_calls"];
               return Array.isArray(raw) ? raw : void 0;
             })();
@@ -9381,9 +9596,9 @@ function convertEventToAiMessage(event) {
             ];
           })(),
           reasoning_details: (() => {
-            const isRecord26 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+            const isRecord27 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
             const payload = event.payload;
-            if (!isRecord26(payload)) return void 0;
+            if (!isRecord27(payload)) return void 0;
             const rd = payload["reasoning_details"];
             return Array.isArray(rd) ? rd : void 0;
           })()
@@ -9392,15 +9607,15 @@ function convertEventToAiMessage(event) {
     case "tool_output": {
       const observationFromPayload = (() => {
         const payload = event.payload;
-        if (!isRecord24(payload)) return void 0;
+        if (!isRecord25(payload)) return void 0;
         const result = payload["result"];
-        if (!isRecord24(result)) return void 0;
+        if (!isRecord25(result)) return void 0;
         const obs = result["observation"];
         return typeof obs === "string" && obs.trim().length > 0 ? obs : void 0;
       })();
       const rawOutput = (() => {
         const payload = event.payload;
-        if (isRecord24(payload)) {
+        if (isRecord25(payload)) {
           const out = payload["output"];
           if (typeof out === "string" && out.trim().length > 0) {
             return out;
@@ -9525,7 +9740,7 @@ __export(utils_exports, {
 });
 
 // src/testkit/context-harness/replayHarness.ts
-function isRecord25(value) {
+function isRecord26(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function createReplayHarness(events) {
@@ -9537,7 +9752,7 @@ function createReplayHarness(events) {
         if (message.role !== "assistant" || message.type !== "tool_calls") {
           return false;
         }
-        if (!isRecord25(message.metadata)) {
+        if (!isRecord26(message.metadata)) {
           return false;
         }
         return Array.isArray(message.metadata.tool_calls);