@cadenya/cadenya 0.103.0 → 0.105.0

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

@@ -74,6 +74,23 @@ export class ToolCalls extends APIResource {
       { body, ...options },
     );
   }
+
+  /**
+   * For bare tool calls (tool sets with no execution adapter), sets the content an
+   * external API consumer supplies for the call — used for human-in-the-loop tools
+   * and reverse harnesses that execute tools locally and report results back.
+   */
+  setContent(
+    toolCallID: string,
+    params: ToolCallSetContentParams,
+    options?: RequestOptions,
+  ): APIPromise<ObjectiveToolCall> {
+    const { workspaceId, objectiveId, ...body } = params;
+    return this._client.post(
+      path`/v1/workspaces/${workspaceId}/objectives/${objectiveId}/tool_calls/${toolCallID}:setContent`,
+      { body, ...options },
+    );
+  }
 }
 
 export type ObjectiveToolCallsCursorPagination = CursorPagination<ObjectiveToolCall>;
@@ -91,7 +108,8 @@ export interface ObjectiveToolCall {
     | 'TOOL_CALL_EXECUTION_STATUS_PENDING'
     | 'TOOL_CALL_EXECUTION_STATUS_RUNNING'
     | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED'
-    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED';
+    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED'
+    | 'TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT';
 
   /**
    * Metadata for ephemeral operations and activities (e.g., objectives, executions,
@@ -261,7 +279,8 @@ export interface ObjectiveToolCallWithResult {
     | 'TOOL_CALL_EXECUTION_STATUS_PENDING'
     | 'TOOL_CALL_EXECUTION_STATUS_RUNNING'
     | 'TOOL_CALL_EXECUTION_STATUS_COMPLETED'
-    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED';
+    | 'TOOL_CALL_EXECUTION_STATUS_ERRORED'
+    | 'TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT';
 
   info: ObjectiveToolCallInfo;
 
@@ -313,6 +332,46 @@ export interface ResolvedSecret {
     | 'RESOLVED_SECRET_SOURCE_OBJECTIVE';
 }
 
+export interface SetToolCallContentRequestAudioBlock {
+  /**
+   * Base64-encoded audio bytes.
+   */
+  data: string;
+
+  /**
+   * IANA media type of the audio, e.g. audio/wav.
+   */
+  mimeType: string;
+}
+
+/**
+ * ContentBlock is a single block of tool call content supplied on input. Exactly
+ * one of the variants is set.
+ */
+export interface SetToolCallContentRequestContentBlock {
+  audio?: SetToolCallContentRequestAudioBlock;
+
+  image?: SetToolCallContentRequestImageBlock;
+
+  text?: SetToolCallContentRequestTextBlock;
+}
+
+export interface SetToolCallContentRequestImageBlock {
+  /**
+   * Base64-encoded image bytes.
+   */
+  data: string;
+
+  /**
+   * IANA media type of the image, e.g. image/png.
+   */
+  mimeType: string;
+}
+
+export interface SetToolCallContentRequestTextBlock {
+  text: string;
+}
+
 export interface ToolCallRetrieveParams {
   workspaceId: string;
 
@@ -328,6 +387,19 @@ export interface ToolCallListParams extends CursorPaginationParams {
    */
   workspaceId: string;
 
+  /**
+   * Query param: Filter by tool call execution status. Useful for reverse-harness
+   * polling of bare tool calls waiting for externally supplied content
+   * (TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT).
+   */
+  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'
+    | 'TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT';
+
   /**
    * Query param: When set to true you may use more of your alloted API rate-limit
    */
@@ -372,6 +444,26 @@ export interface ToolCallDenyParams {
   memo?: string;
 }
 
+export interface ToolCallSetContentParams {
+  /**
+   * Path param
+   */
+  workspaceId: string;
+
+  /**
+   * Path param: The ID of the objective. Supports "external_id:" prefix for external
+   * IDs.
+   */
+  objectiveId: string;
+
+  /**
+   * Body param: The content to set on the tool call. Mirrors
+   * ObjectiveToolCallResult.ContentBlock but writable: media blocks carry raw data
+   * on input where the result-side carries a signed url on output.
+   */
+  content: Array<SetToolCallContentRequestContentBlock>;
+}
+
 export declare namespace ToolCalls {
   export {
     type ObjectiveToolCall as ObjectiveToolCall,
@@ -384,10 +476,15 @@ export declare namespace ToolCalls {
     type ObjectiveToolCallResultTextBlock as ObjectiveToolCallResultTextBlock,
     type ObjectiveToolCallWithResult as ObjectiveToolCallWithResult,
     type ResolvedSecret as ResolvedSecret,
+    type SetToolCallContentRequestAudioBlock as SetToolCallContentRequestAudioBlock,
+    type SetToolCallContentRequestContentBlock as SetToolCallContentRequestContentBlock,
+    type SetToolCallContentRequestImageBlock as SetToolCallContentRequestImageBlock,
+    type SetToolCallContentRequestTextBlock as SetToolCallContentRequestTextBlock,
     type ObjectiveToolCallsCursorPagination as ObjectiveToolCallsCursorPagination,
     type ToolCallRetrieveParams as ToolCallRetrieveParams,
     type ToolCallListParams as ToolCallListParams,
     type ToolCallApproveParams as ToolCallApproveParams,
     type ToolCallDenyParams as ToolCallDenyParams,
+    type ToolCallSetContentParams as ToolCallSetContentParams,
   };
 }

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

@@ -23,6 +23,7 @@ export {
   type ToolFilter,
   type ToolSet,
   type ToolSetAdapter,
+  type ToolSetAdapterBare,
   type ToolSetAdapterHTTP,
   type ToolSetAdapterMcp,
   type ToolSetAdapterOpenAPI,
@@ -45,6 +46,7 @@ export {
 } from './tool-sets';
 export {
   Tools,
+  type ConfigBare,
   type ConfigHTTP,
   type ConfigMcp,
   type ConfigOpenAPI,

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

@@ -18,6 +18,7 @@ import {
 } from './secrets';
 import * as ToolsAPI from './tools';
 import {
+  ConfigBare,
   ConfigHTTP,
   ConfigMcp,
   ConfigOpenAPI,
@@ -281,6 +282,15 @@ export interface ToolSet {
 }
 
 export interface ToolSetAdapter {
+  /**
+   * Bare tool sets define tools without an execution adapter. A bare tool call
+   * doesn't fire anything: the objective's workflow pauses and waits for an external
+   * API consumer to set the tool call's content (e.g. human-in-the-loop tools, or a
+   * reverse harness that polls for pending tool calls, executes locally, and reports
+   * results back via SetToolCallContent).
+   */
+  bare?: ToolSetAdapterBare;
+
   http?: ToolSetAdapterHTTP;
 
   mcp?: ToolSetAdapterMcp;
@@ -288,6 +298,21 @@ export interface ToolSetAdapter {
   openapi?: ToolSetAdapterOpenAPI;
 }
 
+/**
+ * Bare tool sets define tools without an execution adapter. A bare tool call
+ * doesn't fire anything: the objective's workflow pauses and waits for an external
+ * API consumer to set the tool call's content (e.g. human-in-the-loop tools, or a
+ * reverse harness that polls for pending tool calls, executes locally, and reports
+ * results back via SetToolCallContent).
+ */
+export interface ToolSetAdapterBare {
+  /**
+   * How long to wait for content to be set before the tool call errors. If unset,
+   * the call waits indefinitely.
+   */
+  contentTimeout?: number;
+}
+
 export interface ToolSetAdapterHTTP {
   baseUrl?: string;
 
@@ -610,6 +635,7 @@ export declare namespace ToolSets {
     type ToolFilter as ToolFilter,
     type ToolSet as ToolSet,
     type ToolSetAdapter as ToolSetAdapter,
+    type ToolSetAdapterBare as ToolSetAdapterBare,
     type ToolSetAdapterHTTP as ToolSetAdapterHTTP,
     type ToolSetAdapterMcp as ToolSetAdapterMcp,
     type ToolSetAdapterOpenAPI as ToolSetAdapterOpenAPI,
@@ -633,6 +659,7 @@ export declare namespace ToolSets {
 
   export {
     Tools as Tools,
+    type ConfigBare as ConfigBare,
     type ConfigHTTP as ConfigHTTP,
     type ConfigMcp as ConfigMcp,
     type ConfigOpenAPI as ConfigOpenAPI,

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

@@ -101,6 +101,13 @@ export class Tools extends APIResource {
 
 export type ToolsCursorPagination = CursorPagination<Tool>;
 
+/**
+ * Marks the tool as bare: it has no execution adapter of its own and relies on the
+ * parent tool set being a Bare tool set. Present so a webhook consumer can tell a
+ * tool is bare from the tool data alone, without cross-referencing the tool set.
+ */
+export interface ConfigBare {}
+
 export interface ConfigHTTP {
   requestMethod: 'HTTP_METHOD_UNSPECIFIED' | 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
@@ -240,6 +247,13 @@ export interface ToolSpec {
  * be Http. If the tool is an inline tool, the adapter will be Inline.
  */
 export interface ToolSpecConfig {
+  /**
+   * Marks the tool as bare: it has no execution adapter of its own and relies on the
+   * parent tool set being a Bare tool set. Present so a webhook consumer can tell a
+   * tool is bare from the tool data alone, without cross-referencing the tool set.
+   */
+  bare?: ConfigBare;
+
   http?: ConfigHTTP;
 
   mcp?: ConfigMcp;
@@ -392,6 +406,7 @@ export interface ToolRestoreParams {
 
 export declare namespace Tools {
   export {
+    type ConfigBare as ConfigBare,
     type ConfigHTTP as ConfigHTTP,
     type ConfigMcp as ConfigMcp,
     type ConfigOpenAPI as ConfigOpenAPI,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.103.0'; // x-release-please-version
+export const VERSION = '0.105.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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