@tai42/api-client 20.0.0 → 22.0.0

package/dist/schemas/states.d.ts

@@ -2,17 +2,24 @@
 import { z } from 'zod';
 /** One addressed subject: the conversation-target scope plus the (kind, key) within it. */
 export declare const stateSubject: z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodString;
     target_kind: z.ZodEnum<{
         tool: "tool";
         agent: "agent";
     }>;
     target_name: z.ZodString;
-    kind: z.ZodString;
-    key: z.ZodString;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type StateSubject = z.infer<typeof stateSubject>;
-/** One absolute write-regime rule composed over the attachments: `{path, regime}`, permissive. */
-export declare const stateRegime: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** One absolute write-regime rule composed over the attachments: `{path, regime}`. */
+export declare const stateRegime: z.ZodObject<{
+    path: z.ZodArray<z.ZodString>;
+    regime: z.ZodEnum<{
+        single: "single";
+        composing: "composing";
+        free: "free";
+    }>;
+}, z.core.$strict>;
 /**
  * One row of `GET /api/states` — a served declaration (`list_states` dumps every
  * `StateDeclaration`) plus `updated_at` (the row's last-write timestamp, ISO or
@@ -22,10 +29,17 @@ export declare const stateRegime: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export declare const stateListItem: z.ZodObject<{
     default_subject_kind: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
-    effective_schema: z.ZodDefault<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>>;
+    effective_schema: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     name: z.ZodString;
-    regimes: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodNull]>>;
-    retention_days: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    regimes: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>>;
+    retention_days: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
@@ -38,10 +52,17 @@ export type StateListItem = z.infer<typeof stateListItem>;
 export declare const stateList: z.ZodArray<z.ZodObject<{
     default_subject_kind: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
-    effective_schema: z.ZodDefault<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>>;
+    effective_schema: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     name: z.ZodString;
-    regimes: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodNull]>>;
-    retention_days: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    regimes: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>>;
+    retention_days: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
@@ -50,43 +71,111 @@ export declare const stateList: z.ZodArray<z.ZodObject<{
     subject_kinds: z.ZodArray<z.ZodString>;
     updated_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>>;
+/**
+ * One save held by a failed pending save: `save_id` names it, `held_by` the failed save holding it
+ * (equal to `save_id` for the failed save itself), `subjects` the subjects it writes. A scan or
+ * a re-declare that read past it names it in its `held` list.
+ */
+export declare const heldPendingSave: z.ZodObject<{
+    held_by: z.ZodString;
+    save_id: z.ZodString;
+    subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodString;
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type HeldPendingSave = z.infer<typeof heldPendingSave>;
 /** One template attachment on a state: where the fragment lands + its param/declaration values. */
 export declare const stateAttachment: z.ZodObject<{
-    template: z.ZodString;
+    declarations: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     path: z.ZodArray<z.ZodString>;
-    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    declarations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    template: z.ZodString;
 }, z.core.$strip>;
 export type StateAttachment = z.infer<typeof stateAttachment>;
 export declare const stateAttachmentList: z.ZodArray<z.ZodObject<{
-    template: z.ZodString;
+    declarations: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     path: z.ZodArray<z.ZodString>;
-    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    declarations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    state: z.ZodString;
+    template: z.ZodString;
 }, z.core.$strip>>;
 /** `GET /api/states/{name}` — the declaration (with effective schema + regimes) plus attachments. */
 export declare const stateDetail: z.ZodObject<{
     default_subject_kind: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
-    effective_schema: z.ZodDefault<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>>;
+    effective_schema: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     name: z.ZodString;
-    regimes: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodNull]>>;
-    retention_days: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
+    regimes: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>>;
+    retention_days: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
     subject_kinds: z.ZodArray<z.ZodString>;
-    updated_at: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>;
-    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        template: z.ZodString;
+    updated_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    attachments: z.ZodArray<z.ZodObject<{
+        declarations: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         path: z.ZodArray<z.ZodString>;
-        parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        declarations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>>>;
+        template: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strict>;
 export type StateDetail = z.infer<typeof stateDetail>;
+/**
+ * `PUT /api/states/{name}` — a create or re-declare's answer: the stored declaration's fields
+ * plus `held`, the held pending saves an accepted re-declare names (absent when none). The
+ * answer carries no attachments; a caller that needs them reads `getState`.
+ */
+export declare const stateDeclarationSaved: z.ZodObject<{
+    default_subject_kind: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    effective_schema: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    name: z.ZodString;
+    regimes: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>>;
+    retention_days: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        content: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+        kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    subject_kinds: z.ZodArray<z.ZodString>;
+    updated_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type StateDeclarationSaved = z.infer<typeof stateDeclarationSaved>;
 /**
  * `GET /api/states/{name}/stats` — `records` (total documents), `per_field` (the count
  * of records carrying each base-schema property), `per_kind` (records per subject kind)
@@ -94,10 +183,23 @@ export type StateDetail = z.infer<typeof stateDetail>;
  * the states list reads it lazily for its Records column.
  */
 export declare const stateStats: z.ZodObject<{
+    consumers: z.ZodNumber;
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    per_field: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    per_kind: z.ZodRecord<z.ZodString, z.ZodNumber>;
     records: z.ZodNumber;
-    per_field: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    per_kind: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    consumers: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type StateStats = z.infer<typeof stateStats>;
 /**
@@ -107,19 +209,22 @@ export type StateStats = z.infer<typeof stateStats>;
  * columns; the document fields are verbatim.
  */
 export declare const stateTemplateListItem: z.ZodObject<{
-    declarations: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
-        check: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    declarations: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        check: z.ZodDefault<z.ZodNullable<z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
             kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strict>, z.ZodNull]>>;
+        }, z.core.$strict>>>;
         schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strict>, z.ZodNull]>>;
+    }, z.core.$strict>>>;
     description: z.ZodDefault<z.ZodString>;
     kind: z.ZodDefault<z.ZodLiteral<"state-template">>;
     name: z.ZodString;
-    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    reconcile: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        default: z.ZodOptional<z.ZodUnknown>;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>>;
+    reconcile: z.ZodDefault<z.ZodNullable<z.ZodObject<{
         close: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
@@ -135,14 +240,21 @@ export declare const stateTemplateListItem: z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strict>;
-    }, z.core.$strict>, z.ZodNull]>>;
-    regimes: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strict>>>;
+    regimes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>;
     schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodObject<{
+    template_jq: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodDefault<z.ZodString>;
         jq: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
@@ -156,26 +268,31 @@ export declare const stateTemplateListItem: z.ZodObject<{
         }>;
         reads: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodString>>>;
         writes: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strict>>, z.ZodNull]>>;
