@tai42/api-client 15.0.0 → 16.0.1

package/dist/schemas/settings-schema.d.ts

@@ -0,0 +1,23 @@
+/** Declarative settings-form schema response. */
+import { z } from 'zod';
+export declare const settingsSchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        module: z.ZodString;
+        qualname: z.ZodString;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            env_var: z.ZodString;
+            type: z.ZodString;
+            default: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+            required: z.ZodBoolean;
+            secret: z.ZodBoolean;
+            description: z.ZodNullable<z.ZodString>;
+            nested_group: z.ZodNullable<z.ZodString>;
+            default_namespace_var: z.ZodNullable<z.ZodString>;
+            value: z.ZodNullable<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SettingsSchema = z.infer<typeof settingsSchema>;
+//# sourceMappingURL=settings-schema.d.ts.map

package/dist/schemas/settings-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/settings-schema.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;iBAsBzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schemas/settings-schema.js

@@ -0,0 +1,25 @@
+/** Declarative settings-form schema response. */
+import { z } from 'zod';
+import { jsonValue } from './shared';
+// The settings form is auto-rendered from a declarative group/field description
+// the skeleton emits from its typed settings models.
+export const settingsSchema = z.object({
+    groups: z.array(z.object({
+        name: z.string(),
+        module: z.string(),
+        qualname: z.string(),
+        fields: z.array(z.object({
+            name: z.string(),
+            env_var: z.string(),
+            type: z.string(),
+            default: jsonValue.nullable(),
+            required: z.boolean(),
+            secret: z.boolean(),
+            description: z.string().nullable(),
+            nested_group: z.string().nullable(),
+            default_namespace_var: z.string().nullable(),
+            value: jsonValue.nullable(),
+        })),
+    })),
+});
+//# sourceMappingURL=settings-schema.js.map

package/dist/schemas/settings-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-schema.js","sourceRoot":"","sources":["../../src/schemas/settings-schema.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,gFAAgF;AAChF,qDAAqD;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE;YAC7B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;YACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5C,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;SAC5B,CAAC,CACH;KACF,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/schemas/shared.d.ts

