@evalops/maestro 0.10.18 → 0.10.20

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

@@ -0,0 +1,141 @@
+import type { ComposerRunTimelineItem, ComposerRunTimelineResponse, ComposerRunTimelineVisibility } from "@evalops/contracts";
+import type { AgentTrajectoryReplayReport } from "./agent-trajectory-replay.js";
+import type { AgentTrajectoryEvent, AgentTrajectoryReport } from "./agent-trajectory.js";
+export declare const AGENT_RUNTIME_LEDGER_SCHEMA = "evalops.maestro.agent-runtime-ledger.v1";
+export declare const AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA = "evalops.maestro.agent-runtime-replay-summary.v1";
+export declare const AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA = "evalops.maestro.agent-runtime-promotion-plan.v1";
+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 AgentRuntimeLedgerEntry {
+    id: string;
+    sequence: number;
+    timestamp: string;
+    kind: AgentRuntimeLedgerEntryKind;
+    phase: AgentTrajectoryEvent["phase"];
+    actor: AgentTrajectoryEvent["actor"];
+    type: string;
+    state: AgentRuntimeLedgerState;
+    title: string;
+    visibility: ComposerRunTimelineVisibility;
+    source: ComposerRunTimelineItem["source"];
+    timelineItemId?: string;
+    trajectoryEventId: string;
+    toolName?: string;
+    summary?: string;
+    relatedIds: string[];
+    evidence: AgentTrajectoryEvent["evidence"];
+    platformShape: {
+        stepKind: string;
+        workItemKind: string;
+        waitType?: string;
+    };
+}
+export interface AgentRuntimeLedgerReport {
+    schemaVersion: typeof AGENT_RUNTIME_LEDGER_SCHEMA;
+    run: {
+        id: string;
+        sessionId: string;
+        source: ComposerRunTimelineResponse["source"];
+        generatedAt: string;
+        platformBacked: boolean;
+        sessionFile?: string;
+        cwd?: string;
+        model?: string;
+    };
+    counts: {
+        entries: number;
+        promotionOperations: number;
+        byKind: Record<string, number>;
+        byState: Record<string, number>;
+    };
+    entries: AgentRuntimeLedgerEntry[];
+    replay: AgentRuntimeLedgerReplaySummary;
+    promotion: AgentRuntimePromotionPlan;
+}
+export interface AgentRuntimeLedgerReplaySummary {
+    schemaVersion: typeof AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA;
+    deterministic: boolean;
+    events: number;
+    deltas: number;
+    errors: number;
+    warnings: number;
+    cursor: {
+        startSequence?: number;
+        endSequence?: number;
+    };
+}
+export interface AgentRuntimePromotionPlan {
+    schemaVersion: typeof AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA;
+    runId: string;
+    sessionId: string;
+    idempotencyKey: string;
+    operations: AgentRuntimePromotionOperation[];
+    warnings: string[];
+}
+export type AgentRuntimePromotionOperation = {
+    operation: "handle_trigger";
+    id: string;
+    payload: {
+        sourceEventType: "maestro.local_ledger_promote";
+        sourceEventId: string;
+        idempotencyKey: string;
+        sessionId: string;
+        generatedAt: string;
+    };
+} | {
+    operation: "record_run_step";
+    id: string;
+    ledgerEntryId: string;
+    payload: {
+        stepId: string;
+        kind: string;
+        state: AgentRuntimePromotionStepState;
+        title: string;
+        timestamp: string;
+        toolName?: string;
+    };
+} | {
+    operation: "record_run_work_item";
+    id: string;
+    ledgerEntryId: string;
+    payload: {
+        workItemId: string;
+        kind: string;
+        state: AgentRuntimeLedgerState;
+        title: string;
+        timestamp: string;
+    };
+} | {
+    operation: "wait_run";
+    id: string;
+    ledgerEntryId: string;
+    payload: {
+        waitId: string;
+        waitType: string;
+        title: string;
+        timestamp: string;
+    };
+} | {
+    operation: "complete_run" | "fail_run";
+    id: string;
+    payload: {
+        state: "succeeded" | "failed";
+        timestamp: string;
+        reason?: string;
+    };
+};
+export interface BuildAgentRuntimeLedgerOptions {
+    session: {
+        id: string;
+        sessionFile?: string;
+        cwd?: string;
+        model?: string;
+    };
+    timeline: ComposerRunTimelineResponse;
+    trajectory: AgentTrajectoryReport;
+    replay: AgentTrajectoryReplayReport;
+}
+export declare function buildAgentRuntimeLedgerReport(options: BuildAgentRuntimeLedgerOptions): AgentRuntimeLedgerReport;
+export {};
+//# sourceMappingURL=agent-runtime-ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,334 @@
+export const AGENT_RUNTIME_LEDGER_SCHEMA = "evalops.maestro.agent-runtime-ledger.v1";
+export const AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA = "evalops.maestro.agent-runtime-replay-summary.v1";
+export const AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA = "evalops.maestro.agent-runtime-promotion-plan.v1";
+function increment(map, key) {
+    map[key] = (map[key] ?? 0) + 1;
+}
+function timelineIdForEvent(event) {
+    return event.evidence.find((anchor) => anchor.kind === "timeline_item")?.id;
+}
+function stateForStatus(status) {
+    switch (status) {
+        case "completed":
+        case "info":
+        case "approved":
+            return "succeeded";
+        case "running":
+            return "running";
+        case "pending":
+            return "waiting";
+        case "denied":
+            return "blocked";
+        case "failed":
+            return "failed";
+        default:
+            return "pending";
+    }
+}
+function kindForEvent(event) {
+    switch (event.kind) {
+        case "session":
+            return "run";
+        case "message":
+            return event.actor === "assistant" ? "model_call" : "message";
+        case "tool":
+            return event.type === "tool.completed" || event.type === "tool.failed"
+                ? "tool_result"
+                : "tool_call";
+        case "wait":
+            return "wait";
+        case "artifact":
+            return "artifact";
+        case "evidence":
+            return "evidence";
+        case "governance":
+            return "governance";
+        case "context":
+            return event.type.startsWith("compaction.") ? "checkpoint" : "context";
+        case "agent":
+            return "child_run";
+        case "runtime":
+            return "runtime";
+        default:
+            return "runtime";
+    }
+}
+function stepKindForEntry(entryKind, event) {
+    if (entryKind === "model_call")
+        return "AGENT_RUN_STEP_KIND_MODEL_CALL";
+    if (entryKind === "tool_call")
+        return "AGENT_RUN_STEP_KIND_TOOL_CALL_INTENT";
+    if (entryKind === "tool_result" && event.status === "failed") {
+        return "AGENT_RUN_STEP_KIND_ERROR";
+    }
+    if (entryKind === "tool_result")
+        return "AGENT_RUN_STEP_KIND_TOOL_RESULT";
+    if (entryKind === "wait" || entryKind === "governance") {
+        return "AGENT_RUN_STEP_KIND_APPROVAL_WAIT";
+    }
+    return "AGENT_RUN_STEP_KIND_SYSTEM";
+}
+function workItemKindForEntry(kind) {
+    switch (kind) {
+        case "message":
+            return "AGENT_WORK_ITEM_KIND_USER_INPUT";
+        case "model_call":
+            return "AGENT_WORK_ITEM_KIND_MODEL_CALL";
+        case "tool_call":
+        case "tool_result":
+            return "AGENT_WORK_ITEM_KIND_TOOL_CALL";
+        case "child_run":
+            return "AGENT_WORK_ITEM_KIND_CHILD_RUN";
+        case "wait":
+        case "governance":
+            return "AGENT_WORK_ITEM_KIND_WAIT";
+        case "checkpoint":
+            return "AGENT_WORK_ITEM_KIND_RECOVERY";
+        case "artifact":
+        case "evidence":
+            return "AGENT_WORK_ITEM_KIND_MEMORY";
+        default:
+            return "AGENT_WORK_ITEM_KIND_ROOT";
+    }
+}
+function waitTypeForEntry(kind, timelineItem) {
+    if (kind !== "wait") {
+        return undefined;
+    }
+    switch (timelineItem?.pendingRequestKind) {
+        case "approval":
+        case "tool_retry":
+            return "AGENT_RUN_WAIT_TYPE_APPROVAL";
+        case "client_tool":
+        case "mcp_elicitation":
+        case "user_input":
+            return "AGENT_RUN_WAIT_TYPE_INPUT";
+    }
+    if (timelineItem?.approvalRequestId)
+        return "AGENT_RUN_WAIT_TYPE_APPROVAL";
+    if (timelineItem?.pendingRequestId)
+        return "AGENT_RUN_WAIT_TYPE_INPUT";
+    return "AGENT_RUN_WAIT_TYPE_APPROVAL";
+}
+function buildLedgerEntries(timeline, trajectory) {
+    const timelineItemsById = new Map(timeline.items.map((item) => [item.id, item]));
+    return trajectory.events.map((event) => {
+        const kind = kindForEvent(event);
+        const state = stateForStatus(event.status);
+        const timelineItemId = timelineIdForEvent(event);
+        const timelineItem = timelineItemId
+            ? timelineItemsById.get(timelineItemId)
+            : undefined;
+        const waitType = waitTypeForEntry(kind, timelineItem);
+        return {
+            id: `ledger:${event.id}`,
+            sequence: event.sequence,
+            timestamp: event.timestamp,
+            kind,
+            phase: event.phase,
+            actor: event.actor,
+            type: event.type,
+            state,
+            title: event.title,
+            visibility: event.visibility,
+            source: event.source,
+            trajectoryEventId: event.id,
+            ...(timelineItemId ? { timelineItemId } : {}),
+            ...(event.toolName ? { toolName: event.toolName } : {}),
+            ...(event.summary ? { summary: event.summary } : {}),
+            relatedIds: event.relatedIds ?? [],
+            evidence: event.evidence,
+            platformShape: {
+                stepKind: stepKindForEntry(kind, event),
+                workItemKind: workItemKindForEntry(kind),
+                ...(waitType ? { waitType } : {}),
+            },
+        };
+    });
+}
+function replaySummary(replay, entries) {
+    return {
+        schemaVersion: AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA,
+        deterministic: replay.counts.deltas === 0 && replay.counts.errors === 0,
+        events: replay.counts.events,
+        deltas: replay.counts.deltas,
+        errors: replay.counts.errors,
+        warnings: replay.counts.warnings,
+        cursor: {
+            ...(entries[0] ? { startSequence: entries[0].sequence } : {}),
+            ...(entries.at(-1) ? { endSequence: entries.at(-1)?.sequence } : {}),
+        },
+    };
+}
+const PASSIVE_TERMINAL_ENTRY_KINDS = new Set([
+    "run",
+    "wait",
+    "governance",
+]);
+function isTerminalState(state) {
+    return (state === "succeeded" ||
+        state === "skipped" ||
+        state === "failed" ||
+        state === "cancelled");
+}
+function isTerminalCandidate(entry) {
+    return (isTerminalState(entry.state) &&
+        !PASSIVE_TERMINAL_ENTRY_KINDS.has(entry.kind));
+}
+function runStepStateForEntry(entry) {
+    return entry.state === "blocked" ? "failed" : entry.state;
+}
+function terminalEntry(entries) {
+    const last = entries.at(-1);
+    if (!last || !isTerminalState(last.state))
+        return undefined;
+    if (isTerminalCandidate(last))
+        return last;
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        const entry = entries[index];
+        if (entry && isTerminalCandidate(entry))
+            return entry;
+    }
+    return undefined;
+}
+function terminalOperation(runId, entries) {
+    const terminal = terminalEntry(entries);
+    if (!terminal)
+        return undefined;
+    const succeeded = terminal.state === "succeeded" || terminal.state === "skipped";
+    return {
+        operation: succeeded ? "complete_run" : "fail_run",
+        id: `promote:${runId}:terminal`,
+        payload: {
+            state: succeeded ? "succeeded" : "failed",
+            timestamp: terminal.timestamp,
+            ...(succeeded
+                ? {}
+                : {
+                    reason: `Terminal ledger entry ended in ${terminal.state} state.`,
+                }),
+        },
+    };
+}
+function terminalOperationWarning(entries) {
+    const last = entries.at(-1);
+    if (!last) {
+        return "Terminal operation omitted because no ledger entries were available.";
+    }
+    if (terminalEntry(entries)) {
+        return undefined;
+    }
+    if (isTerminalState(last.state)) {
+        return "Terminal operation omitted because no substantive terminal ledger entry was available.";
+    }
+    return `Terminal operation omitted because final ledger entry ended in ${last.state} state.`;
+}
+function buildPromotionPlan(runId, sessionId, generatedAt, entries) {
+    const idempotencyKey = `maestro-local-ledger:${sessionId}:${runId}`;
+    const operations = [
+        {
+            operation: "handle_trigger",
+            id: `promote:${runId}:trigger`,
+            payload: {
+                sourceEventType: "maestro.local_ledger_promote",
+                sourceEventId: sessionId,
+                idempotencyKey,
+                sessionId,
+                generatedAt,
+            },
+        },
+    ];
+    for (const entry of entries) {
+        operations.push({
+            operation: "record_run_step",
+            id: `promote:${entry.id}:step`,
+            ledgerEntryId: entry.id,
+            payload: {
+                stepId: entry.id,
+                kind: entry.platformShape.stepKind,
+                state: runStepStateForEntry(entry),
+                title: entry.title,
+                timestamp: entry.timestamp,
+                ...(entry.toolName ? { toolName: entry.toolName } : {}),
+            },
+        });
+        operations.push({
+            operation: "record_run_work_item",
+            id: `promote:${entry.id}:work-item`,
+            ledgerEntryId: entry.id,
+            payload: {
+                workItemId: entry.id,
+                kind: entry.platformShape.workItemKind,
+                state: entry.state,
+                title: entry.title,
+                timestamp: entry.timestamp,
+            },
+        });
+        if (entry.platformShape.waitType) {
+            operations.push({
+                operation: "wait_run",
+                id: `promote:${entry.id}:wait`,
+                ledgerEntryId: entry.id,
+                payload: {
+                    waitId: entry.id,
+                    waitType: entry.platformShape.waitType,
+                    title: entry.title,
+                    timestamp: entry.timestamp,
+                },
+            });
+        }
+    }
+    const terminal = terminalOperation(runId, entries);
+    if (terminal)
+        operations.push(terminal);
+    const terminalWarning = terminalOperationWarning(entries);
+    const warnings = [
+        "Promotion plan is dry-run only; no Platform AgentRuntime writes were performed.",
+        ...(terminalWarning ? [terminalWarning] : []),
+    ];
+    return {
+        schemaVersion: AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA,
+        runId,
+        sessionId,
+        idempotencyKey,
+        operations,
+        warnings,
+    };
+}
+export function buildAgentRuntimeLedgerReport(options) {
+    const entries = buildLedgerEntries(options.timeline, options.trajectory);
+    const byKind = {};
+    const byState = {};
+    for (const entry of entries) {
+        increment(byKind, entry.kind);
+        increment(byState, entry.state);
+    }
+    const runId = options.trajectory.run.id;
+    const sessionId = options.trajectory.run.sessionId;
+    const promotion = buildPromotionPlan(runId, sessionId, options.trajectory.run.generatedAt, entries);
+    return {
+        schemaVersion: AGENT_RUNTIME_LEDGER_SCHEMA,
+        run: {
+            id: runId,
+            sessionId,
+            source: options.timeline.source,
+            generatedAt: options.trajectory.run.generatedAt,
+            platformBacked: options.trajectory.run.platformBacked,
+            ...(options.session.sessionFile
+                ? { sessionFile: options.session.sessionFile }
+                : {}),
+            ...(options.session.cwd ? { cwd: options.session.cwd } : {}),
+            ...(options.session.model ? { model: options.session.model } : {}),
+        },
+        counts: {
+            entries: entries.length,
+            promotionOperations: promotion.operations.length,
+            byKind,
+            byState,
+        },
+        entries,
+        replay: replaySummary(options.replay, entries),
+        promotion,
+    };
+}
+//# sourceMappingURL=agent-runtime-ledger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime-ledger.js","sourceRoot":"","sources":["../../src/server/agent-runtime-ledger.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tComposerRunTimelineItem,\n\tComposerRunTimelineResponse,\n\tComposerRunTimelineStatus,\n\tComposerRunTimelineVisibility,\n} from \"@evalops/contracts\";\nimport type { AgentTrajectoryReplayReport } from \"./agent-trajectory-replay.js\";\nimport type {\n\tAgentTrajectoryEvent,\n\tAgentTrajectoryReport,\n} from \"./agent-trajectory.js\";\n\nexport const AGENT_RUNTIME_LEDGER_SCHEMA =\n\t\"evalops.maestro.agent-runtime-ledger.v1\";\nexport const AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA =\n\t\"evalops.maestro.agent-runtime-replay-summary.v1\";\nexport const AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA =\n\t\"evalops.maestro.agent-runtime-promotion-plan.v1\";\n\nexport type AgentRuntimeLedgerEntryKind =\n\t| \"run\"\n\t| \"message\"\n\t| \"model_call\"\n\t| \"tool_call\"\n\t| \"tool_result\"\n\t| \"wait\"\n\t| \"checkpoint\"\n\t| \"artifact\"\n\t| \"evidence\"\n\t| \"governance\"\n\t| \"context\"\n\t| \"child_run\"\n\t| \"runtime\";\n\nexport type AgentRuntimeLedgerState =\n\t| \"pending\"\n\t| \"running\"\n\t| \"waiting\"\n\t| \"blocked\"\n\t| \"succeeded\"\n\t| \"failed\"\n\t| \"cancelled\"\n\t| \"skipped\";\n\ntype AgentRuntimePromotionStepState = Exclude<\n\tAgentRuntimeLedgerState,\n\t\"blocked\"\n>;\n\nexport interface AgentRuntimeLedgerEntry {\n\tid: string;\n\tsequence: number;\n\ttimestamp: string;\n\tkind: AgentRuntimeLedgerEntryKind;\n\tphase: AgentTrajectoryEvent[\"phase\"];\n\tactor: AgentTrajectoryEvent[\"actor\"];\n\ttype: string;\n\tstate: AgentRuntimeLedgerState;\n\ttitle: string;\n\tvisibility: ComposerRunTimelineVisibility;\n\tsource: ComposerRunTimelineItem[\"source\"];\n\ttimelineItemId?: string;\n\ttrajectoryEventId: string;\n\ttoolName?: string;\n\tsummary?: string;\n\trelatedIds: string[];\n\tevidence: AgentTrajectoryEvent[\"evidence\"];\n\tplatformShape: {\n\t\tstepKind: string;\n\t\tworkItemKind: string;\n\t\twaitType?: string;\n\t};\n}\n\nexport interface AgentRuntimeLedgerReport {\n\tschemaVersion: typeof AGENT_RUNTIME_LEDGER_SCHEMA;\n\trun: {\n\t\tid: string;\n\t\tsessionId: string;\n\t\tsource: ComposerRunTimelineResponse[\"source\"];\n\t\tgeneratedAt: string;\n\t\tplatformBacked: boolean;\n\t\tsessionFile?: string;\n\t\tcwd?: string;\n\t\tmodel?: string;\n\t};\n\tcounts: {\n\t\tentries: number;\n\t\tpromotionOperations: number;\n\t\tbyKind: Record<string, number>;\n\t\tbyState: Record<string, number>;\n\t};\n\tentries: AgentRuntimeLedgerEntry[];\n\treplay: AgentRuntimeLedgerReplaySummary;\n\tpromotion: AgentRuntimePromotionPlan;\n}\n\nexport interface AgentRuntimeLedgerReplaySummary {\n\tschemaVersion: typeof AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA;\n\tdeterministic: boolean;\n\tevents: number;\n\tdeltas: number;\n\terrors: number;\n\twarnings: number;\n\tcursor: {\n\t\tstartSequence?: number;\n\t\tendSequence?: number;\n\t};\n}\n\nexport interface AgentRuntimePromotionPlan {\n\tschemaVersion: typeof AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA;\n\trunId: string;\n\tsessionId: string;\n\tidempotencyKey: string;\n\toperations: AgentRuntimePromotionOperation[];\n\twarnings: string[];\n}\n\nexport type AgentRuntimePromotionOperation =\n\t| {\n\t\t\toperation: \"handle_trigger\";\n\t\t\tid: string;\n\t\t\tpayload: {\n\t\t\t\tsourceEventType: \"maestro.local_ledger_promote\";\n\t\t\t\tsourceEventId: string;\n\t\t\t\tidempotencyKey: string;\n\t\t\t\tsessionId: string;\n\t\t\t\tgeneratedAt: string;\n\t\t\t};\n\t  }\n\t| {\n\t\t\toperation: \"record_run_step\";\n\t\t\tid: string;\n\t\t\tledgerEntryId: string;\n\t\t\tpayload: {\n\t\t\t\tstepId: string;\n\t\t\t\tkind: string;\n\t\t\t\tstate: AgentRuntimePromotionStepState;\n\t\t\t\ttitle: string;\n\t\t\t\ttimestamp: string;\n\t\t\t\ttoolName?: string;\n\t\t\t};\n\t  }\n\t| {\n\t\t\toperation: \"record_run_work_item\";\n\t\t\tid: string;\n\t\t\tledgerEntryId: string;\n\t\t\tpayload: {\n\t\t\t\tworkItemId: string;\n\t\t\t\tkind: string;\n\t\t\t\tstate: AgentRuntimeLedgerState;\n\t\t\t\ttitle: string;\n\t\t\t\ttimestamp: string;\n\t\t\t};\n\t  }\n\t| {\n\t\t\toperation: \"wait_run\";\n\t\t\tid: string;\n\t\t\tledgerEntryId: string;\n\t\t\tpayload: {\n\t\t\t\twaitId: string;\n\t\t\t\twaitType: string;\n\t\t\t\ttitle: string;\n\t\t\t\ttimestamp: string;\n\t\t\t};\n\t  }\n\t| {\n\t\t\toperation: \"complete_run\" | \"fail_run\";\n\t\t\tid: string;\n\t\t\tpayload: {\n\t\t\t\tstate: \"succeeded\" | \"failed\";\n\t\t\t\ttimestamp: string;\n\t\t\t\treason?: string;\n\t\t\t};\n\t  };\n\nexport interface BuildAgentRuntimeLedgerOptions {\n\tsession: {\n\t\tid: string;\n\t\tsessionFile?: string;\n\t\tcwd?: string;\n\t\tmodel?: string;\n\t};\n\ttimeline: ComposerRunTimelineResponse;\n\ttrajectory: AgentTrajectoryReport;\n\treplay: AgentTrajectoryReplayReport;\n}\n\nfunction increment(map: Record<string, number>, key: string): void {\n\tmap[key] = (map[key] ?? 0) + 1;\n}\n\nfunction timelineIdForEvent(event: AgentTrajectoryEvent): string | undefined {\n\treturn event.evidence.find((anchor) => anchor.kind === \"timeline_item\")?.id;\n}\n\nfunction stateForStatus(\n\tstatus: ComposerRunTimelineStatus,\n): AgentRuntimeLedgerState {\n\tswitch (status) {\n\t\tcase \"completed\":\n\t\tcase \"info\":\n\t\tcase \"approved\":\n\t\t\treturn \"succeeded\";\n\t\tcase \"running\":\n\t\t\treturn \"running\";\n\t\tcase \"pending\":\n\t\t\treturn \"waiting\";\n\t\tcase \"denied\":\n\t\t\treturn \"blocked\";\n\t\tcase \"failed\":\n\t\t\treturn \"failed\";\n\t\tdefault:\n\t\t\treturn \"pending\";\n\t}\n}\n\nfunction kindForEvent(\n\tevent: AgentTrajectoryEvent,\n): AgentRuntimeLedgerEntryKind {\n\tswitch (event.kind) {\n\t\tcase \"session\":\n\t\t\treturn \"run\";\n\t\tcase \"message\":\n\t\t\treturn event.actor === \"assistant\" ? \"model_call\" : \"message\";\n\t\tcase \"tool\":\n\t\t\treturn event.type === \"tool.completed\" || event.type === \"tool.failed\"\n\t\t\t\t? \"tool_result\"\n\t\t\t\t: \"tool_call\";\n\t\tcase \"wait\":\n\t\t\treturn \"wait\";\n\t\tcase \"artifact\":\n\t\t\treturn \"artifact\";\n\t\tcase \"evidence\":\n\t\t\treturn \"evidence\";\n\t\tcase \"governance\":\n\t\t\treturn \"governance\";\n\t\tcase \"context\":\n\t\t\treturn event.type.startsWith(\"compaction.\") ? \"checkpoint\" : \"context\";\n\t\tcase \"agent\":\n\t\t\treturn \"child_run\";\n\t\tcase \"runtime\":\n\t\t\treturn \"runtime\";\n\t\tdefault:\n\t\t\treturn \"runtime\";\n\t}\n}\n\nfunction stepKindForEntry(\n\tentryKind: AgentRuntimeLedgerEntryKind,\n\tevent: AgentTrajectoryEvent,\n): string {\n\tif (entryKind === \"model_call\") return \"AGENT_RUN_STEP_KIND_MODEL_CALL\";\n\tif (entryKind === \"tool_call\") return \"AGENT_RUN_STEP_KIND_TOOL_CALL_INTENT\";\n\tif (entryKind === \"tool_result\" && event.status === \"failed\") {\n\t\treturn \"AGENT_RUN_STEP_KIND_ERROR\";\n\t}\n\tif (entryKind === \"tool_result\") return \"AGENT_RUN_STEP_KIND_TOOL_RESULT\";\n\tif (entryKind === \"wait\" || entryKind === \"governance\") {\n\t\treturn \"AGENT_RUN_STEP_KIND_APPROVAL_WAIT\";\n\t}\n\treturn \"AGENT_RUN_STEP_KIND_SYSTEM\";\n}\n\nfunction workItemKindForEntry(kind: AgentRuntimeLedgerEntryKind): string {\n\tswitch (kind) {\n\t\tcase \"message\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_USER_INPUT\";\n\t\tcase \"model_call\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_MODEL_CALL\";\n\t\tcase \"tool_call\":\n\t\tcase \"tool_result\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_TOOL_CALL\";\n\t\tcase \"child_run\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_CHILD_RUN\";\n\t\tcase \"wait\":\n\t\tcase \"governance\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_WAIT\";\n\t\tcase \"checkpoint\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_RECOVERY\";\n\t\tcase \"artifact\":\n\t\tcase \"evidence\":\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_MEMORY\";\n\t\tdefault:\n\t\t\treturn \"AGENT_WORK_ITEM_KIND_ROOT\";\n\t}\n}\n\nfunction waitTypeForEntry(\n\tkind: AgentRuntimeLedgerEntryKind,\n\ttimelineItem?: ComposerRunTimelineItem,\n): string | undefined {\n\tif (kind !== \"wait\") {\n\t\treturn undefined;\n\t}\n\tswitch (timelineItem?.pendingRequestKind) {\n\t\tcase \"approval\":\n\t\tcase \"tool_retry\":\n\t\t\treturn \"AGENT_RUN_WAIT_TYPE_APPROVAL\";\n\t\tcase \"client_tool\":\n\t\tcase \"mcp_elicitation\":\n\t\tcase \"user_input\":\n\t\t\treturn \"AGENT_RUN_WAIT_TYPE_INPUT\";\n\t}\n\tif (timelineItem?.approvalRequestId) return \"AGENT_RUN_WAIT_TYPE_APPROVAL\";\n\tif (timelineItem?.pendingRequestId) return \"AGENT_RUN_WAIT_TYPE_INPUT\";\n\treturn \"AGENT_RUN_WAIT_TYPE_APPROVAL\";\n}\n\nfunction buildLedgerEntries(\n\ttimeline: ComposerRunTimelineResponse,\n\ttrajectory: AgentTrajectoryReport,\n): AgentRuntimeLedgerEntry[] {\n\tconst timelineItemsById = new Map(\n\t\ttimeline.items.map((item) => [item.id, item] as const),\n\t);\n\treturn trajectory.events.map((event) => {\n\t\tconst kind = kindForEvent(event);\n\t\tconst state = stateForStatus(event.status);\n\t\tconst timelineItemId = timelineIdForEvent(event);\n\t\tconst timelineItem = timelineItemId\n\t\t\t? timelineItemsById.get(timelineItemId)\n\t\t\t: undefined;\n\t\tconst waitType = waitTypeForEntry(kind, timelineItem);\n\t\treturn {\n\t\t\tid: `ledger:${event.id}`,\n\t\t\tsequence: event.sequence,\n\t\t\ttimestamp: event.timestamp,\n\t\t\tkind,\n\t\t\tphase: event.phase,\n\t\t\tactor: event.actor,\n\t\t\ttype: event.type,\n\t\t\tstate,\n\t\t\ttitle: event.title,\n\t\t\tvisibility: event.visibility,\n\t\t\tsource: event.source,\n\t\t\ttrajectoryEventId: event.id,\n\t\t\t...(timelineItemId ? { timelineItemId } : {}),\n\t\t\t...(event.toolName ? { toolName: event.toolName } : {}),\n\t\t\t...(event.summary ? { summary: event.summary } : {}),\n\t\t\trelatedIds: event.relatedIds ?? [],\n\t\t\tevidence: event.evidence,\n\t\t\tplatformShape: {\n\t\t\t\tstepKind: stepKindForEntry(kind, event),\n\t\t\t\tworkItemKind: workItemKindForEntry(kind),\n\t\t\t\t...(waitType ? { waitType } : {}),\n\t\t\t},\n\t\t};\n\t});\n}\n\nfunction replaySummary(\n\treplay: AgentTrajectoryReplayReport,\n\tentries: AgentRuntimeLedgerEntry[],\n): AgentRuntimeLedgerReplaySummary {\n\treturn {\n\t\tschemaVersion: AGENT_RUNTIME_REPLAY_SUMMARY_SCHEMA,\n\t\tdeterministic: replay.counts.deltas === 0 && replay.counts.errors === 0,\n\t\tevents: replay.counts.events,\n\t\tdeltas: replay.counts.deltas,\n\t\terrors: replay.counts.errors,\n\t\twarnings: replay.counts.warnings,\n\t\tcursor: {\n\t\t\t...(entries[0] ? { startSequence: entries[0].sequence } : {}),\n\t\t\t...(entries.at(-1) ? { endSequence: entries.at(-1)?.sequence } : {}),\n\t\t},\n\t};\n}\n\nconst PASSIVE_TERMINAL_ENTRY_KINDS = new Set<AgentRuntimeLedgerEntryKind>([\n\t\"run\",\n\t\"wait\",\n\t\"governance\",\n]);\n\nfunction isTerminalState(state: AgentRuntimeLedgerState): boolean {\n\treturn (\n\t\tstate === \"succeeded\" ||\n\t\tstate === \"skipped\" ||\n\t\tstate === \"failed\" ||\n\t\tstate === \"cancelled\"\n\t);\n}\n\nfunction isTerminalCandidate(entry: AgentRuntimeLedgerEntry): boolean {\n\treturn (\n\t\tisTerminalState(entry.state) &&\n\t\t!PASSIVE_TERMINAL_ENTRY_KINDS.has(entry.kind)\n\t);\n}\n\nfunction runStepStateForEntry(\n\tentry: AgentRuntimeLedgerEntry,\n): AgentRuntimePromotionStepState {\n\treturn entry.state === \"blocked\" ? \"failed\" : entry.state;\n}\n\nfunction terminalEntry(\n\tentries: AgentRuntimeLedgerEntry[],\n): AgentRuntimeLedgerEntry | undefined {\n\tconst last = entries.at(-1);\n\tif (!last || !isTerminalState(last.state)) return undefined;\n\tif (isTerminalCandidate(last)) return last;\n\tfor (let index = entries.length - 1; index >= 0; index -= 1) {\n\t\tconst entry = entries[index];\n\t\tif (entry && isTerminalCandidate(entry)) return entry;\n\t}\n\treturn undefined;\n}\n\nfunction terminalOperation(\n\trunId: string,\n\tentries: AgentRuntimeLedgerEntry[],\n): AgentRuntimePromotionOperation | undefined {\n\tconst terminal = terminalEntry(entries);\n\tif (!terminal) return undefined;\n\tconst succeeded =\n\t\tterminal.state === \"succeeded\" || terminal.state === \"skipped\";\n\treturn {\n\t\toperation: succeeded ? \"complete_run\" : \"fail_run\",\n\t\tid: `promote:${runId}:terminal`,\n\t\tpayload: {\n\t\t\tstate: succeeded ? \"succeeded\" : \"failed\",\n\t\t\ttimestamp: terminal.timestamp,\n\t\t\t...(succeeded\n\t\t\t\t? {}\n\t\t\t\t: {\n\t\t\t\t\t\treason: `Terminal ledger entry ended in ${terminal.state} state.`,\n\t\t\t\t\t}),\n\t\t},\n\t};\n}\n\nfunction terminalOperationWarning(\n\tentries: AgentRuntimeLedgerEntry[],\n): string | undefined {\n\tconst last = entries.at(-1);\n\tif (!last) {\n\t\treturn \"Terminal operation omitted because no ledger entries were available.\";\n\t}\n\tif (terminalEntry(entries)) {\n\t\treturn undefined;\n\t}\n\tif (isTerminalState(last.state)) {\n\t\treturn \"Terminal operation omitted because no substantive terminal ledger entry was available.\";\n\t}\n\treturn `Terminal operation omitted because final ledger entry ended in ${last.state} state.`;\n}\n\nfunction buildPromotionPlan(\n\trunId: string,\n\tsessionId: string,\n\tgeneratedAt: string,\n\tentries: AgentRuntimeLedgerEntry[],\n): AgentRuntimePromotionPlan {\n\tconst idempotencyKey = `maestro-local-ledger:${sessionId}:${runId}`;\n\tconst operations: AgentRuntimePromotionOperation[] = [\n\t\t{\n\t\t\toperation: \"handle_trigger\",\n\t\t\tid: `promote:${runId}:trigger`,\n\t\t\tpayload: {\n\t\t\t\tsourceEventType: \"maestro.local_ledger_promote\",\n\t\t\t\tsourceEventId: sessionId,\n\t\t\t\tidempotencyKey,\n\t\t\t\tsessionId,\n\t\t\t\tgeneratedAt,\n\t\t\t},\n\t\t},\n\t];\n\n\tfor (const entry of entries) {\n\t\toperations.push({\n\t\t\toperation: \"record_run_step\",\n\t\t\tid: `promote:${entry.id}:step`,\n\t\t\tledgerEntryId: entry.id,\n\t\t\tpayload: {\n\t\t\t\tstepId: entry.id,\n\t\t\t\tkind: entry.platformShape.stepKind,\n\t\t\t\tstate: runStepStateForEntry(entry),\n\t\t\t\ttitle: entry.title,\n\t\t\t\ttimestamp: entry.timestamp,\n\t\t\t\t...(entry.toolName ? { toolName: entry.toolName } : {}),\n\t\t\t},\n\t\t});\n\t\toperations.push({\n\t\t\toperation: \"record_run_work_item\",\n\t\t\tid: `promote:${entry.id}:work-item`,\n\t\t\tledgerEntryId: entry.id,\n\t\t\tpayload: {\n\t\t\t\tworkItemId: entry.id,\n\t\t\t\tkind: entry.platformShape.workItemKind,\n\t\t\t\tstate: entry.state,\n\t\t\t\ttitle: entry.title,\n\t\t\t\ttimestamp: entry.timestamp,\n\t\t\t},\n\t\t});\n\t\tif (entry.platformShape.waitType) {\n\t\t\toperations.push({\n\t\t\t\toperation: \"wait_run\",\n\t\t\t\tid: `promote:${entry.id}:wait`,\n\t\t\t\tledgerEntryId: entry.id,\n\t\t\t\tpayload: {\n\t\t\t\t\twaitId: entry.id,\n\t\t\t\t\twaitType: entry.platformShape.waitType,\n\t\t\t\t\ttitle: entry.title,\n\t\t\t\t\ttimestamp: entry.timestamp,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\t}\n\n\tconst terminal = terminalOperation(runId, entries);\n\tif (terminal) operations.push(terminal);\n\tconst terminalWarning = terminalOperationWarning(entries);\n\tconst warnings = [\n\t\t\"Promotion plan is dry-run only; no Platform AgentRuntime writes were performed.\",\n\t\t...(terminalWarning ? [terminalWarning] : []),\n\t];\n\n\treturn {\n\t\tschemaVersion: AGENT_RUNTIME_PROMOTION_PLAN_SCHEMA,\n\t\trunId,\n\t\tsessionId,\n\t\tidempotencyKey,\n\t\toperations,\n\t\twarnings,\n\t};\n}\n\nexport function buildAgentRuntimeLedgerReport(\n\toptions: BuildAgentRuntimeLedgerOptions,\n): AgentRuntimeLedgerReport {\n\tconst entries = buildLedgerEntries(options.timeline, options.trajectory);\n\tconst byKind: Record<string, number> = {};\n\tconst byState: Record<string, number> = {};\n\tfor (const entry of entries) {\n\t\tincrement(byKind, entry.kind);\n\t\tincrement(byState, entry.state);\n\t}\n\tconst runId = options.trajectory.run.id;\n\tconst sessionId = options.trajectory.run.sessionId;\n\tconst promotion = buildPromotionPlan(\n\t\trunId,\n\t\tsessionId,\n\t\toptions.trajectory.run.generatedAt,\n\t\tentries,\n\t);\n\n\treturn {\n\t\tschemaVersion: AGENT_RUNTIME_LEDGER_SCHEMA,\n\t\trun: {\n\t\t\tid: runId,\n\t\t\tsessionId,\n\t\t\tsource: options.timeline.source,\n\t\t\tgeneratedAt: options.trajectory.run.generatedAt,\n\t\t\tplatformBacked: options.trajectory.run.platformBacked,\n\t\t\t...(options.session.sessionFile\n\t\t\t\t? { sessionFile: options.session.sessionFile }\n\t\t\t\t: {}),\n\t\t\t...(options.session.cwd ? { cwd: options.session.cwd } : {}),\n\t\t\t...(options.session.model ? { model: options.session.model } : {}),\n\t\t},\n\t\tcounts: {\n\t\t\tentries: entries.length,\n\t\t\tpromotionOperations: promotion.operations.length,\n\t\t\tbyKind,\n\t\t\tbyState,\n\t\t},\n\t\tentries,\n\t\treplay: replaySummary(options.replay, entries),\n\t\tpromotion,\n\t};\n}\n"]}

