@tai42/studio-sdk 0.2.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,91 @@
+/**
+ * @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).
+ */
+// The design system, delivered by the BARREL so each host app loads it once and a
+// plugin never ships its own copy. These are bare side-effect imports, so they
+// survive bundling only while this module is itself listed in the package's
+// `sideEffects` (both `./dist/index.js` and `./src/index.ts` — `files` ships src
+// too). Without that entry webpack and Vite treat the barrel as side-effect-free
+// and drop all three, and a published consumer gets zero CSS; `sideEffects` is
+// kept honest against these lines by `package-side-effects.test.ts`.
+import './components/tokens.css';
+import './components/fonts.css';
+import './components/components.css';
+export { STUDIO_PLUGIN_API_VERSION, checkPluginApiVersion } from './plugin/version';
+// -- Hooks -------------------------------------------------------------------
+export { ApiProvider, useApi } from './hooks/useApi';
+export { UnauthorizedProvider, useOnUnauthorized } from './hooks/useUnauthorized';
+export { AuthProvider, useAuth } from './hooks/useAuth';
+export { CapabilityProvider, useCapabilities, useCanWrite, isFullProjection, coversAnyRoute, coversRoute, coversWrite, } from './hooks/useCapabilities';
+export { ThemeProvider, useTheme } from './hooks/useTheme';
+export { useBreakpoint } from './hooks/useBreakpoint';
+export { useInteractionsStream } from './hooks/useSse';
+// -- Navigation (shell ⇄ feature route-token contract) -----------------------
+export { NavigationProvider, AppLink, useAppNavigate, useResolvePath } from './navigation';
+// -- Utilities ---------------------------------------------------------------
+export { errorMessage } from './errors';
+export { downloadBlob } from './download';
+// -- Cross-feature query keys ------------------------------------------------
+export { toolsListKey, extensionsQueryKey, subMcpKey, tokensPayloadKey } from './query-keys';
+// -- Extension-combo editing helpers -----------------------------------------
+export { comboElementNames, extensionElementName } from './extension-combos';
+// -- Design system -----------------------------------------------------------
+export { Button, Card, Skeleton, EmptyState, ErrorState, Spinner } from './components/primitives';
+export { PageHeader, Page, Stack } from './components/page-header';
+export { ErrorBoundary } from './components/error-boundary';
+export { Field, useFieldControl } from './components/field';
+export { TextInput, Textarea, NumberInput } from './components/inputs';
+export { Select } from './components/select';
+export { Checkbox } from './components/checkbox';
+export { RadioGroup } from './components/radio-group';
+export { Badge } from './components/badge';
+export { Tabs } from './components/tabs';
+export { Dialog } from './components/dialog';
+export { ConfirmDialog } from './components/confirm-dialog';
+export { Drawer } from './components/drawer';
+export { Tooltip } from './components/tooltip';
+export { Table, THead, TBody, TR, TH, TD } from './components/table';
+export { ScrollRegion, useOverflowRegion, useProseScrollRegions } from './components/scroll-region';
+export { JsonTree } from './components/json-tree';
+export { JsonDiff, diffJson } from './components/json-diff';
+export { TagChips, TagsInput } from './components/tags';
+export { CodeBlock } from './components/code-block';
+export { FleetReport } from './components/fleet-report';
+export { ExternalLinkButton, isSafeHttpUrl } from './components/external-link';
+// The URL half of the link-safety pair: `isSafeHttpUrl` answers yes/no, this one
+// hands back the parsed URL, so a caller that needs the URL does not re-parse it.
+export { safeHttpUrl } from './components/primitives';
+export { ToolPicker } from './components/tool-picker';
+export { ExtensionPicker } from './components/extension-picker';
+export { ExtensionComboBuilder } from './components/extension-combo-builder';
+export { baseNameOf, groupIntoFamilies, groupByKind, kindVariant, NON_STACKABLE_KIND, } from './components/extension-grouping';
+export { VersionHistoryPanel } from './components/version-history-panel';
+export { RevealInput } from './components/reveal-input';
+export { CopyField } from './components/copy-field';
+export { TOKEN_NAMES } from './components/tokens';
+// -- Iconography (the only sanctioned marks; Unicode glyphs are banned) -------
+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';
+// -- Schema-driven forms -----------------------------------------------------
+export { SchemaForm, defaultValueForSchema, validateAgainstSchema, resolveRef, } from './schema-form';
+// -- Schema-editor (validated JSON-Schema authoring control) -----------------
+export { SchemaEditor, lintSchemaText } from './schema-editor';
+// -- MCP context widgets (elicitation / progress / completions / output) -----
+export { ProgressBar } from './components/progress-bar';
+export { CompletionInput } from './components/completion-input';
+export { ElicitationForm } from './elicitation/ElicitationForm';
+export { StructuredOutput } from './structured-output/StructuredOutput';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/navigation/context.d.ts

