@tai42/studio-sdk 0.2.0

package/dist/plugin/registry.js.map

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

package/dist/plugin/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * The Studio-plugin authoring contract. A platform plugin ships an ESM bundle
+ * that exports a `register(context)` entry ({@link PluginEntry}); the host calls
+ * it with a {@link PluginContext} through which the plugin contributes tool
+ * panels, pages, settings tabs, and sidebar nav entries.
+ *
+ * Two styling paths are sanctioned, and only these two:
+ *  1. SDK components plus inline styles that read the design-system tokens
+ *     (`var(--tai-*)`). Raw Tailwind utilities are host-internal, not part of
+ *     this contract.
+ *  2. A plugin-shipped SCOPED stylesheet, listed in the bundle's manifest
+ *     `integrity` map as a `.css` asset and HOST-injected as an SRI'd
+ *     `<link rel="stylesheet">` before the bundle's JS is imported. It is bound
+ *     by three hard rules: (a) no global resets/preflight — never style `html`,
+ *     `body`, `:root`, `*`, or bare element selectors at top level; (b) every
+ *     selector is scoped under a plugin root class the plugin renders itself,
+ *     prefixed with the plugin's own package name; (c) theme values in
+ *     PLUGIN-AUTHORED rules come from the SDK custom properties (`var(--tai-*)`),
+ *     never hardcoded colors, so the stylesheet themes itself with no logic of
+ *     its own. Bundled third-party base CSS is exempt from rule (c) but rules
+ *     (a) and (b) still bind it.
+ */
+import type { ComponentType } from 'react';
+/**
+ * A capability requirement a contribution may declare. `routes` is a list of
+ * route-path prefixes (anyOf semantics, the same evaluator the shell nav uses):
+ * the contribution renders iff the caller's capability projection covers at least
+ * one of them. ABSENT (the field is optional) means the contribution renders only
+ * for a FULL projection — safe-by-default for every existing plugin, which never
+ * declared a requirement. The server remains the authority; this only shapes what
+ * the UI advertises.
+ */
+export interface RequiredCapabilities {
+    readonly routes: readonly string[];
+}
+/** Props a contributed tool-run panel receives (replaces the auto-form). */
+export interface ToolPanelProps {
+    /** The tool name this panel targets. */
+    readonly toolName: string;
+    /** The tool's JSON schema (Pydantic-emitted), for panels that introspect it. */
+    readonly schema: Record<string, unknown>;
+    /** Run the tool with arguments; resolves with the typed result or throws. */
+    readonly run: (args: Record<string, unknown>) => Promise<unknown>;
+}
+/** Props a contributed full page receives. Navigation is via shell route tokens. */
+export interface PluginPageProps {
+    readonly pluginId: string;
+}
+/** Props a contributed settings tab receives. */
+export interface SettingsTabProps {
+    readonly pluginId: string;
+}
+export interface ToolPanelContribution {
+    readonly toolName: string;
+    readonly component: ComponentType<ToolPanelProps>;
+}
+export interface PageContribution {
+    /** URL segment under `/plugins/{pluginId}/`. */
+    readonly path: string;
+    readonly title: string;
+    readonly component: ComponentType<PluginPageProps>;
+    /** Capability gate (see {@link RequiredCapabilities}); absent ⇒ full-only. */
+    readonly requiredCapabilities?: RequiredCapabilities;
+}
+/**
+ * A page as stored in the registry: the plugin's {@link PageContribution} plus
+ * the id of the plugin that registered it. The `pluginId` is stamped by the
+ * registry from the identity the host passed to {@link PluginEntry} — a plugin
+ * never supplies its own id — so a page resolves only under its owner's
+ * `/plugins/{pluginId}/` prefix and two plugins may register the same `path`
+ * without colliding.
+ */
+export interface RegisteredPage extends PageContribution {
+    readonly pluginId: string;
+}
+export interface NavEntryContribution {
+    /**
+     * Path of a page THIS plugin registers. The nav entry links to
+     * `/plugins/{pluginId}/{path}`, so it must match a {@link PageContribution}
+     * `path` of the same plugin — the registry rejects a nav entry with no page.
+     */
+    readonly path: string;
+    readonly title: string;
+    /**
+     * Optional icon rendered before the title. It must be a square inline SVG that
+     * fills its box and draws with `currentColor`; the host constrains the slot,
+     * rendering it inside a fixed 1em box, `aria-hidden` (the accessible name is
+     * `title`), with the color inherited from the link. Its bytes live inside the
+     * plugin bundle, so no external fetch and no CSP change. Absent icon renders a
+     * text-only entry, exactly like the core nav.
+     */
+    readonly icon?: ComponentType;
+    /** Capability gate (see {@link RequiredCapabilities}); absent ⇒ full-only. */
+    readonly requiredCapabilities?: RequiredCapabilities;
+}
+/**
+ * A nav entry as stored in the registry: the plugin's
+ * {@link NavEntryContribution} plus the id of the plugin that registered it. The
+ * `pluginId` is stamped by the registry from the identity the host passed to
+ * {@link PluginEntry}, so the entry links only under its owner's
+ * `/plugins/{pluginId}/` prefix and two plugins may register the same `path`
+ * without colliding.
+ */
+export interface RegisteredNavEntry extends NavEntryContribution {
+    readonly pluginId: string;
+}
+export interface SettingsTabContribution {
+    readonly id: string;
+    readonly title: string;
+    readonly component: ComponentType<SettingsTabProps>;
+    /** Capability gate (see {@link RequiredCapabilities}); absent ⇒ full-only. */
+    readonly requiredCapabilities?: RequiredCapabilities;
+}
+/**
+ * A settings tab as stored in the registry: the plugin's
+ * {@link SettingsTabContribution} plus the id of the plugin that registered it.
+ * The `pluginId` is stamped by the registry from the identity the host passed to
+ * {@link PluginEntry} — a plugin never supplies its own id — so a tab is always
+ * attributable to its owner and two plugins may register the same tab `id`
+ * without colliding.
+ */
+export interface RegisteredSettingsTab extends SettingsTabContribution {
+    readonly pluginId: string;
+}
+/** Everything a single plugin bundle has registered at import time. */
+export interface PluginContributions {
+    readonly toolPanels: ReadonlyMap<string, ToolPanelContribution>;
+    readonly pages: readonly RegisteredPage[];
+    readonly settingsTabs: readonly RegisteredSettingsTab[];
+    readonly navEntries: readonly RegisteredNavEntry[];
+}
+/**
+ * The registration surface a plugin receives in its `register(context)` entry.
+ * Each method binds the contribution to the plugin the host is loading — the
+ * plugin's identity is fixed by the host, not read from any ambient state — so a
+ * contribution can never be misattributed to another plugin. Contributions are
+ * staged and committed together once `register` settles; a `register` that throws
+ * commits nothing. The context is SEALED once `register` settles: a call made
+ * after that (a deferred timer, a post-resolve microtask) throws instead of
+ * silently dropping, so every registration must happen during `register`.
+ */
+export interface PluginContext {
+    /** Register a full page mounted under `/plugins/{pluginId}/{path}`. */
+    registerPage(contribution: PageContribution): void;
+    /** Register a rich run panel for a tool by name (overrides the auto-form). */
+    registerToolPanel(contribution: ToolPanelContribution): void;
+    /** Register a settings tab. */
+    registerSettingsTab(contribution: SettingsTabContribution): void;
+    /**
+     * Register a sidebar nav entry linking to one of this plugin's pages at
+     * `/plugins/{pluginId}/{path}`. The `path` must match a page the plugin also
+     * registers (a nav entry with no page is a dead link and is rejected loudly).
+     */
+    registerNavEntry(contribution: NavEntryContribution): void;
+}
+/**
+ * A plugin bundle's entry: the default plugin API. The host imports the bundle,
+ * reads its `register` export, and calls it with a {@link PluginContext}. All
+ * contributions flow through that context — there are no free registration
+ * functions. The entry may be synchronous or `async`; the host awaits it before
+ * committing, so an async entry must complete every registration before it
+ * resolves (see the seal on {@link PluginContext}).
+ */
+export type PluginEntry = (context: PluginContext) => void | Promise<void>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/plugin/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugin/types.js.map

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

