@cadenya/cadenya 0.66.0 → 0.68.0

package/src/resources/bulk-workspace-resources/bulk-workspace-resources.ts

@@ -32,14 +32,9 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * BulkWorkspaceResources is the workspace-scoped service that applies
- *  a declarative bundle of workspace resources (tool sets, memory
- *  layers, agents, variations, assignments, schedules) in one async
- *  operation. See docs/superpowers/specs/2026-05-02-bulk-workspace-resources-design.md
- *  for the full design.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Apply a declarative bundle of workspace resources — tool sets, memory
+ *  layers, agents, variations, assignments, and schedules — in a single
+ *  asynchronous operation.
  */
 export class BulkWorkspaceResources extends APIResource {
   results: ResultsAPI.Results = new ResultsAPI.Results(this._client);
@@ -47,29 +42,43 @@ export class BulkWorkspaceResources extends APIResource {
   /**
    * Retrieves a bulk workspace apply operation by ID.
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<BulkWorkspaceApply> {
-    return this._client.get(path`/v1/bulk_workspace_applies/${id}`, options);
+  retrieve(
+    id: string,
+    params: BulkWorkspaceResourceRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<BulkWorkspaceApply> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/bulk_workspace_applies/${id}`, options);
   }
 
   /**
    * Lists past and in-flight bulk workspace apply operations in the workspace.
    */
   list(
+    workspaceID: string,
     query: BulkWorkspaceResourceListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<BulkWorkspaceAppliesCursorPagination, BulkWorkspaceApply> {
-    return this._client.getAPIList('/v1/bulk_workspace_applies', CursorPagination<BulkWorkspaceApply>, {
-      query,
-      ...options,
-    });
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceID}/bulk_workspace_applies`,
+      CursorPagination<BulkWorkspaceApply>,
+      { query, ...options },
+    );
   }
 
   /**
    * Asynchronously applies a declarative bundle of workspace resources. Returns the
    * operation immediately in PENDING; clients poll Get to track progress.
    */
-  apply(body: BulkWorkspaceResourceApplyParams, options?: RequestOptions): APIPromise<BulkWorkspaceApply> {
-    return this._client.post('/v1/bulk_workspace_applies', { body, ...options });
+  apply(
+    workspaceID: string,
+    body: BulkWorkspaceResourceApplyParams,
+    options?: RequestOptions,
+  ): APIPromise<BulkWorkspaceApply> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/bulk_workspace_applies`, {
+      body,
+      ...options,
+    });
   }
 }
 
