cadenya 0.16.0

package/src/resources/tool-sets/tool-sets.ts

@@ -0,0 +1,369 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ToolSetsAPI from './tool-sets';
+import * as Shared from '../shared';
+import * as ToolsAPI from './tools';
+import {
+  ConfigHTTP,
+  ConfigMcp,
+  Tool,
+  ToolCreateParams,
+  ToolDeleteParams,
+  ToolListParams,
+  ToolRetrieveParams,
+  ToolSpec,
+  ToolSpecConfig,
+  ToolSpecContentFilter,
+  ToolUpdateParams,
+  Tools,
+  ToolsCursorPagination,
+} from './tools';
+import { APIPromise } from '../../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class ToolSets extends APIResource {
+  tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
+
+  /**
+   * Creates a new tool set in the workspace
+   */
+  create(body: ToolSetCreateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.post('/v1/tool_sets', { body, ...options });
+  }
+
+  /**
+   * Retrieves a tool set by ID from the workspace
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.get(path`/v1/tool_sets/${id}`, options);
+  }
+
+  /**
+   * Updates a tool set in the workspace
+   */
+  update(id: string, body: ToolSetUpdateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.put(path`/v1/tool_sets/${id}`, { body, ...options });
+  }
+
+  /**
+   * Lists all tool sets in the workspace
+   */
+  list(
+    query: ToolSetListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ToolSetsCursorPagination, ToolSet> {
+    return this._client.getAPIList('/v1/tool_sets', CursorPagination<ToolSet>, { query, ...options });
+  }
+
+  /**
+   * Deletes a tool set in the workspace
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/tool_sets/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Lists all events (including sync status) for a tool set
+   */
+  listEvents(
+    toolSetID: string,
+    query: ToolSetListEventsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ToolSetEventsCursorPagination, ToolSetEvent> {
+    return this._client.getAPIList(path`/v1/tool_sets/${toolSetID}/events`, CursorPagination<ToolSetEvent>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type ToolSetsCursorPagination = CursorPagination<ToolSet>;
+
+export type ToolSetEventsCursorPagination = CursorPagination<ToolSetEvent>;
+
+/**
+ * Top-level filter with simple boolean logic (no nesting)
+ */
+export interface McpToolFilter {
+  filters?: Array<McpToolFilter.Filter>;
+
+  operator?: 'OPERATOR_UNSPECIFIED' | 'OPERATOR_AND' | 'OPERATOR_OR';
+}
+
+export namespace McpToolFilter {
+  /**
+   * Single attribute filter
+   */
+  export interface Filter {
+    attribute?: 'ATTRIBUTE_UNSPECIFIED' | 'ATTRIBUTE_NAME' | 'ATTRIBUTE_TITLE' | 'ATTRIBUTE_DESCRIPTION';
+
+    /**
+     * String matching operations
+     */
+    matcher?: Filter.Matcher;
+  }
+
+  export namespace Filter {
+    /**
+     * String matching operations
+     */
+    export interface Matcher {
+      caseSensitive?: boolean;
+
+      contains?: string;
+
+      endsWith?: string;
+
+      exact?: string;
+
+      regex?: string;
+
+      startsWith?: string;
+    }
+  }
+}
+
+/**
+ * SyncCompleted is emitted when a tool set sync operation completes successfully
+ */
+export interface SyncCompleted {
+  /**
+   * Optional message with additional details
+   */
+  message?: string;
+
+  /**
+   * Number of tools synced
+   */
+  toolsSynced?: number;
+}
+
+/**
+ * SyncFailed is emitted when a tool set sync operation fails
+ */
+export interface SyncFailed {
+  /**
+   * Indicates this is an error event
+   */
+  error?: boolean;
+
+  /**
+   * Optional error type/code for programmatic handling
+   */
+  errorType?: string;
+
+  /**
+   * Error message describing what went wrong
+   */
+  message?: string;
+}
+
+/**
+ * SyncStarted is emitted when a tool set sync operation begins
+ */
+export interface SyncStarted {
+  /**
+   * Timestamp when the sync was initiated
+   */
+  message?: string;
+}
+
+export interface ToolSet {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: ToolSetSpec;
+}
+
+export interface ToolSetAdapter {
+  http?: ToolSetAdapterHTTP;
+
+  mcp?: ToolSetAdapterMcp;
+}
+
+export interface ToolSetAdapterHTTP {
+  baseUrl?: string;
+
+  headers?: { [key: string]: string };
+}
+
+export interface ToolSetAdapterMcp {
+  /**
+   * Top-level filter with simple boolean logic (no nesting)
+   */
+  excludeTools?: McpToolFilter;
+
+  headers?: { [key: string]: string };
+
+  /**
+   * Top-level filter with simple boolean logic (no nesting)
+   */
+  includeTools?: McpToolFilter;
+
+  /**
+   * Approval filters that will automatically set the approval requirement on the
+   * tools synced from the MCP server
+   */
+  toolApprovals?: ToolSetAdapterMcp.ToolApprovals;
+
+  url?: string;
+}
+
+export namespace ToolSetAdapterMcp {
+  /**
+   * Approval filters that will automatically set the approval requirement on the
+   * tools synced from the MCP server
+   */
+  export interface ToolApprovals {
+    always?: boolean;
+
+    /**
+     * Top-level filter with simple boolean logic (no nesting)
+     */
+    only?: ToolSetsAPI.McpToolFilter;
+  }
+}
+
+/**
+ * ToolSetEvent represents a single event in the tool set's operation timeline
+ */
+export interface ToolSetEvent {
+  /**
+   * ToolSetEventData represents the actual event payload for tool set operations
+   */
+  event?: ToolSetEventData;
+
+  /**
+   * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+   * runs)
+   */
+  metadata?: Shared.OperationMetadata;
+
+  /**
+   * The tool set this event is associated with
+   */
+  toolSetId?: string;
+}
+
+/**
+ * ToolSetEventData represents the actual event payload for tool set operations
+ */
+export interface ToolSetEventData {
+  /**
+   * SyncCompleted is emitted when a tool set sync operation completes successfully
+   */
+  syncCompleted?: SyncCompleted;
+
+  /**
+   * SyncFailed is emitted when a tool set sync operation fails
+   */
+  syncFailed?: SyncFailed;
+
+  /**
+   * SyncStarted is emitted when a tool set sync operation begins
+   */
+  syncStarted?: SyncStarted;
+
+  /**
+   * Type of the event (e.g., "sync_started", "sync_completed", "sync_failed")
+   */
+  type?: string;
+}
+
+export interface ToolSetSpec {
+  adapter?: ToolSetAdapter;
+
+  description?: string;
+
+  /**
+   * If a tool set is an MCP server, for example, this will be a read only field. If
+   * the adapter type is an HTTP endpoint, then you may modify this to true yourself.
+   * When a tool set is managed, all of the tools associated with it cannot be
+   * created or modified by a profile actor (ie: a human). Instead, tools within a
+   * tool set must be created/modified by an API Key type.
+   */
+  managed?: boolean;
+}
+
+export interface ToolSetCreateParams {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: ToolSetSpec;
+}
+
+export interface ToolSetUpdateParams {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: ToolSetSpec;
+
+  updateMask?: string;
+}
+
+export interface ToolSetListParams extends CursorPaginationParams {
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+}
+
+export interface ToolSetListEventsParams extends CursorPaginationParams {
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+}
+
+ToolSets.Tools = Tools;
+
+export declare namespace ToolSets {
+  export {
+    type McpToolFilter as McpToolFilter,
+    type SyncCompleted as SyncCompleted,
+    type SyncFailed as SyncFailed,
+    type SyncStarted as SyncStarted,
+    type ToolSet as ToolSet,
+    type ToolSetAdapter as ToolSetAdapter,
+    type ToolSetAdapterHTTP as ToolSetAdapterHTTP,
+    type ToolSetAdapterMcp as ToolSetAdapterMcp,
+    type ToolSetEvent as ToolSetEvent,
+    type ToolSetEventData as ToolSetEventData,
+    type ToolSetSpec as ToolSetSpec,
+    type ToolSetsCursorPagination as ToolSetsCursorPagination,
+    type ToolSetEventsCursorPagination as ToolSetEventsCursorPagination,
+    type ToolSetCreateParams as ToolSetCreateParams,
+    type ToolSetUpdateParams as ToolSetUpdateParams,
+    type ToolSetListParams as ToolSetListParams,
+    type ToolSetListEventsParams as ToolSetListEventsParams,
+  };
+
+  export {
+    Tools as Tools,
+    type ConfigHTTP as ConfigHTTP,
+    type ConfigMcp as ConfigMcp,
+    type Tool as Tool,
+    type ToolSpec as ToolSpec,
+    type ToolSpecConfig as ToolSpecConfig,
+    type ToolSpecContentFilter as ToolSpecContentFilter,
+    type ToolsCursorPagination as ToolsCursorPagination,
+    type ToolCreateParams as ToolCreateParams,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolUpdateParams as ToolUpdateParams,
+    type ToolListParams as ToolListParams,
+    type ToolDeleteParams as ToolDeleteParams,
+  };
+}

package/src/resources/tool-sets/tools.ts

@@ -0,0 +1,208 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import { APIPromise } from '../../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Tools extends APIResource {
+  /**
+   * Creates a new tool in the tool set
+   */
+  create(toolSetID: string, body: ToolCreateParams, options?: RequestOptions): APIPromise<Tool> {
+    return this._client.post(path`/v1/tool_sets/${toolSetID}/tools`, { body, ...options });
+  }
+
+  /**
+   * Retrieves a tool by ID from the workspace
+   */
+  retrieve(id: string, params: ToolRetrieveParams, options?: RequestOptions): APIPromise<Tool> {
+    const { toolSetId } = params;
+    return this._client.get(path`/v1/tool_sets/${toolSetId}/tools/${id}`, options);
+  }
+
+  /**
+   * Updates a tool in the tool set
+   */
+  update(id: string, params: ToolUpdateParams, options?: RequestOptions): APIPromise<Tool> {
+    const { toolSetId, ...body } = params;
+    return this._client.put(path`/v1/tool_sets/${toolSetId}/tools/${id}`, { body, ...options });
+  }
+
+  /**
+   * Lists all tools in the tool set
+   */
+  list(
+    toolSetID: string,
+    query: ToolListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ToolsCursorPagination, Tool> {
+    return this._client.getAPIList(path`/v1/tool_sets/${toolSetID}/tools`, CursorPagination<Tool>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Deletes a tool in the tool set
+   */
+  delete(id: string, params: ToolDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { toolSetId } = params;
+    return this._client.delete(path`/v1/tool_sets/${toolSetId}/tools/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type ToolsCursorPagination = CursorPagination<Tool>;
+
+export interface ConfigHTTP {
+  headers?: { [key: string]: string };
+
+  path?: string;
+
+  query?: string;
+
+  requestBodyContentType?: string;
+
+  /**
+   * These are only used when the request method is a POST, PUT, or PATCH
+   */
+  requestBodyTemplate?: string;
+
+  requestMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+  /**
+   * The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP
+   * adapter. This is used to match the tool spec to the correct endpoint on the HTTP
+   * adapter. it will be derived from the name of the tool if not provided.
+   */
+  toolName?: string;
+}
+
+export interface ConfigMcp {
+  toolDescription?: string;
+
+  toolName?: string;
+
+  toolTitle?: string;
+}
+
+export interface Tool {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: ToolSpec;
+}
+
+export interface ToolSpec {
+  /**
+   * Config defines the adapter to use for the tool. This is used to determine how
+   * the tool is called. For example, if the tool is an HTTP tool, the adapter will
+   * be Http. If the tool is an inline tool, the adapter will be Inline.
+   */
+  config?: ToolSpecConfig;
+
+  contentFilter?: ToolSpecContentFilter;
+
+  description?: string;
+
+  parameters?: { [key: string]: unknown };
+
+  requiresApproval?: boolean;
+
+  status?:
+    | 'TOOL_STATUS_UNSPECIFIED'
+    | 'TOOL_STATUS_AVAILABLE'
+    | 'TOOL_STATUS_FILTERED'
+    | 'TOOL_STATUS_ARCHIVED';
+
+  toolSetId?: string;
+}
+
+/**
+ * Config defines the adapter to use for the tool. This is used to determine how
+ * the tool is called. For example, if the tool is an HTTP tool, the adapter will
+ * be Http. If the tool is an inline tool, the adapter will be Inline.
+ */
+export interface ToolSpecConfig {
+  http?: ConfigHTTP;
+
+  mcp?: ConfigMcp;
+}
+
+export interface ToolSpecContentFilter {
+  jq?: string;
+
+  regex?: string;
+}
+
+export interface ToolCreateParams {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: ToolSpec;
+}
+
+export interface ToolRetrieveParams {
+  toolSetId: string;
+}
+
+export interface ToolUpdateParams {
+  /**
+   * Path param
+   */
+  toolSetId: string;
+
+  /**
+   * Body param: Standard metadata for persistent, named resources (e.g., agents,
+   * tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  /**
+   * Body param
+   */
+  spec?: ToolSpec;
+
+  /**
+   * Body param
+   */
+  updateMask?: string;
+}
+
+export interface ToolListParams extends CursorPaginationParams {
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+}
+
+export interface ToolDeleteParams {
+  toolSetId: string;
+}
+
+export declare namespace Tools {
+  export {
+    type ConfigHTTP as ConfigHTTP,
+    type ConfigMcp as ConfigMcp,
+    type Tool as Tool,
+    type ToolSpec as ToolSpec,
+    type ToolSpecConfig as ToolSpecConfig,
+    type ToolSpecContentFilter as ToolSpecContentFilter,
+    type ToolsCursorPagination as ToolsCursorPagination,
+    type ToolCreateParams as ToolCreateParams,
+    type ToolRetrieveParams as ToolRetrieveParams,
+    type ToolUpdateParams as ToolUpdateParams,
+    type ToolListParams as ToolListParams,
+    type ToolDeleteParams as ToolDeleteParams,
+  };
+}

package/src/resources/tool-sets.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './tool-sets/index';

package/src/resources/workspace-secrets.ts

@@ -0,0 +1,120 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class WorkspaceSecrets extends APIResource {
+  /**
+   * Creates a new workspace secret in the workspace
+   */
+  create(body: WorkspaceSecretCreateParams, options?: RequestOptions): APIPromise<WorkspaceSecret> {
+    return this._client.post('/v1/workspace_secrets', { body, ...options });
+  }
+
+  /**
+   * Retrieves a workspace secret by ID from the workspace
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<WorkspaceSecret> {
+    return this._client.get(path`/v1/workspace_secrets/${id}`, options);
+  }
+
+  /**
+   * Updates a workspace secret in the workspace
+   */
+  update(
+    id: string,
+    body: WorkspaceSecretUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkspaceSecret> {
+    return this._client.patch(path`/v1/workspace_secrets/${id}`, { body, ...options });
+  }
+
+  /**
+   * Lists all workspace secrets in the workspace
+   */
+  list(
+    query: WorkspaceSecretListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<WorkspaceSecretsCursorPagination, WorkspaceSecret> {
+    return this._client.getAPIList('/v1/workspace_secrets', CursorPagination<WorkspaceSecret>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Deletes a workspace secret from the workspace
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/workspace_secrets/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type WorkspaceSecretsCursorPagination = CursorPagination<WorkspaceSecret>;
+
+export interface WorkspaceSecret {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: WorkspaceSecretSpec;
+}
+
+export interface WorkspaceSecretSpec {
+  value?: string;
+}
+
+export interface WorkspaceSecretCreateParams {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: WorkspaceSecretSpec;
+}
+
+export interface WorkspaceSecretUpdateParams {
+  /**
+   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   */
+  metadata?: Shared.ResourceMetadata;
+
+  spec?: WorkspaceSecretSpec;
+
+  /**
+   * Fields to update
+   */
+  updateMask?: string;
+}
+
+export interface WorkspaceSecretListParams extends CursorPaginationParams {
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+}
+
+export declare namespace WorkspaceSecrets {
+  export {
+    type WorkspaceSecret as WorkspaceSecret,
+    type WorkspaceSecretSpec as WorkspaceSecretSpec,
+    type WorkspaceSecretsCursorPagination as WorkspaceSecretsCursorPagination,
+    type WorkspaceSecretCreateParams as WorkspaceSecretCreateParams,
+    type WorkspaceSecretUpdateParams as WorkspaceSecretUpdateParams,
+    type WorkspaceSecretListParams as WorkspaceSecretListParams,
+  };
+}