@cadraos/sdk 0.3.15 → 0.3.16-dev.1

package/dist/chat/index.d.cts

@@ -830,6 +830,63 @@ interface ExecuteResponse {
     /** Initial status */
     status: ExecutionStatus;
 }
+/**
+ * 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 = 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 code */
+    text: Partial<Record<AgentMessageLang, string>>;
+    /** `{word}` placeholder names found in any language */
+    placeholders: string[];
+}
+/**
+ * Response of `client.agents.messages.list()`
+ */
+interface AgentMessageList {
+    /** The resolved agent (a team uuid resolves to its lead agent) */
+    agentUuid: string;
+    /** The agent's saved messages, sorted by key */
+    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. 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>;
+}
+/**
+ * Response of `client.agents.messages.render()`
+ */
+interface AgentMessageRenderResult {
+    key: string;
+    /** The language actually rendered (after fallback) */
+    lang: AgentMessageLang;
+    /** Filled text, or `null` when the agent has no message for this key */
+    text: string | null;
+}
 
 /**
  * Streaming types
@@ -2771,6 +2828,47 @@ interface StreamImagesResult {
     executionId: string;
 }
 
+/**
+ * Agent Messages Resource API (p13)
+ *
+ * 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, 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 {
+    constructor(http: HttpClient);
+    /**
+     * 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');
+     * ```
+     */
+    list(agentUuid: string): Promise<AgentMessageList>;
+    /**
+     * 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' },
+     * });
+     * ```
+     */
+    render(agentUuid: string, key: string, options?: AgentMessageRenderOptions): Promise<AgentMessageRenderResult>;
+}
+
 /**
  * Agents Resource API
  *
@@ -2786,6 +2884,8 @@ interface StreamImagesResult {
  */
 declare class AgentsAPI extends BaseResourceAPI {
     private readonly getStreamConfig;
+    /** Saved agent messages (p13): `list()` and `render()` */
+    readonly messages: AgentMessagesAPI;
     constructor(http: HttpClient, getStreamConfig: () => StreamConfig);
     /**
      * List all agents in the organization
@@ -5178,6 +5278,54 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, attachments, onRemoveAttachment, dropZoneRef, isUploadingAttachments, className, onInputChange, onInputControlReady, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 
+/** The slice of CadraClient the picker uses. */
+interface AgentMessagePickerClient {
+    agents: {
+        messages: {
+            list(agentUuid: string): Promise<AgentMessageList>;
+        };
+    };
+}
+/** UI labels; override to translate. */
+interface AgentMessagePickerLabels {
+    search: string;
+    loading: string;
+    loadError: string;
+    empty: string;
+    notSet: string;
+    useCustom: (key: string) => string;
+    invalidCustom: string;
+    /** Accessible label of the preview-language select */
+    language: string;
+}
+interface AgentMessagePickerProps {
+    client: AgentMessagePickerClient;
+    agentUuid: string;
+    /** Selected key */
+    value?: string | null;
+    onChange: (key: string) => void;
+    /** Let the user type a new dotted key */
+    allowCustom?: boolean;
+    /** 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, onLangChange, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Agent message keys (p13) — lowercase dotted, e.g. `chat.welcome`.
+ *
+ * Same rule cadra-web enforces on `/api/v1/agents/:id/messages/render`, so an
+ * invalid key fails client-side before a request is made. Kept free of any
+ * client import so the chat entry can use it without pulling in the client.
+ */
+declare const MESSAGE_KEY_PATTERN: RegExp;
+/** True when `key` is a valid lowercase dotted agent message key. */
+declare function isValidMessageKey(key: string): boolean;
+
 /**
  * Tool name patterns for internal/orchestration tools that should be hidden
  * in compact verbosity mode. These are matched after stripping common prefixes
@@ -5420,4 +5568,4 @@ declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtim
  */
 declare function compressImage(file: File, targetSizeKB?: number): Promise<File>;
 
-export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, type CurrentStep, DatabaseIcon, type DefaultAdapterConfig, type DelegationEvent, DelegationProgress, DelegationProgressList, type DelegationProgressListProps, type DelegationProgressProps, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, type ImageData, ImageGallery, type ImageGalleryProps, ImageIcon, ImageLightbox, type ImageLightboxProps, type ImageStreamClient, type ImageStreamStatus, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, ThinkingBlock, ThinkingBlockList, type ThinkingBlockListProps, type ThinkingBlockProps, type ThinkingBlock$1 as ThinkingBlockType, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseImageStreamOptions, type UseImageStreamResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };
+export { AgentChat, type AgentChatProps, AgentMessagePicker, type AgentMessagePickerClient, type AgentMessagePickerLabels, type AgentMessagePickerProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, type CurrentStep, DatabaseIcon, type DefaultAdapterConfig, type DelegationEvent, DelegationProgress, DelegationProgressList, type DelegationProgressListProps, type DelegationProgressProps, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, type ImageData, ImageGallery, type ImageGalleryProps, ImageIcon, ImageLightbox, type ImageLightboxProps, type ImageStreamClient, type ImageStreamStatus, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MESSAGE_KEY_PATTERN, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, ThinkingBlock, ThinkingBlockList, type ThinkingBlockListProps, type ThinkingBlockProps, type ThinkingBlock$1 as ThinkingBlockType, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseImageStreamOptions, type UseImageStreamResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, isValidMessageKey, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };

package/dist/chat/index.d.ts

@@ -830,6 +830,63 @@ interface ExecuteResponse {
     /** Initial status */
     status: ExecutionStatus;
 }
+/**
+ * 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 = 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 code */
+    text: Partial<Record<AgentMessageLang, string>>;
+    /** `{word}` placeholder names found in any language */
+    placeholders: string[];
+}
+/**
+ * Response of `client.agents.messages.list()`
+ */
+interface AgentMessageList {
+    /** The resolved agent (a team uuid resolves to its lead agent) */
+    agentUuid: string;
+    /** The agent's saved messages, sorted by key */
+    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. 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>;
+}
+/**
+ * Response of `client.agents.messages.render()`
+ */
+interface AgentMessageRenderResult {
+    key: string;
+    /** The language actually rendered (after fallback) */
+    lang: AgentMessageLang;
+    /** Filled text, or `null` when the agent has no message for this key */
+    text: string | null;
+}
 
 /**
  * Streaming types
@@ -2771,6 +2828,47 @@ interface StreamImagesResult {
     executionId: string;
 }
 
+/**
+ * Agent Messages Resource API (p13)
+ *
+ * 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, 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 {
+    constructor(http: HttpClient);
+    /**
+     * 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');
+     * ```
+     */
+    list(agentUuid: string): Promise<AgentMessageList>;
+    /**
+     * 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' },
+     * });
+     * ```
+     */
+    render(agentUuid: string, key: string, options?: AgentMessageRenderOptions): Promise<AgentMessageRenderResult>;
+}
+
 /**
  * Agents Resource API
  *
@@ -2786,6 +2884,8 @@ interface StreamImagesResult {
  */
 declare class AgentsAPI extends BaseResourceAPI {
     private readonly getStreamConfig;
+    /** Saved agent messages (p13): `list()` and `render()` */
+    readonly messages: AgentMessagesAPI;
     constructor(http: HttpClient, getStreamConfig: () => StreamConfig);
     /**
      * List all agents in the organization
@@ -5178,6 +5278,54 @@ interface ChatInputProps {
  */
 declare function ChatInput({ onSend, onStop, placeholder, disabled, isLoading, enableAttachments, attachments, onRemoveAttachment, dropZoneRef, isUploadingAttachments, className, onInputChange, onInputControlReady, }: ChatInputProps): react_jsx_runtime.JSX.Element;
 
+/** The slice of CadraClient the picker uses. */
+interface AgentMessagePickerClient {
+    agents: {
+        messages: {
+            list(agentUuid: string): Promise<AgentMessageList>;
+        };
+    };
+}
+/** UI labels; override to translate. */
+interface AgentMessagePickerLabels {
+    search: string;
+    loading: string;
+    loadError: string;
+    empty: string;
+    notSet: string;
+    useCustom: (key: string) => string;
+    invalidCustom: string;
+    /** Accessible label of the preview-language select */
+    language: string;
+}
+interface AgentMessagePickerProps {
+    client: AgentMessagePickerClient;
+    agentUuid: string;
+    /** Selected key */
+    value?: string | null;
+    onChange: (key: string) => void;
+    /** Let the user type a new dotted key */
+    allowCustom?: boolean;
+    /** 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, onLangChange, labels: labelOverrides, className, }: AgentMessagePickerProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Agent message keys (p13) — lowercase dotted, e.g. `chat.welcome`.
+ *
+ * Same rule cadra-web enforces on `/api/v1/agents/:id/messages/render`, so an
+ * invalid key fails client-side before a request is made. Kept free of any
+ * client import so the chat entry can use it without pulling in the client.
+ */
+declare const MESSAGE_KEY_PATTERN: RegExp;
+/** True when `key` is a valid lowercase dotted agent message key. */
+declare function isValidMessageKey(key: string): boolean;
+
 /**
  * Tool name patterns for internal/orchestration tools that should be hidden
  * in compact verbosity mode. These are matched after stripping common prefixes
@@ -5420,4 +5568,4 @@ declare function ClockIcon({ className, ...props }: IconProps): react_jsx_runtim
  */
 declare function compressImage(file: File, targetSizeKB?: number): Promise<File>;
 
-export { AgentChat, type AgentChatProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, type CurrentStep, DatabaseIcon, type DefaultAdapterConfig, type DelegationEvent, DelegationProgress, DelegationProgressList, type DelegationProgressListProps, type DelegationProgressProps, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, type ImageData, ImageGallery, type ImageGalleryProps, ImageIcon, ImageLightbox, type ImageLightboxProps, type ImageStreamClient, type ImageStreamStatus, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, ThinkingBlock, ThinkingBlockList, type ThinkingBlockListProps, type ThinkingBlockProps, type ThinkingBlock$1 as ThinkingBlockType, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseImageStreamOptions, type UseImageStreamResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };
+export { AgentChat, type AgentChatProps, AgentMessagePicker, type AgentMessagePickerClient, type AgentMessagePickerLabels, type AgentMessagePickerProps, AlertCircleIcon, type Artifact$1 as Artifact, AskUserPrompt, type AskUserPromptProps, type AttachmentData, type AttachmentFile, BotIcon, type ChatAdapter, ChatConfigProvider, type ChatConfigProviderProps, ChatContainer, type ChatContainerProps, type ChatError, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageProps, type ChatMessage$1 as ChatMessageType, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, type ClarificationData, ClockIcon, CodeIcon, CopyIcon, type CurrentStep, DatabaseIcon, type DefaultAdapterConfig, type DelegationEvent, DelegationProgress, DelegationProgressList, type DelegationProgressListProps, type DelegationProgressProps, DownloadIcon, type Execution, type ExecutionResult, type ExecutionStreamEvent, ExternalLinkIcon, FileDropZone, type FileDropZoneProps, type FileDropZoneRef, FileIcon, FileTextIcon, HelpCircleIcon, type HistoryMessage, INTERNAL_TOOL_NAMES, type IconProps, type ImageData, ImageGallery, type ImageGalleryProps, ImageIcon, ImageLightbox, type ImageLightboxProps, type ImageStreamClient, type ImageStreamStatus, ImagesIcon, type ListSessionsInput, ListTodoIcon, LoadingSpinner, MESSAGE_KEY_PATTERN, MarkdownContent, type MarkdownContentProps, Maximize2Icon, MessageCircleIcon, MessageList, type MessageListProps, Minimize2Icon, PaperclipIcon, SendIcon, type SendMessageInput$1 as SendMessageInput, type SendMessageOptions, type SessionHistory$1 as SessionHistory, type SessionList, type SessionListItem, SparklesIcon, type StartExecutionInput, StopCircleIcon, type ThemeMode, ThinkingBlock, ThinkingBlockList, type ThinkingBlockListProps, type ThinkingBlockProps, type ThinkingBlock$1 as ThinkingBlockType, type TodoItem, TodoList, type TodoListProps, type ToolCall, ToolCallEntry, type ToolCallEntryProps, type ToolCallVerbosity, type UploadUrlInput, type UploadUrlResult, type UseAgentChatOptions, type UseAgentChatResult, type UseExecutionStreamOptions, type UseExecutionStreamResult, type UseFileAttachmentsOptions, type UseFileAttachmentsResult, type UseImageStreamOptions, type UseImageStreamResult, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, isValidMessageKey, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };

package/dist/chat/index.js

@@ -1823,13 +1823,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
@@ -9603,6 +9659,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] = 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);
+    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 = 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__ */ jsxs("div", { className: `flex flex-col gap-2 text-sm ${className}`, children: [
+    /* @__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
+    ] }) : /* @__PURE__ */ 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__ */ jsx("li", { role: "option", "aria-selected": selected, children: /* @__PURE__ */ 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__ */ jsxs("span", { className: "flex min-w-0 flex-1 flex-col", children: [
+                /* @__PURE__ */ jsx("span", { className: "font-mono text-xs text-gray-900 dark:text-gray-100", children: item.key }),
+                item.preview !== null ? /* @__PURE__ */ jsx("span", { className: "truncate text-gray-500 dark:text-gray-400", children: item.preview }) : /* @__PURE__ */ jsx("span", { className: "italic text-gray-400 dark:text-gray-500", children: labels.notSet })
+              ] }),
+              selected && /* @__PURE__ */ jsx(CheckIcon, { className: "h-4 w-4 flex-shrink-0 text-blue-500" })
+            ]
+          }
+        ) }, item.key);
+      }),
+      visible.length === 0 && !showCustom && /* @__PURE__ */ jsx("li", { className: "px-3 py-2 text-gray-500 dark:text-gray-400", children: labels.empty })
+    ] }),
+    data && showCustom && (customValid ? /* @__PURE__ */ 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__ */ 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(" ");
 }