package/dist/server/agent-trajectory-inspection.d.ts

@@ -0,0 +1,104 @@
+import type { ComposerRunTimelineItem } from "@evalops/contracts";
+import type { AgentTrajectoryReplayDelta, AgentTrajectoryReplayReport } from "./agent-trajectory-replay.js";
+import type { AgentTrajectoryScoreFinding, AgentTrajectoryScoreReport } from "./agent-trajectory-scorers.js";
+import type { AgentTrajectoryEvent, AgentTrajectoryReport } from "./agent-trajectory.js";
+export declare const AGENT_TRAJECTORY_INSPECTION_SCHEMA = "evalops.maestro.agent-trajectory-inspection.v1";
+type EvidenceAnchor = AgentTrajectoryEvent["evidence"][number];
+export interface AgentTrajectoryInspectionEvidenceAnchor extends EvidenceAnchor {
+    redacted: true;
+    label: string;
+}
+export interface AgentTrajectoryInspectionTimelineItem {
+    id: string;
+    timestamp: string;
+    type: string;
+    status: ComposerRunTimelineItem["status"];
+    visibility: ComposerRunTimelineItem["visibility"];
+    source: ComposerRunTimelineItem["source"];
+    title: string;
+    summary?: string;
+    role?: ComposerRunTimelineItem["role"];
+    toolName?: string;
+    pendingRequestKind?: ComposerRunTimelineItem["pendingRequestKind"];
+    platformOperation?: ComposerRunTimelineItem["platformOperation"];
+    metadataKeys: string[];
+    redacted: true;
+}
+export interface AgentTrajectoryInspectionEvent {
+    id: string;
+    sequence: number;
+    timestamp: string;
+    kind: AgentTrajectoryEvent["kind"];
+    phase: AgentTrajectoryEvent["phase"];
+    actor: AgentTrajectoryEvent["actor"];
+    type: string;
+    status: AgentTrajectoryEvent["status"];
+    visibility: AgentTrajectoryEvent["visibility"];
+    source: AgentTrajectoryEvent["source"];
+    title: string;
+    summary?: string;
+    toolName?: string;
+    relatedIds: string[];
+    timelineItemIds: string[];
+    evidence: AgentTrajectoryInspectionEvidenceAnchor[];
+}
+export interface AgentTrajectoryInspectionReplayDelta {
+    id: string;
+    severity: AgentTrajectoryReplayDelta["severity"];
+    ruleId: string;
+    message: string;
+    eventId?: string;
+    timelineItemIds: string[];
+    evidence: AgentTrajectoryInspectionEvidenceAnchor[];
+}
+export interface AgentTrajectoryInspectionScoreFinding {
+    ruleId: string;
+    status: AgentTrajectoryScoreFinding["status"];
+    severity: AgentTrajectoryScoreFinding["severity"];
+    message: string;
+    eventIds: string[];
+    timelineItemIds: string[];
+    evidence: AgentTrajectoryInspectionEvidenceAnchor[];
+    remediation: string;
+}
+export interface AgentTrajectoryInspectionFinalAnswer {
+    eventId: string;
+    timelineItemIds: string[];
+    title: string;
+    summary?: string;
+    redacted: true;
+}
+export interface AgentTrajectoryInspectionReport {
+    schemaVersion: typeof AGENT_TRAJECTORY_INSPECTION_SCHEMA;
+    trajectorySchemaVersion: AgentTrajectoryReport["schemaVersion"];
+    replaySchemaVersion: AgentTrajectoryReplayReport["schemaVersion"];
+    scoreSchemaVersion: AgentTrajectoryScoreReport["schemaVersion"];
+    run: AgentTrajectoryReport["run"];
+    redaction: {
+        default: "redacted";
+        omitted: string[];
+    };
+    counts: {
+        timelineItems: number;
+        events: number;
+        replayDeltas: number;
+        scoreFindings: number;
+        scoreFailures: number;
+        scoreWarnings: number;
+        jumpTargets: number;
+    };
+    finalAnswer?: AgentTrajectoryInspectionFinalAnswer;
+    timelineItems: AgentTrajectoryInspectionTimelineItem[];
+    events: AgentTrajectoryInspectionEvent[];
+    replayDeltas: AgentTrajectoryInspectionReplayDelta[];
+    scoreFindings: AgentTrajectoryInspectionScoreFinding[];
+}
+export interface BuildAgentTrajectoryInspectionReportOptions {
+    timelineItems: ComposerRunTimelineItem[];
+    trajectory: AgentTrajectoryReport;
+    replay: AgentTrajectoryReplayReport;
+    score: AgentTrajectoryScoreReport;
+}
+export declare function buildAgentTrajectoryInspectionReport({ timelineItems, trajectory, replay, score, }: BuildAgentTrajectoryInspectionReportOptions): AgentTrajectoryInspectionReport;
+export {};
+//# sourceMappingURL=agent-trajectory-inspection.d.ts.map

package/dist/server/agent-trajectory-inspection.d.ts.map

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