@cadenya/cadenya 0.50.0 → 0.52.0

package/resources/tool-sets/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/resources/tool-sets/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/resources/tool-sets/tools.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,UAAU;OACf,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,WAAW,EAAE;OAE9D,EAAE,cAAc,EAAE;AAGzB;;;;;;;;;;GAUG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAI7F;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAK5F;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAKxF;;OAEG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,qBAAqB,EAAE,IAAI,CAAC;IAO3C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOzF;AAED,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,yBAAyB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEvF,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC;IAElC,IAAI,EAAE,QAAQ,CAAC;IAEf,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB,WAAW,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAEvC,MAAM,EACF,yBAAyB,GACzB,uBAAuB,GACvB,sBAAsB,GACtB,sBAAsB,CAAC;IAE3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,sBAAsB,CAAC;IAExC,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,sBAAsB,CAAC;IAEzC;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,sBAAsB;IAC5D;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}

package/src/resources/agents/agents.ts

@@ -3,6 +3,8 @@
 import { APIResource } from '../../core/resource';
 import * as AccountAPI from '../account';
 import * as Shared from '../shared';
+import * as FeedbackAPI from './feedback';
+import { Feedback, FeedbackListParams } from './feedback';
 import * as VariationsAPI from './variations';
 import {
   AgentVariation,
@@ -11,6 +13,7 @@ import {
   AgentVariationSpecCompactionConfig,
   AgentVariationSpecConstraints,
   AgentVariationSpecModelConfig,
+  AgentVariationSpecProgressiveDiscovery,
   AgentVariationsCursorPagination,
   CompactionConfigSummarizationStrategy,
   CompactionConfigToolResultClearingStrategy,
@@ -51,6 +54,7 @@ import { path } from '../../internal/utils/path';
  *  Scope: Workspace-level operations
  */
 export class Agents extends APIResource {
+  feedback: FeedbackAPI.Feedback = new FeedbackAPI.Feedback(this._client);
   webhookDeliveries: WebhookDeliveriesAPI.WebhookDeliveries = new WebhookDeliveriesAPI.WebhookDeliveries(
     this._client,
   );
@@ -258,6 +262,7 @@ export interface AgentListParams extends CursorPaginationParams {
   sortOrder?: string;
 }
 
+Agents.Feedback = Feedback;
 Agents.WebhookDeliveries = WebhookDeliveries;
 Agents.Variations = Variations;
 
@@ -273,6 +278,8 @@ export declare namespace Agents {
     type AgentListParams as AgentListParams,
   };
 
+  export { Feedback as Feedback, type FeedbackListParams as FeedbackListParams };
+
   export {
     WebhookDeliveries as WebhookDeliveries,
     type WebhookDelivery as WebhookDelivery,
@@ -289,6 +296,7 @@ export declare namespace Agents {
     type AgentVariationSpecCompactionConfig as AgentVariationSpecCompactionConfig,
     type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
     type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
+    type AgentVariationSpecProgressiveDiscovery as AgentVariationSpecProgressiveDiscovery,
     type CompactionConfigSummarizationStrategy as CompactionConfigSummarizationStrategy,
     type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
     type VariationAssignment as VariationAssignment,

package/src/resources/agents/feedback.ts

@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ObjectivesFeedbackAPI from '../objectives/feedback';
+import { ObjectiveFeedbacksCursorPagination } from '../objectives/feedback';
+import { CursorPagination, type CursorPaginationParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * AgentService manages AI agents at the WORKSPACE level.
+ *  Agents are workspace-scoped resources that define AI behavior and tool access.
+ *  All operations are implicitly scoped to the workspace determined by the JWT token.
+ *
+ *  Authentication: Bearer token (JWT)
+ *  Scope: Workspace-level operations
+ */
+export class Feedback extends APIResource {
+  /**
+   * Lists feedback submitted across all objectives belonging to an agent. Supports
+   * search by comment, sentiment filter, agent variation filter, and creation date
+   * range. Results are ordered by creation time, newest first.
+   */
+  list(
+    agentID: string,
+    query: FeedbackListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ObjectiveFeedbacksCursorPagination, ObjectivesFeedbackAPI.ObjectiveFeedback> {
+    return this._client.getAPIList(
+      path`/v1/agents/${agentID}/feedback`,
+      CursorPagination<ObjectivesFeedbackAPI.ObjectiveFeedback>,
+      { query, ...options },
+    );
+  }
+}
+
+export interface FeedbackListParams extends CursorPaginationParams {
+  /**
+   * Optional filter to limit results to feedback on objectives run by a single agent
+   * variation. Supports "external_id:" prefix for external IDs.
+   */
+  agentVariationId?: string;
+
+  /**
+   * Inclusive lower bound on feedback creation time.
+   */
+  createdAfter?: string;
+
+  /**
+   * Exclusive upper bound on feedback creation time.
+   */
+  createdBefore?: string;
+
+  /**
+   * Free-text search applied to the feedback comment. Case-insensitive substring
+   * match.
+   */
+  query?: string;
+
+  /**
+   * Filter by sentiment. UNSPECIFIED returns feedback regardless of score.
+   */
+  sentiment?:
+    | 'FEEDBACK_SENTIMENT_UNSPECIFIED'
+    | 'FEEDBACK_SENTIMENT_POSITIVE'
+    | 'FEEDBACK_SENTIMENT_NEGATIVE';
+}
+
+export declare namespace Feedback {
+  export { type FeedbackListParams as FeedbackListParams };
+}
+
+export { type ObjectiveFeedbacksCursorPagination };

package/src/resources/agents/index.ts

@@ -11,6 +11,7 @@ export {
   type AgentListParams,
   type AgentsCursorPagination,
 } from './agents';
+export { Feedback, type FeedbackListParams } from './feedback';
 export {
   Variations,
   type AgentVariation,
@@ -19,6 +20,7 @@ export {
   type AgentVariationSpecCompactionConfig,
   type AgentVariationSpecConstraints,
   type AgentVariationSpecModelConfig,
+  type AgentVariationSpecProgressiveDiscovery,
   type CompactionConfigSummarizationStrategy,
   type CompactionConfigToolResultClearingStrategy,
   type VariationAssignment,

package/src/resources/agents/variations.ts

@@ -272,7 +272,7 @@ export interface AgentVariationSpec {
    * tool search. These are used in conjunction with the context-aware tool search
    * and can help select the best tools for the task.
    */
-  progressiveDiscovery?: AgentVariationSpec.ProgressiveDiscovery;
+  progressiveDiscovery?: AgentVariationSpecProgressiveDiscovery;
 
   /**
    * The system prompt for this variation
@@ -288,30 +288,6 @@ 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.
@@ -365,6 +341,28 @@ export interface AgentVariationSpecModelConfig {
   temperature?: number;
 }
 
+/**
+ * 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 AgentVariationSpecProgressiveDiscovery {
+  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;
+}
+
 /**
  * SummarizationStrategy configures LLM-powered summarization of older conversation
  * turns.
@@ -486,14 +484,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;
 
@@ -531,14 +531,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;
 
@@ -560,12 +562,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;
 
@@ -577,25 +581,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;
 
@@ -613,6 +635,7 @@ export declare namespace Variations {
     type AgentVariationSpecCompactionConfig as AgentVariationSpecCompactionConfig,
     type AgentVariationSpecConstraints as AgentVariationSpecConstraints,
     type AgentVariationSpecModelConfig as AgentVariationSpecModelConfig,
+    type AgentVariationSpecProgressiveDiscovery as AgentVariationSpecProgressiveDiscovery,
     type CompactionConfigSummarizationStrategy as CompactionConfigSummarizationStrategy,
     type CompactionConfigToolResultClearingStrategy as CompactionConfigToolResultClearingStrategy,
     type VariationAssignment as VariationAssignment,

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/objectives/feedback.ts

@@ -83,6 +83,26 @@ export interface ObjectiveFeedbackData {
 }
 
 export interface ObjectiveFeedbackInfo {
+  /**
+   * 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.
+   */
+  agentVariation?: 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.
+   */
+  objective?: Shared.BareMetadata;
+
   /**
    * Profile represents a human user at the account level. Profiles are
    * account-scoped resources that can be associated with multiple workspaces through

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.50.0'; // x-release-please-version
+export const VERSION = '0.52.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.50.0";
+export declare const VERSION = "0.52.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.50.0'; // x-release-please-version
+exports.VERSION = '0.52.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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