@cadraos/sdk 0.3.15 → 0.3.16-dev.1

package/dist/chat/index.cjs

@@ -1830,13 +1830,69 @@ function executionCancelPath(executionId) {
   return `${EXECUTION_PATH}/${executionId}/cancel`;
 }
 
+// src/utils/message-key.ts
+var MESSAGE_KEY_PATTERN = /^[a-z][a-z0-9_]*(\.[a-z0-9_]+)+$/;
+function isValidMessageKey(key) {
+  return MESSAGE_KEY_PATTERN.test(key);
+}
+
+// src/resources/agent-messages.ts
+var AgentMessagesAPI = class extends BaseResourceAPI {
+  constructor(http) {
+    super(http, "/api/v1/agents");
+  }
+  /**
+   * List an agent's saved messages and the known keys
+   *
+   * @param agentUuid - Agent UUID (a team UUID resolves to its lead agent)
+   *
+   * @example
+   * ```typescript
+   * const { messages, knownKeys, languages, defaultLanguage } = await client.agents.messages.list('agent-uuid');
+   * ```
+   */
+  async list(agentUuid) {
+    return this.httpGet(`/${agentUuid}/messages`);
+  }
+  /**
+   * Render one message with placeholders filled
+   *
+   * Resolves with `text: null` when the agent has no message for the key.
+   * Throws `ValidationError` before any request when the key is not a
+   * lowercase dotted key (see `MESSAGE_KEY_PATTERN`).
+   *
+   * @example
+   * ```typescript
+   * const { text } = await client.agents.messages.render('agent-uuid', 'handoff.requested', {
+   *   lang: 'es',
+   *   vars: { agentName: 'Ana' },
+   * });
+   * ```
+   */
+  async render(agentUuid, key, options = {}) {
+    if (!isValidMessageKey(key)) {
+      throw new ValidationError(`Invalid message key "${key}"`, [
+        { field: "key", message: "Must be a lowercase dotted key, e.g. chat.welcome" }
+      ]);
+    }
+    return this.httpPost(`/${agentUuid}/messages/render`, {
+      key,
+      ...options.lang ? { lang: options.lang } : {},
+      ...options.vars ? { vars: options.vars } : {}
+    });
+  }
+};
+
 // src/resources/agents.ts
 var AgentsAPI = class extends BaseResourceAPI {
   constructor(http, getStreamConfig) {
     super(http, "/api/v1/agents");
     this.getStreamConfig = getStreamConfig;
+    this.messages = new AgentMessagesAPI(http);
   }
   getStreamConfig;
+  /** Saved agent messages (p13): `list()` and `render()` */
+  messages;
   // ===== LIST Operations =====
   /**
    * List all agents in the organization
@@ -9610,6 +9666,147 @@ function useImageStream(options) {
   }, [client, providedExecutionId, agentUuid, inputKey, sessionId, shouldConnect]);
   return { images, status, error, executionId, output, cancel };
 }
+var DEFAULT_LABELS = {
+  search: "Search messages",
+  loading: "Loading messages",
+  loadError: "Could not load messages",
+  empty: "No matching messages",
+  notSet: "not set",
+  useCustom: (key) => `Use "${key}"`,
+  invalidCustom: "Keys are lowercase and dotted, like chat.welcome",
+  language: "Preview language"
+};
+function previewOf(message, lang, defaultLanguage = "en") {
+  const base = lang.split("-")[0] ?? lang;
+  for (const candidate of [lang, base, defaultLanguage, "en"]) {
+    const text = message.text[candidate];
+    if (text) return text;
+  }
+  return Object.values(message.text).find((t) => Boolean(t)) ?? null;
+}
+function languagesOf(list) {
+  if (list.languages && list.languages.length > 0) return list.languages;
+  const seen = /* @__PURE__ */ new Set([list.defaultLanguage ?? "en"]);
+  for (const m of list.messages) {
+    for (const [code, text] of Object.entries(m.text)) if (text) seen.add(code);
+  }
+  return [...seen];
+}
+function AgentMessagePicker({
+  client,
+  agentUuid,
+  value,
+  onChange,
+  allowCustom = false,
+  lang,
+  onLangChange,
+  labels: labelOverrides,
+  className = ""
+}) {
+  const labels = { ...DEFAULT_LABELS, ...labelOverrides };
+  const [data, setData] = react.useState(null);
+  const [error, setError] = react.useState(false);
+  const [query, setQuery] = react.useState("");
+  const [pickedLang, setPickedLang] = react.useState(null);
+  react.useEffect(() => {
+    setPickedLang(null);
+  }, [lang, agentUuid]);
+  const defaultLanguage = data?.defaultLanguage ?? "en";
+  const languages = react.useMemo(() => data ? languagesOf(data) : [], [data]);
+  const activeLang = pickedLang ?? lang ?? defaultLanguage;
+  react.useEffect(() => {
+    let cancelled = false;
+    setData(null);
+    setError(false);
+    client.agents.messages.list(agentUuid).then((result) => {
+      if (!cancelled) setData(result);
+    }).catch(() => {
+      if (!cancelled) setError(true);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, agentUuid]);
+  const items = react.useMemo(() => {
+    if (!data) return [];
+    const saved = data.messages.map((m) => ({
+      key: m.key,
+      preview: previewOf(m, activeLang, defaultLanguage)
+    }));
+    const savedKeys = new Set(saved.map((i) => i.key));
+    const unsaved = data.knownKeys.filter((k) => !savedKeys.has(k)).sort().map((key) => ({ key, preview: null }));
+    return [...saved, ...unsaved];
+  }, [data, activeLang, defaultLanguage]);
+  const needle = query.trim().toLowerCase();
+  const visible = needle ? items.filter(
+    (i) => i.key.includes(needle) || (i.preview?.toLowerCase().includes(needle) ?? false)
+  ) : items;
+  const custom = query.trim();
+  const showCustom = allowCustom && custom.length > 0 && !items.some((i) => i.key === custom);
+  const customValid = showCustom && isValidMessageKey(custom);
+  const languageChoices = languages.includes(activeLang) ? languages : [...languages, activeLang];
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `flex flex-col gap-2 text-sm ${className}`, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex gap-2", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          type: "search",
+          value: query,
+          onChange: (e) => setQuery(e.target.value),
+          placeholder: labels.search,
+          "aria-label": labels.search,
+          className: "w-full min-w-0 flex-1 rounded-lg bg-gray-100 dark:bg-gray-800 px-3 py-2 text-gray-900 dark:text-gray-100 placeholder:text-gray-400 focus:outline-none focus:ring-2 focus:ring-blue-500"
+        }
+      ),
+      data && languages.length > 1 && /* @__PURE__ */ jsxRuntime.jsx(
+        "select",
+        {
+          value: activeLang,
+          onChange: (e) => {
+            setPickedLang(e.target.value);
+            onLangChange?.(e.target.value);
+          },
+          "aria-label": labels.language,
+          className: "rounded-lg bg-gray-100 dark:bg-gray-800 px-2 py-2 font-mono text-xs text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-blue-500",
+          children: languageChoices.map((code) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: code, children: code }, code))
+        }
+      )
+    ] }),
+    error ? /* @__PURE__ */ jsxRuntime.jsx("p", { role: "alert", className: "px-1 text-red-500", children: labels.loadError }) : !data ? /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "flex items-center gap-2 px-1 text-gray-500 dark:text-gray-400", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(LoadingSpinner, { className: "h-4 w-4" }),
+      labels.loading
+    ] }) : /* @__PURE__ */ jsxRuntime.jsxs("ul", { role: "listbox", "aria-label": labels.search, className: "flex max-h-72 flex-col gap-0.5 overflow-y-auto", children: [
+      visible.map((item) => {
+        const selected = item.key === value;
+        return /* @__PURE__ */ jsxRuntime.jsx("li", { role: "option", "aria-selected": selected, children: /* @__PURE__ */ jsxRuntime.jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => onChange(item.key),
+            className: `flex w-full items-start gap-2 rounded-lg px-3 py-2 text-left transition-colors ${selected ? "bg-blue-50 dark:bg-blue-900/30" : "hover:bg-gray-100 dark:hover:bg-gray-800"}`,
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "font-mono text-xs text-gray-900 dark:text-gray-100", children: item.key }),
+                item.preview !== null ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-gray-500 dark:text-gray-400", children: item.preview }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "italic text-gray-400 dark:text-gray-500", children: labels.notSet })
+              ] }),
+              selected && /* @__PURE__ */ jsxRuntime.jsx(CheckIcon, { className: "h-4 w-4 flex-shrink-0 text-blue-500" })
+            ]
+          }
+        ) }, item.key);
+      }),
+      visible.length === 0 && !showCustom && /* @__PURE__ */ jsxRuntime.jsx("li", { className: "px-3 py-2 text-gray-500 dark:text-gray-400", children: labels.empty })
+    ] }),
+    data && showCustom && (customValid ? /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        type: "button",
+        onClick: () => onChange(custom),
+        className: "rounded-lg bg-gray-100 dark:bg-gray-800 px-3 py-2 text-left font-mono text-xs text-blue-600 dark:text-blue-400 hover:bg-gray-200 dark:hover:bg-gray-700",
+        children: labels.useCustom(custom)
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsx("p", { className: "px-1 text-xs text-gray-500 dark:text-gray-400", children: labels.invalidCustom }))
+  ] });
+}
 function cn13(...classes) {
   return classes.filter(Boolean).join(" ");
 }
