@linnlabs/linnkit 0.8.0 → 0.10.0

package/dist/cli.js

@@ -200,6 +200,7 @@ var AgentSpecBudgetPolicy = z.object({
 });
 var AgentSpecToolHistoryPolicy = z.object({
   strategy: z.enum(["per-pair", "per-run", "none"]).optional(),
+  retentionMode: z.enum(["drop", "compress"]).optional(),
   keepLatestToolPairs: z.number().int().nonnegative().optional(),
   keepLatestRuns: z.number().int().nonnegative().optional(),
   maxInteractionGroups: z.number().int().nonnegative().optional(),
@@ -1154,6 +1155,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;
@@ -1171,8 +1183,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);
@@ -1184,8 +1196,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 = {
@@ -1193,10 +1205,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: {}
     };
@@ -1207,19 +1219,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;
@@ -1228,17 +1267,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,
@@ -1267,7 +1312,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;
@@ -1315,8 +1360,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", {
@@ -1327,18 +1372,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)
           }
         });
       }
@@ -1377,7 +1422,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") {
@@ -1388,7 +1433,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") {
@@ -1399,7 +1444,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 };
       }
     }
@@ -1410,8 +1455,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 };
   }
 };
@@ -1574,15 +1619,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();
 }
@@ -1939,7 +1984,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;
   }
@@ -2527,7 +2572,7 @@ function createExecuteLlmStage(dependencies) {
         streamEventHandler,
         ctx.signal,
         (fallbackModelId) => {
-          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString(fallbackModelId);
+          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString2(fallbackModelId);
         },
         (info) => {
           ctx.modelFallbackAudit = info;
@@ -2571,7 +2616,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, {
@@ -2643,7 +2688,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
@@ -2691,7 +2736,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
     };
@@ -2741,18 +2786,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 : [],
@@ -3517,7 +3562,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;
   }
@@ -3539,7 +3584,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");
     }
@@ -3549,7 +3594,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");
     }
@@ -4445,6 +4490,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) {
@@ -4652,18 +4713,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()
+    };
   }
 };
 
@@ -4860,12 +4928,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,
@@ -4884,25 +4952,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;
     }
