@tai42/studio-sdk 25.0.1 → 27.0.0

package/README.md

@@ -27,8 +27,9 @@ pnpm add @tai42/studio-sdk
 - `@tai42/studio-sdk/schema-form` — a form-only `SchemaForm` entry for bundling
   consumers that want the form without the barrel. It imports no CSS by design —
   a subpath consumer loads `tokens.css` and `components.css` explicitly.
-- `@tai42/studio-sdk/testing` — test-only helpers: a registry reset and
-  `installJsdomStubs()`, which fills the browser APIs jsdom omits.
+- `@tai42/studio-sdk/testing` — test-only helpers: a registry reset,
+  `installJsdomStubs()`, which fills the browser APIs jsdom omits, and
+  `destructiveColorOffences()`, the destructive-emphasis rule below.
 - `@tai42/studio-sdk/tokens.css` — the design-token stylesheet. It also emits the
   canonical `@layer` order, so a host imports it FIRST.
 - `@tai42/studio-sdk/fonts.css` — the self-hosted Inter Variable and Geist Mono
@@ -107,8 +108,8 @@ than the SDK — it compiles Tailwind v4, whose output needs `@property` and
 
 `tokens.css` is the styling API: a plugin styles against these names and gets
 whichever half the viewer's theme resolves to. The names are also exported as
-`TOKEN_NAMES` (86 of them), and the list grows additively — a rename or a removal
-bumps the SDK compatibility version.
+`TOKEN_NAMES` (79 of them). A new name is not a break; a rename or a removal is a
+breaking change that bumps `STUDIO_PLUGIN_API_VERSION`.
 
 The light value is the token; the dark value sits beside it under a
 `--tai-dark-` name that a plugin never reads. Two blocks put the dark half into
@@ -172,8 +173,8 @@ icons; the `-fill` members are for fills and charts and carry `on-fill` ink.
 
 | Token                   | Light                     | Dark                        |
 | ----------------------- | ------------------------- | --------------------------- |
-| `--tai-color-ok-text`   | `#047857`                 | `#34d399`                   |
-| `--tai-color-err-text`  | `#b91c1c`                 | `#f87171`                   |
+| `--tai-color-ok-text`   | `#065f46`                 | `#34d399`                   |
+| `--tai-color-err-text`  | `#b91c1c`                 | `#fca5a5`                   |
 | `--tai-color-warn-text` | `#92400e`                 | `#fbbf24`                   |
 | `--tai-color-ok-fill`   | `#10b981`                 | `#34d399`                   |
 | `--tai-color-err-fill`  | `#ef4444`                 | `#f87171`                   |
@@ -196,22 +197,18 @@ icons; the `-fill` members are for fills and charts and carry `on-fill` ink.
 | `--tai-color-syntax-number`    | `var(--tai-color-accent)`     | _(same)_             |
 | `--tai-color-syntax-bool`      | `var(--tai-color-warn-text)`  | _(same)_             |
 
-**Legacy slots.** The names a plugin already styles against. `primary`,
-`success` and `warning` re-point at the members of the contract above that keep
-them legible; `danger` is its own destructive emphasis — a deep red that runs
-darker than the brand accent in both themes so a destructive control is never
-mistaken for the primary one, with a white label and a hover a shade deeper.
-
-| Token                        | Light                        | Dark      |
-| ---------------------------- | ---------------------------- | --------- |
-| `--tai-color-primary`        | `var(--tai-color-accent)`    | _(same)_  |
-| `--tai-color-primary-text`   | `var(--tai-color-on-accent)` | _(same)_  |
-| `--tai-color-danger`         | `#991b1b`                    | `#dc2626` |
-| `--tai-color-danger-text`    | `#ffffff`                    | `#ffffff` |
-| `--tai-color-danger-hover`   | `#7f1d1d`                    | `#b91c1c` |
-| `--tai-color-danger-surface` | `var(--tai-color-err-tint)`  | _(same)_  |
-| `--tai-color-success`        | `var(--tai-color-ok-text)`   | _(same)_  |
-| `--tai-color-warning`        | `var(--tai-color-warn-text)` | _(same)_  |
+**Destructive emphasis.** A fill for the destructive button only, never text:
+error text takes `--tai-color-err-text`. It is a deep red that runs darker than
+the brand accent in both themes, so a destructive control is never mistaken for
+the primary one, with a white label and a hover a shade deeper. A plugin checks its
+own styles against this rule with `destructiveColorOffences()` from
+`@tai42/studio-sdk/testing`.
+
+| Token                           | Light     | Dark      |
+| ------------------------------- | --------- | --------- |
+| `--tai-color-destructive`       | `#991b1b` | `#dc2626` |
+| `--tai-color-destructive-hover` | `#7f1d1d` | `#b91c1c` |
+| `--tai-color-on-destructive`    | `#ffffff` | `#ffffff` |
 
 **Spacing** (n × 4; there is deliberately no `space-7`). Authored in `rem` so a
 viewer's font-size preference scales them; the px column is the rendered size at
