@cadenya/cadenya 0.135.0 → 1.0.0

package/src/resources/agents/index.ts

@@ -1,75 +0,0 @@
-export {
-  Agents,
-  type Agent,
-  type AgentInfo,
-  type AgentSpec,
-  type Page,
-  type AgentCreateParams,
-  type AgentRetrieveParams,
-  type AgentUpdateParams,
-  type AgentListParams,
-  type AgentDeleteParams,
-  type AgentArchiveParams,
-  type AgentPublishParams,
-  type AgentUnarchiveParams,
-  type AgentUnpublishParams,
-  type AgentsCursorPagination,
-} from './agents';
-export { Feedback, type FeedbackListParams } from './feedback';
-export {
-  Schedules,
-  type AgentSchedule,
-  type AgentScheduleInfo,
-  type AgentScheduleSpec,
-  type AgentScheduleSpecSchedule,
-  type ScheduleCalendar,
-  type ScheduleInterval,
-  type ScheduleRange,
-  type ScheduleCreateParams,
-  type ScheduleRetrieveParams,
-  type ScheduleUpdateParams,
-  type ScheduleListParams,
-  type ScheduleDeleteParams,
-  type ScheduleArchiveParams,
-  type SchedulePauseParams,
-  type ScheduleResumeParams,
-  type AgentSchedulesCursorPagination,
-} from './schedules';
-export {
-  Variations,
-  type AddAgentVariationAssignmentRequestSubAgentID,
-  type AddAgentVariationAssignmentRequestToolID,
-  type AddAgentVariationAssignmentRequestToolSetID,
-  type AgentVariation,
-  type AgentVariationInfo,
-  type AgentVariationSpec,
-  type AgentVariationSpecCompactionConfig,
-  type AgentVariationSpecConstraints,
-  type AgentVariationSpecModelConfig,
-  type AgentVariationSpecProgressiveDiscovery,
-  type CompactionConfigSummarizationStrategy,
-  type CompactionConfigToolResultClearingStrategy,
-  type VariationAssignment,
-  type VariationAssignmentAgent,
-  type VariationAssignmentTool,
-  type VariationAssignmentToolSet,
-  type VariationMemoryLayerAssignment,
-  type VariationCreateParams,
-  type VariationRetrieveParams,
-  type VariationUpdateParams,
-  type VariationListParams,
-  type VariationDeleteParams,
-  type VariationAddAssignmentParams,
-  type VariationAddMemoryLayerParams,
-  type VariationRemoveAssignmentParams,
-  type VariationRemoveMemoryLayerParams,
-  type VariationUpdateMemoryLayerParams,
-  type AgentVariationsCursorPagination,
-} from './variations';
-export {
-  WebhookDeliveries,
-  type WebhookDelivery,
-  type WebhookDeliveryData,
-  type WebhookDeliveryListParams,
-  type WebhookDeliveriesCursorPagination,
-} from './webhook-deliveries';

package/src/resources/agents/schedules.ts

