@cadraos/sdk 0.1.4 → 0.1.6

package/dist/chat/index.d.cts

@@ -807,8 +807,8 @@ interface ExecutionStreamController extends StreamController {
  * Input for starting an agent execution
  */
 interface StartExecutionInput {
-    /** UUID of the agent to execute */
-    agentId: string;
+    /** UUID of the agent to execute. Optional when teamId is provided. */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /** Optional session ID for continuing a conversation */
@@ -1112,8 +1112,11 @@ interface ChatAdapter {
 }
 
 interface AgentChatProps {
-    /** The UUID of the agent to chat with */
-    agentId: string;
+    /**
+     * The UUID of the agent to chat with.
+     * Optional when teamId is provided (team execution routes to team's lead orchestrator).
+     */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /**
@@ -1521,6 +1524,34 @@ interface ToolConfigUpdateInput {
     /** Enable/disable tool */
     isEnabled?: boolean;
 }
+/**
+ * Request to execute a tool directly, bypassing the agent runtime.
+ * The tool execution is enqueued for async processing via BullMQ.
+ */
+interface ExecuteToolDirectRequest {
+    /** Tool UUID */
+    toolUuid: string;
+    /** Which endpoint on the tool to call (defaults to first) */
+    endpointId?: string;
+    /** Tool parameters (prompt, referenceImageArtifactUuid, aspectRatio, etc.) */
+    parameters: Record<string, unknown>;
+    /** Optional execution ID (auto-generated if not provided) */
+    executionId?: string;
+    /** Optional callback URL for completion notification */
+    callbackUrl?: string;
+}
+/**
+ * Response from a direct tool execution request.
+ * The tool is enqueued for async processing - use SSE or polling to get results.
+ */
+interface ExecuteToolDirectResponse {
+    /** Execution ID for tracking */
+    executionId: string;
+    /** BullMQ job ID */
+    jobId: string;
+    /** Execution status (always 'queued' on success) */
+    status: 'queued';
+}
 
 /**
  * Artifact types
@@ -2147,6 +2178,26 @@ declare class ToolsAPI extends BaseResourceAPI {
      * ```
      */
     execute(uuid: string, input: Record<string, unknown>): Promise<ToolExecution>;
+    /**
+     * Execute a tool directly, bypassing the agent runtime.
+     *
+     * Enqueues the tool for async processing via BullMQ (no LLM, no ReAct loop).
+     * Use SSE or polling with the returned executionId to get the result.
+     *
+     * @param request - Direct execution request
+     * @returns Queued execution response with executionId for tracking
+     *
+     * @example
+     * ```typescript
+     * const result = await client.tools.executeDirect({
+     *   toolUuid: 'tool-uuid',
+     *   parameters: { prompt: 'Generate an image of a sunset' },
+     * });
+     * console.log(result.executionId); // Use for polling/SSE
+     * console.log(result.status);      // 'queued'
+     * ```
+     */
+    executeDirect(request: ExecuteToolDirectRequest): Promise<ExecuteToolDirectResponse>;
     /**
      * Validate input against tool schema
      *
@@ -2769,8 +2820,11 @@ declare function useChatConfig(): ChatConfigContextValue;
 declare function useChatConfigOptional(): ChatConfigContextValue | null;
 
 interface UseAgentChatOptions {
-    /** UUID of the agent to chat with */
-    agentId: string;
+    /**
+     * UUID of the agent to chat with.
+     * Optional when teamId is provided (team execution routes to team's lead orchestrator).
+     */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /**

package/dist/chat/index.d.ts

@@ -807,8 +807,8 @@ interface ExecutionStreamController extends StreamController {
  * Input for starting an agent execution
  */
 interface StartExecutionInput {
-    /** UUID of the agent to execute */
-    agentId: string;
+    /** UUID of the agent to execute. Optional when teamId is provided. */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /** Optional session ID for continuing a conversation */
@@ -1112,8 +1112,11 @@ interface ChatAdapter {
 }
 
 interface AgentChatProps {
-    /** The UUID of the agent to chat with */
-    agentId: string;
+    /**
+     * The UUID of the agent to chat with.
+     * Optional when teamId is provided (team execution routes to team's lead orchestrator).
+     */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /**
@@ -1521,6 +1524,34 @@ interface ToolConfigUpdateInput {
     /** Enable/disable tool */
     isEnabled?: boolean;
 }
+/**
+ * Request to execute a tool directly, bypassing the agent runtime.
+ * The tool execution is enqueued for async processing via BullMQ.
+ */
+interface ExecuteToolDirectRequest {
+    /** Tool UUID */
+    toolUuid: string;
+    /** Which endpoint on the tool to call (defaults to first) */
+    endpointId?: string;
+    /** Tool parameters (prompt, referenceImageArtifactUuid, aspectRatio, etc.) */
+    parameters: Record<string, unknown>;
+    /** Optional execution ID (auto-generated if not provided) */
+    executionId?: string;
+    /** Optional callback URL for completion notification */
+    callbackUrl?: string;
+}
+/**
+ * Response from a direct tool execution request.
+ * The tool is enqueued for async processing - use SSE or polling to get results.
+ */
+interface ExecuteToolDirectResponse {
+    /** Execution ID for tracking */
+    executionId: string;
+    /** BullMQ job ID */
+    jobId: string;
+    /** Execution status (always 'queued' on success) */
+    status: 'queued';
+}
 
 /**
  * Artifact types
@@ -2147,6 +2178,26 @@ declare class ToolsAPI extends BaseResourceAPI {
      * ```
      */
     execute(uuid: string, input: Record<string, unknown>): Promise<ToolExecution>;
+    /**
+     * Execute a tool directly, bypassing the agent runtime.
+     *
+     * Enqueues the tool for async processing via BullMQ (no LLM, no ReAct loop).
+     * Use SSE or polling with the returned executionId to get the result.
+     *
+     * @param request - Direct execution request
+     * @returns Queued execution response with executionId for tracking
+     *
+     * @example
+     * ```typescript
+     * const result = await client.tools.executeDirect({
+     *   toolUuid: 'tool-uuid',
+     *   parameters: { prompt: 'Generate an image of a sunset' },
+     * });
+     * console.log(result.executionId); // Use for polling/SSE
+     * console.log(result.status);      // 'queued'
+     * ```
+     */
+    executeDirect(request: ExecuteToolDirectRequest): Promise<ExecuteToolDirectResponse>;
     /**
      * Validate input against tool schema
      *
@@ -2769,8 +2820,11 @@ declare function useChatConfig(): ChatConfigContextValue;
 declare function useChatConfigOptional(): ChatConfigContextValue | null;
 
 interface UseAgentChatOptions {
-    /** UUID of the agent to chat with */
-    agentId: string;
+    /**
+     * UUID of the agent to chat with.
+     * Optional when teamId is provided (team execution routes to team's lead orchestrator).
+     */
+    agentId?: string;
     /** Optional team UUID for team-based execution (routes to team's lead orchestrator) */
     teamId?: string;
     /**

package/dist/chat/index.js

@@ -1523,6 +1523,29 @@ var ToolsAPI = class extends BaseResourceAPI {
     const idempotencyKey = generateIdempotencyKey();
     return this.httpPost(`/${uuid}/execute`, { input }, { idempotencyKey });
   }
+  /**
+   * Execute a tool directly, bypassing the agent runtime.
+   *
+   * Enqueues the tool for async processing via BullMQ (no LLM, no ReAct loop).
+   * Use SSE or polling with the returned executionId to get the result.
+   *
+   * @param request - Direct execution request
+   * @returns Queued execution response with executionId for tracking
+   *
+   * @example
+   * ```typescript
+   * const result = await client.tools.executeDirect({
+   *   toolUuid: 'tool-uuid',
+   *   parameters: { prompt: 'Generate an image of a sunset' },
+   * });
+   * console.log(result.executionId); // Use for polling/SSE
+   * console.log(result.status);      // 'queued'
+   * ```
+   */
+  async executeDirect(request) {
+    const idempotencyKey = generateIdempotencyKey();
+    return this.httpPost("/execute-direct", request, { idempotencyKey });
+  }
   /**
    * Validate input against tool schema
    *