@tai42/studio-sdk 0.2.0

package/dist/components/extension-combo-builder.js

@@ -0,0 +1,154 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `ExtensionComboBuilder` — a controlled editor for a preset/tool's LIST OF
+ * extension combos. A combo is an ordered list of extension ELEMENTS, each a bare
+ * extension NAME or a `{ name, config }` mapping carrying author config; the value
+ * is the list of combos (`PresetExtensionElement[][]`), the SAME shape the
+ * preset/tool extensions wire carries. It is PRESENTATIONAL: the caller fetches the
+ * extension catalog (`available`) and owns the `value`; this component fetches nothing.
+ *
+ * The surface has two parts:
+ *  - the current combos, each an ordered row of name `Badge`s with a per-combo Edit
+ *    (pull it back into the draft) and Remove;
+ *  - a combo UNDER CONSTRUCTION, authored with the shared `ExtensionPicker` (grouped
+ *    by kind, single-select for the non-stackable `backend` kind). When the draft
+ *    includes the `output_schema` extension, its config is authored inline with a
+ *    `SchemaEditor` (no title required); an "Add combo" / "Update combo" action
+ *    composes the elements — `output_schema` as `{ name, config: { schema } }`, every
+ *    other extension as a bare name — and writes it into the value.
+ *
+ * The builder only blocks the client-trivial invalids: an EMPTY combo (Add is
+ * disabled until the draft has ≥1 member), a DUPLICATE of a combo already in the
+ * value (by name sequence; flagged inline, Add blocked), an INVALID `output_schema`
+ * config (the `SchemaEditor` shows the parse/lint error and Add is blocked), and an
+ * UNKNOWN extension name in an existing combo (a name absent from `available`, which
+ * happens when a plugin is removed after a preset was authored) — flagged inline on
+ * that combo row and reported through `onValidityChange` so the caller can block
+ * submit. Every deeper rule — the registry's one-per-non-stackable-kind constraint,
+ * meta-schema validity, kind/ordering — is SERVER-AUTHORITATIVE: the write route
+ * validates each combo and its 400 message is surfaced verbatim by the caller.
+ *
+ * Loading is signaled by `availableReady`: while the catalog is still loading the
+ * builder reports VALID and suppresses the unknown-name notes (no danger-note flash
+ * while submit stays enabled — the server backstops), so a stale-seeded combo does
+ * not flicker invalid before the catalog resolves.
+ *
+ * SAFETY: an extension name is server-supplied, so every name renders as TEXT through
+ * the DS `Badge`/`Checkbox` (React escapes it) — never an HTML sink.
+ *
+ * Geometry and ink come from the design-system classes: each committed combo is a
+ * `tai-card` row, the invalid notes are `tai-field-error` (icon + message, never
+ * color alone), and Remove is a labelled `Button` carrying `CloseIcon` beside the
+ * word, under an accessible name that names the combo it removes.
+ */
+import { Fragment, useEffect, useState } from 'react';
+import { comboElementNames, extensionElementName } from '../extension-combos';
+import { SchemaEditor } from '../schema-editor';
+import { Badge } from './badge';
+import { ExtensionPicker } from './extension-picker';
+import { CloseIcon, XCircleIcon } from './icons';
+import { Button } from './primitives';
+/** The one config-taking extension this builder authors inline. */
+const OUTPUT_SCHEMA = 'output_schema';
+/** Two combos are equal when their NAME sequences match (config is not part of identity). */
+function sameNames(a, b) {
+    return a.length === b.length && a.every((name, index) => name === b[index]);
+}
+/** The stored `output_schema` config schema for a combo, if it carries one. */
+function outputSchemaConfig(combo) {
+    for (const element of combo) {
+        if (typeof element !== 'string' && element.name === OUTPUT_SCHEMA) {
+            const schema = element.config.schema;
+            return typeof schema === 'object' && schema !== null && !Array.isArray(schema)
+                ? schema
+                : {};
+        }
+    }
+    return null;
+}
+/** The element names in a combo that are absent from the known catalog. */
+function unknownNames(combo, availableNames) {
+    return comboElementNames(combo).filter((name) => !availableNames.has(name));
+}
+export function ExtensionComboBuilder({ available, value, onChange, disabled, idPrefix = 'extension-combo-builder', onValidityChange, availableReady = true, }) {
+    const [draft, setDraft] = useState([]);
+    const [draftConfig, setDraftConfig] = useState({ schema: null, valid: true });
+    // The index of the combo being edited (pulled into the draft), or `null` for a new one.
+    const [editing, setEditing] = useState(null);
+    const draftHasOutputSchema = draft.includes(OUTPUT_SCHEMA);
+    const isDuplicate = draft.length > 0 &&
+        value.some((combo, index) => index !== editing && sameNames(comboElementNames(combo), draft));
+    const configInvalid = draftHasOutputSchema && !draftConfig.valid;
+    const canAdd = !disabled && draft.length > 0 && !isDuplicate && !configInvalid;
+    // Unknown-name validation over the EXISTING combos. Until the catalog is ready the
+    // builder reports VALID and suppresses the notes (no flash on a stale-seeded combo).
+    const availableNames = new Set(available.map((extension) => extension.name));
+    const hasUnknownName = availableReady && value.some((combo) => unknownNames(combo, availableNames).length > 0);
+    const valid = !hasUnknownName;
+    useEffect(() => {
+        onValidityChange?.(valid);
+    }, [onValidityChange, valid]);
+    const resetDraft = () => {
+        setDraft([]);
+        setDraftConfig({ schema: null, valid: true });
+        setEditing(null);
+    };
+    /**
+     * Compose the draft names into config-bearing elements. `output_schema` takes the
+     * inline-authored config; every other name keeps the edited combo's existing
+     * element verbatim when it survives — preserving any author `config` (e.g. an
+     * `ask_external` verifier) the builder does not itself author — and a newly-added
+     * name becomes a bare-name element.
+     */
+    const composeCombo = () => {
+        const source = editing === null ? undefined : value[editing];
+        const byName = new Map();
+        if (source !== undefined) {
+            for (const element of source)
+                byName.set(extensionElementName(element), element);
+        }
+        return draft.map((name) => name === OUTPUT_SCHEMA
+            ? { name, config: { schema: draftConfig.schema ?? {} } }
+            : (byName.get(name) ?? name));
+    };
+    const commitCombo = () => {
+        if (!canAdd)
+            return;
+        const composed = composeCombo();
+        if (editing === null) {
+            onChange([...value.map((combo) => [...combo]), composed]);
+        }
+        else {
+            onChange(value.map((combo, index) => (index === editing ? composed : [...combo])));
+        }
+        resetDraft();
+    };
+    const startEdit = (index) => {
+        const combo = value[index];
+        if (combo === undefined)
+            return;
+        setDraft(comboElementNames(combo));
+        setDraftConfig({ schema: outputSchemaConfig(combo), valid: true });
+        setEditing(index);
+    };
+    const removeCombo = (index) => {
+        onChange(value.filter((_, i) => i !== index).map((combo) => [...combo]));
+        // Removing the row under edit (or one before it) invalidates the draft target.
+        if (editing !== null && (editing === index || editing > index))
+            resetDraft();
+    };
+    return (_jsxs("div", { "data-testid": idPrefix, className: "tai-stack", children: [value.length > 0 ? (_jsx("ul", { className: "tai-stack tai-stack-2", children: value.map((combo, index) => {
+                    const names = comboElementNames(combo);
+                    const unknown = availableReady ? unknownNames(combo, availableNames) : [];
+                    return (
+                    // The index IS the identity here: the list mutates by append, in-place
+                    // update, and remove-by-index (no reorder), and a combo has no stable id
+                    // of its own — so an index key is stable and cannot collide.
+                    _jsxs("li", { className: "tai-card tai-stack tai-stack-2", children: [_jsxs("div", { className: "tai-row", children: [_jsx("span", { className: "tai-row", children: names.map((name, position) => (_jsxs(Fragment, { children: [position > 0 ? (_jsx("span", { "aria-hidden": true, className: "tai-muted", children: "+" })) : null, _jsx(Badge, { variant: unknown.includes(name) ? 'danger' : 'primary', children: name })] }, `${name}-${String(position)}`))) }), _jsx(Button, { type: "button", "aria-label": `${editing === index ? 'Editing' : 'Edit'} combo ${names.join('+')}`, disabled: disabled === true || editing === index, onClick: () => {
+                                            startEdit(index);
+                                        }, children: editing === index ? 'Editing' : 'Edit' }), _jsxs(Button, { type: "button", "aria-label": `Remove combo ${names.join('+')}`, disabled: disabled, onClick: () => {
+                                            removeCombo(index);
+                                        }, children: [_jsx(CloseIcon, {}), "Remove"] })] }), unknown.length > 0 ? (_jsxs("p", { role: "alert", className: "tai-field-error", children: [_jsx(XCircleIcon, {}), unknown.length === 1 ? 'Unknown extension: ' : 'Unknown extensions: ', unknown.join(', '), "."] })) : null] }, index));
+                }) })) : (_jsx("p", { className: "tai-muted", children: "No extension combos." })), _jsxs("div", { className: "tai-stack tai-stack-2", children: [_jsx(ExtensionPicker, { available: available, value: draft, onChange: setDraft, disabled: disabled, idPrefix: `${idPrefix}-draft` }), draftHasOutputSchema ? (_jsx(SchemaEditor, { value: draftConfig.schema, onChange: setDraftConfig, requireTitle: false, label: "Output schema", description: "The JSON Schema the output_schema extension enforces on this combo's result.", disabled: disabled, idPrefix: `${idPrefix}-output-schema` }, editing === null ? 'new' : `edit-${String(editing)}`)) : null, isDuplicate ? (_jsxs("p", { role: "alert", className: "tai-field-error", children: [_jsx(XCircleIcon, {}), "This combo is already added."] })) : null, _jsxs("div", { className: "tai-row", children: [_jsx(Button, { type: "button", variant: "primary", onClick: commitCombo, disabled: !canAdd, children: editing === null ? 'Add combo' : 'Update combo' }), editing !== null ? (_jsx(Button, { type: "button", onClick: resetDraft, disabled: disabled, children: "Cancel edit" })) : null] })] })] }));
+}
+//# sourceMappingURL=extension-combo-builder.js.map

