@mcoda/mswarm 0.1.57 → 0.1.61

package/dist/vendor/codali/runtime/RunLogger.d.ts

@@ -0,0 +1,71 @@
+import type { PhaseArtifactError, PhaseArtifactV1, VerificationReport } from "../cognitive/Types.js";
+import { type PhaseTelemetryInput, type RunSummaryInput, type SafetyTelemetryEventData } from "./RunTelemetryTypes.js";
+export type { SafetyTelemetryEventData, RunSummaryEventData, RunFinalDisposition, RunFailureClass, RunDisposition, RunQualityDimensions, RunArtifactReference, TelemetryReasonCode, SafetyTelemetryCategory, SafetyTelemetryDisposition, RunTelemetryValidationError, PhaseTelemetryRecord, PhaseTelemetryInput, PhaseUsageTelemetry, PhaseCostTelemetry, } from "./RunTelemetryTypes.js";
+export interface RunLogEvent {
+    type: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export type InvestigationGateStatus = "not_checked" | "pass" | "fail";
+export interface InvestigationGateSummary {
+    status: InvestigationGateStatus;
+    reason?: string;
+    missing?: string[];
+    required?: Record<string, number>;
+    observed?: Record<string, number>;
+    score?: number;
+    threshold?: number;
+}
+export interface InvestigationTelemetry extends Record<string, unknown> {
+    phase: "research";
+    status: "skipped" | "completed";
+    duration_ms: number;
+    tool_usage: Record<string, {
+        ok: number;
+        failed: number;
+        skipped: number;
+        total: number;
+    }>;
+    tool_usage_totals: {
+        ok: number;
+        failed: number;
+        skipped: number;
+        total: number;
+    };
+    evidence_gate: InvestigationGateSummary;
+    quota: InvestigationGateSummary;
+    budget: InvestigationGateSummary & {
+        required_cycles?: number;
+        cycles?: number;
+        required_ms?: number;
+        elapsed_ms?: number;
+    };
+    warnings?: string[];
+    summary?: string;
+}
+export interface InvestigationTelemetryEvent extends RunLogEvent {
+    type: "investigation_telemetry";
+    data: InvestigationTelemetry;
+}
+export declare const buildPhaseArtifact: (params: {
+    runId: string;
+    phase: string;
+    kind: string;
+    payload: unknown;
+    startedAtMs?: number;
+    endedAtMs?: number;
+    error?: PhaseArtifactError;
+}) => PhaseArtifactV1;
+export declare class RunLogger {
+    readonly logPath: string;
+    readonly logDir: string;
+    readonly runId: string;
+    constructor(workspaceRoot: string, logDir: string, runId: string);
+    log(type: string, data: Record<string, unknown>): Promise<void>;
+    logSafetyEvent(data: Omit<SafetyTelemetryEventData, "schema_version" | "run_id">): Promise<void>;
+    logPhaseTelemetry(data: PhaseTelemetryInput): Promise<void>;
+    logRunSummary(data: RunSummaryInput): Promise<void>;
+    logVerificationReport(report: VerificationReport): Promise<void>;
+    writePhaseArtifact(phase: string, kind: string, payload: unknown): Promise<string>;
+}
+//# sourceMappingURL=RunLogger.d.ts.map

package/dist/vendor/codali/runtime/RunLogger.d.ts.map

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

package/dist/vendor/codali/runtime/RunLogger.js

@@ -0,0 +1,100 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { normalizePhaseTelemetryRecord, normalizeRunEventPayload, normalizeRunSummaryData, stableSortValue, } from "./RunTelemetryTypes.js";
+const summarizePayload = (payload) => {
+    if (!payload || typeof payload !== "object")
+        return { type: typeof payload };
+    const objectPayload = payload;
+    const summary = {};
+    for (const key of ["status", "phase", "reason", "code"]) {
+        if (key in objectPayload)
+            summary[key] = objectPayload[key];
+    }
+    if (typeof objectPayload.error === "string")
+        summary.error = objectPayload.error;
+    if (Array.isArray(objectPayload.warnings))
+        summary.warning_count = objectPayload.warnings.length;
+    return summary;
+};
+export const buildPhaseArtifact = (params) => ({
+    schema_version: 1,
+    phase: params.phase,
+    kind: params.kind,
+    run_id: params.runId,
+    started_at_ms: params.startedAtMs,
+    ended_at_ms: params.endedAtMs,
+    duration_ms: params.startedAtMs !== undefined && params.endedAtMs !== undefined
+        ? params.endedAtMs - params.startedAtMs
+        : undefined,
+    error: params.error,
+    payload: params.payload,
+});
+export class RunLogger {
+    constructor(workspaceRoot, logDir, runId) {
+        const resolvedDir = path.resolve(workspaceRoot, logDir);
+        this.logDir = resolvedDir;
+        this.runId = runId;
+        this.logPath = path.join(resolvedDir, `${runId}.jsonl`);
+    }
+    async log(type, data) {
+        await fs.mkdir(path.dirname(this.logPath), { recursive: true });
+        const normalizedData = normalizeRunEventPayload(type, data, this.runId);
+        const event = {
+            type,
+            timestamp: new Date().toISOString(),
+            data: stableSortValue(normalizedData),
+        };
+        await fs.appendFile(this.logPath, `${JSON.stringify(event)}\n`, "utf8");
+    }
+    async logSafetyEvent(data) {
+        await this.log("safety_event", {
+            schema_version: 1,
+            run_id: this.runId,
+            ...data,
+        });
+    }
+    async logPhaseTelemetry(data) {
+        const normalized = normalizePhaseTelemetryRecord({
+            ...data,
+            run_id: data.run_id ?? this.runId,
+        });
+        await this.log("phase_telemetry", { ...normalized });
+    }
+    async logRunSummary(data) {
+        await this.log("run_summary", normalizeRunSummaryData({ ...data, run_id: data.run_id ?? this.runId }, this.runId));
+    }
+    async logVerificationReport(report) {
+        await this.log("verification_report", {
+            run_id: this.runId,
+            report,
+        });
+    }
+    async writePhaseArtifact(phase, kind, payload) {
+        const endedAt = Date.now();
+        const artifact = buildPhaseArtifact({
+            runId: this.runId,
+            phase,
+            kind,
+            payload,
+            endedAtMs: endedAt,
+        });
+        const phaseDir = path.join(this.logDir, "phase");
+        await fs.mkdir(phaseDir, { recursive: true });
+        const safePhase = phase.replace(/[^a-z0-9_-]/gi, "_");
+        const safeKind = kind.replace(/[^a-z0-9_-]/gi, "_");
+        const ext = "json";
+        const timestamp = Date.now();
+        const filename = `${this.runId}-${safePhase}-${safeKind}-${timestamp}.${ext}`;
+        const filePath = path.join(phaseDir, filename);
+        const content = JSON.stringify(artifact, null, 2);
+        await fs.writeFile(filePath, content, "utf8");
+        await this.log("phase_artifact", {
+            phase,
+            kind,
+            path: filePath,
+            schema_version: artifact.schema_version,
+            payload_summary: summarizePayload(payload),
+        });
+        return filePath;
+    }
+}

package/dist/vendor/codali/runtime/RunTelemetryTypes.d.ts

@@ -0,0 +1,117 @@
+export declare const RUN_TELEMETRY_SCHEMA_VERSION: 1;
+export type RunTelemetrySchemaVersion = typeof RUN_TELEMETRY_SCHEMA_VERSION;
+export type RunDisposition = "pass" | "fail" | "degraded";
+export type RunFailureClass = "execution_failure" | "verification_failure" | "policy_failure" | "safety_failure" | "patch_failure" | "provider_failure" | "unknown_failure";
+export type QualityDimensionStatus = "available" | "missing" | "degraded";
+export type TelemetrySource = "actual_usage" | "estimated_usage" | "unknown";
+export type TelemetryReasonCode = "usage_missing" | "cost_missing" | "provider_usage_not_exposed" | "pricing_unavailable" | "phase_not_model_invoking" | "not_applicable" | "unknown";
+export type SafetyTelemetryCategory = "tool" | "patch" | "critic" | "policy";
+export type SafetyTelemetryDisposition = "retryable" | "non_retryable";
+export interface SafetyTelemetryEventData {
+    schema_version: RunTelemetrySchemaVersion;
+    run_id: string;
+    phase: string;
+    category: SafetyTelemetryCategory;
+    code: string;
+    disposition: SafetyTelemetryDisposition;
+    message: string;
+    source?: string;
+    tool?: string;
+    failure_class?: RunFailureClass;
+    reason_codes?: string[];
+    details?: Record<string, unknown>;
+}
+export interface RunArtifactReference {
+    phase: string;
+    kind: string;
+    path?: string | null;
+    status: "present" | "missing";
+    reason_code?: string;
+}
+export interface PhaseUsageTelemetry {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+}
+export interface PhaseCostTelemetry {
+    usd?: number;
+    source: TelemetrySource;
+    pricing_source?: string;
+    reason_code?: TelemetryReasonCode;
+}
+export interface PhaseTelemetryRecord {
+    schema_version: RunTelemetrySchemaVersion;
+    run_id: string;
+    phase: string;
+    provider?: string;
+    model?: string;
+    duration_ms?: number;
+    usage?: PhaseUsageTelemetry;
+    cost?: PhaseCostTelemetry;
+    missing_usage_reason?: TelemetryReasonCode;
+    missing_cost_reason?: TelemetryReasonCode;
+    metadata?: Record<string, unknown>;
+}
+export interface PhaseTelemetryInput {
+    run_id?: string;
+    phase?: string;
+    provider?: string;
+    model?: string;
+    duration_ms?: number;
+    usage?: PhaseUsageTelemetry;
+    cost?: PhaseCostTelemetry;
+    missing_usage_reason?: TelemetryReasonCode;
+    missing_cost_reason?: TelemetryReasonCode;
+    metadata?: Record<string, unknown>;
+}
+export interface RunQualityDimensions {
+    plan: QualityDimensionStatus;
+    retrieval: QualityDimensionStatus;
+    patch: QualityDimensionStatus;
+    verification: QualityDimensionStatus;
+    final_disposition: QualityDimensionStatus;
+}
+export interface RunFinalDisposition {
+    status: RunDisposition;
+    failure_class?: RunFailureClass;
+    reason_codes: string[];
+    stage?: string;
+    retryable?: boolean | null;
+}
+export interface RunSummaryEventData extends Record<string, unknown> {
+    schema_version: RunTelemetrySchemaVersion;
+    run_id: string;
+    runId: string;
+    durationMs: number;
+    touchedFiles: string[];
+    quality_dimensions: RunQualityDimensions;
+    final_disposition: RunFinalDisposition;
+    artifact_references: RunArtifactReference[];
+    phase_telemetry: PhaseTelemetryRecord[];
+    missing_artifacts: string[];
+}
+export interface RunSummaryInput extends Record<string, unknown> {
+    schema_version?: number;
+    run_id?: string;
+    runId?: string;
+    durationMs?: number;
+    touchedFiles?: string[];
+    quality_dimensions?: Partial<RunQualityDimensions>;
+    final_disposition?: Partial<RunFinalDisposition>;
+    artifact_references?: RunArtifactReference[];
+    phase_telemetry?: PhaseTelemetryInput[];
+    missing_artifacts?: string[];
+}
+export declare class RunTelemetryValidationError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare const stableSortValue: (value: unknown) => unknown;
+export declare const normalizeFailureClass: (value: unknown) => RunFailureClass | undefined;
+export declare const normalizePhaseTelemetryRecord: (input: PhaseTelemetryInput) => PhaseTelemetryRecord;
+export declare const normalizeRunSummaryData: (input: RunSummaryInput, fallbackRunId?: string) => RunSummaryEventData;
+export declare const normalizeSafetyTelemetryEventData: (input: Omit<SafetyTelemetryEventData, "schema_version"> & {
+    schema_version?: number;
+}, fallbackRunId?: string) => SafetyTelemetryEventData;
+export declare const normalizeRunEventPayload: (type: string, data: Record<string, unknown>, fallbackRunId?: string) => Record<string, unknown>;
+//# sourceMappingURL=RunTelemetryTypes.d.ts.map

package/dist/vendor/codali/runtime/RunTelemetryTypes.d.ts.map

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

package/dist/vendor/codali/runtime/RunTelemetryTypes.js

@@ -0,0 +1,299 @@
+export const RUN_TELEMETRY_SCHEMA_VERSION = 1;
+export class RunTelemetryValidationError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = "RunTelemetryValidationError";
+        this.code = code;
+    }
+}
+const asRecord = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    return value;
+};
+const normalizeNonEmptyString = (value, code, message) => {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new RunTelemetryValidationError(code, message);
+    }
+    return value.trim();
+};
+const normalizeFiniteNumber = (value) => {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    return value;
+};
+const uniqueSortedStrings = (values) => {
+    if (!Array.isArray(values))
+        return [];
+    return Array.from(new Set(values
+        .filter((entry) => typeof entry === "string")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0))).sort((left, right) => left.localeCompare(right));
+};
+export const stableSortValue = (value) => {
+    if (Array.isArray(value)) {
+        return value.map((entry) => stableSortValue(entry));
+    }
+    if (!value || typeof value !== "object")
+        return value;
+    const source = value;
+    const ordered = Object.keys(source)
+        .sort((left, right) => left.localeCompare(right))
+        .map((key) => [key, stableSortValue(source[key])]);
+    return Object.fromEntries(ordered);
+};
+const QUALITY_DEFAULTS = {
+    plan: "missing",
+    retrieval: "missing",
+    patch: "missing",
+    verification: "missing",
+    final_disposition: "available",
+};
+const DISPOSITION_STATUSES = ["pass", "fail", "degraded"];
+const FAILURE_CLASSES = [
+    "execution_failure",
+    "verification_failure",
+    "policy_failure",
+    "safety_failure",
+    "patch_failure",
+    "provider_failure",
+    "unknown_failure",
+];
+const TELEMETRY_REASON_CODES = [
+    "usage_missing",
+    "cost_missing",
+    "provider_usage_not_exposed",
+    "pricing_unavailable",
+    "phase_not_model_invoking",
+    "not_applicable",
+    "unknown",
+];
+const normalizeQualityDimension = (value) => {
+    if (value === "available" || value === "missing" || value === "degraded")
+        return value;
+    return "missing";
+};
+export const normalizeFailureClass = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (FAILURE_CLASSES.includes(normalized)) {
+        return normalized;
+    }
+    return undefined;
+};
+const normalizeReasonCode = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (TELEMETRY_REASON_CODES.includes(normalized)) {
+        return normalized;
+    }
+    return undefined;
+};
+const normalizeArtifactReference = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return undefined;
+    const phase = typeof record.phase === "string" ? record.phase.trim() : "";
+    const kind = typeof record.kind === "string" ? record.kind.trim() : "";
+    if (!phase || !kind)
+        return undefined;
+    const status = record.status === "present" || record.status === "missing" ? record.status : "present";
+    const pathValue = typeof record.path === "string"
+        ? record.path
+        : record.path === null
+            ? null
+            : undefined;
+    const reasonCode = typeof record.reason_code === "string" && record.reason_code.trim().length > 0
+        ? record.reason_code.trim()
+        : undefined;
+    return {
+        phase,
+        kind,
+        status,
+        path: pathValue,
+        reason_code: reasonCode,
+    };
+};
+const normalizeTelemetrySource = (value) => {
+    if (value === "actual_usage" || value === "estimated_usage" || value === "unknown") {
+        return value;
+    }
+    return "unknown";
+};
+export const normalizePhaseTelemetryRecord = (input) => {
+    const runId = normalizeNonEmptyString(input.run_id, "phase_telemetry_missing_run_id", "phase telemetry requires run_id");
+    const phase = normalizeNonEmptyString(input.phase, "phase_telemetry_missing_phase", "phase telemetry requires phase");
+    const usageRecord = asRecord(input.usage);
+    const inputTokens = normalizeFiniteNumber(usageRecord?.input_tokens);
+    const outputTokens = normalizeFiniteNumber(usageRecord?.output_tokens);
+    const totalTokens = normalizeFiniteNumber(usageRecord?.total_tokens);
+    const hasUsage = inputTokens !== undefined || outputTokens !== undefined || totalTokens !== undefined;
+    const costRecord = asRecord(input.cost);
+    const costUsd = normalizeFiniteNumber(costRecord?.usd);
+    const costSource = normalizeTelemetrySource(costRecord?.source);
+    const costPricingSource = typeof costRecord?.pricing_source === "string" ? costRecord.pricing_source : undefined;
+    const costReasonCode = normalizeReasonCode(costRecord?.reason_code);
+    const hasCost = costUsd !== undefined || costSource !== "unknown" || costReasonCode !== undefined;
+    const missingUsageReason = normalizeReasonCode(input.missing_usage_reason);
+    const missingCostReason = normalizeReasonCode(input.missing_cost_reason);
+    if (!hasUsage && !missingUsageReason) {
+        throw new RunTelemetryValidationError("phase_telemetry_missing_usage_reason", "phase telemetry without usage requires missing_usage_reason");
+    }
+    if (!hasCost && !missingCostReason) {
+        throw new RunTelemetryValidationError("phase_telemetry_missing_cost_reason", "phase telemetry without cost requires missing_cost_reason");
+    }
+    return {
+        schema_version: RUN_TELEMETRY_SCHEMA_VERSION,
+        run_id: runId,
+        phase,
+        provider: typeof input.provider === "string" ? input.provider : undefined,
+        model: typeof input.model === "string" ? input.model : undefined,
+        duration_ms: normalizeFiniteNumber(input.duration_ms),
+        usage: hasUsage
+            ? {
+                input_tokens: inputTokens,
+                output_tokens: outputTokens,
+                total_tokens: totalTokens,
+            }
+            : undefined,
+        cost: hasCost
+            ? {
+                usd: costUsd,
+                source: costSource,
+                pricing_source: costPricingSource,
+                reason_code: costReasonCode,
+            }
+            : undefined,
+        missing_usage_reason: missingUsageReason,
+        missing_cost_reason: missingCostReason,
+        metadata: asRecord(input.metadata),
+    };
+};
+const normalizeDisposition = (value) => {
+    if (typeof value === "string" && DISPOSITION_STATUSES.includes(value)) {
+        return value;
+    }
+    return "pass";
+};
+const normalizeFinalDisposition = (value) => {
+    const record = asRecord(value);
+    const status = normalizeDisposition(record?.status);
+    const reasonCodes = uniqueSortedStrings(record?.reason_codes);
+    const failureClass = normalizeFailureClass(record?.failure_class);
+    const retryable = typeof record?.retryable === "boolean" || record?.retryable === null
+        ? record.retryable
+        : undefined;
+    return {
+        status,
+        failure_class: status === "pass" ? undefined : failureClass ?? "unknown_failure",
+        reason_codes: reasonCodes,
+        stage: typeof record?.stage === "string" ? record.stage : undefined,
+        retryable,
+    };
+};
+export const normalizeRunSummaryData = (input, fallbackRunId) => {
+    const resolvedRunIdCandidate = (typeof input.run_id === "string" ? input.run_id : undefined)
+        ?? (typeof input.runId === "string" ? input.runId : undefined)
+        ?? fallbackRunId;
+    const runId = normalizeNonEmptyString(resolvedRunIdCandidate, "run_summary_missing_run_id", "run summary requires run_id or runId");
+    const durationMs = normalizeFiniteNumber(input.durationMs) ?? 0;
+    const touchedFiles = uniqueSortedStrings(input.touchedFiles);
+    const qualityInput = asRecord(input.quality_dimensions);
+    const qualityDimensions = {
+        plan: normalizeQualityDimension(qualityInput?.plan ?? QUALITY_DEFAULTS.plan),
+        retrieval: normalizeQualityDimension(qualityInput?.retrieval ?? QUALITY_DEFAULTS.retrieval),
+        patch: normalizeQualityDimension(qualityInput?.patch ?? QUALITY_DEFAULTS.patch),
+        verification: normalizeQualityDimension(qualityInput?.verification ?? QUALITY_DEFAULTS.verification),
+        final_disposition: normalizeQualityDimension(qualityInput?.final_disposition ?? QUALITY_DEFAULTS.final_disposition),
+    };
+    const finalDisposition = normalizeFinalDisposition(input.final_disposition);
+    const artifactReferencesRaw = Array.isArray(input.artifact_references)
+        ? input.artifact_references
+        : [];
+    const artifactReferences = artifactReferencesRaw
+        .map((entry) => normalizeArtifactReference(entry))
+        .filter((entry) => Boolean(entry))
+        .sort((left, right) => `${left.phase}:${left.kind}:${left.path ?? ""}`.localeCompare(`${right.phase}:${right.kind}:${right.path ?? ""}`));
+    const missingArtifacts = uniqueSortedStrings(input.missing_artifacts
+        ?? artifactReferences
+            .filter((entry) => entry.status === "missing")
+            .map((entry) => `${entry.phase}:${entry.kind}`));
+    const phaseTelemetryRaw = Array.isArray(input.phase_telemetry) ? input.phase_telemetry : [];
+    const phaseTelemetry = phaseTelemetryRaw
+        .map((entry) => normalizePhaseTelemetryRecord({ ...entry, run_id: runId }))
+        .sort((left, right) => left.phase.localeCompare(right.phase));
+    const knownKeys = new Set([
+        "schema_version",
+        "run_id",
+        "runId",
+        "durationMs",
+        "touchedFiles",
+        "quality_dimensions",
+        "final_disposition",
+        "artifact_references",
+        "phase_telemetry",
+        "missing_artifacts",
+    ]);
+    const passthrough = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (knownKeys.has(key))
+            continue;
+        passthrough[key] = value;
+    }
+    return {
+        ...passthrough,
+        schema_version: RUN_TELEMETRY_SCHEMA_VERSION,
+        run_id: runId,
+        runId,
+        durationMs,
+        touchedFiles,
+        quality_dimensions: qualityDimensions,
+        final_disposition: finalDisposition,
+        artifact_references: artifactReferences,
+        phase_telemetry: phaseTelemetry,
+        missing_artifacts: missingArtifacts,
+    };
+};
+export const normalizeSafetyTelemetryEventData = (input, fallbackRunId) => {
+    const runId = normalizeNonEmptyString(input.run_id ?? fallbackRunId, "safety_event_missing_run_id", "safety telemetry requires run_id");
+    const phase = normalizeNonEmptyString(input.phase, "safety_event_missing_phase", "safety telemetry requires phase");
+    const code = normalizeNonEmptyString(input.code, "safety_event_missing_code", "safety telemetry requires code");
+    const message = normalizeNonEmptyString(input.message, "safety_event_missing_message", "safety telemetry requires message");
+    if (!input.category) {
+        throw new RunTelemetryValidationError("safety_event_missing_category", "safety telemetry requires category");
+    }
+    if (!input.disposition) {
+        throw new RunTelemetryValidationError("safety_event_missing_disposition", "safety telemetry requires disposition");
+    }
+    return {
+        schema_version: RUN_TELEMETRY_SCHEMA_VERSION,
+        run_id: runId,
+        phase,
+        category: input.category,
+        code,
+        disposition: input.disposition,
+        message,
+        source: typeof input.source === "string" ? input.source : undefined,
+        tool: typeof input.tool === "string" ? input.tool : undefined,
+        failure_class: normalizeFailureClass(input.failure_class),
+        reason_codes: uniqueSortedStrings(input.reason_codes),
+        details: asRecord(input.details),
+    };
+};
+export const normalizeRunEventPayload = (type, data, fallbackRunId) => {
+    if (type === "run_summary") {
+        return stableSortValue(normalizeRunSummaryData(data, fallbackRunId));
+    }
+    if (type === "phase_telemetry") {
+        return stableSortValue(normalizePhaseTelemetryRecord({
+            ...data,
+            run_id: typeof data.run_id === "string" ? data.run_id : fallbackRunId,
+        }));
+    }
+    if (type === "safety_event") {
+        return stableSortValue(normalizeSafetyTelemetryEventData(data, fallbackRunId));
+    }
+    return stableSortValue(data);
+};

