@songsid/agend 2.3.0-beta.9 → 2.3.0

package/dist/outbound-schemas.d.ts

@@ -6,6 +6,8 @@
  */
 import { z } from "zod";
 export declare const ReplyArgs: z.ZodObject<{
+    chat_id: z.ZodOptional<z.ZodString>;
+    thread_id: z.ZodOptional<z.ZodString>;
     text: z.ZodOptional<z.ZodString>;
     reply_to: z.ZodOptional<z.ZodString>;
     files: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -27,32 +29,30 @@ export declare const ReplyArgs: z.ZodObject<{
         }>>;
         show_voters: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
-    chat_id: z.ZodOptional<z.ZodString>;
-    thread_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ClosePollArgs: z.ZodObject<{
     poll_id: z.ZodString;
 }, z.core.$strip>;
 export declare const ReactArgs: z.ZodObject<{
-    message_id: z.ZodString;
-    emoji: z.ZodString;
     chat_id: z.ZodOptional<z.ZodString>;
     thread_id: z.ZodOptional<z.ZodString>;
+    message_id: z.ZodString;
+    emoji: z.ZodString;
 }, z.core.$strip>;
 export declare const EditMessageArgs: z.ZodObject<{
+    chat_id: z.ZodOptional<z.ZodString>;
+    thread_id: z.ZodOptional<z.ZodString>;
     message_id: z.ZodString;
     text: z.ZodString;
     format: z.ZodOptional<z.ZodEnum<{
         markdown: "markdown";
         text: "text";
     }>>;
-    chat_id: z.ZodOptional<z.ZodString>;
-    thread_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const DownloadAttachmentArgs: z.ZodObject<{
-    file_id: z.ZodString;
     chat_id: z.ZodOptional<z.ZodString>;
     thread_id: z.ZodOptional<z.ZodString>;
+    file_id: z.ZodString;
 }, z.core.$strip>;
 export declare const ValidateConfigArgs: z.ZodObject<{}, z.core.$strip>;
 export declare const CreateScheduleArgs: z.ZodObject<{
@@ -82,18 +82,21 @@ export declare const DeleteScheduleArgs: z.ZodObject<{
 }, z.core.$strip>;
 export declare const TaskBoardArgs: z.ZodObject<{
     action: z.ZodEnum<{
-        update: "update";
-        list: "list";
-        create: "create";
-        get: "get";
         claim: "claim";
+        create: "create";
         done: "done";
+        get: "get";
+        list: "list";
+        mine: "mine";
+        move: "move";
+        projects: "projects";
+        update: "update";
     }>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     priority: z.ZodOptional<z.ZodEnum<{
-        low: "low";
         high: "high";
+        low: "low";
         normal: "normal";
         urgent: "urgent";
     }>>;
@@ -102,34 +105,64 @@ export declare const TaskBoardArgs: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     result: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
+        blocked: "blocked";
         cancelled: "cancelled";
-        open: "open";
-        done: "done";
         claimed: "claimed";
-        blocked: "blocked";
+        done: "done";
+        open: "open";
+        review: "review";
     }>>;
     filter_assignee: z.ZodOptional<z.ZodString>;
     filter_status: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        blocked: "blocked";
         cancelled: "cancelled";
-        open: "open";
-        done: "done";
         claimed: "claimed";
-        blocked: "blocked";
+        done: "done";
+        open: "open";
+        review: "review";
     }>, z.ZodArray<z.ZodEnum<{
+        blocked: "blocked";
         cancelled: "cancelled";
-        open: "open";
-        done: "done";
         claimed: "claimed";
-        blocked: "blocked";
+        done: "done";
+        open: "open";
+        review: "review";
     }>>]>>;
     verbose: z.ZodOptional<z.ZodBoolean>;
+    project: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    parent: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    acceptance: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    check: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    uncheck: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    context: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    log: z.ZodOptional<z.ZodString>;
+    comment: z.ZodOptional<z.ZodString>;
+    needs_review: z.ZodOptional<z.ZodBoolean>;
+    size: z.ZodOptional<z.ZodEnum<{
+        L: "L";
+        M: "M";
+        S: "S";
+    }>>;
+    dispatcher: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    to: z.ZodOptional<z.ZodEnum<{
+        blocked: "blocked";
+        cancelled: "cancelled";
+        claimed: "claimed";
+        done: "done";
+        open: "open";
+        review: "review";
+    }>>;
+    reason: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const PostDecisionArgs: z.ZodObject<{
     title: z.ZodString;
     content: z.ZodString;
     scope: z.ZodOptional<z.ZodEnum<{
-        project: "project";
         fleet: "fleet";
+        project: "project";
     }>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     ttl_days: z.ZodOptional<z.ZodNumber>;
@@ -173,14 +206,14 @@ export declare const PreviewEmojisArgs: z.ZodObject<{
 export declare const SetPersonaEmojiArgs: z.ZodObject<{
     emoji: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
-        failed: "failed";
-        received: "received";
-        queued: "queued";
-        processing: "processing";
+        attachment: "attachment";
         delivered: "delivered";
+        failed: "failed";
         photo: "photo";
-        attachment: "attachment";
+        processing: "processing";
         progress_prefix: "progress_prefix";
+        queued: "queued";
+        received: "received";
     }>>;
 }, z.core.$strip>;
 export declare const GetWebThemeArgs: z.ZodObject<{}, z.core.$strip>;
@@ -190,11 +223,11 @@ export declare const SetWebThemeArgs: z.ZodObject<{
 }, z.core.$strip>;
 export declare const SetWebThemeAssetArgs: z.ZodObject<{
     slot: z.ZodEnum<{
-        portrait: "portrait";
-        banner: "banner";
-        background: "background";
         avatar: "avatar";
+        background: "background";
+        banner: "banner";
         glyph: "glyph";
+        portrait: "portrait";
     }>;
     file: z.ZodString;
 }, z.core.$strip>;
@@ -202,24 +235,24 @@ export declare const ResetWebThemeArgs: z.ZodObject<{}, z.core.$strip>;
 export declare const GetWebAppearanceArgs: z.ZodObject<{}, z.core.$strip>;
 export declare const PreviewWebAppearanceArgs: z.ZodObject<{
     modes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        light: "light";
         dark: "dark";
+        light: "light";
     }>>>;
 }, z.core.$strip>;
 export declare const SetWebWidgetArgs: z.ZodObject<{
     slot: z.ZodEnum<{
-        details: "details";
         chat_header: "chat_header";
+        details: "details";
     }>;
     spec: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export declare const SetWebAmbientArgs: z.ZodObject<{
     preset: z.ZodEnum<{
+        "burst-on-click": "burst-on-click";
         fall: "fall";
         rise: "rise";
         twinkle: "twinkle";
-        "burst-on-click": "burst-on-click";
     }>;
     glyphs: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         asset: z.ZodString;
@@ -250,8 +283,8 @@ export declare const ProposeWebModArgs: z.ZodObject<{
 }, z.core.$strip>;
 export declare const RemoveWebWidgetArgs: z.ZodObject<{
     slot: z.ZodOptional<z.ZodEnum<{
-        details: "details";
         chat_header: "chat_header";
+        details: "details";
     }>>;
 }, z.core.$strip>;
 export declare const UploadWebEffectArgs: z.ZodObject<{
@@ -289,8 +322,8 @@ export declare const ListInstancesArgs: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     backend: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
-        running: "running";
         paused: "paused";
+        running: "running";
         stopped: "stopped";
     }>>;
 }, z.core.$strip>;
@@ -332,18 +365,22 @@ export declare const SetWebSettingsArgs: z.ZodObject<{
         set: z.ZodObject<{
             themes_shown: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             card_size: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                s: "s";
-                m: "m";
                 l: "l";
+                m: "m";
+                s: "s";
             }>>>;
             card_sizes: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodEnum<{
-                s: "s";
-                m: "m";
                 l: "l";
+                m: "m";
+                s: "s";
+            }>>>>;
+            page_colours: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                chat: "chat";
+                page: "page";
             }>>>>;
             colour_places: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
-                name: "name";
                 bar: "bar";
+                name: "name";
                 ring: "ring";
             }>>>>;
             colours_off: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
@@ -356,33 +393,42 @@ export declare const SetWebSettingsArgs: z.ZodObject<{
         what: z.ZodLiteral<"banner_focus">;
         instance: z.ZodString;
         focus: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        what: z.ZodLiteral<"page_colours">;
+        instance: z.ZodString;
+        choice: z.ZodEnum<{
+            agent: "agent";
+            chat: "chat";
+            page: "page";
+        }>;
     }, z.core.$strict>, z.ZodObject<{
         what: z.ZodLiteral<"agent_colour">;
         instance: z.ZodString;
         colour: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         places: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
-            name: "name";
             bar: "bar";
+            name: "name";
             ring: "ring";
         }>>>>;
     }, z.core.$strict>, z.ZodObject<{
         what: z.ZodLiteral<"custom_css">;
         action: z.ZodEnum<{
-            off: "off";
-            save: "save";
             keep: "keep";
+            off: "off";
             revert: "revert";
+            save: "save";
             use: "use";
         }>;
         text: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodString>;
+        trial: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         what: z.ZodLiteral<"mod">;
         action: z.ZodEnum<{
             cancel: "cancel";
+            dismiss: "dismiss";
             install: "install";
             review: "review";
-            dismiss: "dismiss";
             uninstall: "uninstall";
         }>;
         instance: z.ZodOptional<z.ZodString>;
@@ -394,8 +440,8 @@ export declare const SetWebSettingsArgs: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         what: z.ZodLiteral<"effect">;
         action: z.ZodEnum<{
-            remove: "remove";
             apply: "apply";
+            remove: "remove";
         }>;
         instance: z.ZodString;
         id: z.ZodOptional<z.ZodString>;
@@ -403,11 +449,11 @@ export declare const SetWebSettingsArgs: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         what: z.ZodLiteral<"effect_slot">;
         slot: z.ZodEnum<{
+            box: "box";
             cursor: "cursor";
-            sidebar: "sidebar";
             header: "header";
             page: "page";
-            box: "box";
+            sidebar: "sidebar";
         }>;
         id: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
@@ -426,8 +472,8 @@ export declare const SetWebSettingsArgs: z.ZodObject<{
 export declare const GetCacheReportArgs: z.ZodObject<{
     window: z.ZodOptional<z.ZodEnum<{
         "24h": "24h";
-        "7d": "7d";
         "30d": "30d";
+        "7d": "7d";
     }>>;
     instance: z.ZodOptional<z.ZodString>;
     top: z.ZodOptional<z.ZodNumber>;
@@ -435,20 +481,20 @@ export declare const GetCacheReportArgs: z.ZodObject<{
 /** #2122: tokens, requests, delivered messages and their API-equivalent at list price, read-only. */
 export declare const GetUsageReportArgs: z.ZodObject<{
     range: z.ZodOptional<z.ZodEnum<{
+        "7d": "7d";
+        all: "all";
         custom: "custom";
         month: "month";
-        "7d": "7d";
         today: "today";
-        all: "all";
     }>>;
     from: z.ZodOptional<z.ZodString>;
     to: z.ZodOptional<z.ZodString>;
     group: z.ZodOptional<z.ZodEnum<{
-        instance: "instance";
         backend: "backend";
+        instance: "instance";
         model: "model";
-        team: "team";
         profile: "profile";
+        team: "team";
     }>>;
     instance: z.ZodOptional<z.ZodString>;
     top: z.ZodOptional<z.ZodNumber>;
@@ -463,8 +509,8 @@ export declare const GetInstanceLogsArgs: z.ZodObject<{
 }, z.core.$strip>;
 export declare const GetFleetConfigArgs: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<{
-        instance: "instance";
         defaults: "defaults";
+        instance: "instance";
     }>>;
     name: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -501,12 +547,12 @@ export declare const CreateInstanceArgs: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     backend: z.ZodOptional<z.ZodEnum<{
+        antigravity: "antigravity";
         "claude-code": "claude-code";
         codex: "codex";
-        muse: "muse";
-        "kiro-cli": "kiro-cli";
-        antigravity: "antigravity";
         grok: "grok";
+        "kiro-cli": "kiro-cli";
+        muse: "muse";
         opencode: "opencode";
     }>>;
     backend_options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -523,10 +569,10 @@ export declare const SendToInstanceArgs: z.ZodObject<{
     forwards: z.ZodOptional<z.ZodArray<z.ZodString>>;
     steer: z.ZodOptional<z.ZodBoolean>;
     request_kind: z.ZodOptional<z.ZodEnum<{
-        update: "update";
+        query: "query";
         report: "report";
         task: "task";
-        query: "query";
+        update: "update";
     }>>;
     requires_reply: z.ZodOptional<z.ZodBoolean>;
     correlation_id: z.ZodOptional<z.ZodString>;
@@ -541,9 +587,9 @@ export declare const BroadcastArgs: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     task_summary: z.ZodOptional<z.ZodString>;
     request_kind: z.ZodOptional<z.ZodEnum<{
-        update: "update";
-        task: "task";
         query: "query";
+        task: "task";
+        update: "update";
     }>>;
     requires_reply: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;

package/dist/outbound-schemas.js

@@ -99,27 +99,44 @@ export const DeleteScheduleArgs = z.object({
 });
 // ── Fleet Task Board ────────────────────────────────────────────────────
 export const TaskBoardArgs = z.object({
-    action: z.enum(["create", "list", "claim", "done", "update", "get"])
+    action: z.enum(["create", "list", "claim", "done", "update", "get", "mine", "move", "projects"])
         .describe("Operation to perform"),
-    title: z.string().optional().describe("Task title (create)"),
-    description: z.string().optional().describe("Task details (create)"),
+    title: z.string().optional().describe("Task title (create/update)"),
+    description: z.string().optional().describe("Task details; a board card's goal (create/update)"),
     priority: z.enum(["low", "normal", "high", "urgent"]).optional()
         .describe("Priority (create/update)"),
     assignee: z.string().optional().describe("Instance name to assign (create/update)"),
     depends_on: z.array(z.string()).optional()
         .describe("Task IDs this depends on (create)"),
-    id: z.string().optional().describe("Task ID or 8-hex id prefix (claim/done/update/get)"),
+    id: z.string().optional().describe("Task ID, 8-hex id prefix, or card number like M-3 (claim/done/update/get)"),
     result: z.string().optional().describe("Completion summary (done)"),
-    status: z.enum(["open", "claimed", "done", "blocked", "cancelled"]).optional()
+    status: z.enum(["open", "claimed", "review", "done", "blocked", "cancelled"]).optional()
         .describe("New status (update)"),
     filter_assignee: z.string().optional().describe("Filter by assignee (list)"),
     filter_status: z.union([
-        z.enum(["open", "claimed", "done", "blocked", "cancelled"]),
-        z.array(z.enum(["open", "claimed", "done", "blocked", "cancelled"])),
+        z.enum(["open", "claimed", "review", "done", "blocked", "cancelled"]),
+        z.array(z.enum(["open", "claimed", "review", "done", "blocked", "cancelled"])),
     ]).optional()
-        .describe("Filter by status (list) — a single status or an array of statuses. Omit for live-only (open/claimed/blocked)."),
+        .describe("Filter by status (list) — a single status or an array of statuses. Omit for live-only (open/claimed/blocked/review)."),
     verbose: z.boolean().optional()
         .describe("list: return full task records instead of compact rows (default false)"),
+    // The task board (docs/design/task-board.md): naming one of these makes create/update a board card's.
+    project: z.union([z.string(), z.number().int()]).optional().describe("Project name or id: a new main task's (create), a filter (list)"),
+    parent: z.string().optional().describe("Main task number like M-3: a new sub task's (create), its sub tasks (list)"),
+    scope: z.string().optional().describe("Main task: in / out of scope (create/update)"),
+    acceptance: z.array(z.string()).optional().describe("Checklist that defines done, one item each (create/update replaces it)"),
+    check: z.array(z.number().int()).optional().describe("Acceptance items to tick, 1-based (update)"),
+    uncheck: z.array(z.number().int()).optional().describe("Acceptance items to untick, 1-based (update)"),
+    context: z.string().optional().describe("Pointers only: paths, related cards, decisions (create/update)"),
+    state: z.string().optional().describe("Overwritten each time: done / next / watch out, at most 5 lines (update)"),
+    log: z.string().optional().describe("One progress line appended to the card's log (update)"),
+    comment: z.string().optional().describe("A comment on the card (update/move)"),
+    needs_review: z.boolean().optional().describe("Stop at review when finished, for whoever confirms it: the person on a card they handed out, else its dispatcher (create/update)"),
+    size: z.enum(["S", "M", "L"]).optional().describe("S small, M one unit, L too big: split it (create/update)"),
+    dispatcher: z.string().nullable().optional().describe("Who handed the work out (an instance, e.g. your lead); a blocked card's question goes to them first. Default: the main task's, or you when you assign it to someone else (create/update)"),
+    to: z.enum(["open", "claimed", "review", "done", "blocked", "cancelled"]).optional().describe("New status (move)"),
+    reason: z.string().optional().describe("move: why blocked (who must answer what), cancelled, or acceptance left unchecked"),
+    version: z.number().int().optional().describe("The card version you read; a newer one refuses the write (update/move)"),
 });
 // ── Shared Decisions ────────────────────────────────────────────────────
 export const PostDecisionArgs = z.object({
@@ -183,7 +200,7 @@ export const SetPersonaEmojiArgs = z.object({
 export const GetWebThemeArgs = z.object({});
 export const SetWebThemeArgs = z.object({
     set: z.record(z.string(), z.unknown()).optional()
-        .describe("Theme fields to set, merged into your current theme: colors.light|dark.{bg,surface,text,text2,accent,userBubble,agentBubble} as #rrggbb, accent, bubble.{radius 0..24, border none|thin|accent}, font inter|system|mono, background {image: asset id, fit cover|contain, opacity 0.05..1}, avatar (asset id), workingLabel (1..24 characters), card.{portrait, banner} (asset ids uploaded for those slots), card.tagline (1..60 characters, one line), card.bio (1..280 characters, at most 3 line breaks), card.bannerFocus (0 top … 100 bottom: which part of your banner stays in view when it is cropped; 50 the centre)"),
+        .describe("Theme fields to set, merged into your current theme: colors.light|dark.{bg,surface,text,text2,accent,userBubble,agentBubble} as #rrggbb, accent, bubble.{radius 0..24, border none|thin|accent}, font inter|system|mono, background {image: asset id, fit cover|contain, opacity 0.05..1}, avatar (asset id), workingLabel (1..24 characters), card.{portrait, banner} (asset ids uploaded for those slots), card.tagline (1..60 characters, one line), card.bio (1..280 characters, at most 3 line breaks), card.bannerFocus (0 top … 100 bottom: which part of your banner stays in view when it is cropped; 50 the centre), page.on (true: your colours on the whole page — the sidebar, the header, the usage rail, a phone's tabs — while your chat is open; a person's choice wins; text, accent and AgEnD's status colours must read on it), page.sidebar.light|dark (#rrggbb; else your bg)"),
     clear: z.array(z.string().max(64)).max(32).optional().describe("Dotted paths to remove, e.g. [\"colors.dark.bg\", \"workingLabel\"]"),
 });
 export const SetWebThemeAssetArgs = z.object({
@@ -309,6 +326,7 @@ export const SetWebSettingsArgs = z.object({
                 themes_shown: z.boolean().nullable().optional().describe("Show agents' themes, effects and widgets (null: the default, shown)"),
                 card_size: z.enum(["s", "m", "l"]).nullable().optional().describe("Identity cards' size (null: the default, m)"),
                 card_sizes: z.record(z.string(), z.enum(["s", "m", "l"])).nullable().optional().describe("Cards set apart from it: { <instance>: s|m|l } (null: none)"),
+                page_colours: z.record(z.string(), z.enum(["page", "chat"])).nullable().optional().describe("Where agents' theme colours go, set apart from each agent's own choice: { <instance>: page (the whole page) | chat (only its chat) } (null: every agent's own)"),
                 colour_places: Places.nullable().optional().describe("Where identity colours show where nobody chose: name, bar, ring ([] nowhere; null: the default, all three)"),
                 colours_off: z.boolean().nullable().optional().describe("Turn every identity colour off on this host (picks are kept)"),
                 sidebar_widget: z.object({ spec: z.record(z.string(), z.unknown()), data: z.record(z.string(), z.unknown()) }).strict().nullable().optional()
@@ -319,6 +337,10 @@ export const SetWebSettingsArgs = z.object({
             what: z.literal("banner_focus"), instance: NonEmptyString,
             focus: z.number().int().min(0).max(100).nullable().describe("Which part of that agent's cropped banner stays in view: 0 top … 100 bottom (50 the centre); null follows the agent's own"),
         }).strict(),
+        z.object({
+            what: z.literal("page_colours"), instance: NonEmptyString,
+            choice: z.enum(["agent", "page", "chat"]).describe("Where that agent's theme colours go while its chat is open: page (the whole page: sidebar, header, usage rail, a phone's tabs), chat (only its chat), or agent (its own choice, theme.page.on)"),
+        }).strict(),
         z.object({
             what: z.literal("agent_colour"), instance: NonEmptyString,
             colour: z.string().nullable().optional().describe("preset:<name> or #rrggbb (null: back to the agent's, its bot's or the automatic one)"),
@@ -326,8 +348,9 @@ export const SetWebSettingsArgs = z.object({
         }).strict(),
         z.object({
             what: z.literal("custom_css"), action: z.enum(["save", "keep", "revert", "use", "off"]),
-            text: z.string().optional().describe("save: the stylesheet (same rules as the page: no remote URLs, assets as url(\"asset:<id>\"), at most 64 KiB). It goes on trial on their screens: keep it (keep) once they say they like it, or it goes back by itself."),
+            text: z.string().optional().describe("save: the stylesheet (same rules as the page: no remote URLs, assets as url(\"asset:<id>\"), at most 64 KiB). It goes on trial: it waits until they open the dashboard (up to 10 minutes), then goes back by itself 20 s after it is on their screen unless kept — keep it (keep, with the trial id save returned) once they say they like it; kept after it went back, it is put back in force (as use)."),
             version: z.string().optional().describe("use: an earlier saved version's sha, from get_web_settings' custom_css.versions; it applies at once"),
+            trial: z.string().optional().describe("keep: the trial's id, as save returned it (or get_web_settings' custom_css.trial); a different trial on now is not kept"),
         }).strict(),
         z.object({
             what: z.literal("mod"), action: z.enum(["review", "install", "cancel", "dismiss", "uninstall"]),