package/dist/components/extension-combo-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-combo-builder.js","sourceRoot":"","sources":["../../src/components/extension-combo-builder.tsx"],"names":[],"mappings":"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"}

package/dist/components/extension-grouping.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Pure catalog-shaping helpers for the extensions surface — the SHARED grouping
+ * source for both the read-only extensions catalog (`features/extensions`) and the
+ * `ExtensionPicker`. Kept free of React so the grouping logic is unit-tested
+ * directly.
+ *
+ * The `/api/extensions` catalog is a flat list of `{ name, kind }` entries. Two
+ * independent groupings live here:
+ *  - `groupIntoFamilies` groups a tool's composed branch VARIANTS (which share a
+ *    base tool name and append underscore suffixes — `tool`, `tool_a`, `tool_a_b`)
+ *    back into one FAMILY keyed by that base name (the catalog view);
+ *  - `groupByKind` groups the catalog by extension KIND (the picker view), where
+ *    the `backend` kind is the single non-stackable one.
+ * `kindVariant` maps each serialized `kind` value to a design-system Badge variant.
+ */
+import type { Extension } from '@tai42/api-client';
+import type { BadgeProps } from './badge';
+/**
+ * The single non-stackable extension kind: at most one `backend` extension may
+ * appear in a combo (the `backend` kind is declared non-stackable, `multiple=False`).
+ * The `ExtensionPicker` enforces single-select for this kind.
+ */
+export declare const NON_STACKABLE_KIND = "backend";
+/** One base tool and every extension entry that branches from it. */
+export interface ExtensionFamily {
+    /** The base tool name (the segment before the first underscore). */
+    readonly base: string;
+    /** The family's entries, ordered by full name. */
+    readonly members: readonly Extension[];
+}
+/** One extension `kind` and every catalog entry of that kind. */
+export interface ExtensionKindGroup {
+    /** The serialized kind value (`wrapper` / `transformer` / `backend`). */
+    readonly kind: string;
+    /** Whether this kind is non-stackable (single-select in the picker). */
+    readonly nonStackable: boolean;
+    /** The kind's entries, ordered by name. */
+    readonly members: readonly Extension[];
+}
+/**
+ * The base tool name a variant belongs to: the substring before the first
+ * underscore, or the whole name when it has none. `tool`, `tool_a`, `tool_a_b`
+ * all resolve to `tool`; `x_chain` and `x_batch` both resolve to `x`.
+ */
+export declare function baseNameOf(name: string): string;
+/**
+ * Group a flat extension list into families keyed by base tool name. Families
+ * are ordered by base name and each family's members by full name, so the render
+ * order is stable regardless of the server's list order.
+ */
+export declare function groupIntoFamilies(extensions: readonly Extension[]): ExtensionFamily[];
+/**
+ * Group a flat extension list by `kind`, for the picker. Groups are ordered by
+ * kind and each group's members by name, so the render order is stable regardless
+ * of the server's list order. The `backend` group is flagged non-stackable.
+ */
+export declare function groupByKind(extensions: readonly Extension[]): ExtensionKindGroup[];
+/**
+ * Map a serialized extension `kind` to a Badge variant. Known skeleton kinds get
+ * a themed color; any unrecognized kind falls back to the neutral variant (the
+ * Badge itself also neutral-fallbacks, but choosing here keeps the mapping
+ * explicit and testable).
+ */
+export declare function kindVariant(kind: string): NonNullable<BadgeProps['variant']>;
+//# sourceMappingURL=extension-grouping.d.ts.map

