@cadenya/cadenya 0.66.0 → 0.68.0

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

@@ -10,38 +10,41 @@ 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 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 });
+  create(toolSetID: string, params: ToolCreateParams, options?: RequestOptions): APIPromise<Tool> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/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);
+    const { workspaceId, toolSetId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/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 });
+    const { workspaceId, toolSetId, ...body } = params;
+    return this._client.put(path`/v1/workspaces/${workspaceId}/tool_sets/${toolSetId}/tools/${id}`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -49,21 +52,23 @@ export class Tools extends APIResource {
    */
   list(
     toolSetID: string,
-    query: ToolListParams | null | undefined = {},
+    params: ToolListParams,
     options?: RequestOptions,
   ): PagePromise<ToolsCursorPagination, Tool> {
-    return this._client.getAPIList(path`/v1/tool_sets/${toolSetID}/tools`, CursorPagination<Tool>, {
-      query,
-      ...options,
-    });
+    const { workspaceId, ...query } = params;
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceId}/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}`, {
+    const { workspaceId, toolSetId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/tool_sets/${toolSetId}/tools/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -117,9 +122,9 @@ export interface Tool {
 
 export interface ToolInfo {
   /**
-   * 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;
 
@@ -163,27 +168,45 @@ export interface ToolSpecConfig {
 
 export interface ToolCreateParams {
   /**
-   * CreateResourceMetadata contains the user-provided fields for creating 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: CreateResourceMetadata contains the user-provided fields for
+   * creating 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.CreateResourceMetadata;
 
+  /**
+   * Body param
+   */
   spec: ToolSpec;
 }
 
 export interface ToolRetrieveParams {
   /**
-   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
    */
   toolSetId: string;
 }
 
 export interface ToolUpdateParams {
   /**
-   * Path param: Tool set ID (from path). Accepts canonical ts\_… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Path param: Tool set ID. Accepts the canonical ts\_… form or the
+   * external_id:<value> form.
    */
   toolSetId: string;
 
@@ -208,43 +231,49 @@ export interface ToolUpdateParams {
 
 export interface ToolListParams extends CursorPaginationParams {
   /**
-   * Filter by bundle_key — return only resources owned by this bundle.
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: Filter by bundle_key — return only resources owned by this bundle.
    */
   bundleKey?: string;
 
   /**
-   * When set to true you may use more of your alloted API rate-limit
+   * Query param: When set to true you may use more of your alloted API rate-limit
    */
   includeInfo?: boolean;
 
   /**
-   * Filter by tool name (exact match). Multiple values are OR'd together.
+   * Query param: Filter by tool name (exact match). Multiple values are OR'd
+   * together.
    */
   names?: Array<string>;
 
   /**
-   * Filter expression (query param: prefix)
+   * Query param: Filter expression (query param: prefix)
    */
   prefix?: string;
 
   /**
-   * Free-form search query
+   * Query param: Free-form search query
    */
   query?: string;
 
   /**
-   * Filter by approval requirement. Omitted = no filter; true = only tools requiring
-   * approval; false = only tools not requiring approval.
+   * Query param: Filter by approval requirement. Omitted = no filter; true = only
+   * tools requiring approval; false = only tools not requiring approval.
    */
   requiresApproval?: 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;
 
   /**
-   * Filter by tool status. Multiple values are OR'd together.
+   * Query param: Filter by tool status. Multiple values are OR'd together.
    */
   statuses?: Array<
     'TOOL_STATUS_UNSPECIFIED' | 'TOOL_STATUS_AVAILABLE' | 'TOOL_STATUS_OMITTED' | 'TOOL_STATUS_ARCHIVED'
@@ -253,8 +282,12 @@ export interface ToolListParams extends CursorPaginationParams {
 
 export interface ToolDeleteParams {
   /**
-   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
    */
   toolSetId: string;
 }

package/src/resources/uploads.ts

@@ -8,13 +8,9 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 /**
- * UploadService issues short-lived presigned URLs for direct client-to-object-
- *  storage uploads at the WORKSPACE level. Created uploads can be referenced by
- *  id when creating or updating resources that accept binary content (e.g.,
- *  MemoryEntry).
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Issue short-lived presigned URLs for direct client-to-object-storage
+ *  uploads. Created uploads can be referenced by id when creating or updating
+ *  resources that accept binary content (e.g., MemoryEntry).
  */
 export class Uploads extends APIResource {
   /**
@@ -22,27 +18,28 @@ export class Uploads extends APIResource {
    * returned id is used to reference the upload from resources that accept binary
    * content.
    */
-  create(body: UploadCreateParams, options?: RequestOptions): APIPromise<Upload> {
-    return this._client.post('/v1/uploads', { body, ...options });
+  create(workspaceID: string, body: UploadCreateParams, options?: RequestOptions): APIPromise<Upload> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/uploads`, { body, ...options });
   }
 
   /**
    * Retrieves the current state of an upload, including its lifecycle status
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Upload> {
-    return this._client.get(path`/v1/uploads/${id}`, options);
+  retrieve(id: string, params: UploadRetrieveParams, options?: RequestOptions): APIPromise<Upload> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/uploads/${id}`, options);
   }
 }
 
 /**
- * Upload is a workspace-scoped handle representing a single file upload flow.
- * Clients call CreateUpload to receive a short-lived presigned URL, PUT the file
- * directly to object storage, then reference the upload by id when creating or
- * updating resources that accept binary content.
+ * A handle representing a single file upload flow. Clients call CreateUpload to
+ * receive a short-lived presigned URL, PUT the file directly to object storage,
+ * then reference the upload by id when creating or updating resources that accept
+ * binary content.
  *
- * Uploads are one-shot: once consumed by a creating or updating resource, the
+ * Uploads are one-shot: once consumed by a creating or updating resource the
  * upload transitions to UPLOAD_STATUS_CONSUMED and cannot be reused. Unused
- * uploads expire and are garbage-collected by the runtime.
+ * uploads expire and are garbage-collected.
  */
 export interface Upload {
   info: UploadInfo;
@@ -57,9 +54,9 @@ export interface Upload {
 
 export interface UploadInfo {
   /**
-   * 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;
 
@@ -118,11 +115,19 @@ export interface UploadCreateParams {
   spec: UploadSpec;
 }
 
+export interface UploadRetrieveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export declare namespace Uploads {
   export {
     type Upload as Upload,
     type UploadInfo as UploadInfo,
     type UploadSpec as UploadSpec,
     type UploadCreateParams as UploadCreateParams,
+    type UploadRetrieveParams as UploadRetrieveParams,
   };
 }

package/src/resources/workspace-secrets.ts

@@ -13,15 +13,24 @@ 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 });
+  create(
+    workspaceID: string,
+    body: WorkspaceSecretCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkspaceSecret> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/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);
+  retrieve(
+    id: string,
+    params: WorkspaceSecretRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<WorkspaceSecret> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, options);
   }
 
   /**
@@ -29,30 +38,37 @@ export class WorkspaceSecrets extends APIResource {
    */
   update(
     id: string,
-    body: WorkspaceSecretUpdateParams,
+    params: WorkspaceSecretUpdateParams,
     options?: RequestOptions,
   ): APIPromise<WorkspaceSecret> {
-    return this._client.patch(path`/v1/workspace_secrets/${id}`, { body, ...options });
+    const { workspaceId, ...body } = params;
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, {
+      body,
+      ...options,
+    });
   }
 
   /**
    * Lists all workspace secrets in the workspace
    */
   list(
+    workspaceID: string,
     query: WorkspaceSecretListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<WorkspaceSecretsCursorPagination, WorkspaceSecret> {
-    return this._client.getAPIList('/v1/workspace_secrets', CursorPagination<WorkspaceSecret>, {
-      query,
-      ...options,
-    });
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceID}/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}`, {
+  delete(id: string, params: WorkspaceSecretDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { workspaceId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -77,9 +93,9 @@ export interface WorkspaceSecret {
 
 export interface WorkspaceSecretInfo {
   /**
-   * 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;
 
@@ -101,18 +117,34 @@ export interface WorkspaceSecretCreateParams {
   spec: WorkspaceSecretSpec;
 }
 
+export interface WorkspaceSecretRetrieveParams {
+  /**
+   * The workspace the secret belongs to.
+   */
+  workspaceId: string;
+}
+
 export interface WorkspaceSecretUpdateParams {
   /**
-   * 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: The workspace the secret belongs to.
+   */
+  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?: WorkspaceSecretSpec;
 
   /**
-   * Fields to update
+   * Body param: Fields to update.
    */
   updateMask?: string;
 }
@@ -144,6 +176,13 @@ export interface WorkspaceSecretListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
+export interface WorkspaceSecretDeleteParams {
+  /**
+   * The workspace the secret belongs to.
+   */
+  workspaceId: string;
+}
+
 export declare namespace WorkspaceSecrets {
   export {
     type WorkspaceSecret as WorkspaceSecret,
@@ -151,7 +190,9 @@ export declare namespace WorkspaceSecrets {
     type WorkspaceSecretSpec as WorkspaceSecretSpec,
     type WorkspaceSecretsCursorPagination as WorkspaceSecretsCursorPagination,
     type WorkspaceSecretCreateParams as WorkspaceSecretCreateParams,
+    type WorkspaceSecretRetrieveParams as WorkspaceSecretRetrieveParams,
     type WorkspaceSecretUpdateParams as WorkspaceSecretUpdateParams,
     type WorkspaceSecretListParams as WorkspaceSecretListParams,
+    type WorkspaceSecretDeleteParams as WorkspaceSecretDeleteParams,
   };
 }

package/src/resources/workspaces.ts

@@ -7,12 +7,8 @@ import { CursorPagination, type CursorPaginationParams, PagePromise } from '../c
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * WorkspaceService manages workspaces at the ACCOUNT level.
- *  This service is responsible for creating and listing workspaces within an account.
- *  Workspaces provide organizational grouping for resources within an account.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Account-level operations (manages workspaces themselves, not resources within workspaces)
+ * Manage workspaces within an account. Workspaces provide organizational
+ *  grouping and isolation for resources such as agents, tools, and API keys.
  */
 export class Workspaces extends APIResource {
   /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.68.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.68.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.66.0";
+export declare const VERSION = "0.68.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.66.0'; // x-release-please-version
+exports.VERSION = '0.68.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.66.0'; // x-release-please-version
+export const VERSION = '0.68.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map