@cadenya/cadenya 0.42.0 → 0.43.0

package/resources/webhooks.d.ts

@@ -0,0 +1,116 @@
+import { APIResource } from "../core/resource.js";
+import * as Shared from "./shared.js";
+import * as ObjectivesAPI from "./objectives/objectives.js";
+export declare class Webhooks extends APIResource {
+    unsafeUnwrap(body: string): UnsafeUnwrapWebhookEvent;
+    unwrap(body: string, { headers, key }: {
+        headers: Record<string, string>;
+        key?: string;
+    }): UnwrapWebhookEvent;
+}
+/**
+ * The envelope for an objective event webhook delivery. Contains timestamp, event
+ * type, and the webhook data payload.
+ */
+export interface UnsafeUnwrapWebhookEvent {
+    /**
+     * The webhook data payload with flat top-level keys for agent, variation,
+     * objective, and event.
+     */
+    data: UnsafeUnwrapWebhookEvent.Data;
+    timestamp: string;
+    /**
+     * The event type, prefixed with objective_event. (e.g.,
+     * objective_event.tool_result)
+     */
+    type: string;
+}
+export declare namespace UnsafeUnwrapWebhookEvent {
+    /**
+     * The webhook data payload with flat top-level keys for agent, variation,
+     * objective, and event.
+     */
+    interface Data {
+        /**
+         * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+         */
+        agent: Shared.ResourceMetadata;
+        /**
+         * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+         */
+        agentVariation: Shared.ResourceMetadata;
+        /**
+         * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+         * runs)
+         */
+        objective: Shared.OperationMetadata;
+        objectiveEvent: Data.ObjectiveEvent;
+    }
+    namespace Data {
+        interface ObjectiveEvent {
+            data: ObjectivesAPI.ObjectiveEventData;
+            /**
+             * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+             * runs)
+             */
+            metadata: Shared.OperationMetadata;
+            contextWindowId?: string;
+            info?: ObjectivesAPI.ObjectiveEventInfo;
+        }
+    }
+}
+/**
+ * The envelope for an objective event webhook delivery. Contains timestamp, event
+ * type, and the webhook data payload.
+ */
+export interface UnwrapWebhookEvent {
+    /**
+     * The webhook data payload with flat top-level keys for agent, variation,
+     * objective, and event.
+     */
+    data: UnwrapWebhookEvent.Data;
+    timestamp: string;
+    /**
+     * The event type, prefixed with objective_event. (e.g.,
+     * objective_event.tool_result)
+     */
+    type: string;
+}
+export declare namespace UnwrapWebhookEvent {
+    /**
+     * The webhook data payload with flat top-level keys for agent, variation,
+     * objective, and event.
+     */
+    interface Data {
+        /**
+         * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+         */
+        agent: Shared.ResourceMetadata;
+        /**
+         * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+         */
+        agentVariation: Shared.ResourceMetadata;
+        /**
+         * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+         * runs)
+         */
+        objective: Shared.OperationMetadata;
+        objectiveEvent: Data.ObjectiveEvent;
+    }
+    namespace Data {
+        interface ObjectiveEvent {
+            data: ObjectivesAPI.ObjectiveEventData;
+            /**
+             * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+             * runs)
+             */
+            metadata: Shared.OperationMetadata;
+            contextWindowId?: string;
+            info?: ObjectivesAPI.ObjectiveEventInfo;
+        }
+    }
+}
+export declare namespace Webhooks {
+    export { type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent, type UnwrapWebhookEvent as UnwrapWebhookEvent, };
+}
+//# sourceMappingURL=webhooks.d.ts.map

