@tai42/api-client 19.3.0 → 21.0.0

package/dist/schemas/interactions.js

@@ -1,58 +1,30 @@
 /** Interaction question, answer and media response schemas. */
 import { z } from 'zod';
-import { pageWindow } from './shared';
+import * as openapi from '../generated/openapi-schemas';
+import * as served from '../generated/served-schemas';
 // Shapes match the skeleton's interactions SSE contract: the SSE
 // `interaction.add` frame carries the question and its answer format; the answer
 // door returns { interaction_id, status }. `answered` is not a wire field — it
 // is a client-side flag the stream hook flips on an `interaction.answered` event.
-export const answerFormat = z.enum(['text', 'confirm', 'select', 'form', 'external']);
-/** The kind of a question's display-only media item: a remote/inline image, or a link. */
-export const mediaKind = z.enum(['image', 'link']);
+export const answerFormat = openapi.answerFormat;
+/** The kind of a display-only media item: an image, a link, or a document, video or audio file. */
+export const mediaKind = openapi.mediaKind;
 /**
- * One item of a question's display-only media. Applied PER ITEM by the renderer
- * (never as a strict array on the frame): the frame's `media` field is a loose
- * `z.array(z.unknown())`, and the renderer `safeParse`s each item with this schema
- * so one malformed/hostile item is a loud per-item notice, not a whole-frame parse
- * failure that would silently vanish an answerable question.
- *
- * `caption` is `.nullish()` (absent OR `null` both parse to a caption-less item):
- * a caption-less item may arrive with the key omitted OR with an explicit `null`, so
- * `.optional()` here would false-fail the explicit `null` and render a good image as
- * malformed. `url` and `kind` are the only load-bearing fields; the image
- * src scheme gate and the link neutralization are enforced by the renderer.
- */
-export const interactionMediaItem = z.object({
-    kind: mediaKind,
-    url: z.string(),
-    caption: z.string().nullish(),
-});
-/**
- * The kind of a byte-backed inbound attachment carried on a transcript record. A
- * fetchable file — `image`/`document`/`audio`/`video` — never a `link`: a labelled
- * anchor is question CONTEXT (see {@link mediaKind}), not a participant's sent file.
+ * One item of a question's display-only media. The renderer resolves `url` (the image src
+ * scheme gate and the link neutralization are enforced there); `caption` and `filename`
+ * are `null` when absent.
  */
-export const attachmentMediaKind = z.enum(['image', 'document', 'audio', 'video']);
+export const interactionMediaItem = openapi.mediaItem;
+/** The kind of an inbound attachment carried on a transcript record. */
+export const attachmentMediaKind = openapi.mediaKind;
 /**
  * One inbound attachment a participant sent, projected onto a transcript record's
- * `inbound_attachments`. Applied PER ITEM by the renderer (the record's array is a
- * loose `z.array(z.unknown())`, `safeParse`d per member) so one malformed/hostile
- * item is a loud per-item notice, never a whole-record parse failure that would
- * vanish the transcript.
- *
- * `url` is the served-media reference the renderer resolves to the API origin (the
- * same served-url discipline the ask-media renderer uses); the image src scheme gate
- * and the per-item load-failure notice are enforced there. `caption` and `filename`
- * are `.nullish()` (absent OR explicit `null` both parse to absent): the projection
- * may omit the key OR emit `null`, so `.optional()` alone would false-fail an explicit
- * `null`. `filename` is meaningful only for a `document`; the renderer shows it as the
- * download label.
+ * `inbound_attachments`. `url` is the served-media reference the renderer resolves to the
+ * API origin (the same served-url discipline the ask-media renderer uses); the image src
+ * scheme gate and the per-item load-failure notice are enforced there. `filename` is
+ * meaningful only for a `document`; the renderer shows it as the download label.
  */