@@ -9706,6 +9903,7 @@ function TodoList({
 }
 
 exports.AgentChat = AgentChat;
+exports.AgentMessagePicker = AgentMessagePicker;
 exports.AlertCircleIcon = AlertCircleIcon;
 exports.AskUserPrompt = AskUserPrompt;
 exports.BotIcon = BotIcon;
@@ -9738,6 +9936,7 @@ exports.ImageLightbox = ImageLightbox;
 exports.ImagesIcon = ImagesIcon;
 exports.ListTodoIcon = ListTodoIcon;
 exports.LoadingSpinner = LoadingSpinner;
+exports.MESSAGE_KEY_PATTERN = MESSAGE_KEY_PATTERN;
 exports.MarkdownContent = MarkdownContent;
 exports.Maximize2Icon = Maximize2Icon;
 exports.MessageCircleIcon = MessageCircleIcon;
@@ -9758,6 +9957,7 @@ exports.ZoomOutIcon = ZoomOutIcon;
 exports.compressImage = compressImage;
 exports.createDefaultAdapter = createDefaultAdapter;
 exports.isInternalTool = isInternalTool;
+exports.isValidMessageKey = isValidMessageKey;
 exports.useAgentChat = useAgentChat;
 exports.useChatConfig = useChatConfig;
 exports.useChatConfigOptional = useChatConfigOptional;