@cadenya/cadenya 0.124.0 → 0.126.0

package/resources/agents/schedules.d.ts

@@ -11,40 +11,118 @@ import { RequestOptions } from "../../internal/request-options.js";
 export declare class Schedules extends APIResource {
     /**
      * Creates a new schedule for an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.create(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   {
+     *     workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     *     metadata: { name: 'name' },
+     *     spec: { schedule: {} },
+     *   },
+     * );
+     * ```
      */
     create(agentID: string, params: ScheduleCreateParams, options?: RequestOptions): APIPromise<AgentSchedule>;
     /**
      * Retrieves a schedule by ID from an agent
-     */
-    retrieve(id: string, params: ScheduleRetrieveParams, options?: RequestOptions): APIPromise<AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * const agentSchedule =
+     *   await client.agents.schedules.retrieve(
+     *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *     'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     *   );
+     * ```
+     */
+    retrieve(agentID: string, id: string, params?: ScheduleRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<AgentSchedule>;
     /**
      * Updates a schedule for an agent
-     */
-    update(id: string, params: ScheduleUpdateParams, options?: RequestOptions): APIPromise<AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.update(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    update(agentID: string, id: string, params: ScheduleUpdateParams, options?: RequestOptions): APIPromise<AgentSchedule>;
     /**
      * Lists all schedules for an agent
-     */
-    list(agentID: string, params: ScheduleListParams, options?: RequestOptions): PagePromise<AgentSchedulesCursorPagination, AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentSchedule of client.agents.schedules.list(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(agentID: string, params?: ScheduleListParams | null | undefined, options?: RequestOptions): PagePromise<AgentSchedulesCursorPagination, AgentSchedule>;
     /**
      * Deletes a schedule from an agent
-     */
-    delete(id: string, params: ScheduleDeleteParams, options?: RequestOptions): APIPromise<void>;
+     *
+     * @example
+     * ```ts
+     * await client.agents.schedules.delete(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    delete(agentID: string, id: string, params?: ScheduleDeleteParams | null | undefined, options?: RequestOptions): APIPromise<void>;
     /**
      * Transitions a schedule to STATE_ARCHIVED and removes its underlying timer.
      * Archiving is terminal: archived schedules never fire and cannot be reactivated;
      * create a new schedule instead.
-     */
-    archive(id: string, params: ScheduleArchiveParams, options?: RequestOptions): APIPromise<AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.archive(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    archive(agentID: string, id: string, params: ScheduleArchiveParams, options?: RequestOptions): APIPromise<AgentSchedule>;
     /**
      * Transitions a schedule to STATE_PAUSED. Paused schedules retain history but do
      * not fire.
-     */
-    pause(id: string, params: SchedulePauseParams, options?: RequestOptions): APIPromise<AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.pause(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    pause(agentID: string, id: string, params: SchedulePauseParams, options?: RequestOptions): APIPromise<AgentSchedule>;
     /**
      * Transitions a paused schedule back to STATE_ACTIVE so it fires on its cadence
      * again. Archived schedules cannot be resumed.
-     */
-    resume(id: string, params: ScheduleResumeParams, options?: RequestOptions): APIPromise<AgentSchedule>;
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.resume(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
+     */
+    resume(agentID: string, id: string, params: ScheduleResumeParams, options?: RequestOptions): APIPromise<AgentSchedule>;
 }
 export type AgentSchedulesCursorPagination = CursorPagination<AgentSchedule>;
 /**
@@ -206,7 +284,7 @@ export interface ScheduleCreateParams {
     /**
      * Path param: Workspace ID.
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Body param: CreateResourceMetadata contains the user-provided fields for
      * creating a workspace-scoped resource. Read-only fields (id, account_id,
@@ -223,23 +301,13 @@ export interface ScheduleRetrieveParams {
     /**
      * Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-     * form.
-     */
-    agentId: string;
+    workspaceId?: string;
 }
 export interface ScheduleUpdateParams {
     /**
      * Path param: Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Path param: Agent ID. Accepts the canonical `agent_…` form or the
-     * `external_id:<value>` form.
-     */
-    agentId: string;
+    workspaceId?: string;
     /**
      * Body param: UpdateResourceMetadata contains the user-provided fields for
      * updating a workspace-scoped resource. Read-only fields (id, account_id,
@@ -260,7 +328,7 @@ export interface ScheduleListParams extends CursorPaginationParams {
     /**
      * Path param: Workspace ID.
      */
-    workspaceId: string;
+    workspaceId?: string;
     /**
      * Query param: When true, the `info` field on each returned schedule is populated.
      * Requests with this flag count more against your rate limit.
@@ -289,45 +357,25 @@ export interface ScheduleDeleteParams {
     /**
      * Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-     * form.
-     */
-    agentId: string;
+    workspaceId?: string;
 }
 export interface ScheduleArchiveParams {
     /**
      * Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-     * form.
-     */
-    agentId: string;
+    workspaceId?: string;
 }
 export interface SchedulePauseParams {
     /**
      * Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-     * form.
-     */
-    agentId: string;
+    workspaceId?: string;
 }
 export interface ScheduleResumeParams {
     /**
      * Workspace ID.
      */
-    workspaceId: string;
-    /**
-     * Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
-     * form.
-     */
-    agentId: string;
+    workspaceId?: string;
 }
 export declare namespace Schedules {
     export { type AgentSchedule as AgentSchedule, type AgentScheduleInfo as AgentScheduleInfo, type AgentScheduleSpec as AgentScheduleSpec, type AgentScheduleSpecSchedule as AgentScheduleSpecSchedule, type ScheduleCalendar as ScheduleCalendar, type ScheduleInterval as ScheduleInterval, type ScheduleRange as ScheduleRange, type AgentSchedulesCursorPagination as AgentSchedulesCursorPagination, type ScheduleCreateParams as ScheduleCreateParams, type ScheduleRetrieveParams as ScheduleRetrieveParams, type ScheduleUpdateParams as ScheduleUpdateParams, type ScheduleListParams as ScheduleListParams, type ScheduleDeleteParams as ScheduleDeleteParams, type ScheduleArchiveParams as ScheduleArchiveParams, type SchedulePauseParams as SchedulePauseParams, type ScheduleResumeParams as ScheduleResumeParams, };

package/resources/agents/schedules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}

package/resources/agents/schedules.js

@@ -13,9 +13,21 @@ const path_1 = require("../../internal/utils/path.js");
 class Schedules extends resource_1.APIResource {
     /**
      * Creates a new schedule for an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.create(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   {
+     *     workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     *     metadata: { name: 'name' },
+     *     spec: { schedule: {} },
+     *   },
+     * );
+     * ```
      */
     create(agentID, params, options) {
-        const { workspaceId, ...body } = params;
+        const { workspaceId = this._client.workspaceID, ...body } = params;
         return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, {
             body,
             ...options,
@@ -23,34 +35,73 @@ class Schedules extends resource_1.APIResource {
     }
     /**
      * Retrieves a schedule by ID from an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule =
+     *   await client.agents.schedules.retrieve(
+     *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *     'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     *   );
+     * ```
      */
-    retrieve(id, params, options) {
-        const { workspaceId, agentId } = params;
-        return this._client.get((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, options);
+    retrieve(agentID, id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, options);
     }
     /**
      * Updates a schedule for an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.update(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    update(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.patch((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
+    update(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, {
             body,
             ...options,
         });
     }
     /**
      * Lists all schedules for an agent
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentSchedule of client.agents.schedules.list(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
-    list(agentID, params, options) {
-        const { workspaceId, ...query } = params;
+    list(agentID, params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
         return this._client.getAPIList((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, (pagination_1.CursorPagination), { query, ...options });
     }
     /**
      * Deletes a schedule from an agent
+     *
+     * @example
+     * ```ts
+     * await client.agents.schedules.delete(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    delete(id, params, options) {
-        const { workspaceId, agentId } = params;
-        return this._client.delete((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
+    delete(agentID, id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.delete((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, {
             ...options,
             headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });
@@ -59,10 +110,19 @@ class Schedules extends resource_1.APIResource {
      * Transitions a schedule to STATE_ARCHIVED and removes its underlying timer.
      * Archiving is terminal: archived schedules never fire and cannot be reactivated;
      * create a new schedule instead.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.archive(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    archive(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:archive`, {
+    archive(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:archive`, {
             body,
             ...options,
         });
@@ -70,10 +130,19 @@ class Schedules extends resource_1.APIResource {
     /**
      * Transitions a schedule to STATE_PAUSED. Paused schedules retain history but do
      * not fire.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.pause(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    pause(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:pause`, {
+    pause(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:pause`, {
             body,
             ...options,
         });
@@ -81,10 +150,19 @@ class Schedules extends resource_1.APIResource {
     /**
      * Transitions a paused schedule back to STATE_ACTIVE so it fires on its cadence
      * again. Archived schedules cannot be resumed.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.resume(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    resume(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:resume`, {
+    resume(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:resume`, {
             body,
             ...options,
         });

package/resources/agents/schedules.js.map

@@ -1 +1 @@
-{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}

package/resources/agents/schedules.mjs

@@ -10,9 +10,21 @@ import { path } from "../../internal/utils/path.mjs";
 export class Schedules extends APIResource {
     /**
      * Creates a new schedule for an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.create(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   {
+     *     workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
+     *     metadata: { name: 'name' },
+     *     spec: { schedule: {} },
+     *   },
+     * );
+     * ```
      */
     create(agentID, params, options) {
-        const { workspaceId, ...body } = params;
+        const { workspaceId = this._client.workspaceID, ...body } = params;
         return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, {
             body,
             ...options,
@@ -20,34 +32,73 @@ export class Schedules extends APIResource {
     }
     /**
      * Retrieves a schedule by ID from an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule =
+     *   await client.agents.schedules.retrieve(
+     *     'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *     'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *     { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     *   );
+     * ```
      */
-    retrieve(id, params, options) {
-        const { workspaceId, agentId } = params;
-        return this._client.get(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, options);
+    retrieve(agentID, id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.get(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, options);
     }
     /**
      * Updates a schedule for an agent
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.update(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    update(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.patch(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
+    update(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.patch(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, {
             body,
             ...options,
         });
     }
     /**
      * Lists all schedules for an agent
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agentSchedule of client.agents.schedules.list(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * )) {
+     *   // ...
+     * }
+     * ```
      */
-    list(agentID, params, options) {
-        const { workspaceId, ...query } = params;
+    list(agentID, params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
         return this._client.getAPIList(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, (CursorPagination), { query, ...options });
     }
     /**
      * Deletes a schedule from an agent
+     *
+     * @example
+     * ```ts
+     * await client.agents.schedules.delete(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    delete(id, params, options) {
-        const { workspaceId, agentId } = params;
-        return this._client.delete(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}`, {
+    delete(agentID, id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.delete(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, {
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });
@@ -56,10 +107,19 @@ export class Schedules extends APIResource {
      * Transitions a schedule to STATE_ARCHIVED and removes its underlying timer.
      * Archiving is terminal: archived schedules never fire and cannot be reactivated;
      * create a new schedule instead.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.archive(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    archive(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:archive`, {
+    archive(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:archive`, {
             body,
             ...options,
         });
@@ -67,10 +127,19 @@ export class Schedules extends APIResource {
     /**
      * Transitions a schedule to STATE_PAUSED. Paused schedules retain history but do
      * not fire.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.pause(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    pause(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:pause`, {
+    pause(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:pause`, {
             body,
             ...options,
         });
@@ -78,10 +147,19 @@ export class Schedules extends APIResource {
     /**
      * Transitions a paused schedule back to STATE_ACTIVE so it fires on its cadence
      * again. Archived schedules cannot be resumed.
+     *
+     * @example
+     * ```ts
+     * const agentSchedule = await client.agents.schedules.resume(
+     *   'agent_01HXKD2E5NQM3T9AYWCFMGWT9Y',
+     *   'as_01HXKD2E5NQM3T9AYWCFMZZZBD',
+     *   { workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q' },
+     * );
+     * ```
      */
-    resume(id, params, options) {
-        const { workspaceId, agentId, ...body } = params;
-        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentId}/schedules/${id}:resume`, {
+    resume(agentID, id, params, options) {
+        const { workspaceId = this._client.workspaceID, ...body } = params;
+        return this._client.post(path `/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:resume`, {
             body,
             ...options,
         });

package/resources/agents/schedules.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schedules.mjs","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schedules.mjs","sourceRoot":"","sources":["../../src/resources/agents/schedules.ts"],"names":[],"mappings":"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"}