@claudexor/schema 3.20.1 → 3.23.0

package/dist/run-continuity.d.ts

@@ -0,0 +1,215 @@
+import { z } from "zod/v3";
+/**
+ * Run continuation contract ("continue from the break point"): the serializable
+ * DATA shapes shared by the in-run continuation ladder, the `continueFrom` run
+ * chain and the thread store's projection. Split out of `harness.ts` for the
+ * reason the complexity ratchet exists (INV-124); re-exported through
+ * `index.ts`, so every consumer imports it from `@claudexor/schema`.
+ *
+ * Vocabulary: a CARRIER is how done work reaches the next vendor process; a
+ * CAUSE is the typed reason the previous process stopped (copied from the
+ * terminal, never inferred from prose); a CAPSULE is the durable per-attempt
+ * record of the native vendor session and the concrete file that holds it.
+ */
+/** Why the previous process stopped. Typed terminal facts only (INV-049). */
+export declare const ResumableCause: z.ZodEnum<["vendor_limit", "pool_exhausted", "pinned_limit", "transport", "context_exhausted", "wall_clock", "cancelled", "host_restart", "input_required", "other"]>;
+export type ResumableCause = z.infer<typeof ResumableCause>;
+/** How done work reaches the next vendor process. */
+export declare const ContinuityCarrier: z.ZodEnum<["native", "native_moved", "packet", "fresh"]>;
+export type ContinuityCarrier = z.infer<typeof ContinuityCarrier>;
+/** The carriers a stopped run can still be continued with (never `fresh`). */
+export declare const ResumableCarrier: z.ZodEnum<["native", "native_moved", "packet"]>;
+export type ResumableCarrier = z.infer<typeof ResumableCarrier>;
+/** Quality of the typed vendor-limit evidence that ended the work. */
+export declare const LimitEvidence: z.ZodEnum<["window", "unspecified"]>;
+export type LimitEvidence = z.infer<typeof LimitEvidence>;
+export declare const ContinuityIdentityCheck: z.ZodEnum<["matched_before_effects", "mismatch_before_effects", "mismatch_after_possible_effects", "not_applicable"]>;
+export type ContinuityIdentityCheck = z.infer<typeof ContinuityIdentityCheck>;
+export declare const ContinuityInputDelivery: z.ZodEnum<["confirmed", "uncertain", "not_applicable"]>;
+export type ContinuityInputDelivery = z.infer<typeof ContinuityInputDelivery>;
+/**
+ * ONE durable record per attempt of the native vendor session: written by the
+ * orchestrator when `started` reports a native session id (every try, every
+ * envelope kind, standalone runs included), re-located after the try settles
+ * (the history file can be written after `started`). The holder is the
+ * concrete file `locate` found — a session has one holder at a time; a move
+ * copies it into the next account's store and retires the source.
+ */
+export declare const SessionCapsule: z.ZodObject<{
+    harness: z.ZodString;
+    nativeSessionId: z.ZodString;
+    holderProfileId: z.ZodNullable<z.ZodString>;
+    file: z.ZodNullable<z.ZodString>;
+    mtimeMs: z.ZodNullable<z.ZodNumber>;
+    sidecars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    cwd: z.ZodString;
+    requestedModel: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    harness: string;
+    nativeSessionId: string;
+    holderProfileId: string | null;
+    file: string | null;
+    mtimeMs: number | null;
+    sidecars: string[];
+    cwd: string;
+    requestedModel: string | null;
+}, {
+    harness: string;
+    nativeSessionId: string;
+    holderProfileId: string | null;
+    file: string | null;
+    mtimeMs: number | null;
+    sidecars?: string[] | undefined;
+    cwd: string;
+    requestedModel: string | null;
+}>;
+export type SessionCapsule = z.infer<typeof SessionCapsule>;
+/**
+ * Terminal block of a run whose WORK is unfinished and can be continued:
+ * present on non-success lifecycles and on `succeeded` runs whose work state
+ * is `needs_input`/`incomplete`. Decided by the work outcome, never by the
+ * lifecycle word alone. `resetsAt` comes only from a vendor window signal.
+ */
+export declare const RunResumable: z.ZodObject<{
+    cause: z.ZodEnum<["vendor_limit", "pool_exhausted", "pinned_limit", "transport", "context_exhausted", "wall_clock", "cancelled", "host_restart", "input_required", "other"]>;
+    resetsAt: z.ZodNullable<z.ZodString>;
+    limitWindow: z.ZodNullable<z.ZodString>;
+    limitEvidence: z.ZodNullable<z.ZodEnum<["window", "unspecified"]>>;
+    carriers: z.ZodArray<z.ZodEnum<["native", "native_moved", "packet"]>, "many">;
+    limitCode: z.ZodNullable<z.ZodString>;
+    session: z.ZodNullable<z.ZodObject<{
+        harness: z.ZodString;
+        nativeSessionId: z.ZodString;
+        holderProfileId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        harness: string;
+        nativeSessionId: string;
+        holderProfileId: string | null;
+    }, {
+        harness: string;
+        nativeSessionId: string;
+        holderProfileId: string | null;
+    }>>;
+    workspace: z.ZodObject<{
+        kind: z.ZodEnum<["in_place", "retained_envelope", "none"]>;
+        root: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "in_place" | "none" | "retained_envelope";
+        root: string | null;
+    }, {
+        kind: "in_place" | "none" | "retained_envelope";
+        root: string | null;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    cause: "cancelled" | "context_exhausted" | "host_restart" | "input_required" | "other" | "pinned_limit" | "pool_exhausted" | "transport" | "vendor_limit" | "wall_clock";
+    resetsAt: string | null;
+    limitWindow: string | null;
+    limitEvidence: "unspecified" | "window" | null;
+    carriers: ("native" | "native_moved" | "packet")[];
+    limitCode: string | null;
+    session: {
+        harness: string;
+        nativeSessionId: string;
+        holderProfileId: string | null;
+    } | null;
+    workspace: {
+        kind: "in_place" | "none" | "retained_envelope";
+        root: string | null;
+    };
+}, {
+    cause: "cancelled" | "context_exhausted" | "host_restart" | "input_required" | "other" | "pinned_limit" | "pool_exhausted" | "transport" | "vendor_limit" | "wall_clock";
+    resetsAt: string | null;
+    limitWindow: string | null;
+    limitEvidence: "unspecified" | "window" | null;
+    carriers: ("native" | "native_moved" | "packet")[];
+    limitCode: string | null;
+    session: {
+        harness: string;
+        nativeSessionId: string;
+        holderProfileId: string | null;
+    } | null;
+    workspace: {
+        kind: "in_place" | "none" | "retained_envelope";
+        root: string | null;
+    };
+}>;
+export type RunResumable = z.infer<typeof RunResumable>;
+/** Per-try receipt of a continued try (event `run.continuity`). */
+export declare const RunContinuityReceipt: z.ZodObject<{
+    tryIndex: z.ZodNumber;
+    attemptId: z.ZodString;
+    carrier: z.ZodEnum<["native", "native_moved", "packet", "fresh"]>;
+    cause: z.ZodEnum<["vendor_limit", "pool_exhausted", "pinned_limit", "transport", "context_exhausted", "wall_clock", "cancelled", "host_restart", "input_required", "other"]>;
+    from: z.ZodObject<{
+        runId: z.ZodString;
+        attemptId: z.ZodString;
+        profileId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        attemptId: string;
+        profileId: string | null;
+    }, {
+        runId: string;
+        attemptId: string;
+        profileId: string | null;
+    }>;
+    to: z.ZodObject<{
+        profileId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        profileId: string | null;
+    }, {
+        profileId: string | null;
+    }>;
+    workspace: z.ZodEnum<["same_root", "different_root"]>;
+    memory: z.ZodEnum<["full", "partial", "unknown"]>;
+    instructions: z.ZodEnum<["as_sent", "vendor_snapshot"]>;
+    reingestedTokens: z.ZodNullable<z.ZodNumber>;
+    observedModel: z.ZodNullable<z.ZodString>;
+    modelMismatch: z.ZodNullable<z.ZodBoolean>;
+    identityCheck: z.ZodEnum<["matched_before_effects", "mismatch_before_effects", "mismatch_after_possible_effects", "not_applicable"]>;
+    inputDelivery: z.ZodEnum<["confirmed", "uncertain", "not_applicable"]>;
+}, "strict", z.ZodTypeAny, {
+    tryIndex: number;
+    attemptId: string;
+    carrier: "fresh" | "native" | "native_moved" | "packet";
+    cause: "cancelled" | "context_exhausted" | "host_restart" | "input_required" | "other" | "pinned_limit" | "pool_exhausted" | "transport" | "vendor_limit" | "wall_clock";
+    from: {
+        runId: string;
+        attemptId: string;
+        profileId: string | null;
+    };
+    to: {
+        profileId: string | null;
+    };
+    workspace: "different_root" | "same_root";
+    memory: "full" | "partial" | "unknown";
+    instructions: "as_sent" | "vendor_snapshot";
+    reingestedTokens: number | null;
+    observedModel: string | null;
+    modelMismatch: boolean | null;
+    identityCheck: "matched_before_effects" | "mismatch_after_possible_effects" | "mismatch_before_effects" | "not_applicable";
+    inputDelivery: "confirmed" | "not_applicable" | "uncertain";
+}, {
+    tryIndex: number;
+    attemptId: string;
+    carrier: "fresh" | "native" | "native_moved" | "packet";
+    cause: "cancelled" | "context_exhausted" | "host_restart" | "input_required" | "other" | "pinned_limit" | "pool_exhausted" | "transport" | "vendor_limit" | "wall_clock";
+    from: {
+        runId: string;
+        attemptId: string;
+        profileId: string | null;
+    };
+    to: {
+        profileId: string | null;
+    };
+    workspace: "different_root" | "same_root";
+    memory: "full" | "partial" | "unknown";
+    instructions: "as_sent" | "vendor_snapshot";
+    reingestedTokens: number | null;
+    observedModel: string | null;
+    modelMismatch: boolean | null;
+    identityCheck: "matched_before_effects" | "mismatch_after_possible_effects" | "mismatch_before_effects" | "not_applicable";
+    inputDelivery: "confirmed" | "not_applicable" | "uncertain";
+}>;
+export type RunContinuityReceipt = z.infer<typeof RunContinuityReceipt>;
+//# sourceMappingURL=run-continuity.d.ts.map

package/dist/run-continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-continuity.d.ts","sourceRoot":"","sources":["../src/run-continuity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;;;;;;;;GAWG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,cAAc,uKAexB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,0DAI3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,iDAEgD,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,sEAAsE;AACtE,eAAO,MAAM,aAAa,sCAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,uBAAuB,uHASjC,CAAC;AACJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB,yDAIjC,CAAC;AACJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BgE,CAAC;AAC5F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CtB,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,mEAAmE;AACnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CgE,CAAC;AAClG,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/run-continuity.js

@@ -0,0 +1,170 @@
+import { z } from "zod/v3";
+import { Id } from "./primitives.js";
+/**
+ * Run continuation contract ("continue from the break point"): the serializable
+ * DATA shapes shared by the in-run continuation ladder, the `continueFrom` run
+ * chain and the thread store's projection. Split out of `harness.ts` for the
+ * reason the complexity ratchet exists (INV-124); re-exported through
+ * `index.ts`, so every consumer imports it from `@claudexor/schema`.
+ *
+ * Vocabulary: a CARRIER is how done work reaches the next vendor process; a
+ * CAUSE is the typed reason the previous process stopped (copied from the
+ * terminal, never inferred from prose); a CAPSULE is the durable per-attempt
+ * record of the native vendor session and the concrete file that holds it.
+ */
+/** Why the previous process stopped. Typed terminal facts only (INV-049). */
+export const ResumableCause = z
+    .enum([
+    "vendor_limit",
+    "pool_exhausted",
+    "pinned_limit",
+    "transport",
+    "context_exhausted",
+    "wall_clock",
+    "cancelled",
+    "host_restart",
+    "input_required",
+    "other",
+])
+    .describe("Typed reason the previous process stopped: a vendor limit (next account eligible), the whole pool spent, a pinned account's limit, a transport death (crash, timeout, watchdog), context exhaustion, the wall-clock deadline, a cancel, a daemon/host restart, a model that asked for input, or another typed cause.");
+/** How done work reaches the next vendor process. */
+export const ContinuityCarrier = z
+    .enum(["native", "native_moved", "packet", "fresh"])
+    .describe("Carrier of a continued try: native (the vendor's own session, same account), native_moved (the session file made visible in the next account's store, then resumed there), packet (a fresh session re-grounded by an evidence index), or fresh (nothing to carry — a replay of the original prompt).");
+/** The carriers a stopped run can still be continued with (never `fresh`). */
+export const ResumableCarrier = z
+    .enum(["native", "native_moved", "packet"])
+    .describe("A continuity representation still available for a stopped run.");
+/** Quality of the typed vendor-limit evidence that ended the work. */
+export const LimitEvidence = z
+    .enum(["window", "unspecified"])
+    .describe("window: the vendor named the spent window (a reset instant or a constraint id); unspecified: a typed limit without a window — a bare backoff frame is transport, not a limit.");
+export const ContinuityIdentityCheck = z
+    .enum([
+    "matched_before_effects",
+    "mismatch_before_effects",
+    "mismatch_after_possible_effects",
+    "not_applicable",
+])
+    .describe("Whether the resumed vendor session was the one requested, judged at the earliest handshake (codex thread/resume before turn/start; claude system/init): matched, mismatch caught before the child could act, mismatch caught after it may have acted, or not applicable (no resume was requested, or a harness without the continuity capability answered with another session id, which is recorded as before).");
+export const ContinuityInputDelivery = z
+    .enum(["confirmed", "uncertain", "not_applicable"])
+    .describe("Whether the predecessor's last input (its turn prompt or an admitted steering message) is known to be in the vendor history: confirmed, uncertain (carried in the notice as a reference to reconcile, never replayed blindly), or not applicable.");
+/**
+ * ONE durable record per attempt of the native vendor session: written by the
+ * orchestrator when `started` reports a native session id (every try, every
+ * envelope kind, standalone runs included), re-located after the try settles
+ * (the history file can be written after `started`). The holder is the
+ * concrete file `locate` found — a session has one holder at a time; a move
+ * copies it into the next account's store and retires the source.
+ */
+export const SessionCapsule = z
+    .object({
+    harness: Id.describe("Harness that owns the session."),
+    nativeSessionId: z.string().min(1).describe("The vendor's own session/thread id."),
+    holderProfileId: Id.nullable().describe("Credential profile whose store currently holds the session; null = the harness default store."),
+    file: z
+        .string()
+        .nullable()
+        .describe("Absolute path of the located history file (the holder); null until located."),
+    mtimeMs: z
+        .number()
+        .nullable()
+        .describe("Modification time of the located file (newest wins on a tie); null until located."),
+    sidecars: z
+        .array(z.string())
+        .default([])
+        .describe("Absolute paths of sibling state a move must carry (claude `<sid>/` tool-results and subagents; codex rollout parts)."),
+    cwd: z.string().describe("Working directory the session was created under."),
+    requestedModel: z
+        .string()
+        .nullable()
+        .describe("The model the spec requested; null = the harness default."),
+})
+    .strict()
+    .describe("Durable per-attempt record of the native vendor session and its holder file.");
+/**
+ * Terminal block of a run whose WORK is unfinished and can be continued:
+ * present on non-success lifecycles and on `succeeded` runs whose work state
+ * is `needs_input`/`incomplete`. Decided by the work outcome, never by the
+ * lifecycle word alone. `resetsAt` comes only from a vendor window signal.
+ */
+export const RunResumable = z
+    .object({
+    cause: ResumableCause,
+    resetsAt: z
+        .string()
+        .nullable()
+        .describe("When the spent vendor window reopens, only from a vendor signal; never fabricated."),
+    limitWindow: z
+        .string()
+        .nullable()
+        .describe("The vendor's own name for the spent window (e.g. five_hour, seven_day_opus), when known."),
+    limitEvidence: LimitEvidence.nullable(),
+    carriers: z
+        .array(ResumableCarrier)
+        .describe("Continuity representations still available (NOT quota readiness; readiness is described by the limit facts)."),
+    limitCode: z
+        .string()
+        .nullable()
+        .describe("The typed vendor limit code that ended the work, when any."),
+    session: z
+        .object({
+        harness: Id,
+        nativeSessionId: z.string().min(1),
+        holderProfileId: Id.nullable(),
+    })
+        .nullable()
+        .describe("The native session a continuation can resume, when one exists."),
+    workspace: z
+        .object({
+        kind: z.enum(["in_place", "retained_envelope", "none"]),
+        root: z.string().nullable(),
+    })
+        .describe("Where the stopped work's tree is: the live root, a retained envelope, or gone."),
+})
+    .strict()
+    .describe("Terminal facts of a stopped run that can be continued: cause, limit evidence, available carriers, the native session and the workspace.");
+/** Per-try receipt of a continued try (event `run.continuity`). */
+export const RunContinuityReceipt = z
+    .object({
+    tryIndex: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("Native try within the attempt; joins the receipt to its try."),
+    attemptId: Id,
+    carrier: ContinuityCarrier,
+    cause: ResumableCause,
+    from: z.object({
+        runId: Id,
+        attemptId: Id,
+        profileId: Id.nullable(),
+    }),
+    to: z.object({ profileId: Id.nullable() }),
+    workspace: z
+        .enum(["same_root", "different_root"])
+        .describe("Whether the continued try runs in the predecessor's execution root."),
+    memory: z
+        .enum(["full", "partial", "unknown"])
+        .describe("Its own fact: a native resume carries the whole history (full); a packet re-brief is partial; a native resume that lost history (e.g. a rejected compacted item) is partial/unknown."),
+    instructions: z
+        .enum(["as_sent", "vendor_snapshot"])
+        .describe("as_sent: the successor's instructions equal the predecessor's; vendor_snapshot: they differ, and the vendor may resend its recorded system prompt instead (claude records it on the first request)."),
+    reingestedTokens: z
+        .number()
+        .int()
+        .nonnegative()
+        .nullable()
+        .describe("Input + cache-creation tokens of the first resumed request, when known."),
+    observedModel: z
+        .string()
+        .nullable()
+        .describe("THIS try's attested model (never borrowed from another try)."),
+    modelMismatch: z.boolean().nullable(),
+    identityCheck: ContinuityIdentityCheck,
+    inputDelivery: ContinuityInputDelivery,
+})
+    .strict()
+    .describe("Receipt of one continued try: carrier, cause, accounts, memory, model attestation.");
+//# sourceMappingURL=run-continuity.js.map

package/dist/run-continuity.js.map

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

package/dist/run-facts.d.ts

@@ -232,6 +232,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator?: string | null | undefined;
                 description: string;
             }>, "many">>;
