@cadenya/cadenya 0.135.0 → 1.0.0

package/src/resources/workspace-admin.ts

@@ -1 +1,281 @@
-export * from './workspace-admin/index';
+// 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 { CreateAccountResourceMetadata, ListAccountWorkspacesResponse, ListProfilesResponse, ListWorkspaceMembersResponse, Profile, UpdateAccountResourceMetadata, Workspace, WorkspaceMember, WorkspaceSpec } from '../types.js';
+
+export interface WorkspaceAdminListProfilesParams {
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Free-form search over profile name and email. Case-insensitive substring
+   *  match; empty returns all profiles.
+   */
+  query?: string;
+  /**
+   * 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 WorkspaceAdminListAccountParams {
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * When true, archived workspaces are included in the results. Defaults to
+   *  false (active workspaces only).
+   */
+  includeArchived?: 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 WorkspaceAdminCreateParams {
+  metadata: CreateAccountResourceMetadata;
+  spec: WorkspaceSpec;
+}
+
+export interface WorkspaceAdminRetrieveParams {
+  /**
+   * Workspace ID to retrieve (path).
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface WorkspaceAdminArchiveParams {
+  /**
+   * Workspace ID to archive (path).
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface WorkspaceAdminUpdateParams {
+  /**
+   * Workspace ID to update (path).
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateAccountResourceMetadata;
+  spec?: WorkspaceSpec;
+  /**
+   * Fields to update.
+   */
+  updateMask?: string;
+}
+
+export interface WorkspaceAdminListMembersParams {
+  /**
+   * The workspace whose members will be listed (path).
+   * 
+   * 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;
+}
+
+export interface WorkspaceAdminAddMemberParams {
+  /**
+   * The workspace to add the member to (path).
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * An existing account profile to add. Mutually exclusive with email.
+   */
+  profileId?: string;
+  /**
+   * Email address to add (resolve-or-invite). Mutually exclusive with profile_id.
+   */
+  email?: string;
+}
+
+export interface WorkspaceAdminRemoveMemberParams {
+  /**
+   * The workspace to remove the member from (path).
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export class WorkspaceAdmin {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * Search account profiles
+   * 
+   * @example
+   * ```ts
+   * const page = await client.workspaceAdmin.listProfiles();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listProfiles(params?: WorkspaceAdminListProfilesParams, options?: RequestOptions): Promise<Page<Profile>> {
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListProfilesResponse>({ method: 'GET', path: `/v1/account/profiles`, query: { limit: params?.limit, cursor: params?.cursor, query: params?.query, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listProfiles({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * List all workspaces in the account
+   * 
+   * @example
+   * ```ts
+   * const page = await client.workspaceAdmin.listAccount();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listAccount(params?: WorkspaceAdminListAccountParams, options?: RequestOptions): Promise<Page<Workspace>> {
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListAccountWorkspacesResponse>({ method: 'GET', path: `/v1/account/workspaces`, query: { limit: params?.limit, cursor: params?.cursor, includeArchived: params?.includeArchived, labels: params?.labels } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listAccount({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a workspace
+   * 
+   * @example
+   * ```ts
+   * const workspace = await client.workspaceAdmin.create({ metadata: { name: 'sample' }, spec: {  } });
+   * ```
+   */
+  create(params: WorkspaceAdminCreateParams, options?: RequestOptions): APIPromise<Workspace> {
+    return this._client.requestAPI<Workspace>(() => {
+      return { method: 'POST', path: `/v1/account/workspaces`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get a workspace by ID
+   * 
+   * @example
+   * ```ts
+   * const workspace = await client.workspaceAdmin.retrieve();
+   * ```
+   */
+  retrieve(params?: WorkspaceAdminRetrieveParams, options?: RequestOptions): APIPromise<Workspace> {
+    return this._client.requestAPI<Workspace>(() => {
+      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/account/workspaces/${pathSegment('workspaceId', workspaceId)}` };
+    }, options);
+  }
+
+  /**
+   * Archive a workspace
+   * 
+   * @example
+   * ```ts
+   * await client.workspaceAdmin.archive();
+   * ```
+   */
+  archive(params?: WorkspaceAdminArchiveParams, 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/account/workspaces/${pathSegment('workspaceId', workspaceId)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update a workspace
+   * 
+   * @example
+   * ```ts
+   * const workspace = await client.workspaceAdmin.update();
+   * ```
+   */
+  update(params?: WorkspaceAdminUpdateParams, options?: RequestOptions): APIPromise<Workspace> {
+    return this._client.requestAPI<Workspace>(() => {
+      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/account/workspaces/${pathSegment('workspaceId', workspaceId)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * List workspace members
+   * 
+   * @example
+   * ```ts
+   * const page = await client.workspaceAdmin.listMembers();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async listMembers(params?: WorkspaceAdminListMembersParams, options?: RequestOptions): Promise<Page<WorkspaceMember>> {
+    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<ListWorkspaceMembersResponse>({ method: 'GET', path: `/v1/account/workspaces/${pathSegment('workspaceId', workspaceId)}/members`, query: { limit: params?.limit, cursor: params?.cursor } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listMembers({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Add a member to a workspace
+   * 
+   * @example
+   * ```ts
+   * const workspaceMember = await client.workspaceAdmin.addMember();
+   * ```
+   */
+  addMember(params?: WorkspaceAdminAddMemberParams, options?: RequestOptions): APIPromise<WorkspaceMember> {
+    return this._client.requestAPI<WorkspaceMember>(() => {
+      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/account/workspaces/${pathSegment('workspaceId', workspaceId)}/members`, body: { profileId: params?.profileId, email: params?.email } };
+    }, options);
+  }
+
+  /**
+   * Remove a member from a workspace
+   * 
+   * @example
+   * ```ts
+   * await client.workspaceAdmin.removeMember('profile_123');
+   * ```
+   */
+  removeMember(profileId: string, params?: WorkspaceAdminRemoveMemberParams, 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/account/workspaces/${pathSegment('workspaceId', workspaceId)}/members/${pathSegment('profileId', profileId)}`, void: true };
+    }, options);
+  }
+}

package/src/resources/workspace-secrets.ts

@@ -1,213 +1,175 @@
-import { APIResource } from '../core/resource';
-import * as AccountAPI from './account';
-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';
+// Generated by redwood. Do not edit by hand.
 
-export class WorkspaceSecrets extends APIResource {
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { CreateResourceMetadata, ListWorkspaceSecretsResponse, UpdateResourceMetadata, WorkspaceSecret, WorkspaceSecretSpec } from '../types.js';
+
+export interface WorkspaceSecretListParams {
   /**
-   * Creates a new workspace secret in the workspace
+   * The workspace whose secrets will be listed.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
-  create(params: WorkspaceSecretCreateParams, options?: RequestOptions): APIPromise<WorkspaceSecret> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/workspace_secrets`, { body, ...options });
-  }
-
+  workspaceId?: string;
   /**
-   * Retrieves a workspace secret by ID from the workspace
+   * Maximum number of results to return
    */
-  retrieve(
-    id: string,
-    params: WorkspaceSecretRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<WorkspaceSecret> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.get(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, options);
-  }
-
+  limit?: number;
   /**
-   * Updates a workspace secret in the workspace
-   */
-  update(
-    id: string,
-    params: WorkspaceSecretUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<WorkspaceSecret> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.patch(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, {
-      body,
-      ...options,
-    });
-  }
-
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
   /**
-   * Lists all workspace secrets in the workspace
-   */
-  list(
-    params: WorkspaceSecretListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<WorkspaceSecretsCursorPagination, WorkspaceSecret> {
-    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
-    return this._client.getAPIList(
-      path`/v1/workspaces/${workspaceId}/workspace_secrets`,
-      CursorPagination<WorkspaceSecret>,
-      { query, ...options },
-    );
-  }
-
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
   /**
-   * Deletes a workspace secret from the workspace
-   */
-  delete(
-    id: string,
-    params: WorkspaceSecretDeleteParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<void> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.delete(path`/v1/workspaces/${workspaceId}/workspace_secrets/${id}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-}
-
-export type WorkspaceSecretsCursorPagination = CursorPagination<WorkspaceSecret>;
-
-export interface WorkspaceSecret {
+   * Free-form search query
+   */
+  query?: string;
   /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   * 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).
    */
-  metadata: Shared.ResourceMetadata;
-
-  spec: WorkspaceSecretSpec;
-
+  labels?: string;
   /**
-   * Workspace secret information
+   * Sort order for results (asc or desc by creation time)
    */
-  info?: WorkspaceSecretInfo;
-}
-
-export interface WorkspaceSecretInfo {
+  sortOrder?: string;
   /**
-   * 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.
+   * When set to true you may use more of your alloted API rate-limit
    */
-  createdBy?: AccountAPI.Profile;
-
-  lastUsedAt?: string;
-}
-
-export interface WorkspaceSecretSpec {
-  value?: string;
+  includeInfo?: boolean;
 }
 
 export interface WorkspaceSecretCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: WorkspaceSecretSpec;
   /**
-   * Path param: The workspace that will own this secret.
+   * The workspace that will own this secret.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   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: WorkspaceSecretSpec;
 }
 
 export interface WorkspaceSecretRetrieveParams {
   /**
    * The workspace the secret belongs to.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
 }
 
-export interface WorkspaceSecretUpdateParams {
+export interface WorkspaceSecretDeleteParams {
   /**
-   * Path param: The workspace the secret belongs to.
+   * The workspace the secret belongs to.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
+}
 
+export interface WorkspaceSecretUpdateParams {
   /**
-   * 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
+   * The workspace the secret belongs to.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
   spec?: WorkspaceSecretSpec;
-
   /**
-   * Body param: Fields to update.
+   * Fields to update.
    */
   updateMask?: string;
 }
 
-export interface WorkspaceSecretListParams extends CursorPaginationParams {
-  /**
-   * Path param: The workspace whose secrets will be listed.
-   */
-  workspaceId?: string;
-
-  /**
-   * Query param: When set to true you may use more of your alloted API rate-limit
-   */
-  includeInfo?: boolean;
-
-  /**
-   * Query param: 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 class WorkspaceSecrets {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List workspace secrets
+   * 
+   * @example
+   * ```ts
+   * const page = await client.workspaceSecrets.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: WorkspaceSecretListParams, options?: RequestOptions): Promise<Page<WorkspaceSecret>> {
+    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<ListWorkspaceSecretsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/workspace_secrets`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, 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));
+  }
 
   /**
-   * Query param: Filter expression (query param: prefix)
+   * Create a new workspace secret
+   * 
+   * @example
+   * ```ts
+   * const workspaceSecret = await client.workspaceSecrets.create({ metadata: { name: 'sample' }, spec: {  } });
+   * ```
    */
-  prefix?: string;
+  create(params: WorkspaceSecretCreateParams, options?: RequestOptions): APIPromise<WorkspaceSecret> {
+    return this._client.requestAPI<WorkspaceSecret>(() => {
+      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)}/workspace_secrets`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
 
   /**
-   * Query param: Free-form search query
+   * Get a workspace secret by ID
+   * 
+   * @example
+   * ```ts
+   * const workspaceSecret = await client.workspaceSecrets.retrieve('_123');
+   * ```
    */
-  query?: string;
+  retrieve(id: string, params?: WorkspaceSecretRetrieveParams, options?: RequestOptions): APIPromise<WorkspaceSecret> {
+    return this._client.requestAPI<WorkspaceSecret>(() => {
+      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)}/workspace_secrets/${pathSegment('id', id)}` };
+    }, options);
+  }
 
   /**
-   * Query param: Sort order for results (asc or desc by creation time)
+   * Delete a workspace secret
+   * 
+   * @example
+   * ```ts
+   * await client.workspaceSecrets.delete('_123');
+   * ```
    */
-  sortOrder?: string;
-}
+  delete(id: string, params?: WorkspaceSecretDeleteParams, 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)}/workspace_secrets/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
 
-export interface WorkspaceSecretDeleteParams {
   /**
-   * The workspace the secret belongs to.
+   * Update a workspace secret
+   * 
+   * @example
+   * ```ts
+   * const workspaceSecret = await client.workspaceSecrets.update('_123');
+   * ```
    */
-  workspaceId?: string;
-}
-
-export declare namespace WorkspaceSecrets {
-  export {
-    type WorkspaceSecret as WorkspaceSecret,
-    type WorkspaceSecretInfo as WorkspaceSecretInfo,
-    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,
-  };
+  update(id: string, params?: WorkspaceSecretUpdateParams, options?: RequestOptions): APIPromise<WorkspaceSecret> {
+    return this._client.requestAPI<WorkspaceSecret>(() => {
+      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)}/workspace_secrets/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
 }