-    trace: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    attached_to: z.ZodDefault<z.ZodNumber>;
-    shipped_default: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>>;
+    trace: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    attached_to: z.ZodNumber;
+    shipped_default: z.ZodBoolean;
 }, z.core.$strict>;
 export type StateTemplateListItem = z.infer<typeof stateTemplateListItem>;
 export declare const stateTemplateList: z.ZodArray<z.ZodObject<{
-    declarations: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
-        check: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    declarations: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        check: z.ZodDefault<z.ZodNullable<z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
             kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strict>, z.ZodNull]>>;
+        }, z.core.$strict>>>;
         schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strict>, z.ZodNull]>>;
+    }, z.core.$strict>>>;
     description: z.ZodDefault<z.ZodString>;
     kind: z.ZodDefault<z.ZodLiteral<"state-template">>;
     name: z.ZodString;
-    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    reconcile: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        default: z.ZodOptional<z.ZodUnknown>;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>>>;
+    reconcile: z.ZodDefault<z.ZodNullable<z.ZodObject<{
         close: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
             id: z.ZodOptional<z.ZodString>;
@@ -191,14 +308,21 @@ export declare const stateTemplateList: z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strict>;
-    }, z.core.$strict>, z.ZodNull]>>;
-    regimes: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strict>>>;
+    regimes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodString>;
+        regime: z.ZodEnum<{
+            single: "single";
+            composing: "composing";
+            free: "free";
+        }>;
+    }, z.core.$strict>>>;
     schema: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         content: z.ZodOptional<z.ZodString>;
         id: z.ZodOptional<z.ZodString>;
         kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
