@x12i/graphenix-trace-format 1.0.0

package/dist/trace/derive-graph-status.js

@@ -0,0 +1,59 @@
+import { isTerminalNodeStatus, isTerminalUnitStatus } from "../internal/trace-v2-utils.js";
+export function deriveGraphStatus(trace) {
+    const summary = trace.graphExecution;
+    const nodeStatuses = Object.values(trace.nodeExecutions).map((n) => n.status);
+    if (nodeStatuses.every((s) => s === "skipped")) {
+        return "skipped";
+    }
+    if (summary.failedNodeIds.length > 0) {
+        if (summary.completedNodeIds.length > 0) {
+            return "partial";
+        }
+        return "failed";
+    }
+    const allTerminal = nodeStatuses.every((s) => isTerminalNodeStatus(s));
+    if (allTerminal && summary.completedNodeIds.length === nodeStatuses.length) {
+        return "completed";
+    }
+    if (allTerminal && summary.completedNodeIds.length > 0) {
+        return "partial";
+    }
+    const unitStatuses = Object.values(trace.unitExecutions).map((u) => u.status);
+    if (unitStatuses.some((s) => s === "running")) {
+        return "running";
+    }
+    if (trace.status === "cancelled") {
+        return "cancelled";
+    }
+    if (trace.status === "queued" || trace.status === "created") {
+        return trace.status;
+    }
+    return trace.status;
+}
+export function deriveNodeStatusFromUnits(trace, nodeId) {
+    const nodeTrace = trace.nodeExecutions[nodeId];
+    if (!nodeTrace)
+        return "pending";
+    if (nodeTrace.status === "skipped")
+        return "skipped";
+    const units = nodeTrace.unitIds
+        .map((id) => trace.unitExecutions[id])
+        .filter(Boolean);
+    if (units.length === 0) {
+        return nodeTrace.status;
+    }
+    if (units.some((u) => u.status === "failed")) {
+        return "failed";
+    }
+    if (units.every((u) => u.status === "skipped")) {
+        return "skipped";
+    }
+    if (units.every((u) => isTerminalUnitStatus(u.status))) {
+        return "completed";
+    }
+    if (units.some((u) => u.status === "running")) {
+        return "running";
+    }
+    return nodeTrace.status;
+}
+//# sourceMappingURL=derive-graph-status.js.map

package/dist/trace/derive-graph-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-graph-status.js","sourceRoot":"","sources":["../../src/trace/derive-graph-status.ts"],"names":[],"mappings":"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"}

package/dist/trace/summarize-execution-trace.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutionTotals, GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
+export declare function summarizeExecutionTrace(trace: GraphExecutionTraceV2): ExecutionTotals;
+//# sourceMappingURL=summarize-execution-trace.d.ts.map

package/dist/trace/summarize-execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-execution-trace.d.ts","sourceRoot":"","sources":["../../src/trace/summarize-execution-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAE9C,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,GAC3B,eAAe,CAgEjB"}

package/dist/trace/summarize-execution-trace.js