@@ -5159,18 +5227,18 @@ function createClassification(category, reason, suggestedDelay, extras) {
 }
 var ErrorClassifier = class {
   static classify(error, context) {
-    const isRecord22 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+    const isRecord23 = (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 (isRecord22(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
+      if (isRecord23(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
       return "";
     })();
     const causeCode = (() => {
       const cause = error.cause;
-      if (isRecord22(cause) && typeof cause["code"] === "string") return String(cause["code"]);
+      if (isRecord23(cause) && typeof cause["code"] === "string") return String(cause["code"]);
       return "";
     })();
     const errorMessage = `${baseMsg} ${causeMsg}`.trim();
@@ -5846,6 +5914,67 @@ function assertToolCallsHaveValidJsonArguments(toolCalls) {
   }
 }
 
+// src/runtime-kernel/llm/reasoning-details.ts
+var mergeableTextFields = ["reasoning_content"];
+function isRecord18(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function findMergeableTextField(detail) {
+  if (!isRecord18(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 (!isRecord18(previous) || !isRecord18(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 && isRecord18(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;
+}
+
 // src/runtime-kernel/llm/streaming-adapter.ts
 async function callLlmStream(params) {
   const {
@@ -5858,7 +5987,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;
@@ -5928,13 +6057,21 @@ async function callLlmStream(params) {
     const reasoning = isRecord17(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());
@@ -6373,7 +6510,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) {
@@ -6505,7 +6642,7 @@ function runRecordToMeta(record) {
     errorIfAny: record.errorIfAny ? { ...record.errorIfAny } : void 0
   };
 }
-function isRecord18(value) {
+function isRecord19(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStringField(record, key) {
@@ -6526,7 +6663,7 @@ function getRunIdFromMetadata(event) {
     return snakeCaseRunId;
   }
   const runContext = metadata["run_context"];
-  if (isRecord18(runContext)) {
+  if (isRecord19(runContext)) {
     return readStringField(runContext, "runId") ?? readStringField(runContext, "run_id");
   }
   return void 0;
@@ -6744,7 +6881,7 @@ function runMetaFromRecord(record) {
 }
 
 // src/runtime-kernel/run-supervisor/runSupervisor.ts
-function isRecord19(value) {
+function isRecord20(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readStringField2(record, key) {
@@ -6761,7 +6898,7 @@ function readRunIdFromRuntimeEvent(event) {
     return directRunId;
   }
   const runContext = metadata["run_context"];
-  if (!isRecord19(runContext)) {
+  if (!isRecord20(runContext)) {
     return void 0;
   }
   return readStringField2(runContext, "runId") ?? readStringField2(runContext, "run_id");
@@ -6773,7 +6910,7 @@ function readAwaitingUserReason(event) {
   if (typeof event.prompt === "string" && event.prompt.trim().length > 0) {
     return event.prompt;
   }
-  if (isRecord19(event.form)) {
+  if (isRecord20(event.form)) {
     const prompt = readStringField2(event.form, "prompt");
     if (prompt && prompt.trim().length > 0) {
       return prompt;
@@ -6785,7 +6922,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 {
@@ -6872,7 +7009,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({
@@ -7046,12 +7183,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,
@@ -7060,7 +7198,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);
@@ -7124,10 +7262,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: {
@@ -7383,7 +7525,7 @@ function createQuickstartTelemetryPort(collector) {
 }
 
 // src/quickstart/runAgent.ts
-function isRecord20(value) {
+function isRecord21(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readString4(value) {
@@ -7397,7 +7539,7 @@ function resolveModelId(agent, options) {
   return modelId;
 }
 function isQuickstartStreamChunkEvent(value) {
-  return isRecord20(value) && value.type === "stream_chunk" && typeof value.content === "string";
+  return isRecord21(value) && value.type === "stream_chunk" && typeof value.content === "string";
 }
 function createNoopObservationPreview() {
   return {
@@ -7437,7 +7579,7 @@ function readFinalAnswer(events, checkpointLocal) {
   if (chunks.length > 0) {
     return chunks.join("");
   }
-  if (isRecord20(checkpointLocal)) {
+  if (isRecord21(checkpointLocal)) {
     const finalAnswer = checkpointLocal["finalAnswer"];
     if (typeof finalAnswer === "string") {
       return finalAnswer;
@@ -7446,7 +7588,7 @@ function readFinalAnswer(events, checkpointLocal) {
   return "";
 }
 function readContextTrace(checkpointLocal) {
-  if (!isRecord20(checkpointLocal)) return void 0;
+  if (!isRecord21(checkpointLocal)) return void 0;
   return checkpointLocal["contextTrace"];
 }
 async function emitRunEvent(event, sink) {
@@ -7455,6 +7597,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();
@@ -7509,7 +7652,7 @@ async function runAgent(agent, options) {
   };
   await handle.markRunning({ currentNode: "user" });
   try {
-    await executor.prime(conversationId, {
+    await executor.prime(checkpointKey, {
       conversationId,
       turnId,
       request: {
@@ -7534,7 +7677,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;
@@ -7570,11 +7713,11 @@ async function runAgent(agent, options) {
 }
 
 // src/cli/configLoader.ts
-function isRecord21(value) {
+function isRecord22(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readDefaultExport(moduleValue) {
-  if (isRecord21(moduleValue) && "default" in moduleValue) {
+  if (isRecord22(moduleValue) && "default" in moduleValue) {
     return moduleValue.default;
   }
   return moduleValue;
@@ -7585,7 +7728,7 @@ async function loadConfig(configPath, cwd) {
   moduleUrl.searchParams.set("t", String(Date.now()));
   const loaded = await import(moduleUrl.href);
   const config = readDefaultExport(loaded);
-  if (!isRecord21(config)) {
+  if (!isRecord22(config)) {
     throw new Error(`[linnkit] config must export an object: ${absolutePath}`);
   }
   return defineConfig(config);
@@ -7697,7 +7840,7 @@ function createQuickstartTemplateFiles(projectName) {
           start: 'linnkit run hello --input "\u4F60\u597D\uFF0C\u4ECB\u7ECD\u4E00\u4E0B\u4F60\u81EA\u5DF1"'
         },
         dependencies: {
-          "@linnlabs/linnkit": "^0.8.0",
+          "@linnlabs/linnkit": "^0.10.0",
           zod: "^3.22.0"
         },
         devDependencies: {}