@tai42/studio-sdk 0.2.0

package/dist/schema-form/SchemaForm.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `SchemaForm` — the controlled, JSON-Schema-driven auto-form. Given a schema
+ * (as Pydantic v2 emits) plus a value and `onChange`, it renders the form and
+ * emits a plain JS value; the CALLER owns the submit button. It is the
+ * load-bearing renderer reused by the tools run panel and the interactions form
+ * answer format, which is why it lives in the SDK (features cannot import each
+ * other).
+ *
+ * SAFETY: every schema-derived string (title, description, enum label, notice)
+ * is rendered as TEXT through the DS components — React escapes it. No markdown,
+ * no HTML, no `dangerouslySetInnerHTML` sink ever touches a schema-supplied
+ * string. Pinned by a test.
+ *
+ * MEDIA UPLOADS: a string field renders as a file-upload / drag-drop control
+ * (instead of a text box) when its schema carries media annotations, so an
+ * image/file input stays a JSON-serializable string that round-trips through the
+ * normal submit path. The annotation contract:
+ *   - `contentEncoding: "base64"` + `contentMediaType` (e.g. `"image/*"`,
+ *     `"application/pdf"`) → the emitted value is the raw base64 body (no
+ *     `data:` prefix); `contentMediaType` also constrains the accepted MIME.
+ *   - `format: "data-url"` (optionally with `contentMediaType`) → the emitted
+ *     value is a full `data:<mime>;base64,<body>` URL.
+ *   - `contentMaxBytes` pins a per-field size cap (bytes); otherwise the
+ *     {@link SchemaFormProps.maxUploadBytes} prop, else {@link DEFAULT_MAX_UPLOAD_BYTES}.
+ * An over-cap value or a MIME that does not match `contentMediaType` is REJECTED
+ * with a visible error — never silently truncated or accepted. The cap holds on
+ * EVERY input path (file picker, the paste fallback, and `validateAgainstSchema`),
+ * measured against the value's DECODED byte size. A text fallback (paste a
+ * URL/base64) stays available. The uploaded filename renders ESCAPED.
+ *
+ * `contentMaxBytes` is a NONSTANDARD JSON-Schema extension keyword (a standard
+ * validator ignores it); these client-side caps are UX guards, and the SERVER
+ * MUST independently validate the decoded size. The base64 decoding and cap
+ * checks live in the sibling `media` module.
+ */
+import type { ReactNode } from 'react';
+import type { JsonSchema, SchemaFormErrors } from './types';
+/**
+ * Fetch argument-value suggestions for a string field. `argName` is the field's
+ * path within the form (a property key at the root, a dotted path when nested);
+ * `partial` is the value typed so far. The caller owns the source (e.g. an MCP
+ * `completion/complete` call) — SchemaForm only routes string fields through the
+ * completion-backed input when a provider is supplied.
+ */
+export type CompletionProvider = (argName: string, partial: string) => Promise<string[]>;
+export interface SchemaFormProps {
+    readonly schema: JsonSchema;
+    readonly value: unknown;
+    readonly onChange: (value: unknown) => void;
+    readonly errors?: SchemaFormErrors;
+    readonly idPrefix?: string;
+    /**
+     * Optional. When supplied, every string field renders through the
+     * completion-backed input (argument autocomplete); when omitted, string fields
+     * render as a plain text input — the default, unchanged behaviour.
+     */
+    readonly completionProvider?: CompletionProvider;
+    /**
+     * Optional. Default byte cap for media-upload fields (see the module
+     * doc-comment). A field's own `contentMaxBytes` annotation overrides it;
+     * absent both, {@link DEFAULT_MAX_UPLOAD_BYTES} applies.
+     */
+    readonly maxUploadBytes?: number;
+}
+/**
+ * Render a controlled form for `schema`. The root is usually an object (a tool's
+ * input schema); a scalar/array/union root renders as a single field group.
+ */
+export declare function SchemaForm({ schema, value, onChange, errors, idPrefix, completionProvider, maxUploadBytes, }: SchemaFormProps): ReactNode;
+//# sourceMappingURL=SchemaForm.d.ts.map

