@cadraos/sdk 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -178,7 +178,11 @@ interface ExecuteInput {
     context?: Record<string, unknown>;
     /** Attachment UUIDs to include with the message (for images, documents, etc.) */
     attachmentIds?: string[];
-    /** Team UUID for team-based execution (routes to team's lead orchestrator) */
+    /**
+     * Team UUID for team-based execution (routes to team's lead orchestrator).
+     * @deprecated Pass the team UUID directly as the agent/entity ID instead.
+     * The platform now auto-detects whether a UUID is an agent, team, or tool.
+     */
     teamUuid?: string;
     /** Execution options */
     options?: ExecuteOptions;
@@ -558,6 +562,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
@@ -1487,6 +1519,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
      *
@@ -2093,4 +2145,4 @@ declare class NetworkError extends AISaaSError {
     constructor(message?: string, details?: Record<string, unknown>);
 }
 
-export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };
+export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };

package/dist/index.d.ts

@@ -178,7 +178,11 @@ interface ExecuteInput {
     context?: Record<string, unknown>;
     /** Attachment UUIDs to include with the message (for images, documents, etc.) */
     attachmentIds?: string[];
-    /** Team UUID for team-based execution (routes to team's lead orchestrator) */
+    /**
+     * Team UUID for team-based execution (routes to team's lead orchestrator).
+     * @deprecated Pass the team UUID directly as the agent/entity ID instead.
+     * The platform now auto-detects whether a UUID is an agent, team, or tool.
+     */
     teamUuid?: string;
     /** Execution options */
     options?: ExecuteOptions;
@@ -558,6 +562,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
@@ -1487,6 +1519,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
      *
@@ -2093,4 +2145,4 @@ declare class NetworkError extends AISaaSError {
     constructor(message?: string, details?: Record<string, unknown>);
 }
 
-export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };
+export { AISaaSClient, type AISaaSClientOptions, AISaaSError, type Agent, type AgentConfig, type AgentConfigUpdateInput, type AgentExecution, type AgentListOptions, type AgentStatus, type AgentType, type AgentUpdateInput, type Artifact, type ArtifactDownloadOptions, type ArtifactListOptions, type ArtifactType, type ArtifactUploadInput, AuthenticationError, AuthorizationError, type CompleteEvent, ConflictError, type ConnectionChangeEvent, type DelegationCompletedEvent, type DelegationStartedEvent, type ErrorEvent, type ExecuteInput, type ExecuteOptions, type ExecuteResponse, type ExecuteToolDirectRequest, type ExecuteToolDirectResponse, type ExecutionLog, type ExecutionStatus, type ExecutionStreamController, type ExecutionStreamControllerOptions, type JSONSchema, type ListOptions, NetworkError, NotFoundError, type PaginatedResponse, type PaginationInfo, type PausedEvent, type PlanEvent, type ProgressEvent, RateLimitError, type SendMessageInput, ServerError, type Session, type SessionArtifact, type SessionArtifactListOptions, type SessionArtifactType, type SessionArtifactVariantType, type SessionCreateInput, type SessionHistory, type SessionListOptions, type SessionMessage, type SignedUrlResponse, type Skill, type SkillDetails, type SkillExecuteInput, type SkillExecution, type SkillListOptions, type SkillTool, type SkillUpdateInput, type SkillVariable, type StartedEvent, type StreamController, type StreamEventMap, type TextDeltaEvent, TimeoutError, type TokenUsage, type Tool, type ToolCallEvent, type ToolConfigUpdateInput, type ToolExecution, type ToolListOptions, type ToolResultEvent, type ToolUpdateInput, type ToolValidationResult, ValidationError };

package/dist/index.js

@@ -1518,6 +1518,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
    *