@cadraos/sdk 0.3.14-p46.4 → 0.3.14

package/dist/ai-functions/react/index.d.ts

@@ -0,0 +1,129 @@
+import * as React from 'react';
+
+/**
+ * AI function types (p93 — specs §4 run contract, D27 discovery, §6.5 run reads).
+ *
+ * An AI function is a published prompt in the Cadra Prompts library that makes
+ * ONE direct AI-provider call (never an agent). Callers reference it by its
+ * `functionKey` (unique per org), by prompt uuid, or — for platform features —
+ * by slot key.
+ */
+/** Output kind of an AI function. */
+type AiFunctionOutputKind = 'text' | 'json' | 'image';
+/** Parameter (prompt variable) types — specs D10 + D26d. */
+type AiFunctionParameterType = 'string' | 'text' | 'number' | 'boolean' | 'enum' | 'image';
+
+/**
+ * Host-app AI function slots — shared types (p93 AIF-017, specs D28).
+ *
+ * Type-only module: imported by both `@cadraos/sdk/ai-functions/server` and
+ * `@cadraos/sdk/ai-functions/react` (the panel renders the rows the server
+ * handlers return), so it must stay free of runtime code and of React.
+ */
+
+/** One parameter a host slot passes when it calls its function. */
+interface AiFunctionSlotParameter {
+    name: string;
+    type: AiFunctionParameterType;
+    required: boolean;
+    maxLength?: number;
+    options?: string[];
+}
+/** What a slot is bound to: a function of the host's Cadra org. */
+interface AiFunctionSlotBinding {
+    functionKey: string;
+}
+/** Why a function does not fit a slot (D16 rule applied to a D27 descriptor). */
+type AiFunctionSlotCompatIssueCode = 'function_unavailable' | 'output_kind' | 'parameter_missing' | 'parameter_type' | 'parameter_required' | 'options' | 'max_length';
+interface AiFunctionSlotCompatIssue {
+    code: AiFunctionSlotCompatIssueCode;
+    /** The parameter concerned, when there is one. */
+    parameter?: string;
+    message: string;
+}
+interface AiFunctionSlotCompatVerdict {
+    compatible: boolean;
+    issues: AiFunctionSlotCompatIssue[];
+}
+/** A function offered in a slot's picker. */
+interface AiFunctionSlotOption {
+    functionKey: string;
+    title: string;
+    liveVersion: number;
+}
+/** One row of `listSlots()` — catalog + binding + live descriptor + verdict. */
+interface AiFunctionSlotRow {
+    key: string;
+    label: string;
+    usedFor: string | null;
+    outputKind: AiFunctionOutputKind;
+    parameters: AiFunctionSlotParameter[];
+    /** The stored binding, or null when the slot is unset. */
+    binding: AiFunctionSlotBinding | null;
+    /** The bound function's live descriptor summary; null when unset or unavailable. */
+    boundFunction: (AiFunctionSlotOption & {
+        outputKind: AiFunctionOutputKind;
+    }) | null;
+    /** Compatibility of the bound function; null when the slot is unset. */
+    compat: AiFunctionSlotCompatVerdict | null;
+    /** Functions compatible with this slot (the picker's choices). */
+    options: AiFunctionSlotOption[];
+}
+/** Result of a successful `setSlot`. */
+interface AiFunctionSetSlotResult {
+    key: string;
+    functionKey: string;
+    liveVersion: number;
+}
+
+/**
+ * <AiFunctionSlotsPanel/> — admin table for a host app's AI function slots
+ * (p93 AIF-017, specs D28).
+ *
+ * Table: Slot | Used for | Bound to (select of compatible functions + live
+ * version) | Reset. Zero-dependency and unstyled: every element takes a class
+ * from `classNames` so the host styles it with its own tokens. No toasts — a
+ * failed load shows an error banner (never an empty table) and a failed write
+ * shows inline on its row. All visible text can be replaced via `labels`.
+ */
+
+interface AiFunctionSlotsPanelApi {
+    listSlots(): Promise<AiFunctionSlotRow[]>;
+    setSlot(input: {
+        key: string;
+        functionKey: string;
+    }): Promise<AiFunctionSetSlotResult | unknown>;
+    resetSlot(input: {
+        key: string;
+    }): Promise<unknown>;
+}
+interface AiFunctionSlotsPanelLabels {
+    slot: string;
+    usedFor: string;
+    boundTo: string;
+    actions: string;
+    notSet: string;
+    reset: string;
+    retry: string;
+    loading: string;
+    empty: string;
+    loadFailed: string;
+    saveFailed: string;
+    incompatible: string;
+    unavailable: string;
+    version: (n: number) => string;
+}
+declare const DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS: AiFunctionSlotsPanelLabels;
+type AiFunctionSlotsPanelPart = 'root' | 'banner' | 'table' | 'headerRow' | 'headerCell' | 'row' | 'cell' | 'slotLabel' | 'slotKey' | 'select' | 'meta' | 'issues' | 'rowError' | 'button';
+interface AiFunctionSlotsPanelProps {
+    api: AiFunctionSlotsPanelApi;
+    /** Class on the root element. */
+    className?: string;
+    /** Classes per part, for host styling. */
+    classNames?: Partial<Record<AiFunctionSlotsPanelPart, string>>;
+    /** Replace any visible text. */
+    labels?: Partial<AiFunctionSlotsPanelLabels>;
+}
+declare function AiFunctionSlotsPanel(props: AiFunctionSlotsPanelProps): React.ReactElement;
+
+export { type AiFunctionSetSlotResult, type AiFunctionSlotCompatVerdict, type AiFunctionSlotOption, type AiFunctionSlotRow, AiFunctionSlotsPanel, type AiFunctionSlotsPanelApi, type AiFunctionSlotsPanelLabels, type AiFunctionSlotsPanelPart, type AiFunctionSlotsPanelProps, DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS };

