@cadraos/sdk 0.3.15 → 0.3.16-dev.1

package/dist/index.d.cts

@@ -390,6 +390,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;
+}
 
 /**
  * Skill types
@@ -1847,6 +1904,47 @@ interface StreamImagesResult {
  */
 declare function collectImagesFromStream(stream: ExecutionStreamController, options?: CollectImagesOptions): Promise<StreamImagesResult>;
 
+/**
+ * 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
  *
@@ -1862,6 +1960,8 @@ declare function collectImagesFromStream(stream: ExecutionStreamController, opti
  */
 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
@@ -3665,6 +3765,17 @@ declare class CadraClient {
     private validateOptions;
 }
 
+/**
+ * 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;
+
 /**
  * SDK Error Classes
  *
@@ -3803,4 +3914,4 @@ declare class AiFunctionParameterError extends ValidationError {
     constructor(functionKey: string, issues: AiFunctionParameterIssue[]);
 }
 
-export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type AiFunctionBilledTo, AiFunctionChargedError, type AiFunctionDescriptor, AiFunctionDuplicateError, type AiFunctionImage, type AiFunctionOutput, type AiFunctionOutputKind, type AiFunctionParameter, AiFunctionParameterError, type AiFunctionParameterIssue, type AiFunctionParameterIssueCode, type AiFunctionParameterType, type AiFunctionRef, type AiFunctionRun, type AiFunctionRunOptions, type AiFunctionRunResult, type AiFunctionRunShorthandOptions, type AiFunctionRunStatus, type AiFunctionRuntimeParams, type AiFunctionUsage, type AiFunctionVariableValue, type AiFunctionVariables, AiFunctionsAPI, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, type AttachmentUploadUrlInput, type AttachmentUploadUrlResponse, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CollectImagesOptions, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type ExtractContext, type ImageData, type ImageEvent, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type RemoteAgent, type RemoteAgentCreateInput, type RemoteAgentExecuteResponse, type RemoteAgentExecutionTargetKind, type RemoteAgentListOptions, type RemoteAgentStatus, type RemoteAgentUpdateInput, type RemoteAgentVisibility, type RemoteRunner, type RemoteRunnerListOptions, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type StreamImagesResult, type TeamMemberRef, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult };
+export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentMessage, type AgentMessageLang, type AgentMessageList, type AgentMessageRenderOptions, type AgentMessageRenderResult, AgentMessagesAPI, type AgentStatus, type AgentType, type AgentUpdateInput, type AiFunctionBilledTo, AiFunctionChargedError, type AiFunctionDescriptor, AiFunctionDuplicateError, type AiFunctionImage, type AiFunctionOutput, type AiFunctionOutputKind, type AiFunctionParameter, AiFunctionParameterError, type AiFunctionParameterIssue, type AiFunctionParameterIssueCode, type AiFunctionParameterType, type AiFunctionRef, type AiFunctionRun, type AiFunctionRunOptions, type AiFunctionRunResult, type AiFunctionRunShorthandOptions, type AiFunctionRunStatus, type AiFunctionRuntimeParams, type AiFunctionUsage, type AiFunctionVariableValue, type AiFunctionVariables, AiFunctionsAPI, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, type AttachmentUploadUrlInput, type AttachmentUploadUrlResponse, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CollectImagesOptions, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type ExtractContext, type ImageData, type ImageEvent, type JSONSchema, type ListOptions, MESSAGE_KEY_PATTERN, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type RemoteAgent, type RemoteAgentCreateInput, type RemoteAgentExecuteResponse, type RemoteAgentExecutionTargetKind, type RemoteAgentListOptions, type RemoteAgentStatus, type RemoteAgentUpdateInput, type RemoteAgentVisibility, type RemoteRunner, type RemoteRunnerListOptions, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type StreamImagesResult, type TeamMemberRef, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult, isValidMessageKey };

package/dist/index.d.ts

@@ -390,6 +390,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;
+}
 
 /**
  * Skill types
@@ -1847,6 +1904,47 @@ interface StreamImagesResult {
  */
 declare function collectImagesFromStream(stream: ExecutionStreamController, options?: CollectImagesOptions): Promise<StreamImagesResult>;
 
+/**
+ * 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
  *
@@ -1862,6 +1960,8 @@ declare function collectImagesFromStream(stream: ExecutionStreamController, opti
  */
 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
@@ -3665,6 +3765,17 @@ declare class CadraClient {
     private validateOptions;
 }
 
