@tai42/studio-sdk 16.0.1 → 17.1.1

package/src/components/icons/index.ts

@@ -31,54 +31,54 @@
  * none of it; the map is exhaustive over {@link RouteToken} regardless, so a new
  * route fails the build here until it has a mark.
  */
-export type { IconProps, IconComponent } from './icon-frame';
 export {
-  DashboardIcon,
-  ToolsIcon,
-  AgentsIcon,
-  PresetsIcon,
-  ExtensionsIcon,
-  TemplatesIcon,
-  ConnectorsIcon,
-  HooksIcon,
-  StorageIcon,
-  DatabaseIcon,
-  SchedulingIcon,
-  InteractionsIcon,
-  NotificationsIcon,
-  ConversationsIcon,
-  MarketplaceIcon,
-  ManifestIcon,
-  SettingsIcon,
-  SystemIcon,
-  ServedEndpointsIcon,
-  PluginIcon,
-} from './nav-marks';
-export {
-  SearchIcon,
-  SignOutIcon,
-  MenuIcon,
-  CloseIcon,
-  FilterIcon,
+  ArrowDownIcon,
   ArrowLeftIcon,
   ArrowUpIcon,
-  ArrowDownIcon,
+  CheckIcon,
   ChevronDownIcon,
   ChevronRightIcon,
-  CheckIcon,
-  MinusIcon,
-  PlusIcon,
-  EditIcon,
-  UnplugIcon,
+  CloseIcon,
   CopyIcon,
+  EditIcon,
   ExternalLinkIcon,
-  SortAscIcon,
-  SortDescIcon,
   EyeIcon,
   EyeOffIcon,
+  FilterIcon,
   FolderIcon,
   GridIcon,
+  MenuIcon,
+  MinusIcon,
+  PlusIcon,
+  SearchIcon,
+  SignOutIcon,
+  SortAscIcon,
+  SortDescIcon,
+  UnplugIcon,
 } from './chrome-marks';
-export { SunIcon, MoonIcon, MonitorIcon } from './theme-marks';
-export { CheckCircleIcon, AlertTriangleIcon, XCircleIcon, PendingIcon } from './status-marks';
+export type { IconComponent, IconProps } from './icon-frame';
 export { NAV_ICONS } from './nav-map';
+export {
+  AgentsIcon,
+  ConnectorsIcon,
+  ConversationsIcon,
+  DashboardIcon,
+  DatabaseIcon,
+  ExtensionsIcon,
+  HooksIcon,
+  InteractionsIcon,
+  ManifestIcon,
+  MarketplaceIcon,
+  NotificationsIcon,
+  PluginIcon,
+  PresetsIcon,
+  SchedulingIcon,
+  ServedEndpointsIcon,
+  SettingsIcon,
+  StorageIcon,
+  SystemIcon,
+  TemplatesIcon,
+  ToolsIcon,
+} from './nav-marks';
+export { AlertTriangleIcon, CheckCircleIcon, PendingIcon, XCircleIcon } from './status-marks';
+export { MonitorIcon, MoonIcon, SunIcon } from './theme-marks';

package/src/components/icons/nav-map.ts

