@linnlabs/linnkit 0.9.0 → 0.10.0

package/dist/{ports-DnLuKfpE.d.ts → ports-DpPTFhSd.d.ts}

@@ -1,4 +1,4 @@
-import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, a as ToolArgs, T as ToolExecutionContext } from './toolContracts-Blll0241.js';
+import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, T as ToolArgs, a as ToolExecutionContext } from './toolContracts-f8lzZBNa.js';
 
 /**
  * tool schema 生成阶段的最小上下文合同
@@ -87,4 +87,4 @@ interface ObservationPreviewPort {
 interface ToolRuntimePort extends ToolCatalogPort, ToolPresentationPort, ToolExecutionPort {
 }
 
-export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolCatalogPort as T, ToolPresentationPort as a, ToolExecutionPort as b, ObservationPreviewContext as c, ObservationPreviewMeta as d, ObservationPreviewResult as e, ToolExecutionResult as f, ToolRuntimeDefinition as g, ToolRuntimePort as h, ToolSchemaContext as i };
+export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolRuntimeDefinition as T, ToolExecutionResult as a, ToolCatalogPort as b, ToolPresentationPort as c, ToolExecutionPort as d, ObservationPreviewContext as e, ObservationPreviewMeta as f, ObservationPreviewResult as g, ToolRuntimePort as h, ToolSchemaContext as i };

package/dist/{ports-DaatKJXp.d.cts → ports-s-tSp3sB.d.cts}

@@ -1,4 +1,4 @@
-import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, a as ToolArgs, T as ToolExecutionContext } from './toolContracts-CLkQmhTG.cjs';
+import { O as OpenAIToolSchema, b as ToolParameterSchema, h as ToolDisplayOptions, y as ToolIdempotencyPolicy, T as ToolArgs, a as ToolExecutionContext } from './toolContracts-Bm3EZ1UM.cjs';
 
 /**
  * tool schema 生成阶段的最小上下文合同
@@ -87,4 +87,4 @@ interface ObservationPreviewPort {
 interface ToolRuntimePort extends ToolCatalogPort, ToolPresentationPort, ToolExecutionPort {
 }
 
-export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolCatalogPort as T, ToolPresentationPort as a, ToolExecutionPort as b, ObservationPreviewContext as c, ObservationPreviewMeta as d, ObservationPreviewResult as e, ToolExecutionResult as f, ToolRuntimeDefinition as g, ToolRuntimePort as h, ToolSchemaContext as i };
+export type { ConversationArtifactContext as C, ObservationPreviewPort as O, ToolRuntimeDefinition as T, ToolExecutionResult as a, ToolCatalogPort as b, ToolPresentationPort as c, ToolExecutionPort as d, ObservationPreviewContext as e, ObservationPreviewMeta as f, ObservationPreviewResult as g, ToolRuntimePort as h, ToolSchemaContext as i };

package/dist/quickstart.cjs

@@ -168,6 +168,7 @@ var AgentSpecBudgetPolicy = zod.z.object({
 });
 var AgentSpecToolHistoryPolicy = zod.z.object({
   strategy: zod.z.enum(["per-pair", "per-run", "none"]).optional(),
+  retentionMode: zod.z.enum(["drop", "compress"]).optional(),
   keepLatestToolPairs: zod.z.number().int().nonnegative().optional(),
   keepLatestRuns: zod.z.number().int().nonnegative().optional(),
   maxInteractionGroups: zod.z.number().int().nonnegative().optional(),
@@ -282,12 +283,13 @@ var AgentSpecContextPolicy = zod.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,
@@ -1200,6 +1202,7 @@ var Logger = class {
   constructor(moduleName) {
     this.moduleName = moduleName;
   }
+  moduleName;
   debug(message, data) {
     this.log(0 /* DEBUG */, "debug", message, data);
   }
@@ -1272,6 +1275,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;
@@ -1281,6 +1295,7 @@ var GraphExecutor = class {
     };
     this.telemetryPort = config.telemetryPort ?? noopTelemetry;
   }
+  checkpointer;
   nodes = /* @__PURE__ */ new Map();
   ephemeralLocals = /* @__PURE__ */ new Map();
   config;
@@ -1288,8 +1303,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);
@@ -1301,8 +1316,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 = {
@@ -1310,10 +1325,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: {}
     };
@@ -1324,19 +1339,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;
@@ -1345,17 +1387,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,
@@ -1384,7 +1432,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;
@@ -1432,8 +1480,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", {
@@ -1444,18 +1492,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)
           }
         });
       }
@@ -1494,7 +1542,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") {
@@ -1505,7 +1553,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") {
@@ -1516,7 +1564,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 };
       }
     }
@@ -1527,8 +1575,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 };
   }
 };
@@ -1691,15 +1739,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();
 }
@@ -2056,7 +2104,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;
   }
@@ -2644,7 +2692,7 @@ function createExecuteLlmStage(dependencies) {
         streamEventHandler,
         ctx.signal,
         (fallbackModelId) => {
-          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString(fallbackModelId);
+          ctx.cloudQuotaFallbackAppliedModelId = readNonEmptyString2(fallbackModelId);
         },
         (info) => {
           ctx.modelFallbackAudit = info;
@@ -2688,7 +2736,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, {
@@ -2760,7 +2808,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
@@ -2808,7 +2856,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
     };
@@ -2858,18 +2906,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 : [],
@@ -3634,7 +3682,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;
   }
@@ -3656,7 +3704,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");
     }
@@ -3666,7 +3714,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");
     }
@@ -5000,12 +5048,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,
@@ -5024,25 +5072,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;
     }
@@ -6582,7 +6630,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) {
@@ -6994,7 +7042,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 {
@@ -7081,7 +7129,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({
@@ -7255,12 +7303,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,
@@ -7269,7 +7318,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);
@@ -7333,10 +7382,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: {
@@ -7664,6 +7717,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();
@@ -7718,7 +7772,7 @@ async function runAgent(agent, options) {
   };
   await handle.markRunning({ currentNode: "user" });
   try {
-    await executor.prime(conversationId, {
+    await executor.prime(checkpointKey, {
       conversationId,
       turnId,
       request: {
@@ -7743,7 +7797,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;