@cadenya/cadenya 0.134.0 → 1.0.0

package/src/resources/tool-sets.ts

@@ -1,3 +1,355 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by redwood. Do not edit by hand.
 
-export * from './tool-sets/index';
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import { ToolSetSecrets } from './tool-set-secrets.js';
+import { Tools } from './tools.js';
+import type { CreateResourceMetadata, GetToolSetOpenAPISpecResponse, ListToolSetEventsResponse, ListToolSetUsageResponse, ListToolSetsResponse, ToolServiceListToolSetsState, ToolSet, ToolSetEvent, ToolSetSpec, ToolSetUsage, UpdateResourceMetadata } from '../types.js';
+
+export interface ToolSetListParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * Filter by tool set lifecycle state. Defaults to STATE_ACTIVE when
+   *  unspecified; pass STATE_ARCHIVED to list archived tool sets.
+   */
+  state?: ToolServiceListToolSetsState;
+  /**
+   * Filters by metadata labels. Comma-separated key=value pairs,
+   *  e.g. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
+   */
+  labels?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+}
+
+export interface ToolSetCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: ToolSetSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: ToolSetSpec;
+  updateMask?: string;
+}
+
+export interface ToolSetArchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetUnarchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetListEventsParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+  /**
+   * Filters by metadata labels. Comma-separated key=value pairs,
+   *  e.g. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
+   */
+  labels?: string;
+}
+
+export interface ToolSetRetrieveOpenApiSpecParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolSetListUsageParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * When set, lists only variations with a direct assignment of this
+   *  individual tool. When unset, lists variations assigned the whole tool
+   *  set. The tool must belong to the tool set.
+   */
+  toolId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Sort order for results (asc or desc by assignment creation time)
+   */
+  sortOrder?: string;
+}
+
+export class ToolSets {
+  readonly secrets: ToolSetSecrets;
+  readonly tools: Tools;
+  constructor(private readonly _client: HttpClient) {
+    this.secrets = new ToolSetSecrets(_client);
+    this.tools = new Tools(_client);
+  }
+
+  /**
+   * List tool sets
+   * 
+   * @example
+   * ```ts
+   * const page = await client.toolSets.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: ToolSetListParams, options?: RequestOptions): Promise<Page<ToolSet>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListToolSetsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, state: params?.state, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new tool set
+   * 
+   * @example
+   * ```ts
+   * const toolSet = await client.toolSets.create({ metadata: { name: 'sample' }, spec: { adapter: { mcp: {  }, type: 'mcp' } } });
+   * ```
+   */
+  create(params: ToolSetCreateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.requestAPI<ToolSet>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a tool set by ID
+   * 
+   * @example
+   * ```ts
+   * const toolSet = await client.toolSets.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: ToolSetRetrieveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.requestAPI<ToolSet>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a tool set
+   * 
+   * @example
+   * ```ts
+   * await client.toolSets.delete('_123');
+   * ```
+   */
+  delete(id: string, params?: ToolSetDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a tool set
+   * 
+   * @example
+   * ```ts
+   * const toolSet = await client.toolSets.update('_123');
+   * ```
+   */
+  update(id: string, params?: ToolSetUpdateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.requestAPI<ToolSet>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Archive a tool set
+   * 
+   * @example
+   * ```ts
+   * const toolSet = await client.toolSets.archive('_123');
+   * ```
+   */
+  archive(id: string, params?: ToolSetArchiveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.requestAPI<ToolSet>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('id', id)}:archive` };
+    }, options);
+  }
+
+  /**
+   * Unarchive a tool set
+   * 
+   * @example
+   * ```ts
+   * const toolSet = await client.toolSets.unarchive('_123');
+   * ```
+   */
+  unarchive(id: string, params?: ToolSetUnarchiveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.requestAPI<ToolSet>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('id', id)}:unarchive` };
+    }, options);
+  }
+
+  /**
+   * List tool set events
+   * 
+   * @example
+   * ```ts
+   * const page = await client.toolSets.listEvents('tool_set_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listEvents(toolSetId: string, params?: ToolSetListEventsParams, options?: RequestOptions): Promise<Page<ToolSetEvent>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListToolSetEventsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/events`, query: { limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listEvents(toolSetId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Get consumed OpenAPI spec
+   * 
+   * @example
+   * ```ts
+   * const getToolSetOpenApiSpecResponse = await client.toolSets.retrieveOpenApiSpec('tool_set_123');
+   * ```
+   */
+  retrieveOpenApiSpec(toolSetId: string, params?: ToolSetRetrieveOpenApiSpecParams, options?: RequestOptions): APIPromise<GetToolSetOpenAPISpecResponse> {
+    return this._client.requestAPI<GetToolSetOpenAPISpecResponse>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/openapi_spec` };
+    }, options);
+  }
+
+  /**
+   * List tool set usage
+   * 
+   * @example
+   * ```ts
+   * const page = await client.toolSets.listUsage('tool_set_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listUsage(toolSetId: string, params?: ToolSetListUsageParams, options?: RequestOptions): Promise<Page<ToolSetUsage>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListToolSetUsageResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/usage`, query: { toolId: params?.toolId, limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listUsage(toolSetId, { ..._base, cursor: cursor }, options));
+  }
+}

package/src/resources/tools.ts

@@ -0,0 +1,235 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { CreateResourceMetadata, ListToolsResponse, Tool, ToolServiceListToolsStates, ToolSpec, UpdateResourceMetadata } from '../types.js';
+
+export interface ToolListParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * Filter by tool name (exact match). Multiple values are OR'd together.
+   */
+  names?: Array<string>;
+  /**
+   * Filter by tool state. Multiple values are OR'd together.
+   */
+  states?: Array<ToolServiceListToolsStates>;
+  /**
+   * Filter by approval requirement. Omitted = no filter; true = only tools
+   *  requiring approval; false = only tools not requiring approval.
+   */
+  requiresApproval?: boolean;
+  /**
+   * Filters by metadata labels. Comma-separated key=value pairs,
+   *  e.g. "env=prod,team=ai". A resource matches only if every pair
+   *  matches exactly (AND semantics).
+   */
+  labels?: string;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When set to true you may use more of your alloted API rate-limit
+   */
+  includeInfo?: boolean;
+}
+
+export interface ToolCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: ToolSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: ToolSpec;
+  updateMask?: string;
+}
+
+export interface ToolOmitParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface ToolRestoreParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export class Tools {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List tools
+   * 
+   * @example
+   * ```ts
+   * const page = await client.toolSets.tools.list('tool_set_123');
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(toolSetId: string, params?: ToolListParams, options?: RequestOptions): Promise<Page<Tool>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListToolsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, names: params?.names, states: params?.states, requiresApproval: params?.requiresApproval, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list(toolSetId, { ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new tool
+   * 
+   * @example
+   * ```ts
+   * const tool = await client.toolSets.tools.create('tool_set_123', { metadata: { name: 'sample' }, spec: { config: { http: { requestMethod: 'HTTP_METHOD_UNSPECIFIED' }, type: 'http' }, description: 'sample', parameters: {  }, requiresApproval: true } });
+   * ```
+   */
+  create(toolSetId: string, params: ToolCreateParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.requestAPI<Tool>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a tool by ID
+   * 
+   * @example
+   * ```ts
+   * const tool = await client.toolSets.tools.retrieve('tool_set_123', '_123');
+   * ```
+   */
+  retrieve(toolSetId: string, id: string, params?: ToolRetrieveParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.requestAPI<Tool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete a tool
+   * 
+   * @example
+   * ```ts
+   * await client.toolSets.tools.delete('tool_set_123', '_123');
+   * ```
+   */
+  delete(toolSetId: string, id: string, params?: ToolDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a tool
+   * 
+   * @example
+   * ```ts
+   * const tool = await client.toolSets.tools.update('tool_set_123', '_123');
+   * ```
+   */
+  update(toolSetId: string, id: string, params?: ToolUpdateParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.requestAPI<Tool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Omit a tool
+   * 
+   * @example
+   * ```ts
+   * const tool = await client.toolSets.tools.omit('tool_set_123', '_123');
+   * ```
+   */
+  omit(toolSetId: string, id: string, params?: ToolOmitParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.requestAPI<Tool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools/${pathSegment('id', id)}:omit` };
+    }, options);
+  }
+
+  /**
+   * Restore a tool
+   * 
+   * @example
+   * ```ts
+   * const tool = await client.toolSets.tools.restore('tool_set_123', '_123');
+   * ```
+   */
+  restore(toolSetId: string, id: string, params?: ToolRestoreParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.requestAPI<Tool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/tool_sets/${pathSegment('toolSetId', toolSetId)}/tools/${pathSegment('id', id)}:restore` };
+    }, options);
+  }
+}