@cadenya/cadenya 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cadenya/cadenya",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "The official TypeScript SDK for the Cadenya API",
   "license": "Apache-2.0",
   "type": "module",

package/src/client.ts

@@ -8,6 +8,7 @@ import { ApiKeys } from './resources/api-keys.js';
 import { WorkspaceAdmin } from './resources/workspace-admin.js';
 import { Profiles } from './resources/profiles.js';
 import { Workspaces } from './resources/workspaces.js';
+import { AgentPools } from './resources/agent-pools.js';
 import { Agents } from './resources/agents.js';
 import { AiProviderKeys } from './resources/ai-provider-keys.js';
 import { Models } from './resources/models.js';
@@ -55,6 +56,7 @@ export class Cadenya {
   readonly workspaceAdmin: WorkspaceAdmin;
   readonly profiles: Profiles;
   readonly workspaces: Workspaces;
+  readonly agentPools: AgentPools;
   readonly agents: Agents;
   readonly aiProviderKeys: AiProviderKeys;
   readonly models: Models;
@@ -97,6 +99,7 @@ export class Cadenya {
     this.workspaceAdmin = new WorkspaceAdmin(this._client);
     this.profiles = new Profiles(this._client);
     this.workspaces = new Workspaces(this._client);
+    this.agentPools = new AgentPools(this._client);
     this.agents = new Agents(this._client);
     this.aiProviderKeys = new AiProviderKeys(this._client);
     this.models = new Models(this._client);

package/src/index.ts

@@ -17,6 +17,7 @@ export * from './resources/api-keys.js';
 export * from './resources/workspace-admin.js';
 export * from './resources/profiles.js';
 export * from './resources/workspaces.js';
+export * from './resources/agent-pools.js';
 export * from './resources/agents.js';
 export * from './resources/agent-schedules.js';
 export * from './resources/agent-variations.js';

package/src/resources/agent-pools.ts

@@ -0,0 +1,287 @@
+// Generated by redwood. Do not edit by hand.
+
+import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
+import { Page } from '../core/pagination.js';
+import type { AgentPool, AgentPoolServiceListAgentPoolsState, AgentPoolSpec, AgentPoolUpdateSpec, CreateResourceMetadata, ListAgentPoolsResponse, UpdateResourceMetadata } from '../types.js';
+
+export interface AgentPoolListParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  /**
+   * Maximum number of results to return
+   */
+  limit?: number;
+  /**
+   * Pagination cursor from previous response
+   */
+  cursor?: string;
+  /**
+   * Filter expression (query param: prefix)
+   */
+  prefix?: string;
+  /**
+   * Free-form search query
+   */
+  query?: string;
+  /**
+   * Filter by lifecycle state. Unspecified returns active and inactive pools;
+   *  explicitly select ARCHIVED to list archived pools.
+   */
+  state?: AgentPoolServiceListAgentPoolsState;
+  /**
+   * 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;
+  /**
+   * Sort order for results (asc or desc by creation time)
+   */
+  sortOrder?: string;
+  /**
+   * When true, the `info` field on each returned agent pool is populated. Requests
+   *  with this flag count more against your rate limit.
+   */
+  includeInfo?: boolean;
+}
+
+export interface AgentPoolCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: AgentPoolSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolRetrieveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolDeleteParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  spec?: AgentPoolUpdateSpec;
+  /**
+   * Fields to update. Only metadata and spec are mutable; top-level state and info
+   *  paths are invalid. spec.assignments replaces the entire membership list.
+   *  A spec mask replaces the full spec; * replaces all mutable fields.
+   *  Without a mask, infer paths from non-empty fields. Empty or omitted
+   *  membership then leaves the existing list unchanged. Element/index paths
+   *  are invalid. Validate the merged pool atomically: an empty description
+   *  or membership (including an explicitly masked empty list) is invalid.
+   */
+  updateMask?: string;
+}
+
+export interface AgentPoolActivateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolArchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolDeactivateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export interface AgentPoolUnarchiveParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
+
+export class AgentPools {
+  constructor(private readonly _client: HttpClient) {}
+
+  /**
+   * List agent pools
+   * 
+   * @example
+   * ```ts
+   * const page = await client.agentPools.list();
+   * for await (const item of page) {
+   *   // auto-fetches every page
+   * }
+   * ```
+   */
+  async list(params?: AgentPoolListParams, options?: RequestOptions): Promise<Page<AgentPool>> {
+    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+    if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+    const _base = snapshotParams(params);
+    const response = await this._client.request<ListAgentPoolsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools`, query: { limit: params?.limit, cursor: params?.cursor, prefix: params?.prefix, query: params?.query, state: params?.state, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);
+    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));
+  }
+
+  /**
+   * Create a new agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.create({ metadata: { name: 'sample' }, spec: { assignments: [{ agentId: 'sample' }], description: 'sample' } });
+   * ```
+   */
+  create(params: AgentPoolCreateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
+  /**
+   * Get an agent pool by ID
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.retrieve('_123');
+   * ```
+   */
+  retrieve(id: string, params?: AgentPoolRetrieveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}` };
+    }, options);
+  }
+
+  /**
+   * Delete an agent pool
+   * 
+   * @example
+   * ```ts
+   * await client.agentPools.delete('_123');
+   * ```
+   */
+  delete(id: string, params?: AgentPoolDeleteParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.requestAPI<void>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}`, void: true };
+    }, options);
+  }
+
+  /**
+   * Update an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.update('_123');
+   * ```
+   */
+  update(id: string, params?: AgentPoolUpdateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+    }, options);
+  }
+
+  /**
+   * Activate an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.activate('_123');
+   * ```
+   */
+  activate(id: string, params?: AgentPoolActivateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}:activate` };
+    }, options);
+  }
+
+  /**
+   * Archive an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.archive('_123');
+   * ```
+   */
+  archive(id: string, params?: AgentPoolArchiveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}:archive` };
+    }, options);
+  }
+
+  /**
+   * Deactivate an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.deactivate('_123');
+   * ```
+   */
+  deactivate(id: string, params?: AgentPoolDeactivateParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}:deactivate` };
+    }, options);
+  }
+
+  /**
+   * Unarchive an agent pool
+   * 
+   * @example
+   * ```ts
+   * const agentPool = await client.agentPools.unarchive('_123');
+   * ```
+   */
+  unarchive(id: string, params?: AgentPoolUnarchiveParams, options?: RequestOptions): APIPromise<AgentPool> {
+    return this._client.requestAPI<AgentPool>(() => {
+      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;
+      if (workspaceId === undefined) throw new Error("Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.");
+      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/agent_pools/${pathSegment('id', id)}:unarchive` };
+    }, options);
+  }
+}