@cadenya/cadenya 0.86.0 → 0.88.0

package/src/resources/agents/variations.ts

@@ -261,21 +261,6 @@ export interface AgentVariationSpec {
    */
   description?: string;
 
-  /**
-   * Enable episodic memory for objectives using this variation. When true, the
-   * system automatically creates a document namespace for each objective using the
-   * objective's episodic_key as the external_id, allowing the agent to store and
-   * retrieve documents specific to that episode.
-   */
-  enableEpisodicMemory?: boolean;
-
-  /**
-   * How long episodic memories should be retained. After this duration, episodic
-   * document namespaces can be automatically cleaned up. If not set, episodic
-   * memories are retained indefinitely.
-   */
-  episodicMemoryTtl?: number;
-
   /**
    * ModelConfig defines the model configuration for a variation
    */

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

@@ -132,12 +132,24 @@ export interface MemoryLayerInfo {
 export interface MemoryLayerSpec {
   type: 'MEMORY_LAYER_TYPE_UNSPECIFIED' | 'MEMORY_LAYER_TYPE_EPISODIC' | 'MEMORY_LAYER_TYPE_SKILLS';
 
+  /**
+   * Server-set on episodic layers: the agent this layer belongs to. Unset for
+   * non-episodic layers.
+   */
+  agentId?: string;
+
   /**
    * Human-readable description of the layer's purpose. Encouraged for user-created
    * layers; system-managed layers may have a generated description.
    */
   description?: string;
 
+  /**
+   * Server-set on episodic layers: the caller-supplied episodic key the layer was
+   * created for. Unset for non-episodic layers.
+   */
+  episodicKey?: string;
+
   /**
    * For layers with a finite lifetime (e.g., episodic), the time at which the layer
    * becomes eligible for cleanup. Set by the system; unset for persistent layers.
@@ -194,11 +206,23 @@ export interface MemoryLayerUpdateParams {
 }
 
 export interface MemoryLayerListParams extends CursorPaginationParams {
+  /**
+   * Filter to episodic layers belonging to this agent.
+   */
+  agentId?: string;
+
   /**
    * Filter by bundle_key — return only resources owned by this bundle.
    */
   bundleKey?: string;
 
+  /**
+   * Filter to episodic layers whose episodic key starts with this prefix (e.g.
+   * "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+   * keys, similar to a redis key scan.
+   */
+  episodicKeyPrefix?: string;
+
   /**
    * When set to true you may use more of your alloted API rate-limit
    */

package/src/resources/objectives/index.ts

@@ -64,6 +64,13 @@ export {
   type ObjectiveToolCall,
   type ObjectiveToolCallData,
   type ObjectiveToolCallInfo,
+  type ObjectiveToolCallResult,
+  type ObjectiveToolCallResultAudioBlock,
+  type ObjectiveToolCallResultContentBlock,
+  type ObjectiveToolCallResultImageBlock,
+  type ObjectiveToolCallResultTextBlock,
+  type ObjectiveToolCallWithResult,
+  type ToolCallRetrieveParams,
   type ToolCallListParams,
   type ToolCallApproveParams,
   type ToolCallDenyParams,

package/src/resources/objectives/objectives.ts

@@ -31,10 +31,17 @@ import {
   ObjectiveToolCall,
   ObjectiveToolCallData,
   ObjectiveToolCallInfo,
+  ObjectiveToolCallResult,
+  ObjectiveToolCallResultAudioBlock,
+  ObjectiveToolCallResultContentBlock,
+  ObjectiveToolCallResultImageBlock,
+  ObjectiveToolCallResultTextBlock,
+  ObjectiveToolCallWithResult,
   ObjectiveToolCallsCursorPagination,
   ToolCallApproveParams,
   ToolCallDenyParams,
   ToolCallListParams,
+  ToolCallRetrieveParams,
   ToolCalls,
 } from './tool-calls';
 import * as ToolsAPI from './tools';
@@ -323,6 +330,11 @@ export interface Objective {
    */
   data?: { [key: string]: unknown };
 
+  /**
+   * Episodic is used to configure the episodic memory for the objective
+   */
+  episodicMemory?: Objective.EpisodicMemory;
+
   /**
    * ObjectiveInfo provides read-only aggregated statistics about an objective's
    * execution
@@ -378,6 +390,25 @@ export interface Objective {
   userData?: { [key: string]: unknown };
 }
 
+export namespace Objective {
+  /**
+   * Episodic is used to configure the episodic memory for the objective
+   */
+  export interface EpisodicMemory {
+    /**
+     * The caller-supplied episodic key. Objectives created with the same key (for the
+     * same agent) share one episodic memory layer.
+     */
+    key?: string;
+
+    /**
+     * The episodic memory layer resolved (created or reused) for this objective's key.
+     * Populated by the system at objective creation.
+     */
+    memoryLayerId?: string;
+  }
+}
+
 /**
  * ObjectiveConfigSnapshot is the point-in-time snapshot of the agent, variation,
  * and (when applicable) schedule that an objective was started with.
@@ -793,9 +824,15 @@ export interface ToolError {
 }
 
 export interface ToolResult {
-  content?: string;
+  /**
+   * ObjectiveToolCallResult is the content a tool returned after execution. Tools
+   * can return multiple content blocks, and blocks can be multi-modal (text, image,
+   * audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+   * rather than inline bytes.
+   */
+  result: ToolCallsAPI.ObjectiveToolCallResult;
 
-  toolCallId?: string;
+  toolCallId: string;
 }
 
 export interface UserMessage {
@@ -849,6 +886,11 @@ export interface ObjectiveCreateParams {
    */
   data: { [key: string]: unknown };
 
+  /**
+   * Episodic is used to configure the episodic memory for the objective
+   */
+  episodicMemory?: ObjectiveCreateParams.EpisodicMemory;
+
   /**
    * Optional override for the initial message sent to the agent. This becomes the
    * first user message in the LLM chat history. When not set, the selected
@@ -905,6 +947,17 @@ export interface ObjectiveCreateParams {
 }
 
 export namespace ObjectiveCreateParams {
+  /**
+   * Episodic is used to configure the episodic memory for the objective
+   */
+  export interface EpisodicMemory {
+    /**
+     * The caller-supplied episodic key. Objectives created with the same key (for the
+     * same agent) share one episodic memory layer.
+     */
+    key?: string;
+  }
+
   export interface Secret {
     name?: string;
 
@@ -1116,7 +1169,14 @@ export declare namespace Objectives {
     type ObjectiveToolCall as ObjectiveToolCall,
     type ObjectiveToolCallData as ObjectiveToolCallData,
     type ObjectiveToolCallInfo as ObjectiveToolCallInfo,
+    type ObjectiveToolCallResult as ObjectiveToolCallResult,
+    type ObjectiveToolCallResultAudioBlock as ObjectiveToolCallResultAudioBlock,
+    type ObjectiveToolCallResultContentBlock as ObjectiveToolCallResultContentBlock,
+    type ObjectiveToolCallResultImageBlock as ObjectiveToolCallResultImageBlock,
+    type ObjectiveToolCallResultTextBlock as ObjectiveToolCallResultTextBlock,
+    type ObjectiveToolCallWithResult as ObjectiveToolCallWithResult,
     type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination,
+    type ToolCallRetrieveParams as ToolCallRetrieveParams,
     type ToolCallListParams as ToolCallListParams,
     type ToolCallApproveParams as ToolCallApproveParams,
     type ToolCallDenyParams as ToolCallDenyParams,

package/src/resources/objectives/tool-calls.ts

@@ -10,6 +10,22 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class ToolCalls extends APIResource {
+  /**
+   * Retrieves a single tool call, including the content the tool returned. Media
+   * content (images, audio) is served as short-lived signed URLs.
+   */
+  retrieve(
+    toolCallID: string,
+    params: ToolCallRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ObjectiveToolCallWithResult> {
+    const { workspaceId, objectiveId } = params;
+    return this._client.get(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}`,
+      options,
+    );
+  }
+
   /**
    * Lists all tool calls for an objective
    */
@@ -115,11 +131,6 @@ export interface ObjectiveToolCallData {
    */
   memo?: string;
 
-  /**
-   * The result content returned by the tool after execution
-   */
-  result?: string;
-
   /**
    * A profile identifies a user or non-human principal (such as an API key) at the
    * account level. Profiles are account-scoped and can be granted access to multiple
@@ -143,6 +154,126 @@ export interface ObjectiveToolCallInfo {
   objective?: Shared.OperationMetadata;
 }
 
+/**
+ * ObjectiveToolCallResult is the content a tool returned after execution. Tools
+ * can return multiple content blocks, and blocks can be multi-modal (text, image,
+ * audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+ * rather than inline bytes.
+ */
+export interface ObjectiveToolCallResult {
+  content: Array<ObjectiveToolCallResultContentBlock>;
+}
+
+export interface ObjectiveToolCallResultAudioBlock {
+  /**
+   * When the signed URL expires.
+   */
+  expiresAt: string;
+
+  /**
+   * IANA media type of the stored audio, e.g. audio/wav.
+   */
+  mimeType: string;
+
+  /**
+   * Size of the stored audio in bytes.
+   */
+  sizeBytes: string;
+
+  /**
+   * Short-lived signed URL to download the stored audio.
+   */
+  url: string;
+}
+
+/**
+ * ContentBlock is a single block of tool result content. Exactly one of the
+ * variants is set.
+ */
+export interface ObjectiveToolCallResultContentBlock {
+  audio?: ObjectiveToolCallResultAudioBlock;
+
+  image?: ObjectiveToolCallResultImageBlock;
+
+  text?: ObjectiveToolCallResultTextBlock;
+}
+
+export interface ObjectiveToolCallResultImageBlock {
+  /**
+   * When the signed URL expires.
+   */
+  expiresAt: string;
+
+  /**
+   * IANA media type of the stored image, e.g. image/png.
+   */
+  mimeType: string;
+
+  /**
+   * Size of the stored image in bytes.
+   */
+  sizeBytes: string;
+
+  /**
+   * Short-lived signed URL to download the stored image.
+   */
+  url: string;
+}
+
+export interface ObjectiveToolCallResultTextBlock {
+  text: string;
+}
+
+/**
+ * ObjectiveToolCallWithResult is an ObjectiveToolCall plus the content the tool
+ * returned. Returned by GetObjectiveToolCall.
+ */
+export interface ObjectiveToolCallWithResult {
+  data: ObjectiveToolCallData;
+
+  executionStatus:
+    | 'TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED'
+    | 'TOOL_CALL_EXECUTION_STATUS_PENDING'
+    | 'TOOL_CALL_EXECUTION_STATUS_RUNNING'
+    | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED'
+    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED';
+
+  info: ObjectiveToolCallInfo;
+
+  /**
+   * Metadata for ephemeral operations and activities (e.g., objectives, executions,
+   * runs)
+   */
+  metadata: Shared.OperationMetadata;
+
+  /**
+   * Current status of the tool call
+   */
+  status:
+    | 'TOOL_CALL_STATUS_UNSPECIFIED'
+    | 'TOOL_CALL_STATUS_AUTO_APPROVED'
+    | 'TOOL_CALL_STATUS_WAITING_FOR_APPROVAL'
+    | 'TOOL_CALL_STATUS_APPROVED'
+    | 'TOOL_CALL_STATUS_DENIED';
+
+  /**
+   * ObjectiveToolCallResult is the content a tool returned after execution. Tools
+   * can return multiple content blocks, and blocks can be multi-modal (text, image,
+   * audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+   * rather than inline bytes.
+   */
+  result?: ObjectiveToolCallResult;
+}
+
+export interface ToolCallRetrieveParams {
+  workspaceId: string;
+
+  /**
+   * The ID of the objective. Supports "external_id:" prefix for external IDs.
+   */
+  objectiveId: string;
+}
+
 export interface ToolCallListParams extends CursorPaginationParams {
   /**
    * Path param
@@ -198,7 +329,14 @@ export declare namespace ToolCalls {
     type ObjectiveToolCall as ObjectiveToolCall,
     type ObjectiveToolCallData as ObjectiveToolCallData,
     type ObjectiveToolCallInfo as ObjectiveToolCallInfo,
+    type ObjectiveToolCallResult as ObjectiveToolCallResult,
+    type ObjectiveToolCallResultAudioBlock as ObjectiveToolCallResultAudioBlock,
+    type ObjectiveToolCallResultContentBlock as ObjectiveToolCallResultContentBlock,
+    type ObjectiveToolCallResultImageBlock as ObjectiveToolCallResultImageBlock,
+    type ObjectiveToolCallResultTextBlock as ObjectiveToolCallResultTextBlock,
+    type ObjectiveToolCallWithResult as ObjectiveToolCallWithResult,
     type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination,
+    type ToolCallRetrieveParams as ToolCallRetrieveParams,
     type ToolCallListParams as ToolCallListParams,
     type ToolCallApproveParams as ToolCallApproveParams,
     type ToolCallDenyParams as ToolCallDenyParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.86.0'; // x-release-please-version
+export const VERSION = '0.88.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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