@evalops/maestro 0.10.28 → 0.10.30

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();
@@ -160235,6 +160238,15 @@ 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 = [];
@@ -160442,7 +160454,7 @@ var init_parallel_ripgrep = __esm2(() => {
       let truncatedByBytes = false;
       const ripgrepCalls = patterns.map(async (pattern) => {
         const args = [...baseArgs, "--", pattern, ...pathArgs];
-        commands.push(["rg", ...args].join(" "));
+        commands.push(formatRipgrepCommand(args));
         const result2 = await runRipgrep(args, signal, commandCwd);
         truncatedByBytes ||= result2.truncated;
         return { pattern, result: result2 };
@@ -160452,7 +160464,7 @@ var init_parallel_ripgrep = __esm2(() => {
         results = await Promise.all(ripgrepCalls);
       } 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({
           commands,
@@ -196845,6 +196857,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) => {
@@ -196853,6 +196891,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,
@@ -196871,6 +196910,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),
@@ -196952,7 +196992,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) {
@@ -196979,6 +197020,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.`
       }
@@ -197014,7 +197060,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({
@@ -197041,6 +197088,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",
@@ -197056,7 +197104,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.28",
+	"version": "0.10.30",
 	"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.28",
+	"version": "0.10.30",
 	"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 {

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

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime-ledger.d.ts","sourceRoot":"","sources":["../../src/server/agent-runtime-ledger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-runtime-ledger.d.ts","sourceRoot":"","sources":["../../src/server/agent-runtime-ledger.ts"],"names":[],"mappings":"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"}

package/dist/server/agent-runtime-ledger.js

@@ -110,6 +110,39 @@ 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 : undefined;
+}
 function buildLedgerEntries(timeline, trajectory) {
     const timelineItemsById = new Map(timeline.items.map((item) => [item.id, item]));
     return trajectory.events.map((event) => {
@@ -120,6 +153,7 @@ function buildLedgerEntries(timeline, trajectory) {
             ? timelineItemsById.get(timelineItemId)
             : undefined;
         const waitType = waitTypeForEntry(kind, timelineItem);
+        const correlation = correlationForEvent(event, timelineItem);
         return {
             id: `ledger:${event.id}`,
             sequence: event.sequence,
@@ -138,6 +172,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),
@@ -231,6 +266,7 @@ function workItemPayloadForEntry(sessionId, entry) {
         ...(entry.toolName ? { toolName: entry.toolName } : {}),
         ...(entry.summary ? { summary: entry.summary } : {}),
         ...(entry.relatedIds.length > 0 ? { relatedIds: entry.relatedIds } : {}),
+        ...(entry.correlation ? { correlation: entry.correlation } : {}),
     };
 }
 function terminalEntry(entries) {
@@ -257,6 +293,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
                 ? {}
                 : {
@@ -294,7 +335,8 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
         },
     ];
     for (const entry of entries) {
-        const toolExecutionId = firstEvidenceId(entry, "tool_execution");
+        const correlation = entry.correlation ?? {};
+        const toolExecutionId = correlation.toolExecutionId ?? firstEvidenceId(entry, "tool_execution");
         const evidenceRefs = evidenceRefsForEntry(entry);
         const waitId = entry.platformShape.waitType ? entry.id : undefined;
         operations.push({
@@ -321,6 +363,7 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
                 title: entry.title,
                 timestamp: entry.timestamp,
                 ...(waitId ? { waitId } : {}),
+                ...correlation,
                 ...(toolExecutionId ? { toolExecutionId } : {}),
                 evidenceRefs,
                 completionGate: "maestro_agent_runtime_ledger_recorded",
@@ -337,6 +380,7 @@ function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
                     waitType: entry.platformShape.waitType,
                     title: entry.title,
                     timestamp: entry.timestamp,
+                    ...correlation,
                 },
             });
         }