@@ -1,541 +0,0 @@
-import { APIResource } from '../../core/resource';
-import * as AccountAPI from '../account';
-import * as Shared from '../shared';
-import { APIPromise } from '../../core/api-promise';
-import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
-import { buildHeaders } from '../../internal/headers';
-import { RequestOptions } from '../../internal/request-options';
-import { path } from '../../internal/utils/path';
-
-/**
- * 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
-   *
-   * @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> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * 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(
-    agentID: string,
-    id: string,
-    params: ScheduleRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<AgentSchedule> {
-    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(
-    agentID: string,
-    id: string,
-    params: ScheduleUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentSchedule> {
-    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: string,
-    params: ScheduleListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<AgentSchedulesCursorPagination, AgentSchedule> {
-    const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
-    return this._client.getAPIList(
-      path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules`,
-      CursorPagination<AgentSchedule>,
-      { query, ...options },
-    );
-  }
-
-  /**
-   * Deletes a schedule from an agent
-   *
-   * @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> {
-    const { workspaceId = this._client.workspaceID } = params ?? {};
-    return this._client.delete(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-
-  /**
-   * 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(
-    agentID: string,
-    id: string,
-    params: ScheduleArchiveParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentSchedule> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:archive`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * 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(
-    agentID: string,
-    id: string,
-    params: SchedulePauseParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentSchedule> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:pause`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * 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(
-    agentID: string,
-    id: string,
-    params: ScheduleResumeParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentSchedule> {
-    const { workspaceId = this._client.workspaceID, ...body } = params;
-    return this._client.post(path`/v1/workspaces/${workspaceId}/agents/${agentID}/schedules/${id}:resume`, {
-      body,
-      ...options,
-    });
-  }
-}
-
-export type AgentSchedulesCursorPagination = CursorPagination<AgentSchedule>;
-
-/**
- * AgentSchedule resource — a recurring trigger attached to an agent that creates
- * objectives on its cadence.
- */
-export interface AgentSchedule {
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  metadata: Shared.ResourceMetadata;
-
-  /**
-   * AgentScheduleSpec is the user-provided configuration for a schedule.
-   */
-  spec: AgentScheduleSpec;
-
-  /**
-   * The current lifecycle state of the schedule. Output only. Schedules are created
-   * STATE_ACTIVE; use the :pause, :resume, and :archive actions to transition
-   * between states.
-   */
-  state: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_PAUSED' | 'STATE_ARCHIVED';
-
-  /**
-   * AgentScheduleInfo provides read-only runtime data about a schedule.
-   */
-  info?: AgentScheduleInfo;
-}
-
-/**
- * AgentScheduleInfo provides read-only runtime data about a schedule.
- */
-export interface AgentScheduleInfo {
-  /**
-   * 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;
-
-  /**
-   * When the schedule last fired (regardless of objective outcome).
-   */
-  lastFireAt?: string;
-
-  /**
-   * ID of the most recent objective the schedule created.
-   */
-  lastObjectiveId?: string;
-
-  /**
-   * When the schedule most recently skipped a fire (SKIP policy + prior in flight).
-   */
-  lastSkippedAt?: string;
-
-  /**
-   * Reason for the most recent skip (e.g. "previous objective still running").
-   */
-  lastSkipReason?: string;
-
-  /**
-   * When the schedule will next fire. Computed from the spec; absent when the
-   * schedule is STATE_PAUSED/STATE_ARCHIVED or has no future fire times.
-   */
-  nextFireAt?: string;
-
-  /**
-   * Lifetime count of objectives created by this schedule.
-   */
-  totalFires?: number;
-}
-
-/**
- * AgentScheduleSpec is the user-provided configuration for a schedule.
- */
-export interface AgentScheduleSpec {
-  /**
-   * Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
-   * of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
-   * At least one rule is required.
-   */
-  schedule: AgentScheduleSpecSchedule;
-
-  /**
-   * Optional explicit first user message passed to CreateObjective on each fire.
-   * Becomes the first user message in the objective's chat history. When unset, the
-   * fired objective defers to the selected variation's first_user_message_template.
-   */
-  firstUserMessage?: string;
-
-  /**
-   * Optional data rendered into the variation's first_user_message_template when
-   * each fired objective is created. Separate from `system_prompt_data`, which
-   * renders the system prompt template.
-   */
-  firstUserMessageData?: unknown;
-
-  /**
-   * What to do when the previous run is still in flight. Defaults to SKIP.
-   */
-  overlapPolicy?: 'OVERLAP_POLICY_UNSPECIFIED' | 'OVERLAP_POLICY_ALLOW' | 'OVERLAP_POLICY_SKIP';
-
-  /**
-   * Optional data rendered into the variation's system_prompt_template when each
-   * fired objective is created. If the agent has a system_prompt_data_schema, this
-   * must satisfy it.
-   */
-  systemPromptData?: unknown;
-
-  /**
-   * Optional explicit variation. When unset, the agent's variation_selection_mode
-   * chooses per fire.
-   */
-  variationId?: string;
-}
-
-/**
- * Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
- * of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
- * At least one rule is required.
- */
-export interface AgentScheduleSpecSchedule {
-  /**
-   * Wall-clock rules. May be empty if `intervals` is non-empty.
-   */
-  calendars?: Array<ScheduleCalendar>;
-
-  /**
-   * Duration-based rules. May be empty if `calendars` is non-empty.
-   */
-  intervals?: Array<ScheduleInterval>;
-
-  /**
-   * IANA tz name (e.g. "America/New_York"). Required. Applies to calendars;
-   * intervals fire on wall-clock cadence anchored in this zone.
-   */
-  timezone?: string;
-}
-
-/**
- * Calendar is a wall-clock rule. Empty field-list semantics:
- *
- * - second/minute/hour: empty means [{start: 0}] (top of the unit)
- * - day_of_month/month/day_of_week: empty means "any value" Fire times = cartesian
- *   product across all fields.
- */
-export interface ScheduleCalendar {
-  comment?: string;
-
-  dayOfMonth?: Array<ScheduleRange>;
-
-  dayOfWeek?: Array<ScheduleRange>;
-
-  hour?: Array<ScheduleRange>;
-
-  minute?: Array<ScheduleRange>;
-
-  month?: Array<ScheduleRange>;
-
-  second?: Array<ScheduleRange>;
-}
-
-/**
- * Interval is a duration-based rule. Fires every `every` from a stable anchor
- * (workspace epoch), optionally phase-shifted by `offset`.
- */
-export interface ScheduleInterval {
-  every?: string;
-
-  /**
-   * Phase shift within `every`. Must be < `every` (enforced at runtime).
-   */
-  offset?: string;
-}
-
-/**
- * Inclusive numeric range with optional step. {start: 9} → 9 {start: 9, end: 17} →
- * 9..17 {start: 0, end: 59, step: 15} → 0,15,30,45 `end` defaults to `start`;
- * `step` defaults to 1.
- */
-export interface ScheduleRange {
-  end?: number;
-
-  start?: number;
-
-  step?: number;
-}
-
-export interface ScheduleCreateParams {
-  /**
-   * 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;
-
-  /**
-   * Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
-   */
-  spec: AgentScheduleSpec;
-}
-
-export interface ScheduleRetrieveParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface ScheduleUpdateParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  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: AgentScheduleSpec is the user-provided configuration for a schedule.
-   */
-  spec?: AgentScheduleSpec;
-
-  /**
-   * Body param: Fields to update.
-   */
-  updateMask?: string;
-}
-
-export interface ScheduleListParams extends CursorPaginationParams {
-  /**
-   * Path param: Workspace ID.
-   */
-  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.
-   */
-  includeInfo?: boolean;
-
-  /**
-   * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
-   * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
-   * semantics).
-   */
-  labels?: string;
-
-  /**
-   * Query param: Filter expression (query param: prefix).
-   */
-  prefix?: string;
-
-  /**
-   * Query param: Free-form search query.
-   */
-  query?: string;
-
-  /**
-   * Query param: Sort order for results (asc or desc by creation time).
-   */
-  sortOrder?: string;
-}
-
-export interface ScheduleDeleteParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface ScheduleArchiveParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface SchedulePauseParams {
-  /**
-   * Workspace ID.
-   */
-  workspaceId?: string;
-}
-
-export interface ScheduleResumeParams {
-  /**
-   * Workspace ID.
-   */
-  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,
-  };
-}