@getsupervisor/agents-studio-sdk 1.2.0 → 1.4.0

package/dist/index.d.cts

@@ -21,6 +21,22 @@ type paths = {
         get: operations["listAgentInstructions"];
         post: operations["createAgentInstruction"];
     };
+    "/v1/agents/{agentId}/instructions/{instructionId}": {
+        patch: operations["updateAgentInstruction"];
+    };
+    "/v1/agents/{agentId}/schedule": {
+        get: operations["getAgentSchedule"];
+        put: operations["updateAgentSchedule"];
+    };
+    "/v1/agents/{agentId}/versions": {
+        get: operations["listAgentVersions"];
+        post: operations["createAgentVersion"];
+    };
+    "/v1/agents/{agentId}/versions/{versionId}": {
+        get: operations["getAgentVersion"];
+        delete: operations["deleteAgentInstruction"];
+        patch: operations["updateAgentVersion"];
+    };
     "/v1/agents/{agentId}/phones": {
         post: operations["connectAgentPhone"];
     };
@@ -39,6 +55,9 @@ type paths = {
     "/v1/tools/{toolId}/execute": {
         post: operations["executeTool"];
     };
+    "/v1/voices": {
+        get: operations["listVoices"];
+    };
 };
 type components = {
     schemas: {
@@ -65,6 +84,16 @@ type components = {
             limit: number;
             hasNext: boolean;
         };
+        QueryValue: string | number | boolean | string[];
+        QueryFilterOperators: {
+            [key: string]: components["schemas"]["QueryValue"];
+        };
+        QueryFilters: {
+            [key: string]: components["schemas"]["QueryValue"] | components["schemas"]["QueryFilterOperators"];
+        };
+        QueryOrGroups: {
+            [key: string]: components["schemas"]["QueryFilters"];
+        };
         AgentSummary: {
             agentId: string;
             name: string;
@@ -149,6 +178,88 @@ type components = {
             order: number;
             createdAt: string;
         };
+        UpdateInstructionRequest: {
+            order?: number;
+            content?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        VoiceSummary: {
+            id: string;
+            providerVoiceId?: string;
+            name: string;
+            gender?: "female" | "male" | "neutral";
+            locale: string;
+            tags?: string[];
+            previewUrl?: string;
+            provider: string;
+        };
+        VoiceListResponse: {
+            data: components["schemas"]["VoiceSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        AgentScheduleSlot: {
+            startTime: string;
+            endTime: string;
+        };
+        AgentScheduleRule: {
+            dayOfWeek: "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday";
+            slots: components["schemas"]["AgentScheduleSlot"][];
+            isClosed?: boolean;
+        };
+        AgentSchedule: {
+            agentId: string;
+            timezone: string;
+            rules: components["schemas"]["AgentScheduleRule"][];
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        UpdateAgentScheduleRequest: {
+            timezone: string;
+            rules: components["schemas"]["AgentScheduleRule"][];
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        AgentVersionSummary: {
+            versionId: string;
+            agentId: string;
+            label: string;
+            status: "draft" | "published" | "archived";
+            isActive?: boolean;
+            createdAt: string;
+            updatedAt?: string;
+            publishedAt?: string | null;
+        };
+        AgentVersionDetail: components["schemas"]["AgentVersionSummary"] & {
+            description?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+            instructionsVersionId?: string;
+        };
+        AgentVersionListResponse: {
+            data: components["schemas"]["AgentVersionSummary"][];
+            meta?: components["schemas"]["PaginationMeta"];
+        };
+        CreateAgentVersionRequest: {
+            label: string;
+            description?: string;
+            sourceVersionId?: string;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        UpdateAgentVersionRequest: {
+            label?: string;
+            description?: string;
+            status?: "draft" | "published" | "archived";
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
         ConnectPhoneRequest: {
             agent_id: string;
             phone_id: string;
@@ -224,8 +335,18 @@ type components = {
         XWorkspaceId: string;
         AgentId: string;
         PhoneId: string;
+        InstructionId: string;
+        VersionId: string;
         WorkspaceId: string;
         ToolId: string;
+        PageParam?: number;
+        LimitParam?: number;
+        SortParam?: string;
+        FieldsParam?: string;
+        IncludeParam?: string;
+        SearchParam?: string;
+        FilterParam?: components["schemas"]["QueryFilters"];
+        OrParam?: components["schemas"]["QueryOrGroups"];
     };
     requestBodies: never;
     headers: never;
@@ -234,6 +355,16 @@ type components = {
 type operations = {
     listAgents: {
         parameters: {
+            query?: {
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
             header: {
                 "x-workspace-id": components["parameters"]["XWorkspaceId"];
             };
@@ -393,6 +524,16 @@ type operations = {
     };
     listAgentKnowledgeBases: {
         parameters: {
+            query?: {
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
             header: {
                 "x-workspace-id": components["parameters"]["XWorkspaceId"];
             };
@@ -418,6 +559,16 @@ type operations = {
     };
     listAgentKnowledgeUploads: {
         parameters: {
+            query?: {
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
             header: {
                 "x-workspace-id": components["parameters"]["XWorkspaceId"];
             };
@@ -437,6 +588,13 @@ type operations = {
         parameters: {
             query?: {
                 versionId?: string;
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
             };
             header: {
                 "x-workspace-id": components["parameters"]["XWorkspaceId"];
@@ -493,6 +651,225 @@ type operations = {
             };
         };
     };
+    updateAgentInstruction: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+                instructionId: components["parameters"]["InstructionId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateInstructionRequest"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["Instruction"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAgentSchedule: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentSchedule"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateAgentSchedule: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAgentScheduleRequest"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentSchedule"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listAgentVersions: {
+        parameters: {
+            query?: {
+                status?: "draft" | "published" | "archived";
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentVersionListResponse"];
+                };
+            };
+        };
+    };
+    createAgentVersion: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAgentVersionRequest"];
+            };
+        };
+        responses: {
+            201: {
+                content: {
+                    "application/json": components["schemas"]["AgentVersionDetail"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAgentVersion: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+                versionId: components["parameters"]["VersionId"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentVersionDetail"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    deleteAgentInstruction: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+                instructionId: components["parameters"]["InstructionId"];
+            };
+        };
+        responses: {
+            204: {
+                content: never;
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateAgentVersion: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+                versionId: components["parameters"]["VersionId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAgentVersionRequest"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentVersionDetail"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     connectAgentPhone: {
         parameters: {
             header: {
@@ -560,6 +937,14 @@ type operations = {
         parameters: {
             query?: {
                 channel?: "voice";
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
             };
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
@@ -603,6 +988,18 @@ type operations = {
         };
     };
     listTools: {
+        parameters: {
+            query?: {
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
+        };
         responses: {
             200: {
                 content: {
@@ -647,8 +1044,67 @@ type operations = {
             };
         };
     };
+    listVoices: {
+        parameters: {
+            query?: {
+                agentId?: string;
+                agentVersionId?: string;
+                gender?: "female" | "male" | "neutral";
+                locale?: string;
+                page?: components["parameters"]["PageParam"];
+                limit?: components["parameters"]["LimitParam"];
+                sort?: components["parameters"]["SortParam"];
+                fields?: components["parameters"]["FieldsParam"];
+                include?: components["parameters"]["IncludeParam"];
+                q?: components["parameters"]["SearchParam"];
+                filter?: components["parameters"]["FilterParam"];
+                or?: components["parameters"]["OrParam"];
+            };
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["VoiceListResponse"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
 };
 
+type QueryValue = components['schemas']['QueryValue'];
+type QueryFilterOperators = components['schemas']['QueryFilterOperators'];
+type QueryFilters = components['schemas']['QueryFilters'];
+type QueryOrGroups = components['schemas']['QueryOrGroups'];
+type PaginationMeta = components['schemas']['PaginationMeta'];
+type QueryBuilderSerializable = {
+    build: () => string;
+    toString?: () => string;
+};
+type QueryBuilderInput = string | QueryBuilderSerializable | undefined | null;
+type ListQueryOptions = Partial<{
+    page: number;
+    limit: number;
+    sort: string | string[];
+    fields: string | string[];
+    include: string | string[];
+    search: string;
+    filter: QueryFilters | QueryBuilderInput;
+    or: QueryOrGroups | QueryBuilderInput;
+}>;
+type PaginatedResult<TResponse, TOptions extends ListQueryOptions> = TResponse & {
+    next(): Promise<PaginatedResult<TResponse, TOptions> | null>;
+    prev(): Promise<PaginatedResult<TResponse, TOptions> | null>;
+    page(page: number): Promise<PaginatedResult<TResponse, TOptions>>;
+    reload(): Promise<PaginatedResult<TResponse, TOptions>>;
+};
 type ClientConfig = {
     baseUrl: string;
     headers?: Record<string, string>;
@@ -675,6 +1131,7 @@ type Instruction = components['schemas']['Instruction'];
 type CreateInstructionRequest = components['schemas']['CreateInstructionRequest'];
 type InstructionCreatedResponse = components['schemas']['InstructionCreatedResponse'];
 type AgentInstructionsResponse = paths['/v1/agents/{agentId}/instructions']['get']['responses'][200]['content']['application/json'];
+type UpdateInstructionRequest = components['schemas']['UpdateInstructionRequest'];
 type ConnectPhoneRequest = components['schemas']['ConnectPhoneRequest'];
 type PhoneAssignmentResponse = components['schemas']['PhoneAssignmentResponse'];
 type WorkspacePhone = components['schemas']['WorkspacePhone'];
@@ -682,6 +1139,15 @@ type WorkspacePhonesResponse = components['schemas']['WorkspacePhonesResponse'];
 type WorkspacePhoneChannel = 'voice';
 type WorkspaceEnableRequest = components['schemas']['WorkspaceEnableRequest'];
 type WorkspaceEnableResponse = components['schemas']['WorkspaceEnableResponse'];
+type VoiceSummary = components['schemas']['VoiceSummary'];
+type VoiceListResponse = components['schemas']['VoiceListResponse'];
+type AgentSchedule = components['schemas']['AgentSchedule'];
+type UpdateAgentScheduleRequest = components['schemas']['UpdateAgentScheduleRequest'];
+type AgentVersionSummary = components['schemas']['AgentVersionSummary'];
+type AgentVersionDetail = components['schemas']['AgentVersionDetail'];
+type AgentVersionListResponse = components['schemas']['AgentVersionListResponse'];
+type CreateAgentVersionRequest = components['schemas']['CreateAgentVersionRequest'];
+type UpdateAgentVersionRequest = components['schemas']['UpdateAgentVersionRequest'];
 type ToolSummary = components['schemas']['ToolSummary'];
 type ExecuteToolRequest = components['schemas']['ExecuteToolRequest'];
 type ExecuteToolResponse = components['schemas']['ExecuteToolResponse'];
@@ -712,21 +1178,25 @@ type RetryPolicy = {
     retryOn?: (err: unknown, attempt: number) => boolean;
 };
 
+type ListAgentInstructionsOptions = ListQueryOptions & {
+    versionId?: string;
+};
 declare function createAgentInstructionsApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
-    list(agentId: string, opts?: {
-        versionId?: string;
-    }): Promise<AgentInstructionsResponse>;
+    list(agentId: string, opts?: ListAgentInstructionsOptions): Promise<PaginatedResult<AgentInstructionsResponse, ListAgentInstructionsOptions>>;
     create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
+    update(agentId: string, instructionId: string, payload: UpdateInstructionRequest): Promise<Instruction>;
+    delete(agentId: string, instructionId: string): Promise<void>;
 };
 
+type ListAgentKnowledgeOptions = ListQueryOptions;
 declare function createAgentKnowledgeApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
     upload(agentId: string, payload: KnowledgeUploadRequest): Promise<KnowledgeUploadResponse>;
-    listBases(agentId: string): Promise<AgentKnowledgeBasesResponse>;
-    listUploads(agentId: string): Promise<AgentKnowledgeUploadsResponse>;
+    listBases(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeBasesResponse, ListAgentKnowledgeOptions>>;
+    listUploads(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeUploadsResponse, ListAgentKnowledgeOptions>>;
 };
 
 declare function createAgentPhonesApi(cfg: ClientConfig & {
@@ -736,37 +1206,76 @@ declare function createAgentPhonesApi(cfg: ClientConfig & {
     disconnect(agentId: string, phoneId: string): Promise<void>;
 };
 
+declare function createAgentScheduleApi(cfg: ClientConfig & {
+    retry?: RetryPolicy;
+}): {
+    get(agentId: string): Promise<AgentSchedule>;
+    update(agentId: string, payload: UpdateAgentScheduleRequest): Promise<AgentSchedule>;
+};
+
+type ListAgentVersionsOptions = {
+    status?: 'draft' | 'published' | 'archived';
+} & ListQueryOptions;
+declare function createAgentVersionsApi(cfg: ClientConfig & {
+    retry?: RetryPolicy;
+}): {
+    list(agentId: string, opts?: ListAgentVersionsOptions): Promise<PaginatedResult<AgentVersionListResponse, ListAgentVersionsOptions>>;
+    get(agentId: string, versionId: string): Promise<AgentVersionDetail>;
+    create(agentId: string, payload: CreateAgentVersionRequest): Promise<AgentVersionDetail>;
+    update(agentId: string, versionId: string, payload: UpdateAgentVersionRequest): Promise<AgentVersionDetail>;
+};
+
 type AgentInstructionsApi = ReturnType<typeof createAgentInstructionsApi>;
 type AgentKnowledgeApi = ReturnType<typeof createAgentKnowledgeApi>;
 type AgentPhonesApi = ReturnType<typeof createAgentPhonesApi>;
+type AgentScheduleApi = ReturnType<typeof createAgentScheduleApi>;
+type AgentVersionsApi = ReturnType<typeof createAgentVersionsApi>;
 type AgentInstructionsHelper = ReturnType<typeof bindAgentInstructions>;
 type AgentKnowledgeHelper = ReturnType<typeof bindAgentKnowledge>;
 type AgentPhonesHelper = ReturnType<typeof bindAgentPhones>;
-interface AgentEntity extends AgentDetail {
+type AgentScheduleHelper = ReturnType<typeof bindAgentSchedule>;
+type AgentVersionsHelper = ReturnType<typeof bindAgentVersions>;
+type AgentBase = AgentSummary & Partial<Omit<AgentDetail, keyof AgentSummary>>;
+interface AgentEntity extends AgentBase {
     instructions: AgentInstructionsHelper;
     knowledge: AgentKnowledgeHelper;
     phones: AgentPhonesHelper;
+    schedule: AgentScheduleHelper;
+    versions: AgentVersionsHelper;
+    save(patch: UpdateAgentRequest): Promise<AgentEntity>;
+    delete(): Promise<void>;
     refresh(): Promise<AgentEntity>;
 }
 type AgentEntityFactoryOptions = {
     instructionsApi: AgentInstructionsApi;
     knowledgeApi: AgentKnowledgeApi;
     phonesApi: AgentPhonesApi;
+    scheduleApi: AgentScheduleApi;
+    versionsApi: AgentVersionsApi;
     reload(agentId: string): Promise<AgentEntity>;
+    updateAgent(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
+    deleteAgent(agentId: string): Promise<void>;
 };
 declare const bindAgentInstructions: (api: AgentInstructionsApi, agentId: string) => {
-    list(opts?: {
-        versionId?: string;
-    }): Promise<{
+    list(opts?: ListAgentInstructionsOptions): Promise<PaginatedResult<{
         data: components["schemas"]["Instruction"][];
         versionId?: string;
-    }>;
+    }, ListAgentInstructionsOptions>>;
     create(payload: CreateInstructionRequest): Promise<{
         id: string;
         versionId: string;
         order: number;
         createdAt: string;
     }>;
+    update(instructionId: string, payload: UpdateInstructionRequest): Promise<{
+        id: string;
+        versionId: string;
+        order: number;
+        content: string;
+        createdAt?: string;
+        updatedAt?: string;
+    }>;
+    delete(instructionId: string): Promise<void>;
 };
 declare const bindAgentKnowledge: (api: AgentKnowledgeApi, agentId: string) => {
     upload(payload: KnowledgeUploadRequest): Promise<{
@@ -778,11 +1287,20 @@ declare const bindAgentKnowledge: (api: AgentKnowledgeApi, agentId: string) => {
         user_id: string;
         status: "queued" | "processing" | "completed" | "failed";
     }>;
-    listBases(): Promise<{
+    listBases(opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<{
         data?: components["schemas"]["KnowledgeBaseSummary"][];
         agent_id?: string;
-    }>;
-    listUploads(): Promise<{
+    }, Partial<{
+        page: number;
+        limit: number;
+        sort: string | string[];
+        fields: string | string[];
+        include: string | string[];
+        search: string;
+        filter: QueryFilters | QueryBuilderInput;
+        or: QueryOrGroups | QueryBuilderInput;
+    }>>>;
+    listUploads(opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<{
         data: ({
             document_id: string;
             file_path: string;
@@ -792,7 +1310,16 @@ declare const bindAgentKnowledge: (api: AgentKnowledgeApi, agentId: string) => {
             user_id: string;
             status: "queued" | "processing" | "completed" | "failed";
         })[];
-    }>;
+    }, Partial<{
+        page: number;
+        limit: number;
+        sort: string | string[];
+        fields: string | string[];
+        include: string | string[];
+        search: string;
+        filter: QueryFilters | QueryBuilderInput;
+        or: QueryOrGroups | QueryBuilderInput;
+    }>>>;
 };
 declare const bindAgentPhones: (api: AgentPhonesApi, agentId: string) => {
     connect(payload: ConnectPhoneRequest): Promise<{
@@ -805,21 +1332,101 @@ declare const bindAgentPhones: (api: AgentPhonesApi, agentId: string) => {
     }>;
     disconnect(phoneId: string): Promise<void>;
 };
-declare const createAgentEntity: (dto: AgentDetail, options: AgentEntityFactoryOptions) => AgentEntity;
+declare const bindAgentSchedule: (api: AgentScheduleApi, agentId: string) => {
+    get(): Promise<{
+        agentId: string;
+        timezone: string;
+        rules: components["schemas"]["AgentScheduleRule"][];
+        metadata?: {
+            [key: string]: unknown;
+        };
+    }>;
+    update(payload: UpdateAgentScheduleRequest): Promise<{
+        agentId: string;
+        timezone: string;
+        rules: components["schemas"]["AgentScheduleRule"][];
+        metadata?: {
+            [key: string]: unknown;
+        };
+    }>;
+};
+declare const bindAgentVersions: (api: AgentVersionsApi, agentId: string) => {
+    list(opts?: ListAgentVersionsOptions): Promise<PaginatedResult<{
+        data: components["schemas"]["AgentVersionSummary"][];
+        meta?: components["schemas"]["PaginationMeta"];
+    }, ListAgentVersionsOptions>>;
+    get(versionId: string): Promise<{
+        versionId: string;
+        agentId: string;
+        label: string;
+        status: "draft" | "published" | "archived";
+        isActive?: boolean;
+        createdAt: string;
+        updatedAt?: string;
+        publishedAt?: string | null;
+    } & {
+        description?: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        instructionsVersionId?: string;
+    }>;
+    create(payload: CreateAgentVersionRequest): Promise<{
+        versionId: string;
+        agentId: string;
+        label: string;
+        status: "draft" | "published" | "archived";
+        isActive?: boolean;
+        createdAt: string;
+        updatedAt?: string;
+        publishedAt?: string | null;
+    } & {
+        description?: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        instructionsVersionId?: string;
+    }>;
+    update(versionId: string, payload: UpdateAgentVersionRequest): Promise<{
+        versionId: string;
+        agentId: string;
+        label: string;
+        status: "draft" | "published" | "archived";
+        isActive?: boolean;
+        createdAt: string;
+        updatedAt?: string;
+        publishedAt?: string | null;
+    } & {
+        description?: string;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        instructionsVersionId?: string;
+    }>;
+};
+type AgentSnapshot = AgentDetail | AgentSummary;
+declare const createAgentEntity: (dto: AgentSnapshot, options: AgentEntityFactoryOptions) => AgentEntity;
 
 type AgentEntityDependencies = {
     instructionsApi: ReturnType<typeof createAgentInstructionsApi>;
     knowledgeApi: ReturnType<typeof createAgentKnowledgeApi>;
     phonesApi: ReturnType<typeof createAgentPhonesApi>;
+    scheduleApi: ReturnType<typeof createAgentScheduleApi>;
+    versionsApi: ReturnType<typeof createAgentVersionsApi>;
 };
+type ListAgentsOptions = ListQueryOptions;
 type AgentsApi = {
-    list(): Promise<AgentListResponse>;
+    list(options?: ListAgentsOptions): Promise<PaginatedResult<AgentListResponse, ListAgentsOptions>>;
     get(agentId: string): Promise<AgentDetail>;
     create(payload: CreateAgentRequest): Promise<AgentDetail>;
     update(agentId: string, payload: UpdateAgentRequest): Promise<AgentDetail>;
-    delete(agentId: string): Promise<void>;
+    delete(agent: string | AgentEntity): Promise<void>;
+};
+type AgentListResponseWithEntities = Omit<AgentListResponse, 'data'> & {
+    data: AgentEntity[];
 };
-type AgentsApiWithEntities = Omit<AgentsApi, 'get' | 'create' | 'update'> & {
+type AgentsApiWithEntities = Omit<AgentsApi, 'get' | 'create' | 'update' | 'list'> & {
+    list(options?: ListAgentsOptions): Promise<PaginatedResult<AgentListResponseWithEntities, ListAgentsOptions>>;
     get(agentId: string): Promise<AgentEntity>;
     create(payload: CreateAgentRequest): Promise<AgentEntity>;
     update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
@@ -828,20 +1435,36 @@ declare function createAgentsApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }, relatedApis?: AgentEntityDependencies): AgentsApi | AgentsApiWithEntities;
 
-declare function createWorkspacesApi(cfg: ClientConfig & {
+type ListToolsOptions = ListQueryOptions;
+declare function createToolsApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
-    listPhones(workspaceId: string, opts?: {
-        channel?: WorkspacePhoneChannel;
-    }): Promise<WorkspacePhonesResponse>;
-    enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
+    list(options?: ListToolsOptions): Promise<PaginatedResult<ToolsCatalogResponse, ListToolsOptions>>;
+    execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
 };
 
-declare function createToolsApi(cfg: ClientConfig & {
+type ListVoicesOptions = ListQueryOptions & {
+    agentId?: string;
+    agentVersionId?: string;
+    gender?: 'female' | 'male' | 'neutral';
+    locale?: string;
+    page?: number;
+    pageSize?: number;
+};
+declare function createVoicesApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
-    list(): Promise<ToolsCatalogResponse>;
-    execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
+    list(options?: ListVoicesOptions): Promise<PaginatedResult<VoiceListResponse, ListVoicesOptions>>;
+};
+
+type ListWorkspacePhonesOptions = ListQueryOptions & {
+    channel?: WorkspacePhoneChannel;
+};
+declare function createWorkspacesApi(cfg: ClientConfig & {
+    retry?: RetryPolicy;
+}): {
+    listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
+    enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
 };
 
 declare function createClient(initialCfg: ClientConfig & {
@@ -863,71 +1486,109 @@ declare function createClient(initialCfg: ClientConfig & {
             agents: {
                 knowledge: {
                     upload(agentId: string, payload: KnowledgeUploadRequest): Promise<KnowledgeUploadResponse>;
-                    listBases(agentId: string): Promise<AgentKnowledgeBasesResponse>;
-                    listUploads(agentId: string): Promise<AgentKnowledgeUploadsResponse>;
+                    listBases(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeBasesResponse, ListAgentKnowledgeOptions>>;
+                    listUploads(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeUploadsResponse, ListAgentKnowledgeOptions>>;
                 };
                 instructions: {
-                    list(agentId: string, opts?: {
-                        versionId?: string;
-                    }): Promise<AgentInstructionsResponse>;
+                    list(agentId: string, opts?: ListAgentInstructionsOptions): Promise<PaginatedResult<AgentInstructionsResponse, ListAgentInstructionsOptions>>;
                     create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
+                    update(agentId: string, instructionId: string, payload: UpdateInstructionRequest): Promise<Instruction>;
+                    delete(agentId: string, instructionId: string): Promise<void>;
                 };
                 phones: {
                     connect(agentId: string, payload: ConnectPhoneRequest): Promise<PhoneAssignmentResponse>;
                     disconnect(agentId: string, phoneId: string): Promise<void>;
                 };
-                list: () => Promise<AgentListResponse>;
-                delete: (agentId: string) => Promise<void>;
+                schedule: {
+                    get(agentId: string): Promise<AgentSchedule>;
+                    update(agentId: string, payload: UpdateAgentScheduleRequest): Promise<AgentSchedule>;
+                };
+                versions: {
+                    list(agentId: string, opts?: ListAgentVersionsOptions): Promise<PaginatedResult<AgentVersionListResponse, ListAgentVersionsOptions>>;
+                    get(agentId: string, versionId: string): Promise<AgentVersionDetail>;
+                    create(agentId: string, payload: CreateAgentVersionRequest): Promise<AgentVersionDetail>;
+                    update(agentId: string, versionId: string, payload: UpdateAgentVersionRequest): Promise<AgentVersionDetail>;
+                };
+                delete: (agent: string | AgentEntity) => Promise<void>;
+                list(options?: ListAgentsOptions): Promise<PaginatedResult<Omit<{
+                    data: components["schemas"]["AgentSummary"][];
+                    meta: components["schemas"]["PaginationMeta"];
+                }, "data"> & {
+                    data: AgentEntity[];
+                }, ListAgentsOptions>>;
                 get(agentId: string): Promise<AgentEntity>;
                 create(payload: CreateAgentRequest): Promise<AgentEntity>;
                 update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
             };
             workspaces: {
-                listPhones(workspaceId: string, opts?: {
-                    channel?: WorkspacePhoneChannel;
-                }): Promise<WorkspacePhonesResponse>;
+                listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
                 enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
             };
             tools: {
-                list(): Promise<ToolsCatalogResponse>;
+                list(options?: ListToolsOptions): Promise<PaginatedResult<ToolsCatalogResponse, ListToolsOptions>>;
                 execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
             };
+            voices: {
+                list(options?: ListVoicesOptions): Promise<PaginatedResult<VoiceListResponse, ListVoicesOptions>>;
+            };
         };
     };
     agents: {
         knowledge: {
             upload(agentId: string, payload: KnowledgeUploadRequest): Promise<KnowledgeUploadResponse>;
-            listBases(agentId: string): Promise<AgentKnowledgeBasesResponse>;
-            listUploads(agentId: string): Promise<AgentKnowledgeUploadsResponse>;
+            listBases(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeBasesResponse, ListAgentKnowledgeOptions>>;
+            listUploads(agentId: string, opts?: ListAgentKnowledgeOptions): Promise<PaginatedResult<AgentKnowledgeUploadsResponse, ListAgentKnowledgeOptions>>;
         };
         instructions: {
-            list(agentId: string, opts?: {
-                versionId?: string;
-            }): Promise<AgentInstructionsResponse>;
+            list(agentId: string, opts?: ListAgentInstructionsOptions): Promise<PaginatedResult<AgentInstructionsResponse, ListAgentInstructionsOptions>>;
             create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
+            update(agentId: string, instructionId: string, payload: UpdateInstructionRequest): Promise<Instruction>;
+            delete(agentId: string, instructionId: string): Promise<void>;
         };
         phones: {
             connect(agentId: string, payload: ConnectPhoneRequest): Promise<PhoneAssignmentResponse>;
             disconnect(agentId: string, phoneId: string): Promise<void>;
         };
-        list: () => Promise<AgentListResponse>;
-        delete: (agentId: string) => Promise<void>;
+        schedule: {
+            get(agentId: string): Promise<AgentSchedule>;
+            update(agentId: string, payload: UpdateAgentScheduleRequest): Promise<AgentSchedule>;
+        };
+        versions: {
+            list(agentId: string, opts?: ListAgentVersionsOptions): Promise<PaginatedResult<AgentVersionListResponse, ListAgentVersionsOptions>>;
+            get(agentId: string, versionId: string): Promise<AgentVersionDetail>;
+            create(agentId: string, payload: CreateAgentVersionRequest): Promise<AgentVersionDetail>;
+            update(agentId: string, versionId: string, payload: UpdateAgentVersionRequest): Promise<AgentVersionDetail>;
+        };
+        delete: (agent: string | AgentEntity) => Promise<void>;
+        list(options?: ListAgentsOptions): Promise<PaginatedResult<Omit<{
+            data: components["schemas"]["AgentSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        }, "data"> & {
+            data: AgentEntity[];
+        }, ListAgentsOptions>>;
         get(agentId: string): Promise<AgentEntity>;
         create(payload: CreateAgentRequest): Promise<AgentEntity>;
         update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
     };
     workspaces: {
-        listPhones(workspaceId: string, opts?: {
-            channel?: WorkspacePhoneChannel;
-        }): Promise<WorkspacePhonesResponse>;
+        listPhones(workspaceId: string, opts?: ListWorkspacePhonesOptions): Promise<PaginatedResult<WorkspacePhonesResponse, ListWorkspacePhonesOptions>>;
         enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
     };
     tools: {
-        list(): Promise<ToolsCatalogResponse>;
+        list(options?: ListToolsOptions): Promise<PaginatedResult<ToolsCatalogResponse, ListToolsOptions>>;
         execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
     };
+    voices: {
+        list(options?: ListVoicesOptions): Promise<PaginatedResult<VoiceListResponse, ListVoicesOptions>>;
+    };
 };
 
+type QueryParamPrimitive = string | number | boolean;
+type QueryParamValue = QueryParamPrimitive | QueryParamPrimitive[] | null | undefined;
+type QueryInit = string | URLSearchParams | Record<string, QueryParamValue>;
+type FetchOptions = RequestInit & {
+    query?: QueryInit;
+};
 declare function createHttp(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
@@ -938,9 +1599,9 @@ declare function createHttp(cfg: ClientConfig & {
         error?: (...a: any[]) => void;
     };
     retry: RetryPolicy;
-    doFetch: (url: string, init?: RequestInit) => Promise<Response>;
+    doFetch: (url: string, init?: FetchOptions) => Promise<Response>;
     buildHeaders: (extra?: HeadersInit) => Record<string, string>;
     resolveWorkspaceId: () => string;
 };
 
-export { type AgentDetail, type AgentEntity, type AgentEntityFactoryOptions, type AgentInstructionsResponse, type AgentKnowledgeBasesResponse, type AgentKnowledgeUploadsResponse, type AgentListResponse, type AgentSummary, type AgentsApi, type AgentsApiWithEntities, type ClientConfig, type ConnectPhoneRequest, type CreateAgentRequest, type CreateInstructionRequest, type ErrorResponse, type ExecuteToolRequest, type ExecuteToolResponse, HttpError, type Instruction, type InstructionCreatedResponse, type KnowledgeUploadListResponse, type KnowledgeUploadRequest, type KnowledgeUploadResponse, NetworkError, type PhoneAssignmentResponse, type RetryPolicy, TimeoutError, type ToolSummary, type ToolsCatalogResponse, type UpdateAgentRequest, type WorkspaceEnableRequest, type WorkspaceEnableResponse, type WorkspacePhone, type WorkspacePhoneChannel, type WorkspacePhonesResponse, bindAgentInstructions, bindAgentKnowledge, bindAgentPhones, createAgentEntity, createAgentInstructionsApi, createAgentKnowledgeApi, createAgentPhonesApi, createAgentsApi, createClient, createHttp, createToolsApi, createWorkspacesApi };
+export { type AgentDetail, type AgentEntity, type AgentEntityFactoryOptions, type AgentInstructionsResponse, type AgentKnowledgeBasesResponse, type AgentKnowledgeUploadsResponse, type AgentListResponse, type AgentSchedule, type AgentSummary, type AgentVersionDetail, type AgentVersionListResponse, type AgentVersionSummary, type AgentsApi, type AgentsApiWithEntities, type ClientConfig, type ConnectPhoneRequest, type CreateAgentRequest, type CreateAgentVersionRequest, type CreateInstructionRequest, type ErrorResponse, type ExecuteToolRequest, type ExecuteToolResponse, HttpError, type Instruction, type InstructionCreatedResponse, type KnowledgeUploadListResponse, type KnowledgeUploadRequest, type KnowledgeUploadResponse, type ListAgentInstructionsOptions, type ListAgentKnowledgeOptions, type ListAgentVersionsOptions, type ListAgentsOptions, type ListQueryOptions, type ListToolsOptions, type ListVoicesOptions, type ListWorkspacePhonesOptions, NetworkError, type PaginatedResult, type PaginationMeta, type PhoneAssignmentResponse, type QueryBuilderInput, type QueryBuilderSerializable, type QueryFilterOperators, type QueryFilters, type QueryOrGroups, type QueryValue, type RetryPolicy, TimeoutError, type ToolSummary, type ToolsCatalogResponse, type UpdateAgentRequest, type UpdateAgentScheduleRequest, type UpdateAgentVersionRequest, type UpdateInstructionRequest, type VoiceListResponse, type VoiceSummary, type WorkspaceEnableRequest, type WorkspaceEnableResponse, type WorkspacePhone, type WorkspacePhoneChannel, type WorkspacePhonesResponse, bindAgentInstructions, bindAgentKnowledge, bindAgentPhones, bindAgentSchedule, bindAgentVersions, createAgentEntity, createAgentInstructionsApi, createAgentKnowledgeApi, createAgentPhonesApi, createAgentScheduleApi, createAgentVersionsApi, createAgentsApi, createClient, createHttp, createToolsApi, createVoicesApi, createWorkspacesApi };