@petepetrash/circuit 0.1.0

package/dist/schemas/operator-summary.d.ts

@@ -0,0 +1,369 @@
+import { z } from 'zod';
+export declare const OperatorSummaryWarning: z.ZodObject<{
+    kind: z.ZodString;
+    message: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OperatorSummaryWarning = z.infer<typeof OperatorSummaryWarning>;
+export declare const OperatorSummaryReportLink: z.ZodObject<{
+    label: z.ZodString;
+    path: z.ZodString;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type OperatorSummaryReportLink = z.infer<typeof OperatorSummaryReportLink>;
+export declare const OperatorBriefSlots: z.ZodObject<{
+    headline: z.ZodString;
+    assessment: z.ZodString;
+    key_points: z.ZodArray<z.ZodString>;
+    caveats: z.ZodArray<z.ZodString>;
+    next_action: z.ZodString;
+}, z.core.$strict>;
+export type OperatorBriefSlots = z.infer<typeof OperatorBriefSlots>;
+export declare const OperatorAutoResolution: z.ZodObject<{
+    checkpoint_id: z.ZodString;
+    checkpoint_label: z.ZodOptional<z.ZodString>;
+    policy: z.ZodLiteral<"highest-score">;
+    resolved_value: z.ZodString;
+    alternatives_available: z.ZodArray<z.ZodString>;
+    scores: z.ZodRecord<z.ZodString, z.ZodObject<{
+        aggregate_score: z.ZodNumber;
+        runtime_veto_count: z.ZodNumber;
+    }, z.core.$strict>>;
+    rubric_results: z.ZodRecord<z.ZodString, z.ZodObject<{
+        dims: z.ZodRecord<z.ZodString, z.ZodObject<{
+            runtime_signal: z.ZodEnum<{
+                met: "met";
+                missing: "missing";
+                "n/a": "n/a";
+            }>;
+            model_judgment: z.ZodEnum<{
+                pass: "pass";
+                concern: "concern";
+                fail: "fail";
+            }>;
+            final_score: z.ZodEnum<{
+                pass: "pass";
+                concern: "concern";
+                fail: "fail";
+            }>;
+            dim_score: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<0.5>, z.ZodLiteral<0>]>;
+            runtime_vetoed: z.ZodBoolean;
+        }, z.core.$strict>>;
+        aggregate_score: z.ZodNumber;
+        runtime_veto_count: z.ZodNumber;
+        tie_break: z.ZodObject<{
+            ordered_dims: z.ZodArray<z.ZodString>;
+            final_reason: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    winning_score: z.ZodNumber;
+    runner_up_score: z.ZodOptional<z.ZodNumber>;
+    margin: z.ZodNullable<z.ZodNumber>;
+    tie_break: z.ZodString;
+    runtime_veto_effect: z.ZodString;
+    resolved_at: z.ZodString;
+}, z.core.$strict>;
+export type OperatorAutoResolution = z.infer<typeof OperatorAutoResolution>;
+export declare const OperatorSkillHookActivation: z.ZodObject<{
+    hook: z.ZodString;
+    mode: z.ZodEnum<{
+        auto: "auto";
+        mute: "mute";
+    }>;
+    source: z.ZodEnum<{
+        "project-policy": "project-policy";
+        "user-global-policy": "user-global-policy";
+        "default-mapping": "default-mapping";
+    }>;
+    policy_ref: z.ZodOptional<z.ZodString>;
+    injected_skills: z.ZodArray<z.ZodString>;
+    withheld_skills: z.ZodArray<z.ZodString>;
+    unavailable_skills: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperatorSkillHookActivation = z.infer<typeof OperatorSkillHookActivation>;
+export declare const OperatorEquipmentReshape: z.ZodObject<{
+    step_id: z.ZodString;
+    domain_tags: z.ZodArray<z.ZodString>;
+    equipped_steps: z.ZodArray<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type OperatorEquipmentReshape = z.infer<typeof OperatorEquipmentReshape>;
+export declare const OperatorRunReceiptSpendRole: z.ZodObject<{
+    role: z.ZodEnum<{
+        researcher: "researcher";
+        implementer: "implementer";
+        reviewer: "reviewer";
+    }>;
+    relays: z.ZodNumber;
+    relays_missing_usage: z.ZodNumber;
+    models: z.ZodArray<z.ZodString>;
+    input_tokens: z.ZodNumber;
+    output_tokens: z.ZodNumber;
+    cache_read_tokens: z.ZodNumber;
+    cache_creation_tokens: z.ZodNumber;
+    cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type OperatorRunReceiptSpendRole = z.infer<typeof OperatorRunReceiptSpendRole>;
+export declare const OperatorRunReceiptSpend: z.ZodObject<{
+    total_cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+    relays_missing_usage: z.ZodNumber;
+    partial: z.ZodBoolean;
+    roles: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            researcher: "researcher";
+            implementer: "implementer";
+            reviewer: "reviewer";
+        }>;
+        relays: z.ZodNumber;
+        relays_missing_usage: z.ZodNumber;
+        models: z.ZodArray<z.ZodString>;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_read_tokens: z.ZodNumber;
+        cache_creation_tokens: z.ZodNumber;
+        cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperatorRunReceiptSpend = z.infer<typeof OperatorRunReceiptSpend>;
+export declare const OperatorRunReceipt: z.ZodObject<{
+    depth: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        tournament: "tournament";
+        autonomous: "autonomous";
+    }>;
+    power: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    power_source: z.ZodOptional<z.ZodLiteral<"auto">>;
+    power_recommended: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    power_rationale: z.ZodOptional<z.ZodString>;
+    power_clamped: z.ZodOptional<z.ZodBoolean>;
+    worker_runs: z.ZodNumber;
+    escalations: z.ZodNumber;
+    models: z.ZodArray<z.ZodObject<{
+        provider: z.ZodEnum<{
+            custom: "custom";
+            openai: "openai";
+            anthropic: "anthropic";
+            gemini: "gemini";
+        }>;
+        model: z.ZodString;
+    }, z.core.$strict>>;
+    checks_evaluated: z.ZodNumber;
+    checks_failed: z.ZodNumber;
+    reduced_bindings: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        edit_file_surfaces: "edit_file_surfaces";
+        depth_binding: "depth_binding";
+        slice_loop: "slice_loop";
+        terminal_outcome_binding: "terminal_outcome_binding";
+        primary_result_surface: "primary_result_surface";
+    }>>>;
+    spend: z.ZodOptional<z.ZodObject<{
+        total_cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+        relays_missing_usage: z.ZodNumber;
+        partial: z.ZodBoolean;
+        roles: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                researcher: "researcher";
+                implementer: "implementer";
+                reviewer: "reviewer";
+            }>;
+            relays: z.ZodNumber;
+            relays_missing_usage: z.ZodNumber;
+            models: z.ZodArray<z.ZodString>;
+            input_tokens: z.ZodNumber;
+            output_tokens: z.ZodNumber;
+            cache_read_tokens: z.ZodNumber;
+            cache_creation_tokens: z.ZodNumber;
+            cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperatorRunReceipt = z.infer<typeof OperatorRunReceipt>;
+export declare const OperatorSummary: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    run_id: z.core.$ZodBranded<z.ZodGUID, "RunId", "out">;
+    flow_id: z.core.$ZodBranded<z.ZodString, "CompiledFlowId", "out">;
+    selected_flow: z.core.$ZodBranded<z.ZodString, "CompiledFlowId", "out">;
+    routed_by: z.ZodOptional<z.ZodLiteral<"explicit">>;
+    router_reason: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodUnion<readonly [z.ZodEnum<{
+        complete: "complete";
+        stopped: "stopped";
+        handoff: "handoff";
+        aborted: "aborted";
+        escalated: "escalated";
+    }>, z.ZodLiteral<"checkpoint_waiting">]>;
+    headline: z.ZodString;
+    status_text: z.ZodOptional<z.ZodString>;
+    brief_slots: z.ZodOptional<z.ZodObject<{
+        headline: z.ZodString;
+        assessment: z.ZodString;
+        key_points: z.ZodArray<z.ZodString>;
+        caveats: z.ZodArray<z.ZodString>;
+        next_action: z.ZodString;
+    }, z.core.$strict>>;
+    details: z.ZodArray<z.ZodString>;
+    evidence_warnings: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        message: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    run_folder: z.ZodString;
+    result_path: z.ZodOptional<z.ZodString>;
+    html_path: z.ZodOptional<z.ZodString>;
+    report_paths: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        path: z.ZodString;
+        schema: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    auto_resolutions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        checkpoint_id: z.ZodString;
+        checkpoint_label: z.ZodOptional<z.ZodString>;
+        policy: z.ZodLiteral<"highest-score">;
+        resolved_value: z.ZodString;
+        alternatives_available: z.ZodArray<z.ZodString>;
+        scores: z.ZodRecord<z.ZodString, z.ZodObject<{
+            aggregate_score: z.ZodNumber;
+            runtime_veto_count: z.ZodNumber;
+        }, z.core.$strict>>;
+        rubric_results: z.ZodRecord<z.ZodString, z.ZodObject<{
+            dims: z.ZodRecord<z.ZodString, z.ZodObject<{
+                runtime_signal: z.ZodEnum<{
+                    met: "met";
+                    missing: "missing";
+                    "n/a": "n/a";
+                }>;
+                model_judgment: z.ZodEnum<{
+                    pass: "pass";
+                    concern: "concern";
+                    fail: "fail";
+                }>;
+                final_score: z.ZodEnum<{
+                    pass: "pass";
+                    concern: "concern";
+                    fail: "fail";
+                }>;
+                dim_score: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<0.5>, z.ZodLiteral<0>]>;
+                runtime_vetoed: z.ZodBoolean;
+            }, z.core.$strict>>;
+            aggregate_score: z.ZodNumber;
+            runtime_veto_count: z.ZodNumber;
+            tie_break: z.ZodObject<{
+                ordered_dims: z.ZodArray<z.ZodString>;
+                final_reason: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        winning_score: z.ZodNumber;
+        runner_up_score: z.ZodOptional<z.ZodNumber>;
+        margin: z.ZodNullable<z.ZodNumber>;
+        tie_break: z.ZodString;
+        runtime_veto_effect: z.ZodString;
+        resolved_at: z.ZodString;
+    }, z.core.$strict>>>;
+    skill_hook_activations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        hook: z.ZodString;
+        mode: z.ZodEnum<{
+            auto: "auto";
+            mute: "mute";
+        }>;
+        source: z.ZodEnum<{
+            "project-policy": "project-policy";
+            "user-global-policy": "user-global-policy";
+            "default-mapping": "default-mapping";
+        }>;
+        policy_ref: z.ZodOptional<z.ZodString>;
+        injected_skills: z.ZodArray<z.ZodString>;
+        withheld_skills: z.ZodArray<z.ZodString>;
+        unavailable_skills: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
+    equipment_reshapes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        step_id: z.ZodString;
+        domain_tags: z.ZodArray<z.ZodString>;
+        equipped_steps: z.ZodArray<z.ZodString>;
+        reason: z.ZodString;
+    }, z.core.$strict>>>;
+    receipt: z.ZodOptional<z.ZodObject<{
+        depth: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            tournament: "tournament";
+            autonomous: "autonomous";
+        }>;
+        power: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        power_source: z.ZodOptional<z.ZodLiteral<"auto">>;
+        power_recommended: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        power_rationale: z.ZodOptional<z.ZodString>;
+        power_clamped: z.ZodOptional<z.ZodBoolean>;
+        worker_runs: z.ZodNumber;
+        escalations: z.ZodNumber;
+        models: z.ZodArray<z.ZodObject<{
+            provider: z.ZodEnum<{
+                custom: "custom";
+                openai: "openai";
+                anthropic: "anthropic";
+                gemini: "gemini";
+            }>;
+            model: z.ZodString;
+        }, z.core.$strict>>;
+        checks_evaluated: z.ZodNumber;
+        checks_failed: z.ZodNumber;
+        reduced_bindings: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            edit_file_surfaces: "edit_file_surfaces";
+            depth_binding: "depth_binding";
+            slice_loop: "slice_loop";
+            terminal_outcome_binding: "terminal_outcome_binding";
+            primary_result_surface: "primary_result_surface";
+        }>>>;
+        spend: z.ZodOptional<z.ZodObject<{
+            total_cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+            relays_missing_usage: z.ZodNumber;
+            partial: z.ZodBoolean;
+            roles: z.ZodArray<z.ZodObject<{
+                role: z.ZodEnum<{
+                    researcher: "researcher";
+                    implementer: "implementer";
+                    reviewer: "reviewer";
+                }>;
+                relays: z.ZodNumber;
+                relays_missing_usage: z.ZodNumber;
+                models: z.ZodArray<z.ZodString>;
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+                cache_read_tokens: z.ZodNumber;
+                cache_creation_tokens: z.ZodNumber;
+                cost_usd_reported: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    checkpoint: z.ZodOptional<z.ZodObject<{
+        step_id: z.ZodString;
+        request_path: z.ZodString;
+        allowed_choices: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type OperatorSummary = z.infer<typeof OperatorSummary>;
+//# sourceMappingURL=operator-summary.d.ts.map

package/dist/schemas/operator-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-summary.d.ts","sourceRoot":"","sources":["../../src/schemas/operator-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,sBAAsB;;;;kBAMxB,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;;kBAM3B,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAMlF,eAAO,MAAM,kBAAkB;;;;;;kBAQpB,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwBxB,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAS5E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;kBAiB7B,CAAC;AACZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAWtF,eAAO,MAAM,wBAAwB;;;;;kBAO1B,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAQhF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;kBAY7B,CAAC;AACZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAStF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;kBAOzB,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAkB9E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyBpB,CAAC;AACZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+BjB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/operator-summary.js

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+import { CompiledFlowId, RunId } from './ids.js';
+import { Power } from './power.js';
+import { CompiledDepth } from './process.js';
+import { MAX_STATUS_TEXT_CHARS } from './progress-event.js';
+import { RubricResult } from './rubric.js';
+import { ProviderScopedModel } from './selection-policy.js';
+import { RelayRole } from './step.js';
+import { CatalogSourcedBinding, RunClosedOutcome } from './trace-entry.js';
+export const OperatorSummaryWarning = z
+    .object({
+    kind: z.string().min(1),
+    message: z.string().min(1),
+    path: z.string().min(1).optional(),
+})
+    .strict();
+export const OperatorSummaryReportLink = z
+    .object({
+    label: z.string().min(1),
+    path: z.string().min(1),
+    schema: z.string().min(1).optional(),
+})
+    .strict();
+// The digest contract mirrors the five-slot output model directly. The older
+// dormant seat used headline/primary/why/startWith/cautions/nextStep, but that
+// shape had no key-points array and would make JSON disagree with the markdown
+// operators actually read.
+export const OperatorBriefSlots = z
+    .object({
+    headline: z.string().min(1),
+    assessment: z.string().min(1),
+    key_points: z.array(z.string().min(1)).max(4),
+    caveats: z.array(z.string().min(1)).max(3),
+    next_action: z.string().min(1),
+})
+    .strict();
+export const OperatorAutoResolution = z
+    .object({
+    checkpoint_id: z.string().min(1),
+    checkpoint_label: z.string().min(1).optional(),
+    policy: z.literal('highest-score'),
+    resolved_value: z.string().min(1),
+    alternatives_available: z.array(z.string().min(1)),
+    scores: z.record(z.string().min(1), z
+        .object({
+        aggregate_score: z.number().min(0).max(1),
+        runtime_veto_count: z.number().int().nonnegative(),
+    })
+        .strict()),
+    rubric_results: z.record(z.string().min(1), RubricResult),
+    winning_score: z.number().min(0).max(1),
+    runner_up_score: z.number().min(0).max(1).optional(),
+    margin: z.number().nullable(),
+    tie_break: z.string().min(1),
+    runtime_veto_effect: z.string().min(1),
+    resolved_at: z.string().min(1),
+})
+    .strict();
+// A digest of one skill-hook activation for the operator summary. Derived from
+// the run's `run.skill-hook` trace events so the operator can see, without
+// reading the raw trace, which hook fired, what it injected, where the rule that
+// authorized it lives (provenance), and any configured skill that could not be
+// found. `injected_skills` are the ids actually merged into the implementer
+// worker; `withheld_skills` resolved but were held back by a pending strict-mode
+// decision; `unavailable_skills` were named by the policy but did not resolve.
+export const OperatorSkillHookActivation = z
+    .object({
+    hook: z.string().min(1),
+    mode: z.enum(['auto', 'mute']),
+    source: z.enum(['project-policy', 'user-global-policy', 'default-mapping']),
+    policy_ref: z.string().min(1).optional(),
+    injected_skills: z.array(z.string().min(1)),
+    withheld_skills: z.array(z.string().min(1)),
+    unavailable_skills: z.array(z
+        .object({
+        id: z.string().min(1),
+        reason: z.string().min(1).optional(),
+    })
+        .strict()),
+})
+    .strict();
+// One honored live equipment reshape (Step 2: the engine adapted a running
+// flow), projected from the run's `run.equipment-reshape` trace entries so the
+// operator can see, without reading the raw trace, that a later relay gained
+// skills mid-run and why. `step_id` is the step whose confirmed discovery
+// triggered the reshape; `domain_tags` are the domains it confirmed;
+// `equipped_steps` are the steps that gained skills; `reason` is the rationale
+// recorded in the trace. Only honored reshapes (reshaped=true) appear here; a
+// discovery that parked as a finding is surfaced as an evidence warning instead,
+// so the operator sees why nothing changed.
+export const OperatorEquipmentReshape = z
+    .object({
+    step_id: z.string().min(1),
+    domain_tags: z.array(z.string().min(1)),
+    equipped_steps: z.array(z.string().min(1)),
+    reason: z.string().min(1),
+})
+    .strict();
+// Per-role model spend, joined reader-side from the trace: role and model come
+// from `relay.started`, the usage meter from `relay.completed`, on the shared
+// `(step_id, attempt)` key. Only completed relays count — a failed attempt
+// never reaches `relay.completed`, so it never bills. `models` entries are
+// `provider:model` strings in first-seen order. `cache_creation_tokens` is the
+// usage seam's TTL-summed total; the receipt does not split TTLs.
+export const OperatorRunReceiptSpendRole = z
+    .object({
+    role: RelayRole,
+    relays: z.number().int().positive(),
+    relays_missing_usage: z.number().int().nonnegative(),
+    models: z.array(z.string().min(1)),
+    input_tokens: z.number().nonnegative(),
+    output_tokens: z.number().nonnegative(),
+    cache_read_tokens: z.number().nonnegative(),
+    cache_creation_tokens: z.number().nonnegative(),
+    cost_usd_reported: z.number().nonnegative().optional(),
+})
+    .strict();
+// Run-level spend rollup. Absent (never empty) when no completed relay carried
+// a usage block, so a usage-less trace produces a byte-identical receipt. Role
+// order is fixed — researcher, implementer, reviewer — and roles with zero
+// completed relays are omitted. `total_cost_usd_reported` is present iff at
+// least one relay reported a cost. `partial` is the honesty bit: true when any
+// completed relay lacked usage or any usage lacked a reported cost, because a
+// sum with missing meters must never read as complete.
+export const OperatorRunReceiptSpend = z
+    .object({
+    total_cost_usd_reported: z.number().nonnegative().optional(),
+    relays_missing_usage: z.number().int().nonnegative(),
+    partial: z.boolean(),
+    roles: z.array(OperatorRunReceiptSpendRole).min(1),
+})
+    .strict();
+// End-of-run receipt: what the run actually spent and proved, aggregated from
+// the trace. `depth` comes from `run.bootstrapped`, `worker_runs` and `models`
+// from `relay.started` (distinct models in first-seen order; entries without a
+// resolved model still count as runs), and the check counts from every
+// `check.evaluated` entry across all attempts. The rendered digest line uses
+// plain words only — model ids stay here and in the run record. Deliberately
+// no retry count: relay attempt numbers also increment per slice in slice
+// loops, so a retry count derived from them would overstate failures.
+// `power` is the run's dial position and is absent when the dial was off. On
+// a fixed dial it is the first power a relay selection carried (the dial is
+// run-level so they all agree); under an auto setting it is the run's
+// resolved inference — NOT the first selection, which materialized the
+// medium fallback before the researcher's recommendation landed.
+// `escalations` counts relays that ran one tier above their allocation —
+// it is dial-provenance (power_escalated), not an attempt count, so it does
+// not reintroduce the retry-count overstatement above.
+export const OperatorRunReceipt = z
+    .object({
+    depth: CompiledDepth,
+    power: Power.optional(),
+    // Present only when the dial setting was `auto` (any relay selection
+    // carried power_source 'auto'). The three companion fields below are
+    // present only when a researcher recommendation actually resolved;
+    // their absence under `auto` means the run stayed on the medium fallback.
+    power_source: z.literal('auto').optional(),
+    power_recommended: Power.optional(),
+    power_rationale: z.string().min(1).optional(),
+    power_clamped: z.boolean().optional(),
+    worker_runs: z.number().int().nonnegative(),
+    escalations: z.number().int().nonnegative(),
+    models: z.array(ProviderScopedModel),
+    checks_evaluated: z.number().int().nonnegative(),
+    checks_failed: z.number().int().nonnegative(),
+    // Catalog-sourced bindings that fell back to defaults because no catalog
+    // package resolved for this flow id — a composed or published custom flow.
+    // Absent on a normal built-in run. Surfaced as a receipt note so a reduced
+    // run is visible, not silent. See
+    // docs/ideas/first-class-composition-sequence.md (Stage 1).
+    reduced_bindings: z.array(CatalogSourcedBinding).optional(),
+    spend: OperatorRunReceiptSpend.optional(),
+})
+    .strict();
+export const OperatorSummary = z
+    .object({
+    schema_version: z.literal(1),
+    run_id: RunId,
+    flow_id: CompiledFlowId,
+    selected_flow: CompiledFlowId,
+    routed_by: z.literal('explicit').optional(),
+    router_reason: z.string().min(1).optional(),
+    outcome: z.union([RunClosedOutcome, z.literal('checkpoint_waiting')]),
+    headline: z.string().min(1),
+    status_text: z.string().min(1).max(MAX_STATUS_TEXT_CHARS).optional(),
+    brief_slots: OperatorBriefSlots.optional(),
+    details: z.array(z.string().min(1)),
+    evidence_warnings: z.array(OperatorSummaryWarning),
+    run_folder: z.string().min(1),
+    result_path: z.string().min(1).optional(),
+    html_path: z.string().min(1).optional(),
+    report_paths: z.array(OperatorSummaryReportLink),
+    auto_resolutions: z.array(OperatorAutoResolution).optional(),
+    skill_hook_activations: z.array(OperatorSkillHookActivation).optional(),
+    equipment_reshapes: z.array(OperatorEquipmentReshape).optional(),
+    receipt: OperatorRunReceipt.optional(),
+    checkpoint: z
+        .object({
+        step_id: z.string().min(1),
+        request_path: z.string().min(1),
+        allowed_choices: z.array(z.string().min(1)).min(1),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+//# sourceMappingURL=operator-summary.js.map

package/dist/schemas/operator-summary.js.map

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