@cadenya/cadenya 0.66.0 → 0.68.0

package/src/resources/agents/feedback.ts

@@ -8,12 +8,7 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * AgentService manages AI agents at the WORKSPACE level.
- *  Agents are workspace-scoped resources that define AI behavior and tool access.
- *  All operations are implicitly scoped to the workspace determined by the JWT token.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Manage AI agents within a workspace. Agents define AI behavior and tool access.
  */
 export class Feedback extends APIResource {
   /**
@@ -23,11 +18,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 +32,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
+   */
+  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

@@ -10,35 +10,38 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * AgentScheduleService manages recurring schedules attached to agents.
- *  Schedules trigger objectives on a cadence defined by AgentScheduleSpec.Schedule.
- *  All operations are implicitly scoped to the workspace determined by the JWT token.
- *
- *  Authentication: Bearer token (JWT)
- *  Scope: Workspace-level operations
+ * Manage recurring schedules attached to agents. Schedules trigger objectives
+ *  on a cadence defined by AgentScheduleSpec.Schedule.
  */
 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 +49,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]),
     });
@@ -95,9 +100,9 @@ export interface AgentSchedule {
  */
 export interface AgentScheduleInfo {
   /**
-   * 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;
 
@@ -251,30 +256,46 @@ 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.
+   */
+  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 {
   /**
-   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+   * form.
    */
   agentId: string;
 }
 
 export interface ScheduleUpdateParams {
   /**
-   * Path param: Agent ID (from path). Accepts canonical agent\_… form or
-   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   * Path param: Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Path param: Agent ID. Accepts the canonical `agent_…` form or the
+   * `external_id:<value>` form.
    */
   agentId: string;
 
@@ -299,35 +320,46 @@ export interface ScheduleUpdateParams {
 
 export interface ScheduleListParams extends CursorPaginationParams {
   /**
-   * Filter by bundle_key — return only resources owned by this bundle.
+   * Path param: Workspace ID.
+   */
+  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 true, the `info` field on each returned schedule is populated.
+   * Requests with this flag count more against your 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 {
   /**
-   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
-   * form (see common.proto "Path-parameter ID resolution").
+   * Workspace ID.
+   */
+  workspaceId: string;
+
+  /**
+   * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+   * form.
    */
   agentId: string;
 }