@tai42/studio-sdk 0.2.0

package/dist/hooks/useSse.js

@@ -0,0 +1,298 @@
+/**
+ * `useSse` — the live interactions stream, implemented over the api-client's
+ * `streamInteractions` (fetch + ReadableStream, never EventSource).
+ *
+ * SSE event contract: events `interaction.add` /
+ * `interaction.answered` / `interaction.removed` / `interaction.backlog_done`.
+ * The `add` frame (backlog on connect + live tail) carries the full question;
+ * `answered` / `removed` frames carry only ids. On (re)connect the server
+ * replays the current pending set as the backlog; this hook treats that backlog
+ * as authoritative — an entry not re-seen by `interaction.backlog_done` is
+ * dropped, so an interaction removed while the client was disconnected does not
+ * linger. `add` frames are at-least-once, so entries are de-duplicated by
+ * `interaction_id`, and a redelivered `add` preserves the client `answered` flag.
+ *
+ * The `Interaction` type is imported type-only (no runtime dep on api-client);
+ * frames are validated defensively and a malformed frame is surfaced as an error,
+ * never rendered as a silent blank. `answered` is not a wire field — it is a
+ * client flag this hook flips on an `interaction.answered` event.
+ */
+import { useEffect, useRef, useState } from 'react';
+import { useApi } from './useApi';
+import { useOnUnauthorized } from './useUnauthorized';
+// Reconnect backoff: capped exponential with full jitter. The delay for attempt
+// n is a random value in [0, min(CAP, BASE * 2**n)); the attempt counter resets
+// only when a connection is proven healthy (`interaction.backlog_done`), not when
+// it merely opens — so a flapping server that accepts the request then drops the
+// body still backs off instead of tight-looping. A healthy tail-reconnect is
+// near-instant while a sustained outage backs off, and the jitter spreads many
+// clients apart rather than retrying in lockstep.
+const RECONNECT_BASE_MS = 1500;
+const RECONNECT_CAP_MS = 30000;
+// The wire `answer_format` values. Duplicated from the api-client enum by design:
+// the SDK is the leaf and must not import api-client at runtime. The `satisfies`
+// pin against `Interaction['answer_format']` fails to compile if a listed value
+// leaves the union, so this runtime guard cannot silently drift from the type.
+const ANSWER_FORMATS = new Set([
+    'text',
+    'confirm',
+    'select',
+    'form',
+    'external',
+]);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Parse a frame's JSON to a plain object, or null when it is not one. */
+function parseJson(data) {
+    if (!data)
+        return null;
+    try {
+        const obj = JSON.parse(data);
+        return isRecord(obj) ? obj : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate an `interaction.add` frame into an `Interaction`, or null when it is
+ * malformed. This mirrors the api-client `interaction` zod schema exactly — it
+ * accepts what that schema accepts, no more, no less. The strict-required fields
+ * — `interaction_id`, `group_id`, `created_at`, `timeout_at` — must be a string
+ * and `answer_format` a known enum value; any missing or non-string one returns
+ * null so the caller surfaces it as an error rather than rendering a blank card.
+ * Two fields are laxer, matching the schema: `question` is
+ * `z.string().default('')`, whose default substitutes ONLY an absent/undefined
+ * value, so a missing question normalizes to `''` while a present `null` (or any
+ * present non-string) is rejected; `format_payload` is nullish, so an absent/null
+ * value (text/confirm carry none) normalizes to `{}` while a present non-object is
+ * rejected — never silently coerced to a blank card.
+ */
+function parseAddFrame(data) {
+    const obj = parseJson(data);
+    if (obj === null)
+        return null;
+    const { interaction_id, group_id, question, answer_format, format_payload, created_at, timeout_at, sensitive, server_verified, channel, media, } = obj;
+    if (typeof interaction_id !== 'string')
+        return null;
+    if (typeof group_id !== 'string')
+        return null;
+    // `question` is z.string().default('') in the schema: the default substitutes
+    // ONLY an absent/undefined value, so a missing question is valid while a
+    // present null (or any other present non-string) is malformed.
+    if (question !== undefined && typeof question !== 'string')
+        return null;
+    if (typeof created_at !== 'string')
+        return null;
+    if (typeof timeout_at !== 'string')
+        return null;
+    if (typeof answer_format !== 'string' || !ANSWER_FORMATS.has(answer_format))
+        return null;
+    // `format_payload` is nullish in the schema: absent/null normalizes to {}, but
+    // a present non-object is malformed and must not be coerced to a blank card.
+    if (format_payload != null && !isRecord(format_payload))
+        return null;
+    // `sensitive` is z.boolean().default(false): an absent value normalizes to
+    // false, while a present non-boolean is malformed.
+    if (sensitive !== undefined && typeof sensitive !== 'boolean')
+        return null;
+    // `server_verified` is z.boolean().optional(): an absent value stays undefined,
+    // while a present non-boolean is malformed.
+    if (server_verified !== undefined && typeof server_verified !== 'boolean')
+        return null;
+    // `channel` is z.string().optional(): the delivery-channel name rides the frame
+    // only for a channel-delivered question; absent stays undefined, a present
+    // non-string is malformed.
+    if (channel !== undefined && typeof channel !== 'string')
+        return null;
+    // `media` is z.array(z.unknown()).optional(): the display-only media rides the
+    // frame only when the question carries some; absent stays undefined, a present
+    // non-array is malformed. The ITEMS stay unknown here (loose by design) — each is
+    // validated per item by the renderer, so one bad item never fails this frame.
+    if (media !== undefined && !Array.isArray(media))
+        return null;
+    return {
+        interaction_id,
+        group_id,
+        question: typeof question === 'string' ? question : '',
+        answer_format: answer_format,
+        format_payload: isRecord(format_payload) ? format_payload : {},
+        created_at,
+        timeout_at,
+        sensitive: sensitive ?? false,
+        ...(typeof server_verified === 'boolean' ? { server_verified } : {}),
+        ...(typeof channel === 'string' ? { channel } : {}),
+        ...(Array.isArray(media) ? { media } : {}),
+    };
+}
+/** The interaction id from an `answered` / `removed` frame, or null. */
+function parseId(data) {
+    const id = parseJson(data)?.interaction_id;
+    return typeof id === 'string' ? id : null;
+}
+export function useInteractionsStream() {
+    const api = useApi();
+    const onUnauthorized = useOnUnauthorized();
+    const [state, setState] = useState({
+        interactions: [],
+        connected: false,
+        backlogLoaded: false,
+        error: null,
+    });
+    // Source of truth: a dedupe map keyed by interaction_id, rebuilt into the
+    // ordered array on every change.
+    const mapRef = useRef(new Map());
+    useEffect(() => {
+        const controller = new AbortController();
+        const aborted = () => controller.signal.aborted;
+        // A successful data frame rebuilds the list and clears any transient
+        // frame-parse error — one bad frame on a healthy stream must not stick.
+        const publish = () => {
+            setState((prev) => ({
+                ...prev,
+                interactions: Array.from(mapRef.current.values()),
+                error: null,
+            }));
+        };
+        const surfaceMalformed = (event) => {
+            setState((prev) => ({ ...prev, error: new Error(`malformed interaction frame: ${event}`) }));
+        };
+        // Per-connection reconcile state: the replayed backlog is authoritative, so
+        // ids not re-seen by `interaction.backlog_done` are dropped as
+        // removed-while-disconnected.
+        let reconciling = false;
+        let seenInBacklog = new Set();
+        // Consecutive failed reconnect attempts. Reset only when a connection proves
+        // healthy (`interaction.backlog_done`), NOT merely when it opens — a server
+        // that accepts the request then drops the body would otherwise reset every
+        // time and never back off.
+        let reconnectAttempt = 0;
+        const beginConnection = () => {
+            reconciling = true;
+            seenInBacklog = new Set();
+        };
+        const applyFrame = (event, data) => {
+            if (event === 'interaction.backlog_done') {
+                if (reconciling) {
+                    for (const id of mapRef.current.keys()) {
+                        if (!seenInBacklog.has(id))
+                            mapRef.current.delete(id);
+                    }
+                    reconciling = false;
+                }
+                // A completed backlog is proof the connection is healthy — clear the
+                // reconnect backoff so the next drop reconnects promptly.
+                reconnectAttempt = 0;
+                setState((prev) => ({
+                    ...prev,
+                    interactions: Array.from(mapRef.current.values()),
+                    backlogLoaded: true,
+                }));
+                return;
+            }
+            if (event === 'interaction.removed') {
+                const id = parseId(data);
+                if (id === null) {
+                    surfaceMalformed(event);
+                    return;
+                }
+                mapRef.current.delete(id);
+                publish();
+                return;
+            }
+            if (event === 'interaction.answered') {
+                const id = parseId(data);
+                if (id === null) {
+                    surfaceMalformed(event);
+                    return;
+                }
+                // The answered frame carries only ids — flip the existing item's flag,
+                // keeping its question/format. An answered event for an item we never saw
+                // has nothing to show.
+                const existing = mapRef.current.get(id);
+                if (existing)
+                    mapRef.current.set(id, { ...existing, answered: true });
+                publish();
+                return;
+            }
+            // interaction.add — the full question.
+            const interaction = parseAddFrame(data);
+            if (interaction === null) {
+                surfaceMalformed(event);
+                return;
+            }
+            if (reconciling)
+                seenInBacklog.add(interaction.interaction_id);
+            // Dedupe by id; a redelivered add preserves the client answered flag so a
+            // prior `answered` is not undone by an at-least-once replay.
+            const existing = mapRef.current.get(interaction.interaction_id);
+            mapRef.current.set(interaction.interaction_id, {
+                ...interaction,
+                answered: existing?.answered ?? false,
+            });
+            publish();
+        };
+        // The abort signal is the single cancellation source of truth: the cleanup
+        // aborts it, and every loop guard reads it fresh.
+        const run = async () => {
+            while (!aborted()) {
+                try {
+                    const frames = await api.streamInteractions(controller.signal);
+                    if (aborted())
+                        return;
+                    beginConnection();
+                    setState((prev) => ({ ...prev, connected: true, error: null }));
+                    for await (const frame of frames) {
+                        if (aborted())
+                            return;
+                        applyFrame(frame.event, frame.data);
+                    }
+                }
+                catch (err) {
+                    if (aborted())
+                        return;
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    setState((prev) => ({ ...prev, connected: false, error }));
+                    if (error.name === 'ApiUnauthorizedError') {
+                        // A 401 means the stored credential is dead — reconnecting would just
+                        // replay the same bad key every delay forever. Treat it as terminal
+                        // and hand off to the app's 401→login handler, the same path every
+                        // other data call takes; do not loop.
+                        onUnauthorized();
+                        return;
+                    }
+                }
+                // Stream ended or errored → wait, then reconnect (server replays backlog).
+                // Guard before the setState, like every other setState in run(): a
+                // microtask scheduled after the `for await` must not write state after
+                // the effect cleanup has aborted (and unmounted) the hook.
+                if (aborted())
+                    return;
+                setState((prev) => ({ ...prev, connected: false }));
+                const ceiling = Math.min(RECONNECT_CAP_MS, RECONNECT_BASE_MS * 2 ** reconnectAttempt);
+                const delay = Math.random() * ceiling;
+                reconnectAttempt += 1;
+                await new Promise((resolve) => {
+                    const onAbort = () => {
+                        clearTimeout(timer);
+                        resolve();
+                    };
+                    const timer = setTimeout(() => {
+                        // Normal wake: drop the abort listener so it does not accumulate
+                        // across reconnects ({ once: true } only self-removes on firing).
+                        controller.signal.removeEventListener('abort', onAbort);
+                        resolve();
+                    }, delay);
+                    controller.signal.addEventListener('abort', onAbort, { once: true });
+                });
+            }
+        };
+        void run();
+        return () => {
+            controller.abort();
+        };
+    }, [api, onUnauthorized]);
+    return state;
+}
+//# sourceMappingURL=useSse.js.map

package/dist/hooks/useSse.js.map

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

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export type Theme = 'light' | 'dark';
+export type ThemePreference = 'light' | 'dark' | 'system';
+export interface ThemeState {
+    /** The resolved theme the tokens key off — always concrete, never `'system'`. */
+    readonly theme: Theme;
+    /** The operator's choice: a pinned theme, or `'system'` to follow the OS. */
+    readonly preference: ThemePreference;
+    /** Set the preference and persist it. The only path that writes storage. */
+    readonly setPreference: (preference: ThemePreference) => void;
+    /** Pin an explicit theme (persists) — a preference shortcut kept for callers. */
+    readonly setTheme: (theme: Theme) => void;
+    /** Flip between the two pinned themes off the current resolved theme (persists). */
+    readonly toggle: () => void;
+}
+export declare function ThemeProvider({ children }: {
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<ThemeState | null>>;
+export declare function useTheme(): ThemeState;
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/hooks/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9D,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AA4BD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,8FA0DlE;AAED,wBAAgB,QAAQ,IAAI,UAAU,CAIrC"}

package/dist/hooks/useTheme.js

@@ -0,0 +1,97 @@
+/**
+ * `useTheme` — light/dark theme, token-driven. The active theme stamps
+ * `data-theme` on the document root, which the DS token layers key off.
+ *
+ * A three-state PREFERENCE sits behind the resolved theme: `'light'` and
+ * `'dark'` pin it, `'system'` follows `prefers-color-scheme` and tracks OS
+ * changes live. The resolved `theme` a consumer reads is always the concrete
+ * `'light' | 'dark'` the tokens need — never `'system'`.
+ *
+ * The preference persists to `localStorage`, but ONLY when the operator sets it
+ * explicitly (`setPreference` / `setTheme` / `toggle`). Boot READS the stored
+ * value; it never WRITES one, so a session that only ever renders the app leaves
+ * storage untouched. A `'system'` preference clears any pinned choice and hands
+ * the theme back to the OS.
+ */
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useState, } from 'react';
+const ThemeContext = createContext(null);
+/** Where the explicit preference is stored between sessions. */
+const STORAGE_KEY = 'tai-studio.theme-preference';
+function systemTheme() {
+    try {
+        return globalThis.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    catch {
+        return 'light';
+    }
+}
+/** The persisted preference, or `'system'` when none is stored or storage is
+ * unavailable. A READ only — boot never writes, so an untouched session leaves
+ * storage alone (the login flows depend on this). */
+function readStoredPreference() {
+    try {
+        const raw = globalThis.localStorage.getItem(STORAGE_KEY);
+        if (raw === 'light' || raw === 'dark' || raw === 'system')
+            return raw;
+    }
+    catch {
+        // No storage (private mode / non-browser) — the OS preference is the default.
+    }
+    return 'system';
+}
+export function ThemeProvider({ children }) {
+    const [preference, setPreferenceState] = useState(readStoredPreference);
+    // The live OS resolution, kept current by the listener below; it only feeds the
+    // resolved theme while the preference is `'system'`.
+    const [systemResolved, setSystemResolved] = useState(systemTheme);
+    const theme = preference === 'system' ? systemResolved : preference;
+    useEffect(() => {
+        globalThis.document.documentElement.setAttribute('data-theme', theme);
+    }, [theme]);
+    // Track the OS preference live, but ONLY while following it. The same defensive
+    // guard as `systemTheme()` — jsdom has no `matchMedia`, so subscribing is
+    // best-effort and its absence simply leaves the last resolved value in place.
+    useEffect(() => {
+        if (preference !== 'system')
+            return;
+        let query;
+        try {
+            query = globalThis.matchMedia('(prefers-color-scheme: dark)');
+        }
+        catch {
+            return;
+        }
+        setSystemResolved(query.matches ? 'dark' : 'light');
+        const onChange = (event) => {
+            setSystemResolved(event.matches ? 'dark' : 'light');
+        };
+        query.addEventListener('change', onChange);
+        return () => {
+            query.removeEventListener('change', onChange);
+        };
+    }, [preference]);
+    const setPreference = useCallback((next) => {
+        setPreferenceState(next);
+        try {
+            globalThis.localStorage.setItem(STORAGE_KEY, next);
+        }
+        catch {
+            // Storage unavailable — the choice still applies for this session in memory.
+        }
+    }, []);
+    const setTheme = useCallback((next) => {
+        setPreference(next);
+    }, [setPreference]);
+    const toggle = useCallback(() => {
+        setPreference(theme === 'dark' ? 'light' : 'dark');
+    }, [setPreference, theme]);
+    const value = useMemo(() => ({ theme, preference, setPreference, setTheme, toggle }), [theme, preference, setPreference, setTheme, toggle]);
+    return createElement(ThemeContext.Provider, { value }, children);
+}
+export function useTheme() {
+    const state = useContext(ThemeContext);
+    if (state === null)
+        throw new Error('useTheme must be used within a <ThemeProvider>');
+    return state;
+}
+//# sourceMappingURL=useTheme.js.map

package/dist/hooks/useTheme.js.map

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

package/dist/hooks/useUnauthorized.d.ts

@@ -0,0 +1,3 @@
+export declare const UnauthorizedProvider: import("react").Provider<() => void>;
+export declare function useOnUnauthorized(): () => void;
+//# sourceMappingURL=useUnauthorized.d.ts.map

package/dist/hooks/useUnauthorized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnauthorized.d.ts","sourceRoot":"","sources":["../../src/hooks/useUnauthorized.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,oBAAoB,iCAFe,IAAI,CAEY,CAAC;AAEjE,wBAAgB,iBAAiB,IAAI,MAAM,IAAI,CAE9C"}

package/dist/hooks/useUnauthorized.js

@@ -0,0 +1,18 @@
+/**
+ * `useOnUnauthorized` — the app's "the credential is dead, route to login" handler,
+ * provided through an SDK-owned context so shared hooks can reach it without a
+ * runtime dependency on the shell or the router.
+ *
+ * The default is a no-op, so a consumer rendered without a provider (a test, or a
+ * plugin in isolation) still works — it just does not route. The shell wires the
+ * real handler (the same one the api-client's 401 path drives) so a 401 raised
+ * OUTSIDE TanStack Query — notably the raw interactions SSE fetch — lands on the
+ * one login-routing path instead of being retried against a known-bad key.
+ */
+import { createContext, useContext } from 'react';
+const UnauthorizedContext = createContext(() => undefined);
+export const UnauthorizedProvider = UnauthorizedContext.Provider;
+export function useOnUnauthorized() {
+    return useContext(UnauthorizedContext);
+}
+//# sourceMappingURL=useUnauthorized.js.map

package/dist/hooks/useUnauthorized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnauthorized.js","sourceRoot":"","sources":["../../src/hooks/useUnauthorized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,mBAAmB,GAAG,aAAa,CAAa,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,QAAQ,CAAC;AAEjE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @tai42/studio-sdk/host — the HOST-ONLY registry API. `loadPlugin` (the one entry
+ * through which a plugin's `register` contributes) and `getContributions` (what the
+ * shell reads) live here, apart from the plugin surface, so the served plugin asset
+ * carries no way to forge, wipe, or enumerate the registry. Only the host bundle
+ * imports this. See SECURITY.md for the trust boundary.
+ */
+export { loadPlugin, getContributions } from './plugin/registry';
+export { setPluginHostState, getPluginHostState, subscribePluginHost, usePluginContributions, } from './plugin/host-state';
+export type { PluginLoaderState, PluginContributionsSnapshot } from './plugin/host-state';
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/host.js

@@ -0,0 +1,10 @@
+/**
+ * @tai42/studio-sdk/host — the HOST-ONLY registry API. `loadPlugin` (the one entry
+ * through which a plugin's `register` contributes) and `getContributions` (what the
+ * shell reads) live here, apart from the plugin surface, so the served plugin asset
+ * carries no way to forge, wipe, or enumerate the registry. Only the host bundle
+ * imports this. See SECURITY.md for the trust boundary.
+ */
+export { loadPlugin, getContributions } from './plugin/registry';
+export { setPluginHostState, getPluginHostState, subscribePluginHost, usePluginContributions, } from './plugin/host-state';
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @tai42/studio-sdk — the PLUGIN SURFACE: everything a Studio plugin (and every
+ * feature) is allowed to touch.
+ *
+ * 1. The STUDIO-PLUGIN API a plugin implements: the `PluginContext` its `register`
+ *    entry receives, the contribution types, and the compatibility gate.
+ * 2. The design system + hooks every feature (and every plugin) builds on.
+ *
+ * The host registry (`loadPlugin`/`getContributions`) is DELIBERATELY absent here
+ * so the served plugin asset cannot forge, wipe, or enumerate the registry; it is
+ * exported only from `@tai42/studio-sdk/host`, which the host bundle imports. See
+ * SECURITY.md for the trust boundary.
+ *
+ * The three shared modules (react, react-dom, @tai42/studio-sdk) are singletons
+ * across the plugin boundary; this package imports nothing internal at runtime
+ * (the `ApiClient`/`Interaction` types are type-only imports).
+ */
+import './components/tokens.css';
+import './components/fonts.css';
+import './components/components.css';
+export type { PluginContext, PluginEntry, ToolPanelProps, PluginPageProps, SettingsTabProps, ToolPanelContribution, PageContribution, RegisteredPage, SettingsTabContribution, RegisteredSettingsTab, NavEntryContribution, RegisteredNavEntry, PluginContributions, RequiredCapabilities, } from './plugin/types';
+export { STUDIO_PLUGIN_API_VERSION, checkPluginApiVersion } from './plugin/version';
+export type { VersionGateResult } from './plugin/version';
+export { ApiProvider, useApi } from './hooks/useApi';
+export type { ApiClient } from './hooks/useApi';
+export { UnauthorizedProvider, useOnUnauthorized } from './hooks/useUnauthorized';
+export { AuthProvider, useAuth } from './hooks/useAuth';
+export type { AuthState } from './hooks/useAuth';
+export { CapabilityProvider, useCapabilities, useCanWrite, isFullProjection, coversAnyRoute, coversRoute, coversWrite, } from './hooks/useCapabilities';
+export type { CapabilityState, CapabilityContextValue } from './hooks/useCapabilities';
+export { ThemeProvider, useTheme } from './hooks/useTheme';
+export type { Theme, ThemePreference, ThemeState } from './hooks/useTheme';
+export { useBreakpoint } from './hooks/useBreakpoint';
+export type { Breakpoint, BreakpointState } from './hooks/useBreakpoint';
+export { useInteractionsStream } from './hooks/useSse';
+export type { InteractionsStreamState, StreamInteraction } from './hooks/useSse';
+export { NavigationProvider, AppLink, useAppNavigate, useResolvePath } from './navigation';
+export type { AppLinkProps, RouteToken, RouteSearch, RouteSearchByToken, PageProps, NavigationContextValue, } from './navigation';
+export { errorMessage } from './errors';
+export { downloadBlob } from './download';
+export { toolsListKey, extensionsQueryKey, subMcpKey, tokensPayloadKey } from './query-keys';
+export { comboElementNames, extensionElementName } from './extension-combos';
+export { Button, Card, Skeleton, EmptyState, ErrorState, Spinner } from './components/primitives';
+export type { ButtonProps, LinkButtonProps, ButtonVariant, CardProps, SkeletonProps, EmptyStateProps, ErrorStateProps, SpinnerProps, } from './components/primitives';
+export { PageHeader, Page, Stack } from './components/page-header';
+export type { PageHeaderProps, PageLayoutProps, StackProps } from './components/page-header';
+export { ErrorBoundary } from './components/error-boundary';
+export type { ErrorBoundaryProps } from './components/error-boundary';
+export { Field, useFieldControl } from './components/field';
+export type { FieldProps, FieldControlProps } from './components/field';
+export { TextInput, Textarea, NumberInput } from './components/inputs';
+export type { TextInputProps, TextareaProps, NumberInputProps } from './components/inputs';
+export { Select } from './components/select';
+export type { SelectProps, SelectGroupsProps, SelectOption, SelectGroup, } from './components/select';
+export { Checkbox } from './components/checkbox';
+export type { CheckboxProps } from './components/checkbox';
+export { RadioGroup } from './components/radio-group';
+export type { RadioGroupProps, RadioOption } from './components/radio-group';
+export { Badge } from './components/badge';
+export type { BadgeProps } from './components/badge';
+export { Tabs } from './components/tabs';
+export type { TabsProps, TabItem } from './components/tabs';
+export { Dialog } from './components/dialog';
+export type { DialogProps } from './components/dialog';
+export { ConfirmDialog } from './components/confirm-dialog';
+export type { ConfirmDialogProps } from './components/confirm-dialog';
+export { Drawer } from './components/drawer';
+export type { DrawerProps } from './components/drawer';
+export { Tooltip } from './components/tooltip';
+export type { TooltipProps } from './components/tooltip';
+export { Table, THead, TBody, TR, TH, TD } from './components/table';
+export type { TableProps, TableSectionProps, TableRowProps, THProps, TDProps, NumericColumnProps, } from './components/table';
+export { ScrollRegion, useOverflowRegion, useProseScrollRegions } from './components/scroll-region';
+export type { ScrollRegionProps, OverflowRegionAttributes, ProseScrollLabels, } from './components/scroll-region';
+export { JsonTree } from './components/json-tree';
+export type { JsonTreeProps } from './components/json-tree';
+export { JsonDiff, diffJson } from './components/json-diff';
+export type { JsonDiffProps, JsonDiffRow } from './components/json-diff';
+export { TagChips, TagsInput } from './components/tags';
+export type { TagChipsProps, TagsInputProps } from './components/tags';
+export { CodeBlock } from './components/code-block';
+export type { CodeBlockProps } from './components/code-block';
+export { FleetReport } from './components/fleet-report';
+export type { FleetReportProps } from './components/fleet-report';
+export { ExternalLinkButton, isSafeHttpUrl } from './components/external-link';
+export { safeHttpUrl } from './components/primitives';
+export type { ExternalLinkButtonProps } from './components/external-link';
+export { ToolPicker } from './components/tool-picker';
+export type { ToolPickerProps } from './components/tool-picker';
+export { ExtensionPicker } from './components/extension-picker';
+export type { ExtensionPickerProps } from './components/extension-picker';
+export { ExtensionComboBuilder } from './components/extension-combo-builder';
+export type { ExtensionComboBuilderProps } from './components/extension-combo-builder';
+export { baseNameOf, groupIntoFamilies, groupByKind, kindVariant, NON_STACKABLE_KIND, } from './components/extension-grouping';
+export type { ExtensionFamily, ExtensionKindGroup } from './components/extension-grouping';
+export { VersionHistoryPanel } from './components/version-history-panel';
+export type { VersionHistoryPanelProps, VersionHistoryEntry, } from './components/version-history-panel';
+export { RevealInput } from './components/reveal-input';
+export type { RevealInputProps } from './components/reveal-input';
+export { CopyField } from './components/copy-field';
+export type { CopyFieldProps } from './components/copy-field';
+export { TOKEN_NAMES } from './components/tokens';
+export type { TokenName } from './components/tokens';
+export { NAV_ICONS, DashboardIcon, ToolsIcon, AgentsIcon, PresetsIcon, ExtensionsIcon, TemplatesIcon, ConnectorsIcon, HooksIcon, StorageIcon, SchedulingIcon, InteractionsIcon, NotificationsIcon, MarketplaceIcon, ManifestIcon, SettingsIcon, SystemIcon, SearchIcon, SignOutIcon, MenuIcon, CloseIcon, FilterIcon, ArrowLeftIcon, ArrowUpIcon, ArrowDownIcon, ChevronDownIcon, ChevronRightIcon, CheckIcon, MinusIcon, CopyIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, SortAscIcon, SortDescIcon, SunIcon, MoonIcon, MonitorIcon, CheckCircleIcon, AlertTriangleIcon, XCircleIcon, PendingIcon, } from './components/icons';
+export type { IconProps, IconComponent } from './components/icons';
+export { SchemaForm, defaultValueForSchema, validateAgainstSchema, resolveRef, } from './schema-form';
+export type { SchemaFormProps, CompletionProvider, JsonSchema, JsonSchemaType, Discriminator, SchemaFormErrors, } from './schema-form';
+export { SchemaEditor, lintSchemaText } from './schema-editor';
+export type { SchemaEditorProps, SchemaEditorChange, SchemaLintResult } from './schema-editor';
+export { ProgressBar } from './components/progress-bar';
+export type { ProgressBarProps } from './components/progress-bar';
+export { CompletionInput } from './components/completion-input';
+export type { CompletionInputProps } from './components/completion-input';
+export { ElicitationForm } from './elicitation/ElicitationForm';
+export type { ElicitationFormProps } from './elicitation/ElicitationForm';
+export { StructuredOutput } from './structured-output/StructuredOutput';
+export type { StructuredOutputProps } from './structured-output/StructuredOutput';
+//# sourceMappingURL=index.d.ts.map