@maudecode/talaria-web-contracts 1.21.0 → 1.22.0

package/dist/views.js

@@ -1,3 +1,5 @@
+import { DelegationSettingsSchema } from './delegation.js';
+import { PlanGaugeSchema, PlanUsageSchema, ModelAllowanceSchema, ModelSectionsSchema } from './plan-usage.js';
 import { McpCostPolicySchema } from './mcp-cost-policy.js';
 /**
  * Pinned response shapes shared by every consumer (formerly the frontend's
@@ -11,7 +13,7 @@ import { RunStatusSchema } from './run-status.js';
 import { AgentRefreshConfirmationSchema, AgentUpdateOperationSchema } from './sidecar/runtime.js';
 import { SpeedTierSchema } from './speed.js';
 import { ExecutionModeSchema, OwnerAttachmentSchema, MessageReactionViewSchema } from './gateway-session.js';
-import { KanbanInspectionNodeSchema, KanbanInspectionSnapshotSchema, CanonicalBotChatSchema, GatewayModeSchema, PluginOAuthClientSchema, PluginSettingFieldSchema, SkillCatalogIdentitySchema } from './sidecar/namespaces.js';
+import { NousAccountSchema, KanbanInspectionNodeSchema, KanbanInspectionSnapshotSchema, CanonicalBotChatSchema, GatewayModeSchema, PluginOAuthClientSchema, PluginSettingFieldSchema, SkillCatalogIdentitySchema } from './sidecar/namespaces.js';
 export { SpeedTierSchema } from './speed.js';
 const Json = z.unknown();
 export const NullableString = z.string().nullable();
@@ -21,6 +23,7 @@ export const UnixSeconds = z.number();
 // ── sessions ─────────────────────────────────────────────────────────────
 export const SessionIdSchema = z.string().regex(/^[A-Za-z0-9_.:-]{1,128}$/, 'invalid session id');
 export const AttachmentSchema = z.looseObject({
+    download_url: z.string().startsWith('/api/groups/file?').optional(),
     filename: z.string().optional(), name: z.string().optional(), path: z.string().optional(), size: z.number().optional(), mime: z.string().optional(), is_image: z.boolean().optional(), rollback_token: z.string().optional(),
 });
 /** The server's display class for a tool call: clients map it to an icon and localized verb, and never classify names themselves. */
@@ -195,8 +198,10 @@ export const MessageSchema = z.looseObject({
         review_state: BackgroundReviewStateSchema.optional(),
     }).optional(),
     /**
-     * TAL-305: a marker the Agent wrote around context compaction, not a message anyone typed. Clients render a collapsed
-     * card with a localized title per kind and the body on expansion: `_marker_body` when sent, else `content`.
+     * TAL-305: a marker around context compaction, not a message anyone typed. Clients render a collapsed line with a
+     * localized title per kind and the body on expansion: `_marker_body` when sent, else `content`. TAL-1566: each compaction
+     * Web runs is one row in its place, with role `marker` and a stable `message_id`, display-only and excluded from model
+     * history; it is never a turn's prompt or reply.
      */
     _marker_kind: z.enum(['context_compaction', 'preserved_task_list']).optional(),
     /** TAL-305: a preserved task list's card body, without its marker line. */