package/resources/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/resources/webhooks.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,KAAK,aAAa;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB;IAIpD,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAClE,kBAAkB;CAStB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC;IAEpC,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,wBAAwB,CAAC;IACxC;;;OAGG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAE/B;;WAEG;QACH,cAAc,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAExC;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC;QAEpC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC;KACrC;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,cAAc;YAC7B,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC;YAEvC;;;eAGG;YACH,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC;YAEnC,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB,IAAI,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC;SACzC;KACF;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC;IAE9B,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;;OAGG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAE/B;;WAEG;QACH,cAAc,EAAE,MAAM,CAAC,gBAAgB,CAAC;QAExC;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC;QAEpC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC;KACrC;IAED,UAAiB,IAAI,CAAC;QACpB,UAAiB,cAAc;YAC7B,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC;YAEvC;;;eAGG;YACH,QAAQ,EAAE,MAAM,CAAC,iBAAiB,CAAC;YAEnC,eAAe,CAAC,EAAE,MAAM,CAAC;YAEzB,IAAI,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC;SACzC;KACF;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/webhooks.js

@@ -0,0 +1,23 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Webhooks = void 0;
+const resource_1 = require("../core/resource.js");
+const standardwebhooks_1 = require("standardwebhooks");
+class Webhooks extends resource_1.APIResource {
+    unsafeUnwrap(body) {
+        return JSON.parse(body);
+    }
+    unwrap(body, { headers, key }) {
+        if (headers !== undefined) {
+            const keyStr = key === undefined ? this._client.webhookKey : key;
+            if (keyStr === null)
+                throw new Error('Webhook key must not be null in order to unwrap');
+            const wh = new standardwebhooks_1.Webhook(keyStr);
+            wh.verify(body, headers);
+        }
+        return JSON.parse(body);
+    }
+}
+exports.Webhooks = Webhooks;
+//# sourceMappingURL=webhooks.js.map

package/resources/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/resources/webhooks.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,uDAA2C;AAE3C,MAAa,QAAS,SAAQ,sBAAW;IACvC,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC;IACtD,CAAC;IAED,MAAM,CACJ,IAAY,EACZ,EAAE,OAAO,EAAE,GAAG,EAAqD;QAEnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAkB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;YAChF,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACxF,MAAM,EAAE,GAAG,IAAI,0BAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;IAChD,CAAC;CACF;AAjBD,4BAiBC"}

package/resources/webhooks.mjs

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { Webhook } from 'standardwebhooks';
+export class Webhooks extends APIResource {
+    unsafeUnwrap(body) {
+        return JSON.parse(body);
+    }
+    unwrap(body, { headers, key }) {
+        if (headers !== undefined) {
+            const keyStr = key === undefined ? this._client.webhookKey : key;
+            if (keyStr === null)
+                throw new Error('Webhook key must not be null in order to unwrap');
+            const wh = new Webhook(keyStr);
+            wh.verify(body, headers);
+        }
+        return JSON.parse(body);
+    }
+}
+//# sourceMappingURL=webhooks.mjs.map

package/resources/webhooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.mjs","sourceRoot":"","sources":["../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,OAAO,EAAE,MAAM,kBAAkB;AAE1C,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC;IACtD,CAAC;IAED,MAAM,CACJ,IAAY,EACZ,EAAE,OAAO,EAAE,GAAG,EAAqD;QAEnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAkB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;YAChF,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACxF,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/B,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;IAChD,CAAC;CACF"}

package/src/client.ts