package/dist/plugin/version.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The Studio-plugin API compatibility version.
+ *
+ * A monotonic integer bumped ONLY on a breaking change to the Studio-plugin API
+ * OR the public prop/type surface of any DS component the SDK exports (a prop
+ * rename/removal bumps it; genuinely internal/visual changes do not).
+ *
+ * Gate rule: equality is correct precisely because additive changes never
+ * bump (existing plugins keep matching) and after a break every plugin must
+ * rebuild by design. `targeted == current` accepts; anything else rejects.
+ *
+ * Additive evolution under this gate: a host that gains a NEW optional context
+ * capability (a new `register*` method, a new host-side injection behavior)
+ * keeps the same version, so every existing plugin loads unchanged. The one
+ * asymmetry the equality gate leaves is a plugin that USES a newer capability on
+ * an OLDER host that lacks it — and it fails loudly, by construction, not by any
+ * negotiation machinery:
+ *  - A plugin calling a context method the host does not define throws the
+ *    natural `context.<method> is not a function` during `register`; the loader
+ *    catches it as that plugin's loud error card and commits nothing.
+ *  - A plugin shipping a `.css` asset to a host that does not inject stylesheets
+ *    is served but never injected — the page renders with SDK-component styling
+ *    only. This is the single quiet degradation the mechanism admits, and the
+ *    authoring docs state it: stylesheet injection is a host capability, so a
+ *    deployment pairs the Studio host with plugins built for it.
+ */
+export declare const STUDIO_PLUGIN_API_VERSION = 1;
+export interface VersionGateResult {
+    readonly ok: boolean;
+    readonly reason?: string;
+}
+/** Accept iff the plugin's targeted version exactly equals the host's. */
+export declare function checkPluginApiVersion(targeted: number, current?: number): VersionGateResult;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/plugin/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,SAA4B,GAClC,iBAAiB,CAMnB"}

