@signalcore/ui 1.0.0-beta.0 → 1.0.0-beta.2

package/src/contract.ts

@@ -0,0 +1,1720 @@
+// The contract's schemas as types. Generated by v3/clients/generate.py from v3/api/openapi.json. Do not edit.
+
+/** What the agent says about itself. */
+export interface About {
+  summary: string;
+  does: Array<Does>;
+  asks: Array<string>;
+  icon?: "sparkle" | "calendar" | "headset" | "message" | "phone" | "mail" | "cart" | "card" | "chart" | "megaphone" | "wrench" | "briefcase" | "heart" | "user" | "search" | "file" | "globe" | "code" | "map" | null;
+}
+
+/** Qué puede: the agent's own words (None until written) and the facts they rest on. */
+export interface AboutOut {
+  about: About | null;
+  about_at: string | null;
+  facts: Facts;
+}
+
+export interface ActionCount {
+  name: string;
+  count: number;
+}
+
+/** One action as an agent has it: where it comes from, whether it is on and asks first. */
+export interface ActionRowOut {
+  name: string;
+  description: string;
+  destructive: boolean;
+  input_schema?: Record<string, unknown>;
+  source: "default" | "library" | "own";
+  on: boolean;
+  needs_approval: boolean;
+}
+
+export interface ActivityOut {
+  kind?: "conversation";
+  conversation_id: string;
+  agent_id: string;
+  title: string | null;
+  last: LastSaid | null;
+  origin: "person" | "automation";
+  automation: AutomationGlance | null;
+  channel?: ChannelGlance | null;
+  contact?: ContactGlance | null;
+  test?: boolean;
+  started_at: string;
+  last_at: string;
+  outcome: "running" | "done" | "failed" | "waiting" | "handed" | "ignored";
+  error: string | null;
+  actions: Array<ActionCount>;
+  handover?: HandoverOut | null;
+  decision?: SchemasDecisionOut | null;
+}
+
+export interface ActivityPage {
+  items: Array<ActivityOut | RunEntryOut>;
+  next: string | null;
+}
+
+/** An automation with its agent, as the agents' page draws it. */
+export interface AgentAutomationOut {
+  id: string;
+  name: string;
+  kind: "schedule" | "webhook" | "event" | "platform";
+  title: string;
+  summary: string;
+  schedule: string | null;
+  timezone: string | null;
+  app: string | null;
+  event: string | null;
+  config: Record<string, unknown>;
+  url: string | null;
+  say: string;
+  on: boolean;
+  last_run_at: string | null;
+  next_run_at: string | null;
+  agent_id: string;
+}
+
+/** What an agent is up to, at a glance: what the agents' page draws on its lane. */
+export interface AgentGlance {
+  agent_id: string;
+  automations: number;
+  paused: number;
+  next_run_at: string | null;
+  apps: Array<AppGlance>;
+  tables: number;
+  keys: number;
+  files: number;
+  conversations_today: number;
+  with_person: number;
+}
+
+export interface AgentIn {
+  name: string;
+  role?: string;
+  description?: string;
+  instructions?: string;
+  model?: string | null;
+  icon?: "sparkle" | "calendar" | "headset" | "message" | "phone" | "mail" | "cart" | "card" | "chart" | "megaphone" | "wrench" | "briefcase" | "heart" | "user" | "search" | "file" | "globe" | "code" | "map" | null;
+}
+
+export interface AgentOut {
+  id: string;
+  name: string;
+  role: string;
+  description: string;
+  instructions: string;
+  model: string;
+  actions: Array<string>;
+  needs_approval: Array<string>;
+  approvals?: Record<string, "never" | "person" | "business">;
+  access: Record<string, unknown>;
+  icon: "sparkle" | "calendar" | "headset" | "message" | "phone" | "mail" | "cart" | "card" | "chart" | "megaphone" | "wrench" | "briefcase" | "heart" | "user" | "search" | "file" | "globe" | "code" | "map" | null;
+  about_at: string | null;
+  is_builder: boolean;
+  voice: Voice;
+  timezone: string;
+  packages: Packages;
+  connects?: Connects;
+  switches?: Array<Switchable>;
+  template_id?: string | null;
+  template_version?: number | null;
+  managed?: Array<string>;
+  created_at: string;
+}
+
+/** Only what is sent changes. */
+export interface AgentPatchIn {
+  name?: string | null;
+  role?: string | null;
+  description?: string | null;
+  instructions?: string | null;
+  model?: string | null;
+  icon?: "sparkle" | "calendar" | "headset" | "message" | "phone" | "mail" | "cart" | "card" | "chart" | "megaphone" | "wrench" | "briefcase" | "heart" | "user" | "search" | "file" | "globe" | "code" | "map" | null;
+  actions?: Array<string> | null;
+  needs_approval?: Array<string> | null;
+  approvals?: Record<string, unknown> | null;
+  access?: Record<string, unknown> | null;
+  voice?: VoicePatch | null;
+  timezone?: string | null;
+  packages?: Packages | null;
+  connects?: Connects | null;
+  switches?: Array<Switchable> | null;
+}
+
+export interface ApiOut {
+  source: string | null;
+  title: string;
+  servers: Array<string>;
+  base_url: string | null;
+  header: string | null;
+  operations: Array<OperationOut>;
+  skipped: Array<string>;
+  secret?: string | null;
+}
+
+/** Only what is sent changes: the operations picked (each one a tool, the rest none), the base URL, and the header secret (`null`: the signature alone). */
+export interface ApiPatchIn {
+  picked?: Array<string> | null;
+  base_url?: string | null;
+  header?: HeaderIn | null;
+}
+
+/** An app an agent uses, as a map draws it. */
+export interface AppGlance {
+  name: string;
+  provider: string;
+  toolkit: string;
+  title: string;
+  status: string;
+  icon: string | null;
+}
+
+/** How the widget looks: each unset field keeps the widget's own default (the page's type and ink, neutral greys). Colours are `#rrggbb`; sizes are pixels within what reads well. */
+export interface Appearance {
+  accent?: string | null;
+  accent_fg?: string | null;
+  font?: "Inter" | "Manrope" | "DM Sans" | "Plus Jakarta Sans" | "Poppins" | "Nunito" | "Lora" | "Playfair Display" | null;
+  radius?: number | null;
+  theme?: "auto" | "light" | "dark";
+  position?: "right" | "left";
+  launcher_size?: number | null;
+  panel_width?: number | null;
+  panel_height?: number | null;
+  header?: boolean;
+  css?: string | null;
+}
+
+export interface AuthorizeIn {
+  return_url?: string;
+}
+
+/** One of an agent's automations, drawn as the platform has it: its trigger, its steps and what each uses, how it stands, its newest runs. Read-only: the owner switches it on the agent's page, or with a button beside it. */
+export interface AutomationBlock {
+  type: "automation";
+  agent: string;
+  name: string;
+}
+
+export interface AutomationDetailOut {
+  id: string;
+  agent_id: string;
+  name: string;
+  title: string;
+  summary: string;
+  trigger: TriggerView;
+  on: boolean;
+  next_run_at: string | null;
+  steps: Array<Step>;
+  board: Board | null;
+  state: "active" | "paused" | "failing";
+  last_run: RunOut | null;
+  runs: Array<RunOut>;
+}
+
+/** The automation that started a conversation, as its entry draws it. */
+export interface AutomationGlance {
+  id: string;
+  kind: string;
+  title: string;
+  app: string | null;
+  provider: string | null;
+  icon: string | null;
+}
+
+export interface AutomationOut {
+  id: string;
+  agent_id: string;
+  name: string;
+  title: string;
+  summary: string;
+  trigger: TriggerView;
+  on: boolean;
+  next_run_at: string | null;
+  steps: Array<Step>;
+  board: Board | null;
+  state: "active" | "paused" | "failing";
+  last_run: RunOut | null;
+}
+
+/** What the automation moves: its table's rows counted by the value of one field. */
+export interface Board {
+  table: string;
+  title: string;
+  field: string;
+  counts: Array<Count>;
+}
+
+/** One thing the person can do: pressing it sends `action`, or, with `url`, opens the page (a payment, a document). Two buttons that do different things carry different action names: the name is the whole of what comes back. */
+export interface Button {
+  type: "button";
+  label: string;
+  action?: string | null;
+  url?: string | null;
+  tone?: "primary" | "neutral" | "danger";
+}
+
+/** The call a conversation is (VOICE.md): the owner's in the browser or a phone call, when the worker took it and when it ended, why and how long. */
+export interface CallGlance {
+  id: string;
+  kind: "browser" | "phone";
+  reason: string | null;
+  seconds: number | null;
+  started_at: string | null;
+  ended_at: string | null;
+  recording?: boolean;
+}
+
+/** What the browser joins the call with: LiveKit's address, its token for the room, and the call and conversation (whose live socket shows what is said). */
+export interface CallTokenOut {
+  url: string;
+  token: string;
+  room: string;
+  call_id: string;
+  conversation_id: string;
+}
+
+/** Blocks under a title: one thing, set apart. With `image`, its head starts with it: an app's logo, a product's picture. */
+export interface Card {
+  type: "card";
+  title?: string | null;
+  subtitle?: string | null;
+  image?: string | null;
+  children: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | AutomationBlock | FileBlock>;
+}
+
+/** A page of the apps a search finds. */
+export interface CatalogOut {
+  items: Array<HitOut>;
+  total: number;
+  kinds: Array<KindOut>;
+  provider: string;
+}
+
+/** The channel a conversation is on, as a list draws it. */
+export interface ChannelGlance {
+  id: string;
+  kind: string;
+  name: string;
+}
+
+export interface ChannelOut {
+  id: string;
+  agent_id: string;
+  kind: "whatsapp" | "instagram" | "sms" | "phone" | "web";
+  provider: string;
+  name: string;
+  external_id: string;
+  address: string | null;
+  outbound: boolean;
+  status: "pending" | "active" | "error" | "disconnected";
+  detail: string | null;
+  settings: Settings;
+  web?: WebOut | null;
+  created_at: string;
+}
+
+export interface ChannelPatchIn {
+  agent_id?: string | null;
+  settings?: SettingsPatch | null;
+}
+
+export interface ChannelUsageOut {
+  channel: "whatsapp" | "instagram" | "sms";
+  received: number;
+  sent: number;
+}
+
+/** Figures over a few labels: bars to compare them (by state, by who), a line to follow them in time (by day, by week), the labels in their order. */
+export interface Chart {
+  type: "chart";
+  kind?: "bar" | "line";
+  points: Array<Point>;
+}
+
+export interface ChartPiece {
+  type: "chart";
+  title: string;
+  kind?: "bar" | "line";
+  query: Measure;
+}
+
+/** Pick one of a few, at once: picking sends `action` with `{"option": id}`. With `other`, a last row takes an answer in the person's own words instead: `{"text": words}`. */
+export interface Choice {
+  type: "choice";
+  options: Array<Option>;
+  action: string;
+  other?: boolean;
+}
+
+export interface CodePreview {
+  kind: "code";
+  text: string;
+  truncated: boolean;
+  language: string;
+}
+
+export interface Column {
+  field: string;
+  label: string;
+}
+
+export interface ConnectIn {
+  name: string;
+  provider?: "arcade" | "composio" | null;
+  toolkit: string;
+  return_url?: string;
+}
+
+export interface ConnectedOut {
+  channel: ChannelOut;
+  warnings: Array<string>;
+}
+
+export interface ConnectionOut {
+  id: string;
+  name: string;
+  provider: string;
+  toolkit: string;
+  title: string;
+  status: string;
+  created_at: string;
+  url?: string | null;
+  icon?: string | null;
+}
+
+/** One thing the app can do, as the owner picks which to give an agent; its input as the provider describes it (JSON Schema), for the technical view. */
+export interface ConnectionsActionOut {
+  name: string;
+  description: string;
+  read_only: boolean;
+  input_schema?: Record<string, unknown>;
+}
+
+/** The apps an agent may connect itself, from a conversation (`connect_app`), as its owner limits them: which (of these kinds, or these apps of the catalog), whose (the person it talks with, their own account; the team's, the organization's; or either), what it gets of one once it is connected (every action, those that only read, or none), who gives the yes for the actions that change something (`writes`) and where the person lands once they authorized it (`return_url`). Nothing named, it connects none. */
+export interface Connects {
+  kinds?: Array<string>;
+  toolkits?: Array<string>;
+  whose?: "person" | "team" | "both";
+  gets?: "all" | "reads" | "none";
+  writes?: "never" | "person" | "business";
+  return_url?: string | null;
+}
+
+/** The person a conversation on a channel is with, or a person of a host's page (on no channel). */
+export interface ContactGlance {
+  id: string;
+  name: string | null;
+  address: string;
+  muted?: boolean;
+}
+
+export interface ContactOut {
+  id: string;
+  name: string | null;
+  muted: boolean;
+  opted_out: boolean;
+  created_at: string;
+}
+
+/** The owner marks a contact the agent doesn't answer, or takes the mark away. */
+export interface ContactPatchIn {
+  muted: boolean;
+}
+
+export interface ConversationDetailOut {
+  id: string;
+  agent_id: string;
+  trigger_id: string | null;
+  run_id?: string | null;
+  handled_by: "agent" | "person" | "nobody";
+  handover?: HandoverOut | null;
+  pending: boolean;
+  test: boolean;
+  about_agent_id?: string | null;
+  created_at: string;
+  title?: string | null;
+  channel?: ChannelGlance | null;
+  contact?: ContactGlance | null;
+  reply_due_at?: string | null;
+  last_inbound_at?: string | null;
+  call?: CallGlance | null;
+  person?: PersonOut | null;
+  messages: Array<MessageOut>;
+  handovers?: Array<HandoverOut>;
+}
+
+export interface ConversationFileOut {
+  id: string;
+  name: string;
+  media_type: string;
+  size: number;
+  conversation_id: string;
+  created_at: string;
+}
+
+/** A new conversation; `test` when the owner tries the agent out, which no customer sees and is never its activity. With the builder, `about` names the agent it is about (its id): the builder works on that agent alone in it; without, it is a general one until the builder makes or changes an agent in it, which it is then about. */
+export interface ConversationIn {
+  test?: boolean;
+  about?: string | null;
+}
+
+export interface ConversationOut {
+  id: string;
+  agent_id: string;
+  trigger_id: string | null;
+  run_id?: string | null;
+  handled_by: "agent" | "person" | "nobody";
+  handover?: HandoverOut | null;
+  pending: boolean;
+  test: boolean;
+  about_agent_id?: string | null;
+  created_at: string;
+  title?: string | null;
+  channel?: ChannelGlance | null;
+  contact?: ContactGlance | null;
+  reply_due_at?: string | null;
+  last_inbound_at?: string | null;
+  call?: CallGlance | null;
+  person?: PersonOut | null;
+}
+
+/** A conversation for its technical view: how its last turn ended, and every message raw. */
+export interface ConversationRawOut {
+  id: string;
+  agent_id: string;
+  trigger_id: string | null;
+  run_id?: string | null;
+  handled_by: "agent" | "person" | "nobody";
+  handover?: HandoverOut | null;
+  pending: boolean;
+  test: boolean;
+  about_agent_id?: string | null;
+  created_at: string;
+  title?: string | null;
+  channel?: ChannelGlance | null;
+  contact?: ContactGlance | null;
+  reply_due_at?: string | null;
+  last_inbound_at?: string | null;
+  call?: CallGlance | null;
+  person?: PersonOut | null;
+  outcome: "done" | "failed" | null;
+  error: string | null;
+  last_at: string;
+  messages: Array<RawMessageOut>;
+}
+
+export interface Count {
+  value: string;
+  count: number;
+}
+
+export interface DashboardOut {
+  id: string;
+  name: string;
+  title: string;
+  blocks: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece>;
+  created_at: string;
+  updated_at: string;
+}
+
+/** A dashboard rendered: its blocks as the kit draws them, filled from the rows now. */
+export interface DashboardView {
+  id: string;
+  title: string;
+  blocks: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | AutomationBlock | FileBlock>;
+  rendered_at: string;
+}
+
+/** The business's yes (`approve`) or no on the call a conversation waits on for it. */
+export interface DecisionIn {
+  request: string;
+  approve: boolean;
+}
+
+/** A tool as it is declared; `secret`, the organization's tool secret, when this declaration made it (its first server tool): shown here, never again. */
+export interface DeclaredOut {
+  name: string;
+  description: string;
+  input_schema: Record<string, unknown>;
+  mode: "server" | "client" | "api";
+  url: string | null;
+  method: string | null;
+  path: string | null;
+  asks_first: boolean;
+  declared_in: "code" | "app";
+  created_at: string;
+  updated_at: string;
+  secret: string | null;
+}
+
+/** What an automation is: its name (its file's), title, whom it serves, its trigger's kind and what an instance gives it, by name and type. */
+export interface DefinitionOut {
+  id: string;
+  name: string;
+  title: string;
+  audience: "business" | "contact";
+  kind: "schedule" | "webhook" | "event" | "platform" | "instruction";
+  inputs: Record<string, string>;
+  created_at: string;
+}
+
+/** One event told to one endpoint, and how its tries went: `queued` (not tried yet), `delivered`, `retrying` (its last try failed; it is tried again later), `dead` (given up). */
+export interface DeliveryOut {
+  id: string;
+  event_id: string;
+  type: "message.created" | "conversation.holder_changed" | "inbox.item_created" | "run.finished" | "run.failed" | "call.ended" | "channel.status_changed" | "approval.requested";
+  status: "queued" | "delivered" | "retrying" | "dead";
+  attempts: number;
+  response_code: number | null;
+  error: string | null;
+  created_at: string;
+  delivered_at: string | null;
+  event: Record<string, unknown>;
+}
+
+/** A host's deploy: the fields of the agent's spec it owns, as they are now (`spec`, any of `spec.AgentSpec`'s: its files and tools whole, each one named then owned); with none, the agent is published as it is. */
+export interface DeployIn {
+  spec?: Record<string, unknown> | null;
+}
+
+export interface Divider {
+  type: "divider";
+}
+
+export interface DocumentPreview {
+  kind: "document";
+  html: string;
+  truncated: boolean;
+}
+
+/** One automation, as the owner reads it. */
+export interface Does {
+  automation: string;
+  text: string;
+  when: string;
+}
+
+export interface Entry {
+  id: string;
+  title: string;
+  subtitle?: string | null;
+  meta?: string | null;
+  image?: string | null;
+}
+
+/** Something that can happen in a connected app, that an automation can start an agent on. */
+export interface EventTypeOut {
+  name: string;
+  title: string;
+  description: string;
+  config: Record<string, unknown>;
+}
+
+/** An agent as a person's page shows it: who it is, its mark, and whether it takes calls. */
+export interface FaceOut {
+  id: string;
+  name: string;
+  role: string;
+  icon: "sparkle" | "calendar" | "headset" | "message" | "phone" | "mail" | "cart" | "card" | "chart" | "megaphone" | "wrench" | "briefcase" | "heart" | "user" | "search" | "file" | "globe" | "code" | "map" | null;
+  voice: FaceVoiceOut;
+}
+
+export interface FaceVoiceOut {
+  enabled: boolean;
+}
+
+export interface FactAsk {
+  agent_id: string;
+  name: string;
+}
+
+/** An automation; one on an app's event also with its app's provider, name and mark, which the others leave out, as they always have. */
+export interface FactAutomation {
+  id: string;
+  name: string;
+  kind: "schedule" | "webhook" | "event" | "platform";
+  title: string;
+  summary: string;
+  schedule: string | null;
+  timezone: string | null;
+  app: string | null;
+  event: string | null;
+  config: Record<string, unknown>;
+  url: string | null;
+  say: string;
+  on: boolean;
+  last_run_at: string | null;
+  next_run_at: string | null;
+  provider?: string | null;
+  app_title?: string | null;
+  icon?: string | null;
+}
+
+export interface FactChannel {
+  kind: "whatsapp" | "instagram" | "sms" | "phone" | "web";
+  name: string;
+  status: string;
+}
+
+/** An app it was given: the app's name and mark, and its tools, with their names for people (`titles`) and as the model calls them (`called`: `gmail__Gmail_SendEmail`), each by the tool's own. */
+export interface FactConnection {
+  name: string;
+  provider: "composio" | "arcade";
+  toolkit: string;
+  title: string;
+  status: string;
+  actions: Array<string>;
+  titles: Record<string, string>;
+  called: Record<string, string>;
+  icon: string | null;
+}
+
+export interface FactDevice {
+  kind: "extension" | "installer";
+  name: string;
+  status: string;
+}
+
+export interface FactFile {
+  path: string;
+  size: number;
+  searchable: boolean;
+  shared: boolean;
+}
+
+export interface FactKey {
+  name: string;
+  hosts: Array<string>;
+  shared: boolean;
+}
+
+export interface FactTable {
+  table: string;
+  can: Array<string>;
+  title: string | null;
+}
+
+/** What the agent has, as the app draws it. Every list is here from day one; the ones whose phase hasn't come are empty, and their shape is fixed so the renderer never changes. */
+export interface Facts {
+  actions: Array<ActionRowOut>;
+  automations: Array<FactAutomation>;
+  connections: Array<FactConnection>;
+  channels: Array<FactChannel>;
+  files: Array<FactFile>;
+  memories: Array<MemoryOut>;
+  vault: Array<FactKey>;
+  data: Array<FactTable>;
+  asks: Array<FactAsk>;
+  devices: Array<FactDevice>;
+}
+
+export interface FieldDef {
+  name: string;
+  type: "text" | "number" | "boolean" | "date" | "datetime" | "money" | "choice" | "contact";
+  required?: boolean;
+  options?: Array<string> | null;
+}
+
+export interface FieldOut {
+  name: string;
+  type: "text" | "number" | "boolean" | "date" | "datetime" | "money" | "choice" | "contact";
+  required?: boolean;
+  options?: Array<string> | null;
+  read_only?: boolean;
+}
+
+/** Label and value pairs: a summary a person reads at a glance. */
+export interface Fields {
+  type: "fields";
+  items: Array<Item>;
+}
+
+/** A file put in front of the person as it is: a document, a sheet, a deck, a picture, a video, a PDF, to open and to save. The agent names one it may read: one of its files or the organization's by its path, or one of the conversation's by its id (`cvf_…`). Showing it puts it in the conversation (`shown.py`), and the API fills in `file`, that file of the conversation's, before the surface is shown or kept. */
+export interface FileBlock {
+  type: "file";
+  path: string;
+  title?: string | null;
+}
+
+export interface FileContentOut {
+  path: string;
+  size: number;
+  updated_at: string | null;
+  content: string;
+}
+
+export interface FileIn {
+  content: string;
+}
+
+/** Where a file of a conversation plays from, until `expires_at`: a path under the API's root, as a client prefixes its own. */
+export interface FileLinkOut {
+  path: string;
+  expires_at: string;
+}
+
+/** A file of the conversation as a message shows it; its bytes are at `GET /conversations/{id}/files/{file_id}`. */
+export interface FileRef {
+  id: string;
+  name: string;
+  media_type: string;
+  size: number;
+}
+
+export interface FilesFileOut {
+  id: string;
+  path: string;
+  media_type: string;
+  size: number;
+  searchable: boolean;
+  index: IndexOut | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface FolderFileOut {
+  path: string;
+  size: number;
+  updated_at: string | null;
+}
+
+/** Fields to fill; sending them sends `action` with the values by field name: words, a number, true or false, a date as "YYYY-MM-DD", a time as "HH:MM", a moment as "YYYY-MM-DDTHH:MM", a list of option ids for a `multiselect`, the files picked for a `file` (which the agent then sees). */
+export interface Form {
+  type: "form";
+  fields: Array<FormField>;
+  submit?: string | null;
+  action: string;
+}
+
+/** One thing to fill: its name (what its value comes back under), its label, its control. */
+export interface FormField {
+  kind: "text" | "textarea" | "email" | "phone" | "url" | "number" | "date" | "time" | "datetime" | "select" | "multiselect" | "checkbox" | "range" | "rating" | "secret" | "file";
+  placeholder?: string | null;
+  help?: string | null;
+  options?: Array<Option> | null;
+  min?: number | null;
+  max?: number | null;
+  step?: number | null;
+  unit?: string | null;
+  dates?: Array<string> | null;
+  earliest?: string | null;
+  latest?: string | null;
+  times?: Array<string> | null;
+  accept?: Array<string> | null;
+  multiple?: boolean | null;
+  max_mb?: number | null;
+  name: string;
+  label?: string | null;
+  required?: boolean;
+  value?: string | number | boolean | Array<string> | null;
+}
+
+export interface HTTPValidationError {
+  detail?: Array<ValidationError>;
+}
+
+/** A change of who answers a conversation: to whom, why, who set it and when. */
+export interface HandoverOut {
+  holder: "agent" | "person" | "nobody";
+  reason: string;
+  by: string;
+  title: string | null;
+  at: string;
+}
+
+/** A static secret every call carries, in the header the host reads it from. */
+export interface HeaderIn {
+  name: string;
+  value: string;
+}
+
+/** A passage found: its file, where it is in it (in words, and as its parts: first and last page, sheet, first and last row, section) and its text. */
+export interface Hit {
+  path: string;
+  location: string;
+  text: string;
+  pages: Array<number> | null;
+  sheet: string | null;
+  rows: Array<number> | null;
+  section: string | null;
+}
+
+/** An app of the catalog, as a person picking one reads it. */
+export interface HitOut {
+  toolkit: string;
+  name: string;
+  description: string;
+  events: boolean;
+  icon: string | null;
+  kind: string | null;
+  tools: number | null;
+  connected: string | null;
+}
+
+/** The owner says who answers a conversation now: the agent (given back), a person of the business (the agent paused there) or nobody (ignored), and why. */
+export interface HolderIn {
+  holder: "agent" | "person" | "nobody";
+  reason?: string;
+}
+
+/** The week, in the agent's time zone: each day's stretches, in order and apart; a day left out, or empty, is closed. */
+export interface Hours {
+  mon?: Array<Span>;
+  tue?: Array<Span>;
+  wed?: Array<Span>;
+  thu?: Array<Span>;
+  fri?: Array<Span>;
+  sat?: Array<Span>;
+  sun?: Array<Span>;
+}
+
+export interface Image {
+  type: "image";
+  url: string;
+  alt: string;
+  caption?: string | null;
+}
+
+/** The document, by its URL or pasted; the base URL its calls go to, when not the first of its `servers`. */
+export interface ImportIn {
+  url?: string | null;
+  document?: string | null;
+  base_url?: string | null;
+}
+
+/** How far a searchable file's index is: `indexing`, `ready` or `failed`; what to know of it (why it failed, what of it can't be searched); how many of its pages had no text and were read by the model. */
+export interface IndexOut {
+  state: "indexing" | "ready" | "failed";
+  detail: string | null;
+  scanned: number;
+}
+
+/** What Instagram's login sent the person back with, and the page it sent them to. */
+export interface InstagramIn {
+  agent_id: string;
+  code: string;
+  redirect_uri: string;
+}
+
+export interface Item {
+  label: string;
+  value: string;
+}
+
+export interface ItemOut {
+  id: string;
+  kind: "notice" | "handoff" | "failed" | "waiting" | "unanswered";
+  agent_id: string;
+  agent_name: string;
+  conversation_id: string | null;
+  run_id?: string | null;
+  text: string;
+  title?: string | null;
+  read: boolean;
+  created_at: string;
+}
+
+export interface KindOut {
+  id: string;
+  count: number;
+}
+
+/** A conversation's newest words, on one line, and who said them. */
+export interface LastSaid {
+  text: string;
+  by: "person" | "agent";
+}
+
+export interface ListPiece {
+  type: "list";
+  title: string;
+  item: string;
+  subtitle?: string | null;
+  meta?: string | null;
+  query: Rows;
+}
+
+/** Things in a column, each a title with a line under it, maybe a picture and a detail at its right. With `action`, picking one sends it with `{"item": id}`. */
+export interface Listing {
+  type: "list";
+  items: Array<Entry>;
+  action?: string | null;
+}
+
+/** An agent made from the template, in one of the organizations it manages. */
+export interface MadeOut {
+  org_id: string;
+  org_name: string;
+  agent_id: string;
+  version: number;
+  overrides: Array<string>;
+}
+
+/** An endpoint as it is made: the only time `secret` is shown. */
+export interface MadeWebhookOut {
+  id: string;
+  url: string;
+  events: Array<"message.created" | "conversation.holder_changed" | "inbox.item_created" | "run.finished" | "run.failed" | "call.ended" | "channel.status_changed" | "approval.requested">;
+  created_at: string;
+  secret: string;
+}
+
+export interface ManagedOrgIn {
+  name: string;
+  templates?: Array<string>;
+}
+
+export interface ManagedOrgOut {
+  id: string;
+  name: string;
+  kind: "agency" | "business" | "developer";
+  parent_org_id?: string | null;
+  slug?: string | null;
+  created_at: string;
+  agents?: Array<AgentOut>;
+}
+
+/** A figure over the rows that pass `where`: their count, or the sum, average, least or most of one field (`of`); with `by`, one figure per value of that field, or per day, week or month of it with `every` (a date, or `created_at`). */
+export interface Measure {
+  table: string;
+  where?: Array<Where>;
+  measure?: "count" | "sum" | "average" | "min" | "max";
+  of?: string | null;
+  by?: string | null;
+  every?: "day" | "week" | "month" | null;
+}
+
+export interface MediaPreview {
+  kind: "image" | "video" | "audio";
+  media_type: string;
+}
+
+/** A line about them, and the agent of the organization it is kept by. */
+export interface MemoryIn {
+  text: string;
+  agent_id: string;
+}
+
+export interface MemoryOut {
+  id: string;
+  agent_id: string;
+  contact_id?: string | null;
+  text: string;
+  created_at: string;
+}
+
+/** Words in a conversation, files of it (`POST /conversations/{id}/files` first) by id, or both; `wait` to be answered when the turn ends, with the agent's reply. */
+export interface MessageIn {
+  text?: string;
+  files?: Array<string>;
+  wait?: boolean;
+}
+
+export interface MessageOut {
+  id: string;
+  role: "user" | "assistant";
+  text: string;
+  action: Record<string, unknown> | null;
+  steps: Array<StepOut>;
+  files?: Array<FileRef>;
+  author?: "contact" | "agent" | "operator" | null;
+  delivery?: "queued" | "sent" | "delivered" | "read" | "failed" | null;
+  delivery_error?: string | null;
+  pieces?: Array<string> | null;
+  sent_parts?: number | null;
+  voice?: FileRef | null;
+  heard?: string | null;
+  decision?: SchemasDecisionOut | null;
+  created_at: string;
+}
+
+export interface ModelOut {
+  id: string;
+  label: string;
+}
+
+/** A line that stands out: what the person should notice. */
+export interface Note {
+  type: "note";
+  tone: "info" | "success" | "warning" | "danger";
+  text: string;
+}
+
+export interface NotePiece {
+  type: "note";
+  tone?: "info" | "success" | "warning" | "danger";
+  text: string;
+}
+
+export interface OperationOut {
+  id: string;
+  method: string;
+  path: string;
+  tag: string | null;
+  summary: string;
+  input_schema: Record<string, unknown>;
+  tool: string | null;
+}
+
+/** A person of the business writes in a conversation on a channel: words, files of the conversation (`POST /conversations/{id}/files` first) by id, or both. */
+export interface OperatorIn {
+  text?: string;
+  files?: Array<string>;
+}
+
+export interface Option {
+  id: string;
+  label: string;
+  hint?: string | null;
+}
+
+/** What changes of the organization: its name, its kind (not a customer's: always a business). */
+export interface OrgChange {
+  name?: string | null;
+  kind?: "agency" | "business" | "developer" | null;
+}
+
+export interface OrgOut {
+  id: string;
+  name: string;
+  kind: "agency" | "business" | "developer";
+  parent_org_id?: string | null;
+  slug?: string | null;
+  created_at: string;
+}
+
+export interface OriginsIn {
+  origins: Array<string>;
+}
+
+/** The number's SIP login at its provider (Zadarma's panel, its SIP connection), for the agent's calls out; the provider's SIP host, Zadarma's unless told. */
+export interface OutboundIn {
+  username: string;
+  password: string;
+  host?: string;
+}
+
+/** What an agent's own code needs besides the platform, installed exactly as declared (`environments.py`): Debian packages (`apt`: ffmpeg, poppler-utils) and Python requirements (`pip`: openpyxl==3.1.5, pinned so a new release never changes what runs). The manifest checks each (`manifest.read_packages`). */
+export interface Packages {
+  apt?: Array<string>;
+  pip?: Array<string>;
+}
+
+export interface PdfPreview {
+  kind: "pdf";
+  pages: number | null;
+}
+
+/** Who a conversation is with (`people`). */
+export interface PersonOut {
+  kind: "host_person" | "visitor" | "contact" | "owner";
+  external_id: string;
+  name: string | null;
+  email: string | null;
+}
+
+/** The business's number, kept at its provider (Zadarma, its own Twilio, a PBX), in international form. */
+export interface PhoneIn {
+  agent_id: string;
+  number: string;
+}
+
+export interface Point {
+  label: string;
+  value: number;
+}
+
+export interface PreviewSheet {
+  name: string;
+  columns: Array<string> | null;
+  rows: Array<Array<string>>;
+  total_rows: number;
+}
+
+export interface PreviewSlide {
+  title: string | null;
+  text: string;
+  notes: string | null;
+}
+
+/** A message as it was stored: its blocks as the model saw or said them (a file's bytes and a thinking block's signature left out), and what the model reported the reply cost. */
+export interface RawMessageOut {
+  id: string;
+  seq: number;
+  role: "user" | "assistant";
+  content: Array<Record<string, unknown>>;
+  usage: Record<string, unknown> | null;
+  created_at: string;
+}
+
+/** What was said, as stored, and how the turn stands: `running` (it hasn't ended yet: read the conversation later), `done`, `waiting` (on `waiting`) or `failed` (`error`); `replies`, what the agent said since; `waiting`, every call the conversation waits on (a yes the business gives may wait while the turn is done). */
+export interface ReplyOut {
+  conversation_id: string;
+  message: MessageOut;
+  status: "running" | "done" | "waiting" | "failed";
+  replies: Array<MessageOut>;
+  waiting: Array<WaitOut>;
+  error: TurnErrorOut | null;
+}
+
+export interface RowIn {
+  values: Record<string, unknown>;
+}
+
+export interface RowOut {
+  id: string;
+  values: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+/** The rows that pass `where`, the newest first unless `order` says another field. */
+export interface Rows {
+  table: string;
+  where?: Array<Where>;
+  order?: string | null;
+  descending?: boolean;
+  limit?: number;
+}
+
+export interface RunDetailOut {
+  id: string;
+  agent_id: string;
+  automation: string;
+  title: string;
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  conversation_id: string | null;
+  status: "running" | "waiting" | "done" | "failed" | "skipped";
+  summary: string | null;
+  error: string | null;
+  dry: boolean;
+  started_at: string;
+  ended_at: string | null;
+  tokens_in: number;
+  tokens_out: number;
+  opened: Array<string>;
+  decision?: RunsDecisionOut | null;
+  steps: Array<RunStepOut>;
+}
+
+/** A run of an automation, as the activity lists it. */
+export interface RunEntryOut {
+  id: string;
+  agent_id: string;
+  automation: string;
+  title: string;
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  conversation_id: string | null;
+  status: "running" | "waiting" | "done" | "failed" | "skipped";
+  summary: string | null;
+  error: string | null;
+  dry: boolean;
+  started_at: string;
+  ended_at: string | null;
+  tokens_in: number;
+  tokens_out: number;
+  opened: Array<string>;
+  decision?: RunsDecisionOut | null;
+  kind?: "run";
+  last_at: string;
+}
+
+export interface RunOut {
+  id: string;
+  agent_id: string;
+  automation: string;
+  title: string;
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  conversation_id: string | null;
+  status: "running" | "waiting" | "done" | "failed" | "skipped";
+  summary: string | null;
+  error: string | null;
+  dry: boolean;
+  started_at: string;
+  ended_at: string | null;
+  tokens_in: number;
+  tokens_out: number;
+  opened: Array<string>;
+  decision?: RunsDecisionOut | null;
+}
+
+export interface RunStepOut {
+  seq: number;
+  step: string | null;
+  call: string;
+  input: unknown;
+  output: unknown;
+  error: string | null;
+  ms: number;
+  at: string;
+  would: boolean;
+}
+
+/** What a handler decided of a message (`sc.answer`, `sc.hold`, `sc.ignore`). */
+export interface RunsDecisionOut {
+  kind: "answer" | "hold" | "ignore";
+  reason: string;
+}
+
+/** One of the actions the platform ships, as the app lists them; its input as the model gets it (JSON Schema), for the technical view. */
+export interface SchemasActionOut {
+  name: string;
+  description: string;
+  destructive: boolean;
+  input_schema?: Record<string, unknown>;
+}
+
+/** What was decided of a contact's message (`handlers`): by the channel's filter, the agent answers it or not this time (`skip`); by the agent's own handlers (`@sc.on`), it answers, or the conversation goes to a person (`hold`) or to nobody (`ignore`); `deciding` while they go. */
+export interface SchemasDecisionOut {
+  kind: "deciding" | "answer" | "skip" | "hold" | "ignore";
+  reason: string | null;
+  automation: string | null;
+  title: string | null;
+  run_id: string | null;
+}
+
+export interface SecretIn {
+  value: string;
+  hosts?: Array<string>;
+}
+
+export interface SecretOut {
+  name: string;
+  hosts: Array<string>;
+  created_at: string;
+}
+
+export interface Settings {
+  answers?: boolean;
+  filter?: string | null;
+  filter_keywords?: Array<string>;
+  hours?: Hours | null;
+  answers_when?: "in_hours" | "out_of_hours";
+  away_message?: string | null;
+  groups?: boolean;
+  auto_release_after_h?: number | null;
+  instructions?: string | null;
+  reply_delay_s?: number;
+  split?: boolean;
+  typing?: boolean;
+  window_template?: string | null;
+  voice_replies?: "never" | "when_voice" | "always";
+}
+
+/** Only what is sent changes; `null` clears what may be none (`filter`, `hours`, `away_message`, `auto_release_after_h`, `instructions`, `window_template`). */
+export interface SettingsPatch {
+  answers?: boolean | null;
+  filter?: string | null;
+  filter_keywords?: Array<string> | null;
+  hours?: Hours | null;
+  answers_when?: "in_hours" | "out_of_hours" | null;
+  away_message?: string | null;
+  groups?: boolean | null;
+  auto_release_after_h?: number | null;
+  instructions?: string | null;
+  reply_delay_s?: number | null;
+  split?: boolean | null;
+  typing?: boolean | null;
+  window_template?: string | null;
+  voice_replies?: "never" | "when_voice" | "always" | null;
+}
+
+/** What the browser needs to start each channel's flow on this server; None where the server doesn't have it. */
+export interface SetupOut {
+  whatsapp: Record<string, string> | null;
+  instagram: Record<string, string> | null;
+  sms: boolean;
+  phone: boolean;
+}
+
+export interface SheetPreview {
+  kind: "sheet";
+  sheets: Array<PreviewSheet>;
+  truncated: boolean;
+}
+
+export interface SlidesPreview {
+  kind: "slides";
+  slides: Array<PreviewSlide>;
+  truncated: boolean;
+}
+
+/** A stretch of a day, from one time to a later one; `24:00` ends it at midnight. */
+export interface Span {
+  start: string;
+  end: string;
+}
+
+/** Blocks laid out together: down, or across (wrapping on a narrow screen; stats, cards and buttons side by side). */
+export interface Stack {
+  type: "stack";
+  direction?: "column" | "row";
+  children: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | AutomationBlock | FileBlock>;
+}
+
+/** One number that matters, under its label, with a line of context (a change, a goal). */
+export interface Stat {
+  type: "stat";
+  label: string;
+  value: string;
+  hint?: string | null;
+  tone?: "info" | "success" | "warning" | "danger" | null;
+}
+
+export interface StatPiece {
+  type: "stat";
+  label: string;
+  query: Measure;
+  hint?: string | null;
+}
+
+export interface Step {
+  name: string;
+  uses: Array<Use>;
+}
+
+/** The connected app an action belongs to, as its step shows it: its name and its logo (an https address; none when the provider has none). */
+export interface StepApp {
+  name: string;
+  icon?: string | null;
+}
+
+/** An action a reply called: what, how it went, and what it drew. */
+export interface StepOut {
+  id: string;
+  action: string;
+  state: "running" | "waiting" | "done" | "failed";
+  output: string | null;
+  surface: Record<string, unknown> | null;
+  awaits: boolean;
+  request: Record<string, unknown> | null;
+  app?: StepApp | null;
+}
+
+export interface SwitchIn {
+  on: boolean;
+}
+
+/** An automation of the organization's an agent may turn on or off in a conversation (`switch_automation`): one of its own, or of the agent it names. */
+export interface Switchable {
+  agent?: string | null;
+  automation: string;
+}
+
+/** Rows under named columns; a row's cells come in the columns' order. */
+export interface Table {
+  type: "table";
+  columns: Array<string>;
+  rows: Array<Array<string>>;
+}
+
+export interface TableIn {
+  name: string;
+  title: string;
+  fields: Array<FieldDef>;
+}
+
+export interface TableOut {
+  name: string;
+  title: string;
+  fields: Array<FieldOut>;
+  id: string;
+  system: boolean;
+  rows: number;
+  created_at: string;
+}
+
+export interface TablePiece {
+  type: "table";
+  title: string;
+  columns: Array<Column>;
+  query: Rows;
+}
+
+/** A contact's subscription: an instance of a definition (`automation`: the business's automation for contacts, by name; None for an instruction), what it gives it (`inputs`: an instruction's words are `inputs.instruction`), when (`schedule`, a cron line in `timezone`, or once at `next_run_at`), whether it is on, its contact, the conversation it runs about and its newest runs. It read as an automation before: those fields stay, deprecated. */
+export interface TaskOut {
+  id: string;
+  agent_id: string;
+  automation: string | null;
+  title: string;
+  inputs: Record<string, unknown>;
+  schedule: string | null;
+  timezone: string | null;
+  on: boolean;
+  next_run_at: string | null;
+  last_run_at: string | null;
+  contact_id: string;
+  conversation_id: string | null;
+  runs: Array<RunOut>;
+  created_at: string;
+  /** @deprecated Kept for the clients that read it. */
+  name: string;
+  /** @deprecated Kept for the clients that read it. */
+  summary: string;
+  /** @deprecated Kept for the clients that read it. */
+  trigger: TriggerView;
+  /** @deprecated Kept for the clients that read it. */
+  steps: Array<Step>;
+  /** @deprecated Kept for the clients that read it. */
+  board: Board | null;
+  /** @deprecated Kept for the clients that read it. */
+  state: "active" | "paused" | "failing";
+  /** @deprecated Kept for the clients that read it. */
+  last_run: RunOut | null;
+}
+
+export interface TeachIn {
+  text: string;
+}
+
+export interface TemplateDetailOut {
+  agent_id: string;
+  version: number;
+  managed: Array<string>;
+  organizations: number;
+  changed: boolean;
+  updated_at: string;
+  agents: Array<MadeOut>;
+}
+
+/** A template to make: its name in the owner's words (`Recordatorio de cita`), what kind of message it is, its language, its words with `{{1}}`, `{{2}}`… where values go, and an example for each value, in order. */
+export interface TemplateIn {
+  name: string;
+  category?: "utility" | "marketing";
+  language?: string;
+  body: string;
+  examples?: Array<string>;
+}
+
+export interface TemplateOut {
+  agent_id: string;
+  version: number;
+  managed: Array<string>;
+  organizations: number;
+  changed: boolean;
+  updated_at: string;
+}
+
+/** Words, as Markdown. */
+export interface Text {
+  type: "text";
+  text: string;
+}
+
+export interface TextPreview {
+  kind: "markdown" | "text" | "json";
+  text: string;
+  truncated: boolean;
+}
+
+export interface TokenIn {
+  agents: Array<string>;
+  external_id: string;
+  name: string;
+  email?: string | null;
+}
+
+export interface TokenOut {
+  token: string;
+  expires_at: string;
+}
+
+export interface ToolIn {
+  description: string;
+  input_schema: Record<string, unknown>;
+  mode: "server" | "client";
+  url?: string | null;
+  asks_first?: boolean;
+}
+
+export interface ToolOut {
+  name: string;
+  description: string;
+  input_schema: Record<string, unknown>;
+  mode: "server" | "client" | "api";
+  url: string | null;
+  method: string | null;
+  path: string | null;
+  asks_first: boolean;
+  declared_in: "code" | "app";
+  created_at: string;
+  updated_at: string;
+}
+
+/** Only what is sent changes: any tool's name, description, input and asking first; how an imported one calls its API stays its document's. */
+export interface ToolPatchIn {
+  name?: string | null;
+  description?: string | null;
+  input_schema?: Record<string, unknown> | null;
+  asks_first?: boolean | null;
+}
+
+/** The organization's tool secret, shown once. */
+export interface ToolSecretOut {
+  secret: string;
+}
+
+/** An automation's trigger as the agent's page reads it today (`GET /agents/{id}/triggers`); the automation itself is `automations.AutomationOut`. */
+export interface TriggerOut {
+  id: string;
+  name: string;
+  kind: "schedule" | "webhook" | "event" | "platform";
+  title: string;
+  summary: string;
+  schedule: string | null;
+  timezone: string | null;
+  app: string | null;
+  event: string | null;
+  config: Record<string, unknown>;
+  url: string | null;
+  say: string;
+  on: boolean;
+  last_run_at: string | null;
+  next_run_at: string | null;
+}
+
+export interface TriggerPatchIn {
+  on: boolean;
+}
+
+export interface TriggerView {
+  kind: "schedule" | "webhook" | "event" | "platform";
+  schedule: string | null;
+  timezone: string | null;
+  url: string | null;
+  app: string | null;
+  app_title: string | null;
+  event: string | null;
+  event_title: string | null;
+  icon: string | null;
+  decides?: boolean;
+  channels?: Array<string>;
+}
+
+export interface TurnErrorOut {
+  code: string;
+  detail: string;
+}
+
+export interface UnknownPreview {
+  kind: "unknown";
+}
+
+export interface UsageOut {
+  org_id: string;
+  from: string;
+  to: string;
+  cost: number;
+  used: Array<UsedOut>;
+  messages: Array<ChannelUsageOut>;
+}
+
+export interface Use {
+  kind: "app" | "ai" | "agent" | "notify" | "send" | "data" | "http";
+  app: string | null;
+  title: string | null;
+  icon: string | null;
+}
+
+export interface UsedOut {
+  kind: string;
+  unit: string;
+  quantity: number;
+  count: number;
+  cost: number;
+  unpriced: number;
+}
+
+export interface ValidationError {
+  loc: Array<string | number>;
+  msg: string;
+  type: string;
+  input?: unknown;
+  ctx?: Record<string, unknown>;
+}
+
+/** How an agent talks on a call (VOICE.md). The defaults are the old product's, in Spanish: its ElevenLabs voice (Carolina, from Spain), up to ten minutes, a goodbye ends it. */
+export interface Voice {
+  language?: string;
+  voice?: VoiceId;
+  first_message?: string;
+  max_duration_s?: number;
+  end_call_phrases?: Array<string>;
+  model?: "claude-haiku-5-5" | "claude-sonnet-5-5";
+  record?: boolean;
+}
+
+/** Who speaks for the agent: a voice of ElevenLabs (by its id there) or of Cartesia. */
+export interface VoiceId {
+  provider: "elevenlabs" | "cartesia";
+  id: string;
+}
+
+/** Only what is sent changes. */
+export interface VoicePatch {
+  language?: string | null;
+  voice?: VoiceId | null;
+  first_message?: string | null;
+  max_duration_s?: number | null;
+  end_call_phrases?: Array<string> | null;
+  model?: "claude-haiku-5-5" | "claude-sonnet-5-5" | null;
+  record?: boolean | null;
+}
+
+/** A call the conversation waits on: a question the person answers on what it drew (`ask`), a yes (`approve`, given by the person on the screen or by the business: `decides`), or what a host's client tool returns in the page (`tool`). */
+export interface WaitOut {
+  id: string;
+  action: string;
+  kind: "ask" | "approve" | "tool";
+  decides: "person" | "business" | null;
+}
+
+/** The agent the widget talks to, and the sites it may be loaded from. */
+export interface WebIn {
+  agent_id: string;
+  origins: Array<string>;
+}
+
+/** A web channel as its panel shows it: the key the snippet carries, the sites, the look. */
+export interface WebOut {
+  key: string;
+  origins: Array<string>;
+  appearance: Appearance;
+}
+
+export interface WebhookIn {
+  url: string;
+  events: Array<"message.created" | "conversation.holder_changed" | "inbox.item_created" | "run.finished" | "run.failed" | "call.ended" | "channel.status_changed" | "approval.requested">;
+}
+
+export interface WebhookOut {
+  id: string;
+  url: string;
+  events: Array<"message.created" | "conversation.holder_changed" | "inbox.item_created" | "run.finished" | "run.failed" | "call.ended" | "channel.status_changed" | "approval.requested">;
+  created_at: string;
+}
+
+/** What Embedded Signup gave the browser: the code (it lives 30 s) and, when Meta's session event named them, the WhatsApp Business Account and the number; `coexistence` for a number kept on the WhatsApp Business app. */
+export interface WhatsAppIn {
+  agent_id: string;
+  code: string;
+  waba_id?: string | null;
+  phone_number_id?: string | null;
+  mode?: "cloud_api" | "coexistence";
+}
+
+/** One filter: the field compared with `value` by `op`. `last_days` keeps the rows whose date falls in the last `value` days; `contains` looks for words in a text. */
+export interface Where {
+  field: string;
+  op?: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "last_days";
+  value: string | number | boolean;
+}
+
+/** What the widget reads as it loads: the agent it talks to, and how it looks. */
+export interface WidgetOut {
+  agent_id: string;
+  agent_name: string;
+  appearance: Appearance;
+}