-export const attachmentMediaItem = z.object({
-    kind: attachmentMediaKind,
-    url: z.string(),
-    caption: z.string().nullish(),
-    filename: z.string().nullish(),
-});
+export const attachmentMediaItem = openapi.mediaItem;
 /**
  * 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
@@ -60,22 +32,16 @@ export const attachmentMediaItem = z.object({
  * `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 = z.object({
-    value: z.string(),
-    label: z.string().nullish(),
-});
+export const formOption = openapi.formOption;
 /**
  * Per-send `form` data: `values` prefills top-level properties (keyed by property
  * name), `options` supplies per-send choice lists (keyed by property name). Both
  * default to empty. The form preview safeParses this off `format_payload.data`, so a
  * malformed block is a loud notice rather than a whole-frame parse failure.
  */
-export const formData = z.object({
-    values: z.record(z.string(), z.unknown()).default({}),
-    options: z.record(z.string(), z.array(formOption)).default({}),
-});
+export const formData = openapi.formData;
 /** The kind of an ordered display block a page may carry alongside its input fields. */
-export const displayBlockKind = z.enum(['heading', 'body', 'image']);
+export const displayBlockKind = openapi.displayBlock.shape.kind;
 /**
  * One ordered, display-only block on a form page (never an input): a `heading` or
  * `body` text block, or an `image`. `text` carries a heading/body's words; `src`/`alt`
@@ -87,15 +53,9 @@ export const displayBlockKind = z.enum(['heading', 'body', 'image']);
  * whole-page parse failure. Applied per block by the preview (safeParsed via its page),
  * so a malformed block is a loud notice, never silent.
  */
-export const displayBlock = z.object({
-    kind: displayBlockKind,
-    text: z.string().nullish(),
-    src: z.string().nullish(),
-    alt: z.string().nullish(),
-    slot: z.string().nullish(),
-});
+export const displayBlock = openapi.displayBlock;
 /** A page's role: an ordinary `input` page (default) or a terminal `review` summary. */
-export const formPageKind = z.enum(['input', 'review']);
+export const formPageKind = openapi.formPage.shape.kind.unwrap();
 /**
  * One page of a stepped `form`: a `title` and the ordered top-level property names it
  * groups. `format_payload.pages` is the ordered list of these; absent = one page. The
@@ -108,14 +68,11 @@ export const formPageKind = z.enum(['input', 'review']);
  * and carries no new input fields; it defaults to `input`. Both are additive: an older
  * payload ({title, fields}) parses unchanged.
  */
-export const formPage = z.object({
-    title: z.string(),
-    fields: z.array(z.string()),
-    display: z.array(displayBlock).default([]),
-    kind: formPageKind.default('input'),
-});
+export const formPage = openapi.formPage;
 /** The `form` pages list (`format_payload.pages`), safeParsed as a whole by the preview. */
 export const formPages = z.array(formPage);