@@ -283,15 +288,6 @@ const IsMessagingSessionSchema = z.boolean().describe('`source_kind` is `messagi
  * the folder name (TAL-303). Null without a workspace; absent from an older server, where clients show no label.
  */
 const WorkspaceNameSchema = NullableString.optional();
-/**
- * TAL-560: the "Context compaction · Reference only" card, on payloads that carry `messages`. Clients render `text` after
- * the row at full-transcript index `after_message_index` (row `after_message_index - _messages_offset` of `messages`), or
- * above the loaded rows when it is null or before them. Null: no card.
- */
-export const CompressionReferenceSchema = z.object({
-    text: z.string(),
-    after_message_index: z.number().int().nonnegative().nullable().describe('The full-transcript index of the row the card follows; null puts it above the transcript.'),
-});
 /** TAL-454: the chat a `/branch` copied, with its redacted title. */
 export const BranchedFromSchema = z.object({ session_id: SessionIdSchema, title: z.string() });
 export const MAX_SOURCE_REFERENCES = 5;
@@ -303,8 +299,20 @@ export const SourceReferenceSchema = z.object({
 export const AcceptedSourceReferenceSchema = SourceReferenceSchema.extend({ title: z.string() });
 /** Full session record from `GET /api/session` and mutations returning `session`. */
 export const SessionActivityPhaseSchema = z.enum(['starting', 'running', 'waiting_for_approval', 'waiting_for_input', 'completed', 'failed', 'cancelled', 'stale']);
+/** Raw rows remain for older clients; current clients render only the server-normalized display items. */
+export const TodoItemSchema = z.looseObject({ id: z.union([z.string(), z.number()]).optional(), text: z.string().optional(), content: z.string().optional(), title: z.string().optional(), status: z.string().optional(), done: z.boolean().optional(), completed: z.boolean().optional() });
+export const TodoStateSchema = z.looseObject({
+    display_items: z.array(z.object({ id: z.union([z.string(), z.number()]).optional(), text: z.string(), state: z.enum(['pending', 'in_progress', 'completed', 'cancelled']) })).optional(),
+    total_count: z.number().int().nonnegative().optional(), completed_count: z.number().int().nonnegative().optional(),
+    pending_count: z.number().int().nonnegative().optional(), in_progress_count: z.number().int().nonnegative().optional(), cancelled_count: z.number().int().nonnegative().optional(),
+    session_id: z.string().optional(), todos: z.array(TodoItemSchema).optional(), summary: z.record(z.string(), z.unknown()).optional(),
+    version: z.number().optional(), ts: z.number().optional(), source: z.string().optional(), description: z.string().optional(),
+});
 export const SessionSchema = z.looseObject({
+    plan_gauge: PlanGaugeSchema.nullable().optional(),
+    show_reasoning: z.boolean().optional().describe('Server-resolved display preference. Hidden reasoning is omitted from live events, history and activity scenes; older servers omit this field.'),
     activity_phase: SessionActivityPhaseSchema.optional(),
+    todo_state: TodoStateSchema.optional(),
     source_references: z.array(AcceptedSourceReferenceSchema).optional(),
     context_detail_key: z.string().nullable().optional().describe('Opaque identity for open-only context details; changes with owner epoch, model and context.'),
     composer_state_key: z.string().optional().describe('Opaque profile-home and owner identity for device-local composer state; never an API session id.'),
@@ -340,11 +348,14 @@ export const SessionSchema = z.looseObject({
     /** The agent's display name: a named profile's own name, else the `bot_name` setting (TAL-458). */
     assistant_name: z.string().optional(),
     workspace_name: WorkspaceNameSchema,
-    compression_reference: CompressionReferenceSchema.nullable().optional(),
     focus_path: NullableString.optional().describe('TAL-1458: the last non-null `focus_path` of the session\'s persisted tool calls, so a reopened chat shows its file before any stream event; null when none.'),
     branched_from: BranchedFromSchema.nullable().optional().describe('TAL-454: the chat this one was branched from while it still loads (archived included); null for a compression continuation, a deleted or missing parent, and every other chat.'),
 });
 export const SessionEnvelopeSchema = z.looseObject({ session: SessionSchema });
+/** TAL-1534: the sidebar group a listed row belongs to; `pinned` rows come first in the canonical order. */
+export const SidebarGroupKindSchema = z.enum(['pinned', 'recent']);
+/** One group present in a session list, with its English caption; clients localize the known kinds. */
+export const SidebarGroupSchema = z.object({ kind: SidebarGroupKindSchema, title: z.string() });
 /** Sidebar row from `GET /api/sessions`. */
 export const SessionRowSchema = z.looseObject({
     session_id: SessionIdSchema, title: z.string(), workspace: z.string().optional(), model: NullableString.optional(), created_at: UnixSeconds.optional(), updated_at: UnixSeconds.optional(), last_message_at: NullableNumber.optional(),
@@ -353,6 +364,7 @@ export const SessionRowSchema = z.looseObject({
     source_tag: NullableString.optional(), source_label: NullableString.optional(), session_source: NullableString.optional(), raw_source: NullableString.optional(), parent_session_id: NullableString.optional(),
     active_stream_id: ActiveStreamIdSchema, share_token: NullableString.optional(), share_url: NullableString.optional(), worktree_branch: NullableString.optional(), match_type: z.enum(['title', 'metadata', 'content']).optional(), match_preview: NullableString.optional(),
     workspace_name: WorkspaceNameSchema,
+    sidebar_group: SidebarGroupKindSchema.nullable().optional().describe('TAL-1534: the sidebar group `GET /api/sessions` files the row under; null for an archived row. Other routes omit it.'),
     ...ContextUsageFields,
 });
 /**
@@ -368,6 +380,7 @@ export const SessionsListSchema = z.looseObject({
     // TAL-482: sidebar counts for the "Scheduled sessions" / "Webhook sessions" groups; `_truncated` means more exist than are listed.
     scheduled_session_count: z.number().int().nonnegative(), scheduled_sessions_truncated: z.boolean(),
     webhook_session_count: z.number().int().nonnegative(), webhook_sessions_truncated: z.boolean(),
+    sidebar_groups: z.array(SidebarGroupSchema).describe('TAL-1534: the groups the unarchived `sessions` rows fill, in display order; a client captions only these.'),
     agent_storage: AgentStorageSchema.describe('Agent session storage health; a degraded state explains an empty or missing Agent session list.'),
     archived_limit: z.number().int().nullable().optional(), archived_offset: z.number().int().optional(),
 });
@@ -376,7 +389,7 @@ export const SessionStatusSchema = z.looseObject({
     session_id: SessionIdSchema, title: z.string().optional(), active_stream_id: ActiveStreamIdSchema, active_turn_origin: ActiveTurnOriginSchema, agent_running: IsStreamingSchema, is_streaming: IsStreamingSchema, read_only: ReadOnlySchema, read_only_reason: ReadOnlyReasonSchema, owner_attachment: OwnerAttachmentSchema.optional(), message_count: z.number().optional(), model: NullableString.optional(),
     profile: NullableString.optional(), workspace: z.string().optional(), input_tokens: z.number().optional(), output_tokens: z.number().optional(), total_tokens: z.number().optional(), estimated_cost: NullableNumber.optional(), updated_at: UnixSeconds.optional(),
 });
-export const SessionUsageSchema = z.looseObject({ input_tokens: z.number().optional(), output_tokens: z.number().optional(), total_tokens: z.number().optional(), estimated_cost: NullableNumber.optional(), model: NullableString.optional() });
+export const SessionUsageSchema = z.looseObject({ plan_gauge: PlanGaugeSchema.nullable().optional(), input_tokens: z.number().optional(), output_tokens: z.number().optional(), total_tokens: z.number().optional(), estimated_cost: NullableNumber.optional(), model: NullableString.optional() });
 export const ProjectSchema = z.looseObject({ project_id: z.string(), name: z.string(), color: z.string().nullable().optional(), profile: NullableString.optional(), created_at: z.number().optional() });
 export const ProjectsSchema = z.looseObject({ projects: z.array(ProjectSchema), active_profile: z.string(), all_profiles: z.boolean(), other_profile_count: z.number().int() });
 export const SessionDeleteResultSchema = z.looseObject({ ok: z.literal(true), state_db_cleanup_failed: z.boolean().optional() });
@@ -547,13 +560,15 @@ export const QuotaThresholdsSchema = z.object({
     pace_warning_burn_rate_percent: z.number().int().min(100).max(300), pace_critical_burn_rate_percent: z.number().int().min(100).max(400), pace_minimum_elapsed_hours: z.number().int().min(0).max(72),
 });
 export const LoginResponseSchema = z.looseObject({ ok: z.literal(true), message: z.string().optional() });
+/** TAL-1569: Talaria Web update channels, in display order. Nightly is a daily snapshot of the Experimental artifact. */
+export const WebUpdateChannelSchema = z.enum(['stable', 'nightly', 'experimental']);
 export const SettingsSchema = z.looseObject({
     bot_name: z.string().optional(), default_model: z.string().optional(), default_workspace: z.string().optional(), language: z.string().optional(), send_key: z.string().optional(), font_size: z.string().optional(),
     full_width_chat: z.boolean().optional(), chat_width: z.enum(['comfortable', 'wide', 'full']).optional(), auto_scroll_follow: z.boolean().optional(), render_user_markdown: z.boolean().optional(), chat_activity_display_mode: z.string().optional(), default_message_mode: z.string().optional(),
     fade_text_effect: z.boolean().optional(), hidden_tabs: z.array(z.string()).optional(), composer_control_order: z.array(z.string()).optional(), show_cli_sessions: z.boolean().optional(), show_claude_code_sessions: z.boolean().optional(),
     show_cron_sessions: z.boolean().optional(), show_webhook_sessions: z.boolean().optional(), show_kanban_sessions: z.boolean().optional(), check_for_updates: z.boolean().optional(), summarize_updates_automatically: z.boolean().optional(), ignore_agent_updates: z.boolean().optional(),
     auth_enabled: z.boolean().optional(), password_auth_enabled: z.boolean().optional(), password_env_var: z.boolean().optional(), passkeys_enabled: z.boolean().optional(), passwordless_enabled: z.boolean().optional(),
-    auth_disabled_acknowledged: z.boolean().optional(), webui_version: z.string().optional(), agent_version: z.string().optional(), update_channel: z.string().optional(), agent_update_channel: z.enum(['stable', 'experimental']).optional(), update_channel_version: NullableString.optional(),
+    auth_disabled_acknowledged: z.boolean().optional(), webui_version: z.string().optional(), agent_version: z.string().optional(), update_channel: z.string().optional(), update_channels: z.array(WebUpdateChannelSchema).optional().describe('TAL-1569: the Web update channels this server offers, in display order.'), agent_update_channel: z.enum(['stable', 'experimental']).optional(), update_channel_version: NullableString.optional(),
     max_tokens: NullableNumber.optional(), max_tokens_effective: NullableNumber.optional(), max_tokens_fallback: NullableNumber.optional(), tts_engine: z.string().optional(), tts_voice: z.string().optional(),
     dictation_append: z.boolean().optional(), persisted_speech_keys: z.array(z.string()).optional(),
     /** TAL-279: ask before opening external chat links; `trusted_link_hosts` are exact, server-normalized hostnames that skip the ask. */
@@ -583,6 +598,7 @@ export const QuotaLevelSchema = z.enum(['healthy', 'warning', 'critical', 'stale
  * TAL-807: `limit` is present while the provider's credential pool cannot serve this model until `resets_at` (ISO-8601 UTC).
  */
 export const ModelEntrySchema = z.looseObject({
+    allowance: ModelAllowanceSchema.optional(),
     id: z.string(), label: z.string().optional(), provider: z.string().optional(), provider_id: z.string().optional(), bare_id: z.string().optional(), supports_fast_tier: z.boolean().optional(), supported_speed_tiers: z.array(SpeedTierSchema).optional(),
     limit: z.object({ scope: z.literal('model'), resets_at: z.string() }).optional(),
 });
@@ -598,6 +614,7 @@ export const ModelGroupLimitSchema = z.discriminatedUnion('scope', [
  */
 export const CatalogAvailabilitySchema = z.object({ status: z.enum(['available', 'stale', 'unavailable']), authoritative: z.boolean(), unavailable_reason: NullableString, generation: z.string().min(1).describe('Opaque source generation; cached data from another generation must never be merged.') });
 export const ModelGroupSchema = z.looseObject({
+    plan_usage: PlanUsageSchema.nullable().optional(), plan_stale: z.boolean().optional(), sections: ModelSectionsSchema.optional(),
     availability: CatalogAvailabilitySchema.optional(),
     provider: z.string(), provider_id: z.string().optional(), models: z.array(ModelEntrySchema), extra_models: z.array(ModelEntrySchema).optional(),
     limit: ModelGroupLimitSchema.optional(), quota_level: QuotaLevelSchema.optional(),
@@ -615,6 +632,7 @@ export const KeySourceKindSchema = z.enum(['env', 'oauth', 'config', 'pool', 'pl
 export const ProviderSchema = z.looseObject({
     id: z.string(), display_name: z.string().optional(), has_key: z.boolean().optional(), configured: z.boolean().optional(), configurable: z.boolean().optional(), is_oauth: z.boolean().optional(), is_plugin_provider: z.boolean().optional(), is_self_hosted: z.boolean().optional(),
     is_custom: z.boolean().optional(), key_source: z.string().optional(), base_url: NullableString.optional(), auth_error: NullableString.optional(), env_var: NullableString.optional(), models: z.array(ModelEntrySchema).optional(), models_total: z.number().optional(),
+    nous_account: NousAccountSchema.nullable().optional(), nous_account_error: NullableString.optional(),
     is_active: z.boolean().optional(), key_source_kind: KeySourceKindSchema.nullable().optional(), removable: z.boolean().optional(),
 });
 export const ProvidersSchema = z.looseObject({ availability: CatalogAvailabilitySchema.optional(), providers: z.array(ProviderSchema), active_provider: NullableString.optional() });
@@ -642,6 +660,7 @@ export const QuotaWindowSchema = z.looseObject({
 });
 const QuotaWindowIndex = z.number().int().nullable().optional();
 export const QuotaSourceSchema = z.looseObject({
+    plan_usage: PlanUsageSchema.nullable().optional(), plan_stale: z.boolean().optional(),
     computed_at: z.string().optional().describe('Original reference time of this source, retained with stale windows.'),
     source_id: z.string(), provider_id: z.string().optional(), provider_label: z.string().optional(), account_label: z.string().optional(), status: z.string().optional(), supported: z.boolean().optional(), message: z.string().nullable().optional(),
     is_active_provider: z.boolean().optional(), quota: Json.optional(), windows: z.array(QuotaWindowSchema).optional(), balances: Json.optional(), plan: Json.optional(), details: Json.optional(), unavailable_reason: Json.optional(), retry_after: Json.optional(), fetched_at: Json.optional(),
@@ -651,6 +670,7 @@ export const QuotaSourceSchema = z.looseObject({
 });
 /** An account-usage provider's normalised snapshot on `/api/provider/quota` (the same windows and indexes as a quotas source). */
 export const QuotaAccountLimitsSchema = z.looseObject({
+    plan_usage: PlanUsageSchema.nullable().optional(), plan_stale: z.boolean().optional(),
     available: z.boolean().optional(), stale: z.boolean().optional(), title: z.string().optional(), plan: Json.optional(), unavailable_reason: NullableString.optional(),
     windows: z.array(QuotaWindowSchema), details: Json.optional(), fetched_at: NullableString.describe('ISO-8601 UTC.'),
     pace_window_index: QuotaWindowIndex, session_window_index: QuotaWindowIndex, weekly_window_index: QuotaWindowIndex,
@@ -704,7 +724,7 @@ export const AuxiliaryTaskSchema = z.looseObject({
     /** TAL-800: the reasoning effort the slot runs with (the Agent's default until one is saved; `''` = provider default); null when the Agent does not report its slots. */
     reasoning_effort: z.string().nullable(),
 });
-export const AuxiliaryModelsSchema = z.looseObject({ main: z.looseObject({ model: z.string().optional(), provider: z.string().optional(), base_url: z.string().optional(), api_key_set: z.boolean().optional(), service_tier: z.enum(['', 'default', 'priority', 'ultrafast']).optional().describe('Empty string is the Standard value returned by older servers.'), supported_speed_tiers: z.array(SpeedTierSchema).optional() }), tasks: z.array(AuxiliaryTaskSchema) });
+export const AuxiliaryModelsSchema = z.looseObject({ delegation: DelegationSettingsSchema.optional(), main: z.looseObject({ model: z.string().optional(), provider: z.string().optional(), base_url: z.string().optional(), api_key_set: z.boolean().optional(), service_tier: z.enum(['', 'default', 'priority', 'ultrafast']).optional().describe('Empty string is the Standard value returned by older servers.'), supported_speed_tiers: z.array(SpeedTierSchema).optional() }), tasks: z.array(AuxiliaryTaskSchema) });
 export const MaxTokensSchema = z.looseObject({ max_tokens: NullableNumber, max_tokens_effective: NullableNumber, max_tokens_fallback: NullableNumber });
 // ── workspaces, files, git ───────────────────────────────────────────────
 /** A registry entry; `name` is never empty (the folder name when none is registered, `Home` for `default`), so pickers show it as-is (TAL-303). */
@@ -828,7 +848,7 @@ export const UpdateVersionSchema = z.object({
 }).describe('TAL-946: one installable Stable release newer than the installed one.');
 export const UpdateTargetSchema = z.looseObject({
     failed_update: z.object({ version: z.string(), restored_version: z.string() }).optional().describe('Web only: the update that failed before HTTP readiness and the restored package version. Manual retry remains available.'),
-    name: z.string().optional(), channel: z.enum(['stable', 'experimental']).optional(),
+    name: z.string().optional(), channel: WebUpdateChannelSchema.optional(),
     unsupported: z.boolean().optional().describe('Deprecated (TAL-350): `support === \'unchecked\'`, kept for older clients.'),
     support: AgentSupportSchema.optional().describe('Agent target only (TAL-350): `supported` when the target revision is exactly a release in the verified Agent window, else `unchecked`; an `unchecked` apply requires `confirmed_agent_revision`.'),
     support_label: z.string().optional().describe('Agent target only (TAL-946): `support` worded to fit one phone line.'),
@@ -979,7 +999,11 @@ export const ConnectorViewSchema = z.object({
  * so no switch changes them. `sign_in_required` offers Nous sign-in without creating a guest on reads.
  * `rules_error`: why the rules could not be read; every app then reads off (fails closed).
  */
-export const ConnectorsPageSchema = z.object({ available: z.boolean(), sign_in_required: z.boolean().default(false), connectors: z.array(ConnectorViewSchema), policy_revision: z.string().nullable(), rules_error: z.string().nullable() });
+export const ConnectorSignInOfferSchema = z.object({
+    available: z.boolean(), due: z.boolean().describe('The native eligible due check at this read; an already delivered offer remains visible independently.'), visible: z.boolean(), offer_id: z.string().nullable(),
+    actions: z.array(z.enum(['sign_in', 'dismiss'])), refresh_after: z.number().int().positive().nullable(),
+});
+export const ConnectorsPageSchema = z.object({ available: z.boolean(), sign_in_required: z.boolean().default(false), sign_in_offer: ConnectorSignInOfferSchema.optional(), connectors: z.array(ConnectorViewSchema), policy_revision: z.string().nullable(), rules_error: z.string().nullable() });
 /**
  * TAL-818: one app's tools: `enabled`: Hermes may use it (the member rules leave it on and nothing locks it); `locked`: an
  * organization or role rule (by name or tag) keeps it off. `editable`: its switch may change the member rule (readable rules, the app on in them, and no lock).
@@ -1016,8 +1040,6 @@ export const WikiStatusSchema = z.object({
 });
 export const WikiBrowseSchema = z.object({ pages: z.array(z.object({ name: z.string(), path: z.string(), size: z.number().int(), mtime: z.number().int() })) });
 export const WikiPageSchema = z.object({ content: z.string(), path: z.string() });
-export const TodoItemSchema = z.looseObject({ id: z.union([z.string(), z.number()]).optional(), text: z.string().optional(), content: z.string().optional(), title: z.string().optional(), status: z.string().optional(), done: z.boolean().optional(), completed: z.boolean().optional() });
-export const TodoStateSchema = z.looseObject({ session_id: z.string().optional(), todos: z.array(TodoItemSchema).optional(), summary: z.record(z.string(), z.unknown()).optional(), version: z.number().optional(), ts: z.number().optional(), source: z.string().optional(), description: z.string().optional(), pending_count: z.number().optional() });
 // ── onboarding ───────────────────────────────────────────────────────────
 /** `oauth_flow` (TAL-398): `device_code` when the provider signs in through `/api/onboarding/oauth/*` instead of taking an API key; `oauth_label` then names the account to sign in with, and `signed_in` says whether the profile already holds its credential. */
 export const OnboardingProviderSchema = z.looseObject({ id: z.string(), name: z.string().optional(), label: z.string().optional(), kind: z.string().optional(), oauth: z.boolean().optional(), needs_key: z.boolean().optional(), base_url: NullableString.optional(), models: z.array(Json).optional(), category: z.string().optional(), default_model: z.string().optional(), oauth_flow: z.literal('device_code').nullable().optional(), oauth_label: z.string().optional(), signed_in: z.boolean().optional() });
@@ -1036,6 +1058,7 @@ export const OnboardingProbeSchema = z.looseObject({ ok: z.boolean().optional(),
  * `user_code`, `verification_url`, `expires_in` and `interval` (seconds between polls) come with the start.
  */
 export const OnboardingOAuthSchema = z.looseObject({
+    nous_account: NousAccountSchema.nullable().optional(),
     ok: z.boolean().optional(), status: z.string().optional(), url: z.string().optional(), verification_url: z.string().optional(), user_code: z.string().optional(), message: z.string().optional(),
     error: z.string().nullable().optional(), flow_id: z.string().optional(), provider: z.string().optional(), expires_in: z.number().int().optional(), interval: z.number().int().optional(),
     /**