@cadenya/cadenya 0.66.0 → 0.67.0

package/src/client.ts

@@ -30,8 +30,11 @@ import {
 import {
   APIKey,
   APIKeyCreateParams,
+  APIKeyDeleteParams,
   APIKeyInfo,
   APIKeyListParams,
+  APIKeyRetrieveParams,
+  APIKeyRotateParams,
   APIKeySpec,
   APIKeyUpdateParams,
   APIKeys,
@@ -40,6 +43,7 @@ import {
 import {
   Model,
   ModelListParams,
+  ModelRetrieveParams,
   ModelSetStatusParams,
   ModelSpec,
   Models,
@@ -54,6 +58,7 @@ import {
   Upload,
   UploadCreateParams,
   UploadInfo,
+  UploadRetrieveParams,
   UploadSpec,
   Uploads as UploadsAPIUploads,
 } from './resources/uploads';
@@ -61,8 +66,10 @@ import { UnsafeUnwrapWebhookEvent, UnwrapWebhookEvent, Webhooks } from './resour
 import {
   WorkspaceSecret,
   WorkspaceSecretCreateParams,
+  WorkspaceSecretDeleteParams,
   WorkspaceSecretInfo,
   WorkspaceSecretListParams,
+  WorkspaceSecretRetrieveParams,
   WorkspaceSecretSpec,
   WorkspaceSecretUpdateParams,
   WorkspaceSecrets,
@@ -78,8 +85,10 @@ import {
 import {
   Agent,
   AgentCreateParams,
+  AgentDeleteParams,
   AgentInfo,
   AgentListParams,
+  AgentRetrieveParams,
   AgentSpec,
   AgentUpdateParams,
   Agents,
@@ -97,6 +106,7 @@ import {
   BulkWorkspaceApplyStatus,
   BulkWorkspaceResourceApplyParams,
   BulkWorkspaceResourceListParams,
+  BulkWorkspaceResourceRetrieveParams,
   BulkWorkspaceResources,
   MemoryEntryItem,
   MemoryLayerEntry,
@@ -108,8 +118,10 @@ import {
 import {
   MemoryLayer,
   MemoryLayerCreateParams,
+  MemoryLayerDeleteParams,
   MemoryLayerInfo,
   MemoryLayerListParams,
+  MemoryLayerRetrieveParams,
   MemoryLayerSpec,
   MemoryLayerUpdateParams,
   MemoryLayers,
@@ -144,6 +156,7 @@ import {
   ObjectiveListEventsResponse,
   ObjectiveListEventsResponsesCursorPagination,
   ObjectiveListParams,
+  ObjectiveRetrieveParams,
   ObjectiveStatus,
   Objectives,
   ObjectivesCursorPagination,
@@ -166,12 +179,14 @@ import {
   ToolSetAdapterHTTP,
   ToolSetAdapterMcp,
   ToolSetCreateParams,
+  ToolSetDeleteParams,
   ToolSetEvent,
   ToolSetEventData,
   ToolSetEventsCursorPagination,
   ToolSetInfo,
   ToolSetListEventsParams,
   ToolSetListParams,
+  ToolSetRetrieveParams,
   ToolSetSpec,
   ToolSetUpdateParams,
   ToolSets,
@@ -1058,8 +1073,10 @@ export declare namespace Cadenya {
     type Page as Page,
     type AgentsCursorPagination as AgentsCursorPagination,
     type AgentCreateParams as AgentCreateParams,
+    type AgentRetrieveParams as AgentRetrieveParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
+    type AgentDeleteParams as AgentDeleteParams,
   };
 
   export {
@@ -1096,6 +1113,7 @@ export declare namespace Cadenya {
     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,
@@ -1111,8 +1129,10 @@ export declare namespace Cadenya {
     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 {
@@ -1121,6 +1141,7 @@ export declare namespace Cadenya {
     type UploadInfo as UploadInfo,
     type UploadSpec as UploadSpec,
     type UploadCreateParams as UploadCreateParams,
+    type UploadRetrieveParams as UploadRetrieveParams,
   };
 
   export {
@@ -1128,6 +1149,7 @@ export declare namespace Cadenya {
     type Model as Model,
     type ModelSpec as ModelSpec,
     type ModelsCursorPagination as ModelsCursorPagination,
+    type ModelRetrieveParams as ModelRetrieveParams,
     type ModelListParams as ModelListParams,
     type ModelSetStatusParams as ModelSetStatusParams,
   };
@@ -1155,8 +1177,10 @@ export declare namespace Cadenya {
     type ToolSetsCursorPagination as ToolSetsCursorPagination,
     type ToolSetEventsCursorPagination as ToolSetEventsCursorPagination,
     type ToolSetCreateParams as ToolSetCreateParams,
+    type ToolSetRetrieveParams as ToolSetRetrieveParams,
     type ToolSetUpdateParams as ToolSetUpdateParams,
     type ToolSetListParams as ToolSetListParams,
+    type ToolSetDeleteParams as ToolSetDeleteParams,
     type ToolSetListEventsParams as ToolSetListEventsParams,
   };
 
@@ -1167,8 +1191,11 @@ export declare namespace Cadenya {
     type APIKeySpec as APIKeySpec,
     type APIKeysCursorPagination as APIKeysCursorPagination,
     type APIKeyCreateParams as APIKeyCreateParams,
+    type APIKeyRetrieveParams as APIKeyRetrieveParams,
     type APIKeyUpdateParams as APIKeyUpdateParams,
     type APIKeyListParams as APIKeyListParams,
+    type APIKeyDeleteParams as APIKeyDeleteParams,
+    type APIKeyRotateParams as APIKeyRotateParams,
   };
 
   export {
@@ -1178,8 +1205,10 @@ export declare namespace Cadenya {
     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,
   };
 
   export {
@@ -1212,6 +1241,7 @@ export declare namespace Cadenya {
     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/agents/agents.ts

@@ -81,39 +81,46 @@ export class Agents extends APIResource {
   /**
    * Creates a new agent in the workspace
    */
-  create(body: AgentCreateParams, options?: RequestOptions): APIPromise<Agent> {
-    return this._client.post('/v1/agents', { body, ...options });
+  create(workspaceID: string, body: AgentCreateParams, options?: RequestOptions): APIPromise<Agent> {
+    return this._client.post(path`/v1/workspaces/${workspaceID}/agents`, { body, ...options });
   }
 
   /**
    * Retrieves an agent by ID from the workspace
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Agent> {
-    return this._client.get(path`/v1/agents/${id}`, options);
+  retrieve(id: string, params: AgentRetrieveParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/agents/${id}`, options);
   }
 
   /**
    * Updates an agent in the workspace
    */
-  update(id: string, body: AgentUpdateParams, options?: RequestOptions): APIPromise<Agent> {
-    return this._client.patch(path`/v1/agents/${id}`, { body, ...options });
+  update(id: string, params: AgentUpdateParams, options?: RequestOptions): APIPromise<Agent> {
+    const { workspaceId, ...body } = params;
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/agents/${id}`, { body, ...options });
   }
 
   /**
    * Lists all agents in the workspace
    */
   list(
+    workspaceID: string,
     query: AgentListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<AgentsCursorPagination, Agent> {
-    return this._client.getAPIList('/v1/agents', CursorPagination<Agent>, { query, ...options });
+    return this._client.getAPIList(path`/v1/workspaces/${workspaceID}/agents`, CursorPagination<Agent>, {
+      query,
+      ...options,
+    });
   }
 
   /**
    * Deletes an agent from the workspace
    */
-  delete(id: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/v1/agents/${id}`, {
+  delete(id: string, params: AgentDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { workspaceId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/agents/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -244,21 +251,34 @@ export namespace AgentCreateParams {
   }
 }
 
+export interface AgentRetrieveParams {
+  /**
+   * Workspace ID (from path).
+   */
+  workspaceId: string;
+}
+
 export interface AgentUpdateParams {
   /**
-   * 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: Workspace ID (from path).
+   */
+  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;
 
   /**
-   * Agent specification (user-provided configuration)
+   * Body param: Agent specification (user-provided configuration)
    */
   spec?: AgentSpec;
 
   /**
-   * Fields to update
+   * Body param: Fields to update
    */
   updateMask?: string;
 }
@@ -307,6 +327,13 @@ export interface AgentListParams extends CursorPaginationParams {
     | 'VARIATION_SELECTION_MODE_WEIGHTED';
 }
 
+export interface AgentDeleteParams {
+  /**
+   * Workspace ID (from path).
+   */
+  workspaceId: string;
+}
+
 Agents.Feedback = Feedback;
 Agents.WebhookDeliveries = WebhookDeliveries;
 Agents.Variations = Variations;
@@ -320,8 +347,10 @@ export declare namespace Agents {
     type Page as Page,
     type AgentsCursorPagination as AgentsCursorPagination,
     type AgentCreateParams as AgentCreateParams,
+    type AgentRetrieveParams as AgentRetrieveParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
+    type AgentDeleteParams as AgentDeleteParams,
   };
 
   export { Feedback as Feedback, type FeedbackListParams as FeedbackListParams };

package/src/resources/agents/feedback.ts

@@ -23,11 +23,12 @@ export class Feedback extends APIResource {
    */
   list(
     agentID: string,
-    query: FeedbackListParams | null | undefined = {},
+    params: FeedbackListParams,
     options?: RequestOptions,
   ): PagePromise<ObjectiveFeedbacksCursorPagination, ObjectivesFeedbackAPI.ObjectiveFeedback> {
+    const { workspaceId, ...query } = params;
     return this._client.getAPIList(
-      path`/v1/agents/${agentID}/feedback`,
+      path`/v1/workspaces/${workspaceId}/agents/${agentID}/feedback`,
       CursorPagination<ObjectivesFeedbackAPI.ObjectiveFeedback>,
       { query, ...options },
     );
@@ -36,34 +37,40 @@ export class Feedback extends APIResource {
 
 export interface FeedbackListParams extends CursorPaginationParams {
   /**
-   * Optional filter to limit results to feedback on objectives run by a single agent
-   * variation. Supports "external_id:" prefix for external IDs.
+   * Path param: Workspace ID (from path).
+   */
+  workspaceId: string;
+
+  /**
+   * Query param: Optional filter to limit results to feedback on objectives run by a
+   * single agent variation. Supports "external_id:" prefix for external IDs.
    */
   agentVariationId?: string;
 
   /**
-   * Inclusive lower bound on feedback creation time.
+   * Query param: Inclusive lower bound on feedback creation time.
    */
   createdAfter?: string;
 
   /**
-   * Exclusive upper bound on feedback creation time.
+   * Query param: Exclusive upper bound on feedback creation time.
    */
   createdBefore?: 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;
 
   /**
-   * Free-text search applied to the feedback comment. Case-insensitive substring
-   * match.
+   * Query param: Free-text search applied to the feedback comment. Case-insensitive
+   * substring match.
    */
   query?: string;
 
   /**
-   * Filter by sentiment. UNSPECIFIED returns feedback regardless of score.
+   * Query param: Filter by sentiment. UNSPECIFIED returns feedback regardless of
+   * score.
    */
   sentiment?:
     | 'FEEDBACK_SENTIMENT_UNSPECIFIED'

package/src/resources/agents/index.ts

@@ -7,8 +7,10 @@ export {
   type AgentSpec,
   type Page,
   type AgentCreateParams,
+  type AgentRetrieveParams,
   type AgentUpdateParams,
   type AgentListParams,
+  type AgentDeleteParams,
   type AgentsCursorPagination,
 } from './agents';
 export { Feedback, type FeedbackListParams } from './feedback';

package/src/resources/agents/schedules.ts

@@ -21,24 +21,31 @@ export class Schedules extends APIResource {
   /**
    * Creates a new schedule for an agent
    */
-  create(agentID: string, body: ScheduleCreateParams, options?: RequestOptions): APIPromise<AgentSchedule> {
-    return this._client.post(path`/v1/agents/${agentID}/schedules`, { body, ...options });
+  create(agentID: string, params: ScheduleCreateParams, options?: RequestOptions): APIPromise<AgentSchedule> {
+    const { workspaceId, ...body } = params;
+    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, {
+      body,
+      ...options,
+    });
   }
 
   /**
    * Retrieves a schedule by ID from an agent
    */
   retrieve(id: string, params: ScheduleRetrieveParams, options?: RequestOptions): APIPromise<AgentSchedule> {
-    const { agentId } = params;
-    return this._client.get(path`/v1/agents/${agentId}/schedules/${id}`, options);
+    const { workspaceId, agentId } = params;
+    return this._client.get(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, options);
   }
 
   /**
    * Updates a schedule for an agent
    */
   update(id: string, params: ScheduleUpdateParams, options?: RequestOptions): APIPromise<AgentSchedule> {
-    const { agentId, ...body } = params;
-    return this._client.patch(path`/v1/agents/${agentId}/schedules/${id}`, { body, ...options });
+    const { workspaceId, agentId, ...body } = params;
+    return this._client.patch(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
+      body,
+      ...options,
+    });
   }
 
   /**
@@ -46,21 +53,23 @@ export class Schedules extends APIResource {
    */
   list(
     agentID: string,
-    query: ScheduleListParams | null | undefined = {},
+    params: ScheduleListParams,
     options?: RequestOptions,
   ): PagePromise<AgentSchedulesCursorPagination, AgentSchedule> {
-    return this._client.getAPIList(path`/v1/agents/${agentID}/schedules`, CursorPagination<AgentSchedule>, {
-      query,
-      ...options,
-    });
+    const { workspaceId, ...query } = params;
+    return this._client.getAPIList(
+      path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`,
+      CursorPagination<AgentSchedule>,
+      { query, ...options },
+    );
   }
 
   /**
    * Deletes a schedule from an agent
    */
   delete(id: string, params: ScheduleDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { agentId } = params;
-    return this._client.delete(path`/v1/agents/${agentId}/schedules/${id}`, {
+    const { workspaceId, agentId } = params;
+    return this._client.delete(path`/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -251,19 +260,30 @@ export interface ScheduleRange {
 
 export interface ScheduleCreateParams {
   /**
-   * CreateResourceMetadata contains the user-provided fields for creating a
-   * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
-   * profile_id, created_at) are excluded since they are set by the server.
+   * Path param: Workspace ID (from path).
+   */
+  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;
 
   /**
-   * AgentScheduleSpec is the user-provided configuration for a schedule.
+   * Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
    */
   spec: AgentScheduleSpec;
 }
 
 export interface ScheduleRetrieveParams {
+  /**
+   * Workspace ID (from path).
+   */
+  workspaceId: string;
+
   /**
    * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
    * form (see common.proto "Path-parameter ID resolution").
@@ -272,6 +292,11 @@ export interface ScheduleRetrieveParams {
 }
 
 export interface ScheduleUpdateParams {
+  /**
+   * Path param: Workspace ID (from path).
+   */
+  workspaceId: string;
+
   /**
    * Path param: Agent ID (from path). Accepts canonical agent\_… form or
    * external_id:<value> form (see common.proto "Path-parameter ID resolution").
@@ -299,32 +324,42 @@ export interface ScheduleUpdateParams {
 
 export interface ScheduleListParams extends CursorPaginationParams {
   /**
-   * Filter by bundle_key — return only resources owned by this bundle.
+   * Path param: Workspace ID (from path).
+   */
+  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 expression (query param: prefix).
+   * Query param: Filter expression (query param: prefix).
    */
   prefix?: string;
 
   /**
-   * Free-form search query.
+   * Query param: Free-form search query.
    */
   query?: string;
 
   /**
-   * 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 ScheduleDeleteParams {
+  /**
+   * Workspace ID (from path).
+   */
+  workspaceId: string;
+
   /**
    * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
    * form (see common.proto "Path-parameter ID resolution").