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

package/src/contract.ts

@@ -60,7 +60,7 @@ export interface ActivityPage {
 export interface AgentAutomationOut {
   id: string;
   name: string;
-  kind: "schedule" | "webhook" | "event" | "platform";
+  kind: "schedule" | "webhook" | "event" | "platform" | "manual" | "after";
   title: string;
   summary: string;
   schedule: string | null;
@@ -171,6 +171,15 @@ export interface AppGlance {
   icon: string | null;
 }
 
+export interface AppRouteOut {
+  app: string;
+  provider: "composio" | "arcade" | "api" | null;
+}
+
+export interface AppToolsIn {
+  tools: Array<string>;
+}
+
 /** 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;
@@ -238,6 +247,20 @@ export interface AutomationOut {
   last_run: RunOut | null;
 }
 
+/** What a host block is for, in a sentence the agent reads, and the JSON Schema of its props: an object's. */
+export interface BlockIn {
+  description: string;
+  schema: Record<string, unknown>;
+}
+
+export interface BlockOut {
+  name: string;
+  description: string;
+  schema: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
 /** What the automation moves: its table's rows counted by the value of one field. */
 export interface Board {
   table: string;
@@ -246,6 +269,38 @@ export interface Board {
   counts: Array<Count>;
 }
 
+/** Cards in columns, a column per stage. With `action`, the person may move a card to another column, which sends `action` with `{"card": id, "column": id}`: the agent then does what moving it means. */
+export interface BoardBlock {
+  type: "board";
+  columns: Array<BoardColumn>;
+  action?: string | null;
+}
+
+/** One card of a board. */
+export interface BoardCard {
+  id: string;
+  title: string;
+  subtitle?: string | null;
+  meta?: string | null;
+}
+
+export interface BoardColumn {
+  id: string;
+  title: string;
+  cards: Array<BoardCard>;
+}
+
+/** The rows as cards in columns, a column per option of a choice (`column`). */
+export interface BoardPiece {
+  type: "board";
+  title: string;
+  item: string;
+  column: string;
+  subtitle?: string | null;
+  meta?: string | null;
+  query: Rows;
+}
+
 /** 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";
@@ -255,6 +310,38 @@ export interface Button {
   tone?: "primary" | "neutral" | "danger";
 }
 
+/** A day's events, or a week's from `start`, at their hours. With `action`, pressing one sends it with `{"event": id}`; one with `url` opens its page instead. */
+export interface Calendar {
+  type: "calendar";
+  span?: "day" | "week";
+  start: string;
+  events: Array<CalendarEvent>;
+  action?: string | null;
+}
+
+/** One thing on a calendar: its title at its time (a day alone: all of it), until `end`, with a line of detail (where, with whom) and a page to open (`url`). */
+export interface CalendarEvent {
+  id: string;
+  title: string;
+  start: string;
+  end?: string | null;
+  detail?: string | null;
+  url?: string | null;
+}
+
+/** The rows whose date (`at`) falls today (`day`) or this week, at their hours: each called by `item`, until `end`, with `detail` under it and `link` (an https address) to open. */
+export interface CalendarPiece {
+  type: "calendar";
+  title: string;
+  span?: "day" | "week";
+  item: string;
+  at: string;
+  end?: string | null;
+  detail?: string | null;
+  link?: string | null;
+  query: Scope;
+}
+
 /** 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;
@@ -281,7 +368,7 @@ export interface 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>;
+  children: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | Calendar | Timeline | BoardBlock | AutomationBlock | FileBlock | HostBlock>;
 }
 
 /** A page of the apps a search finds. */
@@ -365,6 +452,8 @@ export interface ConnectIn {
   provider?: "arcade" | "composio" | null;
   toolkit: string;
   return_url?: string;
+  events?: boolean;
+  actions?: Array<string>;
 }
 
 export interface ConnectedOut {
@@ -382,6 +471,7 @@ export interface ConnectionOut {
   created_at: string;
   url?: string | null;
   icon?: string | null;
+  why?: 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. */
@@ -410,17 +500,43 @@ export interface ContactGlance {
   muted?: boolean;
 }
 
+/** A contact the business knows, by one identity at least. The first of `account`, `phone`, `email`, `instagram` given finds them when they are known already: the same contact comes back, the other identities added unless someone else has them, a name kept when they have none; `fields`, values of the fields the builders added. */
+export interface ContactIn {
+  name?: string | null;
+  account?: string | null;
+  phone?: string | null;
+  email?: string | null;
+  instagram?: string | null;
+  fields?: Record<string, unknown>;
+}
+
 export interface ContactOut {
   id: string;
   name: string | null;
   muted: boolean;
   opted_out: boolean;
   created_at: string;
+  phone?: string | null;
+  email?: string | null;
+  instagram?: string | null;
+  account?: string | null;
+  fields?: Record<string, unknown>;
+  claims?: Record<string, string>;
 }
 
-/** The owner marks a contact the agent doesn't answer, or takes the mark away. */
+/** What the business changes of a contact: the mark that the agent doesn't answer them (`muted`), and the identities they are known by, added (`add`; one another contact has is refused: merge them) and taken away (`remove`; one at least stays). */
 export interface ContactPatchIn {
-  muted: boolean;
+  muted?: boolean | null;
+  add?: Array<IdentityIn>;
+  remove?: Array<IdentityIn>;
+}
+
+/** A contact by one of their identities, as `ContactIn` takes them: the first given finds them. */
+export interface ContactRefIn {
+  account?: string | null;
+  phone?: string | null;
+  email?: string | null;
+  instagram?: string | null;
 }
 
 export interface ConversationDetailOut {
@@ -441,6 +557,9 @@ export interface ConversationDetailOut {
   last_inbound_at?: string | null;
   call?: CallGlance | null;
   person?: PersonOut | null;
+  unread?: number;
+  waiting_on_person?: boolean;
+  read_until?: string | null;
   messages: Array<MessageOut>;
   handovers?: Array<HandoverOut>;
 }
@@ -458,6 +577,9 @@ export interface ConversationFileOut {
 export interface ConversationIn {
   test?: boolean;
   about?: string | null;
+  contact?: string | ContactRefIn | null;
+  title?: string | null;
+  say?: FirstWords | null;
 }
 
 export interface ConversationOut {
@@ -478,6 +600,9 @@ export interface ConversationOut {
   last_inbound_at?: string | null;
   call?: CallGlance | null;
   person?: PersonOut | null;
+  unread?: number;
+  waiting_on_person?: boolean;
+  read_until?: string | null;
 }
 
 /** A conversation for its technical view: how its last turn ended, and every message raw. */
@@ -499,6 +624,9 @@ export interface ConversationRawOut {
   last_inbound_at?: string | null;
   call?: CallGlance | null;
   person?: PersonOut | null;
+  unread?: number;
+  waiting_on_person?: boolean;
+  read_until?: string | null;
   outcome: "done" | "failed" | null;
   error: string | null;
   last_at: string;
@@ -510,6 +638,36 @@ export interface Count {
   count: number;
 }
 
+export interface CustomerOut {
+  org: OrgOut;
+  conversations: number;
+  cost: number;
+  lost: Array<LostChannelOut>;
+  failed: number;
+  approvals: number;
+}
+
+export interface CustomersOut {
+  from: string;
+  to: string;
+  conversations: number;
+  cost: number;
+  customers: Array<CustomerOut>;
+}
+
+/** A dashboard's name, title or blocks changed: only what is sent. */
+export interface DashboardChange {
+  name?: string | null;
+  title?: string | null;
+  blocks?: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece> | null;
+}
+
+export interface DashboardIn {
+  name: string;
+  title: string;
+  blocks: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece>;
+}
+
 export interface DashboardOut {
   id: string;
   name: string;
@@ -523,14 +681,15 @@ export interface DashboardOut {
 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>;
+  blocks: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | Calendar | Timeline | BoardBlock | AutomationBlock | FileBlock | HostBlock>;
   rendered_at: string;
 }
 
-/** The business's yes (`approve`) or no on the call a conversation waits on for it. */
+/** The business's yes (`approve`) or no on a call a conversation waits on for it; with the yes, `input` changes what the call runs with (checked against its action's schema). */
 export interface DecisionIn {
   request: string;
   approve: boolean;
+  input?: Record<string, unknown> | null;
 }
 
 /** 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. */
@@ -555,7 +714,7 @@ export interface DefinitionOut {
   name: string;
   title: string;
   audience: "business" | "contact";
-  kind: "schedule" | "webhook" | "event" | "platform" | "instruction";
+  kind: "schedule" | "webhook" | "event" | "platform" | "manual" | "after" | "instruction";
   inputs: Record<string, string>;
   created_at: string;
 }
@@ -604,6 +763,12 @@ export interface Entry {
   image?: string | null;
 }
 
+/** An error: `code` for your code (`invalid`, `not_found`, `forbidden`, …), `detail` in a sentence; a request that isn't valid names the field first (`scopes.0: …`). */
+export interface ErrorOut {
+  code: string;
+  detail: string;
+}
+
 /** Something that can happen in a connected app, that an automation can start an agent on. */
 export interface EventTypeOut {
   name: string;
@@ -634,7 +799,7 @@ export interface FactAsk {
 export interface FactAutomation {
   id: string;
   name: string;
-  kind: "schedule" | "webhook" | "event" | "platform";
+  kind: "schedule" | "webhook" | "event" | "platform" | "manual" | "after";
   title: string;
   summary: string;
   schedule: string | null;
@@ -774,6 +939,12 @@ export interface FilesFileOut {
   updated_at: string;
 }
 
+/** A conversation's first words: the person's (the agent answers them) or the agent's. */
+export interface FirstWords {
+  text: string;
+  from?: "contact" | "agent";
+}
+
 export interface FolderFileOut {
   path: string;
   size: number;
@@ -811,10 +982,6 @@ export interface FormField {
   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";
@@ -851,12 +1018,34 @@ export interface HitOut {
   kind: string | null;
   tools: number | null;
   connected: string | null;
+  routes?: Array<RouteOut>;
+  route?: "composio" | "arcade" | "api" | null;
+  why?: string;
 }
 
-/** 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. */
+/** A conversation changed: who answers it now, as the business says (the agent, given back; a person of the business, the agent paused there; or nobody, ignored), and why; or its title, which the person it is with may change too. */
 export interface HolderIn {
-  holder: "agent" | "person" | "nobody";
+  holder?: "agent" | "person" | "nobody" | null;
   reason?: string;
+  title?: string | null;
+}
+
+/** One of the host's own blocks, by the name it declared: `props` as its schema says (the API checks them against it), and `text`, the same in words, which a page that doesn't draw it shows instead, as a channel does. */
+export interface HostBlock {
+  type: "host";
+  name: string;
+  props: Record<string, unknown>;
+  text: string;
+}
+
+/** One of the host's own blocks: its `props` as given; with a rows `query`, one block per row, each prop of `fields` taken from that row's field. `text`: the same in words. */
+export interface HostPiece {
+  type: "host";
+  name: string;
+  text: string;
+  props?: Record<string, unknown>;
+  fields?: Record<string, string>;
+  query?: Rows | null;
 }
 
 /** The week, in the agent's time zone: each day's stretches, in order and apart; a day left out, or empty, is closed. */
@@ -870,6 +1059,12 @@ export interface Hours {
   sun?: Array<Span>;
 }
 
+/** One identity of a contact's, of a kind the business gives. */
+export interface IdentityIn {
+  kind: "account" | "phone" | "email" | "instagram";
+  value: string;
+}
+
 export interface Image {
   type: "image";
   url: string;
@@ -914,6 +1109,21 @@ export interface ItemOut {
   title?: string | null;
   read: boolean;
   created_at: string;
+  contact_id?: string | null;
+  requests?: Array<RequestOut>;
+}
+
+export interface KeyOut {
+  id: string;
+  kind: "secret" | "publishable";
+  name: string;
+  prefix: string;
+  scopes: Array<"read" | "write" | "talk" | "admin">;
+  agent_id: string | null;
+  origins: Array<string>;
+  created_at: string;
+  last_used_at: string | null;
+  revoked_at: string | null;
 }
 
 export interface KindOut {
@@ -943,6 +1153,26 @@ export interface Listing {
   action?: string | null;
 }
 
+export interface LostChannelOut {
+  kind: string;
+  name: string;
+}
+
+/** A key as it is made: the only time `key` is shown. */
+export interface MadeKeyOut {
+  id: string;
+  kind: "secret" | "publishable";
+  name: string;
+  prefix: string;
+  scopes: Array<"read" | "write" | "talk" | "admin">;
+  agent_id: string | null;
+  origins: Array<string>;
+  created_at: string;
+  last_used_at: string | null;
+  revoked_at: string | null;
+  key: string;
+}
+
 /** An agent made from the template, in one of the organizations it manages. */
 export interface MadeOut {
   org_id: string;
@@ -1005,11 +1235,17 @@ export interface MemoryOut {
   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. */
+/** The contact merged into this one, by their id: theirs becomes this one's, and they go. */
+export interface MergeIn {
+  from: 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. They are the person's a token speaks for, or the business's; the business's backend may say them as the conversation's contact (`from: "contact"`). The agent's words first are `sc.say`'s, or a new conversation's (`say`). */
 export interface MessageIn {
   text?: string;
   files?: Array<string>;
   wait?: boolean;
+  from?: "contact" | null;
 }
 
 export interface MessageOut {
@@ -1027,6 +1263,8 @@ export interface MessageOut {
   voice?: FileRef | null;
   heard?: string | null;
   decision?: SchemasDecisionOut | null;
+  proactive?: boolean;
+  run_id?: string | null;
   created_at: string;
 }
 
@@ -1139,6 +1377,13 @@ export interface PreviewSlide {
   notes: string | null;
 }
 
+export interface PublishableKeyIn {
+  kind: "publishable";
+  name: string;
+  agent_id: string;
+  origins: Array<string>;
+}
+
 /** 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;
@@ -1149,6 +1394,11 @@ export interface RawMessageOut {
   created_at: string;
 }
 
+/** How far the person it is with read a conversation: up to `until`, or all of it. */
+export interface ReadIn {
+  until?: string | null;
+}
+
 /** 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;
@@ -1159,6 +1409,30 @@ export interface ReplyOut {
   error: TurnErrorOut | null;
 }
 
+/** A call a conversation waits on, as `approval.requested` tells it: its id is the `request` a decision names; `input`, what the agent called it with. */
+export interface RequestOut {
+  id: string;
+  action: string;
+  kind: "ask" | "approve" | "tool";
+  decides: "person" | "business" | null;
+  schema?: Record<string, unknown> | null;
+  input: Record<string, unknown> | null;
+}
+
+/** The way the owner picks for an app over the platform's choice; null gives it back. */
+export interface RouteIn {
+  provider: "composio" | "arcade" | "api" | null;
+}
+
+/** One way to reach an app: its provider and its name there (none for its own API), how many tools it gives, whether it tells of events, and how a person authorizes it. */
+export interface RouteOut {
+  provider: "composio" | "arcade" | "api";
+  toolkit: string | null;
+  tools: number | null;
+  events: boolean;
+  auth: "oauth" | "key" | "none" | null;
+}
+
 export interface RowIn {
   values: Record<string, unknown>;
 }
@@ -1184,7 +1458,7 @@ export interface RunDetailOut {
   agent_id: string;
   automation: string;
   title: string;
-  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test" | "api" | "after";
   conversation_id: string | null;
   status: "running" | "waiting" | "done" | "failed" | "skipped";
   summary: string | null;
@@ -1196,6 +1470,8 @@ export interface RunDetailOut {
   tokens_out: number;
   opened: Array<string>;
   decision?: RunsDecisionOut | null;
+  result?: unknown;
+  contact_id?: string | null;
   steps: Array<RunStepOut>;
 }
 
@@ -1205,7 +1481,7 @@ export interface RunEntryOut {
   agent_id: string;
   automation: string;
   title: string;
-  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test" | "api" | "after";
   conversation_id: string | null;
   status: "running" | "waiting" | "done" | "failed" | "skipped";
   summary: string | null;
@@ -1217,16 +1493,25 @@ export interface RunEntryOut {
   tokens_out: number;
   opened: Array<string>;
   decision?: RunsDecisionOut | null;
+  result?: unknown;
+  contact_id?: string | null;
   kind?: "run";
   last_at: string;
 }
 
+/** A run started by hand: for a contact (their id or an identity) when it works for one, with what the automation declares (`inputs`; a webhook's body), waiting for its end. */
+export interface RunIn {
+  contact?: string | ContactRefIn | null;
+  inputs?: Record<string, unknown>;
+  wait?: boolean;
+}
+
 export interface RunOut {
   id: string;
   agent_id: string;
   automation: string;
   title: string;
-  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test";
+  by: "schedule" | "webhook" | "event" | "platform" | "agent" | "test" | "api" | "after";
   conversation_id: string | null;
   status: "running" | "waiting" | "done" | "failed" | "skipped";
   summary: string | null;
@@ -1238,6 +1523,8 @@ export interface RunOut {
   tokens_out: number;
   opened: Array<string>;
   decision?: RunsDecisionOut | null;
+  result?: unknown;
+  contact_id?: string | null;
 }
 
 export interface RunStepOut {
@@ -1275,11 +1562,22 @@ export interface SchemasDecisionOut {
   run_id: string | null;
 }
 
+export interface Scope {
+  table: string;
+  where?: Array<Where>;
+}
+
 export interface SecretIn {
   value: string;
   hosts?: Array<string>;
 }
 
+export interface SecretKeyIn {
+  kind: "secret";
+  name: string;
+  scopes: Array<"read" | "write" | "talk" | "admin">;
+}
+
 export interface SecretOut {
   name: string;
   hosts: Array<string>;
@@ -1351,7 +1649,7 @@ export interface Span {
 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>;
+  children: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | Calendar | Timeline | BoardBlock | AutomationBlock | FileBlock | HostBlock>;
 }
 
 /** One number that matters, under its label, with a line of context (a change, a goal). */
@@ -1410,6 +1708,13 @@ export interface Table {
   rows: Array<Array<string>>;
 }
 
+/** A table's fields added or changed (by name) and dropped, and its title; what isn't named stays. */
+export interface TableChangeIn {
+  fields?: Array<FieldDef>;
+  drop?: Array<string>;
+  title?: string | null;
+}
+
 export interface TableIn {
   name: string;
   title: string;
@@ -1433,6 +1738,22 @@ export interface TablePiece {
   query: Rows;
 }
 
+export interface TableVerbsIn {
+  can: Array<"find" | "add" | "update">;
+  contact?: string | null;
+}
+
+/** A contact subscribed to one of the agent's automations for contacts, as the agent's `schedule_task` subscribes the person it talks with: what it takes (`inputs`), and when, a cron line (`cron`, on `timezone`, the agent's when not given) or once (`at`). */
+export interface TaskIn {
+  contact: string;
+  automation: string;
+  inputs?: Record<string, unknown>;
+  title?: string | null;
+  cron?: string | null;
+  at?: string | null;
+  timezone?: string | null;
+}
+
 /** 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;
@@ -1509,6 +1830,33 @@ export interface TextPreview {
   truncated: boolean;
 }
 
+/** Dated things, one under another, the newest first. */
+export interface Timeline {
+  type: "timeline";
+  items: Array<TimelineItem>;
+}
+
+/** One thing on a timeline: what happened (or will) and when, a line about it, and where it stands: `status` in a word, `tone` its mark. */
+export interface TimelineItem {
+  id?: string | null;
+  at: string;
+  title: string;
+  text?: string | null;
+  status?: string | null;
+  tone?: "info" | "success" | "warning" | "danger" | null;
+}
+
+/** The rows by a date (`at`), the newest first: each called by `item`, with `text` under it and `status`, where it stands, in a word. */
+export interface TimelinePiece {
+  type: "timeline";
+  title: string;
+  item: string;
+  at: string;
+  text?: string | null;
+  status?: string | null;
+  query: Rows;
+}
+
 export interface TokenIn {
   agents: Array<string>;
   external_id: string;
@@ -1560,7 +1908,7 @@ export interface ToolSecretOut {
 export interface TriggerOut {
   id: string;
   name: string;
-  kind: "schedule" | "webhook" | "event" | "platform";
+  kind: "schedule" | "webhook" | "event" | "platform" | "manual" | "after";
   title: string;
   summary: string;
   schedule: string | null;
@@ -1580,7 +1928,7 @@ export interface TriggerPatchIn {
 }
 
 export interface TriggerView {
-  kind: "schedule" | "webhook" | "event" | "platform";
+  kind: "schedule" | "webhook" | "event" | "platform" | "manual" | "after";
   schedule: string | null;
   timezone: string | null;
   url: string | null;
@@ -1591,6 +1939,7 @@ export interface TriggerView {
   icon: string | null;
   decides?: boolean;
   channels?: Array<string>;
+  after?: string | null;
 }
 
 export interface TurnErrorOut {
@@ -1627,12 +1976,37 @@ export interface UsedOut {
   unpriced: number;
 }
 
-export interface ValidationError {
-  loc: Array<string | number>;
-  msg: string;
-  type: string;
-  input?: unknown;
-  ctx?: Record<string, unknown>;
+/** A view's name, title or blocks changed: only what is sent. */
+export interface ViewChange {
+  name?: string | null;
+  title?: string | null;
+  blocks?: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece | CalendarPiece | TimelinePiece | BoardPiece | HostPiece> | null;
+}
+
+export interface ViewIn {
+  name: string;
+  title: string;
+  blocks: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece | CalendarPiece | TimelinePiece | BoardPiece | HostPiece>;
+}
+
+export interface ViewOut {
+  id: string;
+  agent_id: string;
+  name: string;
+  title: string;
+  blocks: Array<StatPiece | ChartPiece | TablePiece | ListPiece | NotePiece | CalendarPiece | TimelinePiece | BoardPiece | HostPiece>;
+  created_at: string;
+  updated_at: string;
+}
+
+/** A view rendered for one contact: its blocks as the kit draws them, filled from the rows now, and `text`, the same in words (what a page that can't draw them shows). */
+export interface ViewRendered {
+  name: string;
+  title: string;
+  contact_id: string;
+  blocks: Array<Card | Stack | Divider | Text | Fields | Table | Listing | Stat | Chart | Note | Image | Button | Choice | Form | Calendar | Timeline | BoardBlock | AutomationBlock | FileBlock | HostBlock>;
+  text: string;
+  rendered_at: string;
 }
 
 /** 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. */
@@ -1669,6 +2043,7 @@ export interface WaitOut {
   action: string;
   kind: "ask" | "approve" | "tool";
   decides: "person" | "business" | null;
+  schema?: Record<string, unknown> | null;
 }
 
 /** The agent the widget talks to, and the sites it may be loaded from. */
@@ -1705,10 +2080,10 @@ export interface WhatsAppIn {
   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. */
+/** One filter: the field compared with `value` by `op`. `last_days` keeps the rows whose date falls in the last `value` days, `next_days` those in the next `value` days (from now on); `contains` looks for words in a text. */
 export interface Where {
   field: string;
-  op?: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "last_days";
+  op?: "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "last_days" | "next_days";
   value: string | number | boolean;
 }