package/dist/plugin/version.js

@@ -0,0 +1,37 @@
+/**
+ * The Studio-plugin API compatibility version.
+ *
+ * A monotonic integer bumped ONLY on a breaking change to the Studio-plugin API
+ * OR the public prop/type surface of any DS component the SDK exports (a prop
+ * rename/removal bumps it; genuinely internal/visual changes do not).
+ *
+ * Gate rule: equality is correct precisely because additive changes never
+ * bump (existing plugins keep matching) and after a break every plugin must
+ * rebuild by design. `targeted == current` accepts; anything else rejects.
+ *
+ * Additive evolution under this gate: a host that gains a NEW optional context
+ * capability (a new `register*` method, a new host-side injection behavior)
+ * keeps the same version, so every existing plugin loads unchanged. The one
+ * asymmetry the equality gate leaves is a plugin that USES a newer capability on
+ * an OLDER host that lacks it — and it fails loudly, by construction, not by any
+ * negotiation machinery:
+ *  - A plugin calling a context method the host does not define throws the
+ *    natural `context.<method> is not a function` during `register`; the loader
+ *    catches it as that plugin's loud error card and commits nothing.
+ *  - A plugin shipping a `.css` asset to a host that does not inject stylesheets
+ *    is served but never injected — the page renders with SDK-component styling
+ *    only. This is the single quiet degradation the mechanism admits, and the
+ *    authoring docs state it: stylesheet injection is a host capability, so a
+ *    deployment pairs the Studio host with plugins built for it.
+ */
+export const STUDIO_PLUGIN_API_VERSION = 1;
+/** Accept iff the plugin's targeted version exactly equals the host's. */
+export function checkPluginApiVersion(targeted, current = STUDIO_PLUGIN_API_VERSION) {
+    if (targeted === current)
+        return { ok: true };
+    return {
+        ok: false,
+        reason: `plugin targets Studio API v${String(targeted)} but this host is v${String(current)} — the plugin must be rebuilt`,
+    };
+}
+//# sourceMappingURL=version.js.map

package/dist/plugin/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/plugin/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAO3C,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,OAAO,GAAG,yBAAyB;IAEnC,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,8BAA8B,MAAM,CAAC,QAAQ,CAAC,sBAAsB,MAAM,CAAC,OAAO,CAAC,+BAA+B;KAC3H,CAAC;AACJ,CAAC"}

