@withbuddi/buddi 0.1.0-pre.35 → 0.1.0-pre.37

package/packages/core/dist/onboarding/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/onboarding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,SAAS;IACT,aAAa;IACb,MAAM;IACN,SAAS;CACV,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,CAAU,CAAC;AAI7F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAqF/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/onboarding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,SAAS;IACT,aAAa;IACb,MAAM;IACN,SAAS;CACV,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,CAAU,CAAC;AAI7F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AA6F/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC"}

package/packages/core/dist/pages.d.ts

@@ -83,7 +83,7 @@ export interface PageQuery {
     sensitive?: boolean;
 }
 /** The icons the dashboard draws. A pinned set, never an arbitrary image. */
-export type PageIcon = 'mail' | 'money' | 'calendar' | 'people' | 'file' | 'chart' | 'bell' | 'plug' | 'key' | 'globe' | 'sun' | 'cloud';
+export type PageIcon = 'mail' | 'money' | 'calendar' | 'people' | 'file' | 'chart' | 'bell' | 'plug' | 'key' | 'globe' | 'sun' | 'cloud' | 'news';
 /** One screen: where it lives, and what is on it. */
 export interface PageDescriptor {
     /** 'mail', 'settings' — unique in the plugin. */
@@ -101,6 +101,13 @@ export interface PageDescriptor {
      * component that fetched something mean anything at all.
      */
     data?: QueryRef;
+    /**
+     * The page head's right (since host API 1.27): up to three links or buttons,
+     * drawn against `data` — the News page's Sources and Latest edition. The
+     * last one carrying `tone: 'accent'` is the primary, rightmost. A rail page
+     * only; a settings tab has no head of its own.
+     */
+    actions?: SectionAction[];
     body: Component[];
 }
 /**
@@ -123,7 +130,8 @@ export interface QueryRef {
 /**
  * Where a tool argument comes from. `{ field }` is a form or editor field on
  * the screen; `{ row }` is a field of the row an action sits on; `{ selected }`
- * is the list's current selection, as an array of its `key` values.
+ * is the list's current selection, as an array of its `key` values; `{
+ * choice }` is the option a row's choice was just moved to (1.28).
  */
 export type ArgRef = ValueRef | {
     param: string;
@@ -133,6 +141,8 @@ export type ArgRef = ValueRef | {
     row: string;
 } | {
     selected: true;
+} | {
+    choice: true;
 };
 /**
  * Where a link goes: another page of this same plugin, or one agent's chat.
@@ -151,6 +161,13 @@ export type ArgRef = ValueRef | {
  * proposes policies through core has its proposals there, not on its own
  * page, and the only useful thing its page can say about them is where they
  * are. It names no plugin: the dashboard fills in the one drawing the page.
+ *
+ * `{ href }` (since host API 1.27) is the one road out of buddi: an `https:`
+ * address **read out of the data** — the article a story card is about —
+ * opened in a new tab with `noopener noreferrer` and an outside-link mark.
+ * A value that is not an absolute `https:` URL is no link at all. It is a
+ * link the owner follows, never a request the dashboard makes: nothing is
+ * fetched, previewed or embedded from it.
  */
 export type RouteRef = {
     page: string;
@@ -159,6 +176,8 @@ export type RouteRef = {
     chat: ValueRef;
 } | {
     proposals: true;
+} | {
+    href: ValueRef;
 };
 /** A write: a tool of this plugin, invoked as the owner. */
 export interface ToolRef {
@@ -224,6 +243,14 @@ export interface RowAction extends ToolRef {
      * sheet with its sentence; success closes it.
      */
     form?: RowActionForm;
+    /**
+     * In the row's ⋯ menu rather than on the row (since host API 1.27): the
+     * ways out of a source — Mute, Remove — that would crowd it as buttons.
+     * `hint` is the quiet line under the item; `group` a small heading above it.
+     */
+    menu?: true;
+    hint?: string;
+    group?: string;
 }
 /**
  * The small form a row action opens — Settings → Email's "Set password".
@@ -270,6 +297,30 @@ export interface PillRef {
     /** A tone per value, over `tone`: the descriptor says which states catch the eye. */
     tones?: Record<string, Tone>;
 }
+/**
+ * One small picture on a list row (since host API 1.27): a key of the
+ * plugin's own `assets` (`ctx.buddi.assets.put`), read out of the row, and
+ * the words it stands for. The dashboard draws the stored PNG from buddi,
+ * never from anywhere else, and a letter tile from `label` when the key is
+ * missing or the asset is gone.
+ */
+export interface ImageRef {
+    asset: ValueRef;
+    label: ValueRef;
+}
+/**
+ * Pictures read from an array in the row (since host API 1.27): `from` is
+ * the path to the array, `asset` and `label` paths within one element. The
+ * first three are drawn overlapping, and the rest are counted in words
+ * ("Reuters and 3 more").
+ */
+export interface ImageList {
+    from: string;
+    asset: string;
+    label: string;
+}
+/** Up to this many fixed image slots on a list row. */
+export declare const LIST_IMAGES_MAX = 4;
 /** One line of a list: what it says, and where it goes. */
 export interface ListItem {
     title: ValueRef;
@@ -279,6 +330,78 @@ export interface ListItem {
     /** Several, when one word is not the whole state of a row. */
     pills?: PillRef[];
     to?: RouteRef;
+    /**
+     * Small pictures before the title, from the plugin's assets: up to four
+     * fixed slots, or `{ from, asset, label }` over an array in the row. Since
+     * host API 1.27; an older buddi refuses the descriptor.
+     */
+    images?: ImageRef[] | ImageList;
+    /**
+     * One picture leading the row, larger — an outlet's logo on a source row
+     * (since host API 1.27). A letter tile from `label` when the key is missing.
+     */
+    logo?: ImageRef;
+    /** A short word after the title, in small capitals: a language ("FR"). Since 1.27. */
+    tag?: ValueRef;
+    /**
+     * One sentence under the row, in the tone it names: what is wrong with it
+     * and since when ("Failing since Tue 08:00: …"). Nothing is drawn for an
+     * empty value. Since 1.27.
+     */
+    status?: {
+        text: ValueRef;
+        tone?: Tone | ValueRef;
+    };
+    /**
+     * Path within the row to a `#rrggbb` colour, drawn as a small dot leading
+     * the row — a calendar's own colour beside its name. A row whose value is
+     * empty gets a hollow dot, so the names still line up; anything that is not
+     * a plain hex colour is drawn as empty. Since 1.28.
+     */
+    swatch?: string;
+    /**
+     * One choice of two to four, drawn as a segment on the row's right: what
+     * agents may do with a calendar — Not linked · Read · Read and change.
+     * Since 1.28.
+     */
+    choice?: RowChoice;
+}
+/**
+ * A row's segmented choice (since host API 1.28). The row's value at `value`
+ * is the option drawn as chosen; picking another runs the tool with `{
+ * choice: true }` as the picked option's value and `{ row }` reading the row,
+ * then refreshes. The pick shows at once and goes back if the tool refuses.
+ * `label` is the control's name for a screen reader, with `{field}`
+ * placeholders read from the row ("What agents may do with {name}").
+ */
+export interface RowChoice extends Omit<ToolRef, 'args' | 'confirm'> {
+    value: string;
+    options: RowChoiceOption[];
+    args: Record<string, ValueRef | {
+        row: string;
+    } | {
+        choice: true;
+    }>;
+}
+/** One option of a row's choice: left out where `when` does not hold, greyed where `disabledWhen` does, `hint` saying why. */
+export interface RowChoiceOption {
+    value: string;
+    label: string;
+    when?: Visibility;
+    disabledWhen?: Visibility;
+    hint?: string;
+}
+/**
+ * One item of a `menu` (since host API 1.28): a tool, or `open`, the `id` of
+ * a drawer form on the same page, which it opens in its sheet. `hint` is the
+ * quiet line under the item's words.
+ */
+export interface MenuItem {
+    label: string;
+    hint?: string;
+    when?: Visibility;
+    action?: ToolRef;
+    open?: string;
 }
 /**
  * Where a calendar finds each event's parts: paths within one row.
@@ -360,6 +483,17 @@ export interface TabsPick {
         label: string;
     }>;
     optionsFrom?: OptionsFrom;
+    /**
+     * `chips` (since host API 1.27) draws the choices as a row of chips that
+     * wraps — and scrolls sideways on a phone — instead of a segment: for a
+     * pick with many options, the News page's topics.
+     */
+    look?: 'segment' | 'chips';
+    /** A quiet last chip that goes somewhere: "+ Topic" to the source manager. Chips only. */
+    add?: {
+        label: string;
+        to: RouteRef;
+    };
 }
 /** Rows the owner may tick, and the ones they may not. */
 export interface Selection {
@@ -372,6 +506,22 @@ export interface Selection {
 export interface GroupBy {
     key: string;
     labels?: Record<string, string>;
+    /**
+     * Path within a row to the group's words, read from its first row, for
+     * groups the descriptor cannot list (an owner's own topics). Since 1.27;
+     * `labels` wins where it names the key.
+     */
+    label?: string;
+    /** Path within a row to a quiet line beside the group's head ("6 sources"). Since 1.27. */
+    aside?: string;
+    /** Path within a row to the aside's tone, `warning` or `critical` ("Sign-in ran out"). Since 1.28. */
+    asideTone?: string;
+    /**
+     * Actions on the group's head, at its right, read against the group's first
+     * row: `{ row }` arguments, `when`, `confirm` and `menu` as a row's
+     * (Sign in again; ⋯ Remove account…). Since 1.28.
+     */
+    actions?: RowAction[];
 }
 /** One control on a form, a search or an editor. */
 export interface Field {
@@ -491,12 +641,167 @@ export interface ComponentCommon {
     note?: string;
     /** The sentence shown when there is nothing. */
     empty?: string;
+    /**
+     * Show this only where the dashboard is opened: `local`, a browser on the
+     * computer buddi runs on (its address is 127.0.0.1, localhost or ::1), or
+     * `remote`, anywhere else — over the tailnet, from a phone. What a sign-in's
+     * pasted-address fallback needs: the loopback answer only reaches a browser
+     * on this computer. Since 1.28.
+     */
+    where?: 'local' | 'remote';
+}
+/**
+ * One story, as a `stories` component reads it (since host API 1.27). Every
+ * value is text the plugin already formatted in the owner's words and zone;
+ * logos are keys of the plugin's own assets.
+ */
+export interface StoryRow {
+    id: string;
+    title: string;
+    /** Two lines on the card: the update, when the story has one since it was told. */
+    lead?: string;
+    /** The sheet's paragraph; `lead` when left out. */
+    summary?: string;
+    /** What is new since it was told, in the sheet's accent box under `mark.text`. */
+    update?: string;
+    /** The best article, linked out from the sheet's title. */
+    url?: string;
+    /** "4 h ago". */
+    ago?: string;
+    opinion?: boolean;
+    /** "EN · FR", "FR"; nothing for English alone. */
+    languages?: string;
+    /** `told`: a quiet check and the words; `new`: an accent dot and the words. */
+    mark?: {
+        kind: 'told' | 'new';
+        text: string;
+    };
+    /** Told, and nothing since: the card is drawn quieter. */
+    quiet?: boolean;
+    outlets: Array<{
+        id?: string;
+        name: string;
+        logo?: string;
+    }>;
+    group?: {
+        id: string;
+        name: string;
+    };
+    /** The sheet's title line: the topic. */
+    kicker?: string;
+    /** The sheet's quiet line: "First seen 06:10 · 4 sources · told you this morning". */
+    meta?: string;
+    sources?: Array<{
+        title: string;
+        url?: string;
+        outlet: string;
+        logo?: string;
+        meta?: string;
+    }>;
+    timeline?: Array<{
+        at: string;
+        text: string;
+        told?: boolean;
+    }>;
+}
+/**
+ * One way out of a story (since host API 1.27): an item of its ⋯ menu.
+ * `{ row }` arguments read the story, `{ item }` the element of `each`.
+ */
+export interface StoryWay extends Omit<ToolRef, 'args'> {
+    args: Record<string, ValueRef | {
+        row: string;
+    } | {
+        item: string;
+    }>;
+    /**
+     * Once per element of this array in the row — "Mute Reuters", "Mute Le
+     * Monde" — with `{field}` in `label` read from the element. Four at most.
+     */
+    each?: string;
+    /** The quiet line under the item: "Back on its own next Saturday". */
+    hint?: string;
+    /** A small heading above the item, once per run of the same group: "Mute an outlet". */
+    group?: string;
+    when?: Visibility;
+    /** It takes the story off the page: the card gives way to `done` and Undo for eight seconds. */
+    hides?: true;
+    /** What Undo calls, with the same arguments' kinds. */
+    undo?: {
+        tool: string;
+        label: string;
+        args: Record<string, ValueRef | {
+            row: string;
+        } | {
+            item: string;
+        }>;
+    };
+}
+/** A `stories` empty state: a title, a line, and a way on. */
+export interface StoriesEmpty {
+    when: Visibility;
+    title: string | ValueRef;
+    text?: string | ValueRef;
+    /** The warm ground of a first time, rather than the plain one. */
+    warm?: true;
+    /** Each a link, or a page parameter set (`{ filter: 'all' }` — "Show all"). The last is the primary. */
+    actions?: Array<{
+        label: string;
+        to?: RouteRef;
+        set?: Record<string, string>;
+    }>;
+}
+/**
+ * A `repeat`'s poll: its query alone is asked again every `seconds` while
+ * `while` holds of the answer. `finish` (since host API 1.28) is what makes a
+ * card complete by itself: once a row of an answer satisfies `finish.when`,
+ * `finish.action` is run once for that row — `{ row }` arguments read it —
+ * its `busy` drawn in the card while it runs and its `done` after; then the
+ * page does what its `then` says (refresh by default). A run that fails says
+ * so in the card and is not tried again for that row.
+ */
+export interface RepeatPoll {
+    seconds: number;
+    while: Visibility;
+    finish?: {
+        when: Visibility;
+        action: Omit<ToolRef, 'args' | 'confirm'> & {
+            args: Record<string, ValueRef | {
+                row: string;
+            }>;
+        };
+    };
+}
+/**
+ * What an event's sheet shows besides its title, its time and length and its
+ * calendar (since host API 1.28); every path is read within the event's row.
+ * `color` is the calendar's own `#rrggbb` beside its name; `mapHref` an
+ * https address the place links out to; `open` a link out to the event where
+ * it lives ("Open in Google Calendar"); `asks` buttons that open the corner
+ * chat with a request written in — "Move or change {title}…" — since a change
+ * goes through an agent and its approval card. `{field}` in an ask's `text`
+ * reads the row; `{when}` is the event's day and time as the sheet shows it.
+ */
+export interface CalendarSheet {
+    notes?: string;
+    color?: string;
+    mapHref?: string;
+    open?: {
+        label: string;
+        href: string;
+    };
+    asks?: Array<{
+        label: string;
+        text: string;
+    }>;
 }
 /** What a section may put on the right of its heading: going, or doing. */
 export type SectionAction = Extract<Component, {
     kind: 'link';
 } | {
     kind: 'button';
+} | {
+    kind: 'menu';
 }>;
 export type Component = (ComponentCommon & {
     kind: 'section';
@@ -504,15 +809,33 @@ export type Component = (ComponentCommon & {
     actions?: SectionAction[];
     body: Component[];
 })
-/** A sentence. `text` may be a path, for something the data has to say. */
+/**
+ * A sentence. `text` may be a path, for something the data has to say.
+ *
+ * Since host API 1.27: `look: 'quiet'` draws it as one faint line with a
+ * small glyph instead of a box — "Fetched at 10:00 from 31 sources · next
+ * at 10:15" — and `link` ends it with a link ("2 aren't answering" →
+ * Sources); `action` puts one button on its right ("Try now").
+ */
  | (ComponentCommon & {
     kind: 'notice';
     text: string | ValueRef;
     tone?: Tone;
-}) | (ComponentCommon & {
+    look?: 'box' | 'quiet';
+    icon?: 'globe' | 'clock' | 'alert';
+    link?: {
+        label: string | ValueRef;
+        to: RouteRef;
+        when?: Visibility;
+    };
+    action?: ToolRef;
+})
+/** `tone: 'accent'` (1.27) draws it as the primary button where it heads a page or a section. */
+ | (ComponentCommon & {
     kind: 'link';
     label: string;
     to: RouteRef;
+    tone?: 'accent';
 })
 /**
  * How far something has got: a bar. `value` is a number — a fraction 0–1
@@ -601,10 +924,16 @@ export type Component = (ComponentCommon & {
     fields: Field[];
     submit: ToolRef;
     initial?: QueryRef;
-    /** Behind a button, in a sheet, rather than open on the page. */
+    /**
+     * Behind a button, in a sheet, rather than open on the page. Since host
+     * API 1.28 a drawer may have an `id` instead of (or as well as) its own
+     * button: a `menu` item's `open` names it, and the page parameter
+     * `open=<id>` opens it — so a link can too.
+     */
     drawer?: {
         title: string;
-        button: string;
+        button?: string;
+        id?: string;
     };
     /**
      * Fields to a row on a wide panel: 2 (the default) or 3. The grid still
@@ -663,10 +992,7 @@ export type Component = (ComponentCommon & {
      * and only this query: a download's progress line moves without the
      * page's forms being read again under the owner's hands.
      */
-    poll?: {
-        seconds: number;
-        while: Visibility;
-    };
+    poll?: RepeatPoll;
 })
 /**
  * Dated events as a calendar: a week of hours, a month of days, or a list
@@ -685,6 +1011,10 @@ export type Component = (ComponentCommon & {
     views?: Array<'week' | 'month' | 'list'>;
     default?: 'week' | 'month' | 'list';
     hours?: [number, number];
+    /** "12 events" beside the range's name in the bar (since host API 1.28). */
+    count?: true;
+    /** An event opens a sheet of its own instead of its day's list (since host API 1.28). */
+    sheet?: CalendarSheet;
 })
 /**
  * A row of small cards, one per item — the canvas `tiles`, on a page: a
@@ -763,6 +1093,62 @@ export type Component = (ComponentCommon & {
     tabs: PageTab[];
     default?: string;
     pick?: TabsPick;
+    /**
+     * Keep the chosen tab in this page parameter (since host API 1.27), so a
+     * query below reads it as `{ param }` and an empty state's button can
+     * move it ("Show all"). Without it the choice is the bar's own.
+     */
+    param?: string;
+})
+/**
+ * A feed of stories, each from several sources (since host API 1.27): the
+ * News page. Cards in a grid — the sources' logos and "Reuters and 3 more",
+ * the age, a title, two lines, quiet marks (Opinion, EN · FR, "Told you ·
+ * this morning" or "New since this morning") — under one head per group
+ * with See all; a ⋯ menu of the ways out, each of which may hide the card
+ * behind its sentence and Undo; and a sheet per story with its sources
+ * linked out, how it moved, and the ways out again. Rows are `StoryRow`s.
+ */
+ | (ComponentCommon & {
+    kind: 'stories';
+    query: QueryRef;
+    /** Path to the array of `StoryRow`s in the answer. */
+    rows: string;
+    /** Rows carry `group: { id, name }`: one head per group, and See all writes the id into `param`. */
+    groups?: {
+        param: string;
+        label?: string;
+    };
+    /** The ⋯ menu, in order; the first one that `hides` is also the sheet's left button. At most eight. */
+    ways?: StoryWay[];
+    /** The sheet's primary button, read against the story: Ask Anchor. */
+    ask?: {
+        label: string;
+        to: RouteRef;
+        when?: Visibility;
+    };
+    /** A link at the end of the sheet's quiet line, read against the story: "Read the edition". */
+    edition?: {
+        label: string;
+        to: RouteRef;
+        when?: Visibility;
+    };
+    /** The page parameter the open story's id is kept in, so a story can be linked to. `story` when left out. */
+    param?: string;
+    /** What to say when there is no story, the first whose `when` holds of the answer; `empty` otherwise. */
+    emptyStates?: StoriesEmpty[];
+})
+/**
+ * One button that opens a short menu (since host API 1.28): Add a calendar
+ * → Sign in with Google · Link with an app password · Paste a private
+ * link. Each item runs a tool or opens a drawer form of the same page by
+ * its `id`. It stands where a button does, a section's head included.
+ */
+ | (ComponentCommon & {
+    kind: 'menu';
+    label: string;
+    tone?: 'accent';
+    items: MenuItem[];
 })
 /** A fold. `label` may be a path, so a row's own words are on it. */
  | (ComponentCommon & {
@@ -830,11 +1216,11 @@ export type Component = (ComponentCommon & {
  * a list is reported against the list, not as "no branch matched".
  */
 export declare const componentSchema: z.ZodType<Component>;
-export declare const pageDescriptorSchema: z.ZodObject<{
+export declare const pageDescriptorSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
     place: z.ZodEnum<["rail", "settings"]>;
-    icon: z.ZodOptional<z.ZodEnum<["mail", "money", "calendar", "people", "file", "chart", "bell", "plug", "key", "globe", "sun", "cloud"]>>;
+    icon: z.ZodOptional<z.ZodEnum<["mail", "money", "calendar", "people", "file", "chart", "bell", "plug", "key", "globe", "sun", "cloud", "news"]>>;
     order: z.ZodOptional<z.ZodNumber>;
     data: z.ZodOptional<z.ZodObject<{
         query: z.ZodString;
@@ -859,9 +1245,9 @@ export declare const pageDescriptorSchema: z.ZodObject<{
         }>, z.ZodObject<{
             route: z.ZodEnum<["plugin", "page", "item"]>;
         }, "strict", z.ZodTypeAny, {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
         }, {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
         }>]>>>;
     }, "strict", z.ZodTypeAny, {
         query: string;
@@ -872,7 +1258,7 @@ export declare const pageDescriptorSchema: z.ZodObject<{
         } | {
             param: string;
         } | {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
         }> | undefined;
     }, {
         query: string;
@@ -883,9 +1269,10 @@ export declare const pageDescriptorSchema: z.ZodObject<{
         } | {
             param: string;
         } | {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
         }> | undefined;
     }>>;
+    actions: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodType<Component, z.ZodTypeDef, Component>, "many">, Component[], Component[]>>;
     body: z.ZodArray<z.ZodType<Component, z.ZodTypeDef, Component>, "many">;
 }, "strict", z.ZodTypeAny, {
     id: string;
@@ -901,10 +1288,51 @@ export declare const pageDescriptorSchema: z.ZodObject<{
         } | {
             param: string;
         } | {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
+        }> | undefined;
+    } | undefined;
+    icon?: "file" | "key" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | "news" | undefined;
+    actions?: Component[] | undefined;
+    order?: number | undefined;
+}, {
+    id: string;
+    place: "settings" | "rail";
+    title: string;
+    body: Component[];
+    data?: {
+        query: string;
+        params?: Record<string, {
+            path: string;
+        } | {
+            const: string | number | boolean | null;
+        } | {
+            param: string;
+        } | {
+            route: "page" | "plugin" | "item";
+        }> | undefined;
+    } | undefined;
+    icon?: "file" | "key" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | "news" | undefined;
+    actions?: Component[] | undefined;
+    order?: number | undefined;
+}>, {
+    id: string;
+    place: "settings" | "rail";
+    title: string;
+    body: Component[];
+    data?: {
+        query: string;
+        params?: Record<string, {
+            path: string;
+        } | {
+            const: string | number | boolean | null;
+        } | {
+            param: string;
+        } | {
+            route: "page" | "plugin" | "item";
         }> | undefined;
     } | undefined;
-    icon?: "key" | "file" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | undefined;
+    icon?: "file" | "key" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | "news" | undefined;
+    actions?: Component[] | undefined;
     order?: number | undefined;
 }, {
     id: string;
@@ -920,10 +1348,11 @@ export declare const pageDescriptorSchema: z.ZodObject<{
         } | {
             param: string;
         } | {
-            route: "page" | "item" | "plugin";
+            route: "page" | "plugin" | "item";
         }> | undefined;
     } | undefined;
-    icon?: "key" | "file" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | undefined;
+    icon?: "file" | "key" | "mail" | "sun" | "money" | "calendar" | "people" | "chart" | "bell" | "plug" | "globe" | "cloud" | "news" | undefined;
+    actions?: Component[] | undefined;
     order?: number | undefined;
 }>;
 /**