+/**
+ * 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;
+
 /**
  * SDK Error Classes
  *
@@ -3803,4 +3914,4 @@ declare class AiFunctionParameterError extends ValidationError {
     constructor(functionKey: string, issues: AiFunctionParameterIssue[]);
 }
 
-export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type AiFunctionBilledTo, AiFunctionChargedError, type AiFunctionDescriptor, AiFunctionDuplicateError, type AiFunctionImage, type AiFunctionOutput, type AiFunctionOutputKind, type AiFunctionParameter, AiFunctionParameterError, type AiFunctionParameterIssue, type AiFunctionParameterIssueCode, type AiFunctionParameterType, type AiFunctionRef, type AiFunctionRun, type AiFunctionRunOptions, type AiFunctionRunResult, type AiFunctionRunShorthandOptions, type AiFunctionRunStatus, type AiFunctionRuntimeParams, type AiFunctionUsage, type AiFunctionVariableValue, type AiFunctionVariables, AiFunctionsAPI, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, type AttachmentUploadUrlInput, type AttachmentUploadUrlResponse, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CollectImagesOptions, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type ExtractContext, type ImageData, type ImageEvent, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type RemoteAgent, type RemoteAgentCreateInput, type RemoteAgentExecuteResponse, type RemoteAgentExecutionTargetKind, type RemoteAgentListOptions, type RemoteAgentStatus, type RemoteAgentUpdateInput, type RemoteAgentVisibility, type RemoteRunner, type RemoteRunnerListOptions, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type StreamImagesResult, type TeamMemberRef, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult };
+export { CadraClient as AISaaSClient, type CadraClientOptions as AISaaSClientOptions, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentMessage, type AgentMessageLang, type AgentMessageList, type AgentMessageRenderOptions, type AgentMessageRenderResult, AgentMessagesAPI, type AgentStatus, type AgentType, type AgentUpdateInput, type AiFunctionBilledTo, AiFunctionChargedError, type AiFunctionDescriptor, AiFunctionDuplicateError, type AiFunctionImage, type AiFunctionOutput, type AiFunctionOutputKind, type AiFunctionParameter, AiFunctionParameterError, type AiFunctionParameterIssue, type AiFunctionParameterIssueCode, type AiFunctionParameterType, type AiFunctionRef, type AiFunctionRun, type AiFunctionRunOptions, type AiFunctionRunResult, type AiFunctionRunShorthandOptions, type AiFunctionRunStatus, type AiFunctionRuntimeParams, type AiFunctionUsage, type AiFunctionVariableValue, type AiFunctionVariables, AiFunctionsAPI, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, type AttachmentUploadUrlInput, type AttachmentUploadUrlResponse, AuthenticationError, AuthorizationError, CadraClient, type CadraClientOptions, CadraError, type CollectImagesOptions, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type ExtractContext, type ImageData, type ImageEvent, type JSONSchema, type ListOptions, MESSAGE_KEY_PATTERN, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type RemoteAgent, type RemoteAgentCreateInput, type RemoteAgentExecuteResponse, type RemoteAgentExecutionTargetKind, type RemoteAgentListOptions, type RemoteAgentStatus, type RemoteAgentUpdateInput, type RemoteAgentVisibility, type RemoteRunner, type RemoteRunnerListOptions, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type StreamImagesResult, type TeamMemberRef, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult, isValidMessageKey };

package/dist/index.js

@@ -1816,13 +1816,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
@@ -3728,6 +3784,6 @@ var CadraClient = class {
   }
 };
 
-export { CadraClient as AISaaSClient, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, AiFunctionChargedError, AiFunctionDuplicateError, AiFunctionParameterError, AiFunctionsAPI, AuthenticationError, AuthorizationError, CadraClient, CadraError, ConflictError, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult };
+export { CadraClient as AISaaSClient, CadraError as AISaaSError, AI_FUNCTION_DESCRIPTOR_TTL_MS, AI_FUNCTION_RUN_TIMEOUT_MS, AgentMessagesAPI, AiFunctionChargedError, AiFunctionDuplicateError, AiFunctionParameterError, AiFunctionsAPI, AuthenticationError, AuthorizationError, CadraClient, CadraError, ConflictError, MESSAGE_KEY_PATTERN, NetworkError, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError, checkAiFunctionParameters, collectImagesFromStream, deriveImagesFromToolCalls, extractImagesFromExecutionOutput, extractImagesFromResult, isValidMessageKey };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map