@@ -0,0 +1,25 @@
+import { type AriaAttributes, type ReactNode } from 'react';
+import type { NavigationContextValue, RouteSearch, RouteToken } from './types';
+export declare function NavigationProvider({ value, children, }: {
+    value: NavigationContextValue;
+    children: ReactNode;
+}): ReactNode;
+/** Imperative navigation to a shell route token with its typed search params. */
+export declare function useAppNavigate(): NavigationContextValue['navigate'];
+/** Resolve a token + search to the href the shell would route to. */
+export declare function useResolvePath(): NavigationContextValue['resolvePath'];
+export interface AppLinkProps<T extends RouteToken> {
+    to: T;
+    search?: RouteSearch<T>;
+    children: ReactNode;
+    className?: string;
+    'aria-label'?: string;
+    'aria-current'?: AriaAttributes['aria-current'];
+}
+/**
+ * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
+ * client-side transition on plain left-click. Modified clicks (new tab/window,
+ * download) fall through to the browser's default handling.
+ */
+export declare function AppLink<T extends RouteToken>({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, }: AppLinkProps<T>): ReactNode;
+//# sourceMappingURL=context.d.ts.map

package/dist/navigation/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/navigation/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EAEnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAU/E,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAEZ;AAYD,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAEnE;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAEtE;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,UAAU;IAChD,EAAE,EAAE,CAAC,CAAC;IACN,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,UAAU,EAAE,EAC5C,EAAE,EACF,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,GAC5B,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAkB7B"}

package/dist/navigation/context.js

@@ -0,0 +1,45 @@
+import { createContext, createElement, useCallback, useContext, } from 'react';
+/**
+ * Shell-provided navigation. The context has no default: a feature rendered
+ * outside the shell's {@link NavigationProvider} is a wiring bug, so
+ * {@link useNavigation} raises loudly rather than silently no-op'ing a
+ * transition.
+ */
+const NavigationContext = createContext(null);
+export function NavigationProvider({ value, children, }) {
+    return createElement(NavigationContext.Provider, { value }, children);
+}
+function useNavigation() {
+    const ctx = useContext(NavigationContext);
+    if (ctx === null) {
+        throw new Error('useNavigation must be used within a <NavigationProvider> (the shell provides it).');
+    }
+    return ctx;
+}
+/** Imperative navigation to a shell route token with its typed search params. */
+export function useAppNavigate() {
+    return useNavigation().navigate;
+}
+/** Resolve a token + search to the href the shell would route to. */
+export function useResolvePath() {
+    return useNavigation().resolvePath;
+}
+/**
+ * A real anchor (so middle-click / open-in-new-tab keep working) that drives a
+ * client-side transition on plain left-click. Modified clicks (new tab/window,
+ * download) fall through to the browser's default handling.
+ */
+export function AppLink({ to, search, children, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, }) {
+    const { navigate, resolvePath } = useNavigation();
+    const href = resolvePath(to, search);
+    const onClick = useCallback((event) => {
+        if (event.defaultPrevented)
+            return;
+        if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
+            return;
+        event.preventDefault();
+        navigate(to, search);
+    }, [navigate, to, search]);
+    return createElement('a', { href, className, 'aria-label': ariaLabel, 'aria-current': ariaCurrent, onClick }, children);
+}
+//# sourceMappingURL=context.js.map

