@zavudev/sdk 0.56.0 → 0.58.0

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

@@ -1,26 +1,22 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 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 { Cursor, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
+import type * as T from '../../../types';
+import * as AgentAPI from './agent';
+import { type AgentExecutionsCursor } from './agent';
 
 export class Executions extends APIResource {
   /**
+   * Get a single agent execution
+   *
    * 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' },
-   *   );
-   * ```
+   * `GET /v1/senders/{senderId}/agent/executions/{executionId}`
    */
   retrieve(
     executionID: string,
@@ -32,6 +28,8 @@ export class Executions extends APIResource {
   }
 
   /**
+   * List agent executions
+   *
    * List recent agent executions with pagination.
    *
    * An execution is one inbound message answered by the agent, so this covers the
@@ -39,15 +37,7 @@ export class Executions extends APIResource {
    * many the agent handled. Use `GET /v1/calls` (and `GET /v1/calls/{callId}` for
    * the transcript) for voice.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const agentExecution of client.senders.agent.executions.list(
-   *   'senderId',
-   * )) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/senders/{senderId}/agent/executions`
    */
   list(
     senderID: string,
@@ -62,20 +52,11 @@ export class Executions extends APIResource {
   }
 }
 
-export interface ExecutionRetrieveResponse {
-  execution: AgentAPI.AgentExecution;
-}
+export type ExecutionRetrieveResponse = T.GetAgentExecutionResponse;
 
-export interface ExecutionRetrieveParams {
-  senderId: string;
-}
+export type ExecutionRetrieveParams = T.SendersAgentExecutionsRetrieveParams;
 
-export interface ExecutionListParams extends CursorParams {
-  /**
-   * Status of an agent execution.
-   */
-  status?: AgentAPI.AgentExecutionStatus;
-}
+export type ExecutionListParams = T.SendersAgentExecutionsListParams;
 
 export declare namespace Executions {
   export {
@@ -84,5 +65,3 @@ export declare namespace Executions {
     type ExecutionListParams as ExecutionListParams,
   };
 }
-
-export { type AgentExecutionsCursor };

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

@@ -1,63 +1,31 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../../core/resource';
 import { APIPromise } from '../../../core/api-promise';
-import { Cursor, type CursorParams, PagePromise } from '../../../core/pagination';
+import { Cursor, PagePromise } from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
+import type * as T from '../../../types';
 
 export class Flows extends APIResource {
   /**
+   * Create flow
+   *
    * Create a new flow for an agent.
    *
-   * @example
-   * ```ts
-   * const flow = await client.senders.agent.flows.create(
-   *   'senderId',
-   *   {
-   *     name: 'Lead Capture',
-   *     steps: [
-   *       {
-   *         id: 'welcome',
-   *         type: 'message',
-   *         config: {
-   *           text: 'Thanks for your interest! Let me get some info.',
-   *         },
-   *         nextStepId: 'ask_name',
-   *       },
-   *       {
-   *         id: 'ask_name',
-   *         type: 'collect',
-   *         config: {
-   *           variable: 'name',
-   *           prompt: "What's your name?",
-   *         },
-   *       },
-   *     ],
-   *     trigger: {
-   *       type: 'keyword',
-   *       keywords: ['info', 'pricing', 'demo'],
-   *     },
-   *     description: 'Capture lead information',
-   *   },
-   * );
-   * ```
+   * `POST /v1/senders/{senderId}/agent/flows`
    */
   create(senderID: string, body: FlowCreateParams, options?: RequestOptions): APIPromise<FlowCreateResponse> {
     return this._client.post(path`/v1/senders/${senderID}/agent/flows`, { body, ...options });
   }
 
   /**
+   * Get flow
+   *
    * Get a specific flow.
    *
-   * @example
-   * ```ts
-   * const flow = await client.senders.agent.flows.retrieve(
-   *   'flowId',
-   *   { senderId: 'senderId' },
-   * );
-   * ```
+   * `GET /v1/senders/{senderId}/agent/flows/{flowId}`
    */
   retrieve(
     flowID: string,
@@ -69,15 +37,11 @@ export class Flows extends APIResource {
   }
 
   /**
+   * Update flow
+   *
    * Update a flow.
    *
-   * @example
-   * ```ts
-   * const flow = await client.senders.agent.flows.update(
-   *   'flowId',
-   *   { senderId: 'senderId' },
-   * );
-   * ```
+   * `PATCH /v1/senders/{senderId}/agent/flows/{flowId}`
    */
   update(flowID: string, params: FlowUpdateParams, options?: RequestOptions): APIPromise<FlowUpdateResponse> {
     const { senderId, ...body } = params;
@@ -85,17 +49,11 @@ export class Flows extends APIResource {
   }
 
   /**
+   * List flows
+   *
    * List flows for an agent.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const agentFlow of client.senders.agent.flows.list(
-   *   'senderId',
-   * )) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/senders/{senderId}/agent/flows`
    */
   list(
     senderID: string,
@@ -109,14 +67,11 @@ export class Flows extends APIResource {
   }
 
   /**
+   * Delete flow
+   *
    * Delete a flow. Cannot delete flows with active sessions.
    *
-   * @example
-   * ```ts
-   * await client.senders.agent.flows.delete('flowId', {
-   *   senderId: 'senderId',
-   * });
-   * ```
+   * `DELETE /v1/senders/{senderId}/agent/flows/{flowId}`
    */
   delete(flowID: string, params: FlowDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { senderId } = params;
@@ -127,15 +82,11 @@ export class Flows extends APIResource {
   }
 
   /**
+   * Duplicate flow
+   *
    * Create a copy of an existing flow with a new name.
    *
-   * @example
-   * ```ts
-   * const response = await client.senders.agent.flows.duplicate(
-   *   'flowId',
-   *   { senderId: 'senderId', newName: 'Lead Capture (Copy)' },
-   * );
-   * ```
+   * `POST /v1/senders/{senderId}/agent/flows/{flowId}/duplicate`
    */
   duplicate(
     flowID: string,
@@ -150,162 +101,33 @@ export class Flows extends APIResource {
   }
 }
 
-export type AgentFlowsCursor = Cursor<AgentFlow>;
-
-export interface AgentFlow {
-  id: string;
-
-  agentId: string;
-
-  createdAt: string;
-
-  enabled: boolean;
-
-  name: string;
-
-  /**
-   * Priority when multiple flows match (higher = more priority).
-   */
-  priority: number;
-
-  steps: Array<FlowStep>;
-
-  trigger: FlowTrigger;
-
-  updatedAt: string;
-
-  description?: string | null;
-}
-
-export interface FlowStep {
-  /**
-   * Unique step identifier.
-   */
-  id: string;
+export type AgentFlowsCursor = Cursor<T.AgentFlow>;
 
-  /**
-   * Step configuration (varies by type).
-   */
-  config: { [key: string]: unknown };
+export type AgentFlow = T.AgentFlow;
 
-  /**
-   * Type of flow step.
-   */
-  type: 'message' | 'collect' | 'condition' | 'tool' | 'llm' | 'transfer';
+export type FlowStep = T.FlowStep;
 
-  /**
-   * ID of the next step to execute.
-   */
-  nextStepId?: string | null;
-}
+export type FlowTrigger = T.FlowTrigger;
 
-export interface FlowTrigger {
-  /**
-   * Type of trigger for a flow.
-   */
-  type: 'keyword' | 'intent' | 'always' | 'manual';
+export type FlowCreateResponse = T.FlowResponse;
 
-  /**
-   * Intent that triggers the flow (for intent type).
-   */
-  intent?: string;
+export type FlowRetrieveResponse = T.FlowResponse;
 
-  /**
-   * Keywords that trigger the flow (for keyword type).
-   */
-  keywords?: Array<string>;
-}
+export type FlowUpdateResponse = T.FlowResponse;
 
-export interface FlowCreateResponse {
-  flow: AgentFlow;
-}
+export type FlowDuplicateResponse = T.FlowResponse;
 
-export interface FlowRetrieveResponse {
-  flow: AgentFlow;
-}
+export type FlowCreateParams = T.SendersAgentFlowsCreateParams;
 
-export interface FlowUpdateResponse {
-  flow: AgentFlow;
-}
+export type FlowRetrieveParams = T.SendersAgentFlowsRetrieveParams;
 
-export interface FlowDuplicateResponse {
-  flow: AgentFlow;
-}
+export type FlowUpdateParams = T.SendersAgentFlowsUpdateParams;
 
-export interface FlowCreateParams {
-  name: string;
+export type FlowListParams = T.SendersAgentFlowsListParams;
 
-  steps: Array<FlowStep>;
+export type FlowDeleteParams = T.SendersAgentFlowsDeleteParams;
 
-  trigger: FlowTrigger;
-
-  description?: string;
-
-  enabled?: boolean;
-
-  priority?: number;
-}
-
-export interface FlowRetrieveParams {
-  senderId: string;
-}
-
-export interface FlowUpdateParams {
-  /**
-   * Path param
-   */
-  senderId: string;
-
-  /**
-   * Body param
-   */
-  description?: string;
-
-  /**
-   * Body param
-   */
-  enabled?: boolean;
-
-  /**
-   * Body param
-   */
-  name?: string;
-
-  /**
-   * Body param
-   */
-  priority?: number;
-
-  /**
-   * Body param
-   */
-  steps?: Array<FlowStep>;
-
-  /**
-   * Body param
-   */
-  trigger?: FlowTrigger;
-}
-
-export interface FlowListParams extends CursorParams {
-  enabled?: boolean;
-}
-
-export interface FlowDeleteParams {
-  senderId: string;
-}
-
-export interface FlowDuplicateParams {
-  /**
-   * Path param
-   */
-  senderId: string;
-
-  /**
-   * Body param
-   */
-  newName: string;
-}
+export type FlowDuplicateParams = T.SendersAgentFlowsDuplicateParams;
 
 export declare namespace Flows {
   export {

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

@@ -1,4 +1,4 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export {
   AgentResource,

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

@@ -1,32 +1,23 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../../../core/resource';
-import * as KnowledgeBasesAPI from './knowledge-bases';
-import { AgentDocumentsCursor } from './knowledge-bases';
 import { APIPromise } from '../../../../core/api-promise';
-import { Cursor, type CursorParams, PagePromise } from '../../../../core/pagination';
+import { Cursor, PagePromise } from '../../../../core/pagination';
 import { buildHeaders } from '../../../../internal/headers';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
+import type * as T from '../../../../types';
+import * as KnowledgeBasesAPI from './knowledge-bases';
+import { type AgentDocumentsCursor } from './knowledge-bases';
 
 export class Documents extends APIResource {
   /**
+   * Create document
+   *
    * Add a document to a knowledge base. The document will be automatically processed
    * for RAG.
    *
-   * @example
-   * ```ts
-   * const document =
-   *   await client.senders.agent.knowledgeBases.documents.create(
-   *     'kbId',
-   *     {
-   *       senderId: 'senderId',
-   *       content:
-   *         'Our return policy allows returns within 30 days of purchase...',
-   *       title: 'Return Policy',
-   *     },
-   *   );
-   * ```
+   * `POST /v1/senders/{senderId}/agent/knowledge-bases/{kbId}/documents`
    */
   create(
     kbID: string,
@@ -41,18 +32,11 @@ export class Documents extends APIResource {
   }
 
   /**
+   * List documents
+   *
    * List documents in a knowledge base.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const agentDocument of client.senders.agent.knowledgeBases.documents.list(
-   *   'kbId',
-   *   { senderId: 'senderId' },
-   * )) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/senders/{senderId}/agent/knowledge-bases/{kbId}/documents`
    */
   list(
     kbID: string,
@@ -68,15 +52,11 @@ export class Documents extends APIResource {
   }
 
   /**
+   * Delete document
+   *
    * Delete a document from a knowledge base.
    *
-   * @example
-   * ```ts
-   * await client.senders.agent.knowledgeBases.documents.delete(
-   *   'docId',
-   *   { senderId: 'senderId', kbId: 'kbId' },
-   * );
-   * ```
+   * `DELETE /v1/senders/{senderId}/agent/knowledge-bases/{kbId}/documents/{docId}`
    */
   delete(docID: string, params: DocumentDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { senderId, kbId } = params;
@@ -87,16 +67,11 @@ export class Documents extends APIResource {
   }
 
   /**
+   * Get document
+   *
    * Get a single document from a knowledge base.
    *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.senders.agent.knowledgeBases.documents.retrieveDocument(
-   *     'docId',
-   *     { senderId: 'senderId', kbId: 'kbId' },
-   *   );
-   * ```
+   * `GET /v1/senders/{senderId}/agent/knowledge-bases/{kbId}/documents/{docId}`
    */
   retrieveDocument(
     docID: string,
@@ -111,17 +86,12 @@ export class Documents extends APIResource {
   }
 
   /**
+   * Update document
+   *
    * 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' },
-   *   );
-   * ```
+   * `PATCH /v1/senders/{senderId}/agent/knowledge-bases/{kbId}/documents/{docId}`
    */
   updateDocument(
     docID: string,
@@ -136,75 +106,21 @@ export class Documents extends APIResource {
   }
 }
 
-export interface DocumentCreateResponse {
-  document: KnowledgeBasesAPI.AgentDocument;
-}
+export type DocumentCreateResponse = T.DocumentResponse;
 
-export interface DocumentRetrieveDocumentResponse {
-  document: KnowledgeBasesAPI.AgentDocument;
-}
+export type DocumentRetrieveDocumentResponse = T.DocumentResponse;
 
-export interface DocumentUpdateDocumentResponse {
-  document: KnowledgeBasesAPI.AgentDocument;
-}
+export type DocumentUpdateDocumentResponse = T.DocumentResponse;
 
-export interface DocumentCreateParams {
-  /**
-   * Path param
-   */
-  senderId: string;
+export type DocumentCreateParams = T.SendersAgentKnowledgeBasesDocumentsCreateParams;
 
-  /**
-   * Body param
-   */
-  content: string;
+export type DocumentListParams = T.SendersAgentKnowledgeBasesDocumentsListParams;
 
-  /**
-   * Body param
-   */
-  title: string;
-}
+export type DocumentDeleteParams = T.SendersAgentKnowledgeBasesDocumentsDeleteParams;
 
-export interface DocumentListParams extends CursorParams {
-  /**
-   * Path param
-   */
-  senderId: string;
-}
+export type DocumentRetrieveDocumentParams = T.SendersAgentKnowledgeBasesDocumentsRetrieveDocumentParams;
 
-export interface DocumentDeleteParams {
-  senderId: string;
-
-  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 type DocumentUpdateDocumentParams = T.SendersAgentKnowledgeBasesDocumentsUpdateDocumentParams;
 
 export declare namespace Documents {
   export {
@@ -218,5 +134,3 @@ export declare namespace Documents {
     type DocumentUpdateDocumentParams as DocumentUpdateDocumentParams,
   };
 }
-
-export { type AgentDocumentsCursor };

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

@@ -1,4 +1,4 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export {
   Documents,