@@ -0,0 +1,60 @@
+export function summarizeExecutionTrace(trace) {
+    const nodeExecutions = Object.values(trace.nodeExecutions);
+    const unitExecutions = Object.values(trace.unitExecutions);
+    const invocations = Object.values(trace.modelInvocations);
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let reasoningTokens = 0;
+    let costUsd = 0;
+    let hasCost = false;
+    let hasUsage = false;
+    for (const unit of unitExecutions) {
+        if (unit.usage) {
+            hasUsage = true;
+            inputTokens += unit.usage.inputTokens ?? 0;
+            outputTokens += unit.usage.outputTokens ?? 0;
+            reasoningTokens += unit.usage.reasoningTokens ?? 0;
+        }
+        if (unit.cost && typeof unit.cost.costUsd === "number") {
+            hasCost = true;
+            costUsd += unit.cost.costUsd;
+        }
+    }
+    for (const invocation of invocations) {
+        if (invocation.usage) {
+            hasUsage = true;
+            inputTokens += invocation.usage.inputTokens ?? 0;
+            outputTokens += invocation.usage.outputTokens ?? 0;
+            reasoningTokens += invocation.usage.reasoningTokens ?? 0;
+        }
+        if (invocation.cost && typeof invocation.cost.costUsd === "number") {
+            hasCost = true;
+            costUsd += invocation.cost.costUsd;
+        }
+    }
+    const warnings = nodeExecutions.reduce((sum, n) => sum + (n.warnings?.length ?? 0), 0) +
+        unitExecutions.reduce((sum, u) => sum + (u.warnings?.length ?? 0), 0);
+    return {
+        durationMs: trace.graphExecution.graphDurationMs,
+        nodeCount: nodeExecutions.length,
+        completedNodeCount: trace.graphExecution.completedNodeIds.length,
+        failedNodeCount: trace.graphExecution.failedNodeIds.length,
+        skippedNodeCount: trace.graphExecution.skippedNodeIds.length,
+        unitCount: unitExecutions.length,
+        completedUnitCount: trace.graphExecution.completedUnitIds.length,
+        failedUnitCount: trace.graphExecution.failedUnitIds.length,
+        skippedUnitCount: trace.graphExecution.skippedUnitIds.length,
+        modelInvocationCount: invocations.length,
+        inputTokens: hasUsage ? inputTokens : undefined,
+        outputTokens: hasUsage ? outputTokens : undefined,
+        reasoningTokens: hasUsage ? reasoningTokens : undefined,
+        totalTokens: hasUsage
+            ? inputTokens + outputTokens + reasoningTokens
+            : undefined,
+        costUsd: hasCost ? costUsd : undefined,
+        costStatus: hasCost ? "known" : "unknown",
+        warnings,
+        errors: trace.events.filter((e) => e.level === "error").length
+    };
+}
+//# sourceMappingURL=summarize-execution-trace.js.map

package/dist/trace/summarize-execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-execution-trace.js","sourceRoot":"","sources":["../../src/trace/summarize-execution-trace.ts"],"names":[],"mappings":"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"}

package/dist/validators/validate-execution-trace-v1.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutableGraphValidationResult } from "@x12i/graphenix-executable-contracts";
+import type { ResolvedNodeExecutionPlan } from "@x12i/graphenix-executable-contracts";
+export declare function validateExecutionTraceV1(trace: unknown, planNodePlans?: Record<string, ResolvedNodeExecutionPlan>): ExecutableGraphValidationResult;
+//# sourceMappingURL=validate-execution-trace-v1.d.ts.map

package/dist/validators/validate-execution-trace-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v1.d.ts","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v1.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAK5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AA2EtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GACxD,+BAA+B,CAiOjC"}

package/dist/validators/validate-execution-trace-v1.js

