@linnlabs/linnkit 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -16,6 +16,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.9.0] - 2026-05-22
+
+### Added
+
+- `appendStreamingProviderReasoningDetails` / `compactProviderReasoningDetails` / `compactReasoningDetailsInValue` in `@linnlabs/linnkit/runtime-kernel` — provider-agnostic helpers for merging adjacent streaming `reasoning_content` fragments.
+
+### Fixed
+
+- Streaming `reasoning_details` now merges adjacent pure text reasoning fragments before returning the final LLM result and before emitting provider sidecar updates, preventing audit records from storing token-by-token reasoning fragments.
+- `ToolNode` now drains every pending `assistant.tool_calls` item in the current batch before returning to the LLM, even when an earlier tool call fails. This preserves the protocol invariant that each tool call receives a corresponding tool output and avoids incomplete tool-call groups being dropped by downstream context assembly.
+- Tool protocol fuse handling now waits until the current batch has been fully consumed before throwing, so one repeated protocol error cannot strand later tool calls in the same assistant message.
+
+### Compatibility
+
+- Minor bump because `@linnlabs/linnkit/runtime-kernel` has new public exports and ToolNode batch execution behavior is stricter.
+
+---
+
 ## [0.8.0] - 2026-05-13
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # linnkit
 
-**A fine-grained context engineering framework for Agent applications — control every token sent to the model, with clear run lifecycle, audit records, and testable protocol boundaries.**
+**A fine-grained context engineering framework for Agent applications — control every token sent to the model, with clear run lifecycle, audit records, and testable protocol boundaries.** It gives a small, auditable runtime for controlling the messages, tool results, summaries, and policies that shape every LLM call.
 
 [中文文档](./README.zh-CN.md) · [Integration Guide](./docs/integration/README.md) · [Changelog](./CHANGELOG.md)
 

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # linnkit
 
-**linnkit 是一个可以方便地精细化管理上下文的 Agent 框架，追求控制发给LLM的每一个 token，同时保留清晰的运行生命周期、审计记录和测试边界。**
+**linnkit 是一个可以方便地精细化管理上下文的 Agent 框架，追求控制发给LLM的每一个 token，同时保留清晰的运行生命周期、审计记录和测试边界。** 它提供了一种小巧、可审计的运行时环境，可对消息、工具结果、摘要及策略进行管控，而正是这些要素决定了每一次大语言模型调用的行为。
 
 [English](./README.md) · [接入文档](./docs/integration/README.md) · [更新日志](./CHANGELOG.md)
 

package/dist/cli.cjs

@@ -1084,7 +1084,6 @@ var Logger = class {
   constructor(moduleName) {
     this.moduleName = moduleName;
   }
-  moduleName;
   debug(message, data) {
     this.log(0 /* DEBUG */, "debug", message, data);
   }
@@ -1166,7 +1165,6 @@ var GraphExecutor = class {
     };
     this.telemetryPort = config.telemetryPort ?? noopTelemetry;
   }
-  checkpointer;
   nodes = /* @__PURE__ */ new Map();
   ephemeralLocals = /* @__PURE__ */ new Map();
   config;
@@ -4448,6 +4446,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) {
@@ -4655,18 +4669,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()
+    };
   }
 };
 
@@ -5162,18 +5183,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();
@@ -5849,6 +5870,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 {
@@ -5861,7 +5943,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;
@@ -5931,13 +6013,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());
@@ -6508,7 +6598,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) {
@@ -6529,7 +6619,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;
@@ -6747,7 +6837,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) {
@@ -6764,7 +6854,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");
@@ -6776,7 +6866,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;
@@ -7386,7 +7476,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) {
@@ -7400,7 +7490,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 {
@@ -7440,7 +7530,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;
@@ -7449,7 +7539,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) {
@@ -7573,11 +7663,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;
@@ -7588,7 +7678,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);