@@ -0,0 +1,20 @@
+/** Shared primitive schemas (json value/schema) and the paged-window fields. */
+import { z } from 'zod';
+/** An arbitrary JSON value (tool results, rendered payloads). */
+export declare const jsonValue: z.ZodType;
+/** A JSON Schema object (Pydantic-emitted). Permissive; parsed by the auto-form. */
+export declare const jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * The page window every paged read door carries; `next_page` is null on the last
+ * page. `truncated` is TRUE when the door had more matches than it would scan or
+ * return under its cap — the UI must surface that LOUDLY, never a silent cut — and
+ * false whenever the window is exhaustive.
+ */
+export declare const pageWindow: {
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    next_page: z.ZodNullable<z.ZodNumber>;
+    truncated: z.ZodBoolean;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/schemas/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/schemas/shared.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iEAAiE;AACjE,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,OAAqB,CAAC;AAEhD,oFAAoF;AACpF,eAAO,MAAM,UAAU,wCAAoC,CAAC;AAC5D;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAC"}

package/dist/schemas/shared.js

@@ -0,0 +1,20 @@
+/** Shared primitive schemas (json value/schema) and the paged-window fields. */
+import { z } from 'zod';
+/** An arbitrary JSON value (tool results, rendered payloads). */
+export const jsonValue = z.unknown();
+/** A JSON Schema object (Pydantic-emitted). Permissive; parsed by the auto-form. */
+export const jsonSchema = z.record(z.string(), z.unknown());
+/**
+ * The page window every paged read door carries; `next_page` is null on the last
+ * page. `truncated` is TRUE when the door had more matches than it would scan or
+ * return under its cap — the UI must surface that LOUDLY, never a silent cut — and
+ * false whenever the window is exhaustive.
+ */
+export const pageWindow = {
+    total: z.number(),
+    page: z.number(),
+    page_size: z.number(),
+    next_page: z.number().nullable(),
+    truncated: z.boolean(),
+};
+//# sourceMappingURL=shared.js.map

package/dist/schemas/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/schemas/shared.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,CAAC,OAAO,EAAE,CAAC;AAEhD,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAC5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC"}

package/dist/schemas/states.d.ts

@@ -0,0 +1,499 @@
+/** State declaration, record, template and consumer response schemas. */
+import { z } from 'zod';
+/** One addressed subject: the conversation-target scope plus the (kind, key) within it. */
+export declare const stateSubject: z.ZodObject<{
+    target_kind: z.ZodEnum<{
+        tool: "tool";
+        agent: "agent";
+    }>;
+    target_name: z.ZodString;
+    kind: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strip>;
+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 row of `GET /api/states` — a served declaration (`list_states` dumps every
+ * `StateDeclaration`) plus `updated_at` (the row's last-write timestamp, ISO or
+ * `null`). The list carries no record count; the `Records` column reads
+ * `getStateStats` lazily per row.
+ */
+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]>>;
+    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]>>;
+    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 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]>>;
+    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]>>;
+    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>>;
+/** One template attachment on a state: where the fragment lands + its param/declaration values. */
+export declare const stateAttachment: z.ZodObject<{
+    template: z.ZodString;
+    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>;
+export type StateAttachment = z.infer<typeof stateAttachment>;
+export declare const stateAttachmentList: z.ZodArray<z.ZodObject<{
+    template: z.ZodString;
+    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>>;
+/** `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]>>;
+    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]>>;
+    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;
+        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>>>;
+}, z.core.$strict>;
+export type StateDetail = z.infer<typeof stateDetail>;
+/**
+ * `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)
+ * and `consumers` (the count of listable consumers). The Records tab shows `records`;
+ * the states list reads it lazily for its Records column.
+ */
+export declare const stateStats: z.ZodObject<{
+    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>;
+/**
+ * One row of `GET /api/state-templates`. The template document plus the two derived columns
+ * the Templates tab shows: `attached_to` (how many states attach it — a delete is refused
+ * while > 0) and `shipped_default` (a platform-shipped template). Both are server-derived
+ * 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<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodNull]>>;
+    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<{
+        close: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        orphans: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        resolutions: 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.core.$strict>, z.ZodNull]>>;
+    regimes: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    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<{
+        description: z.ZodDefault<z.ZodString>;
+        jq: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        params: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        purpose: z.ZodEnum<{
+            input: "input";
+            update: "update";
+        }>;
+        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>;
+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<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodNull]>>;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodNull]>>;
+    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<{
+        close: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        orphans: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        resolutions: 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.core.$strict>, z.ZodNull]>>;
+    regimes: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    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<{
+        description: z.ZodDefault<z.ZodString>;
+        jq: z.ZodObject<{
+            content: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            kwargs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        params: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        purpose: z.ZodEnum<{
+            input: "input";
+            update: "update";
+        }>;
+        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>>;
+/** 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<{
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    data: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    seq: z.ZodNumber;
+    canonical_subject: z.ZodObject<{
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    folded_from: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+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<{
+    applied: z.ZodBoolean;
+    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>;
+export type ApplyResult = z.infer<typeof applyResult>;
+/**
+ * `GET …/template-jq/{name}` — the evaluated template jq's `name`, its `purpose`, and
+ * its `value` (the `input` jq's read). GET evaluates ONLY an `input`-purpose jq; a GET
+ * on an `update`-purpose name is refused with 422, so the result's purpose is always
+ * `input`.
+ */
+export declare const templateJqResult: z.ZodObject<{
+    name: z.ZodString;
+    purpose: z.ZodLiteral<"input">;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export type TemplateJqResult = z.infer<typeof templateJqResult>;
+/**
+ * `POST …/template-jq/{name}` — the applied template jq's outcome. The jq lands an op
+ * batch through the same `apply` chokepoint as a delta, so `applied`/`data`/`seq`/`skipped`
+ * 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>>>;
+    seq: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    skipped: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type TemplateJqApplyResult = z.infer<typeof templateJqApplyResult>;
+/**
+ * One paged subject row: the addressed `subject` plus its record's last-write
+ * `updated_at` — epoch seconds (the store's `extract(epoch FROM updated_at)`), served
+ * raw (no `mode="json"` dump), and `NOT NULL` on every record, so a plain number.
+ */
+export declare const subjectRow: z.ZodObject<{
+    subject: z.ZodObject<{
+        target_kind: z.ZodEnum<{
+            tool: "tool";
+            agent: "agent";
+        }>;
+        target_name: z.ZodString;
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    updated_at: z.ZodNumber;
+}, z.core.$strip>;
+export type SubjectRow = z.infer<typeof subjectRow>;
+/**
+ * `GET /api/states/{name}/subjects` — a keyset page of subject rows (optionally of one
+ * `kind`): the matched `subjects` plus the `next_cursor` a "Load more" carries back
+ * (`null` at the end).
+ */
+export declare const subjectPage: z.ZodObject<{
+    subjects: z.ZodArray<z.ZodObject<{
+        subject: z.ZodObject<{
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+            kind: z.ZodString;
+            key: z.ZodString;
+        }, z.core.$strip>;
+        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>;
+/**
+ * `POST /api/states/{name}/records/search` — a keyset page of the subject rows whose
+ * document contains the filters (a JSONB containment match). Each hit's `subject` opens
+ * the record page; `next_cursor` pages the rest.
+ */
+export declare const recordSearchPage: z.ZodObject<{
+    matches: z.ZodArray<z.ZodObject<{
+        subject: z.ZodObject<{
+            target_kind: z.ZodEnum<{
+                tool: "tool";
+                agent: "agent";
+            }>;
+            target_name: z.ZodString;
+            kind: z.ZodString;
+            key: z.ZodString;
+        }, z.core.$strip>;
+        updated_at: z.ZodNumber;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodDefault<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<{
+    consumer: 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>>;
+    turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+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<{
+        consumer: 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>>;
+        turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    paths: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+}, z.core.$strip>;
+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;
+        at: z.ZodString;
+        origin: z.ZodObject<{
+            consumer: 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>>;
+            turn_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            inbound_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>;
+        paths: z.ZodDefault<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+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>;
+export type ConsumerLink = z.infer<typeof consumerLink>;
+/**
+ * One thing that binds a state (mirrors ConsumerRow): its `kind` (flow / hook / schedule
+ * / agent), `name`, human `detail` and optional `link`. `unavailable` marks a consumer
+ * family that cannot be listed on this deployment (e.g. no scheduling backend), surfaced
+ * 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>>;
+    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>>>;
+    unavailable: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+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>>;
+    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>>>;
+    unavailable: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>>;
+export type StateConsumers = z.infer<typeof stateConsumers>;
+/** `DELETE /api/states/{name}` — the removed state. */
+export declare const stateDeleted: z.ZodObject<{
+    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>;
+    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;
+}, 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>;
+    state: z.ZodString;
+    template: z.ZodString;
+}, z.core.$strip>;
+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.
+ */
+export declare const stateFoldReport: z.ZodObject<{
+    mode: z.ZodEnum<{
+        switch: "switch";
+        merge: "merge";
+    }>;
+    from: z.ZodObject<{
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    into: z.ZodObject<{
+        kind: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    already: z.ZodBoolean;
+    flattened: z.ZodDefault<z.ZodNumber>;
+}, 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<{
+    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>;
+}, 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>>;
+}, z.core.$strip>;
+export type StateRetentionPruned = z.infer<typeof stateRetentionPruned>;
+//# sourceMappingURL=states.d.ts.map

package/dist/schemas/states.d.ts.map

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