@multiagency/sdk 0.3.1

package/dist/contract/run-log-schema.d.ts

@@ -0,0 +1,888 @@
+import { z } from "zod";
+/** Private, observational format. No field in this module may authorize an operation. */
+export declare const AGUI_VERSION = "1.0.3";
+export declare const AGUI_PROTOCOL_VERSION = "1.0";
+export declare const MAX_RECORDING_BYTES = 2000000;
+export declare const text: z.ZodString;
+export declare const id: z.ZodString;
+export declare const iso: z.ZodISODateTime;
+export declare const GapSchema: z.ZodObject<{
+    code: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    ref: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Gap = z.infer<typeof GapSchema>;
+/** A safe projection of one physical journal line, not the folded operation or its raw request. */
+export declare const JournalRecordSchema: z.ZodObject<{
+    line: z.ZodNumber;
+    recordedAt: z.ZodNullable<z.ZodISODateTime>;
+    idempotencyKey: z.ZodString;
+    type: z.ZodEnum<{
+        refusal: "refusal";
+        request: "request";
+        status: "status";
+        "submission-claim": "submission-claim";
+    }>;
+    method: z.ZodOptional<z.ZodEnum<{
+        shield: "shield";
+        swap: "swap";
+        transfer: "transfer";
+        unshield: "unshield";
+    }>>;
+    planId: z.ZodOptional<z.ZodString>;
+    correlationId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    refusal: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type JournalRecord = z.infer<typeof JournalRecordSchema>;
+export declare const JournalHistorySchema: z.ZodObject<{
+    agentId: z.ZodString;
+    records: z.ZodArray<z.ZodObject<{
+        line: z.ZodNumber;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        idempotencyKey: z.ZodString;
+        type: z.ZodEnum<{
+            refusal: "refusal";
+            request: "request";
+            status: "status";
+            "submission-claim": "submission-claim";
+        }>;
+        method: z.ZodOptional<z.ZodEnum<{
+            shield: "shield";
+            swap: "swap";
+            transfer: "transfer";
+            unshield: "unshield";
+        }>>;
+        planId: z.ZodOptional<z.ZodString>;
+        correlationId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        refusal: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    gaps: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type JournalHistory = z.infer<typeof JournalHistorySchema>;
+export declare const StartSchema: z.ZodObject<{
+    progressVersion: z.ZodOptional<z.ZodLiteral<1>>;
+    id: z.ZodString;
+    agentId: z.ZodString;
+    at: z.ZodISODateTime;
+    trigger: z.ZodEnum<{
+        operator: "operator";
+        schedule: "schedule";
+    }>;
+    schedule: z.ZodObject<{
+        on: z.ZodBoolean;
+        everyMin: z.ZodNumber;
+        maxUsd: z.ZodNumber;
+        lastRun: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>;
+    build: z.ZodObject<{
+        deployment: z.ZodNullable<z.ZodString>;
+        source: z.ZodString;
+        lockfile: z.ZodNullable<z.ZodString>;
+        packageJson: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    policy: z.ZodObject<{
+        revision: z.ZodNullable<z.ZodNumber>;
+        digest: z.ZodNullable<z.ZodString>;
+        status: z.ZodString;
+    }, z.core.$strip>;
+    strategy: z.ZodString;
+    grant: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const BudgetSchema: z.ZodObject<{
+    daily: z.ZodObject<{
+        limit_usd: z.ZodNullable<z.ZodString>;
+        remaining_usd: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    weekly: z.ZodObject<{
+        limit_usd: z.ZodNullable<z.ZodString>;
+        remaining_usd: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    monthly: z.ZodObject<{
+        limit_usd: z.ZodNullable<z.ZodString>;
+        remaining_usd: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const SeenSchema: z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    at: z.ZodISODateTime;
+    book: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        public: z.ZodString;
+        confidential: z.ZodString;
+        usd: z.ZodNumber;
+    }, z.core.$strip>>;
+    weightsBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    targetBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    driftBps: z.ZodNumber;
+    budget: z.ZodNullable<z.ZodObject<{
+        daily: z.ZodObject<{
+            limit_usd: z.ZodNullable<z.ZodString>;
+            remaining_usd: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        weekly: z.ZodObject<{
+            limit_usd: z.ZodNullable<z.ZodString>;
+            remaining_usd: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        monthly: z.ZodObject<{
+            limit_usd: z.ZodNullable<z.ZodString>;
+            remaining_usd: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    unresolved: z.ZodNumber;
+}, z.core.$strip>]>;
+export declare const PlanSchema: z.ZodObject<{
+    id: z.ZodString;
+    usd: z.ZodNumber;
+    legs: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        amount: z.ZodString;
+        amountOut: z.ZodString;
+        minAmountOut: z.ZodString;
+        costBps: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const DisplaySchema: z.ZodObject<{
+    asOf: z.ZodISODateTime;
+    assets: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        symbol: z.ZodString;
+        decimals: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const result: z.ZodObject<{
+    outcome: z.ZodString;
+    refusal: z.ZodNullable<z.ZodString>;
+    rejected: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+/** The current tick recorder's explicit failure marker; provider operation statuses are independent. */
+export declare const recordedTickFailed: (value: z.infer<typeof result>) => boolean;
+declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"STEP_STARTED">;
+    stepName: z.ZodEnum<{
+        "balances-after": "balances-after";
+        "balances-before": "balances-before";
+        execution: "execution";
+        planning: "planning";
+        recovery: "recovery";
+        sweep: "sweep";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"STEP_FINISHED">;
+    stepName: z.ZodEnum<{
+        "balances-after": "balances-after";
+        "balances-before": "balances-before";
+        execution: "execution";
+        planning: "planning";
+        recovery: "recovery";
+        sweep: "sweep";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"RUN_STARTED">;
+    threadId: z.ZodString;
+    runId: z.ZodString;
+    protocolVersion: z.ZodOptional<z.ZodLiteral<"1.0">>;
+}, z.core.$strict>, z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"CUSTOM">;
+    name: z.ZodLiteral<"treasury.observation">;
+    value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        stage: z.ZodLiteral<"submission">;
+        method: z.ZodEnum<{
+            shield: "shield";
+            swap: "swap";
+            transfer: "transfer";
+            unshield: "unshield";
+        }>;
+        correlationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        stage: z.ZodLiteral<"before">;
+        observation: z.ZodUnion<readonly [z.ZodObject<{
+            error: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            at: z.ZodISODateTime;
+            book: z.ZodArray<z.ZodObject<{
+                asset: z.ZodString;
+                public: z.ZodString;
+                confidential: z.ZodString;
+                usd: z.ZodNumber;
+            }, z.core.$strip>>;
+            weightsBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            targetBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            driftBps: z.ZodNumber;
+            budget: z.ZodNullable<z.ZodObject<{
+                daily: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                weekly: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                monthly: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            unresolved: z.ZodNumber;
+        }, z.core.$strip>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        index: z.ZodNumber;
+        correlationId: z.ZodString;
+        status: z.ZodString;
+        failureCode: z.ZodNullable<z.ZodString>;
+        historySource: z.ZodLiteral<"journal">;
+        history: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            idempotencyKey: z.ZodString;
+            type: z.ZodEnum<{
+                refusal: "refusal";
+                request: "request";
+                status: "status";
+                "submission-claim": "submission-claim";
+            }>;
+            method: z.ZodOptional<z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>>;
+            planId: z.ZodOptional<z.ZodString>;
+            correlationId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        untimedHistory: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            idempotencyKey: z.ZodString;
+            type: z.ZodEnum<{
+                refusal: "refusal";
+                request: "request";
+                status: "status";
+                "submission-claim": "submission-claim";
+            }>;
+            method: z.ZodOptional<z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>>;
+            planId: z.ZodOptional<z.ZodString>;
+            correlationId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        stage: z.ZodLiteral<"shield">;
+        asset: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        stage: z.ZodLiteral<"plan">;
+        plan: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            usd: z.ZodNumber;
+            legs: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                amount: z.ZodString;
+                amountOut: z.ZodString;
+                minAmountOut: z.ZodString;
+                costBps: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        summary: z.ZodString;
+        rejected: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        index: z.ZodNumber;
+        correlationId: z.ZodString;
+        status: z.ZodString;
+        failureCode: z.ZodNullable<z.ZodString>;
+        historySource: z.ZodLiteral<"journal">;
+        history: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            idempotencyKey: z.ZodString;
+            type: z.ZodEnum<{
+                refusal: "refusal";
+                request: "request";
+                status: "status";
+                "submission-claim": "submission-claim";
+            }>;
+            method: z.ZodOptional<z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>>;
+            planId: z.ZodOptional<z.ZodString>;
+            correlationId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        untimedHistory: z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            idempotencyKey: z.ZodString;
+            type: z.ZodEnum<{
+                refusal: "refusal";
+                request: "request";
+                status: "status";
+                "submission-claim": "submission-claim";
+            }>;
+            method: z.ZodOptional<z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>>;
+            planId: z.ZodOptional<z.ZodString>;
+            correlationId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        stage: z.ZodLiteral<"send">;
+    }, z.core.$strict>, z.ZodObject<{
+        stage: z.ZodLiteral<"after">;
+        observation: z.ZodUnion<readonly [z.ZodObject<{
+            error: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            at: z.ZodISODateTime;
+            book: z.ZodArray<z.ZodObject<{
+                asset: z.ZodString;
+                public: z.ZodString;
+                confidential: z.ZodString;
+                usd: z.ZodNumber;
+            }, z.core.$strip>>;
+            weightsBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            targetBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            driftBps: z.ZodNumber;
+            budget: z.ZodNullable<z.ZodObject<{
+                daily: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                weekly: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                monthly: z.ZodObject<{
+                    limit_usd: z.ZodNullable<z.ZodString>;
+                    remaining_usd: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            unresolved: z.ZodNumber;
+        }, z.core.$strip>]>;
+    }, z.core.$strict>], "stage">;
+}, z.core.$strict>, z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>;
+    type: z.ZodLiteral<"RUN_FINISHED">;
+    threadId: z.ZodString;
+    runId: z.ZodString;
+    result: z.ZodObject<{
+        outcome: z.ZodString;
+        refusal: z.ZodNullable<z.ZodString>;
+        rejected: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"RUN_ERROR">;
+    message: z.ZodString;
+    code: z.ZodEnum<{
+        progress_incomplete: "progress_incomplete";
+        tick_failed: "tick_failed";
+    }>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodObject<{
+        eventId: z.ZodString;
+        source: z.ZodLiteral<"tick">;
+        recordRef: z.ZodString;
+        recordedAt: z.ZodNullable<z.ZodISODateTime>;
+        observedAt: z.ZodNullable<z.ZodISODateTime>;
+        timing: z.ZodEnum<{
+            observed: "observed";
+            recorded: "recorded";
+            unknown: "unknown";
+        }>;
+        tickResult: z.ZodObject<{
+            outcome: z.ZodString;
+            refusal: z.ZodNullable<z.ZodString>;
+            rejected: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "type">;
+export type RunLogEvent = z.infer<typeof EventSchema>;
+export declare const RecordingSchema: z.ZodObject<{
+    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    aguiVersion: z.ZodEnum<{
+        "1.0.2": "1.0.2";
+        "1.0.3": "1.0.3";
+    }>;
+    agentId: z.ZodString;
+    tickId: z.ZodString;
+    exportedAt: z.ZodISODateTime;
+    completion: z.ZodEnum<{
+        "no-recorded-end": "no-recorded-end";
+        "recorded-end": "recorded-end";
+    }>;
+    context: z.ZodObject<{
+        progressVersion: z.ZodOptional<z.ZodLiteral<1>>;
+        id: z.ZodString;
+        agentId: z.ZodString;
+        at: z.ZodISODateTime;
+        trigger: z.ZodEnum<{
+            operator: "operator";
+            schedule: "schedule";
+        }>;
+        schedule: z.ZodObject<{
+            on: z.ZodBoolean;
+            everyMin: z.ZodNumber;
+            maxUsd: z.ZodNumber;
+            lastRun: z.ZodNullable<z.ZodISODateTime>;
+        }, z.core.$strip>;
+        build: z.ZodObject<{
+            deployment: z.ZodNullable<z.ZodString>;
+            source: z.ZodString;
+            lockfile: z.ZodNullable<z.ZodString>;
+            packageJson: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        policy: z.ZodObject<{
+            revision: z.ZodNullable<z.ZodNumber>;
+            digest: z.ZodNullable<z.ZodString>;
+            status: z.ZodString;
+        }, z.core.$strip>;
+        strategy: z.ZodString;
+        grant: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    display: z.ZodObject<{
+        asOf: z.ZodISODateTime;
+        assets: z.ZodArray<z.ZodObject<{
+            asset: z.ZodString;
+            symbol: z.ZodString;
+            decimals: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    gaps: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>;
+        type: z.ZodLiteral<"STEP_STARTED">;
+        stepName: z.ZodEnum<{
+            "balances-after": "balances-after";
+            "balances-before": "balances-before";
+            execution: "execution";
+            planning: "planning";
+            recovery: "recovery";
+            sweep: "sweep";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>;
+        type: z.ZodLiteral<"STEP_FINISHED">;
+        stepName: z.ZodEnum<{
+            "balances-after": "balances-after";
+            "balances-before": "balances-before";
+            execution: "execution";
+            planning: "planning";
+            recovery: "recovery";
+            sweep: "sweep";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>;
+        type: z.ZodLiteral<"RUN_STARTED">;
+        threadId: z.ZodString;
+        runId: z.ZodString;
+        protocolVersion: z.ZodOptional<z.ZodLiteral<"1.0">>;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>;
+        type: z.ZodLiteral<"CUSTOM">;
+        name: z.ZodLiteral<"treasury.observation">;
+        value: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            stage: z.ZodLiteral<"submission">;
+            method: z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>;
+            correlationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            stage: z.ZodLiteral<"before">;
+            observation: z.ZodUnion<readonly [z.ZodObject<{
+                error: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                at: z.ZodISODateTime;
+                book: z.ZodArray<z.ZodObject<{
+                    asset: z.ZodString;
+                    public: z.ZodString;
+                    confidential: z.ZodString;
+                    usd: z.ZodNumber;
+                }, z.core.$strip>>;
+                weightsBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                targetBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                driftBps: z.ZodNumber;
+                budget: z.ZodNullable<z.ZodObject<{
+                    daily: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    weekly: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    monthly: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                unresolved: z.ZodNumber;
+            }, z.core.$strip>]>;
+        }, z.core.$strict>, z.ZodObject<{
+            index: z.ZodNumber;
+            correlationId: z.ZodString;
+            status: z.ZodString;
+            failureCode: z.ZodNullable<z.ZodString>;
+            historySource: z.ZodLiteral<"journal">;
+            history: z.ZodArray<z.ZodObject<{
+                line: z.ZodNumber;
+                recordedAt: z.ZodNullable<z.ZodISODateTime>;
+                idempotencyKey: z.ZodString;
+                type: z.ZodEnum<{
+                    refusal: "refusal";
+                    request: "request";
+                    status: "status";
+                    "submission-claim": "submission-claim";
+                }>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    shield: "shield";
+                    swap: "swap";
+                    transfer: "transfer";
+                    unshield: "unshield";
+                }>>;
+                planId: z.ZodOptional<z.ZodString>;
+                correlationId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            untimedHistory: z.ZodArray<z.ZodObject<{
+                line: z.ZodNumber;
+                recordedAt: z.ZodNullable<z.ZodISODateTime>;
+                idempotencyKey: z.ZodString;
+                type: z.ZodEnum<{
+                    refusal: "refusal";
+                    request: "request";
+                    status: "status";
+                    "submission-claim": "submission-claim";
+                }>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    shield: "shield";
+                    swap: "swap";
+                    transfer: "transfer";
+                    unshield: "unshield";
+                }>>;
+                planId: z.ZodOptional<z.ZodString>;
+                correlationId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            stage: z.ZodLiteral<"shield">;
+            asset: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            stage: z.ZodLiteral<"plan">;
+            plan: z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                usd: z.ZodNumber;
+                legs: z.ZodArray<z.ZodObject<{
+                    from: z.ZodString;
+                    to: z.ZodString;
+                    amount: z.ZodString;
+                    amountOut: z.ZodString;
+                    minAmountOut: z.ZodString;
+                    costBps: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            summary: z.ZodString;
+            rejected: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            index: z.ZodNumber;
+            correlationId: z.ZodString;
+            status: z.ZodString;
+            failureCode: z.ZodNullable<z.ZodString>;
+            historySource: z.ZodLiteral<"journal">;
+            history: z.ZodArray<z.ZodObject<{
+                line: z.ZodNumber;
+                recordedAt: z.ZodNullable<z.ZodISODateTime>;
+                idempotencyKey: z.ZodString;
+                type: z.ZodEnum<{
+                    refusal: "refusal";
+                    request: "request";
+                    status: "status";
+                    "submission-claim": "submission-claim";
+                }>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    shield: "shield";
+                    swap: "swap";
+                    transfer: "transfer";
+                    unshield: "unshield";
+                }>>;
+                planId: z.ZodOptional<z.ZodString>;
+                correlationId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            untimedHistory: z.ZodArray<z.ZodObject<{
+                line: z.ZodNumber;
+                recordedAt: z.ZodNullable<z.ZodISODateTime>;
+                idempotencyKey: z.ZodString;
+                type: z.ZodEnum<{
+                    refusal: "refusal";
+                    request: "request";
+                    status: "status";
+                    "submission-claim": "submission-claim";
+                }>;
+                method: z.ZodOptional<z.ZodEnum<{
+                    shield: "shield";
+                    swap: "swap";
+                    transfer: "transfer";
+                    unshield: "unshield";
+                }>>;
+                planId: z.ZodOptional<z.ZodString>;
+                correlationId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodString>;
+                refusal: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            stage: z.ZodLiteral<"send">;
+        }, z.core.$strict>, z.ZodObject<{
+            stage: z.ZodLiteral<"after">;
+            observation: z.ZodUnion<readonly [z.ZodObject<{
+                error: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                at: z.ZodISODateTime;
+                book: z.ZodArray<z.ZodObject<{
+                    asset: z.ZodString;
+                    public: z.ZodString;
+                    confidential: z.ZodString;
+                    usd: z.ZodNumber;
+                }, z.core.$strip>>;
+                weightsBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                targetBps: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                driftBps: z.ZodNumber;
+                budget: z.ZodNullable<z.ZodObject<{
+                    daily: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    weekly: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                    monthly: z.ZodObject<{
+                        limit_usd: z.ZodNullable<z.ZodString>;
+                        remaining_usd: z.ZodNullable<z.ZodString>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                unresolved: z.ZodNumber;
+            }, z.core.$strip>]>;
+        }, z.core.$strict>], "stage">;
+    }, z.core.$strict>, z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>;
+        type: z.ZodLiteral<"RUN_FINISHED">;
+        threadId: z.ZodString;
+        runId: z.ZodString;
+        result: z.ZodObject<{
+            outcome: z.ZodString;
+            refusal: z.ZodNullable<z.ZodString>;
+            rejected: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"RUN_ERROR">;
+        message: z.ZodString;
+        code: z.ZodEnum<{
+            progress_incomplete: "progress_incomplete";
+            tick_failed: "tick_failed";
+        }>;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodObject<{
+            eventId: z.ZodString;
+            source: z.ZodLiteral<"tick">;
+            recordRef: z.ZodString;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            observedAt: z.ZodNullable<z.ZodISODateTime>;
+            timing: z.ZodEnum<{
+                observed: "observed";
+                recorded: "recorded";
+                unknown: "unknown";
+            }>;
+            tickResult: z.ZodObject<{
+                outcome: z.ZodString;
+                refusal: z.ZodNullable<z.ZodString>;
+                rejected: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "type">>;
+    laterObservations: z.ZodArray<z.ZodObject<{
+        correlationId: z.ZodString;
+        source: z.ZodLiteral<"journal">;
+        record: z.ZodObject<{
+            line: z.ZodNumber;
+            recordedAt: z.ZodNullable<z.ZodISODateTime>;
+            idempotencyKey: z.ZodString;
+            type: z.ZodEnum<{
+                refusal: "refusal";
+                request: "request";
+                status: "status";
+                "submission-claim": "submission-claim";
+            }>;
+            method: z.ZodOptional<z.ZodEnum<{
+                shield: "shield";
+                swap: "swap";
+                transfer: "transfer";
+                unshield: "unshield";
+            }>>;
+            planId: z.ZodOptional<z.ZodString>;
+            correlationId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodString>;
+            refusal: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Recording = z.infer<typeof RecordingSchema>;
+export {};