@evalops/maestro 0.10.29 → 0.10.31

package/dist/cli.js

@@ -64435,34 +64435,6 @@ var init_semantic_judge = __esm2(() => {
   init_logger();
   logger50 = createLogger("safety:semantic-judge");
 });
-function normalizeSkillArtifactMetadata(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return;
-  }
-  const candidate = value;
-  if (typeof candidate.name !== "string" || candidate.name.trim().length === 0 || typeof candidate.hash !== "string" || candidate.hash.trim().length === 0 || typeof candidate.source !== "string" || candidate.source.trim().length === 0) {
-    return;
-  }
-  return {
-    name: candidate.name.trim(),
-    hash: candidate.hash.trim(),
-    source: candidate.source.trim(),
-    ...typeof candidate.artifactId === "string" && candidate.artifactId.trim().length > 0 ? { artifactId: candidate.artifactId.trim() } : {},
-    ...typeof candidate.version === "string" && candidate.version.trim().length > 0 ? { version: candidate.version.trim() } : {},
-    ...typeof candidate.sourcePath === "string" && candidate.sourcePath.trim().length > 0 ? { sourcePath: candidate.sourcePath.trim() } : {},
-    ...typeof candidate.scope === "string" && candidate.scope.trim().length > 0 ? { scope: candidate.scope.trim() } : {},
-    ...typeof candidate.workspaceId === "string" && candidate.workspaceId.trim().length > 0 ? { workspaceId: candidate.workspaceId.trim() } : {},
-    ...typeof candidate.ownerId === "string" && candidate.ownerId.trim().length > 0 ? { ownerId: candidate.ownerId.trim() } : {}
-  };
-}
-function getSkillArtifactMetadataFromDetails(details) {
-  if (!details || typeof details !== "object" || Array.isArray(details)) {
-    return;
-  }
-  return normalizeSkillArtifactMetadata(details.skillMetadata);
-}
-var init_artifact_metadata = () => {
-};
 function isReadOnlyTool(toolName, annotations, _source) {
   if (annotations?.readOnlyHint === true) {
     return true;
@@ -72154,6 +72126,95 @@ async function* createProviderStream(model, context2, options, reasoning) {
   }
   throw new Error(`Unsupported API: ${model.api}`);
 }
+function normalizeSkillArtifactMetadata(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return;
+  }
+  const candidate = value;
+  if (typeof candidate.name !== "string" || candidate.name.trim().length === 0 || typeof candidate.hash !== "string" || candidate.hash.trim().length === 0 || typeof candidate.source !== "string" || candidate.source.trim().length === 0) {
+    return;
+  }
+  return {
+    name: candidate.name.trim(),
+    hash: candidate.hash.trim(),
+    source: candidate.source.trim(),
+    ...typeof candidate.artifactId === "string" && candidate.artifactId.trim().length > 0 ? { artifactId: candidate.artifactId.trim() } : {},
+    ...typeof candidate.version === "string" && candidate.version.trim().length > 0 ? { version: candidate.version.trim() } : {},
+    ...typeof candidate.sourcePath === "string" && candidate.sourcePath.trim().length > 0 ? { sourcePath: candidate.sourcePath.trim() } : {},
+    ...typeof candidate.scope === "string" && candidate.scope.trim().length > 0 ? { scope: candidate.scope.trim() } : {},
+    ...typeof candidate.workspaceId === "string" && candidate.workspaceId.trim().length > 0 ? { workspaceId: candidate.workspaceId.trim() } : {},
+    ...typeof candidate.ownerId === "string" && candidate.ownerId.trim().length > 0 ? { ownerId: candidate.ownerId.trim() } : {}
+  };
+}
+function getSkillArtifactMetadataFromDetails(details) {
+  if (!details || typeof details !== "object" || Array.isArray(details)) {
+    return;
+  }
+  return normalizeSkillArtifactMetadata(details.skillMetadata);
+}
+var init_artifact_metadata = () => {
+};
+var AgentEventQueue = class {
+  events = [];
+  pending;
+  wake;
+  push(event) {
+    this.events.push(event);
+    if (this.wake) {
+      const wake = this.wake;
+      this.pending = void 0;
+      this.wake = void 0;
+      wake();
+    }
+  }
+  shift() {
+    return this.events.shift();
+  }
+  wait() {
+    if (this.events.length > 0) {
+      return Promise.resolve();
+    }
+    if (!this.pending) {
+      this.pending = new Promise((resolve192) => {
+        this.wake = resolve192;
+      });
+    }
+    return this.pending;
+  }
+  clearPendingWaiter() {
+    this.pending = void 0;
+    this.wake = void 0;
+  }
+};
+function isDynamicToolApprovalEvent(event) {
+  return event.type === "action_approval_required" || event.type === "action_approval_resolved";
+}
+function getGovernedToolResultEventMetadata(details) {
+  if (!details || typeof details !== "object") {
+    return {};
+  }
+  const governedOutcome = details.governedOutcome;
+  if (!governedOutcome || typeof governedOutcome !== "object") {
+    return {};
+  }
+  const normalized = governedOutcome;
+  const classification = typeof normalized.classification === "string" ? normalized.classification : void 0;
+  const errorCode = typeof normalized.code === "string" && normalized.code.trim().length > 0 ? normalized.code.trim() : classification;
+  const approvalRequestId = typeof normalized.approvalRequestId === "string" && normalized.approvalRequestId.trim().length > 0 ? normalized.approvalRequestId.trim() : void 0;
+  return {
+    errorCode,
+    approvalRequestId,
+    governedOutcome: classification
+  };
+}
+function getSkillToolResultEventMetadata(details) {
+  return {
+    skillMetadata: getSkillArtifactMetadataFromDetails(details)
+  };
+}
+var init_events = __esm2(() => {
+  init_artifact_metadata();
+});
 function stripTrailingSlashes2(value) {
   return value.replace(/\/+$/u, "");
 }