package/dist/navigation/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/navigation/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,GAIX,MAAM,OAAO,CAAC;AAIf;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,aAAa,CAAgC,IAAI,CAAC,CAAC;AAE7E,MAAM,UAAU,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,aAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,EAAE,CAAC,QAAQ,CAAC;AAClC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,EAAE,CAAC,WAAW,CAAC;AACrC,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAuB,EAC5C,EAAE,EACF,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,cAAc,EAAE,WAAW,GACX;IAChB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,KAAoC,EAAE,EAAE;QACvC,IAAI,KAAK,CAAC,gBAAgB;YAAE,OAAO;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;YACxF,OAAO;QACT,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC,EACD,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CACvB,CAAC;IACF,OAAO,aAAa,CAClB,GAAG,EACH,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,EAClF,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/navigation/index.d.ts

@@ -0,0 +1,4 @@
+export { NavigationProvider, AppLink, useAppNavigate, useResolvePath } from './context';
+export type { AppLinkProps } from './context';
+export type { RouteToken, RouteSearch, RouteSearchByToken, PageProps, NavigationContextValue, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/navigation/index.js

@@ -0,0 +1,2 @@
+export { NavigationProvider, AppLink, useAppNavigate, useResolvePath } from './context';
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/navigation/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The shell ⇄ feature navigation contract.
+ *
+ * Routing is SHELL-owned: feature packages never see path strings and never
+ * define routes. They navigate through named ROUTE TOKENS — the keys of
+ * {@link RouteSearchByToken} — which the shell resolves to real paths. A token
+ * is an opaque, compile-time handle: renaming or removing one here is a type
+ * error at every call site, exactly the property free-form path strings lack.
+ *
+ * This contract lives in the SDK because it is the ONLY internal module a feature
+ * may import (a feature importing the shell is a boundary violation). The shell
+ * supplies the runtime resolution via {@link NavigationContextValue}; features
+ * consume it type-safely.
+ */
+/**
+ * Every top-level route the shell owns, mapped to its typed search parameters.
+ * A route with no parameters maps to the empty object. Detail views are driven
+ * by a search parameter (e.g. the selected tool / connection), keeping the route
+ * map flat — one entry per feature surface, matching the shell route map.
+ */
+export interface RouteSearchByToken {
+    login: Record<string, never>;
+    tools: {
+        tool?: string;
+        tags?: string[];
+    };
+    agents: Record<string, never>;
+    presets: {
+        preset?: string;
+    };
+    extensions: Record<string, never>;
+    interactions: Record<string, never>;
+    notifications: Record<string, never>;
+    connectors: {
+        connection?: string;
+    };
+    hooks: Record<string, never>;
+    templates: {
+        template?: string;
+    };
+    storage: {
+        filter?: string;
+    };
+    manifest: Record<string, never>;
+    settings: Record<string, never>;
+    system: Record<string, never>;
+    scheduling: Record<string, never>;
+    observability: {
+        tab?: 'dashboard' | 'tracing';
+        from?: string;
+        to?: string;
+        tags?: string[];
+        status?: 'error' | 'success';
+        minCost?: number;
+        maxCost?: number;
+        minTokens?: number;
+        maxTokens?: number;
+        minLatencyMs?: number;
+        maxLatencyMs?: number;
+        sort?: 'createdAt' | 'cost' | 'latencyMs' | 'totalTokens';
+        dir?: 'asc' | 'desc';
+        trace?: string;
+    };
+    marketplace: {
+        tab?: 'browse' | 'installed';
+        q?: string;
+        kind?: string;
+        category?: string;
+        tags?: string[];
+        sort?: 'downloads' | 'updated' | 'name' | 'relevance';
+        plugin?: string;
+    };
+}
+/** An opaque, typed handle to a shell route. */
+export type RouteToken = keyof RouteSearchByToken;
+/** The search parameters a given route token accepts. */
+export type RouteSearch<T extends RouteToken> = RouteSearchByToken[T];
+/**
+ * Props the shell passes to a feature's page component: the route's typed search
+ * parameters. Features type their exported page as `PageProps<'tools'>` and read
+ * `search` — they receive route state as data, never by importing the router.
+ */
+export interface PageProps<T extends RouteToken> {
+    search: RouteSearch<T>;
+}
+/**
+ * The runtime navigation surface the shell provides through
+ * {@link NavigationProvider}. `navigate` performs a client-side transition;
+ * `resolvePath` produces the href a link should point at (so an AppLink is a real
+ * anchor — middle-click / open-in-new-tab work — while still driving a
+ * client-side transition on plain click).
+ */
+export interface NavigationContextValue {
+    navigate: <T extends RouteToken>(token: T, search?: RouteSearch<T>) => void;
+    resolvePath: <T extends RouteToken>(token: T, search?: RouteSearch<T>) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/navigation/types.d.ts.map

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

package/dist/navigation/types.js

@@ -0,0 +1,16 @@
+/**
+ * The shell ⇄ feature navigation contract.
+ *
+ * Routing is SHELL-owned: feature packages never see path strings and never
+ * define routes. They navigate through named ROUTE TOKENS — the keys of
+ * {@link RouteSearchByToken} — which the shell resolves to real paths. A token
+ * is an opaque, compile-time handle: renaming or removing one here is a type
+ * error at every call site, exactly the property free-form path strings lack.
+ *
+ * This contract lives in the SDK because it is the ONLY internal module a feature
+ * may import (a feature importing the shell is a boundary violation). The shell
+ * supplies the runtime resolution via {@link NavigationContextValue}; features
+ * consume it type-safely.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/navigation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/navigation/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/plugin/host-state.d.ts

@@ -0,0 +1,45 @@
+import type { PluginContributions } from './types';
+/**
+ * The plugin load pass's public state, mirrored for feature pages to read. It is
+ * the shape the app shell's loader store already exposes: `status` gates when the
+ * contributions are complete, and the error fields carry the loud failures.
+ */
+export interface PluginLoaderState {
+    /** `idle` before the first pass, `loading` while it runs, `ready` once done. */
+    readonly status: 'idle' | 'loading' | 'ready';
+    /** Names of plugins whose bundle imported and registered successfully. */
+    readonly loaded: readonly string[];
+    /** Plugin name → loud error message (version mismatch / load failure). */
+    readonly errors: Readonly<Record<string, string>>;
+    /** A registry-listing failure that is NOT a 401 (surfaced loudly, never hidden). */
+    readonly registryError: string | null;
+}
+/**
+ * The host loader pushes every load-pass transition here (it stays the single
+ * driver); every subscriber is notified so feature pages re-render off it.
+ */
+export declare function setPluginHostState(state: PluginLoaderState): void;
+/** The current mirrored host state — the snapshot {@link usePluginContributions} reads. */
+export declare function getPluginHostState(): PluginLoaderState;
+/**
+ * Subscribe to host-state transitions; returns the unsubscribe function
+ * `useSyncExternalStore` requires so a subscriber detaches on unmount.
+ */
+export declare function subscribePluginHost(listener: () => void): () => void;
+/** Tests reset the module-level host state between cases. */
+export declare function __resetPluginHostState(): void;
+/** What {@link usePluginContributions} returns: the load status and the registry. */
+export interface PluginContributionsSnapshot {
+    /** The load pass's status; contributions are only complete once it is `'ready'`. */
+    readonly status: PluginLoaderState['status'];
+    /** The committed contributions, meaningful only when `status === 'ready'`. */
+    readonly contributions: PluginContributions;
+}
+/**
+ * Subscribe to the plugin host state and read the committed contributions. The
+ * status drives re-renders as the load pass advances; `contributions` is only
+ * meaningful once `status === 'ready'` (before then the pass has committed
+ * nothing, so callers render their non-plugin content).
+ */
+export declare function usePluginContributions(): PluginContributionsSnapshot;
+//# sourceMappingURL=host-state.d.ts.map

package/dist/plugin/host-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-state.d.ts","sourceRoot":"","sources":["../../src/plugin/host-state.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAYD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAGjE;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,IAAI,iBAAiB,CAEtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,2BAA2B,CAGpE"}

package/dist/plugin/host-state.js

@@ -0,0 +1,62 @@
+/**
+ * The plugin host-readiness store: a host-driven mirror of the plugin load pass's
+ * public state that feature pages subscribe to. The app shell's loader is the
+ * single driver — it calls {@link setPluginHostState} on every transition — and a
+ * feature page reads the current status plus the committed contributions through
+ * {@link usePluginContributions}, without importing the app shell (the dependency
+ * points the other way).
+ *
+ * This module reads the contribution registry ({@link getContributions}), so it is
+ * part of the HOST-ONLY surface (`@tai42/studio-sdk/host`), never the plugin surface:
+ * a served plugin bundle can neither drive this store nor enumerate the registry
+ * through it. See SECURITY.md for the trust boundary.
+ */
+import { useSyncExternalStore } from 'react';
+import { getContributions } from './registry';
+const INITIAL_HOST_STATE = {
+    status: 'idle',
+    loaded: [],
+    errors: {},
+    registryError: null,
+};
+let hostState = INITIAL_HOST_STATE;
+const listeners = new Set();
+/**
+ * The host loader pushes every load-pass transition here (it stays the single
+ * driver); every subscriber is notified so feature pages re-render off it.
+ */
+export function setPluginHostState(state) {
+    hostState = state;
+    for (const listener of listeners)
+        listener();
+}
+/** The current mirrored host state — the snapshot {@link usePluginContributions} reads. */
+export function getPluginHostState() {
+    return hostState;
+}
+/**
+ * Subscribe to host-state transitions; returns the unsubscribe function
+ * `useSyncExternalStore` requires so a subscriber detaches on unmount.
+ */
+export function subscribePluginHost(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Tests reset the module-level host state between cases. */
+export function __resetPluginHostState() {
+    hostState = INITIAL_HOST_STATE;
+    listeners.clear();
+}
+/**
+ * Subscribe to the plugin host state and read the committed contributions. The
+ * status drives re-renders as the load pass advances; `contributions` is only
+ * meaningful once `status === 'ready'` (before then the pass has committed
+ * nothing, so callers render their non-plugin content).
+ */
+export function usePluginContributions() {
+    const status = useSyncExternalStore(subscribePluginHost, () => getPluginHostState().status);
+    return { status, contributions: getContributions() };
+}
+//# sourceMappingURL=host-state.js.map

package/dist/plugin/host-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-state.js","sourceRoot":"","sources":["../../src/plugin/host-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkB9C,MAAM,kBAAkB,GAAsB;IAC5C,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,IAAI,SAAS,GAAsB,kBAAkB,CAAC;AACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,SAAS,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAoB;IACtD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB;IACpC,SAAS,GAAG,kBAAkB,CAAC;IAC/B,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAC;IAC5F,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE,CAAC;AACvD,CAAC"}

package/dist/plugin/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The in-memory registry the shell reads, plus {@link loadPlugin} — the one entry
+ * through which a plugin bundle's `register(context)` contributes to it. This module
+ * is bundled only into the served `@tai42/studio-sdk/host` singleton (external across
+ * the plugin boundary, like react and react-dom), so the module-level registry is
+ * the SAME instance every host caller — the shell and the feature panels — sees. The
+ * plugin surface (`@tai42/studio-sdk`) does not include it, so a plugin cannot reach it.
+ */
+import type { PluginContributions, PluginEntry } from './types';
+/**
+ * Load one plugin: call its `register` entry with a context bound to `pluginId`,
+ * then commit everything it staged into the global registry.
+ *
+ * Contributions are STAGED into local arrays (identity captured in the closure,
+ * never read from ambient state) and only committed after `entry` settles
+ * successfully. `entry` is AWAITED before commit, so a synchronous or an `async`
+ * entry is fully done first: a post-`await` throw skips the commit (atomicity
+ * holds for async too) and a post-`await` registration cannot slip past the batch.
+ * The seal is set after `entry` has SETTLED — for a sync entry, after it returns
+ * and the `await` continuation runs; for an async entry, after its returned promise
+ * resolves. A registration attempted from that point on (a deferred timer, a
+ * callback scheduled after settle) throws loudly instead of pushing into an
+ * orphaned staged array that never commits. Registrations made during `entry`'s
+ * synchronous body — including a microtask it enqueues then, which runs before the
+ * `await` continuation — are still captured and committed with the batch. A
+ * `register` that throws commits nothing and leaves the registry untouched.
+ * Duplicate guards run against BOTH the staged contributions and what is already
+ * committed, and fail loudly.
+ */
+export declare function loadPlugin(pluginId: string, entry: PluginEntry): Promise<void>;
+/** The shell reads this after loading every installed plugin bundle. */
+export declare function getContributions(): PluginContributions;
+/** Tests reset the module-level registry between cases. */
+export declare function __resetContributions(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugin/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAIV,mBAAmB,EACnB,WAAW,EAMZ,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkHpF;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,mBAAmB,CAEtD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/plugin/registry.js

@@ -0,0 +1,129 @@
+const toolPanels = new Map();
+const pages = [];
+const settingsTabs = [];
+const navEntries = [];
+/**
+ * Load one plugin: call its `register` entry with a context bound to `pluginId`,
+ * then commit everything it staged into the global registry.
+ *
+ * Contributions are STAGED into local arrays (identity captured in the closure,
+ * never read from ambient state) and only committed after `entry` settles
+ * successfully. `entry` is AWAITED before commit, so a synchronous or an `async`
+ * entry is fully done first: a post-`await` throw skips the commit (atomicity
+ * holds for async too) and a post-`await` registration cannot slip past the batch.
+ * The seal is set after `entry` has SETTLED — for a sync entry, after it returns
+ * and the `await` continuation runs; for an async entry, after its returned promise
+ * resolves. A registration attempted from that point on (a deferred timer, a
+ * callback scheduled after settle) throws loudly instead of pushing into an
+ * orphaned staged array that never commits. Registrations made during `entry`'s
+ * synchronous body — including a microtask it enqueues then, which runs before the
+ * `await` continuation — are still captured and committed with the batch. A
+ * `register` that throws commits nothing and leaves the registry untouched.
+ * Duplicate guards run against BOTH the staged contributions and what is already
+ * committed, and fail loudly.
+ */
+export async function loadPlugin(pluginId, entry) {
+    const stagedPages = [];
+    const stagedToolPanels = new Map();
+    const stagedSettingsTabs = [];
+    const stagedTabIds = new Set();
+    const stagedNavEntries = [];
+    let sealed = false;
+    const context = {
+        registerPage(contribution) {
+            if (sealed) {
+                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
+            }
+            const staged = stagedPages.some((p) => p.path === contribution.path);
+            const committed = pages.some((p) => p.pluginId === pluginId && p.path === contribution.path);
+            if (staged || committed) {
+                // A duplicate path within one plugin is an author mistake that would
+                // leave one page unreachable — fail loudly, as registerToolPanel does.
+                throw new Error(`plugin “${pluginId}” already registered a page at “${contribution.path}”`);
+            }
+            stagedPages.push({ ...contribution, pluginId });
+        },
+        registerToolPanel(contribution) {
+            if (sealed) {
+                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
+            }
+            if (stagedToolPanels.has(contribution.toolName) || toolPanels.has(contribution.toolName)) {
+                throw new Error(`a tool panel is already registered for ${contribution.toolName}`);
+            }
+            stagedToolPanels.set(contribution.toolName, contribution);
+        },
+        registerSettingsTab(contribution) {
+            if (sealed) {
+                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
+            }
+            const committed = settingsTabs.some((t) => t.pluginId === pluginId && t.id === contribution.id);
+            if (stagedTabIds.has(contribution.id) || committed) {
+                // A duplicate tab id within one plugin would leave one tab unreachable —
+                // fail loudly, mirroring the page-path guard.
+                throw new Error(`plugin “${pluginId}” already registered a settings tab “${contribution.id}”`);
+            }
+            stagedTabIds.add(contribution.id);
+            stagedSettingsTabs.push({ ...contribution, pluginId });
+        },
+        registerNavEntry(contribution) {
+            if (sealed) {
+                throw new Error('registration is closed: a plugin must register during register(), not after it resolves');
+            }
+            const staged = stagedNavEntries.some((e) => e.path === contribution.path);
+            const committed = navEntries.some((e) => e.pluginId === pluginId && e.path === contribution.path);
+            if (staged || committed) {
+                // A duplicate nav path within one plugin is an author mistake — two
+                // entries pointing at the same page — so fail loudly like the page guard.
+                throw new Error(`plugin “${pluginId}” already registered a nav entry at “${contribution.path}”`);
+            }
+            stagedNavEntries.push({ ...contribution, pluginId });
+        },
+    };
+    try {
+        await entry(context);
+    }
+    finally {
+        // Whether `entry` resolved or threw, no further registration is valid — seal
+        // so a deferred call fails loudly rather than pushing into an orphaned array.
+        sealed = true;
+    }
+    // Every nav entry must link to a page THIS plugin registers — staged in this
+    // call or already committed. A nav entry with no matching page is a guaranteed
+    // dead link (the plugin page surface renders "Page not found"), so reject it
+    // loudly. This throws BEFORE the commit loops, so it propagates out of
+    // `loadPlugin` and NOTHING (pages, panels, tabs, nav) commits — atomicity holds.
+    for (const navEntry of stagedNavEntries) {
+        const hasPage = stagedPages.some((p) => p.path === navEntry.path) ||
+            pages.some((p) => p.pluginId === pluginId && p.path === navEntry.path);
+        if (!hasPage) {
+            throw new Error(`plugin “${pluginId}” registered a nav entry at “${navEntry.path}” but no page at that path`);
+        }
+    }
+    // `entry` resolved without throwing: commit the staged contributions as one
+    // batch, so the registry only ever holds a plugin's complete set — never a
+    // partial set left behind by a mid-registration failure.
+    for (const page of stagedPages) {
+        pages.push(page);
+    }
+    for (const [toolName, contribution] of stagedToolPanels) {
+        toolPanels.set(toolName, contribution);
+    }
+    for (const tab of stagedSettingsTabs) {
+        settingsTabs.push(tab);
+    }
+    for (const navEntry of stagedNavEntries) {
+        navEntries.push(navEntry);
+    }
+}
+/** The shell reads this after loading every installed plugin bundle. */
+export function getContributions() {
+    return { toolPanels, pages, settingsTabs, navEntries };
+}
+/** Tests reset the module-level registry between cases. */
+export function __resetContributions() {
+    toolPanels.clear();
+    pages.length = 0;
+    settingsTabs.length = 0;
+    navEntries.length = 0;
+}
+//# sourceMappingURL=registry.js.map