package/dist/ai-functions/react/index.js

@@ -0,0 +1,153 @@
+import * as React from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+var DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS = {
+  slot: "Slot",
+  usedFor: "Used for",
+  boundTo: "Bound to",
+  actions: "Actions",
+  notSet: "Not set",
+  reset: "Reset",
+  retry: "Retry",
+  loading: "Loading\u2026",
+  empty: "No AI function slots are declared.",
+  loadFailed: "Could not load AI function slots",
+  saveFailed: "Could not save",
+  incompatible: "Incompatible",
+  unavailable: "unavailable",
+  version: (n) => `v${n}`
+};
+function messageOf(error) {
+  if (error && typeof error === "object" && typeof error.message === "string") {
+    return error.message;
+  }
+  return typeof error === "string" ? error : "";
+}
+function AiFunctionSlotsPanel(props) {
+  const { api, className, classNames = {} } = props;
+  const L = { ...DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS, ...props.labels };
+  const [state, setState] = React.useState({ status: "loading" });
+  const [pendingKey, setPendingKey] = React.useState(null);
+  const [rowErrors, setRowErrors] = React.useState({});
+  const mounted = React.useRef(true);
+  const load = React.useCallback(async () => {
+    try {
+      const rows2 = await api.listSlots();
+      if (mounted.current) setState({ status: "ready", rows: rows2 });
+    } catch (error) {
+      if (mounted.current) setState({ status: "error", message: messageOf(error) });
+    }
+  }, [api]);
+  React.useEffect(() => {
+    mounted.current = true;
+    void load();
+    return () => {
+      mounted.current = false;
+    };
+  }, [load]);
+  const mutate = async (key, action) => {
+    setPendingKey(key);
+    setRowErrors((e) => {
+      const next = { ...e };
+      delete next[key];
+      return next;
+    });
+    try {
+      await action();
+      await load();
+    } catch (error) {
+      if (mounted.current) {
+        const msg = messageOf(error);
+        setRowErrors((e) => ({ ...e, [key]: msg ? `${L.saveFailed}: ${msg}` : L.saveFailed }));
+      }
+    } finally {
+      if (mounted.current) setPendingKey(null);
+    }
+  };
+  const rootClass = [classNames.root, className].filter(Boolean).join(" ") || void 0;
+  if (state.status === "loading") {
+    return /* @__PURE__ */ jsx("div", { className: rootClass, "aria-busy": "true", "data-state": "loading", children: L.loading });
+  }
+  if (state.status === "error") {
+    return /* @__PURE__ */ jsx("div", { className: rootClass, "data-state": "error", children: /* @__PURE__ */ jsxs("div", { role: "alert", className: classNames.banner, children: [
+      /* @__PURE__ */ jsx("span", { children: state.message ? `${L.loadFailed}: ${state.message}` : L.loadFailed }),
+      " ",
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          className: classNames.button,
+          onClick: () => {
+            setState({ status: "loading" });
+            void load();
+          },
+          children: L.retry
+        }
+      )
+    ] }) });
+  }
+  const { rows } = state;
+  if (rows.length === 0) {
+    return /* @__PURE__ */ jsx("div", { className: rootClass, "data-state": "empty", children: L.empty });
+  }
+  return /* @__PURE__ */ jsx("div", { className: rootClass, "data-state": "ready", children: /* @__PURE__ */ jsxs("table", { className: classNames.table, children: [
+    /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { className: classNames.headerRow, children: [
+      /* @__PURE__ */ jsx("th", { scope: "col", className: classNames.headerCell, children: L.slot }),
+      /* @__PURE__ */ jsx("th", { scope: "col", className: classNames.headerCell, children: L.usedFor }),
+      /* @__PURE__ */ jsx("th", { scope: "col", className: classNames.headerCell, children: L.boundTo }),
+      /* @__PURE__ */ jsx("th", { scope: "col", className: classNames.headerCell, children: L.actions })
+    ] }) }),
+    /* @__PURE__ */ jsx("tbody", { children: rows.map((row) => {
+      const bound = row.binding?.functionKey ?? "";
+      const boundIsOption = row.options.some((o) => o.functionKey === bound);
+      const busy = pendingKey === row.key;
+      const incompatible = row.compat && !row.compat.compatible;
+      return /* @__PURE__ */ jsxs("tr", { className: classNames.row, "data-slot": row.key, children: [
+        /* @__PURE__ */ jsxs("td", { className: classNames.cell, children: [
+          /* @__PURE__ */ jsx("div", { className: classNames.slotLabel, children: row.label }),
+          /* @__PURE__ */ jsx("div", { className: classNames.slotKey, children: row.key })
+        ] }),
+        /* @__PURE__ */ jsx("td", { className: classNames.cell, children: row.usedFor ?? "" }),
+        /* @__PURE__ */ jsxs("td", { className: classNames.cell, children: [
+          /* @__PURE__ */ jsxs(
+            "select",
+            {
+              "aria-label": `${L.boundTo}: ${row.label}`,
+              className: classNames.select,
+              value: bound,
+              disabled: busy,
+              onChange: (e) => {
+                const functionKey = e.target.value;
+                if (functionKey && functionKey !== bound) {
+                  void mutate(row.key, () => api.setSlot({ key: row.key, functionKey }));
+                }
+              },
+              children: [
+                /* @__PURE__ */ jsx("option", { value: "", disabled: Boolean(bound), children: L.notSet }),
+                bound && !boundIsOption ? /* @__PURE__ */ jsx("option", { value: bound, disabled: true, children: `${row.boundFunction?.title ?? bound} (${incompatible ? L.incompatible : L.unavailable})` }) : null,
+                row.options.map((o) => /* @__PURE__ */ jsx("option", { value: o.functionKey, children: `${o.title} \xB7 ${L.version(o.liveVersion)}` }, o.functionKey))
+              ]
+            }
+          ),
+          row.boundFunction ? /* @__PURE__ */ jsx("div", { className: classNames.meta, children: `${row.boundFunction.functionKey} \xB7 ${L.version(row.boundFunction.liveVersion)}` }) : null,
+          incompatible ? /* @__PURE__ */ jsx("ul", { role: "alert", className: classNames.issues, "aria-label": L.incompatible, children: row.compat.issues.map((issue, i) => /* @__PURE__ */ jsx("li", { children: issue.message }, i)) }) : null,
+          rowErrors[row.key] ? /* @__PURE__ */ jsx("div", { role: "alert", className: classNames.rowError, children: rowErrors[row.key] }) : null
+        ] }),
+        /* @__PURE__ */ jsx("td", { className: classNames.cell, children: /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: classNames.button,
+            disabled: busy || !row.binding,
+            onClick: () => void mutate(row.key, () => api.resetSlot({ key: row.key })),
+            children: L.reset
+          }
+        ) })
+      ] }, row.key);
+    }) })
+  ] }) });
+}
+
+export { AiFunctionSlotsPanel, DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai-functions/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ai-functions/react/AiFunctionSlotsPanel.tsx"],"names":["rows"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * <AiFunctionSlotsPanel/> — admin table for a host app's AI function slots\n * (p93 AIF-017, specs D28).\n *\n * Table: Slot | Used for | Bound to (select of compatible functions + live\n * version) | Reset. Zero-dependency and unstyled: every element takes a class\n * from `classNames` so the host styles it with its own tokens. No toasts — a\n * failed load shows an error banner (never an empty table) and a failed write\n * shows inline on its row. All visible text can be replaced via `labels`.\n */\n\nimport * as React from 'react';\nimport type { AiFunctionSetSlotResult, AiFunctionSlotRow } from '../server/types.js';\n\nexport interface AiFunctionSlotsPanelApi {\n  listSlots(): Promise<AiFunctionSlotRow[]>;\n  setSlot(input: { key: string; functionKey: string }): Promise<AiFunctionSetSlotResult | unknown>;\n  resetSlot(input: { key: string }): Promise<unknown>;\n}\n\nexport interface AiFunctionSlotsPanelLabels {\n  slot: string;\n  usedFor: string;\n  boundTo: string;\n  actions: string;\n  notSet: string;\n  reset: string;\n  retry: string;\n  loading: string;\n  empty: string;\n  loadFailed: string;\n  saveFailed: string;\n  incompatible: string;\n  unavailable: string;\n  version: (n: number) => string;\n}\n\nexport const DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS: AiFunctionSlotsPanelLabels = {\n  slot: 'Slot',\n  usedFor: 'Used for',\n  boundTo: 'Bound to',\n  actions: 'Actions',\n  notSet: 'Not set',\n  reset: 'Reset',\n  retry: 'Retry',\n  loading: 'Loading…',\n  empty: 'No AI function slots are declared.',\n  loadFailed: 'Could not load AI function slots',\n  saveFailed: 'Could not save',\n  incompatible: 'Incompatible',\n  unavailable: 'unavailable',\n  version: (n) => `v${n}`,\n};\n\nexport type AiFunctionSlotsPanelPart =\n  | 'root'\n  | 'banner'\n  | 'table'\n  | 'headerRow'\n  | 'headerCell'\n  | 'row'\n  | 'cell'\n  | 'slotLabel'\n  | 'slotKey'\n  | 'select'\n  | 'meta'\n  | 'issues'\n  | 'rowError'\n  | 'button';\n\nexport interface AiFunctionSlotsPanelProps {\n  api: AiFunctionSlotsPanelApi;\n  /** Class on the root element. */\n  className?: string;\n  /** Classes per part, for host styling. */\n  classNames?: Partial<Record<AiFunctionSlotsPanelPart, string>>;\n  /** Replace any visible text. */\n  labels?: Partial<AiFunctionSlotsPanelLabels>;\n}\n\ntype LoadState =\n  | { status: 'loading' }\n  | { status: 'ready'; rows: AiFunctionSlotRow[] }\n  | { status: 'error'; message: string };\n\nfunction messageOf(error: unknown): string {\n  if (error && typeof error === 'object' && typeof (error as { message?: unknown }).message === 'string') {\n    return (error as { message: string }).message;\n  }\n  return typeof error === 'string' ? error : '';\n}\n\nexport function AiFunctionSlotsPanel(props: AiFunctionSlotsPanelProps): React.ReactElement {\n  const { api, className, classNames = {} } = props;\n  const L: AiFunctionSlotsPanelLabels = { ...DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS, ...props.labels };\n\n  const [state, setState] = React.useState<LoadState>({ status: 'loading' });\n  const [pendingKey, setPendingKey] = React.useState<string | null>(null);\n  const [rowErrors, setRowErrors] = React.useState<Record<string, string>>({});\n  const mounted = React.useRef(true);\n\n  const load = React.useCallback(async () => {\n    try {\n      const rows = await api.listSlots();\n      if (mounted.current) setState({ status: 'ready', rows });\n    } catch (error) {\n      if (mounted.current) setState({ status: 'error', message: messageOf(error) });\n    }\n  }, [api]);\n\n  React.useEffect(() => {\n    mounted.current = true;\n    void load();\n    return () => {\n      mounted.current = false;\n    };\n  }, [load]);\n\n  const mutate = async (key: string, action: () => Promise<unknown>) => {\n    setPendingKey(key);\n    setRowErrors((e) => {\n      const next = { ...e };\n      delete next[key];\n      return next;\n    });\n    try {\n      await action();\n      await load();\n    } catch (error) {\n      if (mounted.current) {\n        const msg = messageOf(error);\n        setRowErrors((e) => ({ ...e, [key]: msg ? `${L.saveFailed}: ${msg}` : L.saveFailed }));\n      }\n    } finally {\n      if (mounted.current) setPendingKey(null);\n    }\n  };\n\n  const rootClass = [classNames.root, className].filter(Boolean).join(' ') || undefined;\n\n  if (state.status === 'loading') {\n    return (\n      <div className={rootClass} aria-busy=\"true\" data-state=\"loading\">\n        {L.loading}\n      </div>\n    );\n  }\n\n  if (state.status === 'error') {\n    return (\n      <div className={rootClass} data-state=\"error\">\n        <div role=\"alert\" className={classNames.banner}>\n          <span>{state.message ? `${L.loadFailed}: ${state.message}` : L.loadFailed}</span>{' '}\n          <button\n            type=\"button\"\n            className={classNames.button}\n            onClick={() => {\n              setState({ status: 'loading' });\n              void load();\n            }}\n          >\n            {L.retry}\n          </button>\n        </div>\n      </div>\n    );\n  }\n\n  const { rows } = state;\n  if (rows.length === 0) {\n    return (\n      <div className={rootClass} data-state=\"empty\">\n        {L.empty}\n      </div>\n    );\n  }\n\n  return (\n    <div className={rootClass} data-state=\"ready\">\n      <table className={classNames.table}>\n        <thead>\n          <tr className={classNames.headerRow}>\n            <th scope=\"col\" className={classNames.headerCell}>{L.slot}</th>\n            <th scope=\"col\" className={classNames.headerCell}>{L.usedFor}</th>\n            <th scope=\"col\" className={classNames.headerCell}>{L.boundTo}</th>\n            <th scope=\"col\" className={classNames.headerCell}>{L.actions}</th>\n          </tr>\n        </thead>\n        <tbody>\n          {rows.map((row) => {\n            const bound = row.binding?.functionKey ?? '';\n            const boundIsOption = row.options.some((o) => o.functionKey === bound);\n            const busy = pendingKey === row.key;\n            const incompatible = row.compat && !row.compat.compatible;\n            return (\n              <tr key={row.key} className={classNames.row} data-slot={row.key}>\n                <td className={classNames.cell}>\n                  <div className={classNames.slotLabel}>{row.label}</div>\n                  <div className={classNames.slotKey}>{row.key}</div>\n                </td>\n                <td className={classNames.cell}>{row.usedFor ?? ''}</td>\n                <td className={classNames.cell}>\n                  <select\n                    aria-label={`${L.boundTo}: ${row.label}`}\n                    className={classNames.select}\n                    value={bound}\n                    disabled={busy}\n                    onChange={(e) => {\n                      const functionKey = e.target.value;\n                      if (functionKey && functionKey !== bound) {\n                        void mutate(row.key, () => api.setSlot({ key: row.key, functionKey }));\n                      }\n                    }}\n                  >\n                    <option value=\"\" disabled={Boolean(bound)}>\n                      {L.notSet}\n                    </option>\n                    {bound && !boundIsOption ? (\n                      <option value={bound} disabled>\n                        {`${row.boundFunction?.title ?? bound} (${incompatible ? L.incompatible : L.unavailable})`}\n                      </option>\n                    ) : null}\n                    {row.options.map((o) => (\n                      <option key={o.functionKey} value={o.functionKey}>\n                        {`${o.title} · ${L.version(o.liveVersion)}`}\n                      </option>\n                    ))}\n                  </select>\n                  {row.boundFunction ? (\n                    <div className={classNames.meta}>\n                      {`${row.boundFunction.functionKey} · ${L.version(row.boundFunction.liveVersion)}`}\n                    </div>\n                  ) : null}\n                  {incompatible ? (\n                    <ul role=\"alert\" className={classNames.issues} aria-label={L.incompatible}>\n                      {row.compat!.issues.map((issue, i) => (\n                        <li key={i}>{issue.message}</li>\n                      ))}\n                    </ul>\n                  ) : null}\n                  {rowErrors[row.key] ? (\n                    <div role=\"alert\" className={classNames.rowError}>\n                      {rowErrors[row.key]}\n                    </div>\n                  ) : null}\n                </td>\n                <td className={classNames.cell}>\n                  <button\n                    type=\"button\"\n                    className={classNames.button}\n                    disabled={busy || !row.binding}\n                    onClick={() => void mutate(row.key, () => api.resetSlot({ key: row.key }))}\n                  >\n                    {L.reset}\n                  </button>\n                </td>\n              </tr>\n            );\n          })}\n        </tbody>\n      </table>\n    </div>\n  );\n}\n"]}

