@linnlabs/linnkit 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 export { i as ports } from './index-Cvr23YCl.cjs';
-export { i as runtimeKernel } from './index-Cm-JbzTH.cjs';
+export { i as runtimeKernel } from './index-BanRABEt.cjs';
 export { i as contracts } from './index-Dl5PLgAv.cjs';
 export { D as DefineAgentInput, a as DefinedAgent, L as LinnkitQuickstartConfig, R as RunAgentOptions, b as RunAgentResult, d as defineAgent, c as defineConfig, r as resolveConfiguredLlm, e as runAgent } from './runAgent-HYKlXbVr.cjs';
 export { L as LlmCallTelemetry, w as withLLMTelemetryContext } from './defaultGraphExecutor-BIjJj7WF.cjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { i as ports } from './index-DDzuSb0n.js';
-export { i as runtimeKernel } from './index-DRBWi1fy.js';
+export { i as runtimeKernel } from './index-Z8NXKNwI.js';
 export { i as contracts } from './index-CHqwkvGp.js';
 export { D as DefineAgentInput, a as DefinedAgent, L as LinnkitQuickstartConfig, R as RunAgentOptions, b as RunAgentResult, d as defineAgent, c as defineConfig, r as resolveConfiguredLlm, e as runAgent } from './runAgent-CPj_9e58.js';
 export { L as LlmCallTelemetry, w as withLLMTelemetryContext } from './defaultGraphExecutor-BBswR8wn.js';

package/dist/index.js

@@ -46,11 +46,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,
@@ -135,7 +138,6 @@ var Logger = class {
   constructor(moduleName) {
     this.moduleName = moduleName;
   }
-  moduleName;
   debug(message, data) {
     this.log(0 /* DEBUG */, "debug", message, data);
   }
@@ -1547,7 +1549,6 @@ var GraphExecutor = class {
     };
     this.telemetryPort = config.telemetryPort ?? noopTelemetry;
   }
-  checkpointer;
   nodes = /* @__PURE__ */ new Map();
   ephemeralLocals = /* @__PURE__ */ new Map();
   config;
@@ -4968,6 +4969,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) {
@@ -5175,18 +5192,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()
+    };
   }
 };
 
@@ -5923,18 +5947,18 @@ function createClassification(category, reason, suggestedDelay, extras) {
 }
 var ErrorClassifier = class {
   static classify(error, context) {
-    const isRecord24 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+    const isRecord25 = (v) => !!v && typeof v === "object" && !Array.isArray(v);
     const baseMsg = (error.message || "").toLowerCase();
     const causeMsg = (() => {
       const cause = error.cause;
       if (typeof cause === "string") return cause.toLowerCase();
       if (cause instanceof Error) return (cause.message || "").toLowerCase();
-      if (isRecord24(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
+      if (isRecord25(cause) && typeof cause["message"] === "string") return String(cause["message"]).toLowerCase();
       return "";
     })();
     const causeCode = (() => {
       const cause = error.cause;
-      if (isRecord24(cause) && typeof cause["code"] === "string") return String(cause["code"]);
+      if (isRecord25(cause) && typeof cause["code"] === "string") return String(cause["code"]);
       return "";
     })();
     const errorMessage = `${baseMsg} ${causeMsg}`.trim();
@@ -6426,6 +6450,9 @@ __export(llm_exports, {
   LLMPolicyEngine: () => LLMPolicyEngine,
   LlmCaller: () => LlmCaller,
   ModelResolver: () => ModelResolver,
+  appendStreamingProviderReasoningDetails: () => appendStreamingProviderReasoningDetails,
+  compactProviderReasoningDetails: () => compactProviderReasoningDetails,
+  compactReasoningDetailsInValue: () => compactReasoningDetailsInValue,
   createDefaultTokenizerPort: () => createDefaultTokenizerPort,
   defaultPolicyEngine: () => defaultPolicyEngine
 });
@@ -6815,6 +6842,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 {
@@ -6827,7 +6938,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;
@@ -6897,13 +7008,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());
@@ -7329,7 +7448,6 @@ var DefaultTokenizerPort = class {
   constructor(config = {}) {
     this.config = config;
   }
-  config;
   estimateText(text, _modelId) {
     return TokenCalculator.estimateTokens(text, {
       encoding: this.config.encoding,
@@ -7471,8 +7589,6 @@ var FinalAnswerCollector = class {
     this.conversationId = conversationId;
     this.turnId = turnId;
   }
-  conversationId;
-  turnId;
   answerId;
   chunks = [];
   chunkCount = 0;
@@ -7520,7 +7636,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) {
@@ -7553,7 +7669,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");
@@ -8222,7 +8338,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) {
@@ -8243,7 +8359,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;
@@ -8461,7 +8577,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) {
@@ -8478,7 +8594,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");
@@ -8490,7 +8606,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;
@@ -9372,7 +9488,7 @@ function createQuickstartTelemetryPort(collector) {
 }
 
 // src/quickstart/runAgent.ts
-function isRecord23(value) {
+function isRecord24(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readString4(value) {
@@ -9386,7 +9502,7 @@ function resolveModelId(agent, options) {
   return modelId;
 }
 function isQuickstartStreamChunkEvent(value) {
-  return isRecord23(value) && value.type === "stream_chunk" && typeof value.content === "string";
+  return isRecord24(value) && value.type === "stream_chunk" && typeof value.content === "string";
 }
 function createNoopObservationPreview() {
   return {
@@ -9426,7 +9542,7 @@ function readFinalAnswer(events, checkpointLocal) {
   if (chunks.length > 0) {
     return chunks.join("");
   }
-  if (isRecord23(checkpointLocal)) {
+  if (isRecord24(checkpointLocal)) {
     const finalAnswer = checkpointLocal["finalAnswer"];
     if (typeof finalAnswer === "string") {
       return finalAnswer;
@@ -9435,7 +9551,7 @@ function readFinalAnswer(events, checkpointLocal) {
   return "";
 }
 function readContextTrace(checkpointLocal) {
-  if (!isRecord23(checkpointLocal)) return void 0;
+  if (!isRecord24(checkpointLocal)) return void 0;
   return checkpointLocal["contextTrace"];
 }
 async function emitRunEvent(event, sink) {