@cadenya/cadenya 0.66.0 → 0.68.0

package/src/resources/objectives/tasks.ts

@@ -12,8 +12,11 @@ export class Tasks extends APIResource {
    * Retrieves a task by ID from an objective
    */
   retrieve(id: string, params: TaskRetrieveParams, options?: RequestOptions): APIPromise<ObjectiveTask> {
-    const { objectiveId } = params;
-    return this._client.get(path`/v1/objectives/${objectiveId}/tasks/${id}`, options);
+    const { workspaceId, objectiveId } = params;
+    return this._client.get(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tasks/${id}`,
+      options,
+    );
   }
 
   /**
@@ -21,11 +24,12 @@ export class Tasks extends APIResource {
    */
   list(
     objectiveID: string,
-    query: TaskListParams | null | undefined = {},
+    params: TaskListParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveTasksCursorPagination, ObjectiveTask> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/tasks`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/tasks`,
       CursorPagination<ObjectiveTask>,
       { query, ...options },
     );
@@ -75,6 +79,8 @@ export interface ObjectiveTaskData {
 }
 
 export interface TaskRetrieveParams {
+  workspaceId: string;
+
   /**
    * The ID of the objective. Supports "external_id:" prefix for external IDs.
    */
@@ -83,7 +89,12 @@ export interface TaskRetrieveParams {
 
 export interface TaskListParams extends CursorPaginationParams {
   /**
-   * Sort order for results
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: Sort order for results
    */
   sortOrder?: string;
 }

package/src/resources/objectives/tool-calls.ts

@@ -15,11 +15,12 @@ export class ToolCalls extends APIResource {
    */
   list(
     objectiveID: string,
-    query: ToolCallListParams | null | undefined = {},
+    params: ToolCallListParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveToolCallsCursorPagination, ObjectiveToolCall> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/tool_calls`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/tool_calls`,
       CursorPagination<ObjectiveToolCall>,
       { query, ...options },
     );
@@ -34,11 +35,11 @@ export class ToolCalls extends APIResource {
     params: ToolCallApproveParams,
     options?: RequestOptions,
   ): APIPromise<ObjectiveToolCall> {
-    const { objectiveId, ...body } = params;
-    return this._client.put(path`/v1/objectives/${objectiveId}/tool_calls/${toolCallID}/approve`, {
-      body,
-      ...options,
-    });
+    const { workspaceId, objectiveId, ...body } = params;
+    return this._client.put(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}/approve`,
+      { body, ...options },
+    );
   }
 
   /**
@@ -51,11 +52,11 @@ export class ToolCalls extends APIResource {
     params: ToolCallDenyParams,
     options?: RequestOptions,
   ): APIPromise<ObjectiveToolCall> {
-    const { objectiveId, ...body } = params;
-    return this._client.put(path`/v1/objectives/${objectiveId}/tool_calls/${toolCallID}/deny`, {
-      body,
-      ...options,
-    });
+    const { workspaceId, objectiveId, ...body } = params;
+    return this._client.put(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}/deny`,
+      { body, ...options },
+    );
   }
 }
 
@@ -120,18 +121,18 @@ export interface ObjectiveToolCallData {
   result?: string;
 
   /**
-   * Profile represents a human user at the account level. Profiles are
-   * account-scoped resources that can be associated with multiple workspaces through
-   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   * A profile identifies a user or non-human principal (such as an API key) at the
+   * account level. Profiles are account-scoped and can be granted access to multiple
+   * workspaces.
    */
   statusChangedBy?: AccountAPI.Profile;
 }
 
 export interface ObjectiveToolCallInfo {
   /**
-   * Profile represents a human user at the account level. Profiles are
-   * account-scoped resources that can be associated with multiple workspaces through
-   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   * A profile identifies a user or non-human principal (such as an API key) at the
+   * account level. Profiles are account-scoped and can be granted access to multiple
+   * workspaces.
    */
   createdBy?: AccountAPI.Profile;
 
@@ -144,12 +145,17 @@ export interface ObjectiveToolCallInfo {
 
 export interface ToolCallListParams extends CursorPaginationParams {
   /**
-   * When set to true you may use more of your alloted API rate-limit
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: When set to true you may use more of your alloted API rate-limit
    */
   includeInfo?: boolean;
 
   /**
-   * Filter by tool call status
+   * Query param: Filter by tool call status
    */
   status?:
     | 'TOOL_CALL_STATUS_UNSPECIFIED'
@@ -160,6 +166,8 @@ export interface ToolCallListParams extends CursorPaginationParams {
 }
 
 export interface ToolCallApproveParams {
+  workspaceId: string;
+
   /**
    * The ID of the objective. Supports "external_id:" prefix for external IDs.
    */
@@ -167,6 +175,11 @@ export interface ToolCallApproveParams {
 }
 
 export interface ToolCallDenyParams {
+  /**
+   * Path param
+   */
+  workspaceId: string;
+
   /**
    * Path param: The ID of the objective. Supports "external_id:" prefix for external
    * IDs.

package/src/resources/objectives/tools.ts

@@ -13,11 +13,12 @@ export class Tools extends APIResource {
    */
   list(
     objectiveID: string,
-    query: ToolListParams | null | undefined = {},
+    params: ToolListParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveToolsCursorPagination, ObjectiveTool> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/tools`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/tools`,
       CursorPagination<ObjectiveTool>,
       { query, ...options },
     );
@@ -48,7 +49,12 @@ export interface ObjectiveTool {
   snapshot?: ToolSetsToolsAPI.Tool;
 }
 
-export interface ToolListParams extends CursorPaginationParams {}
+export interface ToolListParams extends CursorPaginationParams {
+  /**
+   * Path param
+   */
+  workspaceId: string;
+}
 
 export declare namespace Tools {
   export {

package/src/resources/search.ts

@@ -6,16 +6,21 @@ import * as ToolSetsAPI from './tool-sets/tool-sets';
 import * as ToolsAPI from './tool-sets/tools';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Search extends APIResource {
   /**
    * Searches for tools or tool sets in the workspace
    */
   searchToolsOrToolSets(
+    workspaceID: string,
     query: SearchSearchToolsOrToolSetsParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<SearchSearchToolsOrToolSetsResponse> {
-    return this._client.get('/v1/search/tools_or_tool_sets', { query, ...options });
+    return this._client.get(path`/v1/workspaces/${workspaceID}/search/tools_or_tool_sets`, {
+      query,
+      ...options,
+    });
   }
 }
 

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

@@ -15,8 +15,10 @@ export {
   type ToolSetInfo,
   type ToolSetSpec,
   type ToolSetCreateParams,
+  type ToolSetRetrieveParams,
   type ToolSetUpdateParams,
   type ToolSetListParams,
+  type ToolSetDeleteParams,
   type ToolSetListEventsParams,
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,

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

@@ -27,15 +27,11 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * ToolService manages tool sets and tools at the WORKSPACE level.
- *  Tool sets group related tools, and tools define specific capabilities for agents.
- *  All operations are implicitly scoped to the workspace determined by the JWT token.
+ * Manage tool sets and the tools they contain. Tool sets group related tools,
+ *  and tools define specific capabilities available to agents.
  *
- *  Note: When a ToolSet has managed=true, only API Key actors can modify its tools.
- *  Profile actors (humans) are restricted from modifying managed tool sets.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ *  When a tool set is managed, only API key actors can modify its tools; human
+ *  (profile) actors cannot.
  */
 export class ToolSets extends APIResource {
   tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
@@ -43,39 +39,46 @@ export class ToolSets extends APIResource {
   /**
    * Creates a new tool set in the workspace
    */
-  create(body: ToolSetCreateParams, options?: RequestOptions): APIPromise<ToolSet> {
-    return this._client.post('/v1/tool_sets', { body, ...options });
+  create(workspaceID: string, body: ToolSetCreateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/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);
+  retrieve(id: string, params: ToolSetRetrieveParams, options?: RequestOptions): APIPromise<ToolSet> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/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 });
+  update(id: string, params: ToolSetUpdateParams, options?: RequestOptions): APIPromise<ToolSet> {
+    const { workspaceId, ...body } = params;
+    return this._client.put(path`/v1/workspaces/${workspaceId}/tool_sets/${id}`, { body, ...options });
   }
 
   /**
    * Lists all tool sets in the workspace
    */
   list(
+    workspaceID: string,
     query: ToolSetListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<ToolSetsCursorPagination, ToolSet> {
-    return this._client.getAPIList('/v1/tool_sets', CursorPagination<ToolSet>, { query, ...options });
+    return this._client.getAPIList(path`/v1/workspaces/${workspaceID}/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}`, {
+  delete(id: string, params: ToolSetDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { workspaceId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/tool_sets/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -86,13 +89,15 @@ export class ToolSets extends APIResource {
    */
   listEvents(
     toolSetID: string,
-    query: ToolSetListEventsParams | null | undefined = {},
+    params: ToolSetListEventsParams,
     options?: RequestOptions,
   ): PagePromise<ToolSetEventsCursorPagination, ToolSetEvent> {
-    return this._client.getAPIList(path`/v1/tool_sets/${toolSetID}/events`, CursorPagination<ToolSetEvent>, {
-      query,
-      ...options,
-    });
+    const { workspaceId, ...query } = params;
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceId}/tool_sets/${toolSetID}/events`,
+      CursorPagination<ToolSetEvent>,
+      { query, ...options },
+    );
   }
 }
 
@@ -143,46 +148,46 @@ export namespace McpToolFilter {
 }
 
 /**
- * SyncCompleted is emitted when a tool set sync operation completes successfully
+ * Emitted when a tool set sync operation completes successfully.
  */
 export interface SyncCompleted {
   /**
-   * Optional message with additional details
+   * Optional message with additional details.
    */
   message?: string;
 
   /**
-   * Number of tools synced
+   * Number of tools synced.
    */
   toolsSynced?: number;
 }
 
 /**
- * SyncFailed is emitted when a tool set sync operation fails
+ * Emitted when a tool set sync operation fails.
  */
 export interface SyncFailed {
   /**
-   * Indicates this is an error event
+   * Indicates this is an error event.
    */
   error?: boolean;
 
   /**
-   * Optional error type/code for programmatic handling
+   * Optional error type/code for programmatic handling.
    */
   errorType?: string;
 
   /**
-   * Error message describing what went wrong
+   * Error message describing what went wrong.
    */
   message?: string;
 }
 
 /**
- * SyncStarted is emitted when a tool set sync operation begins
+ * Emitted when a tool set sync operation begins.
  */
 export interface SyncStarted {
   /**
-   * Timestamp when the sync was initiated
+   * Human-readable message describing the start of the sync.
    */
   message?: string;
 }
@@ -251,7 +256,7 @@ export namespace ToolSetAdapterMcp {
 }
 
 /**
- * ToolSetEvent represents a single event in the tool set's operation timeline
+ * A single event in the tool set's operation timeline.
  */
 export interface ToolSetEvent {
   /**
@@ -261,14 +266,14 @@ export interface ToolSetEvent {
   metadata: Shared.OperationMetadata;
 
   /**
-   * ToolSetEventData represents the actual event payload for tool set operations
+   * Event payload for a tool set operation.
    */
   event?: ToolSetEventData;
 
   info?: ToolSetEvent.Info;
 
   /**
-   * The tool set this event is associated with
+   * The tool set this event is associated with.
    */
   toolSetId?: string;
 }
@@ -276,9 +281,9 @@ export interface ToolSetEvent {
 export namespace ToolSetEvent {
   export interface Info {
     /**
-     * Profile represents a human user at the account level. Profiles are
-     * account-scoped resources that can be associated with multiple workspaces through
-     * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+     * A profile identifies a user or non-human principal (such as an API key) at the
+     * account level. Profiles are account-scoped and can be granted access to multiple
+     * workspaces.
      */
     createdBy?: AccountAPI.Profile;
 
@@ -290,26 +295,26 @@ export namespace ToolSetEvent {
 }
 
 /**
- * ToolSetEventData represents the actual event payload for tool set operations
+ * Event payload for a tool set operation.
  */
 export interface ToolSetEventData {
   /**
-   * SyncCompleted is emitted when a tool set sync operation completes successfully
+   * Emitted when a tool set sync operation completes successfully.
    */
   syncCompleted?: SyncCompleted;
 
   /**
-   * SyncFailed is emitted when a tool set sync operation fails
+   * Emitted when a tool set sync operation fails.
    */
   syncFailed?: SyncFailed;
 
   /**
-   * SyncStarted is emitted when a tool set sync operation begins
+   * Emitted when a tool set sync operation begins.
    */
   syncStarted?: SyncStarted;
 
   /**
-   * Type of the event (e.g., "sync_started", "sync_completed", "sync_failed")
+   * Type of the event (e.g., "sync_started", "sync_completed", "sync_failed").
    */
   type?: string;
 }
@@ -318,9 +323,9 @@ export interface ToolSetInfo {
   agentCount?: number;
 
   /**
-   * Profile represents a human user at the account level. Profiles are
-   * account-scoped resources that can be associated with multiple workspaces through
-   * the Actor model. Authentication for profiles is handled via SSO/OAuth (WorkOS).
+   * A profile identifies a user or non-human principal (such as an API key) at the
+   * account level. Profiles are account-scoped and can be granted access to multiple
+   * workspaces.
    */
   createdBy?: AccountAPI.Profile;
 
@@ -346,16 +351,35 @@ export interface ToolSetCreateParams {
   spec: ToolSetSpec;
 }
 
+export interface ToolSetRetrieveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export interface ToolSetUpdateParams {
   /**
-   * UpdateResourceMetadata contains the user-provided fields for updating a
-   * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
-   * profile_id, created_at) are excluded since they are set by the server.
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: UpdateResourceMetadata contains the user-provided fields for
+   * updating a workspace-scoped resource. Read-only fields (id, account_id,
+   * workspace_id, profile_id, created_at) are excluded since they are set by the
+   * server.
    */
   metadata?: Shared.UpdateResourceMetadata;
 
+  /**
+   * Body param
+   */
   spec?: ToolSetSpec;
 
+  /**
+   * Body param
+   */
   updateMask?: string;
 }
 
@@ -386,14 +410,26 @@ export interface ToolSetListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
+export interface ToolSetDeleteParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export interface ToolSetListEventsParams extends CursorPaginationParams {
   /**
-   * When set to true you may use more of your alloted API rate-limit
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: When set to true you may use more of your alloted API rate-limit
    */
   includeInfo?: boolean;
 
   /**
-   * Sort order for results (asc or desc by creation time)
+   * Query param: Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
 }
@@ -417,8 +453,10 @@ export declare namespace ToolSets {
     type ToolSetsCursorPagination as ToolSetsCursorPagination,
     type ToolSetEventsCursorPagination as ToolSetEventsCursorPagination,
     type ToolSetCreateParams as ToolSetCreateParams,
+    type ToolSetRetrieveParams as ToolSetRetrieveParams,
     type ToolSetUpdateParams as ToolSetUpdateParams,
     type ToolSetListParams as ToolSetListParams,
+    type ToolSetDeleteParams as ToolSetDeleteParams,
     type ToolSetListEventsParams as ToolSetListEventsParams,
   };