@cadenya/cadenya 0.67.0 → 0.68.0

package/src/resources/objectives/objectives.ts

@@ -263,7 +263,7 @@ export interface MemoryRead {
  * permitted).
  *
  * memory*layer_id accepts both the canonical form (memlyr*…) and the external-id
- * form (external_id:my-custom-id). The same applies to memory_entry_id.
+ * form (external_id:my-custom-id). The same applies to memory_entry_id when set.
  */
 export interface MemoryReference {
   /**
@@ -321,9 +321,9 @@ export interface ObjectiveContextWindow {
 export namespace ObjectiveContextWindow {
   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;
 
@@ -389,22 +389,18 @@ export interface ObjectiveData {
    * Memory layers/entries to push onto this objective's memory stack on top of the
    * baseline stack inherited from the selected variation.
    *
-   * See "Memory stack composition" in memory.proto for lookup semantics.
-   *
    * Array order is push order: the first element sits lower in the objective's
    * contribution to the stack; the LAST element ends up on top of the effective
    * stack. Entries pinned via memory_entry_id behave as single-entry layers at their
    * position.
    *
    * System-managed layers (e.g., episodic) cannot be referenced here; they attach
-   * themselves automatically via the runtime based on episodic_key.
+   * themselves automatically based on episodic_key.
    *
    * Stack size cap: the TOTAL effective stack (variation's memory layers
    *
    * - this field) must not exceed 10 entries. A request that would produce an
-   *   effective stack larger than 10 is rejected with InvalidArgument. Variations
-   *   themselves are capped at 10 memory layer assignments, so a variation that is
-   *   already "full" leaves no room for objective-level references.
+   *   effective stack larger than 10 is rejected with InvalidArgument.
    */
   memoryStack?: Array<MemoryReference>;
 
@@ -421,10 +417,9 @@ export interface ObjectiveData {
   secrets?: Array<ObjectiveDataSecret>;
 
   /**
-   * ID of the AgentSchedule that produced this objective, when applicable.
-   * Read-only; populated by the runtime when the objective is created from a
-   * schedule fire. Empty when the objective was created via CreateObjective
-   * directly.
+   * ID of the AgentSchedule that produced this objective, when applicable. Populated
+   * when the objective is created from a schedule fire; empty when the objective was
+   * created via CreateObjective directly.
    */
   sourceScheduleId?: string;
 
@@ -509,9 +504,9 @@ export namespace ObjectiveEventData {
 
 export interface ObjectiveEventInfo {
   /**
-   * 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;
 
@@ -600,9 +595,9 @@ export interface ObjectiveInfo {
   agentVariation?: Shared.ResourceMetadata;
 
   /**
-   * 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;
 
@@ -777,9 +772,6 @@ export interface ObjectiveCreateParams {
 }
 
 export interface ObjectiveRetrieveParams {
-  /**
-   * Workspace ID (from path).
-   */
   workspaceId: string;
 }
 
@@ -790,9 +782,8 @@ export interface ObjectiveListParams extends CursorPaginationParams {
   agentId?: string;
 
   /**
-   * Filter to objectives produced by a specific AgentSchedule. Matches
-   * ObjectiveData.source*schedule_id. Accepts canonical as*… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Filter to objectives produced by a specific AgentSchedule. Accepts canonical
+   * as\_… form or external_id:<value> form.
    */
   agentScheduleId?: string;
 
@@ -827,7 +818,7 @@ export interface ObjectiveListParams extends CursorPaginationParams {
 
 export interface ObjectiveCancelParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 
@@ -839,7 +830,7 @@ export interface ObjectiveCancelParams {
 
 export interface ObjectiveCompactParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 
@@ -852,7 +843,7 @@ export interface ObjectiveCompactParams {
 
 export interface ObjectiveContinueParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 
@@ -886,7 +877,7 @@ export namespace ObjectiveContinueParams {
 
 export interface ObjectiveListContextWindowsParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 
@@ -898,7 +889,7 @@ export interface ObjectiveListContextWindowsParams extends CursorPaginationParam
 
 export interface ObjectiveListEventsParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 

package/src/resources/objectives/tasks.ts

@@ -79,9 +79,6 @@ export interface ObjectiveTaskData {
 }
 
 export interface TaskRetrieveParams {
-  /**
-   * Workspace ID (from path).
-   */
   workspaceId: string;
 
   /**
@@ -92,7 +89,7 @@ export interface TaskRetrieveParams {
 
 export interface TaskListParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 

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

@@ -121,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;
 
@@ -145,7 +145,7 @@ export interface ObjectiveToolCallInfo {
 
 export interface ToolCallListParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 
@@ -166,9 +166,6 @@ export interface ToolCallListParams extends CursorPaginationParams {
 }
 
 export interface ToolCallApproveParams {
-  /**
-   * Workspace ID (from path).
-   */
   workspaceId: string;
 
   /**
@@ -179,7 +176,7 @@ export interface ToolCallApproveParams {
 
 export interface ToolCallDenyParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 

package/src/resources/objectives/tools.ts

@@ -51,7 +51,7 @@ export interface ObjectiveTool {
 
 export interface ToolListParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param
    */
   workspaceId: string;
 }

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);
@@ -152,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;
 }
@@ -260,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 {
   /**
@@ -270,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;
 }
@@ -285,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;
 
@@ -299,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;
 }
@@ -327,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;
 
@@ -357,14 +353,14 @@ export interface ToolSetCreateParams {
 
 export interface ToolSetRetrieveParams {
   /**
-   * Workspace ID (from path).
+   * Workspace ID.
    */
   workspaceId: string;
 }
 
 export interface ToolSetUpdateParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: Workspace ID.
    */
   workspaceId: string;
 
@@ -416,14 +412,14 @@ export interface ToolSetListParams extends CursorPaginationParams {
 
 export interface ToolSetDeleteParams {
   /**
-   * Workspace ID (from path).
+   * Workspace ID.
    */
   workspaceId: string;
 }
 
 export interface ToolSetListEventsParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: Workspace ID.
    */
   workspaceId: string;
 

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

@@ -10,15 +10,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 Tools extends APIResource {
   /**
@@ -126,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;
 
@@ -172,7 +168,7 @@ export interface ToolSpecConfig {
 
 export interface ToolCreateParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: Workspace ID.
    */
   workspaceId: string;
 
@@ -192,26 +188,25 @@ export interface ToolCreateParams {
 
 export interface ToolRetrieveParams {
   /**
-   * Workspace ID (from path).
+   * Workspace ID.
    */
   workspaceId: string;
 
   /**
-   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
    */
   toolSetId: string;
 }
 
 export interface ToolUpdateParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: Workspace ID.
    */
   workspaceId: string;
 
   /**
-   * 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: Tool set ID. Accepts the canonical ts\_… form or the
+   * external_id:<value> form.
    */
   toolSetId: string;
 
@@ -236,7 +231,7 @@ export interface ToolUpdateParams {
 
 export interface ToolListParams extends CursorPaginationParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: Workspace ID.
    */
   workspaceId: string;
 
@@ -287,13 +282,12 @@ export interface ToolListParams extends CursorPaginationParams {
 
 export interface ToolDeleteParams {
   /**
-   * Workspace ID (from path).
+   * Workspace ID.
    */
   workspaceId: string;
 
   /**
-   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * 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 {
   /**
@@ -36,14 +32,14 @@ export class Uploads extends APIResource {
 }
 
 /**
- * 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;
@@ -58,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;
 
@@ -121,7 +117,7 @@ export interface UploadCreateParams {
 
 export interface UploadRetrieveParams {
   /**
-   * Workspace ID (from path).
+   * Workspace ID.
    */
   workspaceId: string;
 }

package/src/resources/workspace-secrets.ts

@@ -93,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;
 
@@ -119,14 +119,14 @@ export interface WorkspaceSecretCreateParams {
 
 export interface WorkspaceSecretRetrieveParams {
   /**
-   * Workspace ID (from path).
+   * The workspace the secret belongs to.
    */
   workspaceId: string;
 }
 
 export interface WorkspaceSecretUpdateParams {
   /**
-   * Path param: Workspace ID (from path).
+   * Path param: The workspace the secret belongs to.
    */
   workspaceId: string;
 
@@ -144,7 +144,7 @@ export interface WorkspaceSecretUpdateParams {
   spec?: WorkspaceSecretSpec;
 
   /**
-   * Body param: Fields to update
+   * Body param: Fields to update.
    */
   updateMask?: string;
 }
@@ -178,7 +178,7 @@ export interface WorkspaceSecretListParams extends CursorPaginationParams {
 
 export interface WorkspaceSecretDeleteParams {
   /**
-   * Workspace ID (from path).
+   * The workspace the secret belongs to.
    */
   workspaceId: string;
 }

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.67.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.67.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.67.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.67.0'; // x-release-please-version
+exports.VERSION = '0.68.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map