package/dist/components/extension-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-grouping.d.ts","sourceRoot":"","sources":["../../src/components/extension-grouping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,eAAe,EAAE,CAiBrF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAiBlF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAO5E"}

package/dist/components/extension-grouping.js

@@ -0,0 +1,78 @@
+/**
+ * The single non-stackable extension kind: at most one `backend` extension may
+ * appear in a combo (the `backend` kind is declared non-stackable, `multiple=False`).
+ * The `ExtensionPicker` enforces single-select for this kind.
+ */
+export const NON_STACKABLE_KIND = 'backend';
+/**
+ * The base tool name a variant belongs to: the substring before the first
+ * underscore, or the whole name when it has none. `tool`, `tool_a`, `tool_a_b`
+ * all resolve to `tool`; `x_chain` and `x_batch` both resolve to `x`.
+ */
+export function baseNameOf(name) {
+    const separator = name.indexOf('_');
+    return separator === -1 ? name : name.slice(0, separator);
+}
+/**
+ * Group a flat extension list into families keyed by base tool name. Families
+ * are ordered by base name and each family's members by full name, so the render
+ * order is stable regardless of the server's list order.
+ */
+export function groupIntoFamilies(extensions) {
+    const byBase = new Map();
+    for (const extension of extensions) {
+        const base = baseNameOf(extension.name);
+        const members = byBase.get(base);
+        if (members) {
+            members.push(extension);
+        }
+        else {
+            byBase.set(base, [extension]);
+        }
+    }
+    return [...byBase.entries()]
+        .map(([base, members]) => ({
+        base,
+        members: [...members].sort((a, b) => a.name.localeCompare(b.name)),
+    }))
+        .sort((a, b) => a.base.localeCompare(b.base));
+}
+/**
+ * Group a flat extension list by `kind`, for the picker. Groups are ordered by
+ * kind and each group's members by name, so the render order is stable regardless
+ * of the server's list order. The `backend` group is flagged non-stackable.
+ */
+export function groupByKind(extensions) {
+    const byKind = new Map();
+    for (const extension of extensions) {
+        const members = byKind.get(extension.kind);
+        if (members) {
+            members.push(extension);
+        }
+        else {
+            byKind.set(extension.kind, [extension]);
+        }
+    }
+    return [...byKind.entries()]
+        .map(([kind, members]) => ({
+        kind,
+        nonStackable: kind === NON_STACKABLE_KIND,
+        members: [...members].sort((a, b) => a.name.localeCompare(b.name)),
+    }))
+        .sort((a, b) => a.kind.localeCompare(b.kind));
+}
+/**
+ * Map a serialized extension `kind` to a Badge variant. Known skeleton kinds get
+ * a themed color; any unrecognized kind falls back to the neutral variant (the
+ * Badge itself also neutral-fallbacks, but choosing here keeps the mapping
+ * explicit and testable).
+ */
+export function kindVariant(kind) {
+    const known = {
+        wrapper: 'primary',
+        transformer: 'success',
+        backend: 'warning',
+    };
+    return known[kind] ?? 'neutral';
+}
+//# sourceMappingURL=extension-grouping.js.map

