@cadenya/cadenya 0.41.0 → 0.43.0

package/src/resources/{agents/variations.ts → agent-variations.ts}

@@ -1,19 +1,23 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-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';
+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';
 
-export class Variations extends APIResource {
+export class AgentVariations extends APIResource {
   /**
    * Creates a new variation for an agent
    */
-  create(agentID: string, body: VariationCreateParams, options?: RequestOptions): APIPromise<AgentVariation> {
+  create(
+    agentID: string,
+    body: AgentVariationCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentVariation> {
     return this._client.post(path`/v1/agents/${agentID}/variations`, { body, ...options });
   }
 
@@ -22,7 +26,7 @@ export class Variations extends APIResource {
    */
   retrieve(
     id: string,
-    params: VariationRetrieveParams,
+    params: AgentVariationRetrieveParams,
     options?: RequestOptions,
   ): APIPromise<AgentVariation> {
     const { agentId } = params;
@@ -32,7 +36,11 @@ export class Variations extends APIResource {
   /**
    * Updates a variation for an agent
    */
-  update(id: string, params: VariationUpdateParams, options?: RequestOptions): APIPromise<AgentVariation> {
+  update(
+    id: string,
+    params: AgentVariationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentVariation> {
     const { agentId, ...body } = params;
     return this._client.patch(path`/v1/agents/${agentId}/variations/${id}`, { body, ...options });
   }
@@ -42,7 +50,7 @@ export class Variations extends APIResource {
    */
   list(
     agentID: string,
-    query: VariationListParams | null | undefined = {},
+    query: AgentVariationListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<AgentVariationsCursorPagination, AgentVariation> {
     return this._client.getAPIList(path`/v1/agents/${agentID}/variations`, CursorPagination<AgentVariation>, {
@@ -54,13 +62,44 @@ export class Variations extends APIResource {
   /**
    * Deletes a variation from an agent
    */
-  delete(id: string, params: VariationDeleteParams, options?: RequestOptions): APIPromise<void> {
+  delete(id: string, params: AgentVariationDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { agentId } = params;
     return this._client.delete(path`/v1/agents/${agentId}/variations/${id}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID
+   * must be set.
+   */
+  addAssignment(
+    agentVariationID: string,
+    body: AgentVariationAddAssignmentParams,
+    options?: RequestOptions,
+  ): APIPromise<VariationAssignment> {
+    return this._client.post(path`/v1/agent_variations/${agentVariationID}/assignments`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Detaches an assignment from a variation, identified by the assignment ID
+   * returned when it was added.
+   */
+  removeAssignment(
+    id: string,
+    params: AgentVariationRemoveAssignmentParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { agentVariationId } = params;
+    return this._client.delete(path`/v1/agent_variations/${agentVariationId}/assignments/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type AgentVariationsCursorPagination = CursorPagination<AgentVariation>;
@@ -89,6 +128,13 @@ export interface AgentVariation {
  * AgentVariationInfo provides read-only summary information about a variation
  */
 export interface AgentVariationInfo {
+  /**
+   * All tools, tool sets, and sub-agents assigned to this variation. Populated on
+   * reads so clients can render a variation's full assignment list without calling
+   * the add/remove endpoints just to enumerate.
+   */
+  assignments?: Array<VariationAssignment>;
+
   /**
    * Profile represents a human user at the account level. Profiles are
    * account-scoped resources that can be associated with multiple workspaces through
@@ -133,15 +179,10 @@ export interface AgentVariationInfo {
  */
 export interface AgentVariationSpec {
   /**
-   * Documents assigned to this variation. Can include individual documents or entire
-   * document namespaces (which include all documents in the namespace).
-   */
-  agentDocuments?: Array<AgentVariationSpecAgentDocument>;
-
-  /**
-   * Tools assigned to this variation
+   * CompactionConfig defines how context window compaction behaves for objectives
+   * using this variation.
    */
-  agentTools?: Array<AgentVariationSpecAgentTool>;
+  compactionConfig?: AgentVariationSpecCompactionConfig;
 
   /**
    * Execution constraints
@@ -192,43 +233,28 @@ export interface AgentVariationSpec {
   weight?: number;
 }
 
-export interface AgentVariationSpecAgentDocument {
-  documentId?: string;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  documentMetadata?: Shared.ResourceMetadata;
-
-  documentNamespaceId?: string;
-
-  /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
-   */
-  documentNamespaceMetadata?: Shared.ResourceMetadata;
-}
-
-export interface AgentVariationSpecAgentTool {
-  agentId?: string;
-
+/**
+ * CompactionConfig defines how context window compaction behaves for objectives
+ * using this variation.
+ */
+export interface AgentVariationSpecCompactionConfig {
   /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   * SummarizationStrategy configures LLM-powered summarization of older conversation
+   * turns.
    */
-  agentMetadata?: Shared.ResourceMetadata;
-
-  toolId?: string;
+  summarization?: CompactionConfigSummarizationStrategy;
 
   /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   * ToolResultClearingStrategy configures clearing of older tool result content.
    */
-  toolMetadata?: Shared.ResourceMetadata;
-
-  toolSetId?: string;
+  toolResultClearing?: CompactionConfigToolResultClearingStrategy;
 
   /**
-   * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+   * Trigger threshold as a percentage of the model's context window (0.0 to 1.0).
+   * When input tokens reach this percentage of the model's limit, compaction
+   * triggers. Default: 0.75 (75%)
    */
-  toolSetMetadata?: Shared.ResourceMetadata;
+  triggerThreshold?: number;
 }
 
 export interface AgentVariationSpecConstraints {
@@ -278,6 +304,31 @@ export interface AgentVariationSpecToolSelection {
   autoDiscovery?: ToolSelectionAutoDiscovery;
 }
 
+/**
+ * SummarizationStrategy configures LLM-powered summarization of older conversation
+ * turns.
+ */
+export interface CompactionConfigSummarizationStrategy {
+  /**
+   * Custom instructions that guide what the summarizer preserves. Replaces the
+   * default summarization prompt entirely. Example: "Preserve all code snippets,
+   * variable names, and technical decisions."
+   */
+  instructions?: string;
+}
+
+/**
+ * ToolResultClearingStrategy configures clearing of older tool result content.
+ */
+export interface CompactionConfigToolResultClearingStrategy {
+  /**
+   * Number of most recent tool call results to keep intact. Older tool results have
+   * their content replaced with "[result cleared]" while preserving the assistant
+   * tool call message (function name, arguments). Default: 2
+   */
+  preserveRecentResults?: number;
+}
+
 /**
  * AssignedTools is used to indicate that the agent should only use the tools/tool
  * sets that are explicitly assigned to it. Allow discovery is used when the agent
@@ -300,7 +351,51 @@ export interface ToolSelectionAutoDiscovery {
   maxTools?: number;
 }
 
-export interface VariationCreateParams {
+/**
+ * VariationAssignment is a read-only reference to a single tool, tool set, or
+ * sub-agent attached to a variation. Clients read the full set of assignments via
+ * `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove
+ * assignment endpoints under /v1/agent_variations/{id}/assignments.
+ *
+ * The `id` identifies the assignment row itself (not the referenced resource) and
+ * is the handle used to remove the assignment. It is returned by the add endpoint
+ * and present on every entry in AgentVariationInfo.assignments.
+ */
+export interface VariationAssignment {
+  id?: string;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  agent?: Shared.BareMetadata;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  tool?: Shared.BareMetadata;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  toolSet?: Shared.BareMetadata;
+}
+
+export interface AgentVariationCreateParams {
   /**
    * CreateResourceMetadata contains the user-provided fields for creating a
    * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
@@ -314,14 +409,14 @@ export interface VariationCreateParams {
   spec: AgentVariationSpec;
 }
 
-export interface VariationRetrieveParams {
+export interface AgentVariationRetrieveParams {
   /**
    * Agent ID (from path)
    */
   agentId: string;
 }
 
-export interface VariationUpdateParams {
+export interface AgentVariationUpdateParams {
   /**
    * Path param: Agent ID (from path)
    */
@@ -347,7 +442,7 @@ export interface VariationUpdateParams {
   updateMask?: string;
 }
 
-export interface VariationListParams extends CursorPaginationParams {
+export interface AgentVariationListParams extends CursorPaginationParams {
   /**
    * When set to true you may use more of your alloted API rate-limit
    */
@@ -359,30 +454,46 @@ export interface VariationListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
-export interface VariationDeleteParams {
+export interface AgentVariationDeleteParams {
   /**
    * Agent ID (from path)
    */
   agentId: string;
 }
 
-export declare namespace Variations {
+export interface AgentVariationAddAssignmentParams {
+  subAgentId?: string;
+
+  toolId?: string;
+
+  toolSetId?: string;
+}
+
+export interface AgentVariationRemoveAssignmentParams {
+  agentVariationId: string;
+}
+
+export declare namespace AgentVariations {
   export {
     type AgentVariation as AgentVariation,
     type AgentVariationInfo as AgentVariationInfo,
     type AgentVariationSpec as AgentVariationSpec,
-    type AgentVariationSpecAgentDocument as AgentVariationSpecAgentDocument,
-    type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool,
+    type AgentVariationSpecCompactionConfig as AgentVariationSpecCompactionConfig,
     type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
     type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
     type AgentVariationSpecToolSelection as AgentVariationSpecToolSelection,
+    type CompactionConfigSummarizationStrategy as CompactionConfigSummarizationStrategy,
+    type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
     type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
     type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
+    type VariationAssignment as VariationAssignment,
     type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
-    type VariationCreateParams as VariationCreateParams,
-    type VariationRetrieveParams as VariationRetrieveParams,
-    type VariationUpdateParams as VariationUpdateParams,
-    type VariationListParams as VariationListParams,
-    type VariationDeleteParams as VariationDeleteParams,
+    type AgentVariationCreateParams as AgentVariationCreateParams,
+    type AgentVariationRetrieveParams as AgentVariationRetrieveParams,
+    type AgentVariationUpdateParams as AgentVariationUpdateParams,
+    type AgentVariationListParams as AgentVariationListParams,
+    type AgentVariationDeleteParams as AgentVariationDeleteParams,
+    type AgentVariationAddAssignmentParams as AgentVariationAddAssignmentParams,
+    type AgentVariationRemoveAssignmentParams as AgentVariationRemoveAssignmentParams,
   };
 }

package/src/resources/agents/agents.ts

@@ -2,27 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as AccountAPI from '../account';
+import * as AgentVariationsAPI from '../agent-variations';
 import * as Shared from '../shared';
-import * as VariationsAPI from './variations';
-import {
-  AgentVariation,
-  AgentVariationInfo,
-  AgentVariationSpec,
-  AgentVariationSpecAgentDocument,
-  AgentVariationSpecAgentTool,
-  AgentVariationSpecConstraints,
-  AgentVariationSpecModelConfig,
-  AgentVariationSpecToolSelection,
-  AgentVariationsCursorPagination,
-  ToolSelectionAssignedTools,
-  ToolSelectionAutoDiscovery,
-  VariationCreateParams,
-  VariationDeleteParams,
-  VariationListParams,
-  VariationRetrieveParams,
-  VariationUpdateParams,
-  Variations,
-} from './variations';
 import * as WebhookDeliveriesAPI from './webhook-deliveries';
 import {
   WebhookDeliveries,
@@ -46,7 +27,6 @@ import { path } from '../../internal/utils/path';
  *  Scope: Workspace-level operations
  */
 export class Agents extends APIResource {
-  variations: VariationsAPI.Variations = new VariationsAPI.Variations(this._client);
   webhookDeliveries: WebhookDeliveriesAPI.WebhookDeliveries = new WebhookDeliveriesAPI.WebhookDeliveries(
     this._client,
   );
@@ -158,13 +138,6 @@ export interface AgentSpec {
    */
   description?: string;
 
-  /**
-   * The generated secret that will sign all webhooks that are sent to your
-   * configured Webhook URL. Formatted as "wh_asdf1234" per the
-   * https://www.standardwebhooks.com/ format.
-   */
-  webhookEventsHmacSecret?: string;
-
   /**
    * The URL that Cadenya will send events for any objective assigned to the agent.
    */
@@ -211,7 +184,7 @@ export namespace AgentCreateParams {
     /**
      * AgentVariationSpec defines the operational configuration for a variation
      */
-    spec: VariationsAPI.AgentVariationSpec;
+    spec: AgentVariationsAPI.AgentVariationSpec;
   }
 }
 
@@ -251,7 +224,6 @@ export interface AgentListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
-Agents.Variations = Variations;
 Agents.WebhookDeliveries = WebhookDeliveries;
 
 export declare namespace Agents {
@@ -266,26 +238,6 @@ export declare namespace Agents {
     type AgentListParams as AgentListParams,
   };
 
-  export {
-    Variations as Variations,
-    type AgentVariation as AgentVariation,
-    type AgentVariationInfo as AgentVariationInfo,
-    type AgentVariationSpec as AgentVariationSpec,
-    type AgentVariationSpecAgentDocument as AgentVariationSpecAgentDocument,
-    type AgentVariationSpecAgentTool as AgentVariationSpecAgentTool,
-    type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
-    type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
-    type AgentVariationSpecToolSelection as AgentVariationSpecToolSelection,
-    type ToolSelectionAssignedTools as ToolSelectionAssignedTools,
-    type ToolSelectionAutoDiscovery as ToolSelectionAutoDiscovery,
-    type AgentVariationsCursorPagination as AgentVariationsCursorPagination,
-    type VariationCreateParams as VariationCreateParams,
-    type VariationRetrieveParams as VariationRetrieveParams,
-    type VariationUpdateParams as VariationUpdateParams,
-    type VariationListParams as VariationListParams,
-    type VariationDeleteParams as VariationDeleteParams,
-  };
-
   export {
     WebhookDeliveries as WebhookDeliveries,
     type WebhookDelivery as WebhookDelivery,

package/src/resources/agents/index.ts

@@ -11,25 +11,6 @@ export {
   type AgentListParams,
   type AgentsCursorPagination,
 } from './agents';
-export {
-  Variations,
-  type AgentVariation,
-  type AgentVariationInfo,
-  type AgentVariationSpec,
-  type AgentVariationSpecAgentDocument,
-  type AgentVariationSpecAgentTool,
-  type AgentVariationSpecConstraints,
-  type AgentVariationSpecModelConfig,
-  type AgentVariationSpecToolSelection,
-  type ToolSelectionAssignedTools,
-  type ToolSelectionAutoDiscovery,
-  type VariationCreateParams,
-  type VariationRetrieveParams,
-  type VariationUpdateParams,
-  type VariationListParams,
-  type VariationDeleteParams,
-  type AgentVariationsCursorPagination,
-} from './variations';
 export {
   WebhookDeliveries,
   type WebhookDelivery,

package/src/resources/agents/webhook-deliveries.ts

@@ -68,7 +68,8 @@ export interface WebhookDeliveryData {
     | 'OBJECTIVE_EVENT_TYPE_ERROR'
     | 'OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_RESULT'
-    | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR';
+    | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR'
+    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED';
 
   /**
    * Response details (no response_body to avoid storing large payloads)
@@ -125,7 +126,8 @@ export interface WebhookDeliveryListParams extends CursorPaginationParams {
     | 'OBJECTIVE_EVENT_TYPE_ERROR'
     | 'OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE'
     | 'OBJECTIVE_EVENT_TYPE_TOOL_RESULT'
-    | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR';
+    | 'OBJECTIVE_EVENT_TYPE_TOOL_ERROR'
+    | 'OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED';
 
   /**
    * Optional filter by objective ID

package/src/resources/index.ts

@@ -11,7 +11,37 @@ export {
   type APIKeyListParams,
   type APIKeysCursorPagination,
 } from './api-keys';
-export { AccountResource, type Account, type AccountSpec, type Profile, type ProfileSpec } from './account';
+export {
+  AccountResource,
+  type Account,
+  type AccountSpec,
+  type Profile,
+  type ProfileSpec,
+  type RotateWebhookSigningKeyResponse,
+} from './account';
+export {
+  AgentVariations,
+  type AgentVariation,
+  type AgentVariationInfo,
+  type AgentVariationSpec,
+  type AgentVariationSpecCompactionConfig,
+  type AgentVariationSpecConstraints,
+  type AgentVariationSpecModelConfig,
+  type AgentVariationSpecToolSelection,
+  type CompactionConfigSummarizationStrategy,
+  type CompactionConfigToolResultClearingStrategy,
+  type ToolSelectionAssignedTools,
+  type ToolSelectionAutoDiscovery,
+  type VariationAssignment,
+  type AgentVariationCreateParams,
+  type AgentVariationRetrieveParams,
+  type AgentVariationUpdateParams,
+  type AgentVariationListParams,
+  type AgentVariationDeleteParams,
+  type AgentVariationAddAssignmentParams,
+  type AgentVariationRemoveAssignmentParams,
+  type AgentVariationsCursorPagination,
+} from './agent-variations';
 export {
   Agents,
   type Agent,
@@ -36,6 +66,7 @@ export {
   type AssistantMessage,
   type AssistantToolCall,
   type CallableTool,
+  type ContextWindowCompacted,
   type Objective,
   type ObjectiveContextWindow,
   type ObjectiveContextWindowData,
@@ -55,11 +86,13 @@ export {
   type ToolError,
   type ToolResult,
   type UserMessage,
+  type ObjectiveCompactResponse,
   type ObjectiveContinueResponse,
   type ObjectiveListEventsResponse,
   type ObjectiveCreateParams,
   type ObjectiveListParams,
   type ObjectiveCancelParams,
+  type ObjectiveCompactParams,
   type ObjectiveContinueParams,
   type ObjectiveListContextWindowsParams,
   type ObjectiveListEventsParams,
@@ -93,6 +126,7 @@ export {
   type ToolSetsCursorPagination,
   type ToolSetEventsCursorPagination,
 } from './tool-sets/tool-sets';
+export { Webhooks, type UnsafeUnwrapWebhookEvent, type UnwrapWebhookEvent } from './webhooks';
 export {
   WorkspaceSecrets,
   type WorkspaceSecret,

package/src/resources/objectives/feedback.ts

@@ -48,12 +48,12 @@ export interface ObjectiveFeedback {
   data: ObjectiveFeedbackData;
 
   /**
-   * BareMetadata contains the minimal metadata for a resource, including the ID.
-   * These are used sparingly in Cadenya for resources where the full metadata is not
-   * needed. You will come across them in list responses and other places where the
-   * full metadata is not required like listing the tools that were assigned to an
-   * objective. Because these types records are commonly created by other processes
-   * in Cadenya, they do not have things like external IDs, labels, or names.
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
    */
   metadata: Shared.BareMetadata;
 

package/src/resources/objectives/index.ts

@@ -14,6 +14,7 @@ export {
   type AssistantMessage,
   type AssistantToolCall,
   type CallableTool,
+  type ContextWindowCompacted,
   type Objective,
   type ObjectiveContextWindow,
   type ObjectiveContextWindowData,
@@ -33,11 +34,13 @@ export {
   type ToolError,
   type ToolResult,
   type UserMessage,
+  type ObjectiveCompactResponse,
   type ObjectiveContinueResponse,
   type ObjectiveListEventsResponse,
   type ObjectiveCreateParams,
   type ObjectiveListParams,
   type ObjectiveCancelParams,
+  type ObjectiveCompactParams,
   type ObjectiveContinueParams,
   type ObjectiveListContextWindowsParams,
   type ObjectiveListEventsParams,