package/dist/schema-form/SchemaForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaForm.d.ts","sourceRoot":"","sources":["../../src/schema-form/SchemaForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI5D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAwB,EACxB,kBAAkB,EAClB,cAAyC,GAC1C,EAAE,eAAe,GAAG,SAAS,CAoB7B"}

package/dist/schema-form/SchemaForm.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { CompletionProviderContext, MaxUploadBytesContext } from './context';
+import { FieldNode } from './field-node';
+import { DEFAULT_MAX_UPLOAD_BYTES } from './media';
+import { stackClass } from './styles';
+/**
+ * Render a controlled form for `schema`. The root is usually an object (a tool's
+ * input schema); a scalar/array/union root renders as a single field group.
+ */
+export function SchemaForm({ schema, value, onChange, errors, idPrefix = 'schema-form', completionProvider, maxUploadBytes = DEFAULT_MAX_UPLOAD_BYTES, }) {
+    return (_jsx(CompletionProviderContext.Provider, { value: completionProvider, children: _jsx(MaxUploadBytesContext.Provider, { value: maxUploadBytes, children: _jsx("div", { className: stackClass, "data-testid": idPrefix, children: _jsx(FieldNode, { schema: schema, root: schema, value: value, onChange: onChange, path: "", label: undefined, required: true, errors: errors, idPrefix: idPrefix }) }) }) }));
+}
+//# sourceMappingURL=SchemaForm.js.map

package/dist/schema-form/SchemaForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaForm.js","sourceRoot":"","sources":["../../src/schema-form/SchemaForm.tsx"],"names":[],"mappings":";AAqCA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAkCtC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,GAAG,aAAa,EACxB,kBAAkB,EAClB,cAAc,GAAG,wBAAwB,GACzB;IAChB,OAAO,CACL,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,kBAAkB,YAC3D,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,cAAc,YACnD,cAAK,SAAS,EAAE,UAAU,iBAAe,QAAQ,YAC/C,KAAC,SAAS,IACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAC,EAAE,EACP,KAAK,EAAE,SAAS,EAChB,QAAQ,QACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAClB,GACE,GACyB,GACE,CACtC,CAAC;AACJ,CAAC"}

package/dist/schema-form/array-field.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The array field renderer. Each item is a nested {@link FieldNode}; edits map
+ * the list to a new array (add appends a seeded item, remove filters by index).
+ * The whole list re-renders as one controlled value, so index keys are correct.
+ */
+import type { ReactNode } from 'react';
+import type { JsonSchema, SchemaFormErrors } from './types';
+export declare function ArrayField({ heading, description, error, items, root, value, onChange, path, errors, idPrefix, }: {
+    heading: string;
+    description: string | undefined;
+    error: string | undefined;
+    items: JsonSchema;
+    root: JsonSchema;
+    value: unknown;
+    onChange: (value: unknown) => void;
+    path: string;
+    errors: SchemaFormErrors | undefined;
+    idPrefix: string;
+}): ReactNode;
+//# sourceMappingURL=array-field.d.ts.map

package/dist/schema-form/array-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-field.d.ts","sourceRoot":"","sources":["../../src/schema-form/array-field.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE5D,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,WAAW,EACX,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,SAAS,CA0DZ"}