@@ -262,8 +259,7 @@ preference without reading the media query.
 | `--tai-motion-base`           | `250ms` |
 
 **Elevation.** Only the shadow COLOUR varies by theme; the geometry is written
-once, so a dark override cannot silently move an offset or a blur. `shadow-sm`
-and `shadow-md` are legacy slots that now alias the lift and overlay geometry.
+once, so a dark override cannot silently move an offset or a blur.
 
 | Token                        | Light                                         | Dark                |
 | ---------------------------- | --------------------------------------------- | ------------------- |
@@ -271,8 +267,6 @@ and `shadow-md` are legacy slots that now alias the lift and overlay geometry.
 | `--tai-shadow-overlay-color` | `rgb(0 0 0 / 0.16)`                           | `rgb(0 0 0 / 0.6)`  |
 | `--tai-shadow-lift`          | `0 12px 32px var(--tai-shadow-lift-color)`    | _(same)_            |
 | `--tai-shadow-overlay`       | `0 24px 48px var(--tai-shadow-overlay-color)` | _(same)_            |
-| `--tai-shadow-sm`            | `var(--tai-shadow-lift)`                      | _(same)_            |
-| `--tai-shadow-md`            | `var(--tai-shadow-overlay)`                   | _(same)_            |
 
 **Stacking.** `popover` and `tooltip` sit ABOVE the modal layers on purpose: both
 portal to the document body as siblings of a dialog and have to clear its scrim
@@ -350,6 +344,129 @@ is something the sheet can supply for you:
 9. **`--shell-topbar-height` is private to the sheet**, deliberately outside the
    `--tai-*` contract. Do not read it; it is not part of the published API.
 