+// The form reactions and the form update are hand-written: the spec carries them inside an
+// open `format_payload` and an open reaction `update`.
 /**
  * When a `form` reacts while it is open (`format_payload.reactions`): the plain,
  * renderer-readable description of WHEN the form calls its reaction handler. Absent ⇒ a
@@ -134,12 +91,12 @@ export const formReactions = z.object({
     choices: z.array(z.string()).default([]),
 });
 /**
- * The form update a reaction door returns (`POST /api/interactions/{id}/react`): the
- * same kind of data a form is sent with, applied to the open form. `values` sets field
- * values; `options` replaces the per-send choice list of option-bearing fields; `errors`
- * shows per-field messages (keyed by field name); `display` fills display slots (keyed by
- * slot name) — a computed total among them. Every member defaults to empty, so a reaction
- * that touches only one of them returns only that one. The door response is safeParsed, so
+ * The form update a reaction door returns (`POST /api/interactions/{id}/react`, its
+ * `update`): the same kind of data a form is sent with, applied to the open form. `values`
+ * sets field values; `options` replaces the per-send choice list of option-bearing fields;
+ * `errors` shows per-field messages (keyed by field name); `display` fills display slots
+ * (keyed by slot name) — a computed total among them. Every member defaults to empty, so a
+ * reaction that touches only one of them returns only that one. The door response is safeParsed, so
  * a malformed update surfaces loudly rather than applying a half-understood change.
  */
 export const formUpdate = z.object({
@@ -149,79 +106,37 @@ export const formUpdate = z.object({
     display: z.record(z.string(), z.unknown()).default({}),
 });
 /**
- * The event a reaction round-trip reports to the door: `kind` is which of the three
- * declared events fired, `field` names the changed field for a `field_changed` event, and
- * `page` names the advanced-from page (by title) for a `page_advanced` event. A
- * `submitted` event carries neither. The body also carries the partial `values` filled so
- * far (see {@link interactionsClient}'s `reactInteraction`).
+ * The event a reaction round-trip reports to the door (the contract's `FormReactionEvent`
+ * document): `kind` is which of the three declared events fired, `field` names the changed
+ * field for a `field_changed` event, and `page` names the advanced-from page (by title) for a
+ * `page_advanced` event. A `submitted` event carries neither. The body also carries the
+ * partial `values` filled so far (see {@link interactionsClient}'s `reactInteraction`).
  */
-export const reactionEventKind = z.enum(['field_changed', 'page_advanced', 'submitted']);
-export const reactionEvent = z.object({
-    kind: reactionEventKind,
-    field: z.string().optional(),
-    page: z.string().optional(),
-});
-export const interaction = z.object({
-    interaction_id: z.string(),
-    group_id: z.string(),
-    question: z.string().default(''),
-    answer_format: answerFormat,
-    // Format-specific payload: select options, form JSON schema (with optional per-send
-    // `data` and `pages`), external url. The wire sends `null` for formats that carry
+export const reactionEvent = served.formReactionEvent;
+/** The reaction door's reply: the interaction id and the form `update` to apply. */
+export const interactionReaction = openapi.interactionReactionResult.extend({ update: formUpdate });
+export const interaction = openapi.interactionFrame.extend({
+    // Hand-written: the format-specific payload (select options, form JSON schema with
+    // optional per-send `data` and `pages`, external url) is `null` for formats that carry
     // none (text/confirm); it is normalized to `{}` so consumers always see an object.
     format_payload: z
         .record(z.string(), z.unknown())
         .nullish()
         .transform((value) => value ?? {}),
-    created_at: z.string(),
-    timeout_at: z.string(),
-    // Whether the answer body is sensitive and never persisted server-side. Rides
-    // every add frame; an absent value (older frame) normalizes to false.
-    sensitive: z.boolean().default(false),
-    // True only for an external question answered by a signed server-to-server
-    // callback (never by a human); the frame never carries the verifier object.
-    // Absent/undefined for every other question.
-    server_verified: z.boolean().optional(),
-    // Name of the channel plugin the question was also delivered through (e.g.
-    // "telegram"); absent when the question lives only in this inbox.
-    channel: z.string().optional(),
-    // Interaction attribution, each additive and absent when unset. `recipient` is
-    // the channel delivery address the question went to; `origin` is the run id of
-    // the background tool run that asked; `audience` is the user_id the question is
-    // addressed to. Display/binding data only, never an authorization axis; a
-    // present non-string is malformed.
-    recipient: z.string().optional(),
-    origin: z.string().optional(),
-    audience: z.string().optional(),
-    // Display-only media shown WITH the question (images and/or links). Absent when
-    // the question carries none. Deliberately LOOSE (`z.array(z.unknown())`): each
-    // item is `safeParse`d per item by the renderer against `interactionMediaItem`,
-    // so one malformed/hostile item can never fail the whole frame parse and hide an
-    // answerable question. A present non-array value is still malformed.
-    media: z.array(z.unknown()).optional(),
 });
 /** The answer door's response — the blocked caller was woken. */
-export const interactionAnswered = z.object({
-    interaction_id: z.string(),
-    status: z.string(),
-});
+export const interactionAnswered = openapi.interactionActionResult;
 /**
  * The cancel door's response — a pending ask was WITHDRAWN without an answer (the
  * asking flow does not resume). `status` is `"cancelled"`; the shape mirrors the
  * answer door's terminal reply, but the door is distinct so it carries its own
  * schema.
  */
-export const interactionCancelled = z.object({
-    interaction_id: z.string(),
-    status: z.string(),
-});
+export const interactionCancelled = openapi.interactionActionResult;
 /**
  * A page of pending interactions from `GET /api/interactions?page=&pageSize=`. Each
  * item is the same record the stream's `interaction.add` frame carries. The pending
  * set is the paged base the tail-only stream applies live deltas over.
  */
-export const interactionsPage = z.object({
-    items: z.array(interaction),
-    ...pageWindow,
-});
+export const interactionsPage = openapi.interactionWindow.extend({ items: z.array(interaction) });
 //# sourceMappingURL=interactions.js.map

package/dist/schemas/interactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../src/schemas/interactions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../src/schemas/interactions.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,6BAA6B,CAAC;AAEtD,iEAAiE;AACjE,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAElF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAGjD,mGAAmG;AACnG,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAG3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;AAGtD,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AAGzC,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;AAGhE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAGjD,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;AAGjE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AAGzC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAG3C,2FAA2F;AAC3F,uDAAuD;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAGH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,iBAAiB,CAAC;AAItD,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAGpG,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACzD,mFAAmF;IACnF,uFAAuF;IACvF,mFAAmF;IACnF,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,OAAO,EAAE;SACT,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;CACrC,CAAC,CAAC;AAGH,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;AAGpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC"}

package/dist/schemas/login.d.ts

@@ -1,77 +1,76 @@
 /** Public login-method aggregator and login-result schemas. */
-import { z } from 'zod';
+import type { z } from 'zod';
 /**
  * One field of a `form` login method. `secret` fields render as password
  * inputs; `autocomplete` passes through to the input (e.g. "email",
  * "current-password", "new-password").
  */
 export declare const loginFormField: z.ZodObject<{
-    name: z.ZodString;
+    autocomplete: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     label: z.ZodString;
-    secret: z.ZodBoolean;
-    autocomplete: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    name: z.ZodString;
+    secret: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
 /**
  * The two — and only two — login-method shapes. Discriminated on `shape`; an
  * unknown shape fails validation loudly (contract drift, not a soft skip).
- * Optional fields are `.optional()` (absent), never `.nullable()`: the server
- * serializes with `exclude_none`, so an absent field is OMITTED, never `null`.
  */
 export declare const loginMethod: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    shape: z.ZodLiteral<"form">;
+    fields: z.ZodArray<z.ZodObject<{
+        autocomplete: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        label: z.ZodString;
+        name: z.ZodString;
+        secret: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
     id: z.ZodString;
-    title: z.ZodString;
     purpose: z.ZodDefault<z.ZodEnum<{
         login: "login";
         invite: "invite";
     }>>;
-    fields: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        label: z.ZodString;
-        secret: z.ZodBoolean;
-        autocomplete: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    shape: z.ZodDefault<z.ZodLiteral<"form">>;
     submit_path: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    shape: z.ZodLiteral<"button">;
+    title: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    href: z.ZodString;
+    icon: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     id: z.ZodString;
     label: z.ZodString;
-    icon: z.ZodOptional<z.ZodString>;
-    href: z.ZodString;
-}, z.core.$strip>], "shape">;
+    shape: z.ZodDefault<z.ZodLiteral<"button">>;
+}, z.core.$strict>], "shape">;
 /**
  * `GET /api/login/methods` (PUBLIC). `needs_setup: true` ⇒ no principal exists
  * yet, so the deployment must be initialized through the setup door before anyone
  * can sign in. `setup_login` names the login-credential kinds the setup door can
- * attach the owner's login with; it is `null`/absent when no login-attaching
- * accounts provider is configured (a keys-only deployment). Non-strict — the
- * skeleton may grow additive fields.
+ * attach the owner's login with; it is `null` when no login-attaching accounts
+ * provider is configured (a keys-only deployment). `claim_fragment_key` names the
+ * URL-fragment key a claim link carries its token under.
  */
 export declare const loginMethods: z.ZodObject<{
+    claim_fragment_key: z.ZodString;
     methods: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        shape: z.ZodLiteral<"form">;
+        fields: z.ZodArray<z.ZodObject<{
+            autocomplete: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            label: z.ZodString;
+            name: z.ZodString;
+            secret: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
         id: z.ZodString;
-        title: z.ZodString;
         purpose: z.ZodDefault<z.ZodEnum<{
             login: "login";
             invite: "invite";
         }>>;
-        fields: z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            label: z.ZodString;
-            secret: z.ZodBoolean;
-            autocomplete: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
+        shape: z.ZodDefault<z.ZodLiteral<"form">>;
         submit_path: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        shape: z.ZodLiteral<"button">;
+        title: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        href: z.ZodString;
+        icon: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         id: z.ZodString;
         label: z.ZodString;
-        icon: z.ZodOptional<z.ZodString>;
-        href: z.ZodString;
-    }, z.core.$strip>], "shape">>;
+        shape: z.ZodDefault<z.ZodLiteral<"button">>;
+    }, z.core.$strict>], "shape">>;
     needs_setup: z.ZodBoolean;
