@tai42/api-client 22.1.0 → 22.3.0

package/src/generated/openapi-schemas.ts

@@ -88,7 +88,7 @@ export type PageCopy = z.infer<typeof pageCopy>;
 export const answerPageWording = z.object({ "awaiting": pageCopy.nullable().default(null), "confirm": pageCopy.nullable().default(null), "done": pageCopy.nullable().default(null), "form": formPageWording.nullable().default(null), "submitted": pageCopy.nullable().default(null) }).strict();
 export type AnswerPageWording = z.infer<typeof answerPageWording>;
 
-export const formOption = z.object({ "label": z.string().nullable().default(null), "value": z.string() }).strict();
+export const formOption = z.object({ "description": z.string().nullable().default(null), "label": z.string().nullable().default(null), "value": z.string() }).strict();
 export type FormOption = z.infer<typeof formOption>;
 
 export const formData = z.object({ "options": z.record(z.string(), z.array(formOption)).default({}), "values": z.record(z.string(), z.unknown()).default({}) }).strict();
@@ -682,7 +682,7 @@ export type PersonAddress = z.infer<typeof personAddress>;
 export const person = z.object({ "addresses": z.array(personAddress).min(1), "created_at": z.string(), "locale": z.string().nullable().default(null), "person_id": z.string().min(1), "target_kind": z.enum(["agent","tool"]), "target_name": z.string().min(1) });
 export type Person = z.infer<typeof person>;
 
-export const personDeleteResult = z.object({ "erased": z.boolean(), "person_id": z.string(), "removed": z.number().int() });
+export const personDeleteResult = z.object({ "erased": z.boolean(), "person_id": z.string(), "removed": z.number().int(), "states_erased": z.number().int() });
 export type PersonDeleteResult = z.infer<typeof personDeleteResult>;
 
 export const policyRollback = z.object({ "version": z.number().int() });
@@ -826,6 +826,18 @@ export type PublicRoutePin = z.infer<typeof publicRoutePin>;
 export const publicRouteUnpin = z.object({ "url": z.string() });
 export type PublicRouteUnpin = z.infer<typeof publicRouteUnpin>;
 
+export const validationReason = z.object({ "message": z.string(), "path": z.string() }).strict();
+export type ValidationReason = z.infer<typeof validationReason>;
+
+export const recordCheckItem = z.object({ "reasons": z.array(validationReason).default([]), "subject": stateSubject, "updated_at": z.number() }).strict();
+export type RecordCheckItem = z.infer<typeof recordCheckItem>;
+
+export const recordCheckPage = z.object({ "checked": z.number().int(), "held": z.array(heldPendingSave).default([]), "items": z.array(recordCheckItem).default([]), "next_cursor": z.string().nullable().default(null) }).strict();
+export type RecordCheckPage = z.infer<typeof recordCheckPage>;
+
+export const recordValidation = z.object({ "fits": z.boolean(), "reasons": z.array(validationReason).default([]) }).strict();
+export type RecordValidation = z.infer<typeof recordValidation>;
+
 export const reloadConfig = z.object({ "targets": z.array(z.string()).nullable().default(null) });
 export type ReloadConfig = z.infer<typeof reloadConfig>;
 
@@ -1159,7 +1171,7 @@ export type TemplateUpload = z.infer<typeof templateUpload>;
 export const templateUploadResult = z.object({ "fanout": fanoutSummary, "path": z.string(), "uploaded": z.boolean() });
 export type TemplateUploadResult = z.infer<typeof templateUploadResult>;
 
-export const threadDeleteResult = z.object({ "removed": z.number().int(), "route_name": z.string(), "thread_id": z.string() });
+export const threadDeleteResult = z.object({ "removed": z.number().int(), "route_name": z.string(), "states_erased": z.number().int(), "thread_id": z.string() });
 export type ThreadDeleteResult = z.infer<typeof threadDeleteResult>;
 
 export const threadMessageAck = z.object({ "message_id": z.string(), "thread_id": z.string() });