@@ -19,7 +19,37 @@ import { AbstractPage, type CursorPaginationParams, CursorPaginationResponse } f
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import { Account, AccountResource, AccountSpec, Profile, ProfileSpec } from './resources/account';
+import {
+  Account,
+  AccountResource,
+  AccountSpec,
+  Profile,
+  ProfileSpec,
+  RotateWebhookSigningKeyResponse,
+} from './resources/account';
+import {
+  AgentVariation,
+  AgentVariationAddAssignmentParams,
+  AgentVariationCreateParams,
+  AgentVariationDeleteParams,
+  AgentVariationInfo,
+  AgentVariationListParams,
+  AgentVariationRemoveAssignmentParams,
+  AgentVariationRetrieveParams,
+  AgentVariationSpec,
+  AgentVariationSpecCompactionConfig,
+  AgentVariationSpecConstraints,
+  AgentVariationSpecModelConfig,
+  AgentVariationSpecToolSelection,
+  AgentVariationUpdateParams,
+  AgentVariations,
+  AgentVariationsCursorPagination,
+  CompactionConfigSummarizationStrategy,
+  CompactionConfigToolResultClearingStrategy,
+  ToolSelectionAssignedTools,
+  ToolSelectionAutoDiscovery,
+  VariationAssignment,
+} from './resources/agent-variations';
 import {
   APIKey,
   APIKeyCreateParams,
@@ -43,6 +73,7 @@ import {
   SearchSearchToolsOrToolSetsParams,
   SearchSearchToolsOrToolSetsResponse,
 } from './resources/search';
+import { UnsafeUnwrapWebhookEvent, UnwrapWebhookEvent, Webhooks } from './resources/webhooks';
 import {
   WorkspaceSecret,
   WorkspaceSecretCreateParams,
@@ -150,6 +181,11 @@ export interface ClientOptions {
    */
   apiKey?: string | undefined;
 
+  /**
+   * Defaults to process.env['CADENYA_WEBHOOK_KEY'].
+   */
+  webhookKey?: string | null | undefined;
+
   /**
    * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
    *
@@ -224,6 +260,7 @@ export interface ClientOptions {
  */
 export class Cadenya {
   apiKey: string;
+  webhookKey: string | null;
 
   baseURL: string;
   maxRetries: number;
@@ -241,6 +278,7 @@ export class Cadenya {
    * API Client for interfacing with the Cadenya API.
    *
    * @param {string | undefined} [opts.apiKey=process.env['CADENYA_API_KEY'] ?? undefined]
+   * @param {string | null | undefined} [opts.webhookKey=process.env['CADENYA_WEBHOOK_KEY'] ?? null]
    * @param {string} [opts.baseURL=process.env['CADENYA_BASE_URL'] ?? https://api.cadenya.com] - Override the default base URL for the API.
    * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
    * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
@@ -252,6 +290,7 @@ export class Cadenya {
   constructor({
     baseURL = readEnv('CADENYA_BASE_URL'),
     apiKey = readEnv('CADENYA_API_KEY'),
+    webhookKey = readEnv('CADENYA_WEBHOOK_KEY') ?? null,
     ...opts
   }: ClientOptions = {}) {
     if (apiKey === undefined) {
@@ -262,6 +301,7 @@ export class Cadenya {
 
     const options: ClientOptions = {
       apiKey,
+      webhookKey,
       ...opts,
       baseURL: baseURL || `https://api.cadenya.com`,
     };
@@ -284,6 +324,7 @@ export class Cadenya {
     this._options = options;
 
     this.apiKey = apiKey;
+    this.webhookKey = webhookKey;
   }
 
   /**
@@ -300,6 +341,7 @@ export class Cadenya {
       fetch: this.fetch,
       fetchOptions: this.fetchOptions,
       apiKey: this.apiKey,
+      webhookKey: this.webhookKey,
       ...options,
     });
     return client;
@@ -873,6 +915,7 @@ export class Cadenya {
    *  Scope: Workspace-level operations
    */
   agents: API.Agents = new API.Agents(this);
+  agentVariations: API.AgentVariations = new API.AgentVariations(this);
   objectives: API.Objectives = new API.Objectives(this);
   /**
    * ModelService manages LLM models at the WORKSPACE level.
@@ -915,10 +958,12 @@ export class Cadenya {
    *  Scope: Account-level operations (manages workspaces themselves, not resources within workspaces)
    */
   workspaces: API.Workspaces = new API.Workspaces(this);
+  webhooks: API.Webhooks = new API.Webhooks(this);
 }
 
 Cadenya.AccountResource = AccountResource;
 Cadenya.Agents = Agents;
+Cadenya.AgentVariations = AgentVariations;
 Cadenya.Objectives = Objectives;
 Cadenya.Models = Models;
 Cadenya.Search = Search;
@@ -926,6 +971,7 @@ Cadenya.ToolSets = ToolSets;
 Cadenya.APIKeys = APIKeys;
 Cadenya.WorkspaceSecrets = WorkspaceSecrets;
 Cadenya.Workspaces = Workspaces;
+Cadenya.Webhooks = Webhooks;
 
 export declare namespace Cadenya {
   export type RequestOptions = Opts.RequestOptions;
@@ -942,6 +988,7 @@ export declare namespace Cadenya {
     type AccountSpec as AccountSpec,
     type Profile as Profile,
     type ProfileSpec as ProfileSpec,
+    type RotateWebhookSigningKeyResponse as RotateWebhookSigningKeyResponse,
   };
 
   export {
@@ -956,6 +1003,30 @@ export declare namespace Cadenya {
     type AgentListParams as AgentListParams,
   };
 
+  export {
+    AgentVariations as AgentVariations,
+    type AgentVariation as AgentVariation,
+    type AgentVariationInfo as AgentVariationInfo,
+    type AgentVariationSpec as AgentVariationSpec,
+    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 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,
+  };
+
   export {
     Objectives as Objectives,
     type AssistantMessage as AssistantMessage,
@@ -1063,6 +1134,12 @@ export declare namespace Cadenya {
     type WorkspaceListParams as WorkspaceListParams,
   };
 
+  export {
+    Webhooks as Webhooks,
+    type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent,
+    type UnwrapWebhookEvent as UnwrapWebhookEvent,
+  };
+
   export type AccountResourceMetadata = API.AccountResourceMetadata;
   export type BareMetadata = API.BareMetadata;
   export type CreateOperationMetadata = API.CreateOperationMetadata;

package/src/resources/account.ts

@@ -22,18 +22,53 @@ export class AccountResource extends APIResource {
   retrieve(options?: RequestOptions): APIPromise<Account> {
     return this._client.get('/v1/account', options);
   }
+
+  /**
+   * Rotates the webhook signing key for the account. Returns only the new key.
+   */
+  rotateWebhookSigningKey(options?: RequestOptions): APIPromise<RotateWebhookSigningKeyResponse> {
+    return this._client.post('/v1/account/rotate_webhook_signing_key', options);
+  }
 }
 
+/**
+ * Account is an account resource.
+ */
 export interface Account {
+  /**
+   * AccountInfo contains information about the account.
+   */
+  info: Account.Info;
+
   /**
    * AccountResourceMetadata is used to represent a resource that is associated to an
    * account but not to a workspace.
    */
   metadata: Shared.AccountResourceMetadata;
 
+  /**
+   * AccountSpec contains the specification for an account.
+   */
   spec: AccountSpec;
 }
 
+export namespace Account {
+  /**
+   * AccountInfo contains information about the account.
+   */
+  export interface Info {
+    /**
+     * 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;
+  }
+}
+
+/**
+ * AccountSpec contains the specification for an account.
+ */
 export interface AccountSpec {
   billingEmail?: string;
 
@@ -83,11 +118,20 @@ export interface ProfileSpec {
   name?: string;
 }
 
+/**
+ * RotateWebhookEventsHmacSecretResponse is a response to a
+ * RotateWebhookEventsHmacSecretRequest.
+ */
+export interface RotateWebhookSigningKeyResponse {
+  webhookEventsHmacSecret?: string;
+}
+
 export declare namespace AccountResource {
   export {
     type Account as Account,
     type AccountSpec as AccountSpec,
     type Profile as Profile,
     type ProfileSpec as ProfileSpec,
+    type RotateWebhookSigningKeyResponse as RotateWebhookSigningKeyResponse,
   };
 }