@tai42/studio-sdk 13.3.0 → 14.0.0

package/dist/state-binding/adapter.js

@@ -0,0 +1,251 @@
+/**
+ * The adapter compiler — a PURE function set, no React, no jq engine.
+ *
+ * A named template `update` jq declares an input object (its `params` / declared
+ * input keys). A binding must map the run's OUTPUT (and the run's INPUT) into that
+ * object; that mapping is the `adapter` — a single jq program over `{ output, input }`
+ * that CONSTRUCTS the update jq's declared input (which the update jq then reads as
+ * `.input` alongside the record).
+ *
+ * The editor authors the adapter as a ROW form: one row per declared input key,
+ * each row picking one of three value sources — a picked field (from the run's
+ * output / input schema), a hardcoded literal, or a raw jq expression. The whole
+ * form compiles here into ONE adapter jq; each row's own jq fragment is shown on demand.
+ *
+ * Compilation never throws: an invalid literal or an empty field surfaces as a
+ * loud, human error the editor renders in a `role="alert"`, never a silent empty
+ * object.
+ */
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** An object key rendered for jq: a bare identifier, or a quoted string otherwise. */
+export function jqKey(key) {
+    return IDENTIFIER.test(key) ? key : JSON.stringify(key);
+}
+/** A picked field rendered as a jq path, e.g. `.output.user.name` / `.input["odd key"]`. */
+export function fieldPathToJq(root, path) {
+    let out = `.${root}`;
+    for (const segment of path) {
+        out += IDENTIFIER.test(segment) ? `.${segment}` : `[${JSON.stringify(segment)}]`;
+    }
+    return out;
+}
+/** The jq fragment ONE row's value compiles to — the row's "show jq". */
+export function rowValueJq(source) {
+    switch (source.kind) {
+        case 'field':
+            return { ok: true, jq: fieldPathToJq(source.root, source.path) };
+        case 'literal': {
+            const text = source.json.trim();
+            if (text === '')
+                return { ok: false, error: 'Enter a value.' };
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                return { ok: false, error: 'This is not valid JSON.' };
+            }
+            // A parsed JSON value is a valid jq literal verbatim.
+            return { ok: true, jq: JSON.stringify(parsed) };
+        }
+        case 'jq': {
+            const expr = source.expr.trim();
+            if (expr === '')
+                return { ok: false, error: 'Enter a jq expression.' };
+            return { ok: true, jq: expr };
+        }
+    }
+}
+/**
+ * Compile a mapping form into ONE adapter jq that constructs the update jq's
+ * declared input over `{ output, input }`. An empty form compiles to the
+ * empty object `{}`; a blank target, a duplicate target, or an invalid source is a
+ * loud error.
+ */
+export function compileAdapter(rows) {
+    if (rows.length === 0)
+        return { ok: true, jq: '{}' };
+    const seen = new Set();
+    const parts = [];
+    for (const row of rows) {
+        const target = row.target.trim();
+        if (target === '')
+            return { ok: false, error: 'Every mapping row needs a target field.' };
+        if (seen.has(target))
+            return { ok: false, error: `The field '${target}' is mapped twice.` };
+        seen.add(target);
+        const value = rowValueJq(row.source);
+        if (!value.ok)
+            return { ok: false, error: `${target}: ${value.error}` };
+        parts.push(`${jqKey(target)}: (${value.jq})`);
+    }
+    return { ok: true, jq: `{ ${parts.join(', ')} }` };
+}
+/** One row per declared input key, each defaulting to a picked `output` field. */
+export function defaultRowsForInput(params) {
+    return params.map((target) => ({
+        target,
+        source: { kind: 'field', root: 'output', path: [] },
+    }));
+}
+// -- The round-trip: recover a mapping form from a STORED adapter jq --------------
+//
+// `compileAdapter` emits a canonical, PARSEABLE shape so a stored adapter reopens as
+// the form it was authored in (never UI-only state): the object
+// `{ <key>: (<value>), … }` where `<key>` is a bare identifier or a JSON string and
+// `<value>` is one of — a field path `.output…` / `.input…`, a JSON literal, or a raw
+// jq expression. `parseAdapter` inverts it; `parse(compileAdapter(rows).jq) === rows`
+// for every row kind whose literal is already canonical JSON. A shape it does not
+// recognise returns `null` — the editor falls back to the raw-jq escape hatch.
+const IDENTIFIER_HEAD = /^([A-Za-z_][A-Za-z0-9_]*)/;
+const BRACKET_SEGMENT = /^\[("(?:[^"\\]|\\.)*")\]/;
+const ADAPTER_KEY = /^("(?:[^"\\]|\\.)*"|[A-Za-z_][A-Za-z0-9_]*)\s*:\s*\(/;
+/** Recover a field source from a pure path expression, or `null` if it is not one. */
+export function parseFieldPath(value) {
+    const head = /^\.(output|input)/.exec(value);
+    if (head === null)
+        return null;
+    const root = head[1];
+    let rest = value.slice(head[0].length);
+    const path = [];
+    while (rest.length > 0) {
+        if (rest.startsWith('.')) {
+            const segment = IDENTIFIER_HEAD.exec(rest.slice(1));
+            if (segment?.[1] === undefined)
+                return null;
+            path.push(segment[1]);
+            rest = rest.slice(1 + segment[0].length);
+        }
+        else if (rest.startsWith('[')) {
+            const bracket = BRACKET_SEGMENT.exec(rest);
+            if (bracket?.[1] === undefined)
+                return null;
+            path.push(JSON.parse(bracket[1]));
+            rest = rest.slice(bracket[0].length);
+        }
+        else {
+            // Trailing content (e.g. ` + 1`) means this is a jq expression, not a path.
+            return null;
+        }
+    }
+    return { kind: 'field', root, path };
+}
+/** Classify one recovered value into its source (field, else JSON literal, else jq). */
+function parseValue(value) {
+    const field = parseFieldPath(value);
+    if (field !== null)
+        return field;
+    try {
+        const parsed = JSON.parse(value);
+        return { kind: 'literal', json: JSON.stringify(parsed) };
+    }
+    catch {
+        return { kind: 'jq', expr: value };
+    }
+}
+/** Find the index of the paren that closes the `(` at `open`, respecting jq strings. */
+function matchingParen(text, open) {
+    let depth = 0;
+    let inString = false;
+    for (let i = open; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (ch === '\\')
+                i += 1;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === '(')
+            depth += 1;
+        else if (ch === ')') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/** Recover the mapping rows from a stored adapter jq, or `null` if it is not the generated shape. */
+export function parseAdapter(jq) {
+    const trimmed = jq.trim();
+    if (trimmed === '{}')
+        return [];
+    if (!trimmed.startsWith('{') || !trimmed.endsWith('}'))
+        return null;
+    let inner = trimmed.slice(1, -1).trim();
+    const rows = [];
+    while (inner.length > 0) {
+        const keyMatch = ADAPTER_KEY.exec(inner);
+        if (keyMatch?.[1] === undefined)
+            return null;
+        const rawKey = keyMatch[1];
+        const target = rawKey.startsWith('"') ? JSON.parse(rawKey) : rawKey;
+        const open = keyMatch[0].length - 1;
+        const close = matchingParen(inner, open);
+        if (close === -1)
+            return null;
+        const value = inner.slice(open + 1, close).trim();
+        rows.push({ target, source: parseValue(value) });
+        inner = inner.slice(close + 1).trim();
+        if (inner.startsWith(','))
+            inner = inner.slice(1).trim();
+        else if (inner.length > 0)
+            return null;
+    }
+    return rows;
+}
+// -- The canonical single-expression form: `tjq_<callName>(<adapter object>)` --------
+//
+// When a template update rides inside ONE jq field (rather than the structured
+// `template_jq` + `adapter` pair), it is written as the call `tjq_<callName>({ … })`.
+// A jq name is `[a-z][a-z0-9_]*` (double underscores legal); a tai42 template name is a
+// SLUG (`[a-z][a-z0-9-]*` with no leading, trailing, or consecutive hyphens). So the
+// qualified call name is `enc(template) + "__" + name`, where `enc` maps each `-` to
+// `_`. BECAUSE the slug has no consecutive or trailing hyphens, `enc(template)` never
+// contains `__` and never ends in `_` — so the FIRST `__` in the call name is the
+// unambiguous template/name boundary. Resolution back to a catalog ref is therefore
+// injective, but done catalog-driven (`resolveCallName`, `catalog.ts`) rather than by
+// string splitting, since a jq name may itself contain `__` after that boundary. A jq
+// field whose expression is EXACTLY this generated call reopens as the mapping form;
+// any other expression reopens as raw jq.
+const TEMPLATE_CALL = /^tjq_([a-z][a-z0-9_]*)\(([\s\S]*)\)$/;
+/**
+ * Encode a template-name slug for a jq identifier: each `-` becomes `_`. Under the slug
+ * invariant (no consecutive or trailing hyphens) the result carries no `__` and no
+ * trailing `_`, which is what makes the first `__` in a call name the template boundary.
+ */
+export function encodeTemplateSegment(template) {
+    return template.replace(/-/g, '_');
+}
+/** The jq call-name of a catalog ref: `template.name` → `enc(template)__name`; a bare `name` unchanged. */
+function refToCallName(ref) {
+    const dot = ref.indexOf('.');
+    if (dot === -1)
+        return ref;
+    return `${encodeTemplateSegment(ref.slice(0, dot))}__${ref.slice(dot + 1)}`;
+}
+/**
+ * The single-expression form of a named template update built from a mapping form:
+ * `tjq_<enc(template)>__<name>({…})` for a qualified ref, `tjq_<name>({…})` for a bare
+ * one (see the module note on the `__` boundary invariant).
+ */
+export function generateTemplateCall(ref, rows) {
+    const compiled = compileAdapter(rows);
+    return `tjq_${refToCallName(ref)}(${compiled.ok ? compiled.jq : '{}'})`;
+}
+/**
+ * Recover `{ callName, adapter }` from a `tjq_<callName>(<adapter>)` call, or `null`
+ * otherwise. `callName` is the RAW jq identifier — NEVER split here (a jq name may carry
+ * its own `__` past the template boundary); resolve it to a catalog ref with
+ * `resolveCallName`.
+ */
+export function parseTemplateCall(expr) {
+    const match = TEMPLATE_CALL.exec(expr.trim());
+    if (match?.[1] === undefined || match[2] === undefined)
+        return null;
+    return { callName: match[1], adapter: match[2].trim() };
+}
+//# sourceMappingURL=adapter.js.map

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

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

package/dist/state-binding/build-catalog.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Map the api-client's list shapes into the editor's catalogs, so every door screen
+ * feeds `StateBindingEditor` the same way. Pure data transforms; the api-client types
+ * are imported type-only (this package keeps no runtime edge to the client).
+ */
+import type { StateListItem, StateTemplateListItem } from '@tai42/api-client';
+import type { BindingStateOption, BindingTemplateOption, SchemaFieldPath } from './types';
+/** The template catalog (with each template's template jq) from `listStateTemplates()`. */
+export declare function templatesCatalogFromList(items: readonly StateTemplateListItem[]): BindingTemplateOption[];
+/** The states catalog from `listStates()`; per-state attachments are resolved lazily elsewhere. */
+export declare function statesCatalogFromList(states: readonly StateListItem[]): BindingStateOption[];
+/**
+ * Flatten a JSON schema's `properties` into selectable field paths (top-level and
+ * every nested object level), each labelled with its dotted path — the picker source
+ * for the adapter's `output`/`input` roots. A non-object or property-less schema
+ * yields no fields (the field control then falls back to a free path input).
+ */
+export declare function fieldPathsFromSchema(schema: unknown): SchemaFieldPath[];
+//# sourceMappingURL=build-catalog.d.ts.map

package/dist/state-binding/build-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.d.ts","sourceRoot":"","sources":["../../src/state-binding/build-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EACV,kBAAkB,EAElB,qBAAqB,EACrB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,2FAA2F;AAC3F,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC,qBAAqB,EAAE,CAczB;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,kBAAkB,EAAE,CAE5F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,CAcvE"}

package/dist/state-binding/build-catalog.js

@@ -0,0 +1,43 @@
+/** The template catalog (with each template's template jq) from `listStateTemplates()`. */
+export function templatesCatalogFromList(items) {
+    return items.map((item) => {
+        const templateJq = item.template_jq === null
+            ? []
+            : Object.entries(item.template_jq).map(([name, jq]) => ({
+                name,
+                purpose: jq.purpose,
+                description: jq.description,
+                params: jq.params,
+                writes: jq.writes,
+            }));
+        return { name: item.name, description: item.description, templateJq };
+    });
+}
+/** The states catalog from `listStates()`; per-state attachments are resolved lazily elsewhere. */
+export function statesCatalogFromList(states) {
+    return states.map((state) => ({ name: state.name }));
+}
+/**
+ * Flatten a JSON schema's `properties` into selectable field paths (top-level and
+ * every nested object level), each labelled with its dotted path — the picker source
+ * for the adapter's `output`/`input` roots. A non-object or property-less schema
+ * yields no fields (the field control then falls back to a free path input).
+ */
+export function fieldPathsFromSchema(schema) {
+    const out = [];
+    const walk = (node, prefix) => {
+        if (typeof node !== 'object' || node === null)
+            return;
+        const props = node.properties;
+        if (typeof props !== 'object' || props === null)
+            return;
+        for (const [key, child] of Object.entries(props)) {
+            const path = [...prefix, key];
+            out.push({ path, label: path.join('.') });
+            walk(child, path);
+        }
+    };
+    walk(schema, []);
+    return out;
+}
+//# sourceMappingURL=build-catalog.js.map

package/dist/state-binding/build-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.js","sourceRoot":"","sources":["../../src/state-binding/build-catalog.ts"],"names":[],"mappings":"AAcA,2FAA2F;AAC3F,MAAM,UAAU,wBAAwB,CACtC,KAAuC;IAEvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,UAAU,GACd,IAAI,CAAC,WAAW,KAAK,IAAI;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,IAAI;gBACJ,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,MAAM,EAAE,EAAE,CAAC,MAAM;aAClB,CAAC,CAAC,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,MAAgC;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,MAAyB,EAAQ,EAAE;QAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QACtD,MAAM,KAAK,GAAI,IAAiC,CAAC,UAAU,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/state-binding/catalog.d.ts

@@ -0,0 +1,26 @@
+import type { BindingTemplateJqOption, BindingTemplateOption } from './types';
+/** One template jq of an attached template, resolved to the reference a binding stores. */
+export interface ResolvedTemplateJq extends BindingTemplateJqOption {
+    /** The owning template. */
+    readonly template: string;
+    /** The reference a binding writes: `name`, or `template.name` when ambiguous. */
+    readonly ref: string;
+}
+/**
+ * Every template jq the given attached templates offer for a purpose (or all
+ * purposes when `purpose` is omitted), each carrying the reference a binding stores.
+ */
+export declare function resolveTemplateJq(templateNames: readonly string[], catalog: readonly BindingTemplateOption[], purpose?: 'input' | 'update'): ResolvedTemplateJq[];
+/** Find one resolved template jq by the reference a binding stores. */
+export declare function findByRef(ref: string, resolved: readonly ResolvedTemplateJq[]): ResolvedTemplateJq | undefined;
+/**
+ * Resolve a jq call name (`enc(template)__name`, or a bare `name`) back to the catalog
+ * ref, driven by the catalog — never by string splitting, since a jq name may carry its
+ * own `__` past the template boundary and `enc` maps `-`→`_`. Under the template-slug
+ * invariant (no consecutive/trailing hyphens ⇒ `enc(template)` has no `__` and no
+ * trailing `_`) the FIRST `__` is the one true boundary, so the longest encoded-template
+ * prefix whose remainder is a jq the template declares is the unique qualified match;
+ * failing that, a bare name a single template declares. `null` when nothing claims it.
+ */
+export declare function resolveCallName(callName: string, catalog: readonly BindingTemplateOption[]): string | null;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/state-binding/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/state-binding/catalog.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE9E,2FAA2F;AAC3F,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAC3B,kBAAkB,EAAE,CAsBtB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GACtC,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,GAAG,IAAI,CAiBf"}

package/dist/state-binding/catalog.js

@@ -0,0 +1,71 @@
+/**
+ * Pure catalog helpers — resolve the template jq an attached state offers, with the
+ * name-collision rule shared by every layer: an unqualified name that TWO attached
+ * templates declare is ambiguous, so both are offered attachment-qualified as
+ * `template.name`; a name only one template declares stays bare.
+ */
+import { encodeTemplateSegment } from './adapter';
+/**
+ * Every template jq the given attached templates offer for a purpose (or all
+ * purposes when `purpose` is omitted), each carrying the reference a binding stores.
+ */
+export function resolveTemplateJq(templateNames, catalog, purpose) {
+    const chosen = catalog.filter((template) => templateNames.includes(template.name));
+    const counts = new Map();
+    for (const template of chosen) {
+        for (const jq of template.templateJq) {
+            if (purpose !== undefined && jq.purpose !== purpose)
+                continue;
+            counts.set(jq.name, (counts.get(jq.name) ?? 0) + 1);
+        }
+    }
+    const resolved = [];
+    for (const template of chosen) {
+        for (const jq of template.templateJq) {
+            if (purpose !== undefined && jq.purpose !== purpose)
+                continue;
+            const ambiguous = (counts.get(jq.name) ?? 0) > 1;
+            resolved.push({
+                ...jq,
+                template: template.name,
+                ref: ambiguous ? `${template.name}.${jq.name}` : jq.name,
+            });
+        }
+    }
+    return resolved;
+}
+/** Find one resolved template jq by the reference a binding stores. */
+export function findByRef(ref, resolved) {
+    return resolved.find((entry) => entry.ref === ref);
+}
+/**
+ * Resolve a jq call name (`enc(template)__name`, or a bare `name`) back to the catalog
+ * ref, driven by the catalog — never by string splitting, since a jq name may carry its
+ * own `__` past the template boundary and `enc` maps `-`→`_`. Under the template-slug
+ * invariant (no consecutive/trailing hyphens ⇒ `enc(template)` has no `__` and no
+ * trailing `_`) the FIRST `__` is the one true boundary, so the longest encoded-template
+ * prefix whose remainder is a jq the template declares is the unique qualified match;
+ * failing that, a bare name a single template declares. `null` when nothing claims it.
+ */
+export function resolveCallName(callName, catalog) {
+    let bestRef = null;
+    let bestPrefixLength = -1;
+    for (const template of catalog) {
+        const prefix = `${encodeTemplateSegment(template.name)}__`;
+        if (!callName.startsWith(prefix))
+            continue;
+        const jqName = callName.slice(prefix.length);
+        if (template.templateJq.some((jq) => jq.name === jqName) && prefix.length > bestPrefixLength) {
+            bestRef = `${template.name}.${jqName}`;
+            bestPrefixLength = prefix.length;
+        }
+    }
+    if (bestRef !== null)
+        return bestRef;
+    for (const template of catalog) {
+        if (template.templateJq.some((jq) => jq.name === callName))
+            return callName;
+    }
+    return null;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/state-binding/catalog.js.map

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

package/dist/state-binding/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The shared state-binding editor — the ONE binding shape every door and every flow
+ * node authors. Consumed by the platform door screens, the tai42 states surface, and
+ * (in the flow engine) the node State tab. Holds no edge to jq; paints from SDK
+ * tokens only.
+ */
+export { StateBindingEditor } from './StateBindingEditor';
+export type { StateBindingEditorProps } from './StateBindingEditor';
+export { StateBindingSection } from './StateBindingSection';
+export type { StateBindingSectionProps } from './StateBindingSection';
+export { StateAttachRow } from './StateAttachRow';
+export type { StateAttachRowProps, InheritedSubject } from './StateAttachRow';
+export { InjectionList } from './InputInjectionRow';
+export type { InjectionListProps } from './InputInjectionRow';
+export { UpdateList } from './UpdateRow';
+export type { UpdateListProps } from './UpdateRow';
+export { AdapterMapping } from './AdapterMapping';
+export type { AdapterMappingProps } from './AdapterMapping';
+export { SubjectScopeFields } from './SubjectScopeFields';
+export type { SubjectScopeFieldsProps } from './SubjectScopeFields';
+export { BindingJqField, appendTjq } from './BindingJqField';
+export type { BindingJqFieldProps, TemplateJqSuggestion } from './BindingJqField';
+export { resolveTemplateJq, findByRef, resolveCallName } from './catalog';
+export type { ResolvedTemplateJq } from './catalog';
+export { templatesCatalogFromList, statesCatalogFromList, fieldPathsFromSchema, } from './build-catalog';
+export { compileAdapter, rowValueJq, fieldPathToJq, jqKey, defaultRowsForInput, parseAdapter, parseFieldPath, generateTemplateCall, parseTemplateCall, encodeTemplateSegment, } from './adapter';
+export type { MappingRow, MappingSource, FieldSource, LiteralSource, JqSource, FieldRoot, AdapterCompileResult, } from './adapter';
+export type { BindingStateOption, BindingTemplateOption, BindingTemplateJqOption, BindingSourceSchemas, SchemaFieldPath, StateBinding, StateAttach, StateInjection, StateUpdate, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/state-binding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state-binding/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/state-binding/index.js

@@ -0,0 +1,18 @@
+/**
+ * The shared state-binding editor — the ONE binding shape every door and every flow
+ * node authors. Consumed by the platform door screens, the tai42 states surface, and
+ * (in the flow engine) the node State tab. Holds no edge to jq; paints from SDK
+ * tokens only.
+ */
+export { StateBindingEditor } from './StateBindingEditor';
+export { StateBindingSection } from './StateBindingSection';
+export { StateAttachRow } from './StateAttachRow';
+export { InjectionList } from './InputInjectionRow';
+export { UpdateList } from './UpdateRow';
+export { AdapterMapping } from './AdapterMapping';
+export { SubjectScopeFields } from './SubjectScopeFields';
+export { BindingJqField, appendTjq } from './BindingJqField';
+export { resolveTemplateJq, findByRef, resolveCallName } from './catalog';
+export { templatesCatalogFromList, statesCatalogFromList, fieldPathsFromSchema, } from './build-catalog';
+export { compileAdapter, rowValueJq, fieldPathToJq, jqKey, defaultRowsForInput, parseAdapter, parseFieldPath, generateTemplateCall, parseTemplateCall, encodeTemplateSegment, } from './adapter';
+//# sourceMappingURL=index.js.map

package/dist/state-binding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state-binding/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/state-binding/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The catalog + value types the state-binding editor is fed and edits.
+ *
+ * The VALUE is the `StateBinding` document (mirrored in `@tai42/api-client`,
+ * imported type-only so this package keeps no runtime edge to the client). The
+ * CATALOGS are what the consumer resolves from the api-client and hands the editor:
+ * the states it may bind, the templates each may attach, and — when a schema is
+ * known — the fields a picker offers.
+ */
+import type { StateBinding, StateAttach, StateInjection, StateUpdate } from '@tai42/api-client';
+export type { StateBinding, StateAttach, StateInjection, StateUpdate };
+/** One selectable field of a schema: the record path + a human label. */
+export interface SchemaFieldPath {
+    readonly path: readonly string[];
+    readonly label: string;
+}
+/** One template jq of an attached template, as the pickers present it. */
+export interface BindingTemplateJqOption {
+    readonly name: string;
+    readonly purpose: 'input' | 'update';
+    readonly description?: string;
+    /** An `input` jq's declared params / an `update` jq's declared input keys. */
+    readonly params?: readonly string[];
+    /** An `update` jq's declared write paths, each a list of key segments. */
+    readonly writes?: readonly (readonly string[])[];
+}
+/** One template the editor may attach to a state (attach-on-use), with its template jq. */
+export interface BindingTemplateOption {
+    readonly name: string;
+    readonly description?: string;
+    /** Whether this template is already attached to the chosen state (else: attach on save). */
+    readonly attached?: boolean;
+    readonly templateJq: readonly BindingTemplateJqOption[];
+}
+/** One state the editor may bind, with the templates already attached to it and its fields. */
+export interface BindingStateOption {
+    readonly name: string;
+    /** Templates already attached to the state (the rest attach on save). */
+    readonly attachedTemplates?: readonly string[];
+    /** The state's own record fields, for the `state` source of a field picker. */
+    readonly fields?: readonly SchemaFieldPath[];
+}
+/**
+ * The schemas a field picker draws from when authoring an injection or an adapter:
+ * the run's `output` and `input` fields (the state's fields ride each
+ * {@link BindingStateOption}). Absent roots offer no picked field — the author uses
+ * a literal or a jq expression instead.
+ */
+export interface BindingSourceSchemas {
+    readonly output?: readonly SchemaFieldPath[];
+    readonly input?: readonly SchemaFieldPath[];
+    /** The tool-schema fetch that feeds the pickers is in flight. */
+    readonly loading?: boolean;
+    /** The tool-schema fetch failed — the field control shows a note but stays usable. */
+    readonly error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state-binding/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state-binding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhG,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAEvE,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAClD;AAED,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACzD;AAED,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/state-binding/types.js

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

package/dist/state-binding/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "13.3.0",
+  "version": "14.0.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -79,7 +79,7 @@
     "@testing-library/user-event": "^14.6.6",
     "@types/node": "^22.10.5",
     "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.5",
+    "@types/react-dom": "^19.2.7",
     "@vitejs/plugin-react": "^4.7.0",
     "@vitest/coverage-v8": "^5.0.0",
     "jsdom": "^30.0.1",
@@ -90,13 +90,13 @@
   "dependencies": {
     "@fontsource-variable/geist-mono": "^5.2.7",
     "@fontsource-variable/inter": "^5.2.8",
-    "@radix-ui/react-checkbox": "^1.3.6",
+    "@radix-ui/react-checkbox": "^1.3.11",
     "@radix-ui/react-dialog": "^1.1.18",
     "@radix-ui/react-radio-group": "^1.4.2",
     "@radix-ui/react-select": "^2.3.2",
-    "@radix-ui/react-tabs": "^1.1.16",
+    "@radix-ui/react-tabs": "^1.1.21",
     "@radix-ui/react-tooltip": "^1.2.11",
-    "@tai42/api-client": "13.3.0"
+    "@tai42/api-client": "14.0.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",

package/src/components/icons.tsx

@@ -360,6 +360,14 @@ export const MinusIcon: IconComponent = (props) => (
   </Icon>
 );
 
+/** Add / insert: the dash crossed by an upright, for an append or attach affordance. */
+export const PlusIcon: IconComponent = (props) => (
+  <Icon {...props}>
+    <path d="M5.5 12h13" />
+    <path d="M12 5.5v13" />
+  </Icon>
+);
+
 /** Edit: a pencil laid across the surface it writes on. */
 export const EditIcon: IconComponent = (props) => (
   <Icon {...props}>