@cadraos/sdk 0.3.14-p46.4 → 0.3.15

package/README.md

@@ -2,36 +2,19 @@
 
 Official SDK for the CadraOS platform - programmatic access to agents, skills, tools, and artifacts.
 
-> **Note**: For React chat components, use the new [@cadraos/react](https://www.npmjs.com/package/@cadraos/react) package.
-> The `@cadraos/sdk/chat` subpath is deprecated.
-
-## Deprecation Notice
-
-The `@cadraos/sdk/chat` subpath is **deprecated** and will be removed in a future version.
-
-**If you're using React chat components**, please migrate to `@cadraos/react`:
-
-```tsx
-// Before (deprecated)
-import { AgentChat, ChatConfigProvider } from '@cadraos/sdk/chat';
-import '@cadraos/sdk/chat/styles.css';
-
-// After (recommended)
-import '@cadraos/react/styles.css';
-import { CadraCopilot } from '@cadraos/react';
-
-function App() {
-  return (
-    <CadraCopilot
-      apiKey="cdr_live_xxx"
-      orgId={123}
-      agentId="agent-uuid"
-    />
-  );
-}
-```
-
-For full migration instructions, see the [migration guide](https://github.com/cadraos/cadra-sdk/blob/main/packages/react/MIGRATION.md).
+## Entry Points
+
+| Import path | Contents |
+|---|---|
+| `@cadraos/sdk` | `CadraClient`, resource APIs, types, error classes, image-stream helpers |
+| `@cadraos/sdk/chat` | React chat components and hooks (`AgentChat`, `ChatConfigProvider`, adapters) — the canonical chat surface |
+| `@cadraos/sdk/teams` | React components for visualizing agent team structures |
+| `@cadraos/sdk/kanban` | Agent-first kanban: React board + data adapter |
+| `@cadraos/sdk/kanban/engine` | Server-side board engine (host backend only, never the browser) |
+| `@cadraos/sdk/board-host` | Board-host mapping types + `<BoardHostMapping/>` editor widget (see [Board Host](#board-host-run-a-cadra-agentic-board-over-your-own-tables)) |
+| `@cadraos/sdk/board-host/server` | Server board-host kit (read compiler) + `runBoardHostConformance` |
+| `@cadraos/sdk/ai-functions/server` | Server-only handlers for host-app AI-function slots |
+| `@cadraos/sdk/ai-functions/react` | `<AiFunctionSlotsPanel/>` client component (React is an optional peer dep) |
 
 ## Installation
 
@@ -50,7 +33,7 @@ import { CadraClient } from '@cadraos/sdk';
 
 // Initialize the client
 const client = new CadraClient({
-  apiKey: process.env.CADRA_API_KEY!,  // e.g., cdr_live_xxx
+  apiKey: process.env.CADRA_API_KEY!,  // <api-key>
   orgId: Number(process.env.CADRA_ORG_ID),
 });
 
@@ -65,7 +48,7 @@ const execution = await client.agents.executeSync(agents[0].uuid, {
 console.log('Result:', execution.output);
 ```
 
-> **Note**: `AISaaSClient` is deprecated but still works as an alias for `CadraClient`.
+> **Note**: `AISaaSClient` / `AISaaSError` are deprecated aliases for `CadraClient` / `CadraError`.
 
 ## Authentication
 
@@ -74,8 +57,8 @@ The SDK supports three authentication methods:
 ### API Key (recommended for server-side)
 
 ```typescript
-const client = new AISaaSClient({
-  apiKey: 'sk_...',
+const client = new CadraClient({
+  apiKey: '<api-key>',
   orgId: 123,
 });
 ```
@@ -83,8 +66,8 @@ const client = new AISaaSClient({
 ### OAuth Token
 
 ```typescript
-const client = new AISaaSClient({
-  token: 'eyJ...',
+const client = new CadraClient({
+  token: '<oauth-token>',
   orgId: 123,
 });
 ```
@@ -92,7 +75,7 @@ const client = new AISaaSClient({
 ### Token Provider (for automatic refresh)
 
 ```typescript
-const client = new AISaaSClient({
+const client = new CadraClient({
   tokenProvider: async () => myAuth.getAccessToken(),
   orgId: 123,
 });
@@ -132,6 +115,8 @@ stream.on('log', (log) => console.log(log.title));
 stream.on('toolCall', ({ toolName }) => console.log(`Calling: ${toolName}`));
 stream.on('complete', ({ execution }) => console.log(execution.output));
 
+// agents.stream() does NOT connect — register handlers first, then connect once
+await stream.connect();
 const result = await stream.wait();
 
 // Get execution result
@@ -143,6 +128,14 @@ const updated = await client.agents.update('agent-uuid', {
   description: 'New description',
 });
 
+// Update agent config
+await client.agents.updateConfig('agent-uuid', { /* AgentConfigUpdateInput */ });
+
+// Attach to an existing execution (register handlers, then connect once)
+const live = client.agents.streamExecution('execution-uuid');
+live.on('complete', ({ execution }) => console.log(execution.output));
+await live.connect();
+
 // Cancel execution
 await client.agents.cancelExecution('execution-uuid');
 ```
@@ -280,7 +273,7 @@ const execution = await client.sessions.sendMessageSync('session-id', {
   message: 'Tell me more about that',
 });
 
-// Stream message
+// Stream message (sessions.stream() connects for you)
 const stream = await client.sessions.stream('session-id', {
   message: 'Explain in detail',
 });
@@ -296,6 +289,66 @@ history.messages.forEach(msg => {
 await client.sessions.delete('session-id');
 ```
 
+### Attachments
+
+```typescript
+// 1. Get a presigned upload URL
+const { attachmentUuid, uploadUrl } = await client.attachments.getUploadUrl({
+  filename: 'photo.png',
+  mimeType: 'image/png',
+  size: file.size,
+});
+// 2. PUT the bytes to uploadUrl, then confirm
+await client.attachments.confirm(attachmentUuid);
+// 3. Reference it in an execution
+await client.agents.execute('agent-uuid', { task: 'Describe this', attachmentIds: [attachmentUuid] });
+
+// Download URL
+const url = await client.attachments.getDownloadUrl(attachmentUuid);
+```
+
+### Teams
+
+```typescript
+const { data: teams } = await client.teams.list({ isActive: true });
+const team = await client.teams.get('team-uuid'); // includeMembers defaults to true
+```
+
+### Kanban
+
+`client.kanban` drives an agentic board: `getBoard()`, `listCards()`, `createCard()`,
+`getCard()`, `updateCard()`, `transitionCard({ cardId, ... })`, `getCardRun(executionId)`,
+and `streamCardRun(executionId)` (attach `.on(...)` handlers, then call `.connect()` once).
+See the [Kanban HTTP adapter guide](./docs/guides/kanban-http-adapter.md).
+
+### Remote Agents & Runners
+
+`client.remoteAgents`: `list()`, `get()`, `create()`, `update()`, `delete()`, `deploy()`,
+`execute()`, `stream()`. `client.remoteRunners`: `list()`.
+
+### AI Functions
+
+```typescript
+// orgId must be set on the client config — never in run() options
+const fns = await client.aiFunctions.list();
+const descriptor = await client.aiFunctions.get('function_key');
+
+// Shorthand: run(functionKey, parameters, opts?)
+const result = await client.aiFunctions.run('function_key', { topic: 'AI' });
+console.log(result.output, result.usage);
+
+// Object form: run(ref, { variables, version?, idempotencyKey?, params?, validate? })
+await client.aiFunctions.run({ functionKey: 'function_key' }, { variables: { topic: 'AI' } });
+
+// Read a run back
+const run = await client.aiFunctions.getRun(result.executionId);
+```
+
+Paid runs are never auto-retried (an idempotency key is generated when omitted).
+Errors: `AiFunctionParameterError` (client-side check failed, nothing sent),
+`AiFunctionDuplicateError` (409), `AiFunctionChargedError` (metered but output failed).
+See the [AI Functions reference](./docs/api-reference/ai-functions.md).
+
 ## Streaming
 
 The SDK supports real-time streaming for agent executions:
@@ -333,6 +386,9 @@ stream.on('connectionChange', ({ connected, usingFallback }) => {
   }
 });
 
+// Connect AFTER registering handlers (agents.stream() does not auto-connect)
+await stream.connect();
+
 // Wait for completion
 const execution = await stream.wait();
 
@@ -346,7 +402,7 @@ The SDK provides typed error classes for different error scenarios:
 
 ```typescript
 import {
-  AISaaSError,
+  CadraError,
   AuthenticationError,
   AuthorizationError,
   NotFoundError,
@@ -370,7 +426,7 @@ try {
     error.errors.forEach(e => {
       console.log(`${e.field}: ${e.message}`);
     });
-  } else if (error instanceof AISaaSError) {
+  } else if (error instanceof CadraError) {
     console.log(`Error [${error.code}]: ${error.message}`);
     console.log('Request ID:', error.requestId);
   }
@@ -380,18 +436,19 @@ try {
 ## Configuration Options
 
 ```typescript
-const client = new AISaaSClient({
+const client = new CadraClient({
   // Required
-  apiKey: 'sk_...',        // or token/tokenProvider
+  apiKey: '<api-key>',        // or token/tokenProvider
   orgId: 123,
 
   // Optional
-  baseUrl: 'https://api.aisaas.com/v1',  // Custom API URL
+  baseUrl: '<base-url>',                  // Origin only; SDK adds /api/v1 (default: https://api.cadraos.com)
   timeout: 30000,                         // Request timeout (ms)
   maxRetries: 3,                          // Retry attempts
   headers: {                              // Custom headers
     'X-Custom-Header': 'value',
   },
+  fetch: customFetch,                     // Optional fetch impl (e.g. expo/fetch for React Native streaming)
 });
 ```
 
@@ -413,16 +470,10 @@ import type {
 
 ## Browser Support
 
-The SDK works in modern browsers for non-streaming operations. Streaming (SSE) is only supported in Node.js in v1.
-
-```typescript
-// Works in browser
-const agents = await client.agents.list();
-const execution = await client.agents.executeSync(uuid, { task: '...' });
-
-// Node.js only (v1)
-const stream = await client.agents.stream(uuid, { task: '...' });
-```
+The SDK works in Node.js >= 18 and modern browsers, including streaming: SSE is
+read with `fetch` + `ReadableStream` and authenticates via headers. For React
+Native streaming, pass a streaming-capable `fetch` (e.g. `expo/fetch`) in the
+client options.
 
 ## Board Host (run a Cadra agentic board over your own tables)
 

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

@@ -0,0 +1,176 @@
+'use strict';
+
+var React = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+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__namespace.useState({ status: "loading" });
+  const [pendingKey, setPendingKey] = React__namespace.useState(null);
+  const [rowErrors, setRowErrors] = React__namespace.useState({});
+  const mounted = React__namespace.useRef(true);
+  const load = React__namespace.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__namespace.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__ */ jsxRuntime.jsx("div", { className: rootClass, "aria-busy": "true", "data-state": "loading", children: L.loading });
+  }
+  if (state.status === "error") {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: rootClass, "data-state": "error", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { role: "alert", className: classNames.banner, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: state.message ? `${L.loadFailed}: ${state.message}` : L.loadFailed }),
+      " ",
+      /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("div", { className: rootClass, "data-state": "empty", children: L.empty });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: rootClass, "data-state": "ready", children: /* @__PURE__ */ jsxRuntime.jsxs("table", { className: classNames.table, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { className: classNames.headerRow, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("th", { scope: "col", className: classNames.headerCell, children: L.slot }),
+      /* @__PURE__ */ jsxRuntime.jsx("th", { scope: "col", className: classNames.headerCell, children: L.usedFor }),
+      /* @__PURE__ */ jsxRuntime.jsx("th", { scope: "col", className: classNames.headerCell, children: L.boundTo }),
+      /* @__PURE__ */ jsxRuntime.jsx("th", { scope: "col", className: classNames.headerCell, children: L.actions })
+    ] }) }),
+    /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsxs("tr", { className: classNames.row, "data-slot": row.key, children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("td", { className: classNames.cell, children: [
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: classNames.slotLabel, children: row.label }),
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: classNames.slotKey, children: row.key })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { className: classNames.cell, children: row.usedFor ?? "" }),
+        /* @__PURE__ */ jsxRuntime.jsxs("td", { className: classNames.cell, children: [
+          /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("option", { value: "", disabled: Boolean(bound), children: L.notSet }),
+                bound && !boundIsOption ? /* @__PURE__ */ jsxRuntime.jsx("option", { value: bound, disabled: true, children: `${row.boundFunction?.title ?? bound} (${incompatible ? L.incompatible : L.unavailable})` }) : null,
+                row.options.map((o) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: o.functionKey, children: `${o.title} \xB7 ${L.version(o.liveVersion)}` }, o.functionKey))
+              ]
+            }
+          ),
+          row.boundFunction ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: classNames.meta, children: `${row.boundFunction.functionKey} \xB7 ${L.version(row.boundFunction.liveVersion)}` }) : null,
+          incompatible ? /* @__PURE__ */ jsxRuntime.jsx("ul", { role: "alert", className: classNames.issues, "aria-label": L.incompatible, children: row.compat.issues.map((issue, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: issue.message }, i)) }) : null,
+          rowErrors[row.key] ? /* @__PURE__ */ jsxRuntime.jsx("div", { role: "alert", className: classNames.rowError, children: rowErrors[row.key] }) : null
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { className: classNames.cell, children: /* @__PURE__ */ jsxRuntime.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);
+    }) })
+  ] }) });
+}
+
+exports.AiFunctionSlotsPanel = AiFunctionSlotsPanel;
+exports.DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS = DEFAULT_AI_FUNCTION_SLOTS_PANEL_LABELS;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ai-functions/react/AiFunctionSlotsPanel.tsx"],"names":["React","rows","jsx","jsxs"],"mappings":"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","file":"index.cjs","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/react/index.d.cts

@@ -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 };