@linnlabs/linnkit 0.9.0 → 0.10.0

package/dist/index.js

@@ -57,6 +57,7 @@ __export(runtime_kernel_exports, {
   computeToolIdempotencyKey: () => computeToolIdempotencyKey,
   consoleAudit: () => consoleAudit,
   contextBudgetWarningTemplate: () => contextBudgetWarningTemplate,
+  copyToolContextRuntimeCapability: () => copyToolContextRuntimeCapability,
   countToolCallsInCurrentRequest: () => countToolCallsInCurrentRequest,
   createCompositeAudit: () => createCompositeAudit,
   createConsoleAudit: () => createConsoleAudit,
@@ -138,6 +139,7 @@ var Logger = class {
   constructor(moduleName) {
     this.moduleName = moduleName;
   }
+  moduleName;
   debug(message, data) {
     this.log(0 /* DEBUG */, "debug", message, data);
   }
@@ -561,6 +563,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(),
@@ -683,12 +686,13 @@ var AgentSpecContextPolicy = z.object({
 var DEFAULT_CONTEXT_POLICY = {
   profileId: "agent",
   budget: {
-    maxTokens: 12e4,
+    maxTokens: 232e3,
     reservedForResponse: 2400,
     workingMemoryBudgetPercentage: 0.7
   },
   toolHistory: {
     strategy: "per-run",
+    retentionMode: "drop",
     keepLatestToolPairs: 2,
     keepLatestRuns: 1,
     maxInteractionGroups: 12,
@@ -1540,6 +1544,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;
@@ -1549,6 +1564,7 @@ var GraphExecutor = class {
     };
     this.telemetryPort = config.telemetryPort ?? noopTelemetry;
   }
+  checkpointer;
   nodes = /* @__PURE__ */ new Map();
   ephemeralLocals = /* @__PURE__ */ new Map();
   config;
@@ -1556,8 +1572,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);
@@ -1569,8 +1585,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 = {
@@ -1578,10 +1594,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: {}
     };
@@ -1592,19 +1608,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;
@@ -1613,17 +1656,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,
@@ -1652,7 +1701,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;
@@ -1700,8 +1749,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", {
@@ -1712,18 +1761,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)
           }
         });
       }
@@ -1762,7 +1811,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") {
@@ -1773,7 +1822,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") {
@@ -1784,7 +1833,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 };
       }
     }
@@ -1795,8 +1844,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 };
   }
 };
@@ -1993,15 +2042,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();
 }
@@ -2383,7 +2432,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;
   }
@@ -2984,7 +3033,7 @@ function createExecuteLlmStage(dependencies) {
         streamEventHandler,
         ctx.signal,
         (fallbackModelId) => {
-          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString(fallbackModelId);
+          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString2(fallbackModelId);
         },
         (info) => {
           ctx.modelFallbackAudit = info;
@@ -3028,7 +3077,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, {
@@ -3100,7 +3149,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
@@ -3148,7 +3197,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
     };
@@ -3198,18 +3247,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 : [],
@@ -3974,7 +4023,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;
   }
@@ -3996,7 +4045,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");
     }
@@ -4006,7 +4055,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");
     }
@@ -4556,6 +4605,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();
@@ -5407,12 +5481,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,
@@ -5431,25 +5505,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;
     }
@@ -5521,6 +5595,7 @@ __export(tools_exports, {
   CommonParameterTypes: () => CommonParameterTypes,
   ContextCheckpointTool: () => ContextCheckpointTool,
   computeToolIdempotencyKey: () => computeToolIdempotencyKey,
+  copyToolContextRuntimeCapability: () => copyToolContextRuntimeCapability,
   createContextCheckpointTool: () => createContextCheckpointTool,
   ensureToolContextRuntimeCapability: () => ensureToolContextRuntimeCapability,
   findCachedToolOutputByIdempotencyKey: () => findCachedToolOutputByIdempotencyKey,
@@ -5714,7 +5789,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;
   }
@@ -5734,13 +5809,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) {
@@ -7448,6 +7523,7 @@ var DefaultTokenizerPort = class {
   constructor(config = {}) {
     this.config = config;
   }
+  config;
   estimateText(text, _modelId) {
     return TokenCalculator.estimateTokens(text, {
       encoding: this.config.encoding,
@@ -7475,7 +7551,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,
@@ -7487,7 +7562,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
@@ -7589,6 +7664,8 @@ var FinalAnswerCollector = class {
     this.conversationId = conversationId;
     this.turnId = turnId;
   }
+  conversationId;
+  turnId;
   answerId;
   chunks = [];
   chunkCount = 0;
@@ -7805,7 +7882,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 [];
@@ -7813,7 +7890,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
@@ -7842,6 +7919,7 @@ var ChildRunInvoker = class {
       agentConfig,
       userMessage,
       parentToolContext,
+      conversationId,
       runId,
       parentRunId,
       subrunTracePublisher,
@@ -7850,12 +7928,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 ? "..." : "")
     });
@@ -7916,7 +8000,7 @@ var ChildRunInvoker = class {
     const seedHistory = Array.isArray(seedHistoryEvents) ? seedHistoryEvents : [];
     const childToolContext = createChildRunToolContext({
       parentToolContext,
-      internalConversationId,
+      conversationId: runtimeConversationId,
       turnId,
       runId: childRunId,
       parentRunId: resolvedParentRunId,
@@ -7925,13 +8009,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 } : {},
@@ -7939,7 +8023,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;
@@ -7951,7 +8035,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") {
@@ -7985,8 +8069,8 @@ var ChildRunInvoker = class {
       }
       const recoveredEvents = await recoverChildRunEventsFromCheckpoint({
         checkpointer,
-        conversationId: internalConversationId,
-        internalConversationId,
+        checkpointKey: internalCheckpointKey,
+        childConversationId: runtimeConversationId,
         seedHistory
       });
       appendUniqueEvents(allEvents, recoveredEvents);
@@ -8003,7 +8087,7 @@ var ChildRunInvoker = class {
         stack: err.stack
       } : { error: String(err) });
     }
-    await checkpointer.clear(internalConversationId);
+    await checkpointer.clear(internalCheckpointKey);
     return {
       success: !error,
       runId: childRunId,
@@ -8016,6 +8100,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;
@@ -8206,7 +8300,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) {
@@ -8618,7 +8712,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 {
@@ -8705,7 +8799,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({
@@ -8879,12 +8973,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,
@@ -8893,7 +8988,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);
@@ -8957,10 +9052,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: {
@@ -9188,6 +9287,7 @@ function createGraphLoopHarness(options) {
   };
   return {
     async run() {
+      const checkpointKey = options.conversationId;
       const executor = createDefaultGraphExecutor({
         llmNode: options.createLlmNode({
           llmCaller: options.llmCaller,
@@ -9216,8 +9316,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
@@ -9560,6 +9660,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();
@@ -9614,7 +9715,7 @@ async function runAgent(agent, options) {
   };
   await handle.markRunning({ currentNode: "user" });
   try {
-    await executor.prime(conversationId, {
+    await executor.prime(checkpointKey, {
       conversationId,
       turnId,
       request: {
@@ -9639,7 +9740,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;