@cadenya/cadenya 0.85.0 → 0.87.0

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

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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