@cadenya/cadenya 1.0.2 → 1.1.0

package/package.json

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

package/src/client.ts

@@ -10,8 +10,8 @@ import { Profiles } from './resources/profiles.js';
 import { Workspaces } from './resources/workspaces.js';
 import { Agents } from './resources/agents.js';
 import { AiProviderKeys } from './resources/ai-provider-keys.js';
-import { MemoryLayers } from './resources/memory-layers.js';
 import { Models } from './resources/models.js';
+import { MemoryLayers } from './resources/memory-layers.js';
 import { Objectives } from './resources/objectives.js';
 import { ToolSearch } from './resources/tool-search.js';
 import { Tenants } from './resources/tenants.js';
@@ -57,8 +57,8 @@ export class Cadenya {
   readonly workspaces: Workspaces;
   readonly agents: Agents;
   readonly aiProviderKeys: AiProviderKeys;
-  readonly memoryLayers: MemoryLayers;
   readonly models: Models;
+  readonly memoryLayers: MemoryLayers;
   readonly objectives: Objectives;
   readonly toolSearch: ToolSearch;
   readonly tenants: Tenants;
@@ -85,7 +85,7 @@ export class Cadenya {
       authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
       maxRetries: options.maxRetries ?? 0,
       timeout: options.timeout,
-      defaultHeaders: { 'User-Agent': 'cadenya-typescript/1.0.1 (api 1.0)', ...options.defaultHeaders },
+      defaultHeaders: { 'User-Agent': 'cadenya-typescript/1.0.2 (api 1.0)', ...options.defaultHeaders },
       fetch: options.fetch,
       logger: options.logger,
       logLevel: options.logLevel,
@@ -99,8 +99,8 @@ export class Cadenya {
     this.workspaces = new Workspaces(this._client);
     this.agents = new Agents(this._client);
     this.aiProviderKeys = new AiProviderKeys(this._client);
-    this.memoryLayers = new MemoryLayers(this._client);
     this.models = new Models(this._client);
+    this.memoryLayers = new MemoryLayers(this._client);
     this.objectives = new Objectives(this._client);
     this.toolSearch = new ToolSearch(this._client);
     this.tenants = new Tenants(this._client);

package/src/core/http.ts

@@ -38,7 +38,12 @@ export interface RequestOptions {
 }
 
 export type QueryPrimitive = string | number | boolean;
-export type QueryValue = QueryPrimitive | QueryPrimitive[] | undefined | null;
+/**
+ * Query objects are flattened to dot-delimited paths. `object` is used here
+ * deliberately so generated named interfaces (which do not declare an index
+ * signature) remain assignable as query parameter values.
+ */
+export type QueryValue = QueryPrimitive | readonly QueryPrimitive[] | object | undefined | null;
 
 export interface RequestSpec {
   method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -589,17 +594,51 @@ export class HttpClient {
 
   private buildURL(path: string, query?: Record<string, QueryValue>): string {
     const url = new URL(this.baseURL + path);
+    const ancestors = new Set<object>();
     for (const [key, value] of Object.entries(query ?? {})) {
-      if (value === undefined || value === null) continue;
-      // Arrays serialize as repeated params: ?state=a&state=b
-      for (const item of Array.isArray(value) ? value : [value]) {
-        url.searchParams.append(key, String(item));
-      }
+      appendQueryValue(url.searchParams, key, value, ancestors);
     }
     return url.toString();
   }
 }
 
+/**
+ * Flatten nested query objects to dot-delimited paths. Arrays retain the
+ * existing repeated-parameter behavior at whichever path they occur:
+ * `{ filters: { state: ['a', 'b'] } }` becomes
+ * `?filters.state=a&filters.state=b`.
+ */
+function appendQueryValue(
+  searchParams: URLSearchParams,
+  key: string,
+  value: unknown,
+  ancestors: Set<object>,
+): void {
+  if (value === undefined || value === null) return;
+
+  if (typeof value !== 'object') {
+    searchParams.append(key, String(value));
+    return;
+  }
+
+  if (ancestors.has(value)) {
+    throw new APIRequestError('query parameters contain a circular reference', undefined);
+  }
+  ancestors.add(value);
+  try {
+    if (Array.isArray(value)) {
+      for (const item of value) appendQueryValue(searchParams, key, item, ancestors);
+      return;
+    }
+
+    for (const [childKey, childValue] of Object.entries(value)) {
+      appendQueryValue(searchParams, `${key}.${childKey}`, childValue, ancestors);
+    }
+  } finally {
+    ancestors.delete(value);
+  }
+}
+
 /** Retry counts must be bounded non-negative integers; anything else (NaN,
  * Infinity, negatives, fractions) is treated as the nearest sane value. */
 function normalizeRetries(value: number): number {

package/src/index.ts

@@ -21,9 +21,9 @@ export * from './resources/agents.js';
 export * from './resources/agent-schedules.js';
 export * from './resources/agent-variations.js';
 export * from './resources/ai-provider-keys.js';
+export * from './resources/models.js';
 export * from './resources/memory-layers.js';
 export * from './resources/memory-entries.js';
-export * from './resources/models.js';
 export * from './resources/objectives.js';
 export * from './resources/tool-search.js';
 export * from './resources/tenants.js';

package/src/resources/agents.ts

@@ -248,7 +248,7 @@ export class Agents {
    * 
    * @example
    * ```ts
-   * const agent = await client.agents.create({ metadata: { name: 'sample' }, spec: { variationSelectionMode: 'VARIATION_SELECTION_MODE_UNSPECIFIED' } });
+   * const agent = await client.agents.create({ metadata: { name: 'sample' }, spec: {  } });
    * ```
    */
   create(params: AgentCreateParams, options?: RequestOptions): APIPromise<Agent> {

package/src/resources/ai-provider-keys.ts

@@ -2,7 +2,7 @@
 
 import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
 import { Page } from '../core/pagination.js';
-import type { AIProviderKey, AIProviderKeySpec, CreateResourceMetadata, ListAIProviderKeysResponse, UpdateResourceMetadata } from '../types.js';
+import type { AIProviderCredentialPatch, AIProviderKey, AIProviderKeySpec, CreateResourceMetadata, ListAIProviderKeysResponse, UpdateResourceMetadata } from '../types.js';
 
 export interface AiProviderKeyListParams {
   /**
@@ -68,6 +68,11 @@ export interface AiProviderKeyRetrieveParams {
    * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
    */
   workspaceId?: string;
+  /**
+   * When true, populate info (model counts, promotional status, model
+   *  management), at the cost of extra lookups.
+   */
+  includeInfo?: boolean;
 }
 
 export interface AiProviderKeyDeleteParams {
@@ -92,6 +97,11 @@ export interface AiProviderKeyUpdateParams {
    * Fields to update.
    */
   updateMask?: string;
+  /**
+   * Field-level credential changes. This is independent of update_mask;
+   *  legacy clients may continue replacing spec.credentials atomically.
+   */
+  credentialPatch?: AIProviderCredentialPatch;
 }
 
 export class AiProviderKeys {
@@ -144,7 +154,7 @@ export class AiProviderKeys {
     return this._client.requestAPI<AIProviderKey>(() => {
       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)}/ai_provider_keys/${pathSegment('id', id)}` };
+      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/ai_provider_keys/${pathSegment('id', id)}`, query: { includeInfo: params?.includeInfo } };
     }, options);
   }
 
@@ -176,7 +186,7 @@ export class AiProviderKeys {
     return this._client.requestAPI<AIProviderKey>(() => {
       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)}/ai_provider_keys/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask } };
+      return { method: 'PATCH', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/ai_provider_keys/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, updateMask: params?.updateMask, credentialPatch: params?.credentialPatch } };
     }, options);
   }
 }