@@ -6,25 +6,25 @@
 import type { RouteToken } from '../../navigation/types';
 import type { IconComponent } from './icon-frame';
 import {
-  DashboardIcon,
-  ToolsIcon,
   AgentsIcon,
-  PresetsIcon,
+  ConnectorsIcon,
+  ConversationsIcon,
+  DashboardIcon,
   DatabaseIcon,
   ExtensionsIcon,
-  TemplatesIcon,
-  ConnectorsIcon,
-  ServedEndpointsIcon,
   HooksIcon,
-  StorageIcon,
-  SchedulingIcon,
   InteractionsIcon,
-  NotificationsIcon,
-  ConversationsIcon,
-  MarketplaceIcon,
   ManifestIcon,
+  MarketplaceIcon,
+  NotificationsIcon,
+  PresetsIcon,
+  SchedulingIcon,
+  ServedEndpointsIcon,
   SettingsIcon,
+  StorageIcon,
   SystemIcon,
+  TemplatesIcon,
+  ToolsIcon,
 } from './nav-marks';
 
 /**

package/src/components/inputs.tsx

@@ -40,7 +40,7 @@
 import type { AriaAttributes, InputHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
 
 import { controlClassName, INPUT_CLASS, TEXTAREA_CLASS } from './control-styles';
-import { useFieldControl, type FieldControlProps } from './field';
+import { type FieldControlProps, useFieldControl } from './field';
 
 /** The three attributes a `Field` and its control can both want to own. */
 interface WiredControlAttributes {

package/src/components/json-diff.tsx

@@ -21,10 +21,10 @@
  */
 import { type ReactNode } from 'react';
 
+import { isRecord } from '../guards';
 import { Badge } from './badge';
 import { JsonTree } from './json-tree';
 import { Table, TBody, TD, TH, THead, TR } from './table';
-import { isRecord } from '../guards';
 
 /** One leaf difference between the two JSON values. */
 export interface JsonDiffRow {

package/src/components/json-tree-nodes.tsx

@@ -3,11 +3,12 @@
  * and a node's paged children. State is read from the tree context; layout uses
  * the code-block rhythm.
  */
-import { useEffect, useRef, useState } from 'react';
 import type { CSSProperties, MouseEvent as ReactMouseEvent, ReactElement } from 'react';
+import { useEffect, useRef, useState } from 'react';
 
-import { CheckIcon, CopyIcon } from './icons';
 import { COPIED_LABEL, COPIED_RESET_MS } from '../hooks/useClipboardCopy';
+import { CheckIcon, CopyIcon } from './icons';
+import { useJsonTreeContext } from './json-tree-context';
 import {
   childPath,
   containerCount,
@@ -16,7 +17,6 @@ import {
   sliceEntries,
 } from './json-tree-model';
 import { primitiveClass, primitiveText } from './json-value-format';
-import { useJsonTreeContext } from './json-tree-context';
 
 /** A copy control's resting face; whichever is exposed is also its accessible name. */
 export const COPY_LABEL = 'Copy';

package/src/components/json-tree.tsx

@@ -18,23 +18,23 @@
  * The scrolling pane IS the scrolling box, carrying the region attributes itself
  * rather than nesting a `ScrollRegion` that would add a second scroller.
  */
-import { useCallback, useMemo, useState } from 'react';
 import type { ReactElement } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 
-import { XCircleIcon } from './icons';
-import { useOverflowRegion } from './scroll-region';
 import { useClipboardCopy } from '../hooks/useClipboardCopy';
+import { XCircleIcon } from './icons';
+import { JsonTreeContext, type JsonTreeContextValue } from './json-tree-context';
 import {
-  PAGE_SIZE,
+  type Baseline,
   computeOpen,
   expandedOpenPaths,
   initialBaseline,
   isContainer,
-  type Baseline,
+  PAGE_SIZE,
 } from './json-tree-model';
-import { NO_CLIPBOARD, copyFailed, serializeForCopy } from './json-value-format';
-import { JsonTreeContext, type JsonTreeContextValue } from './json-tree-context';
 import { COPY_LABEL, CopyButton, JsonNode } from './json-tree-nodes';
+import { copyFailed, NO_CLIPBOARD, serializeForCopy } from './json-value-format';
+import { useOverflowRegion } from './scroll-region';
 
 export interface JsonTreeProps {
   readonly data: unknown;

package/src/components/markdown.tsx

@@ -10,10 +10,10 @@
  * `![alt](url)` collapses to its `alt` text, so no source URL is fetched. Fenced
  * code goes to `CodeBlock`, itself text-only.
  */
-import { useMemo, type ReactNode } from 'react';
+import { type ReactNode, useMemo } from 'react';
 
 import { CodeBlock } from './code-block';
-import { parseMarkdown, type HeadingLevel, type MarkdownBlock } from './markdown-blocks';
+import { type HeadingLevel, type MarkdownBlock, parseMarkdown } from './markdown-blocks';
 import { renderInline } from './markdown-inline';
 
 export type { HeadingLevel, MarkdownBlock } from './markdown-blocks';

package/src/components/page-fill.tsx

@@ -11,7 +11,7 @@
  * the modifier survives a route transition (old page unmounts after the new one
  * mounts) and clears exactly when the last fill page leaves.
  */
-import { createContext, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';
+import { createContext, type ReactNode, useContext, useEffect, useMemo, useState } from 'react';
 
 /** The registrar a fill page acquires against; each acquire returns its own
  * one-shot release, so double-release is inert. */

package/src/components/radio-group.tsx

@@ -22,8 +22,8 @@
  * rather than being pinned to one.
  */
 import * as RadixRadioGroup from '@radix-ui/react-radio-group';
-import { useId } from 'react';
 import type { ReactNode } from 'react';
+import { useId } from 'react';
 
 import { useFieldControl } from './field';
 

package/src/components/scroll-region.tsx

@@ -22,26 +22,27 @@
  * mounts later than the hook (a README that arrives with the second render) and
  * would never notice one being swapped for another.
  */
-import { useCallback, useState } from 'react';
 import type { CSSProperties, ReactNode, Ref, RefCallback } from 'react';
+import { useCallback, useState } from 'react';
+
 import {
+  holdContentTarget,
+  holdResizeTarget,
+  releaseContentTarget,
+  releaseResizeTarget,
+} from './observer-registry';
+import {
+  clearScrollRegionAttributes,
   needsRegion,
   refreshRegions,
-  clearScrollRegionAttributes,
   SCROLL_REGION_CLASS,
   type TrackedSurface,
 } from './overflow-measure';
-import {
-  holdResizeTarget,
-  releaseResizeTarget,
-  holdContentTarget,
-  releaseContentTarget,
-} from './observer-registry';
 import {
   DEFAULT_PROSE_LABELS,
-  MAX_PROSE_REGIONS,
-  labelledProseSurfaces,
   ensureScrollWrapper,
+  labelledProseSurfaces,
+  MAX_PROSE_REGIONS,
   uniquelyNamed,
 } from './prose-regions';
 

package/src/components/table.tsx

@@ -13,7 +13,7 @@
  * so a caller that has to measure or scroll a cell is not forced back to a raw
  * `<td>` and out of the system.
  */
-import type { HTMLAttributes, Ref, ReactNode, TdHTMLAttributes, ThHTMLAttributes } from 'react';
+import type { HTMLAttributes, ReactNode, Ref, TdHTMLAttributes, ThHTMLAttributes } from 'react';
 
 export interface TableProps extends HTMLAttributes<HTMLTableElement> {
   readonly children?: ReactNode;

package/src/components/tags.tsx

@@ -11,11 +11,11 @@
  * version-history panel's per-version tag editor) needs the same control; a single
  * canonical copy keeps the affordance identical everywhere.
  */
-import { useState, type CSSProperties, type ReactNode } from 'react';
+import { type CSSProperties, type ReactNode, useState } from 'react';
 
 import { CloseIcon } from './icons';
-import { Button } from './primitives';
 import { TextInput } from './inputs';
+import { Button } from './primitives';
 
 /** A tag and its remove control read as one unit, tighter than the row default. */
 const tagGroupStyle: CSSProperties = { gap: 'var(--tai-space-1)' };

package/src/components/templated-text-field.tsx

@@ -24,17 +24,16 @@
  * its kwargs, never converted or dropped. See `storageAbsent` /
  * `storagePresenceLoading`.
  */
-import { useState, type ReactNode } from 'react';
-
 import type { TemplatedText } from '@tai42/api-client';
+import { type ReactNode, useState } from 'react';
 
 import { Field } from './field';
 import {
   initialMode,
-  objectToRows,
-  templatedValueFrom,
   type KwargRow,
   type Mode,
+  objectToRows,
+  templatedValueFrom,
 } from './templated-text-kwargs';
 import { KwargsEditor, ReadOnlyKwargs } from './templated-text-kwargs-editor';
 import { TemplatedTextSource } from './templated-text-source';

package/src/components/templated-text-kwargs-editor.tsx

@@ -3,11 +3,11 @@
  * (`KwargsEditor`) for editable values, and the read-only listing
  * (`ReadOnlyKwargs`) shown beside a read-only stored id.
  */
-import { useState, type ReactNode } from 'react';
+import { type ReactNode, useState } from 'react';
 
-import { Button } from './primitives';
-import { TextInput } from './inputs';
 import { CloseIcon } from './icons';
+import { TextInput } from './inputs';
+import { Button } from './primitives';
 import type { KwargRow } from './templated-text-kwargs';
 
 /** The add/remove kwargs editor, revealed on demand and open when kwargs already exist. */

package/src/components/templated-text-source.tsx

@@ -6,13 +6,13 @@
  */
 import type { ReactNode } from 'react';
 
-import { ErrorState, Skeleton } from './primitives';
 import { Field } from './field';
+import { Textarea } from './inputs';
+import { ErrorState, Skeleton } from './primitives';
 import { RadioGroup } from './radio-group';
 import { Select } from './select';
-import { Textarea } from './inputs';
-import type { Mode } from './templated-text-kwargs';
 import type { TemplatedTextInlineProps, TemplatedTextTemplateOption } from './templated-text-field';
+import type { Mode } from './templated-text-kwargs';
 
 /** A labeled read-only reference to a stored template id, plus the note that
  *  stored templates are unavailable here — NOT an editable field. */

package/src/components/version-history-panel.tsx

@@ -25,7 +25,7 @@
  * machine voice (`tai-table-id` / `tai-mono`). The table itself sits in a
  * `ScrollRegion` so a narrow viewport scrolls it instead of the page.
  */
-import { useEffect, useRef, useState, type ReactNode } from 'react';
+import { type ReactNode, useEffect, useRef, useState } from 'react';
 
 import { errorMessage } from '../errors';
 import { Dialog } from './dialog';

package/src/components/view-toggle.tsx

@@ -9,7 +9,7 @@
  * {@link useViewMode}. The two live in the SDK so every entity screen (and the
  * flows page) toggles identically; `EntityCardGrid` renders the card half.
  */
-import { useCallback, useState, type ReactNode } from 'react';
+import { type ReactNode, useCallback, useState } from 'react';
 
 import { GridIcon, MenuIcon } from './icons';
 import { RadioGroup } from './radio-group';

package/src/element-slot.ts

@@ -9,8 +9,8 @@
  * onto it: the opener renders, carries no `aria-haspopup`/`aria-expanded`/
  * `aria-controls` and no handler, and fails nothing.
  */
-import { Fragment } from 'react';
 import type { ReactElement } from 'react';
+import { Fragment } from 'react';
 
 /** Raises when an `asChild` slot is handed a fragment. `slot` names the prop. */
 export function assertSlotElement(element: ReactElement, slot: string): void {

package/src/hooks/interactions-connection.ts

@@ -6,21 +6,21 @@
  * overlay reducer and republishes the merged list. React state flows in as the
  * dispatchers the hook passes; this file holds no React.
  */
-import type { Dispatch, RefObject, SetStateAction } from 'react';
 import type { ApiClient, Interaction } from '@tai42/api-client';
+import type { Dispatch, RefObject, SetStateAction } from 'react';
 
 import { isFeatureDisabled } from '../feature-disabled';
 import {
   emptyOverlay,
+  type LiveOverlay,
   merge,
   overlayApplyAdd,
   overlayApplyAnswered,
   overlayApplyRemoved,
   parseAddFrame,
   parseId,
-  sweepAnswered,
-  type LiveOverlay,
   type StreamInteraction,
+  sweepAnswered,
 } from './interactions-stream';
 
 // Reconnect backoff: capped exponential with full jitter. The delay for attempt

package/src/hooks/useApi.ts

@@ -9,8 +9,8 @@
  * runtime dependency on @tai42/api-client (the SDK imports nothing internal at
  * runtime).
  */
-import { createContext, useContext } from 'react';
 import type { ApiClient } from '@tai42/api-client';
+import { createContext, useContext } from 'react';
 
 const ApiContext = createContext<ApiClient | null>(null);
 

package/src/hooks/useAuth.ts

@@ -4,8 +4,8 @@
  * sessionStorage. localStorage is NEVER written: the README documents the
  * XSS trade-off and why localStorage persistence is not offered.
  */
-import { createContext, useCallback, useContext, useMemo, useState } from 'react';
 import type { ReactNode } from 'react';
+import { createContext, useCallback, useContext, useMemo, useState } from 'react';
 import { createElement } from 'react';
 
 const SESSION_KEY = 'tai-studio.apiKey';

package/src/hooks/useCapabilities.ts

@@ -14,6 +14,8 @@
  * `ErrorState` with `retry` in the nav region — never an optimistic full nav on
  * error. The UI fails closed exactly as the server would.
  */
+import type { MeProjection } from '@tai42/api-client';
+import type { ReactNode } from 'react';
 import {
   createContext,
   useCallback,
@@ -23,9 +25,7 @@ import {
   useRef,
   useState,
 } from 'react';
-import type { ReactNode } from 'react';
 import { createElement } from 'react';
-import type { MeProjection } from '@tai42/api-client';
 
 import { useApi } from './useApi';
 import { useAuth } from './useAuth';
@@ -116,7 +116,7 @@ export function useCapabilities(): CapabilityContextValue {
 
 /**
  * Whether the projection is the synthetic TOTAL projection — the admin session
- * (the condition-free ownerless `"*"` discriminator) and the gate-off local-dev
+ * (the condition-free `"*"` discriminator) and the gate-off local-dev
  * projection alike. This is `projection.admin === true` and NOTHING else: a
  * seeded editor/viewer carries `["*"]` scopes PLUS a jq fence, so keying on `"*"`
  * scopes would hand every editor/viewer the unfiltered nav and a wall of 403s on

package/src/hooks/useSse.ts

@@ -29,19 +29,19 @@
  * `answered` is not a wire field — it is a client flag flipped on an
  * `interaction.answered` event.
  */
-import { useEffect, useRef, useState } from 'react';
 import type { Interaction } from '@tai42/api-client';
+import { useEffect, useRef, useState } from 'react';
 
-import { useApi } from './useApi';
-import { useOnUnauthorized } from './useUnauthorized';
+import { type ConnectionState, startInteractionsStream } from './interactions-connection';
 import {
   emptyOverlay,
+  type LiveOverlay,
   merge,
   pendingCount,
-  type LiveOverlay,
   type StreamInteraction,
 } from './interactions-stream';
-import { startInteractionsStream, type ConnectionState } from './interactions-connection';
+import { useApi } from './useApi';
+import { useOnUnauthorized } from './useUnauthorized';
 
 export type { StreamInteraction } from './interactions-stream';
 

package/src/hooks/useSystemKinds.tsx

@@ -16,15 +16,15 @@
  * as not-off until the table is `ready`, and a failed fetch leaves every kind not-off
  * so the surface falls back to its reactive 501 handling, never a hard-failed page.
  */
+import type { KindStatus } from '@tai42/api-client';
 import {
   createContext,
   createElement,
+  type ReactNode,
   useContext,
   useEffect,
   useState,
-  type ReactNode,
 } from 'react';
-import type { KindStatus } from '@tai42/api-client';
 
 import { useApi } from './useApi';
 import { useAuth } from './useAuth';

package/src/hooks/useTheme.ts

@@ -13,6 +13,7 @@
  * storage untouched. A `'system'` preference clears any pinned choice and hands
  * the theme back to the OS.
  */
+import type { ReactNode } from 'react';
 import {
   createContext,
   createElement,
@@ -22,7 +23,6 @@ import {
   useMemo,
   useState,
 } from 'react';
-import type { ReactNode } from 'react';
 
 export type Theme = 'light' | 'dark';
 export type ThemePreference = 'light' | 'dark' | 'system';

package/src/hooks/useToolDisplayNames.tsx

@@ -12,17 +12,17 @@
  * display name is cosmetic: a picker with an empty map falls back to the bare raw
  * name, never a hard-failed page.
  */
+import type { ToolMetaOverlay } from '@tai42/api-client';
 import {
   createContext,
   createElement,
+  type ReactNode,
   useCallback,
   useContext,
   useEffect,
   useMemo,
   useState,
-  type ReactNode,
 } from 'react';
-import type { ToolMetaOverlay } from '@tai42/api-client';
 
 import { useApi } from './useApi';
 import { useAuth } from './useAuth';

package/src/host.ts

@@ -5,15 +5,15 @@
  * 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 type {
+  LoadedPlugin,
+  PluginContributionsSnapshot,
+  PluginLoaderState,
+} from './plugin/host-state';
 export {
-  setPluginHostState,
   getPluginHostState,
+  setPluginHostState,
   subscribePluginHost,
   usePluginContributions,
 } from './plugin/host-state';
-export type {
-  PluginLoaderState,
-  LoadedPlugin,
-  PluginContributionsSnapshot,
-} from './plugin/host-state';
+export { getContributions, loadPlugin } from './plugin/registry';