@tai42/studio-sdk 16.0.0 → 16.0.1

package/dist/state-binding/adapter-mapping-row.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * One row of the adapter mapping form: it picks ONE of three value sources for a
+ * declared input key — a picked field (from the run's output / input schema), a
+ * hardcoded literal, or a jq expression — and shows the row's own compiled jq on
+ * demand. {@link AdapterMapping} composes one editor per declared key.
+ */
+import { useState } from 'react';
+import { Badge } from '../components/badge';
+import { Button, Skeleton } from '../components/primitives';
+import { Field } from '../components/field';
+import { Select } from '../components/select';
+import { TextInput } from '../components/inputs';
+import { BindingJqField } from './BindingJqField';
+import { rowValueJq } from './adapter';
+const ROOT_OPTIONS = [
+    { value: 'output', label: 'Run output' },
+    { value: 'input', label: 'Run input' },
+];
+const SOURCE_OPTIONS = [
+    { value: 'field', label: 'Field' },
+    { value: 'literal', label: 'Literal' },
+    { value: 'jq', label: 'Jq' },
+];
+function fieldsFor(root, sources) {
+    if (root === 'output')
+        return sources?.output ?? [];
+    return sources?.input ?? [];
+}
+/** The value control for one row's picked-field source: a Select where a schema is known, else a path input. */
+function FieldSourceControl({ root, path, onRootChange, onPathChange, fields, loading = false, error, }) {
+    const pathInput = (_jsx(TextInput, { "aria-label": "Field path", placeholder: "path.into.value", value: path.join('.'), onChange: (event) => {
+            const text = event.target.value.trim();
+            onPathChange(text === '' ? [] : text.split('.'));
+        } }));
+    return (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--tai-space-1)' }, children: [_jsxs("div", { style: { display: 'flex', gap: 'var(--tai-space-2)', flexWrap: 'wrap' }, children: [_jsx(Field, { label: "Field root", hideLabel: true, children: _jsx(Select, { value: root, onValueChange: (next) => {
+                                onRootChange(next);
+                            }, options: ROOT_OPTIONS.map((option) => ({ value: option.value, label: option.label })) }) }), loading ? (_jsx(Skeleton, { height: 32, width: 220 })) : fields.length > 0 ? (_jsx(Field, { label: "Field", hideLabel: true, children: _jsx(Select, { placeholder: "Choose a field", value: path.length === 0 ? '' : JSON.stringify(path), onValueChange: (next) => {
+                                onPathChange(next === '' ? [] : JSON.parse(next));
+                            }, options: [
+                                { value: '', label: '(whole value)' },
+                                ...fields.map((field) => ({
+                                    value: JSON.stringify(field.path),
+                                    label: field.label,
+                                })),
+                            ] }) })) : (pathInput)] }), error !== undefined && !loading ? (_jsx("span", { role: "status", style: { color: 'var(--tai-color-text-muted)', fontSize: 'var(--tai-text-sm)' }, children: error })) : null] }));
+}
+export function MappingRowEditor({ row, onChange, sources, suggestions, }) {
+    const [showJq, setShowJq] = useState(false);
+    const source = row.source;
+    const preview = rowValueJq(source);
+    const setSource = (next) => {
+        onChange({ ...row, source: next });
+    };
+    const changeKind = (kind) => {
+        if (kind === 'field')
+            setSource({ kind: 'field', root: 'output', path: [] });
+        else if (kind === 'literal')
+            setSource({ kind: 'literal', json: '' });
+        else
+            setSource({ kind: 'jq', expr: '' });
+    };
+    return (_jsxs("div", { "data-testid": `adapter-row-${row.target}`, style: {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 'var(--tai-space-1)',
+            padding: 'var(--tai-space-2)',
+            border: '1px solid var(--tai-color-border)',
+            borderRadius: 'var(--tai-radius-md)',
+        }, children: [_jsxs("div", { style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: 'var(--tai-space-2)',
+                    flexWrap: 'wrap',
+                }, children: [_jsx(Badge, { variant: "neutral", children: row.target }), _jsx(Field, { label: `Source for ${row.target}`, hideLabel: true, children: _jsx(Select, { "aria-label": `Source for ${row.target}`, value: source.kind, onValueChange: changeKind, options: SOURCE_OPTIONS }) })] }), source.kind === 'field' ? (_jsx(FieldSourceControl, { root: source.root, path: source.path, fields: fieldsFor(source.root, sources), loading: sources?.loading, error: sources?.error, onRootChange: (nextRoot) => {
+                    setSource({ kind: 'field', root: nextRoot, path: [] });
+                }, onPathChange: (nextPath) => {
+                    setSource({ kind: 'field', root: source.root, path: nextPath });
+                } })) : source.kind === 'literal' ? (_jsx(Field, { label: `Literal for ${row.target}`, hideLabel: true, error: preview.ok ? undefined : preview.error, children: _jsx(TextInput, { "aria-label": `Literal for ${row.target}`, placeholder: '"a string", 42, true, or {"k":1}', value: source.json, onChange: (event) => {
+                        setSource({ kind: 'literal', json: event.target.value });
+                    } }) })) : (_jsx(BindingJqField, { label: `Jq for ${row.target}`, value: source.expr, onChange: (next) => {
+                    setSource({ kind: 'jq', expr: next });
+                }, error: preview.ok ? undefined : preview.error, suggestions: suggestions })), _jsxs("div", { children: [_jsx(Button, { type: "button", variant: "ghost", "aria-expanded": showJq, onClick: () => {
+                            setShowJq((open) => !open);
+                        }, children: showJq ? 'Hide jq' : 'Show jq' }), showJq ? (_jsx("pre", { "data-testid": `adapter-row-jq-${row.target}`, style: { margin: 0, fontFamily: 'var(--tai-font-mono)', whiteSpace: 'pre-wrap' }, children: preview.ok ? preview.jq : preview.error })) : null] })] }));
+}
+//# sourceMappingURL=adapter-mapping-row.js.map

