@cadraos/sdk 0.3.15 → 0.3.16-dev.1

package/dist/index.cjs

@@ -1818,13 +1818,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
@@ -3734,6 +3790,7 @@ exports.AISaaSClient = CadraClient;
 exports.AISaaSError = CadraError;
 exports.AI_FUNCTION_DESCRIPTOR_TTL_MS = AI_FUNCTION_DESCRIPTOR_TTL_MS;
 exports.AI_FUNCTION_RUN_TIMEOUT_MS = AI_FUNCTION_RUN_TIMEOUT_MS;
+exports.AgentMessagesAPI = AgentMessagesAPI;
 exports.AiFunctionChargedError = AiFunctionChargedError;
 exports.AiFunctionDuplicateError = AiFunctionDuplicateError;
 exports.AiFunctionParameterError = AiFunctionParameterError;
@@ -3743,6 +3800,7 @@ exports.AuthorizationError = AuthorizationError;
 exports.CadraClient = CadraClient;
 exports.CadraError = CadraError;
 exports.ConflictError = ConflictError;
+exports.MESSAGE_KEY_PATTERN = MESSAGE_KEY_PATTERN;
 exports.NetworkError = NetworkError;
 exports.NotFoundError = NotFoundError;
 exports.RateLimitError = RateLimitError;
@@ -3754,5 +3812,6 @@ exports.collectImagesFromStream = collectImagesFromStream;
 exports.deriveImagesFromToolCalls = deriveImagesFromToolCalls;
 exports.extractImagesFromExecutionOutput = extractImagesFromExecutionOutput;
 exports.extractImagesFromResult = extractImagesFromResult;
+exports.isValidMessageKey = isValidMessageKey;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map