@zavudev/sdk 0.54.0 → 0.56.0

package/src/resources/index.ts

@@ -10,6 +10,24 @@ export {
   type AddressListParams,
   type AddressesCursor,
 } from './addresses';
+export {
+  AgentTemplates,
+  type AgentTemplateRetrieveResponse,
+  type AgentTemplateListResponse,
+} from './agent-templates';
+export {
+  Agents,
+  type AgentCreateResponse,
+  type AgentRetrieveResponse,
+  type AgentUpdateResponse,
+  type AgentListVoicesResponse,
+  type AgentTestResponse,
+  type AgentCreateParams,
+  type AgentUpdateParams,
+  type AgentListParams,
+  type AgentListVoicesParams,
+  type AgentTestParams,
+} from './agents/agents';
 export { Balance, type BalanceRetrieveResponse } from './balance';
 export {
   Broadcasts,
@@ -37,6 +55,16 @@ export {
   type BroadcastContactsCursor,
   type BroadcastsCursor,
 } from './broadcasts/broadcasts';
+export {
+  Calls,
+  type CallCreateResponse,
+  type CallRetrieveResponse,
+  type CallListResponse,
+  type CallHangupResponse,
+  type CallCreateParams,
+  type CallListParams,
+  type CallListResponsesCursor,
+} from './calls';
 export {
   Contacts,
   type Contact,
@@ -47,6 +75,23 @@ export {
   type ContactMergeParams,
   type ContactsCursor,
 } from './contacts/contacts';
+export {
+  Conversations,
+  type ConversationRetrieveResponse,
+  type ConversationListResponse,
+  type ConversationMarkAsReadResponse,
+  type ConversationListParams,
+  type ConversationListMessagesParams,
+  type ConversationListResponsesCursor,
+} from './conversations';
+export {
+  EmailDomains,
+  type EmailDomainCreateResponse,
+  type EmailDomainRetrieveResponse,
+  type EmailDomainListResponse,
+  type EmailDomainVerifyResponse,
+  type EmailDomainCreateParams,
+} from './email-domains';
 export {
   Functions,
   type FunctionCreateResponse,
@@ -55,16 +100,23 @@ export {
   type FunctionDeleteResponse,
   type FunctionDeployResponse,
   type FunctionGetDeploymentResponse,
+  type FunctionListDeploymentsResponse,
+  type FunctionListEventTypesResponse,
+  type FunctionRollbackDeploymentResponse,
   type FunctionTailLogsResponse,
   type FunctionCreateParams,
   type FunctionUpdateParams,
   type FunctionDeployParams,
+  type FunctionListDeploymentsParams,
+  type FunctionRollbackDeploymentParams,
   type FunctionTailLogsParams,
 } from './functions/functions';
 export {
   Introspect,
   type LineType,
+  type IntrospectValidateEmailResponse,
   type IntrospectValidatePhoneResponse,
+  type IntrospectValidateEmailParams,
   type IntrospectValidatePhoneParams,
 } from './introspect';
 export {
@@ -86,6 +138,7 @@ export {
   type MessageResponse,
   type MessageStatus,
   type MessageType,
+  type MessageListAttachmentsResponse,
   type MessageShowTypingResponse,
   type MessageListParams,
   type MessageReactParams,
@@ -164,16 +217,20 @@ export {
   Templates,
   type Template,
   type WhatsappCategory,
+  type TemplateSyncResponse,
   type TemplateCreateParams,
   type TemplateListParams,
   type TemplateSubmitParams,
+  type TemplateSyncParams,
   type TemplatesCursor,
 } from './templates';
 export {
   URLs,
   type VerifiedURL,
+  type URLEscalateResponse,
   type URLRetrieveDetailsResponse,
   type URLSubmitForVerificationResponse,
+  type URLEscalateParams,
   type URLListVerifiedParams,
   type URLSubmitForVerificationParams,
   type VerifiedURLsCursor,

package/src/resources/introspect.ts

@@ -6,6 +6,32 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 export class Introspect extends APIResource {
+  /**
+   * Heuristic email validation to run before sending: catches invalid syntax, dead
+   * domains (no MX/A records), disposable inboxes, role-based addresses (info@,
+   * contacto@, sales@), and addresses already on your project's suppression list.
+   * Use it to clean a list before a broadcast and keep your bounce rate low.
+   *
+   * No mailbox-level (SMTP) probe is performed, so a `deliverable` verdict is not a
+   * delivery guarantee — it means no negative signal was found. Treat `risky`
+   * addresses with care and drop `undeliverable` ones.
+   *
+   * Accepts a single `email` or an `emails` batch (max 100 per request).
+   *
+   * @example
+   * ```ts
+   * const response = await client.introspect.validateEmail({
+   *   email: 'maria@example.com',
+   * });
+   * ```
+   */
+  validateEmail(
+    body: IntrospectValidateEmailParams,
+    options?: RequestOptions,
+  ): APIPromise<IntrospectValidateEmailResponse> {
+    return this._client.post('/v1/introspect/email', { body, ...options });
+  }
+
   /**
    * Validate a phone number and check if a WhatsApp conversation window is open.
    *
@@ -29,6 +55,71 @@ export class Introspect extends APIResource {
  */
 export type LineType = 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
 
+export interface IntrospectValidateEmailResponse {
+  /**
+   * One result per submitted address, in the same order.
+   */
+  results: Array<IntrospectValidateEmailResponse.Result>;
+
+  summary: IntrospectValidateEmailResponse.Summary;
+}
+
+export namespace IntrospectValidateEmailResponse {
+  export interface Result {
+    /**
+     * Domain part of the address. Null when the syntax is invalid.
+     */
+    domain: string | null;
+
+    /**
+     * The address exactly as submitted.
+     */
+    email: string;
+
+    /**
+     * Lowercased, trimmed form of the address. Null when the syntax is invalid.
+     */
+    normalized: string | null;
+
+    /**
+     * Signals behind the verdict. Empty for a clean `deliverable` address.
+     */
+    reasons: Array<
+      | 'invalid_syntax'
+      | 'domain_not_found'
+      | 'domain_no_mx'
+      | 'disposable_domain'
+      | 'role_address'
+      | 'suppressed_hard_bounce'
+      | 'suppressed_soft_bounce'
+      | 'suppressed_complaint'
+      | 'suppressed_manual'
+      | 'suppressed_unsubscribe'
+    >;
+
+    /**
+     * Validation verdict.
+     *
+     * - `deliverable`: nothing suggests the address will bounce.
+     * - `risky`: sendable, but a signal predicts elevated bounce/complaint odds (role
+     *   address, disposable domain, MX-less domain, prior soft bounce).
+     * - `undeliverable`: will bounce or is blocked (invalid syntax, dead domain, or
+     *   the address is on your suppression list after a hard bounce/complaint).
+     */
+    verdict: 'deliverable' | 'risky' | 'undeliverable';
+  }
+
+  export interface Summary {
+    deliverable: number;
+
+    risky: number;
+
+    total: number;
+
+    undeliverable: number;
+  }
+}
+
 export interface IntrospectValidatePhoneResponse {
   countryCode: string;
 
@@ -74,6 +165,18 @@ export namespace IntrospectValidatePhoneResponse {
   }
 }
 
+export interface IntrospectValidateEmailParams {
+  /**
+   * Single email address to validate.
+   */
+  email?: string;
+
+  /**
+   * Batch of email addresses to validate (max 100).
+   */
+  emails?: Array<string>;
+}
+
 export interface IntrospectValidatePhoneParams {
   phoneNumber: string;
 }
@@ -81,7 +184,9 @@ export interface IntrospectValidatePhoneParams {
 export declare namespace Introspect {
   export {
     type LineType as LineType,
+    type IntrospectValidateEmailResponse as IntrospectValidateEmailResponse,
     type IntrospectValidatePhoneResponse as IntrospectValidatePhoneResponse,
+    type IntrospectValidateEmailParams as IntrospectValidateEmailParams,
     type IntrospectValidatePhoneParams as IntrospectValidatePhoneParams,
   };
 }

package/src/resources/messages.ts

@@ -40,6 +40,25 @@ export class Messages extends APIResource {
     return this._client.getAPIList('/v1/messages', Cursor<Message>, { query, ...options });
   }
 
+  /**
+   * List the stored file attachments for an email message and get a short-lived
+   * signed `downloadUrl` for each. Works for both inbound emails (received via
+   * `message.inbound`) and outbound emails you sent with attachments. Messages
+   * without stored attachments (including SMS, WhatsApp, and other channels) return
+   * an empty list. Each `downloadUrl` is generated fresh per request and expires —
+   * fetch the file promptly and do not cache the URL.
+   *
+   * @example
+   * ```ts
+   * const response = await client.messages.listAttachments(
+   *   'messageId',
+   * );
+   * ```
+   */
+  listAttachments(messageID: string, options?: RequestOptions): APIPromise<MessageListAttachmentsResponse> {
+    return this._client.get(path`/v1/messages/${messageID}/attachments`, options);
+  }
+
   /**
    * Send an emoji reaction to an existing WhatsApp message. Reactions are only
    * supported for WhatsApp messages.
@@ -361,6 +380,20 @@ export interface MessageContent {
    */
   reactToMessageId?: string;
 
+  /**
+   * Click-to-WhatsApp (CTWA) ad attribution: where an inbound conversation came
+   * from.
+   *
+   * WhatsApp only. Present on the **first inbound message** of a conversation opened
+   * from a Meta ad or post, and on no message after it — so store it when it arrives
+   * rather than expecting it again. Organic conversations never carry it.
+   *
+   * Field names are camelCased to match the rest of this API; Meta sends them as
+   * snake_case (`ctwa_clid`, `source_id`, ...). Fields that do not apply are
+   * omitted: a `post` source has no click id, and an image ad has no `videoUrl`.
+   */
+  referral?: MessageContent.Referral;
+
   /**
    * Sender of the quoted message (phone number in E.164 format).
    */
@@ -450,6 +483,72 @@ export namespace MessageContent {
     phones?: Array<string>;
   }
 
+  /**
+   * Click-to-WhatsApp (CTWA) ad attribution: where an inbound conversation came
+   * from.
+   *
+   * WhatsApp only. Present on the **first inbound message** of a conversation opened
+   * from a Meta ad or post, and on no message after it — so store it when it arrives
+   * rather than expecting it again. Organic conversations never carry it.
+   *
+   * Field names are camelCased to match the rest of this API; Meta sends them as
+   * snake_case (`ctwa_clid`, `source_id`, ...). Fields that do not apply are
+   * omitted: a `post` source has no click id, and an image ad has no `videoUrl`.
+   */
+  export interface Referral {
+    /**
+     * Body copy of the ad or post.
+     */
+    body?: string;
+
+    /**
+     * Click-to-WhatsApp click identifier. This is the value Meta's Conversions API
+     * needs to credit a conversion back to the ad that produced the conversation.
+     * Present on `ad` sources; a `post` source has none.
+     */
+    ctwaClid?: string;
+
+    /**
+     * Headline of the ad or post.
+     */
+    headline?: string;
+
+    /**
+     * Image of the ad. Present when `mediaType` is `image`.
+     */
+    imageUrl?: string;
+
+    /**
+     * Type of media on the ad, when it had any.
+     */
+    mediaType?: 'image' | 'video';
+
+    /**
+     * Identifier of the ad or post that produced the click.
+     */
+    sourceId?: string;
+
+    /**
+     * Where the click came from.
+     */
+    sourceType?: 'ad' | 'post';
+
+    /**
+     * Meta permalink to the ad or post.
+     */
+    sourceUrl?: string;
+
+    /**
+     * Thumbnail of the ad media.
+     */
+    thumbnailUrl?: string;
+
+    /**
+     * Video of the ad. Present when `mediaType` is `video`.
+     */
+    videoUrl?: string;
+  }
+
   export interface Section {
     rows: Array<Section.Row>;
 
@@ -516,6 +615,52 @@ export type MessageType =
   | 'reaction'
   | 'template';
 
+export interface MessageListAttachmentsResponse {
+  items: Array<MessageListAttachmentsResponse.Item>;
+}
+
+export namespace MessageListAttachmentsResponse {
+  /**
+   * A stored file attachment for an email message (inbound or outbound).
+   */
+  export interface Item {
+    id: string;
+
+    /**
+     * Content-ID for inline attachments (referenced in the HTML body as
+     * `cid:<contentId>`). Null for regular attachments.
+     */
+    contentId: string | null;
+
+    createdAt: string;
+
+    /**
+     * Short-lived signed URL to download the attachment bytes. Freshly generated on
+     * each request and expires; do not cache it. Null if the stored file is no longer
+     * available.
+     */
+    downloadUrl: string | null;
+
+    filename: string;
+
+    /**
+     * Whether the attachment is inline (embedded in the HTML body) rather than a
+     * regular attachment.
+     */
+    isInline: boolean;
+
+    /**
+     * MIME type of the attachment.
+     */
+    mimeType: string;
+
+    /**
+     * Size of the attachment in bytes.
+     */
+    size: number;
+  }
+}
+
 export interface MessageShowTypingResponse {
   success: boolean;
 }
@@ -680,6 +825,7 @@ export declare namespace Messages {
     type MessageResponse as MessageResponse,
     type MessageStatus as MessageStatus,
     type MessageType as MessageType,
+    type MessageListAttachmentsResponse as MessageListAttachmentsResponse,
     type MessageShowTypingResponse as MessageShowTypingResponse,
     type MessagesCursor as MessagesCursor,
     type MessageListParams as MessageListParams,

package/src/resources/senders/agent/agent.ts

@@ -26,23 +26,6 @@ import {
   FlowUpdateResponse,
   Flows,
 } from './flows';
-import * as ToolsAPI from './tools';
-import {
-  AgentTool,
-  AgentToolsCursor,
-  ToolCreateParams,
-  ToolCreateResponse,
-  ToolDeleteParams,
-  ToolListParams,
-  ToolParameters,
-  ToolRetrieveParams,
-  ToolRetrieveResponse,
-  ToolTestParams,
-  ToolTestResponse,
-  ToolUpdateParams,
-  ToolUpdateResponse,
-  Tools,
-} from './tools';
 import * as KnowledgeBasesAPI from './knowledge-bases/knowledge-bases';
 import {
   AgentDocument,
@@ -58,6 +41,25 @@ import {
   KnowledgeBaseUpdateResponse,
   KnowledgeBases,
 } from './knowledge-bases/knowledge-bases';
+import * as ToolsAPI from './tools/tools';
+import {
+  AgentTool,
+  AgentToolsCursor,
+  ToolCreateParams,
+  ToolCreateResponse,
+  ToolDeleteParams,
+  ToolListParams,
+  ToolListTestRunsParams,
+  ToolListTestRunsResponse,
+  ToolParameters,
+  ToolRetrieveParams,
+  ToolRetrieveResponse,
+  ToolTestParams,
+  ToolTestResponse,
+  ToolUpdateParams,
+  ToolUpdateResponse,
+  Tools,
+} from './tools/tools';
 import { APIPromise } from '../../../core/api-promise';
 import { Cursor } from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
@@ -158,6 +160,8 @@ export class AgentResource extends APIResource {
 
 export type AgentExecutionsCursor = Cursor<AgentExecution>;
 
+export type AgentsCursor = Cursor<Agent>;
+
 /**
  * AI Agent configuration for a sender.
  */
@@ -771,6 +775,7 @@ export declare namespace AgentResource {
     type ToolCreateResponse as ToolCreateResponse,
     type ToolRetrieveResponse as ToolRetrieveResponse,
     type ToolUpdateResponse as ToolUpdateResponse,
+    type ToolListTestRunsResponse as ToolListTestRunsResponse,
     type ToolTestResponse as ToolTestResponse,
     type AgentToolsCursor as AgentToolsCursor,
     type ToolCreateParams as ToolCreateParams,
@@ -778,6 +783,7 @@ export declare namespace AgentResource {
     type ToolUpdateParams as ToolUpdateParams,
     type ToolListParams as ToolListParams,
     type ToolDeleteParams as ToolDeleteParams,
+    type ToolListTestRunsParams as ToolListTestRunsParams,
     type ToolTestParams as ToolTestParams,
   };
 

package/src/resources/senders/agent/index.ts

@@ -11,6 +11,7 @@ export {
   type AgentCreateParams,
   type AgentUpdateParams,
   type AgentExecutionsCursor,
+  type AgentsCursor,
 } from './agent';
 export {
   Executions,
@@ -57,12 +58,14 @@ export {
   type ToolCreateResponse,
   type ToolRetrieveResponse,
   type ToolUpdateResponse,
+  type ToolListTestRunsResponse,
   type ToolTestResponse,
   type ToolCreateParams,
   type ToolRetrieveParams,
   type ToolUpdateParams,
   type ToolListParams,
   type ToolDeleteParams,
+  type ToolListTestRunsParams,
   type ToolTestParams,
   type AgentToolsCursor,
-} from './tools';
+} from './tools/index';

package/src/resources/senders/agent/knowledge-bases/documents.ts

@@ -85,12 +85,69 @@ export class Documents extends APIResource {
       { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
     );
   }
+
+  /**
+   * Get a single document from a knowledge base.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.senders.agent.knowledgeBases.documents.retrieveDocument(
+   *     'docId',
+   *     { senderId: 'senderId', kbId: 'kbId' },
+   *   );
+   * ```
+   */
+  retrieveDocument(
+    docID: string,
+    params: DocumentRetrieveDocumentParams,
+    options?: RequestOptions,
+  ): APIPromise<DocumentRetrieveDocumentResponse> {
+    const { senderId, kbId } = params;
+    return this._client.get(
+      path`/v1/senders/${senderId}/agent/knowledge-bases/${kbId}/documents/${docID}`,
+      options,
+    );
+  }
+
+  /**
+   * Update a document's title or content. Updating content reprocesses the document
+   * for RAG.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.senders.agent.knowledgeBases.documents.updateDocument(
+   *     'docId',
+   *     { senderId: 'senderId', kbId: 'kbId' },
+   *   );
+   * ```
+   */
+  updateDocument(
+    docID: string,
+    params: DocumentUpdateDocumentParams,
+    options?: RequestOptions,
+  ): APIPromise<DocumentUpdateDocumentResponse> {
+    const { senderId, kbId, ...body } = params;
+    return this._client.patch(
+      path`/v1/senders/${senderId}/agent/knowledge-bases/${kbId}/documents/${docID}`,
+      { body, ...options },
+    );
+  }
 }
 
 export interface DocumentCreateResponse {
   document: KnowledgeBasesAPI.AgentDocument;
 }
 
+export interface DocumentRetrieveDocumentResponse {
+  document: KnowledgeBasesAPI.AgentDocument;
+}
+
+export interface DocumentUpdateDocumentResponse {
+  document: KnowledgeBasesAPI.AgentDocument;
+}
+
 export interface DocumentCreateParams {
   /**
    * Path param
@@ -121,12 +178,44 @@ export interface DocumentDeleteParams {
   kbId: string;
 }
 
+export interface DocumentRetrieveDocumentParams {
+  senderId: string;
+
+  kbId: string;
+}
+
+export interface DocumentUpdateDocumentParams {
+  /**
+   * Path param
+   */
+  senderId: string;
+
+  /**
+   * Path param
+   */
+  kbId: string;
+
+  /**
+   * Body param
+   */
+  content?: string;
+
+  /**
+   * Body param
+   */
+  title?: string;
+}
+
 export declare namespace Documents {
   export {
     type DocumentCreateResponse as DocumentCreateResponse,
+    type DocumentRetrieveDocumentResponse as DocumentRetrieveDocumentResponse,
+    type DocumentUpdateDocumentResponse as DocumentUpdateDocumentResponse,
     type DocumentCreateParams as DocumentCreateParams,
     type DocumentListParams as DocumentListParams,
     type DocumentDeleteParams as DocumentDeleteParams,
+    type DocumentRetrieveDocumentParams as DocumentRetrieveDocumentParams,
+    type DocumentUpdateDocumentParams as DocumentUpdateDocumentParams,
   };
 }
 

package/src/resources/senders/agent/knowledge-bases/index.ts

@@ -3,9 +3,13 @@
 export {
   Documents,
   type DocumentCreateResponse,
+  type DocumentRetrieveDocumentResponse,
+  type DocumentUpdateDocumentResponse,
   type DocumentCreateParams,
   type DocumentListParams,
   type DocumentDeleteParams,
+  type DocumentRetrieveDocumentParams,
+  type DocumentUpdateDocumentParams,
 } from './documents';
 export {
   KnowledgeBases,

package/src/resources/senders/agent/knowledge-bases/knowledge-bases.ts

@@ -7,6 +7,10 @@ import {
   DocumentCreateResponse,
   DocumentDeleteParams,
   DocumentListParams,
+  DocumentRetrieveDocumentParams,
+  DocumentRetrieveDocumentResponse,
+  DocumentUpdateDocumentParams,
+  DocumentUpdateDocumentResponse,
   Documents,
 } from './documents';
 import { APIPromise } from '../../../../core/api-promise';
@@ -244,8 +248,12 @@ export declare namespace KnowledgeBases {
   export {
     Documents as Documents,
     type DocumentCreateResponse as DocumentCreateResponse,
+    type DocumentRetrieveDocumentResponse as DocumentRetrieveDocumentResponse,
+    type DocumentUpdateDocumentResponse as DocumentUpdateDocumentResponse,
     type DocumentCreateParams as DocumentCreateParams,
     type DocumentListParams as DocumentListParams,
     type DocumentDeleteParams as DocumentDeleteParams,
+    type DocumentRetrieveDocumentParams as DocumentRetrieveDocumentParams,
+    type DocumentUpdateDocumentParams as DocumentUpdateDocumentParams,
   };
 }

package/src/resources/senders/agent/tools/index.ts

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Tools,
+  type AgentTool,
+  type ToolParameters,
+  type ToolCreateResponse,
+  type ToolRetrieveResponse,
+  type ToolUpdateResponse,
+  type ToolListTestRunsResponse,
+  type ToolTestResponse,
+  type ToolCreateParams,
+  type ToolRetrieveParams,
+  type ToolUpdateParams,
+  type ToolListParams,
+  type ToolDeleteParams,
+  type ToolListTestRunsParams,
+  type ToolTestParams,
+  type AgentToolsCursor,
+} from './tools';
+export { Webhook, type WebhookRotateSecretParams } from './webhook';