@@ -83730,64 +83791,6 @@ async function waitForNextExecutionOrUpdate(pendingExecutions, updateQueue) {
   }
   return next;
 }
-var AgentEventQueue = class {
-  events = [];
-  pending;
-  wake;
-  push(event) {
-    this.events.push(event);
-    if (this.wake) {
-      const wake = this.wake;
-      this.pending = void 0;
-      this.wake = void 0;
-      wake();
-    }
-  }
-  shift() {
-    return this.events.shift();
-  }
-  wait() {
-    if (this.events.length > 0) {
-      return Promise.resolve();
-    }
-    if (!this.pending) {
-      this.pending = new Promise((resolve202) => {
-        this.wake = resolve202;
-      });
-    }
-    return this.pending;
-  }
-  clearPendingWaiter() {
-    this.pending = void 0;
-    this.wake = void 0;
-  }
-};
-function isDynamicToolApprovalEvent(event) {
-  return event.type === "action_approval_required" || event.type === "action_approval_resolved";
-}
-function getGovernedToolResultEventMetadata(details) {
-  if (!details || typeof details !== "object") {
-    return {};
-  }
-  const governedOutcome = details.governedOutcome;
-  if (!governedOutcome || typeof governedOutcome !== "object") {
-    return {};
-  }
-  const normalized = governedOutcome;
-  const classification = typeof normalized.classification === "string" ? normalized.classification : void 0;
-  const errorCode = typeof normalized.code === "string" && normalized.code.trim().length > 0 ? normalized.code.trim() : classification;
-  const approvalRequestId = typeof normalized.approvalRequestId === "string" && normalized.approvalRequestId.trim().length > 0 ? normalized.approvalRequestId.trim() : void 0;
-  return {
-    errorCode,
-    approvalRequestId,
-    governedOutcome: classification
-  };
-}
-function getSkillToolResultEventMetadata(details) {
-  return {
-    skillMetadata: getSkillArtifactMetadataFromDetails(details)
-  };
-}
 var ProviderTransport = class _ProviderTransport {
   options;
   workflowState = new WorkflowStateTracker();
@@ -85352,11 +85355,11 @@ var init_transport = __esm2(() => {
   init_safety_middleware();
   init_semantic_judge();
   init_workflow_state();
-  init_artifact_metadata();
   init_parallel_execution();
   init_cost_tracker();
   init_training();
   init_keys();
+  init_events();
   init_reusable_tool_results();
   init_tool_execution();
   init_tool_safety_pipeline();
@@ -94851,7 +94854,6 @@ var init_compaction_cleanup = __esm2(() => {
   logger89 = createLogger("compaction-cleanup");
   cleanupHandlers = /* @__PURE__ */ new Map();
 });
-var SESSION_START_INITIAL_USER_METADATA_KIND = "session_start_initial_user";
 function calculateContextTokens(usage4) {
   return usage4.input + usage4.output + usage4.cacheRead + usage4.cacheWrite;
 }
@@ -94864,6 +94866,107 @@ function getAssistantUsage(msg) {
   }
   return null;
 }
+function getLastAssistantUsage(messages) {
+  for (let i2 = messages.length - 1; i2 >= 0; i2--) {
+    const usage4 = getAssistantUsage(messages[i2]);
+    if (usage4)
+      return usage4;
+  }
+  return null;
+}
+function findTurnBoundaries(messages, startIndex, endIndex) {
+  const boundaries = [];
+  for (let i2 = startIndex; i2 < endIndex; i2++) {
+    if (messages[i2].role === "user") {
+      boundaries.push(i2);
+    }
+  }
+  return boundaries;
+}
+function findCutPoint(messages, startIndex, endIndex, keepRecentTokens) {
+  const boundaries = findTurnBoundaries(messages, startIndex, endIndex);
+  if (boundaries.length === 0) {
+    return startIndex;
+  }
+  const assistantUsages = [];
+  for (let i2 = endIndex - 1; i2 >= startIndex; i2--) {
+    const usage4 = getAssistantUsage(messages[i2]);
+    if (usage4) {
+      assistantUsages.push({
+        index: i2,
+        tokens: calculateContextTokens(usage4)
+      });
+    }
+  }
+  if (assistantUsages.length === 0) {
+    return boundaries[boundaries.length - 1];
+  }
+  const newestTokens = assistantUsages[0].tokens;
+  let cutIndex = startIndex;
+  for (let i2 = 1; i2 < assistantUsages.length; i2++) {
+    const tokenDiff = newestTokens - assistantUsages[i2].tokens;
+    if (tokenDiff >= keepRecentTokens) {
+      const lastKeptAssistantIndex = assistantUsages[i2 - 1].index;
+      for (let b = boundaries.length - 1; b >= 0; b--) {
+        const boundary = boundaries[b];
+        if (boundary !== void 0 && boundary <= lastKeptAssistantIndex) {
+          cutIndex = boundary;
+          break;
+        }
+      }
+      break;
+    }
+  }
+  return cutIndex;
+}
+function adjustBoundaryForToolResults(messages, boundary) {
+  let adjusted = boundary;
+  const seenToolCalls = /* @__PURE__ */ new Set();
+  const missingToolCalls = /* @__PURE__ */ new Set();
+  const processAssistantMessage = (message) => {
+    if (message.role !== "assistant")
+      return;
+    const content = message.content;
+    if (!content)
+      return;
+    for (const part of content) {
+      if (part?.type === "toolCall") {
+        seenToolCalls.add(part.id);
+        if (missingToolCalls.has(part.id)) {
+          missingToolCalls.delete(part.id);
+        }
+      }
+    }
+  };
+  const processToolResultMessage = (message) => {
+    if (message.role !== "toolResult")
+      return;
+    const toolCallId2 = message.toolCallId;
+    if (!seenToolCalls.has(toolCallId2)) {
+      missingToolCalls.add(toolCallId2);
+    }
+  };
+  for (const message of messages.slice(adjusted)) {
+    processAssistantMessage(message);
+    processToolResultMessage(message);
+  }
+  while (missingToolCalls.size > 0 && adjusted > 0) {
+    adjusted -= 1;
+    const candidate = messages[adjusted];
+    processAssistantMessage(candidate);
+    processToolResultMessage(candidate);
+  }
+  return adjusted;
+}
+var DEFAULT_COMPACTION_SETTINGS;
+var init_cut_points = __esm2(() => {
+  DEFAULT_COMPACTION_SETTINGS = {
+    enabled: true,
+    reserveTokens: 16384,
+    keepRecentTokens: 2e4
+  };
+});
+var SESSION_START_INITIAL_USER_METADATA_KIND = "session_start_initial_user";
 function shouldSkipAssistantCompactionMessage(message) {
   return message.role === "assistant" && (message.stopReason === "aborted" || message.stopReason === "error");
 }
@@ -95560,98 +95663,6 @@ function truncateSummaryInputForOverflowRetry(messages, overflowErrorMessage) {
   };
   return preamble ? [preamble, markerMessage, ...truncatedBody] : [markerMessage, ...truncatedBody];
 }
-function getLastAssistantUsage(messages) {
-  for (let i2 = messages.length - 1; i2 >= 0; i2--) {
-    const usage4 = getAssistantUsage(messages[i2]);
-    if (usage4)
-      return usage4;
-  }
-  return null;
-}
-function findTurnBoundaries(messages, startIndex, endIndex) {
-  const boundaries = [];
-  for (let i2 = startIndex; i2 < endIndex; i2++) {
-    if (messages[i2].role === "user") {
-      boundaries.push(i2);
-    }
-  }
-  return boundaries;
-}
-function findCutPoint(messages, startIndex, endIndex, keepRecentTokens) {
-  const boundaries = findTurnBoundaries(messages, startIndex, endIndex);
-  if (boundaries.length === 0) {
-    return startIndex;
-  }
-  const assistantUsages = [];
-  for (let i2 = endIndex - 1; i2 >= startIndex; i2--) {
-    const usage4 = getAssistantUsage(messages[i2]);
-    if (usage4) {
-      assistantUsages.push({
-        index: i2,
-        tokens: calculateContextTokens(usage4)
-      });
-    }
-  }
-  if (assistantUsages.length === 0) {
-    return boundaries[boundaries.length - 1];
-  }
-  const newestTokens = assistantUsages[0].tokens;
-  let cutIndex = startIndex;
-  for (let i2 = 1; i2 < assistantUsages.length; i2++) {
-    const tokenDiff = newestTokens - assistantUsages[i2].tokens;
-    if (tokenDiff >= keepRecentTokens) {
-      const lastKeptAssistantIndex = assistantUsages[i2 - 1].index;
-      for (let b = boundaries.length - 1; b >= 0; b--) {
-        const boundary = boundaries[b];
-        if (boundary !== void 0 && boundary <= lastKeptAssistantIndex) {
-          cutIndex = boundary;
-          break;
-        }
-      }
-      break;
-    }
-  }
-  return cutIndex;
-}
-function adjustBoundaryForToolResults(messages, boundary) {
-  let adjusted = boundary;
-  const seenToolCalls = /* @__PURE__ */ new Set();
-  const missingToolCalls = /* @__PURE__ */ new Set();
-  const processAssistantMessage = (message) => {
-    if (message.role !== "assistant")
-      return;
-    const content = message.content;
-    if (!content)
-      return;
-    for (const part of content) {
-      if (part?.type === "toolCall") {
-        seenToolCalls.add(part.id);
-        if (missingToolCalls.has(part.id)) {
-          missingToolCalls.delete(part.id);
-        }
-      }
-    }
-  };
-  const processToolResultMessage = (message) => {
-    if (message.role !== "toolResult")
-      return;
-    const toolCallId2 = message.toolCallId;
-    if (!seenToolCalls.has(toolCallId2)) {
-      missingToolCalls.add(toolCallId2);
-    }
-  };
-  for (const message of messages.slice(adjusted)) {
-    processAssistantMessage(message);
-    processToolResultMessage(message);
-  }
-  while (missingToolCalls.size > 0 && adjusted > 0) {
-    adjusted -= 1;
-    const candidate = messages[adjusted];
-    processAssistantMessage(candidate);
-    processToolResultMessage(candidate);
-  }
-  return adjusted;
-}
 function buildSummarizationPrompt(customInstructions) {
   if (customInstructions) {
     return `${SUMMARIZATION_PROMPT}
@@ -96003,7 +96014,6 @@ ${previousSummary}`,
   };
 }
 var logger90;
-var DEFAULT_COMPACTION_SETTINGS;
 var COMPACTION_RESUME_PROMPT = "Use the above summary to resume the plan from where we left off.";
 var MAX_COMPACTION_OVERFLOW_RETRIES = 3;
 var PREVIOUS_SUMMARY_PREFIX = `Previous session summary:
@@ -96035,15 +96045,12 @@ var init_compaction = __esm2(() => {
   init_path_validation();
   init_compaction_cleanup();
   init_compaction_hooks();
+  init_cut_points();
+  init_cut_points();
   init_compaction_restoration();
   init_context_overflow();
   init_plan_mode();
   logger90 = createLogger("agent:compaction");
-  DEFAULT_COMPACTION_SETTINGS = {
-    enabled: true,
-    reserveTokens: 16384,
-    keepRecentTokens: 2e4
-  };
 });
 var exports_task_budget_access = {};
 __export2(exports_task_budget_access, {
@@ -142452,8 +142459,8 @@ ${renderCard([
       const summary2 = buildDiffSummary(diffValue);
       sections.push(summary2);
       const diffLines22 = highlightCodeLines(diffValue, "diff");
-      const shouldCompact = diffStyle === "auto" && terminalWidth < 90;
-      const renderedLines = shouldCompact ? clampAnsiLines(diffLines22.slice(0, 80).concat(diffLines22.length > 80 ? [`${theme.fg("dim", "... truncated ...")}`] : []), maxDiffWidth) : clampAnsiLines(diffLines22, maxDiffWidth);
+      const shouldCompact2 = diffStyle === "auto" && terminalWidth < 90;
+      const renderedLines = shouldCompact2 ? clampAnsiLines(diffLines22.slice(0, 80).concat(diffLines22.length > 80 ? [`${theme.fg("dim", "... truncated ...")}`] : []), maxDiffWidth) : clampAnsiLines(diffLines22, maxDiffWidth);
       sections.push(renderedLines.join(`
 `));
     } else if (typeof context2.args?.before === "string" && typeof context2.args?.after === "string") {
@@ -160145,6 +160152,15 @@ function toArray(value) {
   }
   return Array.isArray(value) ? value : [value];
 }
+function shellQuoteArg(value) {
+  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(value)) {
+    return value;
+  }
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function formatRipgrepCommand(args) {
+  return ["rg", ...args].map(shellQuoteArg).join(" ");
+}
 async function runRipgrep(args, signal, cwd) {
   const child = spawn17("rg", args, {
     cwd: cwd ?? process.cwd(),
@@ -160235,15 +160251,6 @@ var init_ripgrep_utils = __esm2(() => {
     }), { minItems: 1 })
   ]));
 });
-function shellQuoteArg(value) {
-  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(value)) {
-    return value;
-  }
-  return `'${value.replace(/'/g, "'\\''")}'`;
-}
-function formatRipgrepCommand(args) {
-  return ["rg", ...args].map(shellQuoteArg).join(" ");
-}
 function mergeRanges(ranges) {
   const sorted = [...ranges].sort((a, b) => a.start - b.start);
   const merged = [];
@@ -160742,20 +160749,20 @@ Examples:
       } else {
         args.push(".");
       }