package/dist/components/extension-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-grouping.js","sourceRoot":"","sources":["../../src/components/extension-grouping.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,35 @@
+/**
+ * `ExtensionPicker` — a controlled multi-select over the extension catalog
+ * (`GET /api/extensions`), authoring ONE extension combo (an ordered list of
+ * extension names). Built on the DS `Checkbox` so features share one picker
+ * instead of re-implementing a checklist (the same reason `SchemaForm`/`ToolPicker`
+ * live in the SDK). It is PRESENTATIONAL: the caller fetches `available` and owns
+ * the selected `value`; this component fetches nothing.
+ *
+ * The catalog is GROUPED by `kind`. The `backend` kind is the single NON-STACKABLE
+ * one (`multiple=False`), so it is SINGLE-SELECT — checking a backend
+ * extension replaces any other backend already in the combo; every other kind is
+ * freely multi-select. Selection order is preserved (the combo is ordered — the
+ * stacking order that produces the branch tool name), so a newly-checked extension
+ * appends to the end and unchecking removes in place.
+ *
+ * SAFETY: an extension name AND its kind are server-supplied, so every name/kind
+ * renders as TEXT through the DS `Checkbox`/`Badge` (React escapes it) — never an
+ * HTML sink. Pinned by a test.
+ *
+ * Geometry and ink come from the design-system layout classes (`tai-stack`,
+ * `tai-row`, `tai-muted`); the component carries no palette of its own.
+ */
+import type { Extension } from '@tai42/api-client';
+export interface ExtensionPickerProps {
+    /** The extension catalog (`GET /api/extensions`) the checklist is drawn from. */
+    readonly available: readonly Extension[];
+    /** The currently-selected extension names, in combo (stacking) order. */
+    readonly value: readonly string[];
+    /** Fired with the next ordered selection whenever a box toggles. */
+    readonly onChange: (names: string[]) => void;
+    readonly disabled?: boolean;
+    readonly idPrefix?: string;
+}
+export declare function ExtensionPicker({ available, value, onChange, disabled, idPrefix, }: ExtensionPickerProps): import("react").JSX.Element;
+//# sourceMappingURL=extension-picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-picker.d.ts","sourceRoot":"","sources":["../../src/components/extension-picker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAA6B,GAC9B,EAAE,oBAAoB,+BAmDtB"}

