@cadraos/sdk 0.3.16-dev.0 → 0.3.16-dev.1

package/dist/chat/index.d.cts

@@ -831,16 +831,18 @@ interface ExecuteResponse {
     status: ExecutionStatus;
 }
 /**
- * Languages an agent message can be stored and rendered in.
+ * Language code an agent message is stored and rendered in (e.g. `en`,
+ * `pt-br`). Each agent sets its own language list; see
+ * `AgentMessageList.languages`. Was `'en' | 'es' | 'id'` before p13.
  */
-type AgentMessageLang = 'en' | 'es' | 'id';
+type AgentMessageLang = string;
 /**
  * One saved agent message (e.g. `handoff.requested`), text per language.
  */
 interface AgentMessage {
     /** Lowercase dotted key, e.g. `chat.welcome` */
     key: string;
-    /** Text per language; `en` is the fallback language */
+    /** Text per language code */
     text: Partial<Record<AgentMessageLang, string>>;
     /** `{word}` placeholder names found in any language */
     placeholders: string[];
@@ -855,12 +857,22 @@ interface AgentMessageList {
     messages: AgentMessage[];
     /** Every key the platform knows about, for pickers (saved or not) */
     knownKeys: string[];
+    /**
+     * The agent's message languages, in display order. Missing from older
+     * servers; fall back to the languages seen in `messages[].text`.
+     */
+    languages?: AgentMessageLang[];
+    /** The agent's default message language. Missing from older servers; treat as `en`. */
+    defaultLanguage?: AgentMessageLang;
 }
 /**
  * Options for `client.agents.messages.render()`
  */
 interface AgentMessageRenderOptions {
-    /** Requested language; falls back to `en` server-side */
+    /**
+     * Requested language. Server falls back: exact, then base (`pt-br` to `pt`),
+     * then the agent's default language, then `en`, then the first non-empty text.
+     */
     lang?: AgentMessageLang;
     /** Values for `{word}` placeholders; unknown placeholders are left as-is */
     vars?: Record<string, string | number>;
@@ -870,7 +882,7 @@ interface AgentMessageRenderOptions {
  */
 interface AgentMessageRenderResult {
     key: string;
-    /** The language actually rendered */
+    /** The language actually rendered (after fallback) */
     lang: AgentMessageLang;
     /** Filled text, or `null` when the agent has no message for this key */
     text: string | null;
@@ -2821,8 +2833,9 @@ interface StreamImagesResult {
  *
  * Read-only access to an agent's saved messages (welcome, handoff, fallback
  * copy, ...). Reached as `client.agents.messages`.
- * - list(): the agent's saved messages + every known key
- * - render(): one message filled with vars, in a language (falls back to en)
+ * - list(): the agent's saved messages, every known key, the agent's languages
+ * - render(): one message filled with vars, in a language (server falls back:
+ *   exact, base, agent default, en, first non-empty; `lang` says which was used)
  */
 
 declare class AgentMessagesAPI extends BaseResourceAPI {
@@ -2834,7 +2847,7 @@ declare class AgentMessagesAPI extends BaseResourceAPI {
      *
      * @example
      * ```typescript
-     * const { messages, knownKeys } = await client.agents.messages.list('agent-uuid');
+     * const { messages, knownKeys, languages, defaultLanguage } = await client.agents.messages.list('agent-uuid');
      * ```
      */
     list(agentUuid: string): Promise<AgentMessageList>;
@@ -5282,6 +5295,8 @@ interface AgentMessagePickerLabels {
     notSet: string;
     useCustom: (key: string) => string;
     invalidCustom: string;
+    /** Accessible label of the preview-language select */
+    language: string;
 }
 interface AgentMessagePickerProps {
     client: AgentMessagePickerClient;
@@ -5291,12 +5306,14 @@ interface AgentMessagePickerProps {
     onChange: (key: string) => void;
     /** Let the user type a new dotted key */
     allowCustom?: boolean;
-    /** Preview language (falls back to en). Default: en */
+    /** Starting preview language. Default: the agent's defaultLanguage, else en */
     lang?: AgentMessageLang;
+    /** Called when the user picks another preview language */
+    onLangChange?: (lang: AgentMessageLang) => void;
     labels?: Partial<AgentMessagePickerLabels>;
     className?: string;
 }
-declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
+declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, onLangChange, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Agent message keys (p13) — lowercase dotted, e.g. `chat.welcome`.

package/dist/chat/index.d.ts

@@ -831,16 +831,18 @@ interface ExecuteResponse {
     status: ExecutionStatus;
 }
 /**
- * Languages an agent message can be stored and rendered in.
+ * Language code an agent message is stored and rendered in (e.g. `en`,
+ * `pt-br`). Each agent sets its own language list; see
+ * `AgentMessageList.languages`. Was `'en' | 'es' | 'id'` before p13.
  */
-type AgentMessageLang = 'en' | 'es' | 'id';
+type AgentMessageLang = string;
 /**
  * One saved agent message (e.g. `handoff.requested`), text per language.
  */
 interface AgentMessage {
     /** Lowercase dotted key, e.g. `chat.welcome` */
     key: string;
-    /** Text per language; `en` is the fallback language */
+    /** Text per language code */
     text: Partial<Record<AgentMessageLang, string>>;
     /** `{word}` placeholder names found in any language */
     placeholders: string[];
@@ -855,12 +857,22 @@ interface AgentMessageList {
     messages: AgentMessage[];
     /** Every key the platform knows about, for pickers (saved or not) */
     knownKeys: string[];
+    /**
+     * The agent's message languages, in display order. Missing from older
+     * servers; fall back to the languages seen in `messages[].text`.
+     */
+    languages?: AgentMessageLang[];
+    /** The agent's default message language. Missing from older servers; treat as `en`. */
+    defaultLanguage?: AgentMessageLang;
 }
 /**
  * Options for `client.agents.messages.render()`
  */
 interface AgentMessageRenderOptions {
-    /** Requested language; falls back to `en` server-side */
+    /**
+     * Requested language. Server falls back: exact, then base (`pt-br` to `pt`),
+     * then the agent's default language, then `en`, then the first non-empty text.
+     */
     lang?: AgentMessageLang;
     /** Values for `{word}` placeholders; unknown placeholders are left as-is */
     vars?: Record<string, string | number>;
@@ -870,7 +882,7 @@ interface AgentMessageRenderOptions {
  */
 interface AgentMessageRenderResult {
     key: string;
-    /** The language actually rendered */
+    /** The language actually rendered (after fallback) */
     lang: AgentMessageLang;
     /** Filled text, or `null` when the agent has no message for this key */
     text: string | null;
@@ -2821,8 +2833,9 @@ interface StreamImagesResult {
  *
  * Read-only access to an agent's saved messages (welcome, handoff, fallback
  * copy, ...). Reached as `client.agents.messages`.
- * - list(): the agent's saved messages + every known key
- * - render(): one message filled with vars, in a language (falls back to en)
+ * - list(): the agent's saved messages, every known key, the agent's languages
+ * - render(): one message filled with vars, in a language (server falls back:
+ *   exact, base, agent default, en, first non-empty; `lang` says which was used)
  */
 
 declare class AgentMessagesAPI extends BaseResourceAPI {
@@ -2834,7 +2847,7 @@ declare class AgentMessagesAPI extends BaseResourceAPI {
      *
      * @example
      * ```typescript
-     * const { messages, knownKeys } = await client.agents.messages.list('agent-uuid');
+     * const { messages, knownKeys, languages, defaultLanguage } = await client.agents.messages.list('agent-uuid');
      * ```
      */
     list(agentUuid: string): Promise<AgentMessageList>;
@@ -5282,6 +5295,8 @@ interface AgentMessagePickerLabels {
     notSet: string;
     useCustom: (key: string) => string;
     invalidCustom: string;
+    /** Accessible label of the preview-language select */
+    language: string;
 }
 interface AgentMessagePickerProps {
     client: AgentMessagePickerClient;
@@ -5291,12 +5306,14 @@ interface AgentMessagePickerProps {
     onChange: (key: string) => void;
     /** Let the user type a new dotted key */
     allowCustom?: boolean;
-    /** Preview language (falls back to en). Default: en */
+    /** Starting preview language. Default: the agent's defaultLanguage, else en */
     lang?: AgentMessageLang;
+    /** Called when the user picks another preview language */
+    onLangChange?: (lang: AgentMessageLang) => void;
     labels?: Partial<AgentMessagePickerLabels>;
     className?: string;
 }
-declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
+declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, onLangChange, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Agent message keys (p13) — lowercase dotted, e.g. `chat.welcome`.

package/dist/chat/index.js

@@ -1841,7 +1841,7 @@ var AgentMessagesAPI = class extends BaseResourceAPI {
    *
    * @example
    * ```typescript
-   * const { messages, knownKeys } = await client.agents.messages.list('agent-uuid');
+   * const { messages, knownKeys, languages, defaultLanguage } = await client.agents.messages.list('agent-uuid');
    * ```
    */
   async list(agentUuid) {
@@ -9666,10 +9666,24 @@ var DEFAULT_LABELS = {
   empty: "No matching messages",
   notSet: "not set",
   useCustom: (key) => `Use "${key}"`,
-  invalidCustom: "Keys are lowercase and dotted, like chat.welcome"
+  invalidCustom: "Keys are lowercase and dotted, like chat.welcome",
+  language: "Preview language"
 };
-function previewOf(message, lang) {
-  return message.text[lang] ?? message.text.en ?? Object.values(message.text).find(Boolean) ?? null;
+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,
@@ -9677,7 +9691,8 @@ function AgentMessagePicker({
   value,
   onChange,
   allowCustom = false,
-  lang = "en",
+  lang,
+  onLangChange,
   labels: labelOverrides,
   className = ""
 }) {
@@ -9685,6 +9700,13 @@ function AgentMessagePicker({
   const [data, setData] = useState(null);
   const [error, setError] = useState(false);
   const [query, setQuery] = useState("");
+  const [pickedLang, setPickedLang] = useState(null);
+  useEffect(() => {
+    setPickedLang(null);
+  }, [lang, agentUuid]);
+  const defaultLanguage = data?.defaultLanguage ?? "en";
+  const languages = useMemo(() => data ? languagesOf(data) : [], [data]);
+  const activeLang = pickedLang ?? lang ?? defaultLanguage;
   useEffect(() => {
     let cancelled = false;
     setData(null);
@@ -9700,11 +9722,14 @@ function AgentMessagePicker({
   }, [client, agentUuid]);
   const items = useMemo(() => {
     if (!data) return [];
-    const saved = data.messages.map((m) => ({ key: m.key, preview: previewOf(m, lang) }));
+    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, lang]);
+  }, [data, activeLang, defaultLanguage]);
   const needle = query.trim().toLowerCase();
   const visible = needle ? items.filter(
     (i) => i.key.includes(needle) || (i.preview?.toLowerCase().includes(needle) ?? false)
@@ -9712,18 +9737,34 @@ function AgentMessagePicker({
   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__ */ jsxs("div", { className: `flex flex-col gap-2 text-sm ${className}`, children: [
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        type: "search",
-        value: query,
-        onChange: (e) => setQuery(e.target.value),
-        placeholder: labels.search,
-        "aria-label": labels.search,
-        className: "w-full 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"
-      }
-    ),
+    /* @__PURE__ */ jsxs("div", { className: "flex gap-2", children: [
+      /* @__PURE__ */ 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__ */ 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__ */ jsx("option", { value: code, children: code }, code))
+        }
+      )
+    ] }),
     error ? /* @__PURE__ */ jsx("p", { role: "alert", className: "px-1 text-red-500", children: labels.loadError }) : !data ? /* @__PURE__ */ jsxs("p", { className: "flex items-center gap-2 px-1 text-gray-500 dark:text-gray-400", children: [
       /* @__PURE__ */ jsx(LoadingSpinner, { className: "h-4 w-4" }),
       labels.loading