@@ -124,17 +133,15 @@ export interface AgentVariationEntry {
   labels?: { [key: string]: string };
 
   /**
-   * Reconciled list — capped at 10 to match the existing variation
-   * memory-layer-assignment cap.
+   * Reconciled list of memory layer assignments. Up to 10 entries.
    */
   memoryLayers?: Array<VariationMemoryLayerEntry>;
 }
 
 /**
- * BulkWorkspaceApply is the operation resource produced by a call to
- * BulkWorkspaceResources.Apply. It is operation-typed (uses OperationMetadata,
- * like Objective and ObjectiveEvent) and carries the input bundle in `data`, the
- * lifecycle state in `status`, and aggregate counts in `info`.
+ * The operation resource produced by a call to BulkWorkspaceResources.Apply. It
+ * carries the input bundle in `data`, the lifecycle state in `status`, and
+ * aggregate counts in `info`.
  */
 export interface BulkWorkspaceApply {
   data: BulkWorkspaceApplyData;
@@ -199,9 +206,9 @@ export interface BulkWorkspaceApplyInfo {
   completedAt?: 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.
    */
   createdBy?: AccountAPI.Profile;
 
@@ -352,6 +359,13 @@ export interface VariationMemoryLayerEntry {
   position?: number;
 }
 
+export interface BulkWorkspaceResourceRetrieveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export interface BulkWorkspaceResourceListParams extends CursorPaginationParams {
   /**
    * Filter by bundle_key — list every apply for a given bundle.
@@ -399,6 +413,7 @@ export declare namespace BulkWorkspaceResources {
     type VariationAssignmentEntry as VariationAssignmentEntry,
     type VariationMemoryLayerEntry as VariationMemoryLayerEntry,
     type BulkWorkspaceAppliesCursorPagination as BulkWorkspaceAppliesCursorPagination,
+    type BulkWorkspaceResourceRetrieveParams as BulkWorkspaceResourceRetrieveParams,
     type BulkWorkspaceResourceListParams as BulkWorkspaceResourceListParams,
     type BulkWorkspaceResourceApplyParams as BulkWorkspaceResourceApplyParams,
   };

package/src/resources/bulk-workspace-resources/index.ts

@@ -15,6 +15,7 @@ export {
   type ToolSetEntry,
   type VariationAssignmentEntry,
   type VariationMemoryLayerEntry,
+  type BulkWorkspaceResourceRetrieveParams,
   type BulkWorkspaceResourceListParams,
   type BulkWorkspaceResourceApplyParams,
   type BulkWorkspaceAppliesCursorPagination,

package/src/resources/bulk-workspace-resources/results.ts

@@ -14,14 +14,9 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * BulkWorkspaceResources is the workspace-scoped service that applies
- *  a declarative bundle of workspace resources (tool sets, memory
- *  layers, agents, variations, assignments, schedules) in one async
- *  operation. See docs/superpowers/specs/2026-05-02-bulk-workspace-resources-design.md
- *  for the full design.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Apply a declarative bundle of workspace resources — tool sets, memory
+ *  layers, agents, variations, assignments, and schedules — in a single
+ *  asynchronous operation.
  */
 export class Results extends APIResource {
   /**
@@ -29,11 +24,12 @@ export class Results extends APIResource {
    */
   list(
     bulkWorkspaceApplyID: string,
-    query: ResultListParams | null | undefined = {},
+    params: ResultListParams,
     options?: RequestOptions,
   ): PagePromise<BulkWorkspaceApplyResultsCursorPagination, BulkWorkspaceApplyResult> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/bulk_workspace_applies/${bulkWorkspaceApplyID}/results`,
+      path`/v1/workspaces/${workspaceId}/bulk_workspace_applies/${bulkWorkspaceApplyID}/results`,
       CursorPagination<BulkWorkspaceApplyResult>,
       { query, ...options },
     );
@@ -43,19 +39,17 @@ export class Results extends APIResource {
 export type BulkWorkspaceApplyResultsCursorPagination = CursorPagination<BulkWorkspaceApplyResult>;
 
 /**
- * BulkWorkspaceApplyResult is one row of the per-resource result list for a
- * BulkWorkspaceApply. Each row is itself an operation (OperationMetadata-typed) so
- * it can be paginated, sorted by created_at, and individually addressed. Mirrors
- * the Objective → ObjectiveEvent relationship.
+ * One row of the per-resource result list for a BulkWorkspaceApply. Each row is
+ * itself an operation that can be paginated, sorted by created_at, and addressed
+ * individually.
  */
 export interface BulkWorkspaceApplyResult {
   /**
-   * BulkWorkspaceApplyResultData carries the outcome for a single resource. The
-   * `type` field is the discriminator string that names the populated `outcome`
-   * oneof variant (e.g., "toolSet", "memoryEntry"). Every Outcome shell carries an
-   * `action` enum and either a resulting resource snapshot (for ACTION_CREATED /
-   * ACTION_UPDATED / ACTION_UNCHANGED / ACTION_DELETED) or a google.rpc.Status (for
-   * ACTION_FAILED).
+   * Outcome for a single resource within a bulk apply. The `type` field is the
+   * discriminator string naming the populated `outcome` oneof variant (e.g.,
+   * "toolSet", "memoryEntry"). Every outcome shell carries an `action` enum and
+   * either a resulting resource snapshot (for ACTION_CREATED, ACTION_UPDATED,
+   * ACTION_UNCHANGED, ACTION_DELETED) or a google.rpc.Status (for ACTION_FAILED).
    */
   data: BulkWorkspaceApplyResultData;
 
@@ -67,12 +61,11 @@ export interface BulkWorkspaceApplyResult {
 }
 
 /**
- * BulkWorkspaceApplyResultData carries the outcome for a single resource. The
- * `type` field is the discriminator string that names the populated `outcome`
- * oneof variant (e.g., "toolSet", "memoryEntry"). Every Outcome shell carries an
- * `action` enum and either a resulting resource snapshot (for ACTION_CREATED /
- * ACTION_UPDATED / ACTION_UNCHANGED / ACTION_DELETED) or a google.rpc.Status (for
- * ACTION_FAILED).
+ * Outcome for a single resource within a bulk apply. The `type` field is the
+ * discriminator string naming the populated `outcome` oneof variant (e.g.,
+ * "toolSet", "memoryEntry"). Every outcome shell carries an `action` enum and
+ * either a resulting resource snapshot (for ACTION_CREATED, ACTION_UPDATED,
+ * ACTION_UNCHANGED, ACTION_DELETED) or a google.rpc.Status (for ACTION_FAILED).
  */
 export interface BulkWorkspaceApplyResultData {
   agent?: BulkWorkspaceApplyResultDataAgentOutcome;
@@ -642,15 +635,14 @@ export interface BulkWorkspaceApplyResultDataVariationAssignmentOutcome {
   error?: BulkWorkspaceApplyResultDataVariationAssignmentOutcome.Error;
 
   /**
-   * VariationAssignment is a read-only reference to a single tool, tool set, or
-   * sub-agent attached to a variation. Clients read the full set of assignments via
+   * A read-only reference to a single tool, tool set, or sub-agent attached to a
+   * variation. Read the full set of assignments via
    * `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove
-   * assignment endpoints under
-   * /v1/agents/{agent_id}/variations/{variation_id}/assignments.
+   * assignment endpoints.
    *
-   * The `id` identifies the assignment row itself (not the referenced resource) and
-   * is the handle used to remove the assignment. It is returned by the add endpoint
-   * and present on every entry in AgentVariationInfo.assignments.
+   * The `id` identifies the assignment itself (not the referenced resource) and is
+   * the handle used to remove the assignment. It is returned by the add endpoint and
+   * present on every entry in `AgentVariationInfo.assignments`.
    */
   resource?: VariationsAPI.VariationAssignment;
 }
@@ -781,7 +773,12 @@ export namespace BulkWorkspaceApplyResultDataVariationMemoryLayerOutcome {
 
 export interface ResultListParams extends CursorPaginationParams {
   /**
-   * Filter by action.
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: Filter by action.
    */
   action?:
     | 'ACTION_UNSPECIFIED'
@@ -792,12 +789,12 @@ export interface ResultListParams extends CursorPaginationParams {
     | 'ACTION_FAILED';
 
   /**
-   * 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 data.type discriminator (e.g., "toolSet", "memoryEntry").
+   * Query param: Filter by data.type discriminator (e.g., "toolSet", "memoryEntry").
    */
   type?: string;
 }

package/src/resources/index.ts

@@ -7,8 +7,11 @@ export {
   type APIKeyInfo,
   type APIKeySpec,
   type APIKeyCreateParams,
+  type APIKeyRetrieveParams,
   type APIKeyUpdateParams,
   type APIKeyListParams,
+  type APIKeyDeleteParams,
+  type APIKeyRotateParams,
   type APIKeysCursorPagination,
 } from './api-keys';
 export {
@@ -26,8 +29,10 @@ export {
   type AgentSpec,
   type Page,
   type AgentCreateParams,
+  type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
+  type AgentDeleteParams,
   type AgentsCursorPagination,
 } from './agents/agents';
 export {
@@ -45,6 +50,7 @@ export {
   type ToolSetEntry,
   type VariationAssignmentEntry,
   type VariationMemoryLayerEntry,
+  type BulkWorkspaceResourceRetrieveParams,
   type BulkWorkspaceResourceListParams,
   type BulkWorkspaceResourceApplyParams,
   type BulkWorkspaceAppliesCursorPagination,
@@ -55,14 +61,17 @@ export {
   type MemoryLayerInfo,
   type MemoryLayerSpec,
   type MemoryLayerCreateParams,
+  type MemoryLayerRetrieveParams,
   type MemoryLayerUpdateParams,
   type MemoryLayerListParams,
+  type MemoryLayerDeleteParams,
   type MemoryLayersCursorPagination,
 } from './memory-layers/memory-layers';
 export {
   Models,
   type Model,
   type ModelSpec,
+  type ModelRetrieveParams,
   type ModelListParams,
   type ModelSetStatusParams,
   type ModelsCursorPagination,
@@ -98,6 +107,7 @@ export {
   type ObjectiveContinueResponse,
   type ObjectiveListEventsResponse,
   type ObjectiveCreateParams,
+  type ObjectiveRetrieveParams,
   type ObjectiveListParams,
   type ObjectiveCancelParams,
   type ObjectiveCompactParams,
@@ -128,13 +138,22 @@ export {
   type ToolSetInfo,
   type ToolSetSpec,
   type ToolSetCreateParams,
+  type ToolSetRetrieveParams,
   type ToolSetUpdateParams,
   type ToolSetListParams,
+  type ToolSetDeleteParams,
   type ToolSetListEventsParams,
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets/tool-sets';
-export { Uploads, type Upload, type UploadInfo, type UploadSpec, type UploadCreateParams } from './uploads';
+export {
+  Uploads,
+  type Upload,
+  type UploadInfo,
+  type UploadSpec,
+  type UploadCreateParams,
+  type UploadRetrieveParams,
+} from './uploads';
 export { Webhooks, type UnsafeUnwrapWebhookEvent, type UnwrapWebhookEvent } from './webhooks';
 export {
   WorkspaceSecrets,
@@ -142,8 +161,10 @@ export {
   type WorkspaceSecretInfo,
   type WorkspaceSecretSpec,
   type WorkspaceSecretCreateParams,
+  type WorkspaceSecretRetrieveParams,
   type WorkspaceSecretUpdateParams,
   type WorkspaceSecretListParams,
+  type WorkspaceSecretDeleteParams,
   type WorkspaceSecretsCursorPagination,
 } from './workspace-secrets';
 export {

package/src/resources/memory-layers/entries.ts

@@ -10,16 +10,10 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * MemoryService manages memory layers and their entries at the WORKSPACE level.
- *  Layers are named containers that can be composed into an objective's memory
- *  stack; entries are the keyed values within a layer.
- *
- *  All operations are implicitly scoped to the workspace determined by the JWT
- *  token. System-managed layers (e.g., episodic layers created by the runtime)
- *  cannot be mutated through this API.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Manage memory layers and their entries. Layers are named containers that can
+ *  be composed into an objective's memory stack; entries are the keyed values
+ *  within a layer. System-managed layers (e.g., episodic layers created by the
+ *  runtime) cannot be mutated through this API.
  */
 export class Entries extends APIResource {
   /**
@@ -28,10 +22,14 @@ export class Entries extends APIResource {
    */
   create(
     memoryLayerID: string,
-    body: EntryCreateParams,
+    params: EntryCreateParams,
     options?: RequestOptions,
   ): APIPromise<MemoryEntryDetail> {
-    return this._client.post(path`/v1/memory_layers/${memoryLayerID}/entries`, { body, ...options });
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -39,8 +37,11 @@ export class Entries extends APIResource {
    * including the content body.
    */
   retrieve(id: string, params: EntryRetrieveParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
-    const { memoryLayerId } = params;
-    return this._client.get(path`/v1/memory_layers/${memoryLayerId}/entries/${id}`, options);
+    const { workspaceId, memoryLayerId } = params;
+    return this._client.get(
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      options,
+    );
   }
 
   /**
@@ -48,8 +49,11 @@ export class Entries extends APIResource {
    * resolved content body.
    */
   update(id: string, params: EntryUpdateParams, options?: RequestOptions): APIPromise<MemoryEntryDetail> {
-    const { memoryLayerId, ...body } = params;
-    return this._client.patch(path`/v1/memory_layers/${memoryLayerId}/entries/${id}`, { body, ...options });
+    const { workspaceId, memoryLayerId, ...body } = params;
+    return this._client.patch(
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      { body, ...options },
+    );
   }
 
   /**
@@ -57,11 +61,12 @@ export class Entries extends APIResource {
    */
   list(
     memoryLayerID: string,
-    query: EntryListParams | null | undefined = {},
+    params: EntryListParams,
     options?: RequestOptions,
   ): PagePromise<MemoryEntriesCursorPagination, MemoryEntry> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/memory_layers/${memoryLayerID}/entries`,
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerID}/entries`,
       CursorPagination<MemoryEntry>,
       { query, ...options },
     );
@@ -71,11 +76,11 @@ export class Entries extends APIResource {
    * Deletes a memory entry from a memory layer
    */
   delete(id: string, params: EntryDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { memoryLayerId } = params;
-    return this._client.delete(path`/v1/memory_layers/${memoryLayerId}/entries/${id}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+    const { workspaceId, memoryLayerId } = params;
+    return this._client.delete(
+      path`/v1/workspaces/${workspaceId}/memory_layers/${memoryLayerId}/entries/${id}`,
+      { ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
+    );
   }
 }
 
@@ -164,9 +169,9 @@ export interface MemoryEntryDetail {
 
 export interface MemoryEntryInfo {
   /**
-   * 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;
 
@@ -229,32 +234,44 @@ export interface MemoryEntryUpdateSpec {
 
 export interface EntryCreateParams {
   /**
-   * 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
+   */
+  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;
 
   /**
-   * MemoryEntryCreateSpec is the input shape for CreateMemoryEntry. It accepts
-   * either inline content or a reference to a completed Upload; exactly one of the
-   * two must be set.
+   * Body param: MemoryEntryCreateSpec is the input shape for CreateMemoryEntry. It
+   * accepts either inline content or a reference to a completed Upload; exactly one
+   * of the two must be set.
    */
   spec: MemoryEntryCreateSpec;
 }
 
 export interface EntryRetrieveParams {
+  workspaceId: string;
+
   /**
-   * Memory layer ID (from path). Accepts canonical memlyr\_… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
    */
   memoryLayerId: string;
 }
 
 export interface EntryUpdateParams {
   /**
-   * Path param: Memory layer ID (from path). Accepts canonical memlyr\_… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Path param: Memory layer ID. Accepts canonical memlyr\_… form or
+   * external_id:<value> form.
    */
   memoryLayerId: string;
 
@@ -282,36 +299,42 @@ export interface EntryUpdateParams {
 
 export interface EntryListParams extends CursorPaginationParams {
   /**
-   * Filter by bundle_key — return only resources owned by this bundle.
+   * Path param
+   */
+  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 key prefix (e.g., "skills/postmortem/" to list all entries under that
-   * hierarchy). Matches against the entry's key, not its name.
+   * Query param: Filter by key prefix (e.g., "skills/postmortem/" to list all
+   * entries under that hierarchy). Matches against the entry's key, not its name.
    */
   prefix?: string;
 
   /**
-   * Free-form search query
+   * Query param: Free-form search query
    */
   query?: string;
 
   /**
-   * Sort order for results (asc or desc by creation time)
+   * Query param: Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
 }
 
 export interface EntryDeleteParams {
+  workspaceId: string;
+
   /**
-   * Memory layer ID (from path). Accepts canonical memlyr\_… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Memory layer ID. Accepts canonical memlyr\_… form or external_id:<value> form.
    */
   memoryLayerId: string;
 }

package/src/resources/memory-layers/index.ts

@@ -21,7 +21,9 @@ export {
   type MemoryLayerInfo,
   type MemoryLayerSpec,
   type MemoryLayerCreateParams,
+  type MemoryLayerRetrieveParams,
   type MemoryLayerUpdateParams,
   type MemoryLayerListParams,
+  type MemoryLayerDeleteParams,
   type MemoryLayersCursorPagination,
 } from './memory-layers';