package/src/resources/memory-layers.ts

@@ -120,7 +120,7 @@ export class MemoryLayers {
    * 
    * @example
    * ```ts
-   * const memoryLayer = await client.memoryLayers.create({ metadata: { name: 'sample' }, spec: { type: 'MEMORY_LAYER_TYPE_UNSPECIFIED' } });
+   * const memoryLayer = await client.memoryLayers.create({ metadata: { name: 'sample' }, spec: { type: 'MEMORY_LAYER_TYPE_EPISODIC' } });
    * ```
    */
   create(params: MemoryLayerCreateParams, options?: RequestOptions): APIPromise<MemoryLayer> {

package/src/resources/models.ts

@@ -2,7 +2,18 @@
 
 import { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
 import { Page } from '../core/pagination.js';
-import type { ListModelsResponse, Model, ModelServiceListModelsState, SwapModelOnVariationsRequest_ModelSwap } from '../types.js';
+import type { CreateResourceMetadata, ListModelsResponse, Model, ModelPricingOverride, ModelServiceListModelsState, ModelSpec, SwapModelOnVariationsRequest_ModelSwap, UpdateResourceMetadata } from '../types.js';
+
+export interface ModelCreateParams {
+  metadata: CreateResourceMetadata;
+  spec: ModelSpec;
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+}
 
 export interface ModelListParams {
   /**
@@ -70,6 +81,29 @@ export interface ModelRetrieveParams {
   workspaceId?: string;
 }
 
+export interface ModelUpdateParams {
+  /**
+   * Workspace ID.
+   * 
+   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
+   */
+  workspaceId?: string;
+  metadata?: UpdateResourceMetadata;
+  /**
+   * When any spec.* path is masked, send the complete spec (current values
+   *  plus edits); it is validated as a whole.
+   */
+  spec?: ModelSpec;
+  /**
+   * Customer price overrides, applied per masked path.
+   */
+  pricingOverride?: ModelPricingOverride;
+  /**
+   * Fields to update. Required; leaf paths only.
+   */
+  updateMask?: string;
+}
+
 export interface ModelDisableParams {
   /**
    * Workspace ID.
@@ -104,6 +138,22 @@ export interface ModelSwapOnVariationsParams {
 export class Models {
   constructor(private readonly _client: HttpClient) {}
 
+  /**
+   * Create a model
+   * 
+   * @example
+   * ```ts
+   * const model = await client.models.create('ai_provider_key_123', { metadata: { name: 'sample' }, spec: { capabilities: [{ temperature: {  }, type: 'temperature' }], family: 'sample', inputPricePerMillionTokens: 'sample', maxInputTokens: 1, maxOutputTokens: 1, outputPricePerMillionTokens: 'sample', provider: 'sample', providerModelId: 'sample' } });
+   * ```
+   */
+  create(aiProviderKeyId: string, params: ModelCreateParams, options?: RequestOptions): APIPromise<Model> {
+    return this._client.requestAPI<Model>(() => {
+      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)}/ai_provider_keys/${pathSegment('aiProviderKeyId', aiProviderKeyId)}/models`, body: { metadata: params.metadata, spec: params.spec } };
+    }, options);
+  }
+
   /**
    * List models
    * 
@@ -139,6 +189,22 @@ export class Models {
     }, options);
   }
 
+  /**
+   * Update a model
+   * 
+   * @example
+   * ```ts
+   * const model = await client.models.update('_123');
+   * ```
+   */
+  update(id: string, params?: ModelUpdateParams, options?: RequestOptions): APIPromise<Model> {
+    return this._client.requestAPI<Model>(() => {
+      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)}/models/${pathSegment('id', id)}`, body: { metadata: params?.metadata, spec: params?.spec, pricingOverride: params?.pricingOverride, updateMask: params?.updateMask } };
+    }, options);
+  }
+
   /**
    * Disable a model
    * 

package/src/resources/objectives.ts

@@ -3,7 +3,7 @@
 import { HttpClient, RequestOptions, RequestSpec, APIPromise, pathSegment, snapshotParams } from '../core/http.js';
 import { Page } from '../core/pagination.js';
 import { Stream } from '../core/sse.js';
-import type { AgentVariationSpec_CompactionConfig, CompactObjectiveResponse, CreateObjectiveRequest_Secret, CreateOperationMetadata, GetObjectiveDiagnosticsResponse, ListObjectiveContextWindowsResponse, ListObjectiveEventsResponse, ListObjectiveFeedbackResponse, ListObjectiveTasksResponse, ListObjectiveToolCallsResponse, ListObjectiveToolsResponse, ListObjectivesResponse, MemoryReference, Objective, ObjectiveContextWindow, ObjectiveEpisodicConfigParam, ObjectiveEvent, ObjectiveFeedback, ObjectiveFeedbackData, ObjectiveServiceListObjectiveToolCallsExecutionStatus, ObjectiveServiceListObjectiveToolCallsStatus, ObjectiveServiceListObjectivesState, ObjectiveTask, ObjectiveTool, ObjectiveToolCall, ObjectiveToolCallWithResult, SetToolCallContentRequest_ContentBlock, SubjectAssertion, TenantAssertion } from '../types.js';
+import type { AgentVariationSpec_CompactionConfig, CompactObjectiveResponse, CreateObjectiveRequest_Secret, CreateOperationMetadata, GetObjectiveDiagnosticsResponse, ListObjectiveContextWindowsResponse, ListObjectiveEventsResponse, ListObjectiveFeedbackResponse, ListObjectiveToolCallsResponse, ListObjectiveToolsResponse, ListObjectivesResponse, MemoryReference, Objective, ObjectiveContextWindow, ObjectiveEpisodicConfigParam, ObjectiveEvent, ObjectiveFeedback, ObjectiveFeedbackData, ObjectiveServiceListObjectiveToolCallsExecutionStatus, ObjectiveServiceListObjectiveToolCallsStatus, ObjectiveServiceListObjectivesState, ObjectiveTool, ObjectiveToolCall, ObjectiveToolCallWithResult, SetToolCallContentRequest_ContentBlock, SubjectAssertion, TenantAssertion } from '../types.js';
 import { wireObjectiveEpisodicConfig } from '../types.js';
 
 export interface ObjectiveListParams {
@@ -267,32 +267,6 @@ export interface ObjectiveCreateFeedbackParams {
   workspaceId?: string;
 }
 
-export interface ObjectiveListTasksParams {
-  /**
-   * 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;
-  /**
-   * Sort order for results
-   */
-  sortOrder?: string;
-}
-
-export interface ObjectiveRetrieveTaskParams {
-  /**
-   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
-   */
-  workspaceId?: string;
-}
-
 export interface ObjectiveListToolCallsParams {
   /**
    * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.
@@ -580,41 +554,6 @@ export class Objectives {
     }, options);
   }
 
-  /**
-   * List objective tasks
-   * 
-   * @example
-   * ```ts
-   * const page = await client.objectives.listTasks('objective_123');
-   * for await (const item of page) {
-   *   // auto-fetches every page
-   * }
-   * ```
-   */
-  async listTasks(objectiveId: string, params?: ObjectiveListTasksParams, options?: RequestOptions): Promise<Page<ObjectiveTask>> {
-    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<ListObjectiveTasksResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/objectives/${pathSegment('objectiveId', objectiveId)}/tasks`, query: { limit: params?.limit, cursor: params?.cursor, sortOrder: params?.sortOrder } }, options);
-    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.listTasks(objectiveId, { ..._base, cursor: cursor }, options));
-  }
-
-  /**
-   * Get an objective task by ID
-   * 
-   * @example
-   * ```ts
-   * const objectiveTask = await client.objectives.retrieveTask('objective_123', '_123');
-   * ```
-   */
-  retrieveTask(objectiveId: string, id: string, params?: ObjectiveRetrieveTaskParams, options?: RequestOptions): APIPromise<ObjectiveTask> {
-    return this._client.requestAPI<ObjectiveTask>(() => {
-      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)}/objectives/${pathSegment('objectiveId', objectiveId)}/tasks/${pathSegment('id', id)}` };
-    }, options);
-  }
-
   /**
    * List objective tool calls
    * 

package/src/resources/tools.ts

@@ -150,7 +150,7 @@ export class Tools {
    * 
    * @example
    * ```ts
-   * const tool = await client.toolSets.tools.create('tool_set_123', { metadata: { name: 'sample' }, spec: { config: { http: { requestMethod: 'HTTP_METHOD_UNSPECIFIED' }, type: 'http' }, description: 'sample', parameters: {  }, requiresApproval: true } });
+   * const tool = await client.toolSets.tools.create('tool_set_123', { metadata: { name: 'sample' }, spec: { config: { http: { requestMethod: 'GET' }, type: 'http' }, description: 'sample', parameters: {  }, requiresApproval: true } });
    * ```
    */
   create(toolSetId: string, params: ToolCreateParams, options?: RequestOptions): APIPromise<Tool> {