package/dist/query-keys.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cross-feature TanStack Query keys.
+ *
+ * Feature packages cannot import each other — the SDK is their one shared seam — so
+ * a query key more than one feature must reference lives here as a single
+ * authoritative constant rather than a duplicated literal that could drift.
+ *
+ * `toolsListKey` is the registered-tool master list. A mutation that changes the
+ * registered-tool population — creating, deleting, or rolling back a preset (each
+ * binds or tears down a live tool) — invalidates it so the tools page refetches.
+ */
+/** The registered-tool master list (`GET /api/tools`). */
+export declare const toolsListKey: readonly ["tools"];
+/**
+ * The extension catalog (`GET /api/extensions`). The extensions feature keys its
+ * read-only catalog on it; a tool's extension-combo save (in the tools feature)
+ * creates or tears down branch tools, so it invalidates this key too — a
+ * cross-feature reference that must resolve to one authoritative constant.
+ */
+export declare const extensionsQueryKey: readonly ["extensions"];
+/**
+ * The discovered sub-MCP mounts (`GET /api/sub-mcp`). The settings feature reads
+ * this map (its scope mapper lists the mounts) while the manifest feature owns the
+ * create/delete controls that mutate it; both must key and invalidate the exact
+ * same tuple, so it lives here rather than as a literal duplicated across the two
+ * features (which cannot import each other).
+ */
+export declare const subMcpKey: readonly ["sub-mcp"];
+/** The api-key payloads; read by settings AND the hooks execution-key picker. */
+export declare const tokensPayloadKey: readonly ["auth-tokens-payload"];
+//# sourceMappingURL=query-keys.d.ts.map

package/dist/query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../src/query-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,YAAY,oBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yBAA0B,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,sBAAuB,CAAC;AAE9C,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,kCAAmC,CAAC"}

package/dist/query-keys.js

@@ -0,0 +1,31 @@
+/**
+ * Cross-feature TanStack Query keys.
+ *
+ * Feature packages cannot import each other — the SDK is their one shared seam — so
+ * a query key more than one feature must reference lives here as a single
+ * authoritative constant rather than a duplicated literal that could drift.
+ *
+ * `toolsListKey` is the registered-tool master list. A mutation that changes the
+ * registered-tool population — creating, deleting, or rolling back a preset (each
+ * binds or tears down a live tool) — invalidates it so the tools page refetches.
+ */
+/** The registered-tool master list (`GET /api/tools`). */
+export const toolsListKey = ['tools'];
+/**
+ * The extension catalog (`GET /api/extensions`). The extensions feature keys its
+ * read-only catalog on it; a tool's extension-combo save (in the tools feature)
+ * creates or tears down branch tools, so it invalidates this key too — a
+ * cross-feature reference that must resolve to one authoritative constant.
+ */
+export const extensionsQueryKey = ['extensions'];
+/**
+ * The discovered sub-MCP mounts (`GET /api/sub-mcp`). The settings feature reads
+ * this map (its scope mapper lists the mounts) while the manifest feature owns the
+ * create/delete controls that mutate it; both must key and invalidate the exact
+ * same tuple, so it lives here rather than as a literal duplicated across the two
+ * features (which cannot import each other).
+ */
+export const subMcpKey = ['sub-mcp'];
+/** The api-key payloads; read by settings AND the hooks execution-key picker. */
+export const tokensPayloadKey = ['auth-tokens-payload'];
+//# sourceMappingURL=query-keys.js.map

package/dist/query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.js","sourceRoot":"","sources":["../src/query-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAU,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAY,CAAU,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,CAAU,CAAC;AAE9C,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,qBAAqB,CAAU,CAAC"}

