@linnlabs/linnkit 0.8.0 → 0.9.0

package/dist/testkit.js

@@ -105,11 +105,14 @@ __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,
@@ -194,7 +197,6 @@ var Logger = class {
   constructor(moduleName) {
     this.moduleName = moduleName;
   }
-  moduleName;
   debug(message, data) {
     this.log(0 /* DEBUG */, "debug", message, data);
   }
@@ -1182,7 +1184,6 @@ var GraphExecutor = class {
     };
     this.telemetryPort = config.telemetryPort ?? noopTelemetry;
   }
-  checkpointer;
   nodes = /* @__PURE__ */ new Map();
   ephemeralLocals = /* @__PURE__ */ new Map();
   config;
@@ -4575,6 +4576,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) {
@@ -4782,18 +4799,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()
+    };
   }
 };
 
@@ -5530,18 +5554,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();
@@ -6033,6 +6057,9 @@ __export(llm_exports, {
   LLMPolicyEngine: () => LLMPolicyEngine,
   LlmCaller: () => LlmCaller,
   ModelResolver: () => ModelResolver,
+  appendStreamingProviderReasoningDetails: () => appendStreamingProviderReasoningDetails,
+  compactProviderReasoningDetails: () => compactProviderReasoningDetails,
+  compactReasoningDetailsInValue: () => compactReasoningDetailsInValue,
   createDefaultTokenizerPort: () => createDefaultTokenizerPort,
   defaultPolicyEngine: () => defaultPolicyEngine
 });
@@ -6422,6 +6449,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 {
@@ -6434,7 +6545,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;
@@ -6504,13 +6615,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());
@@ -6936,7 +7055,6 @@ var DefaultTokenizerPort = class {
   constructor(config = {}) {
     this.config = config;
   }
-  config;
   estimateText(text, _modelId) {
     return TokenCalculator.estimateTokens(text, {
       encoding: this.config.encoding,
@@ -7078,8 +7196,6 @@ var FinalAnswerCollector = class {
     this.conversationId = conversationId;
     this.turnId = turnId;
   }
-  conversationId;
-  turnId;
   answerId;
   chunks = [];
   chunkCount = 0;
@@ -7127,7 +7243,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) {
@@ -7160,7 +7276,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");
@@ -7829,7 +7945,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) {
@@ -7850,7 +7966,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;
@@ -8068,7 +8184,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) {
@@ -8085,7 +8201,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");
@@ -8097,7 +8213,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;
@@ -8983,11 +9099,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;
@@ -9005,7 +9121,7 @@ function safeParseArgs(rawArgs) {
   }
   try {
     const parsed = JSON.parse(rawArgs);
-    return isRecord23(parsed) ? parsed : {};
+    return isRecord24(parsed) ? parsed : {};
   } catch {
     return {};
   }
@@ -9299,7 +9415,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) {
@@ -9357,10 +9473,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;
             })();
@@ -9379,9 +9495,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;
           })()
@@ -9390,15 +9506,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;
@@ -9523,7 +9639,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) {
@@ -9535,7 +9651,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);