@@ -1414,6 +1426,7 @@ export const responseSchemas = {
   get_api_states_name_attachments: stateAttachmentList,
   get_api_states_name_attachments_template: stateAttachmentRow,
   get_api_states_name_consumers: stateConsumerList,
+  get_api_states_name_records_check: recordCheckPage,
   get_api_states_name_records_target_kind_target_name_kind_key: stateRecordOrNull,
   get_api_states_name_records_target_kind_target_name_kind_key_template_jq_program: templateJqResult,
   get_api_states_name_records_target_kind_target_name_kind_key_writes: writesPage,
@@ -1511,6 +1524,7 @@ export const responseSchemas = {
   post_api_states_name_records_target_kind_target_name_kind_key_deltas: applyResult,
   post_api_states_name_records_target_kind_target_name_kind_key_fold: foldReport,
   post_api_states_name_records_target_kind_target_name_kind_key_template_jq_program: templateJqApplyResult,
+  post_api_states_name_records_validate: recordValidation,
   post_api_storage_resources: resourceStored,
   post_api_sub_mcp: subMcpRegistrationResult,
   post_api_template: templateFetchView,

package/src/generated/served-schemas.ts

@@ -789,6 +789,10 @@ export const servedDocumentsJson = {
                   "gloss": "door=channel: the registry channel name",
                   "name": "channel"
                 },
+                {
+                  "gloss": "the name of the conversation route the turn entered through",
+                  "name": "route"
+                },
                 {
                   "gloss": "the turn's canonical thread id (the thread doors' id)",
                   "name": "thread_id"
@@ -1185,6 +1189,10 @@ export const servedDocumentsJson = {
                   "gloss": "door=channel: the registry channel name",
                   "name": "channel"
                 },
+                {
+                  "gloss": "the name of the conversation route the turn entered through",
+                  "name": "route"
+                },
                 {
                   "gloss": "the turn's canonical thread id (the thread doors' id)",
                   "name": "thread_id"
@@ -1674,6 +1682,10 @@ export const servedDocumentsJson = {
                   "gloss": "door=channel: the registry channel name",
                   "name": "channel"
                 },
+                {
+                  "gloss": "the name of the conversation route the turn entered through",
+                  "name": "route"
+                },
                 {
                   "gloss": "the turn's canonical thread id (the thread doors' id)",
                   "name": "thread_id"
@@ -2058,6 +2070,10 @@ export const servedDocumentsJson = {
                   "gloss": "door=channel: the registry channel name",
                   "name": "channel"
                 },
+                {
+                  "gloss": "the name of the conversation route the turn entered through",
+                  "name": "route"
+                },
                 {
                   "gloss": "the turn's canonical thread id (the thread doors' id)",
                   "name": "thread_id"

package/src/index.ts

@@ -242,7 +242,10 @@ export type {
   ProviderView,
   ReactionEvent,
   ReactionEventKind,
+  RecordCheckItem,
+  RecordCheckPage,
   RecordSearchPage,
+  RecordValidation,
   RecycleEntry,
   RecycleRoll,
   RecycleStop,
@@ -324,6 +327,7 @@ export type {
   TriggerLinkList,
   TriggerLinkRecord,
   ValidateConditionResult,
+  ValidationReason,
   VisitOutcome,
   Wording,
   WorkerKind,

package/src/schemas/interactions.ts

@@ -41,9 +41,11 @@ export type AttachmentMediaItem = z.infer<typeof attachmentMediaItem>;
 /**
  * One per-send choice for a `form` property whose schema is a string (or array of
  * strings). `value` is what the answer carries; `label` (absent OR null both parse
- * to no label) is the human text shown in its place. A send may replace a property's
- * `enum` this way for one ask without republishing the form. Applied per property by
- * the form preview (safeParsed), so a malformed entry is a loud notice, never silent.
+ * to no label) is the human text shown in its place; `description` (absent OR null
+ * both parse to none) is the option's second line of supporting text. A send may
+ * replace a property's `enum` this way for one ask without republishing the form.
+ * Applied per property by the form preview (safeParsed), so a malformed entry is a
+ * loud notice, never silent.
  */
 export const formOption = openapi.formOption;
 export type FormOption = z.infer<typeof formOption>;

package/src/schemas/states.ts

@@ -126,6 +126,40 @@ export type SubjectPage = z.infer<typeof subjectPage>;
 export const recordSearchPage = openapi.stateSearchPage;
 export type RecordSearchPage = z.infer<typeof recordSearchPage>;
 
+/**
+ * One way a candidate document does not fit a state's effective schema (mirrors
+ * ValidationReason): the JSON `path` of the offending node (`$` for the document root)
+ * and the validator's `message`. A document that fits has none.
+ */
+export const validationReason = openapi.validationReason;
+export type ValidationReason = z.infer<typeof validationReason>;
+
+/**
+ * `POST /api/states/{name}/records/validate` — whether a candidate document `fits` the
+ * state's effective schema, with every `reasons` entry it fails on (ordered by JSON
+ * path). A misfit is a 200 whose body says `fits:false`; a non-object body or a broken
+ * `$ref` is the route's 422.
+ */
+export const recordValidation = openapi.recordValidation;
+export type RecordValidation = z.infer<typeof recordValidation>;
+
+/**
+ * One stored record that does not fit its state's current effective schema (mirrors
+ * RecordCheckItem): the `subject` it belongs to, its last-write `updated_at` (epoch
+ * seconds) and every `reasons` entry it fails on.
+ */
+export const recordCheckItem = openapi.recordCheckItem;
+export type RecordCheckItem = z.infer<typeof recordCheckItem>;
+
+/**
+ * `GET /api/states/{name}/records/check` — one keyset page of the state's records checked
+ * against its effective schema: `checked` (records read this page), `items` (the MISFITS
+ * ONLY), `next_cursor` (the cursor the next page reads from, `null` at the end) and `held`
+ * (the saves held by a failed pending save whose subjects the page skipped).
+ */
+export const recordCheckPage = openapi.recordCheckPage;
+export type RecordCheckPage = z.infer<typeof recordCheckPage>;
+
 /** A WriteEntry's origin completed by the platform chokepoint (mirrors CompletedOrigin). */
 export const completedOrigin = openapi.completedOrigin;
 export type CompletedOrigin = z.infer<typeof completedOrigin>;