@cadenya/cadenya 0.66.0 → 0.68.0

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

@@ -26,16 +26,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 MemoryLayers extends APIResource {
   entries: EntriesAPI.Entries = new EntriesAPI.Entries(this._client);
@@ -43,39 +37,51 @@ export class MemoryLayers extends APIResource {
   /**
    * Creates a new memory layer in the workspace
    */
-  create(body: MemoryLayerCreateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
-    return this._client.post('/v1/memory_layers', { body, ...options });
+  create(
+    workspaceID: string,
+    body: MemoryLayerCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<MemoryLayer> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/memory_layers`, { body, ...options });
   }
 
   /**
    * Retrieves a memory layer by ID from the workspace
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<MemoryLayer> {
-    return this._client.get(path`/v1/memory_layers/${id}`, options);
+  retrieve(id: string, params: MemoryLayerRetrieveParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, options);
   }
 
   /**
    * Updates a memory layer in the workspace
    */
-  update(id: string, body: MemoryLayerUpdateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
-    return this._client.patch(path`/v1/memory_layers/${id}`, { body, ...options });
+  update(id: string, params: MemoryLayerUpdateParams, options?: RequestOptions): APIPromise<MemoryLayer> {
+    const { workspaceId, ...body } = params;
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, { body, ...options });
   }
 
   /**
    * Lists all memory layers in the workspace
    */
   list(
+    workspaceID: string,
     query: MemoryLayerListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<MemoryLayersCursorPagination, MemoryLayer> {
-    return this._client.getAPIList('/v1/memory_layers', CursorPagination<MemoryLayer>, { query, ...options });
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceID}/memory_layers`,
+      CursorPagination<MemoryLayer>,
+      { query, ...options },
+    );
   }
 
   /**
    * Deletes a memory layer from the workspace
    */
-  delete(id: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/v1/memory_layers/${id}`, {
+  delete(id: string, params: MemoryLayerDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { workspaceId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/memory_layers/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -105,9 +111,9 @@ export interface MemoryLayer {
 
 export interface MemoryLayerInfo {
   /**
-   * 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;
 
@@ -158,16 +164,32 @@ export interface MemoryLayerCreateParams {
   spec: MemoryLayerSpec;
 }
 
+export interface MemoryLayerRetrieveParams {
+  workspaceId: string;
+}
+
 export interface MemoryLayerUpdateParams {
   /**
-   * 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
+   */
+  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?: MemoryLayerSpec;
 
+  /**
+   * Body param
+   */
   updateMask?: string;
 }
 
@@ -203,6 +225,10 @@ export interface MemoryLayerListParams extends CursorPaginationParams {
   type?: 'MEMORY_LAYER_TYPE_UNSPECIFIED' | 'MEMORY_LAYER_TYPE_EPISODIC' | 'MEMORY_LAYER_TYPE_SKILLS';
 }
 
+export interface MemoryLayerDeleteParams {
+  workspaceId: string;
+}
+
 MemoryLayers.Entries = Entries;
 
 export declare namespace MemoryLayers {
@@ -212,8 +238,10 @@ export declare namespace MemoryLayers {
     type MemoryLayerSpec as MemoryLayerSpec,
     type MemoryLayersCursorPagination as MemoryLayersCursorPagination,
     type MemoryLayerCreateParams as MemoryLayerCreateParams,
+    type MemoryLayerRetrieveParams as MemoryLayerRetrieveParams,
     type MemoryLayerUpdateParams as MemoryLayerUpdateParams,
     type MemoryLayerListParams as MemoryLayerListParams,
+    type MemoryLayerDeleteParams as MemoryLayerDeleteParams,
   };
 
   export {

package/src/resources/models.ts

@@ -8,37 +8,39 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 /**
- * ModelService manages LLM models at the WORKSPACE level.
- *  Models represent available LLM providers and families (e.g., "anthropic/claude-sonnet-4.6").
- *  Models are seeded into workspaces and can be enabled or disabled.
- *  All operations are implicitly scoped to the workspace determined by the JWT token.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Manage LLM models available to a workspace. Models represent provider and
+ *  family pairs (e.g., "anthropic/claude-sonnet-4.6"). Workspaces are seeded
+ *  with the supported models and you can enable or disable each one.
  */
 export class Models extends APIResource {
   /**
    * Retrieves a model by ID from the workspace
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Model> {
-    return this._client.get(path`/v1/models/${id}`, options);
+  retrieve(id: string, params: ModelRetrieveParams, options?: RequestOptions): APIPromise<Model> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/models/${id}`, options);
   }
 
   /**
    * Lists all models in the workspace
    */
   list(
+    workspaceID: string,
     query: ModelListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<ModelsCursorPagination, Model> {
-    return this._client.getAPIList('/v1/models', CursorPagination<Model>, { query, ...options });
+    return this._client.getAPIList(path`/v1/workspaces/${workspaceID}/models`, CursorPagination<Model>, {
+      query,
+      ...options,
+    });
   }
 
   /**
    * Enables or disables a model in the workspace
    */
-  setStatus(id: string, body: ModelSetStatusParams, options?: RequestOptions): APIPromise<Model> {
-    return this._client.put(path`/v1/models/${id}/status`, { body, ...options });
+  setStatus(id: string, params: ModelSetStatusParams, options?: RequestOptions): APIPromise<Model> {
+    const { workspaceId, ...body } = params;
+    return this._client.put(path`/v1/workspaces/${workspaceId}/models/${id}/status`, { body, ...options });
   }
 }
 
@@ -93,6 +95,13 @@ export interface ModelSpec {
   status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
 }
 
+export interface ModelRetrieveParams {
+  /**
+   * Workspace ID.
+   */
+  workspaceId: string;
+}
+
 export interface ModelListParams extends CursorPaginationParams {
   /**
    * Filter by bundle_key — return only resources owned by this bundle.
@@ -122,7 +131,12 @@ export interface ModelListParams extends CursorPaginationParams {
 
 export interface ModelSetStatusParams {
   /**
-   * The new status for the model
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: The new status for the model
    */
   status?: 'MODEL_STATUS_UNSPECIFIED' | 'MODEL_STATUS_ENABLED' | 'MODEL_STATUS_DISABLED';
 }
@@ -132,6 +146,7 @@ export declare namespace Models {
     type Model as Model,
     type ModelSpec as ModelSpec,
     type ModelsCursorPagination as ModelsCursorPagination,
+    type ModelRetrieveParams as ModelRetrieveParams,
     type ModelListParams as ModelListParams,
     type ModelSetStatusParams as ModelSetStatusParams,
   };

package/src/resources/objectives/feedback.ts

@@ -15,10 +15,14 @@ export class Feedback extends APIResource {
    */
   create(
     objectiveID: string,
-    body: FeedbackCreateParams,
+    params: FeedbackCreateParams,
     options?: RequestOptions,
   ): APIPromise<ObjectiveFeedback> {
-    return this._client.post(path`/v1/objectives/${objectiveID}/feedback`, { body, ...options });
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/feedback`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -26,11 +30,12 @@ export class Feedback extends APIResource {
    */
   list(
     objectiveID: string,
-    query: FeedbackListParams | null | undefined = {},
+    params: FeedbackListParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveFeedbacksCursorPagination, ObjectiveFeedback> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/feedback`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/feedback`,
       CursorPagination<ObjectiveFeedback>,
       { query, ...options },
     );
@@ -92,25 +97,38 @@ export interface ObjectiveFeedbackInfo {
   objective?: Shared.BareMetadata;
 
   /**
-   * 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.
    */
   submittedBy?: AccountAPI.Profile;
 }
 
 export interface FeedbackCreateParams {
+  /**
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Body param
+   */
   data: ObjectiveFeedbackData;
 
   /**
-   * CreateOperationMetadata contains the user-provided fields for creating an
-   * operation. Read-only fields (id, account_id, workspace_id, created_at,
-   * profile_id) are excluded since they are set by the server.
+   * Body param: CreateOperationMetadata contains the user-provided fields for
+   * creating an operation. Read-only fields (id, account_id, workspace_id,
+   * created_at, profile_id) are excluded since they are set by the server.
    */
   metadata: Shared.CreateOperationMetadata;
 }
 
-export interface FeedbackListParams extends CursorPaginationParams {}
+export interface FeedbackListParams extends CursorPaginationParams {
+  /**
+   * Path param
+   */
+  workspaceId: string;
+}
 
 export declare namespace Feedback {
   export {

package/src/resources/objectives/index.ts

@@ -40,6 +40,7 @@ export {
   type ObjectiveContinueResponse,
   type ObjectiveListEventsResponse,
   type ObjectiveCreateParams,
+  type ObjectiveRetrieveParams,
   type ObjectiveListParams,
   type ObjectiveCancelParams,
   type ObjectiveCompactParams,

package/src/resources/objectives/objectives.ts

@@ -52,33 +52,47 @@ export class Objectives extends APIResource {
   /**
    * Creates a new objective in the workspace
    */
-  create(body: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective> {
-    return this._client.post('/v1/objectives', { body, ...options });
+  create(workspaceID: string, body: ObjectiveCreateParams, options?: RequestOptions): APIPromise<Objective> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/objectives`, { body, ...options });
   }
 
   /**
    * Retrieves an objective by ID from the workspace
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Objective> {
-    return this._client.get(path`/v1/objectives/${id}`, options);
+  retrieve(id: string, params: ObjectiveRetrieveParams, options?: RequestOptions): APIPromise<Objective> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/objectives/${id}`, options);
   }
 
   /**
    * Lists all objectives in the workspace
    */
   list(
+    workspaceID: string,
     query: ObjectiveListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<ObjectivesCursorPagination, Objective> {
-    return this._client.getAPIList('/v1/objectives', CursorPagination<Objective>, { query, ...options });
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceID}/objectives`,
+      CursorPagination<Objective>,
+      { query, ...options },
+    );
   }
 
   /**
    * Cancels a running or pending objective. The objective's state will be set to
    * STATE_CANCELLED.
    */
-  cancel(objectiveID: string, body: ObjectiveCancelParams, options?: RequestOptions): APIPromise<Objective> {
-    return this._client.post(path`/v1/objectives/${objectiveID}/cancel`, { body, ...options });
+  cancel(
+    objectiveID: string,
+    params: ObjectiveCancelParams,
+    options?: RequestOptions,
+  ): APIPromise<Objective> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/cancel`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -87,10 +101,14 @@ export class Objectives extends APIResource {
    */
   compact(
     objectiveID: string,
-    body: ObjectiveCompactParams,
+    params: ObjectiveCompactParams,
     options?: RequestOptions,
   ): APIPromise<ObjectiveCompactResponse> {
-    return this._client.post(path`/v1/objectives/${objectiveID}/compact`, { body, ...options });
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/compact`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -98,10 +116,14 @@ export class Objectives extends APIResource {
    */
   continue(
     objectiveID: string,
-    body: ObjectiveContinueParams,
+    params: ObjectiveContinueParams,
     options?: RequestOptions,
   ): APIPromise<ObjectiveContinueResponse> {
-    return this._client.post(path`/v1/objectives/${objectiveID}/continue`, { body, ...options });
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/continue`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -110,11 +132,12 @@ export class Objectives extends APIResource {
    */
   listContextWindows(
     objectiveID: string,
-    query: ObjectiveListContextWindowsParams | null | undefined = {},
+    params: ObjectiveListContextWindowsParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveContextWindowsCursorPagination, ObjectiveContextWindow> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/context_windows`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/context_windows`,
       CursorPagination<ObjectiveContextWindow>,
       { query, ...options },
     );
@@ -125,11 +148,12 @@ export class Objectives extends APIResource {
    */
   listEvents(
     objectiveID: string,
-    query: ObjectiveListEventsParams | null | undefined = {},
+    params: ObjectiveListEventsParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveListEventsResponsesCursorPagination, ObjectiveListEventsResponse> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/objectives/${objectiveID}/events`,
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveID}/events`,
       CursorPagination<ObjectiveListEventsResponse>,
       { query, ...options },
     );
@@ -239,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 {
   /**
@@ -297,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;
 
@@ -365,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>;
 
@@ -397,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;
 
@@ -485,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;
 
@@ -576,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;
 
@@ -752,6 +771,10 @@ export interface ObjectiveCreateParams {
   variationId?: string;
 }
 
+export interface ObjectiveRetrieveParams {
+  workspaceId: string;
+}
+
 export interface ObjectiveListParams extends CursorPaginationParams {
   /**
    * Agent ID for filtering
@@ -759,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;
 
@@ -796,34 +818,51 @@ export interface ObjectiveListParams extends CursorPaginationParams {
 
 export interface ObjectiveCancelParams {
   /**
-   * Optional reason for cancellation
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: Optional reason for cancellation
    */
   reason?: string;
 }
 
 export interface ObjectiveCompactParams {
   /**
-   * CompactionConfig defines how context window compaction behaves for objectives
-   * using this variation.
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: CompactionConfig defines how context window compaction behaves for
+   * objectives using this variation.
    */
   compactionConfig?: VariationsAPI.AgentVariationSpecCompactionConfig;
 }
 
 export interface ObjectiveContinueParams {
   /**
-   * When set to true, the message will be enqueued for when the agent loop is
-   * available to process it.
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Body param: When set to true, the message will be enqueued for when the agent
+   * loop is available to process it.
    */
   enqueue?: boolean;
 
   /**
-   * The message to continue an objective that has completed (or you are enqueing)
+   * Body param: The message to continue an objective that has completed (or you are
+   * enqueing)
    */
   message?: string;
 
   /**
-   * Secrets that should be included with the message. Helpful for when you need to
-   * update secrets on the objective (IE: A secret expires and needs to be refreshed)
+   * Body param: Secrets that should be included with the message. Helpful for when
+   * you need to update secrets on the objective (IE: A secret expires and needs to
+   * be refreshed)
    */
   secrets?: Array<ObjectiveContinueParams.Secret>;
 }
@@ -838,24 +877,34 @@ export namespace ObjectiveContinueParams {
 
 export interface ObjectiveListContextWindowsParams 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;
 }
 
 export interface ObjectiveListEventsParams 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;
 
   /**
-   * Sort order for results (asc or desc by creation time)
+   * Query param: Sort order for results (asc or desc by creation time)
    */
   sortOrder?: string;
 
   /**
-   * Optional context window ID to filter events by
+   * Query param: Optional context window ID to filter events by
    */
   windowId?: string;
 }
@@ -899,6 +948,7 @@ export declare namespace Objectives {
     type ObjectiveContextWindowsCursorPagination as ObjectiveContextWindowsCursorPagination,
     type ObjectiveListEventsResponsesCursorPagination as ObjectiveListEventsResponsesCursorPagination,
     type ObjectiveCreateParams as ObjectiveCreateParams,
+    type ObjectiveRetrieveParams as ObjectiveRetrieveParams,
     type ObjectiveListParams as ObjectiveListParams,
     type ObjectiveCancelParams as ObjectiveCancelParams,
     type ObjectiveCompactParams as ObjectiveCompactParams,