@cadraos/sdk 0.3.15 → 0.3.16-dev.0

package/dist/chat/index.d.cts

@@ -830,6 +830,51 @@ interface ExecuteResponse {
     /** Initial status */
     status: ExecutionStatus;
 }
+/**
+ * Languages an agent message can be stored and rendered in.
+ */
+type AgentMessageLang = 'en' | 'es' | 'id';
+/**
+ * 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: 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[];
+}
+/**
+ * Options for `client.agents.messages.render()`
+ */
+interface AgentMessageRenderOptions {
+    /** Requested language; falls back to `en` server-side */
+    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 */
+    lang: AgentMessageLang;
+    /** Filled text, or `null` when the agent has no message for this key */
+    text: string | null;
+}
 
 /**
  * Streaming types
@@ -2771,6 +2816,46 @@ 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
+ * - render(): one message filled with vars, in a language (falls back to en)
+ */
+
+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 } = 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 +2871,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 +5265,50 @@ 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;
+}
+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;
+    /** Preview language (falls back to en). Default: en */
+    lang?: AgentMessageLang;
+    labels?: Partial<AgentMessagePickerLabels>;
+    className?: string;
+}
+declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, 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 +5551,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,51 @@ interface ExecuteResponse {
     /** Initial status */
     status: ExecutionStatus;
 }
+/**
+ * Languages an agent message can be stored and rendered in.
+ */
+type AgentMessageLang = 'en' | 'es' | 'id';
+/**
+ * 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: 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[];
+}
+/**
+ * Options for `client.agents.messages.render()`
+ */
+interface AgentMessageRenderOptions {
+    /** Requested language; falls back to `en` server-side */
+    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 */
+    lang: AgentMessageLang;
+    /** Filled text, or `null` when the agent has no message for this key */
+    text: string | null;
+}
 
 /**
  * Streaming types
@@ -2771,6 +2816,46 @@ 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
+ * - render(): one message filled with vars, in a language (falls back to en)
+ */
+
+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 } = 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 +2871,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 +5265,50 @@ 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;
+}
+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;
+    /** Preview language (falls back to en). Default: en */
+    lang?: AgentMessageLang;
+    labels?: Partial<AgentMessagePickerLabels>;
+    className?: string;
+}
+declare function AgentMessagePicker({ client, agentUuid, value, onChange, allowCustom, lang, 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 +5551,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 } = 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,106 @@ 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"
+};
+function previewOf(message, lang) {
+  return message.text[lang] ?? message.text.en ?? Object.values(message.text).find(Boolean) ?? null;
+}
+function AgentMessagePicker({
+  client,
+  agentUuid,
+  value,
+  onChange,
+  allowCustom = false,
+  lang = "en",
+  labels: labelOverrides,
+  className = ""
+}) {
+  const labels = { ...DEFAULT_LABELS, ...labelOverrides };
+  const [data, setData] = useState(null);
+  const [error, setError] = useState(false);
+  const [query, setQuery] = useState("");
+  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, lang) }));
+    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]);
+  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);
+  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"
+      }
+    ),
+    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 +9854,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