-    template_jq: z.ZodDefault<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodObject<{
+    template_jq: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodDefault<z.ZodString>;
         jq: z.ZodObject<{
             content: z.ZodOptional<z.ZodString>;
@@ -212,44 +336,46 @@ export declare const stateTemplateList: z.ZodArray<z.ZodObject<{
         }>;
         reads: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodString>>>;
         writes: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strict>>, z.ZodNull]>>;
-    trace: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    attached_to: z.ZodDefault<z.ZodNumber>;
-    shipped_default: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>>;
+    trace: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    attached_to: z.ZodNumber;
+    shipped_default: z.ZodBoolean;
 }, z.core.$strict>>;
 /** A read record: the state, its subject, the document + monotonic seq, and any fold. */
 export declare const stateRecord: z.ZodObject<{
-    state: z.ZodString;
-    subject: z.ZodObject<{
+    canonical_subject: z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodString;
         target_kind: z.ZodEnum<{
             tool: "tool";
             agent: "agent";
         }>;
         target_name: z.ZodString;
-        kind: z.ZodString;
-        key: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    seq: z.ZodNumber;
-    canonical_subject: z.ZodObject<{
+    folded_from: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodString;
         target_kind: z.ZodEnum<{
             tool: "tool";
             agent: "agent";
         }>;
         target_name: z.ZodString;
-        kind: z.ZodString;
+    }, z.core.$strict>>>;
+    seq: z.ZodNumber;
+    state: z.ZodString;
+    subject: z.ZodObject<{
         key: z.ZodString;
-    }, z.core.$strip>;
-    folded_from: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
         target_kind: z.ZodEnum<{
             tool: "tool";
             agent: "agent";
         }>;
         target_name: z.ZodString;
-        kind: z.ZodString;
-        key: z.ZodString;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export type StateRecord = z.infer<typeof stateRecord>;
 /** The outcome of an `apply` (a delta batch): whether it applied + the resulting doc. */
 export declare const applyResult: z.ZodObject<{
@@ -257,7 +383,7 @@ export declare const applyResult: z.ZodObject<{
     data: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     seq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     skipped: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type ApplyResult = z.infer<typeof applyResult>;
 /**
  * `GET …/template-jq/{name}` — the evaluated template jq's `name`, its `purpose`, and
@@ -267,9 +393,9 @@ export type ApplyResult = z.infer<typeof applyResult>;
  */
 export declare const templateJqResult: z.ZodObject<{
     name: z.ZodString;
-    purpose: z.ZodLiteral<"input">;
-    value: z.ZodUnknown;
-}, z.core.$strip>;
+    purpose: z.ZodDefault<z.ZodLiteral<"input">>;
+    value: z.ZodDefault<z.ZodUnknown>;
+}, z.core.$strict>;
 export type TemplateJqResult = z.infer<typeof templateJqResult>;
 /**
  * `POST …/template-jq/{name}` — the applied template jq's outcome. The jq lands an op
@@ -277,12 +403,12 @@ export type TemplateJqResult = z.infer<typeof templateJqResult>;
  * carry that outcome.
  */
 export declare const templateJqApplyResult: z.ZodObject<{
-    name: z.ZodString;
     applied: z.ZodBoolean;
     data: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    name: z.ZodString;
     seq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
     skipped: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type TemplateJqApplyResult = z.infer<typeof templateJqApplyResult>;
 /**
  * One paged subject row: the addressed `subject` plus its record's last-write
@@ -291,14 +417,14 @@ export type TemplateJqApplyResult = z.infer<typeof templateJqApplyResult>;
  */
 export declare const subjectRow: z.ZodObject<{
     subject: z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodString;
         target_kind: z.ZodEnum<{
             tool: "tool";
             agent: "agent";
         }>;
         target_name: z.ZodString;
-        kind: z.ZodString;
-        key: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     updated_at: z.ZodNumber;
 }, z.core.$strip>;
 export type SubjectRow = z.infer<typeof subjectRow>;
@@ -308,19 +434,32 @@ export type SubjectRow = z.infer<typeof subjectRow>;
  * (`null` at the end).
  */
 export declare const subjectPage: z.ZodObject<{
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
     subjects: z.ZodArray<z.ZodObject<{
         subject: z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
             target_kind: z.ZodEnum<{
                 tool: "tool";
                 agent: "agent";
             }>;
             target_name: z.ZodString;
-            kind: z.ZodString;
-            key: z.ZodString;
-        }, z.core.$strip>;
+        }, z.core.$strict>;
         updated_at: z.ZodNumber;
     }, z.core.$strip>>;
-    next_cursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type SubjectPage = z.infer<typeof subjectPage>;
 /**
@@ -329,76 +468,110 @@ export type SubjectPage = z.infer<typeof subjectPage>;
  * the record page; `next_cursor` pages the rest.
  */
 export declare const recordSearchPage: z.ZodObject<{
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
     matches: z.ZodArray<z.ZodObject<{
         subject: z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
             target_kind: z.ZodEnum<{
                 tool: "tool";
                 agent: "agent";
             }>;
             target_name: z.ZodString;
-            kind: z.ZodString;
-            key: z.ZodString;
-        }, z.core.$strip>;
+        }, z.core.$strict>;
         updated_at: z.ZodNumber;
     }, z.core.$strip>>;
-    next_cursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type RecordSearchPage = z.infer<typeof recordSearchPage>;
 /** A WriteEntry's origin completed by the platform chokepoint (mirrors CompletedOrigin). */
 export declare const completedOrigin: z.ZodObject<{
+    actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     consumer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    door: z.ZodEnum<{
+        tool: "tool";
+        api: "api";
+        conversation: "conversation";
+        hook: "hook";
+        schedule: "schedule";
+        operator: "operator";
+    }>;
+    inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     meta: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     op_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    door: z.ZodString;
-    actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type CompletedOrigin = z.infer<typeof completedOrigin>;
 /** One row of a subject's audit trail (mirrors WriteEntry). `paths` are absolute. */
 export declare const writeEntry: z.ZodObject<{
-    seq: z.ZodNumber;
     at: z.ZodString;
     origin: z.ZodObject<{
+        actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         consumer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        door: z.ZodEnum<{
+            tool: "tool";
+            api: "api";
+            conversation: "conversation";
+            hook: "hook";
+            schedule: "schedule";
+            operator: "operator";
+        }>;
+        inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         meta: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         op_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        door: z.ZodString;
-        actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
     paths: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
-}, z.core.$strip>;
+    seq: z.ZodNumber;
+}, z.core.$strict>;
 export type WriteEntry = z.infer<typeof writeEntry>;
 /** `GET /api/states/{name}/records/.../writes` — a keyset page of the audit trail. */
 export declare const writesPage: z.ZodObject<{
-    items: z.ZodArray<z.ZodObject<{
-        seq: z.ZodNumber;
+    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
         at: z.ZodString;
         origin: z.ZodObject<{
+            actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             consumer: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            door: z.ZodEnum<{
+                tool: "tool";
+                api: "api";
+                conversation: "conversation";
+                hook: "hook";
+                schedule: "schedule";
+                operator: "operator";
+            }>;
+            inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             meta: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-            run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             op_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            door: z.ZodString;
-            actor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>;
+        }, z.core.$strict>;
         paths: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
-    }, z.core.$strip>>;
+        seq: z.ZodNumber;
+    }, z.core.$strict>>>;
     next_cursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type WritesPage = z.infer<typeof writesPage>;
 /** Where the Studio opens a consumer (mirrors ConsumerLink): a token+search OR plugin path. */
 export declare const consumerLink: z.ZodObject<{
-    token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     plugin_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     search: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
+    token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
 export type ConsumerLink = z.infer<typeof consumerLink>;
 /**
  * One thing that binds a state (mirrors ConsumerRow): its `kind` (flow / hook / schedule
@@ -407,52 +580,65 @@ export type ConsumerLink = z.infer<typeof consumerLink>;
  * as a muted line — never swallowed.
  */
 export declare const consumerRow: z.ZodObject<{
-    kind: z.ZodString;
-    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodString;
     link: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-        token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         plugin_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         search: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$strip>>>;
+        token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     unavailable: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type ConsumerRow = z.infer<typeof consumerRow>;
 /** `GET /api/states/{name}/consumers` — the union of every registered lister's rows. */
 export declare const stateConsumers: z.ZodArray<z.ZodObject<{
-    kind: z.ZodString;
-    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    kind: z.ZodString;
     link: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-        token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         plugin_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         search: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$strip>>>;
+        token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     unavailable: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>>;
+}, z.core.$strict>>;
 export type StateConsumers = z.infer<typeof stateConsumers>;
 /** `DELETE /api/states/{name}` — the removed state. */
 export declare const stateDeleted: z.ZodObject<{
+    deleted: z.ZodBoolean;
     name: z.ZodString;
-    deleted: z.ZodLiteral<true>;
 }, z.core.$strip>;
 /** `PUT /api/states/{name}/attachments/{template}` — the template now attached to the state. */
 export declare const stateAttached: z.ZodObject<{
-    attached: z.ZodLiteral<true>;
+    attached: z.ZodBoolean;
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
     state: z.ZodString;
     template: z.ZodString;
 }, z.core.$strip>;
 export type StateAttached = z.infer<typeof stateAttached>;
 /** `PATCH /api/states/{name}/attachments/{template}` — the attachment whose declarations were rewritten. */
 export declare const stateAttachmentUpdated: z.ZodObject<{
-    updated: z.ZodLiteral<true>;
     state: z.ZodString;
     template: z.ZodString;
+    updated: z.ZodBoolean;
 }, z.core.$strip>;
 export type StateAttachmentUpdated = z.infer<typeof stateAttachmentUpdated>;
 /** `DELETE /api/states/{name}/attachments/{template}` — the template detached from the state. */
 export declare const stateDetached: z.ZodObject<{
-    detached: z.ZodLiteral<true>;
+    detached: z.ZodBoolean;
     state: z.ZodString;
     template: z.ZodString;
 }, z.core.$strip>;
@@ -460,40 +646,169 @@ export type StateDetached = z.infer<typeof stateDetached>;
 /**
  * `POST /api/states/{name}/records/.../fold` — the fold report: the `mode`, the
  * `{kind, key}` of the folded `from` and surviving `into` subjects, whether the fold
- * was `already` in place, and how many records were `flattened` into the survivor.
+ * was `already` in place, how many records were `flattened` into the survivor, and
+ * (a `merge` fold only) the survivor's newly-filled `merged_members`.
  */
 export declare const stateFoldReport: z.ZodObject<{
-    mode: z.ZodEnum<{
-        switch: "switch";
-        merge: "merge";
-    }>;
+    already: z.ZodBoolean;
+    flattened: z.ZodNumber;
     from: z.ZodObject<{
-        kind: z.ZodString;
         key: z.ZodString;
+        kind: z.ZodString;
     }, z.core.$strip>;
     into: z.ZodObject<{
-        kind: z.ZodString;
         key: z.ZodString;
+        kind: z.ZodString;
     }, z.core.$strip>;
-    already: z.ZodBoolean;
-    flattened: z.ZodDefault<z.ZodNumber>;
+    merged_members: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    mode: z.ZodEnum<{
+        switch: "switch";
+        merge: "merge";
+    }>;
 }, z.core.$strip>;
 export type StateFoldReport = z.infer<typeof stateFoldReport>;
 /** `DELETE /api/state-templates/{name}` — the removed template document. */
 export declare const stateTemplateDeleted: z.ZodObject<{
+    deleted: z.ZodBoolean;
     name: z.ZodString;
-    deleted: z.ZodLiteral<true>;
 }, z.core.$strip>;
 /** `DELETE /api/states/{name}/records/...` — the erased record marker. */
 export declare const recordErased: z.ZodObject<{
-    erased: z.ZodLiteral<true>;
+    erased: z.ZodBoolean;
 }, z.core.$strip>;
 /**
  * `POST /api/state-retention/prune` — the retention sweep's per-state deleted counts
  * (`{}` when nothing expired); the UI sums the values for its total.
  */
 export declare const stateRetentionPruned: z.ZodObject<{
-    pruned: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    held: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        held_by: z.ZodString;
+        save_id: z.ZodString;
+        subjects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    pruned: z.ZodRecord<z.ZodString, z.ZodNumber>;
 }, z.core.$strip>;
 export type StateRetentionPruned = z.infer<typeof stateRetentionPruned>;
+/** A pending save's lifecycle: records waiting, calls queued, a call running, or failed (held). */
+export declare const pendingSaveStatus: z.ZodEnum<{
+    running: "running";
+    failed: "failed";
+    calls: "calls";
+    pending: "pending";
+}>;
+export type PendingSaveStatus = z.infer<typeof pendingSaveStatus>;
+/**
+ * One outstanding pending state save (`GET /api/state-pending-saves`): what it writes and calls,
+ * never the record data or call arguments. `failed_phase` says which part failed.
+ */
+export declare const pendingSave: z.ZodObject<{
+    attempts: z.ZodNumber;
+    calls: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+    created_at: z.ZodString;
+    failed_at: z.ZodNullable<z.ZodString>;
+    failed_phase: z.ZodNullable<z.ZodEnum<{
+        calls: "calls";
+        records: "records";
+    }>>;
+    id: z.ZodString;
+    last_error: z.ZodNullable<z.ZodString>;
+    run_id: z.ZodNullable<z.ZodString>;
+    states: z.ZodArray<z.ZodString>;
+    status: z.ZodEnum<{
+        running: "running";
+        failed: "failed";
+        calls: "calls";
+        pending: "pending";
+    }>;
+    subjects: z.ZodArray<z.ZodObject<{
+        state: z.ZodString;
+        subject: z.ZodObject<{
+            key: z.ZodString;
+            kind: z.ZodString;
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PendingSave = z.infer<typeof pendingSave>;
+/**
+ * A page of pending saves, newest first, with the totals of every `outstanding` and every
+ * `failed` save; `next_cursor` continues the page (`null` at the end).
+ */
+export declare const pendingSavesPage: z.ZodObject<{
+    failed: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        attempts: z.ZodNumber;
+        calls: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            target: z.ZodString;
+        }, z.core.$strip>>;
+        created_at: z.ZodString;
+        failed_at: z.ZodNullable<z.ZodString>;
+        failed_phase: z.ZodNullable<z.ZodEnum<{
+            calls: "calls";
+            records: "records";
+        }>>;
+        id: z.ZodString;
+        last_error: z.ZodNullable<z.ZodString>;
+        run_id: z.ZodNullable<z.ZodString>;
+        states: z.ZodArray<z.ZodString>;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            calls: "calls";
+            pending: "pending";
+        }>;
+        subjects: z.ZodArray<z.ZodObject<{
+            state: z.ZodString;
+            subject: z.ZodObject<{
+                key: z.ZodString;
+                kind: z.ZodString;
+                target_kind: z.ZodEnum<{
+                    tool: "tool";
+                    agent: "agent";
+                }>;
+                target_name: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    outstanding: z.ZodNumber;
+}, z.core.$strip>;
+export type PendingSavesPage = z.infer<typeof pendingSavesPage>;
+/**
+ * `POST /api/state-pending-saves/{id}/retry` — the save's status after its records phase:
+ * `applied` (it landed whole), `pending`/`calls`/`running` (queued again), or `failed` again
+ * with its `last_error`.
+ */
+export declare const pendingSaveRetried: z.ZodObject<{
+    id: z.ZodString;
+    last_error: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        running: "running";
+        applied: "applied";
+        failed: "failed";
+        calls: "calls";
+        pending: "pending";
+    }>;
+}, z.core.$strip>;
+export type PendingSaveRetried = z.infer<typeof pendingSaveRetried>;
+/** `DELETE /api/state-pending-saves/{id}` — the discarded save's id. */
+export declare const pendingSaveDiscarded: z.ZodObject<{
+    discarded: z.ZodString;
+}, z.core.$strip>;
 //# sourceMappingURL=states.d.ts.map