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

package/dist/index.d.cts

@@ -391,16 +391,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[];
@@ -415,12 +417,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>;
@@ -430,7 +442,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;
@@ -1897,8 +1909,9 @@ declare function collectImagesFromStream(stream: ExecutionStreamController, opti
  *
  * 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 {
@@ -1910,7 +1923,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>;

package/dist/index.d.ts

@@ -391,16 +391,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[];
@@ -415,12 +417,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>;
@@ -430,7 +442,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;
@@ -1897,8 +1909,9 @@ declare function collectImagesFromStream(stream: ExecutionStreamController, opti
  *
  * 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 {
@@ -1910,7 +1923,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>;

package/dist/index.js

@@ -1834,7 +1834,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) {