package/dist/vendor/codali/runtime/Runner.d.ts

@@ -0,0 +1,66 @@
+import type { AgentEvent, Provider, ProviderMessage, ProviderRequest, ProviderResponseFormat, ProviderUsage } from "../providers/ProviderTypes.js";
+import { ToolRegistry } from "../tools/ToolRegistry.js";
+import type { ToolContext } from "../tools/ToolTypes.js";
+import type { RunLogger } from "./RunLogger.js";
+export interface RunnerOptions {
+    provider: Provider;
+    tools: ToolRegistry;
+    context: ToolContext;
+    maxSteps: number;
+    maxToolCalls: number;
+    maxTokens?: number;
+    temperature?: number;
+    responseFormat?: ProviderResponseFormat;
+    toolChoice?: ProviderRequest["toolChoice"];
+    stream?: boolean;
+    onEvent?: (event: AgentEvent) => void;
+    onToken?: (token: string) => void;
+    streamFlushMs?: number;
+    timeoutMs?: number;
+    logger?: RunLogger;
+}
+export interface RunnerResult {
+    finalMessage: ProviderMessage;
+    messages: ProviderMessage[];
+    toolCallsExecuted: number;
+    usage?: ProviderUsage;
+}
+export type RunnerBudgetReasonCode = "runner_timeout_exceeded" | "runner_tool_call_limit_exceeded" | "runner_step_limit_exceeded";
+export declare class RunnerBudgetError extends Error {
+    readonly code: RunnerBudgetReasonCode;
+    readonly metadata: {
+        reason_code: RunnerBudgetReasonCode;
+        step: number;
+        tool_calls_executed: number;
+        max_steps: number;
+        max_tool_calls: number;
+        timeout_ms?: number;
+    };
+    constructor(code: RunnerBudgetReasonCode, metadata: {
+        step: number;
+        tool_calls_executed: number;
+        max_steps: number;
+        max_tool_calls: number;
+        timeout_ms?: number;
+    });
+}
+export declare class Runner {
+    private provider;
+    private tools;
+    private context;
+    private maxSteps;
+    private maxToolCalls;
+    private maxTokens?;
+    private temperature?;
+    private responseFormat?;
+    private toolChoice?;
+    private stream?;
+    private onEvent?;
+    private onToken?;
+    private streamFlushMs?;
+    private timeoutMs?;
+    private logger?;
+    constructor(options: RunnerOptions);
+    run(initialMessages: ProviderMessage[]): Promise<RunnerResult>;
+}
+//# sourceMappingURL=Runner.d.ts.map

package/dist/vendor/codali/runtime/Runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Runner.d.ts","sourceRoot":"","sources":["../../src/runtime/Runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,sBAAsB,EAEtB,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,eAAe,CAAC;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,MAAM,sBAAsB,GAC9B,yBAAyB,GACzB,iCAAiC,GACjC,4BAA4B,CAAC;AAEjC,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE;QACjB,WAAW,EAAE,sBAAsB,CAAC;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;gBAGA,IAAI,EAAE,sBAAsB,EAC5B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAgBJ;AASD,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAyB;IAChD,OAAO,CAAC,UAAU,CAAC,CAAgC;IACnD,OAAO,CAAC,MAAM,CAAC,CAAU;IACzB,OAAO,CAAC,OAAO,CAAC,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAC,CAA0B;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAY;gBAEf,OAAO,EAAE,aAAa;IAkB5B,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAyLrE"}