package/dist/ai-functions/server/index.cjs

@@ -0,0 +1,296 @@
+'use strict';
+
+// src/ai-functions/server/slots.ts
+var AiFunctionSlotError = class extends Error {
+  code;
+  slotKey;
+  constructor(code, slotKey, message) {
+    super(message);
+    this.name = "AiFunctionSlotError";
+    this.code = code;
+    this.slotKey = slotKey;
+  }
+};
+var AiFunctionSlotUnsetError = class extends AiFunctionSlotError {
+  constructor(slotKey) {
+    super("slot_unset", slotKey, `AI function slot "${slotKey}" is not bound to a function.`);
+    this.name = "AiFunctionSlotUnsetError";
+  }
+};
+var AiFunctionUnknownSlotError = class extends AiFunctionSlotError {
+  constructor(slotKey) {
+    super("unknown_slot", slotKey, `Unknown AI function slot "${slotKey}".`);
+    this.name = "AiFunctionUnknownSlotError";
+  }
+};
+var AiFunctionSlotIncompatibleError = class extends AiFunctionSlotError {
+  functionKey;
+  issues;
+  constructor(slotKey, functionKey, issues) {
+    super(
+      "binding_incompatible",
+      slotKey,
+      `"${functionKey}" does not fit slot "${slotKey}": ` + issues.map((i) => i.message).join("; ")
+    );
+    this.name = "AiFunctionSlotIncompatibleError";
+    this.functionKey = functionKey;
+    this.issues = issues;
+  }
+};
+var SLOT_KEY_RE = /^[a-z][a-z0-9_]{1,63}$/;
+function defineAiFunctionSlots(slots) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const slot of slots) {
+    if (!SLOT_KEY_RE.test(slot.key)) {
+      throw new Error(`Invalid AI function slot key "${slot.key}" (use lower_snake_case, 2\u201364 chars).`);
+    }
+    if (seen.has(slot.key)) throw new Error(`Duplicate AI function slot key "${slot.key}".`);
+    seen.add(slot.key);
+    const names = /* @__PURE__ */ new Set();
+    for (const p of slot.parameters) {
+      if (!p.name || names.has(p.name)) {
+        throw new Error(`Slot "${slot.key}": parameter names must be non-empty and unique ("${p.name}").`);
+      }
+      names.add(p.name);
+      if (p.type === "enum" && (!p.options || p.options.length === 0)) {
+        throw new Error(`Slot "${slot.key}": enum parameter "${p.name}" needs options.`);
+      }
+    }
+  }
+  return Object.freeze(slots);
+}
+function parseAiFunctionSlotBinding(raw) {
+  let value = raw;
+  if (typeof value === "string") {
+    const t = value.trim();
+    if (!t.startsWith("{")) return null;
+    try {
+      value = JSON.parse(t);
+    } catch {
+      return null;
+    }
+  }
+  if (value && typeof value === "object") {
+    const fk = value.functionKey;
+    if (typeof fk === "string" && fk.trim()) return { functionKey: fk.trim() };
+  }
+  return null;
+}
+function createAiFunctionSlotResolver(options) {
+  const { store } = options;
+  const ttlMs = options.ttlMs ?? 6e4;
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      const now = Date.now();
+      const hit = cache.get(key);
+      if (hit && hit.expiresAt > now) return hit.value;
+      const value = parseAiFunctionSlotBinding(await store.get(key));
+      cache.set(key, { value, expiresAt: now + ttlMs });
+      return value;
+    },
+    async set(key, binding) {
+      await store.set(key, { functionKey: binding.functionKey });
+      cache.delete(key);
+    },
+    async delete(key) {
+      await store.delete(key);
+      cache.delete(key);
+    },
+    async list() {
+      const rows = await store.list();
+      const out = /* @__PURE__ */ new Map();
+      for (const row of rows) {
+        const b = parseAiFunctionSlotBinding(row.value);
+        if (b) out.set(row.key, b);
+      }
+      return out;
+    },
+    clearCache(key) {
+      if (key) cache.delete(key);
+      else cache.clear();
+    }
+  };
+}
+var DEFAULT_MAX_LENGTH = { string: 2e3, text: 24e3 };
+function checkAiFunctionSlotCompatibility(slot, descriptor) {
+  const issues = [];
+  if (descriptor.outputKind !== slot.outputKind) {
+    issues.push({
+      code: "output_kind",
+      message: `returns ${descriptor.outputKind}, the slot expects ${slot.outputKind}`
+    });
+  }
+  const fnParams = new Map(descriptor.parameters.map((p) => [p.name, p]));
+  const slotParams = new Map(slot.parameters.map((p) => [p.name, p]));
+  for (const sp of slot.parameters) {
+    const fp = fnParams.get(sp.name);
+    if (!fp) {
+      issues.push({ code: "parameter_missing", parameter: sp.name, message: `has no parameter '${sp.name}'` });
+      continue;
+    }
+    if (fp.type !== sp.type) {
+      issues.push({
+        code: "parameter_type",
+        parameter: sp.name,
+        message: `parameter '${sp.name}' is ${fp.type}, the slot passes ${sp.type}`
+      });
+      continue;
+    }
+    if (sp.options && sp.options.length > 0) {
+      const have = new Set(fp.options ?? []);
+      const missing = sp.options.filter((o) => !have.has(o));
+      if (missing.length > 0) {
+        issues.push({
+          code: "options",
+          parameter: sp.name,
+          message: `parameter '${sp.name}' does not accept ${missing.map((m) => `'${m}'`).join(", ")}`
+        });
+      }
+    }
+    if (typeof sp.maxLength === "number" && (sp.type === "string" || sp.type === "text")) {
+      const effective = fp.maxLength ?? DEFAULT_MAX_LENGTH[fp.type];
+      if (typeof effective === "number" && effective < sp.maxLength) {
+        issues.push({
+          code: "max_length",
+          parameter: sp.name,
+          message: `parameter '${sp.name}' allows ${effective} characters, the slot may pass ${sp.maxLength}`
+        });
+      }
+    }
+  }
+  for (const fp of descriptor.parameters) {
+    if (!fp.required) continue;
+    const sp = slotParams.get(fp.name);
+    if (!sp || !sp.required) {
+      issues.push({
+        code: "parameter_required",
+        parameter: fp.name,
+        message: sp ? `requires '${fp.name}', which the slot passes only optionally` : `requires '${fp.name}', which the slot does not pass`
+      });
+    }
+  }
+  return { compatible: issues.length === 0, issues };
+}
+function findSlot(slots, key) {
+  const slot = slots.find((s) => s.key === key);
+  if (!slot) throw new AiFunctionUnknownSlotError(key);
+  return slot;
+}
+function toOption(d) {
+  return { functionKey: d.functionKey, title: d.title, liveVersion: d.liveVersion };
+}
+function createAiFunctionSlotHandlers(deps) {
+  const { client, slots, resolver } = deps;
+  return {
+    async listSlots() {
+      const [functions, bindings] = await Promise.all([client.aiFunctions.list(), resolver.list()]);
+      const byKey = new Map(functions.map((f) => [f.functionKey, f]));
+      return slots.map((slot) => {
+        const binding = bindings.get(slot.key) ?? null;
+        const bound = binding ? byKey.get(binding.functionKey) : void 0;
+        let compat = null;
+        if (binding) {
+          compat = bound ? checkAiFunctionSlotCompatibility(slot, bound) : {
+            compatible: false,
+            issues: [
+              {
+                code: "function_unavailable",
+                message: `'${binding.functionKey}' is not published or no longer exists`
+              }
+            ]
+          };
+        }
+        return {
+          key: slot.key,
+          label: slot.label,
+          usedFor: slot.usedFor ?? null,
+          outputKind: slot.outputKind,
+          parameters: slot.parameters.map((p) => ({ ...p })),
+          binding,
+          boundFunction: bound ? { ...toOption(bound), outputKind: bound.outputKind } : null,
+          compat,
+          options: functions.filter((f) => checkAiFunctionSlotCompatibility(slot, f).compatible).map(toOption)
+        };
+      });
+    },
+    async setSlot({ key, functionKey }) {
+      const slot = findSlot(slots, key);
+      const descriptor = await client.aiFunctions.get(functionKey);
+      const verdict = checkAiFunctionSlotCompatibility(slot, descriptor);
+      if (!verdict.compatible) {
+        throw new AiFunctionSlotIncompatibleError(key, functionKey, verdict.issues);
+      }
+      await resolver.set(key, { functionKey });
+      return { key, functionKey, liveVersion: descriptor.liveVersion };
+    },
+    async resetSlot({ key }) {
+      findSlot(slots, key);
+      await resolver.delete(key);
+      return { key };
+    },
+    async listFunctions(input) {
+      const functions = await client.aiFunctions.list();
+      return input?.outputKind ? functions.filter((f) => f.outputKind === input.outputKind) : functions;
+    }
+  };
+}
+async function runSlot(deps, key, parameters, opts) {
+  findSlot(deps.slots, key);
+  const binding = await deps.resolver.get(key);
+  if (!binding) throw new AiFunctionSlotUnsetError(key);
+  return deps.client.aiFunctions.run(binding.functionKey, parameters, opts);
+}
+
+// src/ai-functions/server/classify.ts
+function numberAt(source, key) {
+  if (!source || typeof source !== "object") return void 0;
+  const raw = source[key];
+  const n = typeof raw === "string" ? Number(raw) : raw;
+  return typeof n === "number" && Number.isFinite(n) && n >= 0 ? n : void 0;
+}
+function stringAt(source, key) {
+  if (!source || typeof source !== "object") return void 0;
+  const raw = source[key];
+  return typeof raw === "string" && raw ? raw : void 0;
+}
+function classifyAiFunctionError(error) {
+  const status = numberAt(error, "status");
+  const name = stringAt(error, "name");
+  const serverCode = stringAt(error, "serverCode");
+  const message = stringAt(error, "message") ?? (typeof error === "string" ? error : "AI function call failed");
+  const details = error && typeof error === "object" ? error.details : void 0;
+  const base = {
+    ...status !== void 0 ? { status } : {},
+    ...serverCode ? { serverCode } : {},
+    message
+  };
+  if (status === 429 || name === "RateLimitError" || serverCode === "RATE_LIMITED") {
+    const retryAfterSeconds = numberAt(error, "retryAfter") ?? numberAt(details, "retryAfter") ?? numberAt(details, "retry_after");
+    return { kind: "rate_limited", ...base, ...retryAfterSeconds !== void 0 ? { retryAfterSeconds } : {} };
+  }
+  if (status === 401 || name === "AuthenticationError") return { kind: "unauthorized", ...base };
+  if (status === 403 || name === "AuthorizationError") return { kind: "forbidden", ...base };
+  if (status === 404 || name === "NotFoundError") return { kind: "not_found", ...base };
+  if (name === "TimeoutError" || name === "AbortError" || status === 408 || serverCode === "TIMEOUT") {
+    return { kind: "timeout", ...base };
+  }
+  if (name === "NetworkError" || status === 0 || status === void 0 && name === "TypeError") {
+    return { kind: "network", ...base };
+  }
+  return { kind: "upstream", ...base };
+}
+
+exports.AiFunctionSlotError = AiFunctionSlotError;
+exports.AiFunctionSlotIncompatibleError = AiFunctionSlotIncompatibleError;
+exports.AiFunctionSlotUnsetError = AiFunctionSlotUnsetError;
+exports.AiFunctionUnknownSlotError = AiFunctionUnknownSlotError;
+exports.checkAiFunctionSlotCompatibility = checkAiFunctionSlotCompatibility;
+exports.classifyAiFunctionError = classifyAiFunctionError;
+exports.createAiFunctionSlotHandlers = createAiFunctionSlotHandlers;
+exports.createAiFunctionSlotResolver = createAiFunctionSlotResolver;
+exports.defineAiFunctionSlots = defineAiFunctionSlots;
+exports.parseAiFunctionSlotBinding = parseAiFunctionSlotBinding;
+exports.runSlot = runSlot;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map