package/dist/components/extension-picker.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge } from './badge';
+import { Checkbox } from './checkbox';
+import { groupByKind, kindVariant } from './extension-grouping';
+export function ExtensionPicker({ available, value, onChange, disabled, idPrefix = 'extension-picker', }) {
+    const groups = groupByKind(available);
+    const selected = new Set(value);
+    /**
+     * Toggle a single extension. For a NON-STACKABLE kind (`backend`), checking one
+     * first strips any other selected member of that kind before appending, so the
+     * combo carries at most one backend; unchecking just removes it. Order is
+     * preserved: a newly-checked name lands at the end.
+     */
+    const toggle = (extension, nonStackable, checked) => {
+        if (!checked) {
+            onChange(value.filter((name) => name !== extension.name));
+            return;
+        }
+        if (selected.has(extension.name))
+            return;
+        const siblingNames = nonStackable
+            ? new Set(available.filter((e) => e.kind === extension.kind).map((e) => e.name))
+            : undefined;
+        const kept = siblingNames === undefined ? [...value] : value.filter((name) => !siblingNames.has(name));
+        onChange([...kept, extension.name]);
+    };
+    return (_jsx("div", { "data-testid": idPrefix, className: "tai-stack", children: groups.map((group) => (_jsxs("div", { className: "tai-stack tai-stack-2", children: [_jsxs("div", { className: "tai-row", children: [_jsx(Badge, { variant: kindVariant(group.kind), children: group.kind }), group.nonStackable ? _jsx("span", { className: "tai-muted", children: "(single-select)" }) : null] }), _jsx("div", { className: "tai-row", children: group.members.map((extension) => (_jsx(Checkbox, { label: extension.name, checked: selected.has(extension.name), disabled: disabled, onCheckedChange: (checked) => {
+                            toggle(extension, group.nonStackable, checked);
+                        } }, extension.name))) })] }, group.kind))) }));
+}
+//# sourceMappingURL=extension-picker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-picker.js","sourceRoot":"","sources":["../../src/components/extension-picker.tsx"],"names":[],"mappings":";AAwBA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAahE,MAAM,UAAU,eAAe,CAAC,EAC9B,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,GAAG,kBAAkB,GACR;IACrB,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,MAAM,MAAM,GAAG,CAAC,SAAoB,EAAE,YAAqB,EAAE,OAAgB,EAAQ,EAAE;QACrF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO;QACzC,MAAM,YAAY,GAAG,YAAY;YAC/B,CAAC,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChF,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,IAAI,GACR,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5F,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO,CACL,6BAAkB,QAAQ,EAAE,SAAS,EAAC,WAAW,YAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,eAAsB,SAAS,EAAC,uBAAuB,aAGrD,eAAK,SAAS,EAAC,SAAS,aACtB,KAAC,KAAK,IAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,YAAG,KAAK,CAAC,IAAI,GAAS,EAC5D,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,WAAW,gCAAuB,CAAC,CAAC,CAAC,IAAI,IAC3E,EACN,cAAK,SAAS,EAAC,SAAS,YACrB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAChC,KAAC,QAAQ,IAEP,KAAK,EAAE,SAAS,CAAC,IAAI,EACrB,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EACrC,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;4BAC3B,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;wBACjD,CAAC,IANI,SAAS,CAAC,IAAI,CAOnB,CACH,CAAC,GACE,KAnBE,KAAK,CAAC,IAAI,CAoBd,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/external-link.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `ExternalLinkButton` — an open-link action for a URL the Studio did not author
+ * (a registry homepage, an interaction payload's link). Only an ABSOLUTE
+ * `http(s)` URL is navigable here: every other spelling — another scheme, and a
+ * relative reference, which would be a same-origin in-app navigation the caller
+ * never intended — is NEUTRALIZED into plain text with no anchor and no href.
+ * This is an XSS pin.
+ *
+ * The check and the neutralized rendering are `Button`'s; this module chooses the
+ * stricter of the two link policies rather than re-implementing either.
+ */
+import type { ReactNode } from 'react';
+export { isSafeHttpUrl } from './primitives';
+export interface ExternalLinkButtonProps {
+    readonly url: string;
+    readonly children?: ReactNode;
+}
+export declare function ExternalLinkButton({ url, children }: ExternalLinkButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=external-link.d.ts.map

package/dist/components/external-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-link.d.ts","sourceRoot":"","sources":["../../src/components/external-link.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,uBAAuB,+BAW5E"}

package/dist/components/external-link.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, buttonClass, DEFAULT_BUTTON_VARIANT, isSafeHttpUrl, NeutralizedLink, } from './primitives';
+export { isSafeHttpUrl } from './primitives';
+export function ExternalLinkButton({ url, children }) {
+    const label = children ?? url;
+    if (!isSafeHttpUrl(url)) {
+        // The same classes the navigable form wears, so the two never drift apart.
+        return (_jsx(NeutralizedLink, { className: buttonClass(DEFAULT_BUTTON_VARIANT, undefined), children: label }));
+    }
+    return _jsx(Button, { href: url, children: label });
+}
+//# sourceMappingURL=external-link.js.map

package/dist/components/external-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-link.js","sourceRoot":"","sources":["../../src/components/external-link.tsx"],"names":[],"mappings":";AAaA,OAAO,EACL,MAAM,EACN,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAO7C,MAAM,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAA2B;IAC3E,MAAM,KAAK,GAAG,QAAQ,IAAI,GAAG,CAAC;IAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,2EAA2E;QAC3E,OAAO,CACL,KAAC,eAAe,IAAC,SAAS,EAAE,WAAW,CAAC,sBAAsB,EAAE,SAAS,CAAC,YACvE,KAAK,GACU,CACnB,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,MAAM,IAAC,IAAI,EAAE,GAAG,YAAG,KAAK,GAAU,CAAC;AAC7C,CAAC"}

package/dist/components/field.d.ts

@@ -0,0 +1,64 @@
+import type { CSSProperties, ReactNode } from 'react';
+/** The a11y wiring a form control spreads onto its element. */
+export interface FieldControlProps {
+    readonly id: string | undefined;
+    readonly 'aria-describedby': string | undefined;
+    readonly 'aria-invalid': true | undefined;
+}
+/**
+ * Read the enclosing Field's wiring.
+ *
+ * `id` and `aria-describedby` are `undefined` both when there is no Field AND
+ * inside a group `Field`: a group has no single element to carry them, and the
+ * group container itself already carries the name and the description. Only
+ * `aria-invalid` still crosses that boundary, because `role="group"` does not
+ * support it (ARIA 1.2), so the control is the sole place an errored group can
+ * expose its invalid state.
+ */
+export declare function useFieldControl(): FieldControlProps;
+export interface FieldProps {
+    readonly label: string;
+    readonly description?: string;
+    readonly error?: string;
+    readonly children: ReactNode;
+    readonly style?: CSSProperties;
+    /** APPENDED to `tai-field` rather than replacing it, so the field keeps its paint. */
+    readonly className?: string;
+    /**
+     * Set when the wrapped control is a GROUP rather than one labelable element —
+     * a `RadioGroup`, a set of checkboxes, any `role="radiogroup"`/`role="group"`
+     * panel.
+     *
+     * `<label for>` can only name a labelable element: pointed at a group it
+     * either dangles at an id no element carries or names an element the browser
+     * refuses to label, and it is inert either way. So a group Field wraps
+     * `children` in the group CONTAINER itself — a `<div role="group">` carrying
+     * `aria-labelledby` at the label and `aria-describedby` at the description and
+     * error — and the label becomes a `<span>`, because a `<label>` associated
+     * with nothing is a semantics lie.
+     *
+     * IT ALSO CHANGES WHAT A CHILD READS FROM {@link useFieldControl}. The
+     * container is what carries the name and the description, so the group Field
+     * publishes NEITHER `id` NOR `aria-describedby` — both are `undefined`, and a
+     * control that spread them would take the group's own name and description for
+     * itself. `aria-invalid` still crosses: `role="group"` does not support it
+     * (ARIA 1.2), so the control is the only place an errored group can expose its
+     * invalid state.
+     *
+     * Naming therefore happens BY CONSTRUCTION rather than by the call site
+     * remembering to read a hook. The cost is one extra container announcement
+     * where the child has a group role of its own; that is accepted deliberately,
+     * because the two failure directions are asymmetric — a redundant container is
+     * audible, an unnamed group is silent.
+     *
+     * A group child left UNMARKED is a build failure, not a runtime surprise:
+     * `components/field-group.test.ts` ("Field group contract" → "marks every
+     * Field whose child does not claim its control id") scans every Field call
+     * site in the repository, and a child outside its list of control-id-claiming
+     * components — `RadioGroup` among them — reddens until the site passes
+     * `group`.
+     */
+    readonly group?: boolean;
+}
+export declare function Field({ label, description, error, children, style, className, group, }: FieldProps): import("react").JSX.Element;
+//# sourceMappingURL=field.d.ts.map

package/dist/components/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYtD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,KAAa,GACd,EAAE,UAAU,+BAiEZ"}

package/dist/components/field.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `Field` — the label + description + error wrapper every form control sits in.
+ * It owns one generated id and publishes it (plus the description/error ids and
+ * the invalid flag) through a context; a nested control reads them via
+ * `useFieldControl` and spreads them, so the label's `htmlFor`, the control's
+ * `aria-describedby`, and its `aria-invalid` stay wired without the caller
+ * threading ids by hand.
+ */
+import { createContext, useContext, useId } from 'react';
+import { XCircleIcon } from './icons';
+const FieldContext = createContext(null);
+/**
+ * Read the enclosing Field's wiring.
+ *
+ * `id` and `aria-describedby` are `undefined` both when there is no Field AND
+ * inside a group `Field`: a group has no single element to carry them, and the
+ * group container itself already carries the name and the description. Only
+ * `aria-invalid` still crosses that boundary, because `role="group"` does not
+ * support it (ARIA 1.2), so the control is the sole place an errored group can
+ * expose its invalid state.
+ */
+export function useFieldControl() {
+    const ctx = useContext(FieldContext);
+    if (ctx === null) {
+        return { id: undefined, 'aria-describedby': undefined, 'aria-invalid': undefined };
+    }
+    return {
+        id: ctx.controlId,
+        'aria-describedby': ctx.describedBy,
+        'aria-invalid': ctx.invalid ? true : undefined,
+    };
+}
+export function Field({ label, description, error, children, style, className, group = false, }) {
+    const controlId = useId();
+    const labelId = `${controlId}-label`;
+    const descriptionId = `${controlId}-desc`;
+    const errorId = `${controlId}-err`;
+    const describedByIds = [];
+    if (description !== undefined)
+        describedByIds.push(descriptionId);
+    if (error !== undefined)
+        describedByIds.push(errorId);
+    const describedBy = describedByIds.length > 0 ? describedByIds.join(' ') : undefined;
+    // A group withholds the ID and the DESCRIPTION — there is no single element to
+    // carry them, and a control that spread them inside a group would take the
+    // group's own name and description for itself — but it still publishes
+    // `invalid`. `aria-invalid` is not supported on `role="group"` (ARIA 1.2), so
+    // if the group Field withheld it too, a group Field carrying an `error` would
+    // expose its invalid state NOWHERE in the accessibility tree.
+    const value = group
+        ? { controlId: undefined, describedBy: undefined, invalid: error !== undefined }
+        : { controlId, describedBy, invalid: error !== undefined };
+    return (_jsx(FieldContext.Provider, { value: value, children: _jsxs("div", { className: className === undefined ? 'tai-field' : `tai-field ${className}`, style: style, children: [group ? (_jsx("span", { id: labelId, className: "tai-field-label", children: label })) : (_jsx("label", { id: labelId, htmlFor: controlId, className: "tai-field-label", children: label })), group ? (_jsx("div", { role: "group", "aria-labelledby": labelId, "aria-describedby": describedBy, className: "tai-field-group", children: children })) : (children), description !== undefined ? (_jsx("p", { id: descriptionId, className: "tai-field-hint", style: { margin: 0 }, children: description })) : null, error !== undefined ? (_jsxs("p", { id: errorId, role: "alert", className: "tai-field-error", style: { margin: 0 }, children: [_jsx(XCircleIcon, {}), error] })) : null] }) }));
+}
+//# sourceMappingURL=field.js.map

package/dist/components/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/components/field.tsx"],"names":[],"mappings":"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"}

package/dist/components/fleet-report.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `FleetReport` — the shared, loud rendering of a config mutation's fleet broadcast.
+ * Every mutation surface (connector, backup, mcp-config, env, extensions, single-MCP
+ * reload, fleet reload) computes a `FleetReportSummary` from its response through the
+ * api-client's shared handler and hands it here, so a FAILED propagation is never
+ * invisible.
+ *
+ * The `action` prop tunes the copy to the caller's framing: `'save'` (the default,
+ * used by every config-mutation surface) reports a saved change that did not fully
+ * propagate and points the operator at the System page to reload; `'reload'` (the
+ * System page's own fleet-reload action) drops the "Change saved" framing — nothing
+ * was saved, a reload was dispatched — and the self-referential System-page pointer.
+ *
+ * A `converged` summary (every origin applied, or a lone-worker local-only change)
+ * renders NOTHING — the calling surface shows its own success. A `degraded` summary
+ * (the bus was reached but a sibling did not confirm) or an `unreachable` summary (the
+ * bus itself failed) renders a loud `role="alert"` panel naming the honest per-origin
+ * outcomes: `failed` / `missing` / `departed` / `timed_out`, or the bus error. It
+ * never fakes success on a stranded origin. Every server-supplied string (an origin
+ * name, an error/detail message) renders as escaped React text, never an HTML sink.
+ *
+ * Every state — the headline and each origin's outcome — is a `tai-status` line: an
+ * icon MARK plus a word LABEL, with the tone color only reinforcing them, so the
+ * report is readable without color perception.
+ */
+import type { ReactNode } from 'react';
+import type { FleetReportSummary } from '@tai42/api-client';
+/**
+ * Render a fleet broadcast's failure state. Returns `null` for a converged/absent
+ * report (nothing to warn about) so callers can always mount it unconditionally
+ * beside their own success line.
+ */
+export interface FleetReportProps {
+    readonly summary: FleetReportSummary | null;
+    /** Whose framing the copy takes: a saved config change, or a dispatched reload. */
+    readonly action?: 'save' | 'reload';
+}
+export declare function FleetReport({ summary, action }: FleetReportProps): ReactNode;
+//# sourceMappingURL=fleet-report.d.ts.map

package/dist/components/fleet-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-report.d.ts","sourceRoot":"","sources":["../../src/components/fleet-report.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAgCjF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACrC;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAe,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAkErF"}