+            unverified_reason: z.ZodOptional<z.ZodEnum<["footer_missing", "footer_not_json", "footer_not_object", "report_missing", "report_malformed", "report_contradictory", "legacy_output_invalid"]>>;
         }, "strip", z.ZodTypeAny, {
             state: "completed" | "incomplete" | "needs_input" | "unverified";
             source: "absent" | "constrained" | "validated";
@@ -240,6 +241,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator: string | null;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         }, {
             state: "completed" | "incomplete" | "needs_input" | "unverified";
             source: "absent" | "constrained" | "validated";
@@ -248,6 +250,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator?: string | null | undefined;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         }>>;
     }, "strict", z.ZodTypeAny, {
         lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -264,6 +267,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator: string | null;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         } | undefined;
     }, {
         lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -280,6 +284,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator?: string | null | undefined;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         } | undefined;
     }>;
     deliverable: z.ZodObject<{
@@ -464,6 +469,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator: string | null;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         } | undefined;
     };
     deliverable: {
@@ -536,6 +542,7 @@ export declare const RunFacts: z.ZodObject<{
                 locator?: string | null | undefined;
                 description: string;
             }[] | undefined;
+            unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
         } | undefined;
     };
     deliverable: {

package/dist/run-facts.d.ts.map

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

package/dist/run-list-page.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod/v3";
+export interface RunListRecord {
+    id: string;
+    state: string;
+    createdAt?: string;
+}
+export declare const RunListCursor: z.ZodObject<{
+    createdAt: z.ZodString;
+    id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    createdAt: string;
+    id: string;
+}, {
+    createdAt: string;
+    id: string;
+}>;
+export type RunListCursor = z.infer<typeof RunListCursor>;
+export declare const RunListQuery: z.ZodObject<{
+    limit: z.ZodNumber;
+    state: z.ZodNullable<z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>>;
+    cursor: z.ZodNullable<z.ZodObject<{
+        createdAt: z.ZodString;
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        createdAt: string;
+        id: string;
+    }, {
+        createdAt: string;
+        id: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded" | null;
+    cursor: {
+        createdAt: string;
+        id: string;
+    } | null;
+}, {
+    limit: number;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded" | null;
+    cursor: {
+        createdAt: string;
+        id: string;
+    } | null;
+}>;
+export type RunListQuery = z.infer<typeof RunListQuery>;
+/** Newest-first deterministic order: `(createdAt desc, id desc)`. Records with
+ * no `createdAt` sort last (empty string) with `id` as the stable tiebreak, so
+ * the traversal is total and duplicate-free even across foreign record shapes. */
+export declare function orderRunRecords<T extends RunListRecord>(records: readonly T[]): T[];
+/**
+ * Index of the first record strictly after `cursor` within an already-ordered
+ * list. Comparison-based (not id-equality) so a cursor whose record was pruned
+ * between pages still resumes at the correct neighbor — no duplicate, no gap.
+ */
+export declare function indexAfterCursor(ordered: readonly RunListRecord[], cursor: RunListCursor): number;
+export declare function encodeRunCursor(rec: RunListRecord): string;
+/** Strict opaque-cursor decode: base64url alphabet only, exactly one separator,
+ * non-empty id. Anything else is a typed 400 (never a silent full-list fall
+ * back), mirroring the QA-061 run-event cursor contract. */
+export declare function decodeRunCursor(raw: string): RunListCursor;
+/**
+ * Select one bounded page from the raw daemon records: order newest-first,
+ * apply the optional `state` filter, then keyset-slice by cursor + limit. All of
+ * it happens on the raw records BEFORE any summary is materialized, so the
+ * caller only fingerprints/projects the returned page — work bounded by page
+ * size, not total retained records (QA-052).
+ */
+export declare function selectRunListPage<T extends RunListRecord>(records: readonly T[], query: RunListQuery): {
+    page: T[];
+    hasMore: boolean;
+    nextCursor: string | null;
+};
+//# sourceMappingURL=run-list-page.d.ts.map

package/dist/run-list-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-list-page.d.ts","sourceRoot":"","sources":["../src/run-list-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,eAAO,MAAM,aAAa;;;;;;;;;EAAsE,CAAC;AACjG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMd,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAcxD;;kFAEkF;AAClF,wBAAgB,eAAe,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAQnF;AAUD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAIjG;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED;;4DAE4D;AAC5D,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAiB1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,EACvD,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,KAAK,EAAE,YAAY,GAClB;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAQ5D"}

package/dist/run-list-page.js

@@ -0,0 +1,85 @@
+import { z } from "zod/v3";
+import { ControlRunState } from "./control.js";
+export const RunListCursor = z.object({ createdAt: z.string(), id: z.string().min(1) }).strict();
+export const RunListQuery = z
+    .object({
+    limit: z.number().int().min(1).max(1000),
+    state: ControlRunState.nullable(),
+    cursor: RunListCursor.nullable(),
+})
+    .strict();
+function invalidRunListQuery(message, code) {
+    return Object.assign(new Error(message), {
+        status: 400,
+        code,
+        requiredActions: code === "invalid_run_list_cursor" ? ["resnapshot"] : ["retry_with_valid_query"],
+    });
+}
+/** Newest-first deterministic order: `(createdAt desc, id desc)`. Records with
+ * no `createdAt` sort last (empty string) with `id` as the stable tiebreak, so
+ * the traversal is total and duplicate-free even across foreign record shapes. */
+export function orderRunRecords(records) {
+    return [...records].sort((a, b) => {
+        const ac = a.createdAt ?? "";
+        const bc = b.createdAt ?? "";
+        if (ac !== bc)
+            return ac < bc ? 1 : -1;
+        if (a.id !== b.id)
+            return a.id < b.id ? 1 : -1;
+        return 0;
+    });
+}
+/** True when `rec` sorts strictly AFTER the cursor key in newest-first order
+ * (i.e. is older, or same instant with a smaller id). */
+function recordSortsAfterCursor(rec, cursor) {
+    const rc = rec.createdAt ?? "";
+    if (rc !== cursor.createdAt)
+        return rc < cursor.createdAt;
+    return rec.id < cursor.id;
+}
+/**
+ * Index of the first record strictly after `cursor` within an already-ordered
+ * list. Comparison-based (not id-equality) so a cursor whose record was pruned
+ * between pages still resumes at the correct neighbor — no duplicate, no gap.
+ */
+export function indexAfterCursor(ordered, cursor) {
+    let i = 0;
+    while (i < ordered.length && !recordSortsAfterCursor(ordered[i], cursor))
+        i++;
+    return i;
+}
+export function encodeRunCursor(rec) {
+    return Buffer.from(`${rec.createdAt ?? ""}\0${rec.id}`, "utf8").toString("base64url");
+}
+/** Strict opaque-cursor decode: base64url alphabet only, exactly one separator,
+ * non-empty id. Anything else is a typed 400 (never a silent full-list fall
+ * back), mirroring the QA-061 run-event cursor contract. */
+export function decodeRunCursor(raw) {
+    if (!/^[A-Za-z0-9_-]+$/.test(raw)) {
+        throw invalidRunListQuery("cursor is malformed; refetch the run list and resume from its nextCursor", "invalid_run_list_cursor");
+    }
+    const decoded = Buffer.from(raw, "base64url").toString("utf8");
+    const sep = decoded.indexOf("\0");
+    const id = sep < 0 ? "" : decoded.slice(sep + 1);
+    if (sep < 0 || id.length === 0 || id.includes("\0")) {
+        throw invalidRunListQuery("cursor is malformed; refetch the run list and resume from its nextCursor", "invalid_run_list_cursor");
+    }
+    return { createdAt: decoded.slice(0, sep), id };
+}
+/**
+ * Select one bounded page from the raw daemon records: order newest-first,
+ * apply the optional `state` filter, then keyset-slice by cursor + limit. All of
+ * it happens on the raw records BEFORE any summary is materialized, so the
+ * caller only fingerprints/projects the returned page — work bounded by page
+ * size, not total retained records (QA-052).
+ */
+export function selectRunListPage(records, query) {
+    const ordered = orderRunRecords(records);
+    const filtered = query.state ? ordered.filter((r) => r.state === query.state) : ordered;
+    const start = query.cursor ? indexAfterCursor(filtered, query.cursor) : 0;
+    const page = filtered.slice(start, start + query.limit);
+    const hasMore = start + page.length < filtered.length;
+    const tail = page[page.length - 1];
+    return { page, hasMore, nextCursor: hasMore && tail ? encodeRunCursor(tail) : null };
+}
+//# sourceMappingURL=run-list-page.js.map

package/dist/run-list-page.js.map

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