@cadenya/cadenya 0.49.0 → 0.51.0

package/src/resources/agents/variations.ts

@@ -266,14 +266,18 @@ export interface AgentVariationSpec {
   modelConfig?: AgentVariationSpecModelConfig;
 
   /**
-   * The system prompt for this variation
+   * ProgressiveDiscovery is used to indicate that the agent should automatically
+   * discover tools that are not explicitly assigned to it. Max tools is the maximum
+   * number of tools that can be discovered per search. Hints are optional hints for
+   * tool search. These are used in conjunction with the context-aware tool search
+   * and can help select the best tools for the task.
    */
-  prompt?: string;
+  progressiveDiscovery?: AgentVariationSpec.ProgressiveDiscovery;
 
   /**
-   * Tool selection strategy
+   * The system prompt for this variation
    */
-  toolSelection?: AgentVariationSpecToolSelection;
+  prompt?: string;
 
   /**
    * Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
@@ -284,6 +288,30 @@ export interface AgentVariationSpec {
   weight?: number;
 }
 
+export namespace AgentVariationSpec {
+  /**
+   * ProgressiveDiscovery is used to indicate that the agent should automatically
+   * discover tools that are not explicitly assigned to it. Max tools is the maximum
+   * number of tools that can be discovered per search. Hints are optional hints for
+   * tool search. These are used in conjunction with the context-aware tool search
+   * and can help select the best tools for the task.
+   */
+  export interface ProgressiveDiscovery {
+    hints?: Array<string>;
+
+    maxTools?: number;
+
+    /**
+     * Rerank Threshold is an optional value that instructs whether or not to run a
+     * search result through a embedding/reranker process which can improve performance
+     * and reduce context bloat when tools reach the configured threshold. If a tool
+     * match must exceed 0.8, for example, the tool very closely match the query the
+     * tool search performed.
+     */
+    rerankThreshold?: number;
+  }
+}
+
 /**
  * CompactionConfig defines how context window compaction behaves for objectives
  * using this variation.
@@ -337,24 +365,6 @@ export interface AgentVariationSpecModelConfig {
   temperature?: number;
 }
 
-export interface AgentVariationSpecToolSelection {
-  /**
-   * 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
-   * thinks it needs to discover more tools.
-   */
-  assignedTools?: ToolSelectionAssignedTools;
-
-  /**
-   * AutoDiscovery is used to indicate that the agent should automatically discover
-   * tools that are not explicitly assigned to it. Max tools is the maximum number of
-   * tools that can be discovered. Hints are optional hints for tool search. These
-   * are used in conjunction with the context-aware tool search and can help select
-   * the best tools for the task.
-   */
-  autoDiscovery?: ToolSelectionAutoDiscovery;
-}
-
 /**
  * SummarizationStrategy configures LLM-powered summarization of older conversation
  * turns.
@@ -380,28 +390,6 @@ export interface CompactionConfigToolResultClearingStrategy {
   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
- * thinks it needs to discover more tools.
- */
-export interface ToolSelectionAssignedTools {
-  allowDiscovery?: boolean;
-}
-
-/**
- * AutoDiscovery is used to indicate that the agent should automatically discover
- * tools that are not explicitly assigned to it. Max tools is the maximum number of
- * tools that can be discovered. Hints are optional hints for tool search. These
- * are used in conjunction with the context-aware tool search and can help select
- * the best tools for the task.
- */
-export interface ToolSelectionAutoDiscovery {
-  hints?: Array<string>;
-
-  maxTools?: number;
-}
-
 /**
  * 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
@@ -498,14 +486,16 @@ export interface VariationCreateParams {
 
 export interface VariationRetrieveParams {
   /**
-   * Agent ID (from path)
+   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 }
 
 export interface VariationUpdateParams {
   /**
-   * Path param: Agent ID (from path)
+   * Path param: Agent ID (from path). Accepts canonical agent\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 
@@ -543,14 +533,16 @@ export interface VariationListParams extends CursorPaginationParams {
 
 export interface VariationDeleteParams {
   /**
-   * Agent ID (from path)
+   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 }
 
 export interface VariationAddAssignmentParams {
   /**
-   * Path param
+   * Path param: Agent ID (from path). Accepts canonical agent\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 
@@ -572,12 +564,14 @@ export interface VariationAddAssignmentParams {
 
 export interface VariationAddMemoryLayerParams {
   /**
-   * Path param
+   * Path param: Agent ID (from path). Accepts canonical agent\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 
   /**
-   * Body param: Layer to attach. Accepts memlyr\_… or external_id:… form.
+   * Body param: Layer to attach. Accepts canonical memlyr\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   memoryLayerId?: string;
 
@@ -589,25 +583,43 @@ export interface VariationAddMemoryLayerParams {
 }
 
 export interface VariationRemoveAssignmentParams {
+  /**
+   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   agentId: string;
 
+  /**
+   * Variation ID (from path). Accepts canonical av\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   variationId: string;
 }
 
 export interface VariationRemoveMemoryLayerParams {
+  /**
+   * Agent ID (from path). Accepts canonical agent\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   agentId: string;
 
+  /**
+   * Variation ID (from path). Accepts canonical av\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   variationId: string;
 }
 
 export interface VariationUpdateMemoryLayerParams {
   /**
-   * Path param
+   * Path param: Agent ID (from path). Accepts canonical agent\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   agentId: string;
 
   /**
-   * Path param
+   * Path param: Variation ID (from path). Accepts canonical av\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   variationId: string;
 
@@ -625,11 +637,8 @@ export declare namespace Variations {
     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 VariationMemoryLayerAssignment as VariationMemoryLayerAssignment,
     type AgentVariationsCursorPagination as AgentVariationsCursorPagination,

package/src/resources/memory-layers/entries.ts

@@ -244,12 +244,17 @@ export interface EntryCreateParams {
 }
 
 export interface EntryRetrieveParams {
+  /**
+   * Memory layer ID (from path). Accepts canonical memlyr\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   */
   memoryLayerId: string;
 }
 
 export interface EntryUpdateParams {
   /**
-   * Path param
+   * Path param: Memory layer ID (from path). Accepts canonical memlyr\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   memoryLayerId: string;
 
@@ -294,6 +299,10 @@ export interface EntryListParams extends CursorPaginationParams {
 }
 
 export interface EntryDeleteParams {
+  /**
+   * Memory layer ID (from path). Accepts canonical memlyr\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
+   */
   memoryLayerId: string;
 }
 

package/src/resources/tool-sets/tools.ts

@@ -173,12 +173,17 @@ export interface ToolCreateParams {
 }
 
 export interface ToolRetrieveParams {
+  /**
+   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   toolSetId: string;
 }
 
 export interface ToolUpdateParams {
   /**
-   * Path param
+   * Path param: Tool set ID (from path). Accepts canonical ts\_… form or
+   * external_id:<value> form (see common.proto "Path-parameter ID resolution").
    */
   toolSetId: string;
 
@@ -219,6 +224,10 @@ export interface ToolListParams extends CursorPaginationParams {
 }
 
 export interface ToolDeleteParams {
+  /**
+   * Tool set ID (from path). Accepts canonical ts\_… form or external_id:<value>
+   * form (see common.proto "Path-parameter ID resolution").
+   */
   toolSetId: string;
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.49.0'; // x-release-please-version
+export const VERSION = '0.51.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.49.0";
+export declare const VERSION = "0.51.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.49.0";
+export declare const VERSION = "0.51.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.49.0'; // x-release-please-version
+exports.VERSION = '0.51.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.49.0'; // x-release-please-version
+export const VERSION = '0.51.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map