+      const command = formatRipgrepCommand(args);
       let result2;
       try {
         result2 = await runRipgrep(args, signal, commandCwd);
       } catch (error) {
         const reason = error instanceof Error ? error.message : `Unknown error: ${String(error)}`;
-        return respond.text(`ripgrep failed
+        return respond.error(`ripgrep failed
 
-${reason}`).detail({ command: ["rg", ...args].join(" "), cwd: commandCwd });
+${reason}`).detail({ command, cwd: commandCwd });
       }
       if (result2.exitCode === 2) {
         const message = result2.stderr.trim() || result2.stdout.trim();
         throw new Error(message.length > 0 ? message : "ripgrep exited with an error");
       }
-      const command = ["rg", ...args].join(" ");
       if (result2.exitCode === 1 || result2.stdout.trim().length === 0) {
         const detailFormat = outputMode === "files" ? "files" : outputMode === "count" ? "count" : format;
         return respond.text("No matches found.").detail({ command, cwd: commandCwd, format: detailFormat });
@@ -196854,6 +196861,32 @@ function waitTypeForEntry(kind, timelineItem) {
     return "AGENT_RUN_WAIT_TYPE_INPUT";
   return "AGENT_RUN_WAIT_TYPE_APPROVAL";
 }
+function firstEvidenceIdForEvent(event, kind) {
+  return event.evidence.find((anchor) => anchor.kind === kind)?.id;
+}
+function hasCorrelation(correlation) {
+  return Object.values(correlation).some((value) => typeof value === "string" && value.length > 0);
+}
+function correlationForEvent(event, timelineItem) {
+  const pendingRequestId = timelineItem?.pendingRequestId ?? firstEvidenceIdForEvent(event, "pending_request");
+  const approvalRequestId = timelineItem?.approvalRequestId ?? firstEvidenceIdForEvent(event, "approval_request");
+  const toolExecutionId = timelineItem?.toolExecutionId ?? firstEvidenceIdForEvent(event, "tool_execution");
+  const artifactId = timelineItem?.artifactId ?? firstEvidenceIdForEvent(event, "artifact");
+  const agentRunId = timelineItem?.agentRunId ?? firstEvidenceIdForEvent(event, "agent_run");
+  const parentAgentRunId = timelineItem?.parentAgentRunId ?? firstEvidenceIdForEvent(event, "parent_agent_run");
+  const childAgentRunId = timelineItem?.childAgentRunId ?? firstEvidenceIdForEvent(event, "child_agent_run");
+  const correlation = {
+    ...pendingRequestId ? { pendingRequestId } : {},
+    ...timelineItem?.pendingRequestKind ? { pendingRequestKind: timelineItem.pendingRequestKind } : {},
+    ...approvalRequestId ? { approvalRequestId } : {},
+    ...toolExecutionId ? { toolExecutionId } : {},
+    ...artifactId ? { artifactId } : {},
+    ...agentRunId ? { agentRunId } : {},
+    ...parentAgentRunId ? { parentAgentRunId } : {},
+    ...childAgentRunId ? { childAgentRunId } : {}
+  };
+  return hasCorrelation(correlation) ? correlation : void 0;
+}
 function buildLedgerEntries(timeline, trajectory) {
   const timelineItemsById = new Map(timeline.items.map((item) => [item.id, item]));
   return trajectory.events.map((event) => {
@@ -196862,6 +196895,7 @@ function buildLedgerEntries(timeline, trajectory) {
     const timelineItemId = timelineIdForEvent(event);
     const timelineItem = timelineItemId ? timelineItemsById.get(timelineItemId) : void 0;
     const waitType = waitTypeForEntry(kind, timelineItem);
+    const correlation = correlationForEvent(event, timelineItem);
     return {
       id: `ledger:${event.id}`,
       sequence: event.sequence,
@@ -196880,6 +196914,7 @@ function buildLedgerEntries(timeline, trajectory) {
       ...event.summary ? { summary: event.summary } : {},
       relatedIds: event.relatedIds ?? [],
       evidence: event.evidence,
+      ...correlation ? { correlation } : {},
       platformShape: {
         stepKind: stepKindForEntry(kind, event),
         workItemKind: workItemKindForEntry(kind),
@@ -196961,7 +196996,8 @@ function workItemPayloadForEntry(sessionId, entry2) {
     ...entry2.timelineItemId ? { timelineItemId: entry2.timelineItemId } : {},
     ...entry2.toolName ? { toolName: entry2.toolName } : {},
     ...entry2.summary ? { summary: entry2.summary } : {},
-    ...entry2.relatedIds.length > 0 ? { relatedIds: entry2.relatedIds } : {}
+    ...entry2.relatedIds.length > 0 ? { relatedIds: entry2.relatedIds } : {},
+    ...entry2.correlation ? { correlation: entry2.correlation } : {}
   };
 }
 function terminalEntry(entries) {
@@ -196988,6 +197024,11 @@ function terminalOperation(runId, entries) {
     payload: {
       state: succeeded ? "succeeded" : "failed",
       timestamp: terminal.timestamp,
+      ledgerEntryId: terminal.id,
+      trajectoryEventId: terminal.trajectoryEventId,
+      eventType: terminal.type,
+      title: terminal.title,
+      evidenceRefs: evidenceRefsForEntry(terminal),
       ...succeeded ? {} : {
         reason: `Terminal ledger entry ended in ${terminal.state} state.`
       }
@@ -197023,7 +197064,8 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
     }
   ];
   for (const entry2 of entries) {
-    const toolExecutionId = firstEvidenceId2(entry2, "tool_execution");
+    const correlation = entry2.correlation ?? {};
+    const toolExecutionId = correlation.toolExecutionId ?? firstEvidenceId2(entry2, "tool_execution");
     const evidenceRefs = evidenceRefsForEntry(entry2);
     const waitId = entry2.platformShape.waitType ? entry2.id : void 0;
     operations.push({
@@ -197050,6 +197092,7 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
         title: entry2.title,
         timestamp: entry2.timestamp,
         ...waitId ? { waitId } : {},
+        ...correlation,
         ...toolExecutionId ? { toolExecutionId } : {},
         evidenceRefs,
         completionGate: "maestro_agent_runtime_ledger_recorded",
@@ -197065,7 +197108,8 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
           waitId: entry2.id,
           waitType: entry2.platformShape.waitType,
           title: entry2.title,
-          timestamp: entry2.timestamp
+          timestamp: entry2.timestamp,
+          ...correlation
         }
       });
     }

package/dist/node_modules/@evalops/contracts/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@evalops/contracts",
-	"version": "0.10.29",
+	"version": "0.10.31",
 	"description": "Shared Maestro contracts for frontend/backend integration",
 	"type": "module",
 	"main": "./dist/index.js",

package/dist/node_modules/@evalops/tui/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@evalops/tui",
-	"version": "0.10.29",
+	"version": "0.10.31",
 	"description": "Terminal UI library with differential rendering for Maestro",
 	"type": "module",
 	"main": "./dist/index.js",

package/dist/server/agent-runtime-ledger.d.ts

@@ -7,6 +7,16 @@ export declare const AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA = "evalops.maestro.agen
 export type AgentRuntimeLedgerEntryKind = "run" | "message" | "model_call" | "tool_call" | "tool_result" | "wait" | "checkpoint" | "artifact" | "evidence" | "governance" | "context" | "child_run" | "runtime";
 export type AgentRuntimeLedgerState = "pending" | "running" | "waiting" | "blocked" | "succeeded" | "failed" | "cancelled" | "skipped";
 type AgentRuntimePromotionStepState = Exclude<AgentRuntimeLedgerState, "blocked">;
+export interface AgentRuntimeLedgerCorrelation {
+    pendingRequestId?: string;
+    pendingRequestKind?: ComposerRunTimelineItem["pendingRequestKind"];
+    approvalRequestId?: string;
+    toolExecutionId?: string;
+    artifactId?: string;
+    agentRunId?: string;
+    parentAgentRunId?: string;
+    childAgentRunId?: string;
+}
 export interface AgentRuntimeLedgerEntry {
     id: string;
     sequence: number;
@@ -25,6 +35,7 @@ export interface AgentRuntimeLedgerEntry {
     summary?: string;
     relatedIds: string[];
     evidence: AgentTrajectoryEvent["evidence"];
+    correlation?: AgentRuntimeLedgerCorrelation;
     platformShape: {
         stepKind: string;
         workItemKind: string;
@@ -106,11 +117,10 @@ export type AgentRuntimePromotionOperation = {
         title: string;
         timestamp: string;
         waitId?: string;
-        toolExecutionId?: string;
         evidenceRefs?: string[];
         completionGate?: string;
         payload?: Record<string, unknown>;
-    };
+    } & AgentRuntimeLedgerCorrelation;
 } | {
     operation: "wait_run";
     id: string;
@@ -120,7 +130,7 @@ export type AgentRuntimePromotionOperation = {
         waitType: string;
         title: string;
         timestamp: string;
-    };
+    } & AgentRuntimeLedgerCorrelation;
 } | {
     operation: "complete_run" | "fail_run";
     id: string;
@@ -128,6 +138,11 @@ export type AgentRuntimePromotionOperation = {
         state: "succeeded" | "failed";
         timestamp: string;
         reason?: string;
+        ledgerEntryId: string;
+        trajectoryEventId: string;
+        eventType: string;
+        title: string;
+        evidenceRefs: string[];
     };
 };
 export interface BuildAgentRuntimeLedgerOptions {