package/dist/state-binding/adapter-mapping-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-mapping-row.js","sourceRoot":"","sources":["../../src/state-binding/adapter-mapping-row.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,cAAc,EAA6B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAuD,MAAM,WAAW,CAAC;AAG5F,MAAM,YAAY,GAAmD;IACnE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE;IACxC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE;CACvC,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;IAClC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;CAC7B,CAAC;AAEF,SAAS,SAAS,CAChB,IAAe,EACf,OAAyC;IAEzC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;IACpD,OAAO,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,gHAAgH;AAChH,SAAS,kBAAkB,CAAC,EAC1B,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,OAAO,GAAG,KAAK,EACf,KAAK,GASN;IACC,MAAM,SAAS,GAAG,CAChB,KAAC,SAAS,kBACG,YAAY,EACvB,WAAW,EAAC,iBAAiB,EAC7B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACvC,YAAY,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC,GACD,CACH,CAAC;IACF,OAAO,CACL,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,oBAAoB,EAAE,aACjF,eAAK,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,EAAE,aAC1E,KAAC,KAAK,IAAC,KAAK,EAAC,YAAY,EAAC,SAAS,kBACjC,KAAC,MAAM,IACL,KAAK,EAAE,IAAI,EACX,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;gCACtB,YAAY,CAAC,IAAiB,CAAC,CAAC;4BAClC,CAAC,EACD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,GACrF,GACI,EACP,OAAO,CAAC,CAAC,CAAC,CACT,KAAC,QAAQ,IAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAI,CACrC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CACtB,KAAC,KAAK,IAAC,KAAK,EAAC,OAAO,EAAC,SAAS,kBAC5B,KAAC,MAAM,IACL,WAAW,EAAC,gBAAgB,EAC5B,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EACpD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE;gCACtB,YAAY,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC;4BAClE,CAAC,EACD,OAAO,EAAE;gCACP,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE;gCACrC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oCACxB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;oCACjC,KAAK,EAAE,KAAK,CAAC,KAAK;iCACnB,CAAC,CAAC;6BACJ,GACD,GACI,CACT,CAAC,CAAC,CAAC,CACF,SAAS,CACV,IACG,EACL,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CACjC,eACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAE9E,KAAK,GACD,CACR,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAC/B,GAAG,EACH,QAAQ,EACR,OAAO,EACP,WAAW,GAMZ;IACC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnC,MAAM,SAAS,GAAG,CAAC,IAAmB,EAAQ,EAAE;QAC9C,QAAQ,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAQ,EAAE;QACxC,IAAI,IAAI,KAAK,OAAO;YAAE,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;aACxE,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;;YACjE,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF,OAAO,CACL,8BACe,eAAe,GAAG,CAAC,MAAM,EAAE,EACxC,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,QAAQ;YACvB,GAAG,EAAE,oBAAoB;YACzB,OAAO,EAAE,oBAAoB;YAC7B,MAAM,EAAE,mCAAmC;YAC3C,YAAY,EAAE,sBAAsB;SACrC,aAED,eACE,KAAK,EAAE;oBACL,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;oBACpB,GAAG,EAAE,oBAAoB;oBACzB,QAAQ,EAAE,MAAM;iBACjB,aAED,KAAC,KAAK,IAAC,OAAO,EAAC,SAAS,YAAE,GAAG,CAAC,MAAM,GAAS,EAC7C,KAAC,KAAK,IAAC,KAAK,EAAE,cAAc,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,kBACjD,KAAC,MAAM,kBACO,cAAc,GAAG,CAAC,MAAM,EAAE,EACtC,KAAK,EAAE,MAAM,CAAC,IAAI,EAClB,aAAa,EAAE,UAAU,EACzB,OAAO,EAAE,cAAc,GACvB,GACI,IACJ,EAEL,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CACzB,KAAC,kBAAkB,IACjB,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EACzB,KAAK,EAAE,OAAO,EAAE,KAAK,EACrB,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE;oBACzB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACzD,CAAC,EACD,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE;oBACzB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAClE,CAAC,GACD,CACH,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAC9B,KAAC,KAAK,IACJ,KAAK,EAAE,eAAe,GAAG,CAAC,MAAM,EAAE,EAClC,SAAS,QACT,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,YAE7C,KAAC,SAAS,kBACI,eAAe,GAAG,CAAC,MAAM,EAAE,EACvC,WAAW,EAAC,kCAAkC,EAC9C,KAAK,EAAE,MAAM,CAAC,IAAI,EAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;wBAClB,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC3D,CAAC,GACD,GACI,CACT,CAAC,CAAC,CAAC,CACF,KAAC,cAAc,IACb,KAAK,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,EAC7B,KAAK,EAAE,MAAM,CAAC,IAAI,EAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;oBACjB,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxC,CAAC,EACD,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAC7C,WAAW,EAAE,WAAW,GACxB,CACH,EAED,0BACE,KAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,OAAO,mBACA,MAAM,EACrB,OAAO,EAAE,GAAG,EAAE;4BACZ,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;wBAC7B,CAAC,YAEA,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GACxB,EACR,MAAM,CAAC,CAAC,CAAC,CACR,6BACe,kBAAkB,GAAG,CAAC,MAAM,EAAE,EAC3C,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,sBAAsB,EAAE,UAAU,EAAE,UAAU,EAAE,YAE/E,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,GACpC,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,IACF,CACP,CAAC;AACJ,CAAC"}

