@zavudev/sdk 0.31.0 → 0.43.0

package/src/resources/number-10dlc/campaigns/index.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Campaigns,
+  type TenDlcCampaign,
+  type CampaignCreateResponse,
+  type CampaignRetrieveResponse,
+  type CampaignUpdateResponse,
+  type CampaignSubmitResponse,
+  type CampaignSyncStatusResponse,
+  type CampaignCreateParams,
+  type CampaignUpdateParams,
+  type CampaignListParams,
+  type TenDlcCampaignsCursor,
+} from './campaigns';
+export {
+  PhoneNumbers,
+  type TenDlcPhoneNumberAssignment,
+  type PhoneNumberListResponse,
+  type PhoneNumberAssignResponse,
+  type PhoneNumberAssignParams,
+  type PhoneNumberUnassignParams,
+} from './phone-numbers';

package/src/resources/number-10dlc/campaigns/phone-numbers.ts

@@ -0,0 +1,123 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class PhoneNumbers extends APIResource {
+  /**
+   * List phone numbers assigned to a 10DLC campaign.
+   *
+   * @example
+   * ```ts
+   * const phoneNumbers =
+   *   await client.number10dlc.campaigns.phoneNumbers.list(
+   *     'campaignId',
+   *   );
+   * ```
+   */
+  list(campaignID: string, options?: RequestOptions): APIPromise<PhoneNumberListResponse> {
+    return this._client.get(path`/v1/10dlc/campaigns/${campaignID}/phone-numbers`, options);
+  }
+
+  /**
+   * Assign a US phone number to an approved 10DLC campaign. The campaign must be in
+   * approved status.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.number10dlc.campaigns.phoneNumbers.assign(
+   *     'campaignId',
+   *     { phoneNumberId: 'pn_abc123' },
+   *   );
+   * ```
+   */
+  assign(
+    campaignID: string,
+    body: PhoneNumberAssignParams,
+    options?: RequestOptions,
+  ): APIPromise<PhoneNumberAssignResponse> {
+    return this._client.post(path`/v1/10dlc/campaigns/${campaignID}/phone-numbers`, { body, ...options });
+  }
+
+  /**
+   * Remove a phone number assignment from a 10DLC campaign.
+   *
+   * @example
+   * ```ts
+   * await client.number10dlc.campaigns.phoneNumbers.unassign(
+   *   'assignmentId',
+   *   { campaignId: 'campaignId' },
+   * );
+   * ```
+   */
+  unassign(
+    assignmentID: string,
+    params: PhoneNumberUnassignParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { campaignId } = params;
+    return this._client.delete(path`/v1/10dlc/campaigns/${campaignId}/phone-numbers/${assignmentID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface TenDlcPhoneNumberAssignment {
+  id: string;
+
+  campaignId: string;
+
+  createdAt: string;
+
+  phoneNumberId: string;
+
+  /**
+   * Assignment status.
+   */
+  status: 'pending' | 'active' | 'failed';
+
+  updatedAt: string;
+
+  assignedAt?: string | null;
+
+  failureReason?: string | null;
+}
+
+export interface PhoneNumberListResponse {
+  items: Array<TenDlcPhoneNumberAssignment>;
+
+  nextCursor?: string | null;
+}
+
+export interface PhoneNumberAssignResponse {
+  assignment: TenDlcPhoneNumberAssignment;
+}
+
+export interface PhoneNumberAssignParams {
+  /**
+   * ID of the phone number to assign.
+   */
+  phoneNumberId: string;
+}
+
+export interface PhoneNumberUnassignParams {
+  /**
+   * 10DLC campaign ID.
+   */
+  campaignId: string;
+}
+
+export declare namespace PhoneNumbers {
+  export {
+    type TenDlcPhoneNumberAssignment as TenDlcPhoneNumberAssignment,
+    type PhoneNumberListResponse as PhoneNumberListResponse,
+    type PhoneNumberAssignResponse as PhoneNumberAssignResponse,
+    type PhoneNumberAssignParams as PhoneNumberAssignParams,
+    type PhoneNumberUnassignParams as PhoneNumberUnassignParams,
+  };
+}

package/src/resources/number-10dlc/campaigns.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './campaigns/index';

package/src/resources/number-10dlc/index.ts

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Brands,
+  type TenDlcBrand,
+  type BrandCreateResponse,
+  type BrandRetrieveResponse,
+  type BrandUpdateResponse,
+  type BrandListUseCasesResponse,
+  type BrandSubmitResponse,
+  type BrandSyncStatusResponse,
+  type BrandCreateParams,
+  type BrandUpdateParams,
+  type BrandListParams,
+  type TenDlcBrandsCursor,
+} from './brands';
+export {
+  Campaigns,
+  type TenDlcCampaign,
+  type CampaignCreateResponse,
+  type CampaignRetrieveResponse,
+  type CampaignUpdateResponse,
+  type CampaignSubmitResponse,
+  type CampaignSyncStatusResponse,
+  type CampaignCreateParams,
+  type CampaignUpdateParams,
+  type CampaignListParams,
+  type TenDlcCampaignsCursor,
+} from './campaigns/index';
+export { Number10dlc } from './number-10dlc';

package/src/resources/number-10dlc/number-10dlc.ts

@@ -0,0 +1,71 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BrandsAPI from './brands';
+import {
+  BrandCreateParams,
+  BrandCreateResponse,
+  BrandListParams,
+  BrandListUseCasesResponse,
+  BrandRetrieveResponse,
+  BrandSubmitResponse,
+  BrandSyncStatusResponse,
+  BrandUpdateParams,
+  BrandUpdateResponse,
+  Brands,
+  TenDlcBrand,
+  TenDlcBrandsCursor,
+} from './brands';
+import * as CampaignsAPI from './campaigns/campaigns';
+import {
+  CampaignCreateParams,
+  CampaignCreateResponse,
+  CampaignListParams,
+  CampaignRetrieveResponse,
+  CampaignSubmitResponse,
+  CampaignSyncStatusResponse,
+  CampaignUpdateParams,
+  CampaignUpdateResponse,
+  Campaigns,
+  TenDlcCampaign,
+  TenDlcCampaignsCursor,
+} from './campaigns/campaigns';
+
+export class Number10dlc extends APIResource {
+  brands: BrandsAPI.Brands = new BrandsAPI.Brands(this._client);
+  campaigns: CampaignsAPI.Campaigns = new CampaignsAPI.Campaigns(this._client);
+}
+
+Number10dlc.Brands = Brands;
+Number10dlc.Campaigns = Campaigns;
+
+export declare namespace Number10dlc {
+  export {
+    Brands as Brands,
+    type TenDlcBrand as TenDlcBrand,
+    type BrandCreateResponse as BrandCreateResponse,
+    type BrandRetrieveResponse as BrandRetrieveResponse,
+    type BrandUpdateResponse as BrandUpdateResponse,
+    type BrandListUseCasesResponse as BrandListUseCasesResponse,
+    type BrandSubmitResponse as BrandSubmitResponse,
+    type BrandSyncStatusResponse as BrandSyncStatusResponse,
+    type TenDlcBrandsCursor as TenDlcBrandsCursor,
+    type BrandCreateParams as BrandCreateParams,
+    type BrandUpdateParams as BrandUpdateParams,
+    type BrandListParams as BrandListParams,
+  };
+
+  export {
+    Campaigns as Campaigns,
+    type TenDlcCampaign as TenDlcCampaign,
+    type CampaignCreateResponse as CampaignCreateResponse,
+    type CampaignRetrieveResponse as CampaignRetrieveResponse,
+    type CampaignUpdateResponse as CampaignUpdateResponse,
+    type CampaignSubmitResponse as CampaignSubmitResponse,
+    type CampaignSyncStatusResponse as CampaignSyncStatusResponse,
+    type TenDlcCampaignsCursor as TenDlcCampaignsCursor,
+    type CampaignCreateParams as CampaignCreateParams,
+    type CampaignUpdateParams as CampaignUpdateParams,
+    type CampaignListParams as CampaignListParams,
+  };
+}

package/src/resources/number-10dlc.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './number-10dlc/index';

package/src/resources/plan.ts

@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Plan extends APIResource {
+  /**
+   * Get the current subscription plan for the API key's team, including tier,
+   * billing interval, and period dates.
+   */
+  retrieve(options?: RequestOptions): APIPromise<PlanRetrieveResponse> {
+    return this._client.get('/v1/plan', options);
+  }
+}
+
+export interface PlanRetrieveResponse {
+  billingInterval: 'monthly' | 'annual';
+
+  status: 'active' | 'past_due' | 'canceled' | 'trialing';
+
+  /**
+   * Current subscription tier.
+   */
+  tier: 'free' | 'pro' | 'scale' | 'enterprise';
+
+  cancelAtPeriodEnd?: boolean;
+
+  currentPeriodEnd?: string;
+
+  currentPeriodStart?: string;
+
+  limits?: PlanRetrieveResponse.Limits;
+}
+
+export namespace PlanRetrieveResponse {
+  export interface Limits {
+    broadcasts?: boolean;
+
+    /**
+     * Monthly email limit.
+     */
+    emails?: number;
+
+    /**
+     * Monthly A2P message limit.
+     */
+    messagesA2P?: number;
+
+    phoneNumbers?: number;
+
+    senders?: number;
+
+    subAccounts?: boolean;
+
+    wabaConnections?: number;
+  }
+}
+
+export declare namespace Plan {
+  export { type PlanRetrieveResponse as PlanRetrieveResponse };
+}

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

@@ -2,7 +2,12 @@
 
 import { APIResource } from '../../../core/resource';
 import * as ExecutionsAPI from './executions';
-import { ExecutionListParams, Executions } from './executions';
+import {
+  ExecutionListParams,
+  ExecutionRetrieveParams,
+  ExecutionRetrieveResponse,
+  Executions,
+} from './executions';
 import * as FlowsAPI from './flows';
 import {
   AgentFlow,
@@ -15,6 +20,8 @@ import {
   FlowListParams,
   FlowRetrieveParams,
   FlowRetrieveResponse,
+  FlowStep,
+  FlowTrigger,
   FlowUpdateParams,
   FlowUpdateResponse,
   Flows,
@@ -27,6 +34,7 @@ import {
   ToolCreateResponse,
   ToolDeleteParams,
   ToolListParams,
+  ToolParameters,
   ToolRetrieveParams,
   ToolRetrieveResponse,
   ToolTestParams,
@@ -366,11 +374,18 @@ export declare namespace AgentResource {
     type AgentUpdateParams as AgentUpdateParams,
   };
 
-  export { Executions as Executions, type ExecutionListParams as ExecutionListParams };
+  export {
+    Executions as Executions,
+    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
+    type ExecutionRetrieveParams as ExecutionRetrieveParams,
+    type ExecutionListParams as ExecutionListParams,
+  };
 
   export {
     Flows as Flows,
     type AgentFlow as AgentFlow,
+    type FlowStep as FlowStep,
+    type FlowTrigger as FlowTrigger,
     type FlowCreateResponse as FlowCreateResponse,
     type FlowRetrieveResponse as FlowRetrieveResponse,
     type FlowUpdateResponse as FlowUpdateResponse,
@@ -387,6 +402,7 @@ export declare namespace AgentResource {
   export {
     Tools as Tools,
     type AgentTool as AgentTool,
+    type ToolParameters as ToolParameters,
     type ToolCreateResponse as ToolCreateResponse,
     type ToolRetrieveResponse as ToolRetrieveResponse,
     type ToolUpdateResponse as ToolUpdateResponse,

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

@@ -3,11 +3,34 @@
 import { APIResource } from '../../../core/resource';
 import * as AgentAPI from './agent';
 import { AgentExecutionsCursor } from './agent';
+import { APIPromise } from '../../../core/api-promise';
 import { Cursor, type CursorParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
 export class Executions extends APIResource {
+  /**
+   * Fetch full details for one execution — including `errorMessage`, `errorCode`,
+   * and `responseText`. Use this to debug failures surfaced by the list endpoint.
+   *
+   * @example
+   * ```ts
+   * const execution =
+   *   await client.senders.agent.executions.retrieve(
+   *     'executionId',
+   *     { senderId: 'senderId' },
+   *   );
+   * ```
+   */
+  retrieve(
+    executionID: string,
+    params: ExecutionRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ExecutionRetrieveResponse> {
+    const { senderId } = params;
+    return this._client.get(path`/v1/senders/${senderId}/agent/executions/${executionID}`, options);
+  }
+
   /**
    * List recent agent executions with pagination.
    *
@@ -34,6 +57,14 @@ export class Executions extends APIResource {
   }
 }
 
+export interface ExecutionRetrieveResponse {
+  execution: AgentAPI.AgentExecution;
+}
+
+export interface ExecutionRetrieveParams {
+  senderId: string;
+}
+
 export interface ExecutionListParams extends CursorParams {
   /**
    * Status of an agent execution.
@@ -42,7 +73,11 @@ export interface ExecutionListParams extends CursorParams {
 }
 
 export declare namespace Executions {
-  export { type ExecutionListParams as ExecutionListParams };
+  export {
+    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
+    type ExecutionRetrieveParams as ExecutionRetrieveParams,
+    type ExecutionListParams as ExecutionListParams,
+  };
 }
 
 export { type AgentExecutionsCursor };

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

@@ -168,54 +168,52 @@ export interface AgentFlow {
    */
   priority: number;
 
-  steps: Array<AgentFlow.Step>;
+  steps: Array<FlowStep>;
 
-  trigger: AgentFlow.Trigger;
+  trigger: FlowTrigger;
 
   updatedAt: string;
 
   description?: string | null;
 }
 
-export namespace AgentFlow {
-  export interface Step {
-    /**
-     * Unique step identifier.
-     */
-    id: string;
-
-    /**
-     * Step configuration (varies by type).
-     */
-    config: { [key: string]: unknown };
-
-    /**
-     * Type of flow step.
-     */
-    type: 'message' | 'collect' | 'condition' | 'tool' | 'llm' | 'transfer';
-
-    /**
-     * ID of the next step to execute.
-     */
-    nextStepId?: string | null;
-  }
+export interface FlowStep {
+  /**
+   * Unique step identifier.
+   */
+  id: string;
 
-  export interface Trigger {
-    /**
-     * Type of trigger for a flow.
-     */
-    type: 'keyword' | 'intent' | 'always' | 'manual';
-
-    /**
-     * Intent that triggers the flow (for intent type).
-     */
-    intent?: string;
-
-    /**
-     * Keywords that trigger the flow (for keyword type).
-     */
-    keywords?: Array<string>;
-  }
+  /**
+   * Step configuration (varies by type).
+   */
+  config: { [key: string]: unknown };
+
+  /**
+   * Type of flow step.
+   */
+  type: 'message' | 'collect' | 'condition' | 'tool' | 'llm' | 'transfer';
+
+  /**
+   * ID of the next step to execute.
+   */
+  nextStepId?: string | null;
+}
+
+export interface FlowTrigger {
+  /**
+   * Type of trigger for a flow.
+   */
+  type: 'keyword' | 'intent' | 'always' | 'manual';
+
+  /**
+   * Intent that triggers the flow (for intent type).
+   */
+  intent?: string;
+
+  /**
+   * Keywords that trigger the flow (for keyword type).
+   */
+  keywords?: Array<string>;
 }
 
 export interface FlowCreateResponse {
@@ -237,9 +235,9 @@ export interface FlowDuplicateResponse {
 export interface FlowCreateParams {
   name: string;
 
-  steps: Array<FlowCreateParams.Step>;
+  steps: Array<FlowStep>;
 
-  trigger: FlowCreateParams.Trigger;
+  trigger: FlowTrigger;
 
   description?: string;
 
@@ -248,47 +246,6 @@ export interface FlowCreateParams {
   priority?: number;
 }
 
-export namespace FlowCreateParams {
-  export interface Step {
-    /**
-     * Unique step identifier.
-     */
-    id: string;
-
-    /**
-     * Step configuration (varies by type).
-     */
-    config: { [key: string]: unknown };
-
-    /**
-     * Type of flow step.
-     */
-    type: 'message' | 'collect' | 'condition' | 'tool' | 'llm' | 'transfer';
-
-    /**
-     * ID of the next step to execute.
-     */
-    nextStepId?: string | null;
-  }
-
-  export interface Trigger {
-    /**
-     * Type of trigger for a flow.
-     */
-    type: 'keyword' | 'intent' | 'always' | 'manual';
-
-    /**
-     * Intent that triggers the flow (for intent type).
-     */
-    intent?: string;
-
-    /**
-     * Keywords that trigger the flow (for keyword type).
-     */
-    keywords?: Array<string>;
-  }
-}
-
 export interface FlowRetrieveParams {
   senderId: string;
 }
@@ -322,53 +279,12 @@ export interface FlowUpdateParams {
   /**
    * Body param
    */
-  steps?: Array<FlowUpdateParams.Step>;
+  steps?: Array<FlowStep>;
 
   /**
    * Body param
    */
-  trigger?: FlowUpdateParams.Trigger;
-}
-
-export namespace FlowUpdateParams {
-  export interface Step {
-    /**
-     * Unique step identifier.
-     */
-    id: string;
-
-    /**
-     * Step configuration (varies by type).
-     */
-    config: { [key: string]: unknown };
-
-    /**
-     * Type of flow step.
-     */
-    type: 'message' | 'collect' | 'condition' | 'tool' | 'llm' | 'transfer';
-
-    /**
-     * ID of the next step to execute.
-     */
-    nextStepId?: string | null;
-  }
-
-  export interface Trigger {
-    /**
-     * Type of trigger for a flow.
-     */
-    type: 'keyword' | 'intent' | 'always' | 'manual';
-
-    /**
-     * Intent that triggers the flow (for intent type).
-     */
-    intent?: string;
-
-    /**
-     * Keywords that trigger the flow (for keyword type).
-     */
-    keywords?: Array<string>;
-  }
+  trigger?: FlowTrigger;
 }
 
 export interface FlowListParams extends CursorParams {
@@ -394,6 +310,8 @@ export interface FlowDuplicateParams {
 export declare namespace Flows {
   export {
     type AgentFlow as AgentFlow,
+    type FlowStep as FlowStep,
+    type FlowTrigger as FlowTrigger,
     type FlowCreateResponse as FlowCreateResponse,
     type FlowRetrieveResponse as FlowRetrieveResponse,
     type FlowUpdateResponse as FlowUpdateResponse,

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

@@ -12,10 +12,17 @@ export {
   type AgentUpdateParams,
   type AgentExecutionsCursor,
 } from './agent';
-export { Executions, type ExecutionListParams } from './executions';
+export {
+  Executions,
+  type ExecutionRetrieveResponse,
+  type ExecutionRetrieveParams,
+  type ExecutionListParams,
+} from './executions';
 export {
   Flows,
   type AgentFlow,
+  type FlowStep,
+  type FlowTrigger,
   type FlowCreateResponse,
   type FlowRetrieveResponse,
   type FlowUpdateResponse,
@@ -46,6 +53,7 @@ export {
 export {
   Tools,
   type AgentTool,
+  type ToolParameters,
   type ToolCreateResponse,
   type ToolRetrieveResponse,
   type ToolUpdateResponse,