@getsupervisor/agents-studio-sdk 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,38 +1,43 @@
 type paths = {
-    '/v1/agents/{agentId}': {
-        get: operations['getAgentDetail'];
-        delete: operations['deleteAgent'];
+    "/v1/agents": {
+        get: operations["listAgents"];
+        post: operations["createAgent"];
     };
-    '/v1/agents/{agentId}/knowledge/upload': {
-        post: operations['uploadAgentKnowledge'];
+    "/v1/agents/{agentId}": {
+        get: operations["getAgentDetail"];
+        delete: operations["deleteAgent"];
+        patch: operations["updateAgent"];
     };
-    '/v1/agents/{agentId}/knowledge/bases': {
-        get: operations['listAgentKnowledgeBases'];
+    "/v1/agents/{agentId}/knowledge/upload": {
+        post: operations["uploadAgentKnowledge"];
     };
-    '/v1/agents/{agentId}/knowledge/uploads': {
-        get: operations['listAgentKnowledgeUploads'];
+    "/v1/agents/{agentId}/knowledge/bases": {
+        get: operations["listAgentKnowledgeBases"];
     };
-    '/v1/agents/{agentId}/instructions': {
-        get: operations['listAgentInstructions'];
-        post: operations['createAgentInstruction'];
+    "/v1/agents/{agentId}/knowledge/uploads": {
+        get: operations["listAgentKnowledgeUploads"];
     };
-    '/v1/agents/{agentId}/phones': {
-        post: operations['connectAgentPhone'];
+    "/v1/agents/{agentId}/instructions": {
+        get: operations["listAgentInstructions"];
+        post: operations["createAgentInstruction"];
     };
-    '/v1/agents/{agentId}/phones/{phoneId}': {
-        delete: operations['disconnectAgentPhone'];
+    "/v1/agents/{agentId}/phones": {
+        post: operations["connectAgentPhone"];
     };
-    '/v1/workspaces/{workspaceId}/phones': {
-        get: operations['listWorkspacePhones'];
+    "/v1/agents/{agentId}/phones/{phoneId}": {
+        delete: operations["disconnectAgentPhone"];
     };
-    '/v1/workspaces/{workspaceId}/enable': {
-        post: operations['enableWorkspace'];
+    "/v1/workspaces/{workspaceId}/phones": {
+        get: operations["listWorkspacePhones"];
     };
-    '/v1/tools': {
-        get: operations['listTools'];
+    "/v1/workspaces/{workspaceId}/enable": {
+        post: operations["enableWorkspace"];
     };
-    '/v1/tools/{toolId}/execute': {
-        post: operations['executeTool'];
+    "/v1/tools": {
+        get: operations["listTools"];
+    };
+    "/v1/tools/{toolId}/execute": {
+        post: operations["executeTool"];
     };
 };
 type components = {
@@ -43,7 +48,7 @@ type components = {
             workspaceId: string;
             provider: string;
             versionId?: string;
-            status: 'inactive' | 'training' | 'active' | 'archived';
+            status: "inactive" | "training" | "active" | "archived";
             voiceProfile?: {
                 voiceId?: string;
                 llmId?: string;
@@ -54,6 +59,40 @@ type components = {
             createdAt?: string;
             updatedAt?: string;
         };
+        PaginationMeta: {
+            total: number;
+            page: number;
+            limit: number;
+            hasNext: boolean;
+        };
+        AgentSummary: {
+            agentId: string;
+            name: string;
+            status: "inactive" | "training" | "active" | "archived";
+            workspaceId: string;
+            createdAt: string;
+        };
+        AgentListResponse: {
+            data: components["schemas"]["AgentSummary"][];
+            meta: components["schemas"]["PaginationMeta"];
+        };
+        CreateAgentRequest: {
+            name: string;
+            provider: string;
+            languageCode: string;
+            templateId?: string | null;
+            metadata?: {
+                [key: string]: unknown;
+            };
+        };
+        UpdateAgentRequest: {
+            name?: string;
+            status?: "inactive" | "training" | "active" | "archived";
+            metadata?: {
+                [key: string]: unknown;
+            };
+            provider?: string;
+        };
         KnowledgeBaseSummary: {
             id: string;
             providerId?: string;
@@ -76,18 +115,18 @@ type components = {
             source: string;
             drive_file_id?: string | null;
             user_id: string;
-            status: 'queued' | 'processing' | 'completed' | 'failed';
+            status: "queued" | "processing" | "completed" | "failed";
         };
         KnowledgeUploadListResponse: {
-            data: {
+            data: ({
                 document_id: string;
                 file_path: string;
                 file_name: string;
                 source: string;
                 drive_file_id?: string | null;
                 user_id: string;
-                status: 'queued' | 'processing' | 'completed' | 'failed';
-            }[];
+                status: "queued" | "processing" | "completed" | "failed";
+            })[];
         };
         Instruction: {
             id: string;
@@ -127,14 +166,14 @@ type components = {
         WorkspacePhone: {
             id: string;
             external_id: string;
-            channel?: 'voice' | null;
+            channel?: "voice" | null;
             supports_outbound?: boolean | null;
             assigned_to?: string | null;
             last_used_at?: string | null;
             requires_qr_reauth?: boolean | null;
         };
         WorkspacePhonesResponse: {
-            data: components['schemas']['WorkspacePhone'][];
+            data: components["schemas"]["WorkspacePhone"][];
         };
         ToolSummary: {
             id: string;
@@ -161,14 +200,14 @@ type components = {
             toolId: string;
         };
         WorkspaceEnableRequest: {
-            provider: 'retell';
+            provider: "retell";
             apiKey: string;
             metadata?: {
                 [key: string]: unknown;
             };
         };
         WorkspaceEnableResponse: {
-            status: 'enabled';
+            status: "enabled";
             provider: string;
             workspaceId: string;
         };
@@ -182,6 +221,7 @@ type components = {
     };
     responses: never;
     parameters: {
+        XWorkspaceId: string;
         AgentId: string;
         PhoneId: string;
         WorkspaceId: string;
@@ -192,29 +232,83 @@ type components = {
     pathItems: never;
 };
 type operations = {
+    listAgents: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentListResponse"];
+                };
+            };
+        };
+    };
+    createAgent: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateAgentRequest"];
+            };
+        };
+        responses: {
+            201: {
+                content: {
+                    "application/json": components["schemas"]["AgentDetail"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getAgentDetail: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['AgentDetail'];
+                    "application/json": components["schemas"]["AgentDetail"];
                 };
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     deleteAgent: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         responses: {
@@ -223,72 +317,118 @@ type operations = {
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateAgent: {
+        parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
+            path: {
+                agentId: components["parameters"]["AgentId"];
+            };
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateAgentRequest"];
+            };
+        };
+        responses: {
+            200: {
+                content: {
+                    "application/json": components["schemas"]["AgentDetail"];
+                };
+            };
+            400: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            404: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            409: {
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     uploadAgentKnowledge: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['KnowledgeUploadRequest'];
+                "application/json": components["schemas"]["KnowledgeUploadRequest"];
             };
         };
         responses: {
             202: {
                 content: {
-                    'application/json': components['schemas']['KnowledgeUploadResponse'];
+                    "application/json": components["schemas"]["KnowledgeUploadResponse"];
                 };
             };
             400: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     listAgentKnowledgeBases: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': {
-                        data?: components['schemas']['KnowledgeBaseSummary'][];
+                    "application/json": {
+                        data?: components["schemas"]["KnowledgeBaseSummary"][];
                         agent_id?: string;
                     };
                 };
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     listAgentKnowledgeUploads: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['KnowledgeUploadListResponse'];
+                    "application/json": components["schemas"]["KnowledgeUploadListResponse"];
                 };
             };
         };
@@ -298,94 +438,106 @@ type operations = {
             query?: {
                 versionId?: string;
             };
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': {
-                        data?: components['schemas']['Instruction'][];
+                    "application/json": {
+                        data: components["schemas"]["Instruction"][];
                         versionId?: string;
                     };
                 };
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     createAgentInstruction: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateInstructionRequest'];
+                "application/json": components["schemas"]["CreateInstructionRequest"];
             };
         };
         responses: {
             201: {
                 content: {
-                    'application/json': components['schemas']['InstructionCreatedResponse'];
+                    "application/json": components["schemas"]["InstructionCreatedResponse"];
                 };
             };
             400: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     connectAgentPhone: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
+                agentId: components["parameters"]["AgentId"];
             };
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['ConnectPhoneRequest'];
+                "application/json": components["schemas"]["ConnectPhoneRequest"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['PhoneAssignmentResponse'];
+                    "application/json": components["schemas"]["PhoneAssignmentResponse"];
                 };
             };
             400: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
     };
     disconnectAgentPhone: {
         parameters: {
+            header: {
+                "x-workspace-id": components["parameters"]["XWorkspaceId"];
+            };
             path: {
-                agentId: components['parameters']['AgentId'];
-                phoneId: components['parameters']['PhoneId'];
+                agentId: components["parameters"]["AgentId"];
+                phoneId: components["parameters"]["PhoneId"];
             };
         };
         responses: {
@@ -394,12 +546,12 @@ type operations = {
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
@@ -407,16 +559,16 @@ type operations = {
     listWorkspacePhones: {
         parameters: {
             query?: {
-                channel?: 'voice';
+                channel?: "voice";
             };
             path: {
-                workspaceId: components['parameters']['WorkspaceId'];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['WorkspacePhonesResponse'];
+                    "application/json": components["schemas"]["WorkspacePhonesResponse"];
                 };
             };
         };
@@ -424,28 +576,28 @@ type operations = {
     enableWorkspace: {
         parameters: {
             path: {
-                workspaceId: components['parameters']['WorkspaceId'];
+                workspaceId: components["parameters"]["WorkspaceId"];
             };
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['WorkspaceEnableRequest'];
+                "application/json": components["schemas"]["WorkspaceEnableRequest"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['WorkspaceEnableResponse'];
+                    "application/json": components["schemas"]["WorkspaceEnableResponse"];
                 };
             };
             400: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             502: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
@@ -454,8 +606,8 @@ type operations = {
         responses: {
             200: {
                 content: {
-                    'application/json': {
-                        data?: components['schemas']['ToolSummary'][];
+                    "application/json": {
+                        data?: components["schemas"]["ToolSummary"][];
                     };
                 };
             };
@@ -464,33 +616,33 @@ type operations = {
     executeTool: {
         parameters: {
             path: {
-                toolId: components['parameters']['ToolId'];
+                toolId: components["parameters"]["ToolId"];
             };
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['ExecuteToolRequest'];
+                "application/json": components["schemas"]["ExecuteToolRequest"];
             };
         };
         responses: {
             200: {
                 content: {
-                    'application/json': components['schemas']['ExecuteToolResponse'];
+                    "application/json": components["schemas"]["ExecuteToolResponse"];
                 };
             };
             400: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             404: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
             409: {
                 content: {
-                    'application/json': components['schemas']['ErrorResponse'];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
@@ -506,8 +658,14 @@ type ClientConfig = {
         debug?: (...a: any[]) => void;
         error?: (...a: any[]) => void;
     };
+    workspaceId?: string;
+    getWorkspaceId?: () => string | undefined;
 };
 type AgentDetail = components['schemas']['AgentDetail'];
+type AgentSummary = components['schemas']['AgentSummary'];
+type AgentListResponse = components['schemas']['AgentListResponse'];
+type CreateAgentRequest = components['schemas']['CreateAgentRequest'];
+type UpdateAgentRequest = components['schemas']['UpdateAgentRequest'];
 type KnowledgeUploadRequest = components['schemas']['KnowledgeUploadRequest'];
 type KnowledgeUploadResponse = components['schemas']['KnowledgeUploadResponse'];
 type KnowledgeUploadListResponse = components['schemas']['KnowledgeUploadListResponse'];
@@ -554,11 +712,13 @@ type RetryPolicy = {
     retryOn?: (err: unknown, attempt: number) => boolean;
 };
 
-declare function createAgentsApi(cfg: ClientConfig & {
+declare function createAgentInstructionsApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
-    get(agentId: string): Promise<AgentDetail>;
-    delete(agentId: string): Promise<void>;
+    list(agentId: string, opts?: {
+        versionId?: string;
+    }): Promise<AgentInstructionsResponse>;
+    create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
 };
 
 declare function createAgentKnowledgeApi(cfg: ClientConfig & {
@@ -569,15 +729,6 @@ declare function createAgentKnowledgeApi(cfg: ClientConfig & {
     listUploads(agentId: string): Promise<AgentKnowledgeUploadsResponse>;
 };
 
-declare function createAgentInstructionsApi(cfg: ClientConfig & {
-    retry?: RetryPolicy;
-}): {
-    list(agentId: string, opts?: {
-        versionId?: string;
-    }): Promise<AgentInstructionsResponse>;
-    create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
-};
-
 declare function createAgentPhonesApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
@@ -585,6 +736,98 @@ declare function createAgentPhonesApi(cfg: ClientConfig & {
     disconnect(agentId: string, phoneId: string): Promise<void>;
 };
 
+type AgentInstructionsApi = ReturnType<typeof createAgentInstructionsApi>;
+type AgentKnowledgeApi = ReturnType<typeof createAgentKnowledgeApi>;
+type AgentPhonesApi = ReturnType<typeof createAgentPhonesApi>;
+type AgentInstructionsHelper = ReturnType<typeof bindAgentInstructions>;
+type AgentKnowledgeHelper = ReturnType<typeof bindAgentKnowledge>;
+type AgentPhonesHelper = ReturnType<typeof bindAgentPhones>;
+interface AgentEntity extends AgentDetail {
+    instructions: AgentInstructionsHelper;
+    knowledge: AgentKnowledgeHelper;
+    phones: AgentPhonesHelper;
+    refresh(): Promise<AgentEntity>;
+}
+type AgentEntityFactoryOptions = {
+    instructionsApi: AgentInstructionsApi;
+    knowledgeApi: AgentKnowledgeApi;
+    phonesApi: AgentPhonesApi;
+    reload(agentId: string): Promise<AgentEntity>;
+};
+declare const bindAgentInstructions: (api: AgentInstructionsApi, agentId: string) => {
+    list(opts?: {
+        versionId?: string;
+    }): Promise<{
+        data: components["schemas"]["Instruction"][];
+        versionId?: string;
+    }>;
+    create(payload: CreateInstructionRequest): Promise<{
+        id: string;
+        versionId: string;
+        order: number;
+        createdAt: string;
+    }>;
+};
+declare const bindAgentKnowledge: (api: AgentKnowledgeApi, agentId: string) => {
+    upload(payload: KnowledgeUploadRequest): Promise<{
+        document_id: string;
+        file_path: string;
+        file_name: string;
+        source: string;
+        drive_file_id?: string | null;
+        user_id: string;
+        status: "queued" | "processing" | "completed" | "failed";
+    }>;
+    listBases(): Promise<{
+        data?: components["schemas"]["KnowledgeBaseSummary"][];
+        agent_id?: string;
+    }>;
+    listUploads(): Promise<{
+        data: ({
+            document_id: string;
+            file_path: string;
+            file_name: string;
+            source: string;
+            drive_file_id?: string | null;
+            user_id: string;
+            status: "queued" | "processing" | "completed" | "failed";
+        })[];
+    }>;
+};
+declare const bindAgentPhones: (api: AgentPhonesApi, agentId: string) => {
+    connect(payload: ConnectPhoneRequest): Promise<{
+        agent_id: string;
+        phone_id: string;
+        allow_all: boolean;
+        test_phones?: string[];
+        channel?: string | null;
+        assigned_at?: string | null;
+    }>;
+    disconnect(phoneId: string): Promise<void>;
+};
+declare const createAgentEntity: (dto: AgentDetail, options: AgentEntityFactoryOptions) => AgentEntity;
+
+type AgentEntityDependencies = {
+    instructionsApi: ReturnType<typeof createAgentInstructionsApi>;
+    knowledgeApi: ReturnType<typeof createAgentKnowledgeApi>;
+    phonesApi: ReturnType<typeof createAgentPhonesApi>;
+};
+type AgentsApi = {
+    list(): Promise<AgentListResponse>;
+    get(agentId: string): Promise<AgentDetail>;
+    create(payload: CreateAgentRequest): Promise<AgentDetail>;
+    update(agentId: string, payload: UpdateAgentRequest): Promise<AgentDetail>;
+    delete(agentId: string): Promise<void>;
+};
+type AgentsApiWithEntities = Omit<AgentsApi, 'get' | 'create' | 'update'> & {
+    get(agentId: string): Promise<AgentEntity>;
+    create(payload: CreateAgentRequest): Promise<AgentEntity>;
+    update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
+};
+declare function createAgentsApi(cfg: ClientConfig & {
+    retry?: RetryPolicy;
+}, relatedApis?: AgentEntityDependencies): AgentsApi | AgentsApiWithEntities;
+
 declare function createWorkspacesApi(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
@@ -601,9 +844,56 @@ declare function createToolsApi(cfg: ClientConfig & {
     execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
 };
 
-declare function createClient(cfg: ClientConfig & {
+declare function createClient(initialCfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
+    workspace: {
+        get: () => string;
+        set(id?: string): void;
+        useGetter(getter?: () => string | undefined): void;
+        clear(): void;
+        scoped(id: string): {
+            workspace: {
+                get: () => string;
+                set(id?: string): void;
+                useGetter(getter?: () => string | undefined): void;
+                clear(): void;
+                scoped(id: string): any;
+            };
+            agents: {
+                knowledge: {
+                    upload(agentId: string, payload: KnowledgeUploadRequest): Promise<KnowledgeUploadResponse>;
+                    listBases(agentId: string): Promise<AgentKnowledgeBasesResponse>;
+                    listUploads(agentId: string): Promise<AgentKnowledgeUploadsResponse>;
+                };
+                instructions: {
+                    list(agentId: string, opts?: {
+                        versionId?: string;
+                    }): Promise<AgentInstructionsResponse>;
+                    create(agentId: string, payload: CreateInstructionRequest): Promise<InstructionCreatedResponse>;
+                };
+                phones: {
+                    connect(agentId: string, payload: ConnectPhoneRequest): Promise<PhoneAssignmentResponse>;
+                    disconnect(agentId: string, phoneId: string): Promise<void>;
+                };
+                list: () => Promise<AgentListResponse>;
+                delete: (agentId: string) => Promise<void>;
+                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>;
+                enable(workspaceId: string, payload: WorkspaceEnableRequest): Promise<WorkspaceEnableResponse>;
+            };
+            tools: {
+                list(): Promise<ToolsCatalogResponse>;
+                execute(toolId: string, payload: ExecuteToolRequest): Promise<ExecuteToolResponse>;
+            };
+        };
+    };
     agents: {
         knowledge: {
             upload(agentId: string, payload: KnowledgeUploadRequest): Promise<KnowledgeUploadResponse>;
@@ -620,8 +910,11 @@ declare function createClient(cfg: ClientConfig & {
             connect(agentId: string, payload: ConnectPhoneRequest): Promise<PhoneAssignmentResponse>;
             disconnect(agentId: string, phoneId: string): Promise<void>;
         };
-        get(agentId: string): Promise<AgentDetail>;
-        delete(agentId: string): Promise<void>;
+        list: () => Promise<AgentListResponse>;
+        delete: (agentId: string) => Promise<void>;
+        get(agentId: string): Promise<AgentEntity>;
+        create(payload: CreateAgentRequest): Promise<AgentEntity>;
+        update(agentId: string, payload: UpdateAgentRequest): Promise<AgentEntity>;
     };
     workspaces: {
         listPhones(workspaceId: string, opts?: {
@@ -639,14 +932,15 @@ declare function createHttp(cfg: ClientConfig & {
     retry?: RetryPolicy;
 }): {
     base: string;
-    headers: Record<string, string>;
     timeout: number;
     log: {
         debug?: (...a: any[]) => void;
         error?: (...a: any[]) => void;
     };
     retry: RetryPolicy;
-    doFetch: (url: string, init: RequestInit) => Promise<Response>;
+    doFetch: (url: string, init?: RequestInit) => Promise<Response>;
+    buildHeaders: (extra?: HeadersInit) => Record<string, string>;
+    resolveWorkspaceId: () => string;
 };
 
-export { type AgentDetail, type AgentInstructionsResponse, type AgentKnowledgeBasesResponse, type AgentKnowledgeUploadsResponse, type ClientConfig, type ConnectPhoneRequest, 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 WorkspaceEnableRequest, type WorkspaceEnableResponse, type WorkspacePhone, type WorkspacePhoneChannel, type WorkspacePhonesResponse, createAgentInstructionsApi, createAgentKnowledgeApi, createAgentPhonesApi, createAgentsApi, createClient, createHttp, createToolsApi, createWorkspacesApi };
+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 };