package/dist/schema-editor/SchemaEditor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `SchemaEditor` — the shared control for AUTHORING a JSON Schema. It is a VALIDATED
+ * code editor, NOT a visual builder: the operator writes the schema as JSON in a
+ * textarea, and the editor gives loud parse feedback, a structural lint (top-level
+ * object; a `"title"` when `requireTitle`), and a live PREVIEW of the authored shape
+ * through the same {@link SchemaForm} renderer the run side uses (falling back to a
+ * {@link JsonTree} of the schema dict when the shape is not form-renderable).
+ *
+ * A JSON Schema is more expressive than any builder UI (`$defs`, `anyOf`, constraint
+ * keywords), and the backend rejects an invalid schema LOUDLY — so full meta-schema
+ * validation stays server-side and this control adds no schema-validation dependency.
+ *
+ * CONTROLLED-BY-SEED: `value` seeds the editor's text ONCE (on mount); thereafter the
+ * text is the source of truth and every edit reports up through `onChange`. Validity
+ * is exposed there too so the consumer can gate its submit — always alongside a
+ * VISIBLE inline message, never a silently disabled button. The parsed dict is passed
+ * through untouched, so a schema the editor does not understand round-trips exactly.
+ *
+ * SAFETY: the schema text is operator-authored and every derived value renders as
+ * React TEXT (through the DS controls / `JsonTree` / `SchemaForm`), never an HTML sink.
+ */
+import { type ReactNode } from 'react';
+/** What {@link SchemaEditor} reports up on every edit. */
+export interface SchemaEditorChange {
+    /** The authored schema dict when valid and non-empty; `null` when the editor is empty. */
+    readonly schema: Record<string, unknown> | null;
+    /** False when the text is non-empty but unparseable or failing lint — gate submit on this. */
+    readonly valid: boolean;
+}
+export interface SchemaEditorProps {
+    /** The schema dict to seed the editor with, or `null` for an empty editor. */
+    readonly value: Record<string, unknown> | null;
+    /** Fired on every edit with the parsed schema (or `null`) and its validity. */
+    readonly onChange: (change: SchemaEditorChange) => void;
+    /** When true, a top-level `"title"` is required (the `response_format` contract). */
+    readonly requireTitle: boolean;
+    readonly label?: string;
+    readonly description?: string;
+    readonly disabled?: boolean;
+    readonly idPrefix?: string;
+}
+export declare function SchemaEditor({ value, onChange, requireTitle, label, description, disabled, idPrefix, }: SchemaEditorProps): ReactNode;
+//# sourceMappingURL=SchemaEditor.d.ts.map

package/dist/schema-editor/SchemaEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaEditor.d.ts","sourceRoot":"","sources":["../../src/schema-editor/SchemaEditor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAYrE,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAkFD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAA0B,GAC3B,EAAE,iBAAiB,GAAG,SAAS,CA2C/B"}