-    setup_login: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    setup_login: z.ZodDefault<z.ZodNullable<z.ZodObject<{
         kinds: z.ZodArray<z.ZodEnum<{
             invite: "invite";
             password: "password";

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

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/schemas/login.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;4BAgBtB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;iBAGtB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/schemas/login.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;kBAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;6BAAoD,CAAC;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA8B,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;iBAA8B,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/schemas/login.js

@@ -1,61 +1,27 @@
-/** Public login-method aggregator and login-result schemas. */
-import { z } from 'zod';
+import * as openapi from '../generated/openapi-schemas';
 /**
  * One field of a `form` login method. `secret` fields render as password
  * inputs; `autocomplete` passes through to the input (e.g. "email",
  * "current-password", "new-password").
  */
-export const loginFormField = z.object({
-    name: z.string().min(1),
-    label: z.string().min(1),
-    secret: z.boolean(),
-    autocomplete: z.string().optional(),
-});
+export const loginFormField = openapi.formField;
 /**
  * The two — and only two — login-method shapes. Discriminated on `shape`; an
  * unknown shape fails validation loudly (contract drift, not a soft skip).
- * Optional fields are `.optional()` (absent), never `.nullable()`: the server
- * serializes with `exclude_none`, so an absent field is OMITTED, never `null`.
  */
-export const loginMethod = z.discriminatedUnion('shape', [
-    z.object({
-        shape: z.literal('form'),
-        id: z.string().min(1),
-        title: z.string().min(1),
-        purpose: z.enum(['login', 'invite']).default('login'),
-        fields: z.array(loginFormField).min(1),
-        submit_path: z.string().min(1),
-    }),
-    z.object({
-        shape: z.literal('button'),
-        id: z.string().min(1),
-        label: z.string().min(1),
-        icon: z.string().optional(),
-        href: z.string().min(1),
-    }),
-]);
+export const loginMethod = openapi.loginMethodsListing.shape.methods.element;
 /**
  * `GET /api/login/methods` (PUBLIC). `needs_setup: true` ⇒ no principal exists
  * yet, so the deployment must be initialized through the setup door before anyone
  * can sign in. `setup_login` names the login-credential kinds the setup door can
- * attach the owner's login with; it is `null`/absent when no login-attaching
- * accounts provider is configured (a keys-only deployment). Non-strict — the
- * skeleton may grow additive fields.
+ * attach the owner's login with; it is `null` when no login-attaching accounts
+ * provider is configured (a keys-only deployment). `claim_fragment_key` names the
+ * URL-fragment key a claim link carries its token under.
  */
-export const loginMethods = z.object({
-    methods: z.array(loginMethod),
-    needs_setup: z.boolean(),
-    setup_login: z
-        .object({ kinds: z.array(z.enum(['password', 'invite'])) })
-        .nullable()
-        .optional(),
-});
+export const loginMethods = openapi.loginMethodsListing;
 /**
  * A successful login/exchange: the minted session token (opaque, `tai-sess-`
  * prefixed — the client treats it as an opaque string) + its user.
  */
-export const loginResult = z.object({
-    token: z.string().min(1),
-    user_id: z.string().min(1),
-});
+export const loginResult = openapi.claimExchangeResult;
 //# sourceMappingURL=login.js.map

package/dist/schemas/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/schemas/login.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IACvD,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACrD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACxB,CAAC;CACH,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACxB,WAAW,EAAE,CAAC;SACX,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3B,CAAC,CAAC"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/schemas/login.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC"}

package/dist/schemas/manifest-mcp.d.ts

@@ -12,7 +12,8 @@ export declare const connectorRef: z.ZodObject<{
 }, z.core.$strip>;
 export type ConnectorRef = z.infer<typeof connectorRef>;
 /**
- * One entry of the live manifest's MCP section. Only the `managed` provenance
+ * One entry of the live manifest's MCP section, hand-typed: the spec publishes an entry as
+ * an open object. Only the `managed` provenance
  * marker is typed — the connect/disconnect flows write it server-side to point a
  * connector-owned entry back at its connection, and the editor renders such
  * entries read-only. `.nullish()` because a hand-authored entry carries `null`
@@ -29,6 +30,7 @@ export declare const manifestMcpEntry: z.ZodObject<{
 }, z.core.$loose>;
 export type ManifestMcpEntry = z.infer<typeof manifestMcpEntry>;
 export declare const manifestView: z.ZodObject<{
+    user_tools: z.ZodArray<z.ZodString>;
     mcp: z.ZodArray<z.ZodObject<{
         managed: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             connection_id: z.ZodString;
@@ -36,7 +38,6 @@ export declare const manifestView: z.ZodObject<{
             sub_service: z.ZodString;
         }, z.core.$strip>>>;
     }, z.core.$loose>>;
-    user_tools: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 /**
  * One `!ENV ${VAR[:default]}` marker the manifest's MCP section carries
@@ -48,76 +49,101 @@ export declare const manifestView: z.ZodObject<{
  * a false red. The checklist derives from THIS alone — no env value is ever fetched.
  */
 export declare const mcpEnvRef: z.ZodObject<{
-    var: z.ZodString;
-    pointer: z.ZodString;
     has_default: z.ZodBoolean;
+    pointer: z.ZodString;
     set: z.ZodBoolean;
+    var: z.ZodString;
 }, z.core.$strip>;
 export type McpEnvRef = z.infer<typeof mcpEnvRef>;
 export declare const mcpEnvRefs: z.ZodArray<z.ZodObject<{
-    var: z.ZodString;
-    pointer: z.ZodString;
     has_default: z.ZodBoolean;
+    pointer: z.ZodString;
     set: z.ZodBoolean;
+    var: z.ZodString;
 }, z.core.$strip>>;
 export type McpEnvRefs = z.infer<typeof mcpEnvRefs>;
 /**
  * The apply result every config-writer mutation returns (`POST /api/mcp-config`,
  * `POST /api/config/env`): the serving worker's local reload result (`status` +
- * `env_keys`) plus the mode-wrapped fleet fan-out of the reload it broadcast. The
- * `fanout` is parsed EXPLICITLY so the shared fleet-report handler can surface a
- * failed propagation — zod's unknown-key stripping would otherwise hide it. A drift
- * throws `ApiSchemaError`.
+ * `env_keys`), the mode-wrapped fleet fan-out of the reload it broadcast, `recycle` — the
+ * fleet recycle roll an env change carrying a recycle-class key ran (`null` when it carried
+ * none) — and `awaiting_respawn`, the workers (name + keys) still awaiting a respawn after
+ * it, empty when its roll converged. The `fanout` is hand-typed (the spec publishes it as
+ * one object with optional fields) so the shared fleet-report handler can surface a failed
+ * propagation. A drift throws `ApiSchemaError`.
  */
 export declare const reloadConfigResult: z.ZodObject<{
-    status: z.ZodString;
+    awaiting_respawn: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        keys: z.ZodArray<z.ZodString>;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
     env_keys: z.ZodNumber;
+    recycle: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        fresh: z.ZodArray<z.ZodObject<{
+            generation: z.ZodNumber;
+            kind: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        recycle: z.ZodArray<z.ZodObject<{
+            detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            generation_before: z.ZodNumber;
+            kind: z.ZodString;
+            name: z.ZodString;
+            status: z.ZodString;
+        }, z.core.$strip>>;
+        recycle_stopped: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            detail: z.ZodString;
+            kind: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    status: z.ZodString;
     fanout: z.ZodDiscriminatedUnion<[z.ZodObject<{
         mode: z.ZodLiteral<"local-only">;
         note: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        local_only: z.ZodDefault<z.ZodBoolean>;
         op: z.ZodString;
-        reachable: z.ZodBoolean;
-        local_only: z.ZodBoolean;
-        results: z.ZodArray<z.ZodObject<{
+        reachable: z.ZodDefault<z.ZodBoolean>;
+        results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             outcome: z.ZodEnum<{
-                failed: "failed";
                 applied: "applied";
-                resyncing: "resyncing";
-                recycling: "recycling";
-                stale: "stale";
+                failed: "failed";
                 missing: "missing";
                 departed: "departed";
                 timed_out: "timed_out";
+                resyncing: "resyncing";
+                recycling: "recycling";
+                stale: "stale";
             }>;
-            payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-            error: z.ZodNullable<z.ZodString>;
-            detail: z.ZodNullable<z.ZodString>;
-        }, z.core.$strip>>;
-        error: z.ZodNullable<z.ZodString>;
+            payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+        }, z.core.$strip>>>;
         mode: z.ZodLiteral<"fleet">;
     }, z.core.$strip>, z.ZodObject<{
+        error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        local_only: z.ZodDefault<z.ZodBoolean>;
         op: z.ZodString;
-        reachable: z.ZodBoolean;
-        local_only: z.ZodBoolean;
-        results: z.ZodArray<z.ZodObject<{
+        reachable: z.ZodDefault<z.ZodBoolean>;
+        results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            detail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             name: z.ZodString;
             outcome: z.ZodEnum<{
-                failed: "failed";
                 applied: "applied";
-                resyncing: "resyncing";
-                recycling: "recycling";
-                stale: "stale";
+                failed: "failed";
                 missing: "missing";
                 departed: "departed";
                 timed_out: "timed_out";
+                resyncing: "resyncing";
+                recycling: "recycling";
+                stale: "stale";
             }>;
-            payload: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-            error: z.ZodNullable<z.ZodString>;
-            detail: z.ZodNullable<z.ZodString>;
-        }, z.core.$strip>>;
-        error: z.ZodNullable<z.ZodString>;
+            payload: z.ZodDefault<z.ZodNullable<z.ZodUnknown>>;
+        }, z.core.$strip>>>;
         mode: z.ZodLiteral<"unreachable">;
     }, z.core.$strip>], "mode">;
 }, z.core.$strip>;