@@ -9698,6 +9895,6 @@ function TodoList({
   );
 }
 
-export { AgentChat, AlertCircleIcon, AskUserPrompt, BotIcon, ChatConfigProvider, ChatContainer, ChatInput, ChatMessage, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, DelegationProgress, DelegationProgressList, DownloadIcon, ExternalLinkIcon, FileDropZone, FileIcon, FileTextIcon, HelpCircleIcon, INTERNAL_TOOL_NAMES, ImageGallery, ImageIcon, ImageLightbox, ImagesIcon, ListTodoIcon, LoadingSpinner, MarkdownContent, Maximize2Icon, MessageCircleIcon, MessageList, Minimize2Icon, PaperclipIcon, SendIcon, SparklesIcon, StopCircleIcon, ThinkingBlock, ThinkingBlockList, TodoList, ToolCallEntry, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };
+export { AgentChat, AgentMessagePicker, AlertCircleIcon, AskUserPrompt, BotIcon, ChatConfigProvider, ChatContainer, ChatInput, ChatMessage, CheckCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CircleIcon, ClockIcon, CodeIcon, CopyIcon, DatabaseIcon, DelegationProgress, DelegationProgressList, DownloadIcon, ExternalLinkIcon, FileDropZone, FileIcon, FileTextIcon, HelpCircleIcon, INTERNAL_TOOL_NAMES, ImageGallery, ImageIcon, ImageLightbox, ImagesIcon, ListTodoIcon, LoadingSpinner, MESSAGE_KEY_PATTERN, MarkdownContent, Maximize2Icon, MessageCircleIcon, MessageList, Minimize2Icon, PaperclipIcon, SendIcon, SparklesIcon, StopCircleIcon, ThinkingBlock, ThinkingBlockList, TodoList, ToolCallEntry, UserIcon, XIcon, ZoomInIcon, ZoomOutIcon, compressImage, createDefaultAdapter, isInternalTool, isValidMessageKey, useAgentChat, useChatConfig, useChatConfigOptional, useExecutionStream, useFileAttachments, useImageStream };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map