package/dist/schema-editor/SchemaEditor.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `SchemaEditor` — the shared control for AUTHORING a JSON Schema. It is a VALIDATED
+ * code editor, NOT a visual builder: the operator writes the schema as JSON in a
+ * textarea, and the editor gives loud parse feedback, a structural lint (top-level
+ * object; a `"title"` when `requireTitle`), and a live PREVIEW of the authored shape
+ * through the same {@link SchemaForm} renderer the run side uses (falling back to a
+ * {@link JsonTree} of the schema dict when the shape is not form-renderable).
+ *
+ * A JSON Schema is more expressive than any builder UI (`$defs`, `anyOf`, constraint
+ * keywords), and the backend rejects an invalid schema LOUDLY — so full meta-schema
+ * validation stays server-side and this control adds no schema-validation dependency.
+ *
+ * CONTROLLED-BY-SEED: `value` seeds the editor's text ONCE (on mount); thereafter the
+ * text is the source of truth and every edit reports up through `onChange`. Validity
+ * is exposed there too so the consumer can gate its submit — always alongside a
+ * VISIBLE inline message, never a silently disabled button. The parsed dict is passed
+ * through untouched, so a schema the editor does not understand round-trips exactly.
+ *
+ * SAFETY: the schema text is operator-authored and every derived value renders as
+ * React TEXT (through the DS controls / `JsonTree` / `SchemaForm`), never an HTML sink.
+ */
+import { Component, useMemo, useState } from 'react';
+import { Field } from '../components/field';
+import { Textarea } from '../components/inputs';
+import { JsonTree } from '../components/json-tree';
+import { ScrollRegion } from '../components/scroll-region';
+import { classifySchema } from '../schema-form/classify';
+import { defaultValueForSchema } from '../schema-form/default-value';
+import { SchemaForm } from '../schema-form/SchemaForm';
+import { lintSchemaText } from './lint';
+function seedText(value) {
+    return value === null ? '' : JSON.stringify(value, null, 2);
+}
+/**
+ * Whether {@link SchemaForm} can render this schema's root — i.e. it classifies to a
+ * concrete field kind rather than `unsupported`. A schema whose root the form cannot
+ * render (or whose classification throws on a bad `$ref`) previews as a `JsonTree`.
+ */
+function canRenderWithForm(schema) {
+    try {
+        return classifySchema(schema, schema).model.kind !== 'unsupported';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * An interactive preview of the authored schema. Seeds a throwaway value from the
+ * schema's defaults so the operator can see (and poke) the shape they defined.
+ */
+function PreviewForm({ schema }) {
+    const [value, setValue] = useState(() => defaultValueForSchema(schema));
+    return _jsx(SchemaForm, { schema: schema, value: value, onChange: setValue, idPrefix: "schema-preview" });
+}
+/**
+ * Catch a render-time throw from a deep, malformed schema (e.g. a nested unresolvable
+ * `$ref`) so the preview degrades to the `JsonTree` fallback instead of crashing the
+ * enclosing dialog. Reset per authored schema by keying this boundary on the schema.
+ */
+class PreviewBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError(_error) {
+        return { failed: true };
+    }
+    render() {
+        return this.state.failed ? this.props.fallback : this.props.children;
+    }
+}
+/** The preview pane's accessible name, wherever the scrolling box turns out to be. */
+const PREVIEW_LABEL = 'Schema preview';
+/**
+ * The preview pane, framed as a card and scrollable — a deep schema's preview can
+ * outrun its column, so it scrolls in place rather than pushing the dialog sideways.
+ *
+ * WHICH element scrolls depends on the branch, and only the one that actually
+ * scrolls may carry the region attributes. {@link JsonTree} IS its own scrolling
+ * box, so on the fallback branch the card is a plain frame and the tree names
+ * itself; a `ScrollRegion` around it would take an overflow that never reaches it,
+ * leaving a name announced for a box that cannot move. The {@link SchemaForm}
+ * branch renders no scroller of its own, so there the card IS the region.
+ */
+function SchemaPreview({ schema, testId, }) {
+    const jsonFallback = (_jsx("div", { className: "tai-card", "data-testid": testId, children: _jsx(JsonTree, { data: schema, label: PREVIEW_LABEL }) }));
+    if (!canRenderWithForm(schema))
+        return jsonFallback;
+    return (_jsx(PreviewBoundary, { fallback: jsonFallback, children: _jsx(ScrollRegion, { label: PREVIEW_LABEL, className: "tai-card", "data-testid": testId, children: _jsx(PreviewForm, { schema: schema }) }) }));
+}
+export function SchemaEditor({ value, onChange, requireTitle, label = 'Schema', description, disabled, idPrefix = 'schema-editor', }) {
+    const [text, setText] = useState(() => seedText(value));
+    // Recomputed for display (inline error + preview) on every render; the change
+    // handler lints the NEXT text independently so `onChange` and the view agree.
+    const result = useMemo(() => lintSchemaText(text, requireTitle), [text, requireTitle]);
+    const emit = (nextText) => {
+        setText(nextText);
+        const next = lintSchemaText(nextText, requireTitle);
+        onChange({ schema: next.valid ? next.schema : null, valid: next.valid });
+    };
+    return (_jsxs("div", { "data-testid": idPrefix, className: "tai-stack tai-stack-3", children: [_jsx(Field, { label: label, description: description, error: result.error, children: _jsx(Textarea, { value: text, disabled: disabled, onChange: (event) => {
+                        emit(event.target.value);
+                    }, rows: 10, "aria-label": `${label} JSON`, className: "tai-textarea-mono", spellCheck: false }) }), result.schema !== null ? (_jsxs("div", { className: "tai-stack tai-stack-2", children: [_jsx("span", { className: "tai-label", children: "Preview" }), _jsx(SchemaPreview
+                    // Re-seed the preview (and reset its error boundary) whenever the
+                    // authored schema changes.
+                    , { schema: result.schema, testId: `${idPrefix}-preview` }, JSON.stringify(result.schema))] })) : null] }));
+}
+//# sourceMappingURL=SchemaEditor.js.map

package/dist/schema-editor/SchemaEditor.js.map

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

package/dist/schema-editor/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Schema-editor — the shared, validated JSON-Schema authoring control. Public
+ * surface: the `SchemaEditor` component, its change type, and the pure lint helper
+ * consumers reuse to pre-check a stored schema.
+ */
+export { SchemaEditor } from './SchemaEditor';
+export type { SchemaEditorProps, SchemaEditorChange } from './SchemaEditor';
+export { lintSchemaText } from './lint';
+export type { SchemaLintResult } from './lint';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema-editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema-editor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/schema-editor/index.js

@@ -0,0 +1,8 @@
+/**
+ * Schema-editor — the shared, validated JSON-Schema authoring control. Public
+ * surface: the `SchemaEditor` component, its change type, and the pure lint helper
+ * consumers reuse to pre-check a stored schema.
+ */
+export { SchemaEditor } from './SchemaEditor';
+export { lintSchemaText } from './lint';
+//# sourceMappingURL=index.js.map

package/dist/schema-editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema-editor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC"}

package/dist/schema-editor/lint.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The pure parse + structural lint behind the `SchemaEditor` module. It never throws:
+ * a malformed value IS the result it reports. Full meta-schema validation stays
+ * server-side (the backend 400s carry the detail); this is the fast, loud client
+ * guard that keeps an obviously-broken schema from ever leaving the dialog.
+ */
+/** The parse/lint outcome for one editor text buffer. */
+export interface SchemaLintResult {
+    /**
+     * The parsed schema dict when the text is a syntactically valid JSON object, or
+     * `null` when the text is empty or does not parse. Carries the parsed object even
+     * when a lint (e.g. a missing `title`) fails, so the preview can still show the
+     * authored shape — the consumer gates on {@link valid}, never on this alone.
+     */
+    readonly schema: Record<string, unknown> | null;
+    /**
+     * True when the text is empty or a valid schema. False when the text is non-empty
+     * but fails to parse or fails a structural lint — the consumer blocks submit.
+     */
+    readonly valid: boolean;
+    /** A loud, human-readable message when {@link valid} is false; else `undefined`. */
+    readonly error: string | undefined;
+}
+/**
+ * Parse and structurally lint a JSON-Schema editor buffer.
+ *
+ *  - Empty text is VALID (an unset, optional schema) with a `null` schema.
+ *  - Malformed JSON is INVALID; the parser message is surfaced verbatim.
+ *  - A top-level value that is not a JSON object (an array or a scalar) is INVALID.
+ *  - When `requireTitle`, a top-level string `"title"` is REQUIRED (the
+ *    `response_format` contract the backend enforces); its absence is INVALID.
+ *
+ * The parsed object is returned untouched — no key is normalized, reordered, or
+ * dropped — so a schema carrying `$defs`/`anyOf` round-trips exactly.
+ */
+export declare function lintSchemaText(text: string, requireTitle: boolean): SchemaLintResult;
+//# sourceMappingURL=lint.d.ts.map

package/dist/schema-editor/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/schema-editor/lint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,gBAAgB,CA4BpF"}

package/dist/schema-editor/lint.js

@@ -0,0 +1,49 @@
+/**
+ * The pure parse + structural lint behind the `SchemaEditor` module. It never throws:
+ * a malformed value IS the result it reports. Full meta-schema validation stays
+ * server-side (the backend 400s carry the detail); this is the fast, loud client
+ * guard that keeps an obviously-broken schema from ever leaving the dialog.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse and structurally lint a JSON-Schema editor buffer.
+ *
+ *  - Empty text is VALID (an unset, optional schema) with a `null` schema.
+ *  - Malformed JSON is INVALID; the parser message is surfaced verbatim.
+ *  - A top-level value that is not a JSON object (an array or a scalar) is INVALID.
+ *  - When `requireTitle`, a top-level string `"title"` is REQUIRED (the
+ *    `response_format` contract the backend enforces); its absence is INVALID.
+ *
+ * The parsed object is returned untouched — no key is normalized, reordered, or
+ * dropped — so a schema carrying `$defs`/`anyOf` round-trips exactly.
+ */
+export function lintSchemaText(text, requireTitle) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return { schema: null, valid: true, error: undefined };
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (error) {
+        return {
+            schema: null,
+            valid: false,
+            error: error instanceof Error ? error.message : 'Invalid JSON.',
+        };
+    }
+    if (!isPlainObject(parsed)) {
+        return { schema: null, valid: false, error: 'The schema must be a JSON object.' };
+    }
+    if (requireTitle && typeof parsed.title !== 'string') {
+        return {
+            schema: parsed,
+            valid: false,
+            error: 'A top-level "title" string is required for this schema.',
+        };
+    }
+    return { schema: parsed, valid: true, error: undefined };
+}
+//# sourceMappingURL=lint.js.map

package/dist/schema-editor/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/schema-editor/lint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,YAAqB;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAE3E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IACpF,CAAC;IAED,IAAI,YAAY,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,yDAAyD;SACjE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC"}