@chanl-ai/sdk 2.0.1

package/dist/modules/tools.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * ToolsModule - SDK module for MCP tool management and execution
+ *
+ * TDD Phase: GREEN - Implementation to make tests pass
+ *
+ * Provides CRUD operations for tools and execution capabilities.
+ * Supports both JWT auth (admin UI) and MCP API key auth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolsModule = void 0;
+// ============================================================================
+// TOOLS MODULE
+// ============================================================================
+class ToolsModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * List all tools with optional filters
+     *
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of tools
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const { data } = await sdk.tools.list();
+     *
+     * // Filter by type and status
+     * const { data } = await sdk.tools.list({
+     *   type: 'http',
+     *   isEnabled: true,
+     *   page: 1,
+     *   limit: 10
+     * });
+     *
+     * // Exclude system tools (kb_search, chanl_reason, etc.)
+     * const { data } = await sdk.tools.list({
+     *   includeSystem: false
+     * });
+     * ```
+     */
+    async list(filters) {
+        const queryParams = new URLSearchParams();
+        if (filters?.type) {
+            queryParams.append('type', filters.type);
+        }
+        if (filters?.isEnabled !== undefined) {
+            queryParams.append('isEnabled', String(filters.isEnabled));
+        }
+        if (filters?.search) {
+            queryParams.append('search', filters.search);
+        }
+        if (filters?.tag) {
+            queryParams.append('tag', filters.tag);
+        }
+        if (filters?.includeSystem !== undefined) {
+            queryParams.append('includeSystem', String(filters.includeSystem));
+        }
+        if (filters?.page) {
+            queryParams.append('page', filters.page.toString());
+        }
+        if (filters?.limit) {
+            queryParams.append('limit', filters.limit.toString());
+        }
+        if (filters?.sortBy) {
+            queryParams.append('sortBy', filters.sortBy);
+        }
+        if (filters?.sortOrder) {
+            queryParams.append('sortOrder', filters.sortOrder);
+        }
+        const url = `/api/v1/tools${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Get a single tool by ID
+     *
+     * @param id - Tool ID
+     * @returns Tool details
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.get('tool_abc123');
+     * console.log(data.tool.name);
+     * ```
+     */
+    async get(id) {
+        return this.sdk.request('GET', `/api/v1/tools/${id}`);
+    }
+    /**
+     * Create a new tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param input - Tool creation data
+     * @returns Created tool
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if tool name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.create({
+     *   name: 'get_weather',
+     *   description: 'Get weather for a city',
+     *   type: 'http',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: { city: { type: 'string' } },
+     *     required: ['city']
+     *   },
+     *   configuration: {
+     *     http: { method: 'GET', url: 'https://wttr.in/{{city}}' }
+     *   }
+     * });
+     * ```
+     */
+    async create(input) {
+        return this.sdk.request('POST', `/api/v1/tools`, input);
+    }
+    /**
+     * Update an existing tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param input - Update data
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if new name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.update('tool_abc123', {
+     *   description: 'Updated description',
+     *   isEnabled: false
+     * });
+     * ```
+     */
+    async update(id, input) {
+        return this.sdk.request('PATCH', `/api/v1/tools/${id}`, input);
+    }
+    /**
+     * Delete a tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.delete('tool_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    async delete(id) {
+        return this.sdk.request('DELETE', `/api/v1/tools/${id}`);
+    }
+    /**
+     * Execute a tool with given arguments
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param args - Arguments to pass to the tool
+     * @returns Execution result
+     * @throws NotFoundError if tool doesn't exist
+     * @throws ValidationError if args don't match input schema
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.execute('tool_abc123', {
+     *   city: 'London',
+     *   units: 'celsius'
+     * });
+     * console.log(data.output); // { temperature: 12, ... }
+     * ```
+     */
+    async execute(id, args) {
+        return this.sdk.request('POST', `/api/v1/tools/${id}/execute`, {
+            arguments: args,
+        });
+    }
+    /**
+     * Test a tool execution (same as execute but for testing in admin UI)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param args - Arguments to pass to the tool
+     * @returns Execution result
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.test('tool_abc123', {
+     *   city: 'London'
+     * });
+     * ```
+     */
+    async test(id, args) {
+        return this.sdk.request('POST', `/api/v1/tools/${id}/test`, {
+            arguments: args,
+        });
+    }
+    /**
+     * Get execution history for a tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of executions
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Get all executions
+     * const { data } = await sdk.tools.getExecutions('ws_123', 'tool_abc123');
+     *
+     * // Filter by status and date range
+     * const { data } = await sdk.tools.getExecutions('ws_123', 'tool_abc123', {
+     *   status: 'completed',
+     *   fromDate: '2025-01-01',
+     *   toDate: '2025-01-31'
+     * });
+     * ```
+     */
+    async getExecutions(id, filters) {
+        const queryParams = new URLSearchParams();
+        if (filters?.status) {
+            queryParams.append('status', filters.status);
+        }
+        if (filters?.source) {
+            queryParams.append('source', filters.source);
+        }
+        if (filters?.fromDate) {
+            queryParams.append('fromDate', filters.fromDate);
+        }
+        if (filters?.toDate) {
+            queryParams.append('toDate', filters.toDate);
+        }
+        if (filters?.page) {
+            queryParams.append('page', filters.page.toString());
+        }
+        if (filters?.limit) {
+            queryParams.append('limit', filters.limit.toString());
+        }
+        const url = `/api/v1/tools/${id}/executions${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Enable a tool (shortcut for setting isEnabled=true)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.enable('tool_abc123');
+     * console.log(data.tool.isEnabled); // true
+     * ```
+     */
+    async enable(id) {
+        return this.sdk.request('POST', `/api/v1/tools/${id}/enable`);
+    }
+    /**
+     * Disable a tool (shortcut for setting isEnabled=false)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.disable('tool_abc123');
+     * console.log(data.tool.isEnabled); // false
+     * ```
+     */
+    async disable(id) {
+        return this.sdk.request('POST', `/api/v1/tools/${id}/disable`);
+    }
+    /**
+     * Get tool categories (aggregated tags with counts)
+     *
+     * @param workspaceId - Workspace ID
+     * @returns List of categories with counts
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.getCategories('ws_123');
+     * console.log(data.categories);
+     * // [{ name: 'weather', count: 5, enabledCount: 3 }, ...]
+     * ```
+     */
+    async getCategories() {
+        return this.sdk.request('GET', `/api/v1/tools/categories`);
+    }
+}
+exports.ToolsModule = ToolsModule;
+//# sourceMappingURL=tools.js.map

package/dist/modules/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/modules/tools.ts"],"names":[],"mappings":"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"}

package/dist/modules/toolsets.d.ts

@@ -0,0 +1,173 @@
+/**
+ * ToolsetsModule - SDK module for MCP toolset management
+ *
+ * Provides CRUD operations for toolsets (collections of tools).
+ * Supports both JWT auth (admin UI) and API key auth.
+ */
+import { ChanlSDK } from '../client';
+import { ApiResponse } from '../types/config';
+import type { CreateToolsetInput, UpdateToolsetInput, ToolsetFilters, ToolsetListResponse, ToolsetResponse, ToolsetDeleteResponse, ManageToolsInput, ToolOverride } from '../types/toolsets';
+export declare class ToolsetsModule {
+    private sdk;
+    constructor(sdk: ChanlSDK);
+    /**
+     * List all toolsets with optional filters
+     *
+     * @param workspaceId - Workspace ID
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of toolsets
+     *
+     * @example
+     * ```typescript
+     * // List all toolsets
+     * const { data } = await sdk.toolsets.list();
+     *
+     * // Filter by enabled status
+     * const { data } = await sdk.toolsets.list({
+     *   enabled: true,
+     *   page: 1,
+     *   limit: 10
+     * });
+     * ```
+     */
+    list(filters?: ToolsetFilters): Promise<ApiResponse<ToolsetListResponse>>;
+    /**
+     * Get a single toolset by ID
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Toolset details
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.get('toolset_abc123');
+     * console.log(data.toolset.name);
+     * ```
+     */
+    get(id: string): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Create a new toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param input - Toolset creation data
+     * @returns Created toolset
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if toolset name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.create({
+     *   name: 'customer_support_tools',
+     *   description: 'Tools for customer support agents',
+     *   tools: ['tool_id_1', 'tool_id_2'],
+     *   enabled: true,
+     *   tags: ['support', 'customer-facing']
+     * });
+     * ```
+     */
+    create(input: CreateToolsetInput): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Update an existing toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param input - Update data
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if new name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.update('toolset_abc123', {
+     *   description: 'Updated description',
+     *   enabled: false
+     * });
+     * ```
+     */
+    update(id: string, input: UpdateToolsetInput): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Delete a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.delete('toolset_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    delete(id: string): Promise<ApiResponse<ToolsetDeleteResponse>>;
+    /**
+     * Add or remove tools from a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param input - Tools to add or remove
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Add tools
+     * const { data } = await sdk.toolsets.manageTools('ws_123', 'toolset_abc123', {
+     *   add: ['tool_id_3', 'tool_id_4']
+     * });
+     *
+     * // Remove tools
+     * const { data } = await sdk.toolsets.manageTools('ws_123', 'toolset_abc123', {
+     *   remove: ['tool_id_1']
+     * });
+     * ```
+     */
+    manageTools(id: string, input: ManageToolsInput): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Set tool name/description overrides for a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param overrides - Map of tool ID to override configuration
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.setOverrides('ws_123', 'toolset_abc123', {
+     *   'tool_id_1': { name: 'Custom Name', description: 'Custom description' }
+     * });
+     * ```
+     */
+    setOverrides(id: string, overrides: Record<string, ToolOverride>): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Enable a toolset (shortcut for update with enabled: true)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Updated toolset
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.enable('toolset_abc123');
+     * console.log(data.toolset.enabled); // true
+     * ```
+     */
+    enable(id: string): Promise<ApiResponse<ToolsetResponse>>;
+    /**
+     * Disable a toolset (shortcut for update with enabled: false)
+     *
+     * @param id - Toolset ID
+     * @returns Updated toolset
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.disable('toolset_abc123');
+     * console.log(data.toolset.enabled); // false
+     * ```
+     */
+    disable(id: string): Promise<ApiResponse<ToolsetResponse>>;
+}
+//# sourceMappingURL=toolsets.d.ts.map

package/dist/modules/toolsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsets.d.ts","sourceRoot":"","sources":["../../src/modules/toolsets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAM3B,qBAAa,cAAc;IACb,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,QAAQ;IAEjC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IA0B5C;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAI5D;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CACV,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAIxC;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAIxC;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAIrE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAIxC;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACtC,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAIxC;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAI/D;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;CAGjE"}

package/dist/modules/toolsets.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * ToolsetsModule - SDK module for MCP toolset management
+ *
+ * Provides CRUD operations for toolsets (collections of tools).
+ * Supports both JWT auth (admin UI) and API key auth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolsetsModule = void 0;
+// ============================================================================
+// TOOLSETS MODULE
+// ============================================================================
+class ToolsetsModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * List all toolsets with optional filters
+     *
+     * @param workspaceId - Workspace ID
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of toolsets
+     *
+     * @example
+     * ```typescript
+     * // List all toolsets
+     * const { data } = await sdk.toolsets.list();
+     *
+     * // Filter by enabled status
+     * const { data } = await sdk.toolsets.list({
+     *   enabled: true,
+     *   page: 1,
+     *   limit: 10
+     * });
+     * ```
+     */
+    async list(filters) {
+        const queryParams = new URLSearchParams();
+        if (filters?.search) {
+            queryParams.append('search', filters.search);
+        }
+        if (filters?.enabled !== undefined) {
+            queryParams.append('enabled', String(filters.enabled));
+        }
+        if (filters?.isPublic !== undefined) {
+            queryParams.append('isPublic', String(filters.isPublic));
+        }
+        if (filters?.tag) {
+            queryParams.append('tag', filters.tag);
+        }
+        if (filters?.page) {
+            queryParams.append('page', filters.page.toString());
+        }
+        if (filters?.limit) {
+            queryParams.append('limit', filters.limit.toString());
+        }
+        const url = `/api/v1/toolsets${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Get a single toolset by ID
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Toolset details
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.get('toolset_abc123');
+     * console.log(data.toolset.name);
+     * ```
+     */
+    async get(id) {
+        return this.sdk.request('GET', `/api/v1/toolsets/${id}`);
+    }
+    /**
+     * Create a new toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param input - Toolset creation data
+     * @returns Created toolset
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if toolset name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.create({
+     *   name: 'customer_support_tools',
+     *   description: 'Tools for customer support agents',
+     *   tools: ['tool_id_1', 'tool_id_2'],
+     *   enabled: true,
+     *   tags: ['support', 'customer-facing']
+     * });
+     * ```
+     */
+    async create(input) {
+        return this.sdk.request('POST', `/api/v1/toolsets`, input);
+    }
+    /**
+     * Update an existing toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param input - Update data
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if new name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.update('toolset_abc123', {
+     *   description: 'Updated description',
+     *   enabled: false
+     * });
+     * ```
+     */
+    async update(id, input) {
+        return this.sdk.request('PATCH', `/api/v1/toolsets/${id}`, input);
+    }
+    /**
+     * Delete a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.delete('toolset_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    async delete(id) {
+        return this.sdk.request('DELETE', `/api/v1/toolsets/${id}`);
+    }
+    /**
+     * Add or remove tools from a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param input - Tools to add or remove
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Add tools
+     * const { data } = await sdk.toolsets.manageTools('ws_123', 'toolset_abc123', {
+     *   add: ['tool_id_3', 'tool_id_4']
+     * });
+     *
+     * // Remove tools
+     * const { data } = await sdk.toolsets.manageTools('ws_123', 'toolset_abc123', {
+     *   remove: ['tool_id_1']
+     * });
+     * ```
+     */
+    async manageTools(id, input) {
+        return this.sdk.request('PUT', `/api/v1/toolsets/${id}/tools`, input);
+    }
+    /**
+     * Set tool name/description overrides for a toolset
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @param overrides - Map of tool ID to override configuration
+     * @returns Updated toolset
+     * @throws NotFoundError if toolset doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.setOverrides('ws_123', 'toolset_abc123', {
+     *   'tool_id_1': { name: 'Custom Name', description: 'Custom description' }
+     * });
+     * ```
+     */
+    async setOverrides(id, overrides) {
+        return this.sdk.request('PUT', `/api/v1/toolsets/${id}/overrides`, overrides);
+    }
+    /**
+     * Enable a toolset (shortcut for update with enabled: true)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Toolset ID
+     * @returns Updated toolset
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.enable('toolset_abc123');
+     * console.log(data.toolset.enabled); // true
+     * ```
+     */
+    async enable(id) {
+        return this.update(id, { enabled: true });
+    }
+    /**
+     * Disable a toolset (shortcut for update with enabled: false)
+     *
+     * @param id - Toolset ID
+     * @returns Updated toolset
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.toolsets.disable('toolset_abc123');
+     * console.log(data.toolset.enabled); // false
+     * ```
+     */
+    async disable(id) {
+        return this.update(id, { enabled: false });
+    }
+}
+exports.ToolsetsModule = ToolsetsModule;
+//# sourceMappingURL=toolsets.js.map