package/dist/structured-output/StructuredOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StructuredOutput.d.ts","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAoBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAAG,SAAS,CAgCtF"}
+{"version":3,"file":"StructuredOutput.d.ts","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAgBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAAG,SAAS,CAgCtF"}

package/dist/structured-output/StructuredOutput.js

@@ -1,11 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { JsonTree } from '../components/json-tree';
 import { resolveRef } from '../schema-form/resolve';
+import { isRecord } from '../guards';
 /** The pane's name when the payload has no schema to name it by. */
 const RAW_OUTPUT_LABEL = 'Structured output';
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
 function isObjectSchema(schema, root) {
     if (!schema || !root)
         return false;

package/dist/structured-output/StructuredOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"StructuredOutput.js","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":";AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAUpD,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CACrB,MAA8B,EAC9B,IAA4B;IAE5B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAyB;IACzE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,CAGL,6BAAiB,uBAAuB,YACtC,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,EAAE,eAAe,QAAC,KAAK,EAAE,gBAAgB,GAAI,GAChE,CACP,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAE7C,OAAO,CACL,cAAK,SAAS,EAAC,uBAAuB,iBAAa,mBAAmB,YACnE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;YAChC,OAAO,CACL,eAAe,SAAS,EAAC,WAAW,aAClC,eAAM,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,EAE/C,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,eAAe,QAAC,KAAK,EAAE,IAAI,GAAI,KAHrD,GAAG,CAIP,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"StructuredOutput.js","sourceRoot":"","sources":["../../src/structured-output/StructuredOutput.tsx"],"names":[],"mappings":";AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AASrC,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,SAAS,cAAc,CACrB,MAA8B,EAC9B,IAA4B;IAE5B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAyB;IACzE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,CAGL,6BAAiB,uBAAuB,YACtC,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,EAAE,eAAe,QAAC,KAAK,EAAE,gBAAgB,GAAI,GAChE,CACP,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAE7C,OAAO,CACL,cAAK,SAAS,EAAC,uBAAuB,iBAAa,mBAAmB,YACnE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;YAChC,OAAO,CACL,eAAe,SAAS,EAAC,WAAW,aAClC,eAAM,SAAS,EAAC,iBAAiB,YAAE,IAAI,GAAQ,EAE/C,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,eAAe,QAAC,KAAK,EAAE,IAAI,GAAI,KAHrD,GAAG,CAIP,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "16.0.0",
+  "version": "16.0.1",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -96,7 +96,7 @@
     "@radix-ui/react-select": "^2.3.2",
     "@radix-ui/react-tabs": "^1.1.21",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "16.0.0"
+    "@tai42/api-client": "16.0.1"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/explorer-body.tsx

@@ -0,0 +1,239 @@
+/**
+ * The explorer's directory body: the empty-state ladder, the card grid and the
+ * scrolling table (folders sorted above items in both), and the page footer. The
+ * pagination MATH lives in `ExplorerView`; this renders the result.
+ */
+import type { ReactNode } from 'react';
+
+import { EntityCardGrid } from './entity-card-grid';
+import { FolderRow, type Folder } from './folder-nav';
+import { type OpenTargetProps } from './open-target';
+import { Button, Card, EmptyState } from './primitives';
+import { ScrollRegion } from './scroll-region';
+import { Select } from './select';
+import { Table, TBody, TD, TH, THead, TR } from './table';
+import type { ViewMode } from './view-toggle';
+import { PAGE_SIZES } from './explorer-page-size';
+import type { ExplorerColumn, ExplorerEmptyStates } from './explorer-view';
+
+/** One page entry: a subfolder (sorted first) or a filtered item, in one array. */
+export type ExplorerEntry<T> =
+  | { readonly kind: 'folder'; readonly folder: Folder }
+  | { readonly kind: 'item'; readonly item: T };
+
+/** A first-class folder entry — a `FolderRow` (icon + name, navigates inward)
+ *  beside its optional actions, in the layout shared by the row cell and the card. */
+function FolderEntry({
+  folder,
+  onNavigate,
+  renderFolderActions,
+}: {
+  readonly folder: Folder;
+  readonly onNavigate: (folderId: string | null) => void;
+  readonly renderFolderActions: ((folder: Folder) => ReactNode) | undefined;
+}): ReactNode {
+  return (
+    <div className="tai-explorer-folder">
+      <FolderRow folder={folder} onOpen={onNavigate} />
+      {renderFolderActions ? renderFolderActions(folder) : null}
+    </div>
+  );
+}
+
+interface ExplorerPagerProps {
+  readonly label: string;
+  readonly pageStart: number;
+  readonly pageSize: number;
+  readonly total: number;
+  readonly effectivePage: number;
+  readonly pageCount: number;
+  readonly onPageChange: (page: number) => void;
+  readonly onPageSizeChange: (size: number) => void;
+}
+
+function ExplorerPager({
+  label,
+  pageStart,
+  pageSize,
+  total,
+  effectivePage,
+  pageCount,
+  onPageChange,
+  onPageSizeChange,
+}: ExplorerPagerProps): ReactNode {
+  return (
+    <nav className="tai-explorer-pagination" aria-label={`${label} pagination`}>
+      {/* The pager counts ENTRIES — subfolders plus filtered items in the
+          current directory — which is a different unit from the header's total
+          item count across every folder. Naming the unit keeps the two honest:
+          "1–4 of 4 entries" here versus "7 templates" above. */}
+      <span className="tai-muted">{`${String(pageStart + 1)}–${String(Math.min(pageStart + pageSize, total))} of ${String(total)} entries`}</span>
+      <div className="tai-row">
+        <Select
+          aria-label="Items per page"
+          value={String(pageSize)}
+          onValueChange={(value) => {
+            onPageSizeChange(Number(value));
+          }}
+          options={PAGE_SIZES.map((size) => ({
+            value: String(size),
+            label: `${String(size)} per page`,
+          }))}
+        />
+        {/* aria-disabled, never the disabled attribute: a button removed from
+            the tab order at the bound drops focus to the body (WCAG 2.4.3).
+            The click guard makes activation at the bound an inert no-op. */}
+        <Button
+          variant="ghost"
+          aria-label="Previous page"
+          aria-disabled={effectivePage <= 1}
+          onClick={() => {
+            if (effectivePage <= 1) return;
+            onPageChange(effectivePage - 1);
+          }}
+        >
+          Prev
+        </Button>
+        <Button
+          variant="ghost"
+          aria-label="Next page"
+          aria-disabled={effectivePage >= pageCount}
+          onClick={() => {
+            if (effectivePage >= pageCount) return;
+            onPageChange(effectivePage + 1);
+          }}
+        >
+          Next
+        </Button>
+        <span className="tai-muted">{`Page ${String(effectivePage)} of ${String(pageCount)}`}</span>
+      </div>
+    </nav>
+  );
+}
+
+export interface ExplorerBodyProps<T> {
+  readonly hasEntries: boolean;
+  /** Items in the current folder before filtering, so the empty ladder can tell
+   *  "filter emptied it" (>0 → no-match) from "genuinely empty". */
+  readonly inFolderCount: number;
+  readonly emptyStates: ExplorerEmptyStates;
+  readonly viewMode: ViewMode;
+  readonly label: string;
+  readonly columns: readonly ExplorerColumn[];
+  readonly pageEntries: readonly ExplorerEntry<T>[];
+  readonly getItemKey: (item: T) => string;
+  readonly renderRow: (item: T) => ReactNode;
+  readonly renderCard: (item: T) => ReactNode;
+  readonly openProps: (item: T) => OpenTargetProps;
+  readonly onNavigate: (folderId: string | null) => void;
+  readonly renderFolderActions: ((folder: Folder) => ReactNode) | undefined;
+  readonly pager: ExplorerPagerProps;
+}
+
+/** A card entry (folder card or item card) for the grid view. */
+function CardEntry<T>(
+  props: ExplorerBodyProps<T> & { readonly entry: ExplorerEntry<T> },
+): ReactNode {
+  const { entry, onNavigate, renderFolderActions, getItemKey, renderCard, openProps } = props;
+  if (entry.kind === 'folder') {
+    return (
+      <div role="listitem" key={`folder:${entry.folder.id}`}>
+        <Card interactive>
+          <FolderEntry
+            folder={entry.folder}
+            onNavigate={onNavigate}
+            renderFolderActions={renderFolderActions}
+          />
+        </Card>
+      </div>
+    );
+  }
+  return (
+    <div role="listitem" key={`item:${getItemKey(entry.item)}`} {...openProps(entry.item)}>
+      {renderCard(entry.item)}
+    </div>
+  );
+}
+
+/** A table row (folder row spanning all columns, or item row) for the list view. */
+function RowEntry<T>(
+  props: ExplorerBodyProps<T> & { readonly entry: ExplorerEntry<T> },
+): ReactNode {
+  const { entry, columns, onNavigate, renderFolderActions, getItemKey, renderRow, openProps } =
+    props;
+  if (entry.kind === 'folder') {
+    return (
+      <TR key={`folder:${entry.folder.id}`}>
+        <TD colSpan={columns.length}>
+          <FolderEntry
+            folder={entry.folder}
+            onNavigate={onNavigate}
+            renderFolderActions={renderFolderActions}
+          />
+        </TD>
+      </TR>
+    );
+  }
+  return (
+    <TR key={`item:${getItemKey(entry.item)}`} {...openProps(entry.item)}>
+      {renderRow(entry.item)}
+    </TR>
+  );
+}
+
+export function ExplorerBody<T>(props: ExplorerBodyProps<T>): ReactNode {
+  const { hasEntries, inFolderCount, emptyStates, viewMode, label, columns, pageEntries, pager } =
+    props;
+
+  if (!hasEntries) {
+    // The current folder renders nothing. A filter emptied it (`inFolderCount` > 0)
+    // → "no match"; otherwise the folder is genuinely empty. The ladder decides on
+    // the full, unsliced sets, never on a page.
+    return <EmptyState {...(inFolderCount > 0 ? emptyStates.noMatch : emptyStates.emptyFolder)} />;
+  }
+
+  if (viewMode === 'cards') {
+    return (
+      <>
+        <EntityCardGrid aria-label={label}>
+          {pageEntries.map((entry) => (
+            <CardEntry key={entryKey(entry, props.getItemKey)} {...props} entry={entry} />
+          ))}
+        </EntityCardGrid>
+        <ExplorerPager {...pager} />
+      </>
+    );
+  }
+
+  // Folder rows share the item table, spanning every column, sorted above items —
+  // so a folder-with-only-subfolders is folder ROWS, never a header-only table.
+  // A too-wide table scrolls inside its own box rather than widening the page.
+  return (
+    <>
+      <ScrollRegion label={label}>
+        <Table>
+          <THead>
+            <TR>
+              {columns.map((column) => (
+                <TH key={column.key} numeric={column.numeric}>
+                  {column.header}
+                </TH>
+              ))}
+            </TR>
+          </THead>
+          <TBody>
+            {pageEntries.map((entry) => (
+              <RowEntry key={entryKey(entry, props.getItemKey)} {...props} entry={entry} />
+            ))}
+          </TBody>
+        </Table>
+      </ScrollRegion>
+      <ExplorerPager {...pager} />
+    </>
+  );
+}
+
+/** The stable React key for a page entry, folder or item. */
+function entryKey<T>(entry: ExplorerEntry<T>, getItemKey: (item: T) => string): string {
+  return entry.kind === 'folder' ? `folder:${entry.folder.id}` : `item:${getItemKey(entry.item)}`;
+}

package/src/components/explorer-page-size.ts

@@ -0,0 +1,39 @@
+/**
+ * The explorer's persisted page size, per view surface. Mirrors `useViewMode`: an
+ * invalid or absent stored value degrades to the default, and a storage failure
+ * degrades to in-memory only — never a thrown boot.
+ */
+import { useCallback, useState } from 'react';
+
+/** The page-size choices, and the default. */
+export const PAGE_SIZES = [12, 24, 48, 96] as const;
+const DEFAULT_PAGE_SIZE = 24;
+
+const PAGE_SIZE_STORAGE_PREFIX = 'tai-studio.page-size.';
+
+function readStoredPageSize(surface: string): number {
+  try {
+    const raw = globalThis.localStorage.getItem(PAGE_SIZE_STORAGE_PREFIX + surface);
+    const parsed = raw === null ? Number.NaN : Number(raw);
+    if ((PAGE_SIZES as readonly number[]).includes(parsed)) return parsed;
+  } catch {
+    // No storage (private mode / non-browser) — fall back to the default.
+  }
+  return DEFAULT_PAGE_SIZE;
+}
+
+export function usePageSize(surface: string): readonly [number, (size: number) => void] {
+  const [size, setSizeState] = useState<number>(() => readStoredPageSize(surface));
+  const setSize = useCallback(
+    (next: number) => {
+      setSizeState(next);
+      try {
+        globalThis.localStorage.setItem(PAGE_SIZE_STORAGE_PREFIX + surface, String(next));
+      } catch {
+        // Storage unavailable — the choice still applies for this session.
+      }
+    },
+    [surface],
+  );
+  return [size, setSize];
+}

package/src/components/explorer-tag-filter.tsx

@@ -0,0 +1,80 @@
+/**
+ * The explorer's tag filter row: a togglable chip per vocabulary entry, with the
+ * unselected chips beyond the cap collapsed into a static "+N more" count.
+ */
+import type { ReactNode } from 'react';
+
+import type { TagVocabularyEntry } from './explorer-tags';
+
+/** A togglable tag chip; `aria-pressed` reflects whether the tag filters the list. */
+function TagChip({
+  entry,
+  active,
+  onToggle,
+}: {
+  readonly entry: TagVocabularyEntry;
+  readonly active: boolean;
+  readonly onToggle: () => void;
+}): ReactNode {
+  return (
+    <button
+      type="button"
+      className="tai-chip"
+      aria-pressed={active}
+      aria-label={`${entry.label} (${String(entry.count)})`}
+      onClick={onToggle}
+    >
+      <span>{entry.label}</span>
+      <span>{entry.count}</span>
+    </button>
+  );
+}
+
+/** The filter row: every selected chip plus as many unselected chips as fit under
+ *  the cap, with the remainder collapsed into a STATIC "+N more" count. An unset
+ *  cap shows every chip. */
+export function TagFilterRow({
+  vocabulary,
+  selectedSet,
+  onToggle,
+  filterLabel,
+  maxVisibleTags,
+}: {
+  readonly vocabulary: readonly TagVocabularyEntry[];
+  readonly selectedSet: ReadonlySet<string>;
+  readonly onToggle: (token: string) => void;
+  readonly filterLabel: string;
+  readonly maxVisibleTags: number | undefined;
+}): ReactNode {
+  const visible: TagVocabularyEntry[] = [];
+  let hidden = 0;
+  let unselectedShown = 0;
+  for (const entry of vocabulary) {
+    if (selectedSet.has(entry.token)) {
+      visible.push(entry);
+    } else if (maxVisibleTags === undefined || unselectedShown < maxVisibleTags) {
+      visible.push(entry);
+      unselectedShown += 1;
+    } else {
+      hidden += 1;
+    }
+  }
+
+  return (
+    <div role="group" aria-label={filterLabel} className="tai-row">
+      {visible.map((entry) => (
+        <TagChip
+          key={entry.token}
+          entry={entry}
+          active={selectedSet.has(entry.token)}
+          onToggle={() => {
+            onToggle(entry.token);
+          }}
+        />
+      ))}
+      {hidden > 0 ? (
+        <span className="tai-chip tai-chip-static">{`+${String(hidden)} more`}</span>
+      ) : null}
+    </div>
+  );
+}

package/src/components/explorer-tags.ts

@@ -0,0 +1,64 @@
+/**
+ * The tag glue every explorer screen shares: the untagged sentinel, the tag
+ * vocabulary builder, and the OR-match rule — one vocabulary/untagged/OR
+ * definition rather than a copy per screen.
+ */
+
+/** Reserved filter token for items carrying NO tag; namespaced so it never
+ *  collides with a real tag. */
+export const UNTAGGED_TOKEN = '__untagged__';
+
+export interface TagVocabularyEntry {
+  readonly token: string;
+  readonly label: string;
+  readonly count: number;
+}
+
+/** The tag vocabulary over `items`, name-sorted, plus an untagged pseudo-tag
+ *  (labelled `untaggedLabel`) when any item is untagged; a selected token whose
+ *  items vanished still appears (count 0) so it can be cleared. */
+export function buildTagVocabulary<T>(
+  items: readonly T[],
+  getTags: (item: T) => readonly string[],
+  selectedTags: readonly string[],
+  untaggedLabel: string,
+): TagVocabularyEntry[] {
+  const counts = new Map<string, number>();
+  let untagged = 0;
+  for (const item of items) {
+    const tags = getTags(item);
+    if (tags.length === 0) {
+      untagged += 1;
+      continue;
+    }
+    for (const tag of tags) counts.set(tag, (counts.get(tag) ?? 0) + 1);
+  }
+  const vocabulary: TagVocabularyEntry[] = [...counts.entries()]
+    .sort(([a], [b]) => a.localeCompare(b))
+    .map(([label, count]) => ({ token: label, label, count }));
+  if (untagged > 0) {
+    vocabulary.push({ token: UNTAGGED_TOKEN, label: untaggedLabel, count: untagged });
+  }
+  for (const token of selectedTags) {
+    if (!vocabulary.some((entry) => entry.token === token)) {
+      vocabulary.push({
+        token,
+        label: token === UNTAGGED_TOKEN ? untaggedLabel : token,
+        count: 0,
+      });
+    }
+  }
+  return vocabulary;
+}
+
+/** OR semantics: an empty selection matches everything; otherwise an item
+ *  matches when it carries any selected tag, or is untagged and UNTAGGED_TOKEN
+ *  is selected. */
+export function matchesSelectedTags(
+  itemTags: readonly string[],
+  selected: ReadonlySet<string>,
+): boolean {
+  if (selected.size === 0) return true;
+  if (itemTags.length === 0) return selected.has(UNTAGGED_TOKEN);
+  return itemTags.some((tag) => selected.has(tag));
+}