+## Design rules
+
+These rules hold for every Studio screen and for a plugin page that wants to sit
+beside them. They name the SDK pieces each case is built from, so a screen reads
+the same way wherever it comes from.
+
+**Tokens.** Colour, space, radius, type, motion and elevation come only from the
+names in `TOKEN_NAMES`; a literal colour is never written. Every colour pair is
+checked in both themes, the light `--tai-color-*` and the dark
+`--tai-dark-color-*` values. A status is never told by hue alone: an icon or a word
+sits beside it. The accent is the brand colour only, never a status.
+
+**Spacing.** A page is padded by `.tai-page`. Vertical rhythm is `.tai-stack`
+(space-4); inside a group it is `.tai-stack-2`, between groups in a card
+`.tai-stack-3`, and between the sections of a page `.tai-stack-6`. A row of
+controls is `.tai-row`.
+
+**Screen patterns.** A new screen uses one of these patterns. A screen with tabs
+under its header (Settings, Dashboard, Marketplace, the Conversations landing)
+takes a pattern per tab.
+
+- **Browse and inspect.** A split list and detail (`.tai-split`), with the
+  selection held in the URL search. Tools, whose list pane is an `ExplorerView`;
+  Presets; States; Storage; a Conversations route, its threads beside the open
+  transcript.
+- **Catalog.** A directory of cards with search and filters. Connectors and the
+  Tools card view, through `ExplorerView`; the Marketplace Browse tab, a card grid
+  with facet filters and Load more.
+- **Registry.** Tables or lists of records in cards. Create and the row actions
+  open a dialog built on `Dialog` (`FormDialog` or the screen's own); edit opens
+  one too or happens in place; a destructive action is confirmed before it runs.
+  Scheduling, Members, the Conversations routes and per-target configs, the
+  Marketplace Installed tab, and the Profiles, API keys and Roles tabs of
+  Settings.
+- **Registry with inline create.** The records list first, then the create forms
+  in cards on the page below them; edit, where a record has one, in a `Dialog`; a
+  destructive action confirmed before it runs. Hooks, Served endpoints.
+- **Replaced detail.** A search param swaps the page or the tab for one item. The
+  Marketplace plugin page, a trace in the Dashboard Tracing tab, a state template
+  or a state's records.
+- **Run surface.** A list, then the run view in its place. Agents.
+- **Inbox.** Newest-first cards, the rest paged in by a button at the foot: Load
+  more where the server pages (Interactions), Show more where the whole feed is
+  already loaded (Notifications).
+- **Status and configuration.** Stacked cards of read-only views and in-place
+  editors, no create dialog; a destructive or fleet-wide action is confirmed in a
+  `ConfirmDialog`. Manifest, System, the Dashboard tab of Dashboard, the Settings,
+  Environment and Backup tabs of Settings, and the Failed deliveries tab of the
+  Conversations landing (one read-only card that re-reads itself).
+
+A multi-step create is a `Stepper` inside a `Dialog`.
+
+**States.** A page or a region (a card, a pane, a tab) shows one state at a time,
+each drawn by its SDK piece:
+
+- loading: a `Skeleton` in the shape of the content, or a labelled `Spinner` where
+  the content has no fixed shape;
+- empty: an `EmptyState` whose title says what is missing and whose `action`
+  gives the next step;
+- off, when the server answers that the feature is not configured:
+  `FeatureDisabled`;
+- no grant: as below;
+- failed: an `ErrorState`, with `onRetry` when a retry can succeed;
+- then the content.
+
+Content already drawn stays when a later read fails (the next page, a secondary
+read): the failure is shown beside it, as an `ErrorState` or a muted line saying
+what could not be read and why. A control inside a form follows the picker rules
+instead.
+
+**No grant.** What the caller's access does not reach is not drawn. A write
+control is hidden through `useCanWrite`, never shown disabled, and in its place,
+where the reader would look for it, a muted `role="status"` line says what is out
+of reach and, where the screen knows it, the access it needs ("Running this tool
+is outside your access — it is shown read-only."). A whole region the caller
+cannot read is an `EmptyState` whose title says it is not available and whose
+description says what it would show and the access it needs. A no-grant state
+has no Retry and never wears the error ground: a refusal is an answer, not a
+failure. Readable content stays, read-only. A secondary control (a row's Delete)
+is hidden without a line. A screen the caller cannot reach leaves the sidebar;
+its URL still renders, and a refusal the screen did not expect is an
+`ErrorState`.
+
+**Disabled controls and results.** A control disabled for a reason the screen
+does not otherwise show says the reason in text beside it. There is no toast: a
+result is shown inline next to the control that caused it, a `role="status"` line
+for an outcome and `role="alert"` (or an `ErrorState`) for a failure.
+
+**Pickers.** A picker is an SDK component wrapped in `Field` with a visible
+label. It reads a structural query interface
+(`{ data, isPending, isError, isSuccess, error, refetch }`, the shape
+`ExecutionKeyPicker` takes) and names no query library. Pending is the control
+disabled with the placeholder "Loading <plural noun>…"; error is an `ErrorState`
+with retry inside the field (`group` set); empty is a muted `role="status"` line
+naming where to create one; no grant to read the list is the no-grant line in
+place of the control. Values render as text, never HTML. A picker is composed
+outside `SchemaForm`. Two cases differ:
+
+- A picker that is one control of a larger group on its host (a `fieldset` whose
+  `legend` names the group) takes no label of its own: its control carries an
+  `aria-label` that names it within the group (the legend, then what the control
+  picks), and its states render in the same place without a `Field`.
+- When the read behind the list fails and the same failure is already shown once,
+  with retry, elsewhere on the same surface, the picker draws no second
+  `ErrorState`: in place of the control it shows a muted `role="status"` line
+  saying the list could not be read and where that error is shown, with no retry.
+  A surface shows one failure with retry once.
+
+**Stepper.** An ordered list in a labelled `nav`, with `aria-current="step"` on
+the current step and each step's status spoken in visually hidden text. Done,
+current, upcoming and error are told apart by marker shape and icon as well as
+colour, filled with the ok and err tokens (never the accent, never a destructive
+token). Tab and Enter or Space reach only the steps that can be revisited. Below
+the narrow breakpoint (640 px) the list collapses to "Step n of m: <label>".
+Motion follows the reduced-motion rule, and targets are 44 px on coarse pointers.
+
+**Keyboard and accessibility.** There are no global shortcuts. Every interactive
+element is reachable by Tab in reading order; Enter and Space work on custom rows;
+the focus-visible ring comes from the five-state contract. A route change moves
+focus to the page `<h1>`; dialogs trap focus and return it. The bar is WCAG
+2.0/2.1 A and AA in both themes, enforced by an axe audit over every route and by
+the SDK's guard tests.
+
 ## Usage
 
 ```ts

package/dist/components/action-menu.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `ActionMenu` — a row's or a card's overflow menu: a ghost "Actions" button
+ * whose accessible name the caller completes ("Actions for <name>", which keeps
+ * the visible word at its start) that opens a `role="menu"` list of
+ * `role="menuitem"` buttons, the WAI-ARIA menu-button pattern.
+ *
+ * Opening moves focus to the first item; ArrowDown/ArrowUp move between items
+ * (wrapping), Home/End jump to the ends, Escape closes and returns focus to the
+ * trigger, Tab closes. Activating an item closes the menu, returns focus to the
+ * trigger, then runs the item's action, so a dialog the action opens takes focus
+ * from a settled trigger. A pointer press outside the menu closes it.
+ *
+ * The caller passes only the items the session may use; with none the menu is
+ * not drawn at all (a hidden control takes no line).
+ */
+import { type ReactNode } from 'react';
+export interface ActionMenuItem {
+    readonly id: string;
+    readonly label: string;
+    readonly onSelect: () => void;
+    /** Paints the item in the error tone (a destructive action). */
+    readonly danger?: boolean;
+}
+export interface ActionMenuProps {
+    /** The trigger's accessible name, e.g. "Actions for Acme". */
+    readonly label: string;
+    readonly items: readonly ActionMenuItem[];
+}
+export declare function ActionMenu({ label, items }: ActionMenuProps): ReactNode;
+//# sourceMappingURL=action-menu.d.ts.map

package/dist/components/action-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-menu.d.ts","sourceRoot":"","sources":["../../src/components/action-menu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAsB,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAI/F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAED,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,eAAe,GAAG,SAAS,CA8HvE"}

package/dist/components/action-menu.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `ActionMenu` — a row's or a card's overflow menu: a ghost "Actions" button
+ * whose accessible name the caller completes ("Actions for <name>", which keeps
+ * the visible word at its start) that opens a `role="menu"` list of
+ * `role="menuitem"` buttons, the WAI-ARIA menu-button pattern.
+ *
+ * Opening moves focus to the first item; ArrowDown/ArrowUp move between items
+ * (wrapping), Home/End jump to the ends, Escape closes and returns focus to the
+ * trigger, Tab closes. Activating an item closes the menu, returns focus to the
+ * trigger, then runs the item's action, so a dialog the action opens takes focus
+ * from a settled trigger. A pointer press outside the menu closes it.
+ *
+ * The caller passes only the items the session may use; with none the menu is
+ * not drawn at all (a hidden control takes no line).
+ */
+import { useEffect, useId, useRef, useState } from 'react';
+import { ChevronDownIcon } from './icons';
+export function ActionMenu({ label, items }) {
+    const [open, setOpen] = useState(false);
+    const menuId = useId();
+    const triggerRef = useRef(null);
+    const menuRef = useRef(null);
+    const itemRefs = useRef([]);
+    useEffect(() => {
+        if (!open)
+            return undefined;
+        itemRefs.current[0]?.focus();
+        const onPointerDown = (event) => {
+            const target = event.target;
+            if (target === null)
+                return;
+            if (menuRef.current?.contains(target) === true)
+                return;
+            if (triggerRef.current?.contains(target) === true)
+                return;
+            setOpen(false);
+        };
+        document.addEventListener('pointerdown', onPointerDown);
+        return () => {
+            document.removeEventListener('pointerdown', onPointerDown);
+        };
+    }, [open]);
+    if (items.length === 0)
+        return null;
+    const close = () => {
+        setOpen(false);
+        triggerRef.current?.focus();
+    };
+    const focusItem = (index) => {
+        const count = items.length;
+        itemRefs.current[((index % count) + count) % count]?.focus();
+    };
+    const onMenuKeyDown = (event) => {
+        const current = itemRefs.current.findIndex((item) => item === document.activeElement);
+        switch (event.key) {
+            case 'ArrowDown':
+                event.preventDefault();
+                focusItem(current + 1);
+                break;
+            case 'ArrowUp':
+                event.preventDefault();
+                focusItem(current - 1);
+                break;
+            case 'Home':
+                event.preventDefault();
+                focusItem(0);
+                break;
+            case 'End':
+                event.preventDefault();
+                focusItem(items.length - 1);
+                break;
+            case 'Escape':
+                event.preventDefault();
+                event.stopPropagation();
+                close();
+                break;
+            case 'Tab':
+                setOpen(false);
+                break;
+            default:
+                break;
+        }
+    };
+    return (_jsxs("div", { className: "tai-action-menu", children: [_jsxs("button", { ref: triggerRef, type: "button", className: "tai-btn tai-btn-ghost", "aria-label": label, "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? menuId : undefined, onClick: () => {
+                    setOpen((was) => !was);
+                }, onKeyDown: (event) => {
+                    if (event.key === 'ArrowDown' && !open) {
+                        event.preventDefault();
+                        setOpen(true);
+                    }
+                }, children: ["Actions", _jsx(ChevronDownIcon, {})] }), open ? (_jsx("div", { ref: menuRef, id: menuId, role: "menu", tabIndex: -1, "aria-label": label, className: "tai-action-menu-list", onKeyDown: onMenuKeyDown, children: items.map((item, index) => (_jsx("button", { ref: (node) => {
+                        itemRefs.current[index] = node;
+                    }, type: "button", role: "menuitem", tabIndex: -1, className: item.danger === true
+                        ? 'tai-action-menu-item tai-action-menu-item-danger'
+                        : 'tai-action-menu-item', onClick: () => {
+                        close();
+                        item.onSelect();
+                    }, children: item.label }, item.id))) })) : null] }));
+}
+//# sourceMappingURL=action-menu.js.map

package/dist/components/action-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-menu.js","sourceRoot":"","sources":["../../src/components/action-menu.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAsC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAgB1C,MAAM,UAAU,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,EAAmB;IAC1D,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAA+B,EAAE,CAAC,CAAC;IAE1D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAQ,EAAE;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;YAC3C,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO;YAC5B,IAAI,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI;gBAAE,OAAO;YACvD,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI;gBAAE,OAAO;YAC1D,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACxD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,KAAa,EAAQ,EAAE;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,KAAoC,EAAQ,EAAE;QACnE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,aAAa,CAAC,CAAC;QACtF,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC;YAClB,KAAK,WAAW;gBACd,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,SAAS;gBACZ,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,MAAM;gBACT,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,CAAC,CAAC,CAAC;gBACb,MAAM;YACR,KAAK,KAAK;gBACR,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,KAAK,CAAC,eAAe,EAAE,CAAC;gBACxB,KAAK,EAAE,CAAC;gBACR,MAAM;YACR,KAAK,KAAK;gBACR,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,eAAK,SAAS,EAAC,iBAAiB,aAC9B,kBACE,GAAG,EAAE,UAAU,EACf,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,uBAAuB,gBACrB,KAAK,mBACH,MAAM,mBACL,IAAI,mBACJ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EACxC,OAAO,EAAE,GAAG,EAAE;oBACZ,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC,EACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;oBACnB,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;wBACvC,KAAK,CAAC,cAAc,EAAE,CAAC;wBACvB,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC,wBAGD,KAAC,eAAe,KAAG,IACZ,EACR,IAAI,CAAC,CAAC,CAAC,CACN,cACE,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAC,MAAM,EACX,QAAQ,EAAE,CAAC,CAAC,gBACA,KAAK,EACjB,SAAS,EAAC,sBAAsB,EAChC,SAAS,EAAE,aAAa,YAEvB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,iBAEE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;wBACZ,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;oBACjC,CAAC,EACD,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,UAAU,EACf,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EACP,IAAI,CAAC,MAAM,KAAK,IAAI;wBAClB,CAAC,CAAC,kDAAkD;wBACpD,CAAC,CAAC,sBAAsB,EAE5B,OAAO,EAAE,GAAG,EAAE;wBACZ,KAAK,EAAE,CAAC;wBACR,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAClB,CAAC,YAEA,IAAI,CAAC,KAAK,IAjBN,IAAI,CAAC,EAAE,CAkBL,CACV,CAAC,GACE,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/components/agent-picker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `AgentPicker` — picks a registered agent by name from the agent list read
+ * (`GET /api/agents`) the host owns and hands in. Presentational: it fetches nothing
+ * and names no query library. It draws the read's states and its own copy, and flags
+ * a stored agent the loaded list does not hold as "not registered".
+ */
+import type { AgentListing } from '@tai42/api-client';
+import type { ReactNode } from 'react';
+import { type ListReadFlags } from './named-list-picker';
+/** The subset of the agent list read this picker reads; a TanStack query result satisfies it. */
+export interface AgentListQuery extends ListReadFlags {
+    readonly data: AgentListing | undefined;
+}
+export interface AgentPickerProps {
+    readonly query: AgentListQuery;
+    readonly value: string;
+    readonly onValueChange: (value: string) => void;
+    /** The host form's field error, shown under the control while a `Select` renders. */
+    readonly error?: string | undefined;
+}
+export declare function AgentPicker({ query, value, onValueChange, error }: AgentPickerProps): ReactNode;
+//# sourceMappingURL=agent-picker.d.ts.map

package/dist/components/agent-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-picker.d.ts","sourceRoot":"","sources":["../../src/components/agent-picker.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,qBAAqB,CAAC;AAE9F,iGAAiG;AACjG,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAiBD,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAY/F"}

package/dist/components/agent-picker.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AppLink } from '../navigation/app-link';
+import { NamedListPicker } from './named-list-picker';
+const COPY = {
+    label: 'Agent',
+    loadingPlaceholder: 'Loading agents…',
+    placeholder: 'Select an agent',
+    forbiddenNote: 'This session cannot list agents. Picking one needs read access to GET /api/agents; ask an administrator to grant it.',
+    emptyNote: 'No agents are registered on this deployment.',
+    emptyAction: (_jsx(AppLink, { to: "agents", className: "tai-link", children: "Open the Agents screen" })),
+    unlistedLabel: 'not registered',
+};
+export function AgentPicker({ query, value, onValueChange, error }) {
+    const names = (query.data?.items ?? []).map((item) => item.name);
+    return (_jsx(NamedListPicker, { query: query, names: names, value: value, onValueChange: onValueChange, error: error, copy: COPY }));
+}
+//# sourceMappingURL=agent-picker.js.map

package/dist/components/agent-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-picker.js","sourceRoot":"","sources":["../../src/components/agent-picker.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAA0C,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAe9F,MAAM,IAAI,GAAkB;IAC1B,KAAK,EAAE,OAAO;IACd,kBAAkB,EAAE,iBAAiB;IACrC,WAAW,EAAE,iBAAiB;IAC9B,aAAa,EACX,sHAAsH;IACxH,SAAS,EAAE,8CAA8C;IACzD,WAAW,EAAE,CACX,KAAC,OAAO,IAAC,EAAE,EAAC,QAAQ,EAAC,SAAS,EAAC,UAAU,uCAE/B,CACX;IACD,aAAa,EAAE,gBAAgB;CAChC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAoB;IAClF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CACL,KAAC,eAAe,IACd,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,GACV,CACH,CAAC;AACJ,CAAC"}

package/dist/components/channel-picker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `ChannelPicker` — picks an installed channel plugin by name from the channel list
+ * read (`GET /api/channels`) the host owns and hands in. Presentational: it fetches
+ * nothing and names no query library. It draws the read's states and its own copy,
+ * and flags a stored channel the loaded list does not hold as "not installed".
+ */
+import type { Channels } from '@tai42/api-client';
+import type { ReactNode } from 'react';
+import { type ListReadFlags } from './named-list-picker';
+/** The subset of the channel list read this picker reads; a TanStack query result satisfies it. */
+export interface ChannelListQuery extends ListReadFlags {
+    readonly data: Channels | undefined;
+}
+export interface ChannelPickerProps {
+    readonly query: ChannelListQuery;
+    readonly value: string;
+    readonly onValueChange: (value: string) => void;
+    /** The host form's field error, shown under the control while a `Select` renders. */
+    readonly error?: string | undefined;
+}
+/**
+ * The named channel's declared hint for a route's identity: the hint, `null` for a
+ * listed channel that declares none, `undefined` when the name is not listed.
+ */
+export declare function channelIdentityHint(data: Channels, name: string): string | null | undefined;
+export declare function ChannelPicker({ query, value, onValueChange, error, }: ChannelPickerProps): ReactNode;
+//# sourceMappingURL=channel-picker.d.ts.map

package/dist/components/channel-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-picker.d.ts","sourceRoot":"","sources":["../../src/components/channel-picker.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,qBAAqB,CAAC;AAE9F,mGAAmG;AACnG,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAG3F;AAkBD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,KAAK,EACL,aAAa,EACb,KAAK,GACN,EAAE,kBAAkB,GAAG,SAAS,CAYhC"}

package/dist/components/channel-picker.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { AppLink } from '../navigation/app-link';
+import { NamedListPicker } from './named-list-picker';
+/**
+ * The named channel's declared hint for a route's identity: the hint, `null` for a
+ * listed channel that declares none, `undefined` when the name is not listed.
+ */
+export function channelIdentityHint(data, name) {
+    const entry = data.channels.find((channel) => channel.name === name);
+    return entry === undefined ? undefined : entry.identity_hint;
+}
+const COPY = {
+    label: 'Channel',
+    description: 'An installed channel plugin; the answer goes back on the same channel.',
+    loadingPlaceholder: 'Loading channels…',
+    placeholder: 'Select a channel',
+    forbiddenNote: 'This session cannot list channels. Picking one needs read access to GET /api/channels; ask an administrator to grant it.',
+    emptyNote: 'No channels are installed on this deployment.',
+    emptyAction: (_jsx(AppLink, { to: "marketplace", search: { kind: 'channel' }, className: "tai-link", children: "Browse channel plugins" })),
+    unlistedLabel: 'not installed',
+};
+export function ChannelPicker({ query, value, onValueChange, error, }) {
+    const names = (query.data?.channels ?? []).map((channel) => channel.name);
+    return (_jsx(NamedListPicker, { query: query, names: names, value: value, onValueChange: onValueChange, error: error, copy: COPY }));
+}
+//# sourceMappingURL=channel-picker.js.map

package/dist/components/channel-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-picker.js","sourceRoot":"","sources":["../../src/components/channel-picker.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAA0C,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAe9F;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACrE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;AAC/D,CAAC;AAED,MAAM,IAAI,GAAkB;IAC1B,KAAK,EAAE,SAAS;IAChB,WAAW,EAAE,wEAAwE;IACrF,kBAAkB,EAAE,mBAAmB;IACvC,WAAW,EAAE,kBAAkB;IAC/B,aAAa,EACX,0HAA0H;IAC5H,SAAS,EAAE,+CAA+C;IAC1D,WAAW,EAAE,CACX,KAAC,OAAO,IAAC,EAAE,EAAC,aAAa,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,EAAC,UAAU,uCAEjE,CACX;IACD,aAAa,EAAE,eAAe;CAC/B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,KAAK,EACL,aAAa,EACb,KAAK,GACc;IACnB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO,CACL,KAAC,eAAe,IACd,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,GACV,CACH,CAAC;AACJ,CAAC"}