package/dist/schema-form/array-field.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CloseIcon } from '../components/icons';
+import { Button } from '../components/primitives';
+import { classifySchema } from './classify';
+import { defaultValueForSchema } from './default-value';
+import { FieldGroup } from './field-group';
+import { FieldNode } from './field-node';
+export function ArrayField({ heading, description, error, items, root, value, onChange, path, errors, idPrefix, }) {
+    const list = Array.isArray(value) ? value : [];
+    const addItem = () => {
+        onChange([...list, newItemValue(items, root)]);
+    };
+    const removeItem = (index) => {
+        onChange(list.filter((_, position) => position !== index));
+    };
+    const setItem = (index, next) => {
+        onChange(list.map((item, position) => (position === index ? next : item)));
+    };
+    return (_jsxs(FieldGroup, { heading: heading, description: description, error: error, atRoot: false, children: [list.length === 0 ? _jsx("span", { className: "tai-field-hint", children: "No items" }) : null, list.map((item, index) => (_jsxs("div", { className: "tai-row", children: [_jsx("div", { style: { flex: 1 }, children: _jsx(FieldNode, { schema: items, root: root, value: item, onChange: (next) => {
+                                setItem(index, next);
+                            }, path: `${path}[${String(index)}]`, label: `Item ${String(index + 1)}`, required: true, errors: errors, idPrefix: idPrefix }) }), _jsxs(Button, { type: "button", variant: "secondary", "aria-label": `Remove item ${String(index + 1)}`, onClick: () => {
+                            removeItem(index);
+                        }, children: [_jsx(CloseIcon, {}), "Remove"] })] }, index))), _jsx("div", { children: _jsx(Button, { type: "button", variant: "secondary", onClick: addItem, children: "Add item" }) })] }));
+}
+function newItemValue(schema, root) {
+    const seeded = defaultValueForSchema(schema, root);
+    if (seeded !== undefined)
+        return seeded;
+    const classified = classifySchema(schema, root);
+    switch (classified.model.kind) {
+        case 'string':
+            return '';
+        case 'boolean':
+            return false;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=array-field.js.map

package/dist/schema-form/array-field.js.map

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

package/dist/schema-form/classify.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The single source of truth for "what kind of field is this schema?". Both the
+ * renderer and the validator classify through here so a construct is treated
+ * identically everywhere. Classification resolves `$ref`, normalizes `anyOf`/
+ * `oneOf` (null-union → nullable single field; multi-member → variant selector),
+ * and lands every unrecognized construct on the explicit `unsupported` kind —
+ * a field is never silently dropped.
+ */
+import { type EnumOption } from './resolve';
+import type { JsonSchema } from './types';
+/**
+ * How a string field accepts binary content as a JSON-serializable string.
+ * Derived from a field's JSON-Schema media annotations (see the `SchemaForm` module).
+ */
+export interface MediaUpload {
+    /**
+     * `base64` — the emitted value is the raw base64 body (no `data:` prefix),
+     * matching `contentEncoding: "base64"`. `data-url` — the emitted value is a
+     * full `data:<mime>;base64,<body>` URL, matching `format: "data-url"`.
+     */
+    readonly encoding: 'base64' | 'data-url';
+    /**
+     * The `contentMediaType` constraint (e.g. `image/*`, `application/pdf`), used
+     * for MIME validation and the file picker's `accept`. `undefined` for a bare
+     * `format: "data-url"` field with no declared type.
+     */
+    readonly mediaType: string | undefined;
+    /** A per-field byte cap from `contentMaxBytes`, if the schema pins one. */
+    readonly maxBytes: number | undefined;
+}
+/** One selectable variant of a union field. */
+export interface UnionVariant {
+    readonly label: string;
+    /** The discriminator tag value, or `undefined` for a non-discriminated union. */
+    readonly tag: unknown;
+    /** The variant schema as written (unresolved — the renderer resolves it). */
+    readonly schema: JsonSchema;
+}
+/** The renderer-facing classification of a schema node. */
+export type FieldModel = {
+    readonly kind: 'const';
+    readonly value: unknown;
+} | {
+    readonly kind: 'enum';
+    readonly options: readonly EnumOption[];
+} | {
+    readonly kind: 'string';
+    readonly format: string | undefined;
+    /** Present when media annotations opt the field into the upload control. */
+    readonly media: MediaUpload | undefined;
+} | {
+    readonly kind: 'number';
+    readonly integer: boolean;
+} | {
+    readonly kind: 'boolean';
+} | {
+    readonly kind: 'array';
+    readonly items: JsonSchema;
+} | {
+    readonly kind: 'object';
+    readonly properties: readonly (readonly [string, JsonSchema])[];
+    readonly required: ReadonlySet<string>;
+} | {
+    readonly kind: 'union';
+    readonly variants: readonly UnionVariant[];
+    readonly discriminator: string | undefined;
+} | {
+    readonly kind: 'unsupported';
+    readonly reason: string;
+};
+/** A fully classified field: its model plus resolved metadata. */
+export interface ClassifiedField {
+    readonly model: FieldModel;
+    /** True when JSON `null` is an accepted value (a null-union member). */
+    readonly nullable: boolean;
+    /** The effective (ref-resolved) schema this classification describes. */
+    readonly schema: JsonSchema;
+    readonly title: string | undefined;
+    readonly description: string | undefined;
+}
+/**
+ * Classify a schema node (resolving `$ref` first). `wrapper` metadata (a
+ * ref-site title/description) is threaded down so a `{ $ref, title }` or a
+ * null-union wrapper keeps its property-level label.
+ */
+export declare function classifySchema(raw: JsonSchema, root: JsonSchema): ClassifiedField;
+//# sourceMappingURL=classify.d.ts.map

package/dist/schema-form/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/schema-form/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAQL,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,GAClE;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CACzC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACtD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,eAAe,CA6KjF"}

package/dist/schema-form/classify.js

@@ -0,0 +1,199 @@
+/**
+ * The single source of truth for "what kind of field is this schema?". Both the
+ * renderer and the validator classify through here so a construct is treated
+ * identically everywhere. Classification resolves `$ref`, normalizes `anyOf`/
+ * `oneOf` (null-union → nullable single field; multi-member → variant selector),
+ * and lands every unrecognized construct on the explicit `unsupported` kind —
+ * a field is never silently dropped.
+ */
+import { isNullSchema, resolveRef, scalarLabel, typeList, unionMembers, variantLabel, variantTag, } from './resolve';
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Detect the media-upload annotations on a (ref-resolved) string schema. A field
+ * opts into the upload control when it carries `contentEncoding: "base64"` plus a
+ * `contentMediaType`, OR `format: "data-url"`. Anything else is a plain string.
+ */
+function mediaUpload(schema) {
+    const mediaType = typeof schema.contentMediaType === 'string' ? schema.contentMediaType : undefined;
+    const maxBytes = typeof schema.contentMaxBytes === 'number' && schema.contentMaxBytes > 0
+        ? schema.contentMaxBytes
+        : undefined;
+    if (schema.format === 'data-url') {
+        return { encoding: 'data-url', mediaType, maxBytes };
+    }
+    if (schema.contentEncoding === 'base64' && mediaType !== undefined) {
+        return { encoding: 'base64', mediaType, maxBytes };
+    }
+    return undefined;
+}
+function unsupported(schema, reason, title, description) {
+    return { model: { kind: 'unsupported', reason }, nullable: false, schema, title, description };
+}
+/**
+ * Classify a schema node (resolving `$ref` first). `wrapper` metadata (a
+ * ref-site title/description) is threaded down so a `{ $ref, title }` or a
+ * null-union wrapper keeps its property-level label.
+ */
+export function classifySchema(raw, root) {
+    const resolved = resolveRef(raw, root);
+    const title = firstString(raw.title, resolved.title);
+    const description = firstString(raw.description, resolved.description);
+    // const pins a single value.
+    if ('const' in resolved) {
+        return {
+            model: { kind: 'const', value: resolved.const },
+            nullable: false,
+            schema: resolved,
+            title,
+            description,
+        };
+    }
+    // enum → a fixed choice list.
+    if (resolved.enum !== undefined) {
+        const options = resolved.enum.map((value) => ({
+            value,
+            label: scalarLabel(value),
+        }));
+        const nullable = resolved.enum.some((value) => value === null);
+        return { model: { kind: 'enum', options }, nullable, schema: resolved, title, description };
+    }
+    // anyOf/oneOf union normalization.
+    const members = unionMembers(resolved);
+    if (members !== undefined) {
+        const nonNull = members.filter((member) => !isNullSchema(resolveRef(member, root)));
+        const nullable = nonNull.length !== members.length;
+        const soleNonNull = nonNull[0];
+        if (soleNonNull === undefined) {
+            return unsupported(resolved, 'union with no non-null members', title, description);
+        }
+        if (nonNull.length === 1) {
+            const inner = classifySchema(soleNonNull, root);
+            // Media annotations (`contentEncoding`/`contentMediaType`/`format: data-url`)
+            // that land on the OUTER null-union wrapper of an OPTIONAL field would
+            // otherwise be lost when delegating to the inner string member, silently
+            // degrading an optional upload field to a plain text box. Re-detect them on
+            // the wrapper and attach to the inner string model.
+            const model = inner.model.kind === 'string' && inner.model.media === undefined
+                ? { ...inner.model, media: mediaUpload(resolved) }
+                : inner.model;
+            return {
+                model,
+                nullable: nullable || inner.nullable,
+                schema: inner.schema,
+                title: title ?? inner.title,
+                description: description ?? inner.description,
+            };
+        }
+        const discriminator = resolved.discriminator?.propertyName;
+        const variants = nonNull.map((member, index) => {
+            const tag = discriminator === undefined ? undefined : variantTag(member, discriminator, root);
+            return { label: variantLabel(member, index, tag, root), tag, schema: member };
+        });
+        return {
+            model: { kind: 'union', variants, discriminator },
+            nullable,
+            schema: resolved,
+            title,
+            description,
+        };
+    }
+    // allOf: Pydantic wraps a single $ref this way; a multi-member intersection is
+    // not a form-renderable construct.
+    if (resolved.allOf !== undefined) {
+        const soleAllOf = resolved.allOf[0];
+        if (resolved.allOf.length === 1 && soleAllOf !== undefined) {
+            const inner = classifySchema(soleAllOf, root);
+            return {
+                model: inner.model,
+                nullable: inner.nullable,
+                schema: inner.schema,
+                title: title ?? inner.title,
+                description: description ?? inner.description,
+            };
+        }
+        return unsupported(resolved, 'allOf intersection of multiple schemas', title, description);
+    }
+    // Type-driven classification.
+    const types = typeList(resolved);
+    const nonNullTypes = types.filter((type) => type !== 'null');
+    const nullableByType = nonNullTypes.length !== types.length;
+    if (nonNullTypes.length === 0) {
+        return unsupported(resolved, 'schema declares no renderable type', title, description);
+    }
+    if (nonNullTypes.length > 1) {
+        return unsupported(resolved, `multiple JSON types (${nonNullTypes.join(', ')}) without a discriminator`, title, description);
+    }
+    const type = nonNullTypes[0];
+    if (type === undefined) {
+        return unsupported(resolved, 'schema declares no renderable type', title, description);
+    }
+    switch (type) {
+        case 'string':
+            return {
+                model: { kind: 'string', format: resolved.format, media: mediaUpload(resolved) },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        case 'number':
+            return {
+                model: { kind: 'number', integer: false },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        case 'integer':
+            return {
+                model: { kind: 'number', integer: true },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        case 'boolean':
+            return {
+                model: { kind: 'boolean' },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        case 'array': {
+            if (resolved.items === undefined) {
+                return unsupported(resolved, 'array without an items schema', title, description);
+            }
+            return {
+                model: { kind: 'array', items: resolved.items },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        }
+        case 'object': {
+            if (resolved.properties === undefined) {
+                return unsupported(resolved, 'free-form object (additionalProperties map) is not supported', title, description);
+            }
+            const properties = Object.entries(resolved.properties);
+            const required = new Set(resolved.required ?? []);
+            return {
+                model: { kind: 'object', properties, required },
+                nullable: nullableByType,
+                schema: resolved,
+                title,
+                description,
+            };
+        }
+        default:
+            return unsupported(resolved, `unrecognized type "${String(type)}"`, title, description);
+    }
+}
+//# sourceMappingURL=classify.js.map

package/dist/schema-form/classify.js.map

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

package/dist/schema-form/context.d.ts

@@ -0,0 +1,4 @@
+import type { CompletionProvider } from './SchemaForm';
+export declare const CompletionProviderContext: import("react").Context<CompletionProvider | undefined>;
+export declare const MaxUploadBytesContext: import("react").Context<number>;
+//# sourceMappingURL=context.d.ts.map

package/dist/schema-form/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIvD,eAAO,MAAM,yBAAyB,yDAA2D,CAAC;AAIlG,eAAO,MAAM,qBAAqB,iCAAkD,CAAC"}

package/dist/schema-form/context.js

@@ -0,0 +1,14 @@
+/**
+ * Ambient React contexts for the schema-form tree: the optional argument
+ * completion provider and the default media-upload byte cap. A field deep in the
+ * tree reads these here rather than every intermediate node drilling the prop.
+ */
+import { createContext } from 'react';
+import { DEFAULT_MAX_UPLOAD_BYTES } from './media';
+// Ambient completion provider for the whole form. A string field deep in the
+// tree reads it here rather than every intermediate node drilling the prop.
+export const CompletionProviderContext = createContext(undefined);
+// Ambient default upload cap for the whole form; a media field reads it here so
+// intermediate object/array nodes never drill the prop.
+export const MaxUploadBytesContext = createContext(DEFAULT_MAX_UPLOAD_BYTES);
+//# sourceMappingURL=context.js.map

package/dist/schema-form/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAGnD,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAiC,SAAS,CAAC,CAAC;AAElG,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAS,wBAAwB,CAAC,CAAC"}

package/dist/schema-form/default-value.d.ts

@@ -0,0 +1,8 @@
+import type { JsonSchema } from './types';
+/**
+ * The initial value for a schema. `root` carries the `$defs` document for
+ * `$ref` resolution and defaults to the schema itself (the common
+ * whole-tool-schema call).
+ */
+export declare function defaultValueForSchema(schema: JsonSchema, root?: JsonSchema): unknown;
+//# sourceMappingURL=default-value.d.ts.map

package/dist/schema-form/default-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-value.d.ts","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAY1C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,UAAmB,GAAG,OAAO,CAiC5F"}

package/dist/schema-form/default-value.js

@@ -0,0 +1,64 @@
+/**
+ * `defaultValueForSchema` — the initial form value for a schema, honoring
+ * `default`/`const` and seeding required nested structure.
+ *
+ * Inclusion rules keep the seed honest:
+ *  - a REQUIRED property is seeded (objects → a nested seed, arrays → `[]`); a
+ *    required scalar with no default is left ABSENT so validation flags it
+ *    rather than inventing a value;
+ *  - an OPTIONAL property is included only when it carries an explicit
+ *    `default` — an optional object/array is NOT auto-materialized, so its own
+ *    required children can't raise spurious errors on a field the user never
+ *    opted into.
+ */
+import { classifySchema } from './classify';
+/** The explicit `default` (wrapper takes precedence over the resolved node), if any. */
+function explicitDefault(raw, resolved) {
+    if ('default' in raw)
+        return { present: true, value: raw.default };
+    if ('default' in resolved)
+        return { present: true, value: resolved.default };
+    return { present: false, value: undefined };
+}
+/**
+ * The initial value for a schema. `root` carries the `$defs` document for
+ * `$ref` resolution and defaults to the schema itself (the common
+ * whole-tool-schema call).
+ */
+export function defaultValueForSchema(schema, root = schema) {
+    const classified = classifySchema(schema, root);
+    const explicit = explicitDefault(schema, classified.schema);
+    if (explicit.present)
+        return explicit.value;
+    const { model } = classified;
+    switch (model.kind) {
+        case 'const':
+            return model.value;
+        case 'object': {
+            const result = {};
+            for (const [name, propSchema] of model.properties) {
+                if (model.required.has(name)) {
+                    const seeded = defaultValueForSchema(propSchema, root);
+                    if (seeded !== undefined)
+                        result[name] = seeded;
+                    continue;
+                }
+                const propClassified = classifySchema(propSchema, root);
+                const propDefault = explicitDefault(propSchema, propClassified.schema);
+                if (propDefault.present)
+                    result[name] = propDefault.value;
+            }
+            return result;
+        }
+        case 'array':
+            return [];
+        case 'enum':
+        case 'string':
+        case 'number':
+        case 'boolean':
+        case 'union':
+        case 'unsupported':
+            return undefined;
+    }
+}
+//# sourceMappingURL=default-value.js.map

package/dist/schema-form/default-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-value.js","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,wFAAwF;AACxF,SAAS,eAAe,CACtB,GAAe,EACf,QAAoB;IAEpB,IAAI,SAAS,IAAI,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACnE,IAAI,SAAS,IAAI,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAkB,EAAE,OAAmB,MAAM;IACjF,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC;IAE5C,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAC7B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAA4B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAClD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;oBACvD,IAAI,MAAM,KAAK,SAAS;wBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;oBAChD,SAAS;gBACX,CAAC;gBACD,MAAM,cAAc,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACxD,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;gBACvE,IAAI,WAAW,CAAC,OAAO;oBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;YAC5D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,OAAO,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/schema-form/enum-field.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The enum field renderer. A short enum (up to {@link RADIO_MAX_OPTIONS}
+ * options) renders as a radio group; a longer one renders as a select. Options
+ * are keyed by index so a non-string enum value round-trips through the string
+ * control.
+ */
+import type { ReactNode } from 'react';
+import type { FieldModel } from './classify';
+export declare function EnumField({ heading, description, error, model, value, onChange, }: {
+    heading: string;
+    description: string | undefined;
+    error: string | undefined;
+    model: Extract<FieldModel, {
+        kind: 'enum';
+    }>;
+    value: unknown;
+    onChange: (value: unknown) => void;
+}): ReactNode;
+//# sourceMappingURL=enum-field.d.ts.map

package/dist/schema-form/enum-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-field.d.ts","sourceRoot":"","sources":["../../src/schema-form/enum-field.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,WAAW,EACX,KAAK,EACL,KAAK,EACL,KAAK,EACL,QAAQ,GACT,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,GAAG,SAAS,CAmCZ"}

package/dist/schema-form/enum-field.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Field } from '../components/field';
+import { RadioGroup } from '../components/radio-group';
+import { Select } from '../components/select';
+const RADIO_MAX_OPTIONS = 3;
+export function EnumField({ heading, description, error, model, value, onChange, }) {
+    const options = model.options.map((option, index) => ({
+        key: String(index),
+        label: option.label,
+        value: option.value,
+    }));
+    const selected = options.find((option) => option.value === value);
+    // Always a defined string so the control stays controlled from first render
+    // (an `undefined` → string transition warns about uncontrolled→controlled).
+    const selectedKey = selected?.key ?? '';
+    const emit = (key) => {
+        const match = options.find((option) => option.key === key);
+        if (match !== undefined)
+            onChange(match.value);
+    };
+    if (options.length <= RADIO_MAX_OPTIONS) {
+        return (_jsx(Field, { label: heading, description: description, error: error, group: true, children: _jsx(RadioGroup, { options: options.map((option) => ({ value: option.key, label: option.label })), value: selectedKey, onValueChange: emit }) }));
+    }
+    return (_jsx(Field, { label: heading, description: description, error: error, children: _jsx(Select, { options: options.map((option) => ({ value: option.key, label: option.label })), value: selectedKey, onValueChange: emit }) }));
+}
+//# sourceMappingURL=enum-field.js.map