@@ -0,0 +1,155 @@
+import { EXECUTION_TRACE_FORMAT } from "@x12i/graphenix-executable-contracts";
+import { execError, isRecord } from "@x12i/graphenix-executable-contracts";
+function isOrderedByTimestamp(events) {
+    for (let index = 1; index < events.length; index += 1) {
+        const previous = Date.parse(events[index - 1].ts);
+        const current = Date.parse(events[index].ts);
+        if (Number.isNaN(previous) || Number.isNaN(current) || current < previous) {
+            return false;
+        }
+    }
+    return true;
+}
+function unitFallbackAllowed(unitTrace, allowedTriggers) {
+    if (!unitTrace.fallback?.applied) {
+        return true;
+    }
+    const trigger = unitTrace.fallback.trigger;
+    if (!trigger) {
+        return false;
+    }
+    return allowedTriggers.includes(trigger);
+}
+function collectUnitUsage(nodeExecutions) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let costUsd = 0;
+    let hasUsage = false;
+    let hasCost = false;
+    for (const nodeTrace of Object.values(nodeExecutions)) {
+        if (!isRecord(nodeTrace)) {
+            continue;
+        }
+        const units = nodeTrace.units;
+        if (isRecord(units)) {
+            for (const unitTrace of Object.values(units)) {
+                if (!isRecord(unitTrace)) {
+                    continue;
+                }
+                const usage = unitTrace.usage;
+                if (isRecord(usage)) {
+                    hasUsage = true;
+                    inputTokens +=
+                        typeof usage.inputTokens === "number" ? usage.inputTokens : 0;
+                    outputTokens +=
+                        typeof usage.outputTokens === "number" ? usage.outputTokens : 0;
+                }
+                const cost = unitTrace.cost;
+                if (isRecord(cost) && typeof cost.costUsd === "number") {
+                    hasCost = true;
+                    costUsd += cost.costUsd;
+                }
+            }
+        }
+    }
+    return { inputTokens, outputTokens, costUsd, hasUsage, hasCost };
+}
+export function validateExecutionTraceV1(trace, planNodePlans) {
+    const errors = [];
+    if (!isRecord(trace)) {
+        return {
+            valid: false,
+            errors: [
+                execError("EXECUTION_TRACE_INVALID", "Execution trace must be an object.", "")
+            ]
+        };
+    }
+    if (trace.format !== EXECUTION_TRACE_FORMAT) {
+        errors.push(execError("EXECUTION_TRACE_FORMAT_INVALID", `format must be ${EXECUTION_TRACE_FORMAT}.`, "/format"));
+    }
+    if (typeof trace.traceId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_ID_MISSING", "traceId is required.", "/traceId"));
+    }
+    if (typeof trace.jobId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_JOB_ID_MISSING", "jobId is required.", "/jobId"));
+    }
+    const validStatuses = [
+        "queued",
+        "running",
+        "completed",
+        "failed",
+        "cancelled",
+        "partial"
+    ];
+    if (typeof trace.status !== "string" || !validStatuses.includes(trace.status)) {
+        errors.push(execError("EXECUTION_TRACE_STATUS_INVALID", "status must be a valid execution status.", "/status"));
+    }
+    const source = trace.source;
+    if (!isRecord(source) || typeof source.graphId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_SOURCE_MISSING", "source.graphId is required.", "/source"));
+    }
+    const plan = trace.plan;
+    if (!isRecord(plan) || typeof plan.planId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_PLAN_REFERENCE_MISSING", "plan.planId is required.", "/plan"));
+    }
+    const events = trace.events;
+    if (!Array.isArray(events)) {
+        errors.push(execError("EXECUTION_TRACE_EVENTS_MISSING", "events must be an array.", "/events"));
+    }
+    else if (!isOrderedByTimestamp(events)) {
+        errors.push(execError("EXECUTION_TRACE_EVENTS_NOT_ORDERED", "events must be append-only and ordered by timestamp.", "/events"));
+    }
+    const nodeExecutions = trace.nodeExecutions;
+    if (!isRecord(nodeExecutions)) {
+        errors.push(execError("EXECUTION_TRACE_NODE_EXECUTIONS_MISSING", "nodeExecutions is required.", "/nodeExecutions"));
+    }
+    else if (planNodePlans) {
+        for (const [nodeId, nodeTrace] of Object.entries(nodeExecutions)) {
+            if (!isRecord(nodeTrace)) {
+                continue;
+            }
+            const plannedNode = planNodePlans[nodeId];
+            if (!plannedNode) {
+                errors.push(execError("EXECUTION_TRACE_UNKNOWN_NODE", `nodeExecutions.${nodeId} is not present in executable plan.`, `/nodeExecutions/${nodeId}`));
+                continue;
+            }
+            const units = nodeTrace.units;
+            if (!isRecord(units)) {
+                errors.push(execError("EXECUTION_TRACE_UNITS_MISSING", `nodeExecutions.${nodeId}.units is required.`, `/nodeExecutions/${nodeId}/units`));
+                continue;
+            }
+            for (const plannedUnit of plannedNode.executionUnits) {
+                const unitTrace = units[plannedUnit.unitId];
+                if (!isRecord(unitTrace)) {
+                    errors.push(execError("EXECUTION_TRACE_UNKNOWN_UNIT", `nodeExecutions.${nodeId}.units must contain trace for planned unit ${plannedUnit.unitId}.`, `/nodeExecutions/${nodeId}/units/${plannedUnit.unitId}`));
+                    continue;
+                }
+                if (plannedNode.fallbackPolicy &&
+                    !unitFallbackAllowed(unitTrace, plannedNode.fallbackPolicy.allowedTriggers)) {
+                    errors.push(execError("EXECUTION_TRACE_UNIT_FALLBACK_NOT_ALLOWED", `Fallback on unit ${plannedUnit.unitId} is not allowed by executable plan policy.`, `/nodeExecutions/${nodeId}/units/${plannedUnit.unitId}/fallback`));
+                }
+            }
+        }
+    }
+    if (isRecord(trace.totals) && isRecord(nodeExecutions)) {
+        const { inputTokens, outputTokens, costUsd, hasUsage, hasCost } = collectUnitUsage(nodeExecutions);
+        const totals = trace.totals;
+        if (hasUsage &&
+            typeof totals.inputTokens === "number" &&
+            totals.inputTokens !== inputTokens) {
+            errors.push(execError("EXECUTION_TRACE_TOTALS_MISMATCH", "totals.inputTokens does not match unit usage totals.", "/totals/inputTokens"));
+        }
+        if (hasUsage &&
+            typeof totals.outputTokens === "number" &&
+            totals.outputTokens !== outputTokens) {
+            errors.push(execError("EXECUTION_TRACE_TOTALS_MISMATCH", "totals.outputTokens does not match unit usage totals.", "/totals/outputTokens"));
+        }
+        if (hasCost &&
+            typeof totals.costUsd === "number" &&
+            Math.abs(totals.costUsd - costUsd) > 0.000001) {
+            errors.push(execError("EXECUTION_TRACE_TOTALS_MISMATCH", "totals.costUsd does not match unit cost totals.", "/totals/costUsd"));
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate-execution-trace-v1.js.map

package/dist/validators/validate-execution-trace-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v1.js","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v1.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAI3E,SAAS,oBAAoB,CAAC,MAA6B;IACzD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,QAAQ,EAAE,CAAC;YAC1E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,SAA6B,EAC7B,eAAuC;IAEvC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,gBAAgB,CAAC,cAAuC;IAO/D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QAC9B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzB,SAAS;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;gBAC9B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,QAAQ,GAAG,IAAI,CAAC;oBAChB,WAAW;wBACT,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChE,YAAY;wBACV,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpE,CAAC;gBAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;gBAC5B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACvD,OAAO,GAAG,IAAI,CAAC;oBACf,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAc,EACd,aAAyD;IAEzD,MAAM,MAAM,GAA8C,EAAE,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN,SAAS,CACP,yBAAyB,EACzB,oCAAoC,EACpC,EAAE,CACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,sBAAsB,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,kBAAkB,sBAAsB,GAAG,EAC3C,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,4BAA4B,EAC5B,sBAAsB,EACtB,UAAU,CACX,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,oBAAoB,EACpB,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,QAAQ;QACR,SAAS;QACT,WAAW;QACX,QAAQ;QACR,WAAW;QACX,SAAS;KACV,CAAC;IACF,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9E,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,0CAA0C,EAC1C,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,6BAA6B,EAC7B,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,CAAC,IAAI,CACT,SAAS,CACP,wCAAwC,EACxC,0BAA0B,EAC1B,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CACT,SAAS,CACP,gCAAgC,EAChC,0BAA0B,EAC1B,SAAS,CACV,CACF,CAAC;IACJ,CAAC;SAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CACT,SAAS,CACP,oCAAoC,EACpC,sDAAsD,EACtD,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,SAAS,CACP,yCAAyC,EACzC,6BAA6B,EAC7B,iBAAiB,CAClB,CACF,CAAC;IACJ,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzB,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CACT,SAAS,CACP,8BAA8B,EAC9B,kBAAkB,MAAM,qCAAqC,EAC7D,mBAAmB,MAAM,EAAE,CAC5B,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CACT,SAAS,CACP,+BAA+B,EAC/B,kBAAkB,MAAM,qBAAqB,EAC7C,mBAAmB,MAAM,QAAQ,CAClC,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;gBACrD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAC5C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,IAAI,CACT,SAAS,CACP,8BAA8B,EAC9B,kBAAkB,MAAM,8CAA8C,WAAW,CAAC,MAAM,GAAG,EAC3F,mBAAmB,MAAM,UAAU,WAAW,CAAC,MAAM,EAAE,CACxD,CACF,CAAC;oBACF,SAAS;gBACX,CAAC;gBAED,IACE,WAAW,CAAC,cAAc;oBAC1B,CAAC,mBAAmB,CAClB,SAA0C,EAC1C,WAAW,CAAC,cAAc,CAAC,eAAe,CAC3C,EACD,CAAC;oBACD,MAAM,CAAC,IAAI,CACT,SAAS,CACP,2CAA2C,EAC3C,oBAAoB,WAAW,CAAC,MAAM,4CAA4C,EAClF,mBAAmB,MAAM,UAAU,WAAW,CAAC,MAAM,WAAW,CACjE,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACvD,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAC7D,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,IACE,QAAQ;YACR,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;YACtC,MAAM,CAAC,WAAW,KAAK,WAAW,EAClC,CAAC;YACD,MAAM,CAAC,IAAI,CACT,SAAS,CACP,iCAAiC,EACjC,sDAAsD,EACtD,qBAAqB,CACtB,CACF,CAAC;QACJ,CAAC;QAED,IACE,QAAQ;YACR,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;YACvC,MAAM,CAAC,YAAY,KAAK,YAAY,EACpC,CAAC;YACD,MAAM,CAAC,IAAI,CACT,SAAS,CACP,iCAAiC,EACjC,uDAAuD,EACvD,sBAAsB,CACvB,CACF,CAAC;QACJ,CAAC;QAED,IACE,OAAO;YACP,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,QAAQ,EAC7C,CAAC;YACD,MAAM,CAAC,IAAI,CACT,SAAS,CACP,iCAAiC,EACjC,iDAAiD,EACjD,iBAAiB,CAClB,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/validators/validate-execution-trace-v2-structural.d.ts

@@ -0,0 +1,3 @@
+import type { TraceValidationResult } from "@x12i/graphenix-executable-contracts";
+export declare function validateExecutionTraceV2Structural(trace: unknown): TraceValidationResult;
+//# sourceMappingURL=validate-execution-trace-v2-structural.d.ts.map

package/dist/validators/validate-execution-trace-v2-structural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v2-structural.d.ts","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v2-structural.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AA0PlF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,qBAAqB,CAuKvB"}

package/dist/validators/validate-execution-trace-v2-structural.js

@@ -0,0 +1,215 @@
+import { EXECUTION_TRACE_FORMAT_V2 } from "@x12i/graphenix-executable-contracts";
+import { execError, isRecord } from "@x12i/graphenix-executable-contracts";
+const FORBIDDEN_TRACE_FIELDS = [
+    "credentials",
+    "openrouterApiKey",
+    "providerResponse"
+];
+const TERMINAL_GRAPH_EVENTS = new Set([
+    "graph.completed",
+    "graph.failed",
+    "graph.cancelled"
+]);
+const EXECUTION_EVENT_TYPES = new Set([
+    "graph.started",
+    "gate.evaluated",
+    "node.started",
+    "node.completed",
+    "node.failed",
+    "node.skipped",
+    "unit.started",
+    "unit.completed",
+    "unit.failed",
+    "unit.skipped",
+    "model.resolved",
+    "model.invocation.started",
+    "model.invocation.completed",
+    "model.invocation.failed",
+    "fallback.applied",
+    "retry.attempted",
+    "memory.read",
+    "memory.write",
+    "finalOutput.produced",
+    "contract.validation.completed"
+]);
+function containsForbiddenFields(value, path, errors) {
+    if (!isRecord(value))
+        return;
+    for (const field of FORBIDDEN_TRACE_FIELDS) {
+        if (field in value) {
+            errors.push(execError("EXECUTION_TRACE_V2_FORBIDDEN_FIELD", `Execution trace must not contain ${field}.`, `${path}/${field}`));
+        }
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (isRecord(child) || Array.isArray(child)) {
+            containsForbiddenFields(child, `${path}/${key}`, errors);
+        }
+    }
+}
+function validateEvents(trace, errors) {
+    const events = trace.events;
+    if (!Array.isArray(events))
+        return;
+    const seenSequences = new Set();
+    let lastSequence = -1;
+    let terminalIndex = -1;
+    const nodeIds = isRecord(trace.nodeExecutions)
+        ? new Set(Object.keys(trace.nodeExecutions))
+        : new Set();
+    const unitIds = isRecord(trace.unitExecutions)
+        ? new Set(Object.keys(trace.unitExecutions))
+        : new Set();
+    const gateIds = isRecord(trace.gateEvaluations)
+        ? new Set(Object.keys(trace.gateEvaluations))
+        : new Set();
+    const invocationIds = isRecord(trace.modelInvocations)
+        ? new Set(Object.keys(trace.modelInvocations))
+        : new Set();
+    for (const [index, event] of events.entries()) {
+        const path = `/events/${index}`;
+        if (!isRecord(event))
+            continue;
+        if (typeof event.sequence !== "number" || !Number.isInteger(event.sequence)) {
+            errors.push(execError("EXECUTION_TRACE_V2_EVENT_SEQUENCE_OUT_OF_ORDER", `Event ${index} must define integer sequence.`, `${path}/sequence`));
+        }
+        else {
+            if (seenSequences.has(event.sequence)) {
+                errors.push(execError("EXECUTION_TRACE_V2_EVENT_SEQUENCE_DUPLICATE", `Duplicate event sequence ${event.sequence}.`, `${path}/sequence`));
+            }
+            seenSequences.add(event.sequence);
+            if (event.sequence < lastSequence) {
+                errors.push(execError("EXECUTION_TRACE_V2_EVENT_SEQUENCE_OUT_OF_ORDER", `Event sequence ${event.sequence} is out of order.`, `${path}/sequence`));
+            }
+            lastSequence = event.sequence;
+        }
+        if (typeof event.nodeId === "string" && !nodeIds.has(event.nodeId)) {
+            errors.push(execError("EXECUTION_TRACE_V2_EVENT_UNKNOWN_NODE", `Event references unknown nodeId ${event.nodeId}.`, `${path}/nodeId`));
+        }
+        if (typeof event.unitId === "string" && !unitIds.has(event.unitId)) {
+            errors.push(execError("EXECUTION_TRACE_V2_EVENT_UNKNOWN_UNIT", `Event references unknown unitId ${event.unitId}.`, `${path}/unitId`));
+        }
+        if (typeof event.gateId === "string" && !gateIds.has(event.gateId)) {
+            errors.push(execError("EXECUTION_TRACE_V2_EVENT_UNKNOWN_GATE", `Event references unknown gateId ${event.gateId}.`, `${path}/gateId`));
+        }
+        if (typeof event.invocationId === "string" &&
+            !invocationIds.has(event.invocationId)) {
+            errors.push(execError("EXECUTION_TRACE_V2_UNKNOWN_INVOCATION", `Event references unknown invocationId ${event.invocationId}.`, `${path}/invocationId`));
+        }
+        if (typeof event.type === "string" && TERMINAL_GRAPH_EVENTS.has(event.type)) {
+            terminalIndex = index;
+        }
+    }
+    if (terminalIndex >= 0) {
+        for (let index = terminalIndex + 1; index < events.length; index += 1) {
+            const event = events[index];
+            if (!isRecord(event))
+                continue;
+            const eventType = String(event.type ?? "");
+            if (EXECUTION_EVENT_TYPES.has(eventType) &&
+                eventType !== "diagnostic" &&
+                eventType !== "warning") {
+                errors.push(execError("EXECUTION_TRACE_V2_EVENT_AFTER_TERMINAL", `Event after terminal graph event must be diagnostic or warning.`, `/events/${index}`));
+                break;
+            }
+        }
+    }
+}
+function validateDataPolicy(trace, errors) {
+    const diagnostics = trace.diagnostics;
+    const policy = isRecord(diagnostics) ? diagnostics.dataPolicy : undefined;
+    if (!isRecord(policy))
+        return;
+    const maxPreview = typeof policy.maxPreviewChars === "number" ? policy.maxPreviewChars : 512;
+    if (policy.storePrompts === false || policy.storeProviderResponses === false) {
+        const invocations = isRecord(trace.modelInvocations)
+            ? trace.modelInvocations
+            : {};
+        for (const [id, invocation] of Object.entries(invocations)) {
+            if (!isRecord(invocation))
+                continue;
+            const request = invocation.request;
+            const response = invocation.response;
+            if (policy.storePrompts === false &&
+                isRecord(request) &&
+                typeof request.preview === "string" &&
+                request.preview.length > maxPreview &&
+                !request.valueRef &&
+                !request.hash) {
+                errors.push(execError("EXECUTION_TRACE_V2_DATA_POLICY_VIOLATION", `Model invocation ${id} stores full prompt against data policy.`, `/modelInvocations/${id}/request/preview`));
+            }
+            if (policy.storeProviderResponses === false &&
+                isRecord(response) &&
+                typeof response.preview === "string" &&
+                response.preview.length > maxPreview &&
+                !response.valueRef &&
+                !response.hash) {
+                errors.push(execError("EXECUTION_TRACE_V2_DATA_POLICY_VIOLATION", `Model invocation ${id} stores full provider response against data policy.`, `/modelInvocations/${id}/response/preview`));
+            }
+        }
+    }
+}
+export function validateExecutionTraceV2Structural(trace) {
+    const errors = [];
+    if (!isRecord(trace)) {
+        return {
+            valid: false,
+            errors: [
+                execError("EXECUTION_TRACE_V2_INVALID", "Execution trace must be an object.", "")
+            ]
+        };
+    }
+    if (trace.format !== EXECUTION_TRACE_FORMAT_V2) {
+        errors.push(execError("EXECUTION_TRACE_V2_FORMAT_INVALID", `format must be ${EXECUTION_TRACE_FORMAT_V2}.`, "/format"));
+    }
+    if (typeof trace.traceId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_ID_MISSING", "traceId is required.", "/traceId"));
+    }
+    if (typeof trace.jobId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_JOB_ID_MISSING", "jobId is required.", "/jobId"));
+    }
+    const source = trace.source;
+    if (!isRecord(source) || typeof source.graphId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_SOURCE_MISSING", "source.graphId is required.", "/source/graphId"));
+    }
+    else if (typeof source.graphHash !== "string") {
+        errors.push(execError("EXECUTION_TRACE_V2_SOURCE_MISMATCH", "source.graphHash is required.", "/source/graphHash"));
+    }
+    const plan = trace.plan;
+    if (!isRecord(plan) || typeof plan.planId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_PLAN_REFERENCE_MISSING", "plan.planId is required.", "/plan/planId"));
+    }
+    else if (typeof plan.planHash !== "string") {
+        errors.push(execError("EXECUTION_TRACE_V2_PLAN_HASH_MISSING", "plan.planHash is required.", "/plan/planHash"));
+    }
+    const runtime = trace.runtime;
+    if (!isRecord(runtime) || typeof runtime.jobId !== "string") {
+        errors.push(execError("EXECUTION_TRACE_V2_RUNTIME_MISMATCH", "runtime.jobId is required.", "/runtime/jobId"));
+    }
+    else if (typeof trace.jobId === "string" &&
+        runtime.jobId !== trace.jobId) {
+        errors.push(execError("EXECUTION_TRACE_V2_RUNTIME_MISMATCH", "trace.jobId must match runtime.jobId.", "/jobId"));
+    }
+    if (!isRecord(trace.graphExecution)) {
+        errors.push(execError("EXECUTION_TRACE_V2_INVALID", "graphExecution is required.", "/graphExecution"));
+    }
+    if (!isRecord(trace.nodeExecutions)) {
+        errors.push(execError("EXECUTION_TRACE_NODE_EXECUTIONS_MISSING", "nodeExecutions is required.", "/nodeExecutions"));
+    }
+    if (!isRecord(trace.unitExecutions)) {
+        errors.push(execError("EXECUTION_TRACE_V2_INVALID", "unitExecutions is required.", "/unitExecutions"));
+    }
+    if (!isRecord(trace.gateEvaluations)) {
+        errors.push(execError("EXECUTION_TRACE_V2_INVALID", "gateEvaluations is required.", "/gateEvaluations"));
+    }
+    if (!isRecord(trace.modelInvocations)) {
+        errors.push(execError("EXECUTION_TRACE_V2_INVALID", "modelInvocations is required.", "/modelInvocations"));
+    }
+    if (!isRecord(trace.memory)) {
+        errors.push(execError("EXECUTION_TRACE_V2_INVALID", "memory is required.", "/memory"));
+    }
+    validateEvents(trace, errors);
+    validateDataPolicy(trace, errors);
+    containsForbiddenFields(trace, "", errors);
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate-execution-trace-v2-structural.js.map

package/dist/validators/validate-execution-trace-v2-structural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v2-structural.js","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v2-structural.ts"],"names":[],"mappings":"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"}

package/dist/validators/validate-execution-trace-v2.d.ts

@@ -0,0 +1,6 @@
+import type { ExecutableGraphPlanV2 } from "@x12i/graphenix-executable-contracts";
+import type { TraceValidationResult } from "@x12i/graphenix-executable-contracts";
+export declare function validateTraceAgainstPlanOnly(trace: unknown, plan: ExecutableGraphPlanV2): TraceValidationResult;
+export declare function validateExecutionTraceV2(trace: unknown, plan?: ExecutableGraphPlanV2): TraceValidationResult;
+export declare function computeExpectedPlanHash(plan: ExecutableGraphPlanV2): string;
+//# sourceMappingURL=validate-execution-trace-v2.d.ts.map

package/dist/validators/validate-execution-trace-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v2.d.ts","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAMlF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,qBAAqB,GAC1B,qBAAqB,CAMvB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,qBAAqB,GAC3B,qBAAqB,CA+BvB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE3E"}

package/dist/validators/validate-execution-trace-v2.js

@@ -0,0 +1,40 @@
+import { defaultHashFunction } from "@x12i/graphenix-executable-contracts";
+import { buildTracePlanRef } from "../internal/trace-v2-utils.js";
+import { validateExecutionTraceV2Structural } from "./validate-execution-trace-v2-structural.js";
+import { validateTraceAgainstPlan } from "./validate-trace-against-plan.js";
+export function validateTraceAgainstPlanOnly(trace, plan) {
+    const structural = validateExecutionTraceV2Structural(trace);
+    if (!structural.valid) {
+        return structural;
+    }
+    return validateTraceAgainstPlan(trace, plan);
+}
+export function validateExecutionTraceV2(trace, plan) {
+    const structural = validateExecutionTraceV2Structural(trace);
+    if (!structural.valid) {
+        return structural;
+    }
+    if (plan) {
+        const expectedPlanRef = buildTracePlanRef(plan);
+        const errors = [...structural.errors];
+        if (typeof trace.plan?.planHash ===
+            "string" &&
+            trace.plan.planHash !==
+                expectedPlanRef.planHash) {
+            errors.push({
+                source: "graphenix.executable",
+                code: "EXECUTION_TRACE_V2_PLAN_MISMATCH",
+                message: "trace.plan.planHash does not match executable plan hash.",
+                path: "/plan/planHash"
+            });
+        }
+        const planResult = validateTraceAgainstPlan(trace, plan);
+        errors.push(...planResult.errors);
+        return { valid: errors.length === 0, errors };
+    }
+    return structural;
+}
+export function computeExpectedPlanHash(plan) {
+    return defaultHashFunction(plan);
+}
+//# sourceMappingURL=validate-execution-trace-v2.js.map

package/dist/validators/validate-execution-trace-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace-v2.js","sourceRoot":"","sources":["../../src/validators/validate-execution-trace-v2.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,IAA2B;IAE3B,MAAM,UAAU,GAAG,kCAAkC,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAc,EACd,IAA4B;IAE5B,MAAM,UAAU,GAAG,kCAAkC,CAAC,KAAK,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,eAAe,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAEtC,IACE,OAAQ,KAA0C,CAAC,IAAI,EAAE,QAAQ;YAC/D,QAAQ;YACT,KAAwC,CAAC,IAAI,CAAC,QAAQ;gBACrD,eAAe,CAAC,QAAQ,EAC1B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,sBAAsB;gBAC9B,IAAI,EAAE,kCAAkC;gBACxC,OAAO,EAAE,0DAA0D;gBACnE,IAAI,EAAE,gBAAgB;aACvB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAElC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAA2B;IACjE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/validators/validate-execution-trace.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutableGraphValidationResult } from "@x12i/graphenix-executable-contracts";
+import type { ExecutableGraphPlanV2 } from "@x12i/graphenix-executable-contracts";
+import type { GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
+import type { ResolvedNodeExecutionPlan } from "@x12i/graphenix-executable-contracts";
+export declare function validateExecutionTrace(trace: unknown, planOrNodePlans?: ExecutableGraphPlanV2 | Record<string, ResolvedNodeExecutionPlan>): ExecutableGraphValidationResult;
+export declare function assertExecutionTrace(trace: unknown, plan: ExecutableGraphPlanV2): asserts trace is GraphExecutionTraceV2;
+//# sourceMappingURL=validate-execution-trace.d.ts.map

package/dist/validators/validate-execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-execution-trace.d.ts","sourceRoot":"","sources":["../../src/validators/validate-execution-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAOtF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,eAAe,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,GAClF,+BAA+B,CAgBjC;AAQD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,KAAK,IAAI,qBAAqB,CAMxC"}