@epilot/sdk 2.4.4-alpha.0 → 2.4.4

package/dist/ai-agents.d-OkXfr2bz.d.ts

@@ -0,0 +1,1339 @@
+import { OpenAPIClient, Parameters, AxiosRequestConfig, OperationResponse, UnknownParamsObject } from 'openapi-client-axios';
+
+/* Auto-copied from ai-agents-client */
+/* eslint-disable */
+
+
+
+declare namespace Components {
+    namespace Schemas {
+        export interface AgentDefinition {
+            agent_id?: /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            AgentId;
+            org_id?: string;
+            name?: string;
+            description?: string;
+            category?: SkillCategory;
+            icon?: string;
+            source?: /**
+             * - system: Pre-built by epilot (system skills)
+             * - custom: Created by organization
+             *
+             */
+            AgentSource;
+            /**
+             * Where this agent/skill is available (flows, copilot, or both)
+             * example:
+             * [
+             *   "flows",
+             *   "copilot"
+             * ]
+             */
+            availability?: /**
+             * Where the skill/agent is available:
+             * - flows: Available in workflow automations
+             * - copilot: Available as a sub-agent in copilot
+             * - all: Available everywhere
+             *
+             */
+            SkillAvailability[];
+            /**
+             * Entity schemas this skill is allowed to work with (e.g., ["message"] for email skills)
+             * example:
+             * [
+             *   "message"
+             * ]
+             */
+            allowed_entity_schemas?: string[];
+            system_prompt?: string;
+            tools?: string[];
+            model_config?: ModelConfig;
+            max_iterations?: number;
+            execution_pattern?: /**
+             * - direct: Single LLM call, no tools
+             * - react: Multi-step reasoning with tool use
+             *
+             */
+            ExecutionPattern;
+            execution_mode?: /**
+             * - automatic: Execute without human intervention
+             * - approval: Pause for human approval before tool execution
+             * - draft: Execute but mark output as draft for review
+             *
+             */
+            ExecutionMode;
+            output_schema?: {
+                [key: string]: any;
+            };
+            input_parameters_schema?: /**
+             * example:
+             * {
+             *   "type": "object",
+             *   "parameters": [
+             *     {
+             *       "name": "target_schema",
+             *       "label": "Target Schema",
+             *       "type": "entity-schema",
+             *       "description": "Entity type to create"
+             *     },
+             *     {
+             *       "name": "confidence_threshold",
+             *       "label": "Confidence Threshold",
+             *       "type": "number",
+             *       "minimum": 0,
+             *       "maximum": 1,
+             *       "default": 0.8
+             *     },
+             *     {
+             *       "name": "categories",
+             *       "label": "Categories",
+             *       "type": "select",
+             *       "enum": [
+             *         "invoice",
+             *         "contract",
+             *         "letter"
+             *       ],
+             *       "multi": true
+             *     }
+             *   ],
+             *   "required": [
+             *     "target_schema"
+             *   ]
+             * }
+             */
+            InputParametersSchema;
+            version?: number;
+            created_at?: string; // date-time
+            updated_at?: string; // date-time
+            created_by?: string;
+        }
+        /**
+         * Agent identifier. Can be either:
+         * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+         * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+         *
+         * example:
+         * skill:email-categorizer
+         */
+        export type AgentId = string;
+        /**
+         * - system: Pre-built by epilot (system skills)
+         * - custom: Created by organization
+         *
+         */
+        export type AgentSource = "system" | "custom";
+        export interface ApproveExecutionRequest {
+            /**
+             * Optional reason for approval
+             */
+            reason?: string;
+        }
+        export interface CreateAgentRequest {
+            /**
+             * example:
+             * Email Reply Generator
+             */
+            name: string;
+            description?: string;
+            category?: SkillCategory;
+            /**
+             * example:
+             * mail-reply
+             */
+            icon?: string;
+            /**
+             * Core LLM instructions
+             */
+            system_prompt: string;
+            /**
+             * Tool IDs this agent can use
+             * example:
+             * [
+             *   "entity.search",
+             *   "message.draft"
+             * ]
+             */
+            tools?: string[];
+            model_config?: ModelConfig;
+            /**
+             * Max ReAct loop iterations
+             */
+            max_iterations?: number;
+            execution_pattern: /**
+             * - direct: Single LLM call, no tools
+             * - react: Multi-step reasoning with tool use
+             *
+             */
+            ExecutionPattern;
+            execution_mode?: /**
+             * - automatic: Execute without human intervention
+             * - approval: Pause for human approval before tool execution
+             * - draft: Execute but mark output as draft for review
+             *
+             */
+            ExecutionMode;
+            /**
+             * JSON Schema for expected output
+             */
+            output_schema?: {
+                [key: string]: any;
+            };
+            input_parameters_schema?: /**
+             * example:
+             * {
+             *   "type": "object",
+             *   "parameters": [
+             *     {
+             *       "name": "target_schema",
+             *       "label": "Target Schema",
+             *       "type": "entity-schema",
+             *       "description": "Entity type to create"
+             *     },
+             *     {
+             *       "name": "confidence_threshold",
+             *       "label": "Confidence Threshold",
+             *       "type": "number",
+             *       "minimum": 0,
+             *       "maximum": 1,
+             *       "default": 0.8
+             *     },
+             *     {
+             *       "name": "categories",
+             *       "label": "Categories",
+             *       "type": "select",
+             *       "enum": [
+             *         "invoice",
+             *         "contract",
+             *         "letter"
+             *       ],
+             *       "multi": true
+             *     }
+             *   ],
+             *   "required": [
+             *     "target_schema"
+             *   ]
+             * }
+             */
+            InputParametersSchema;
+        }
+        export interface Error {
+            error?: string;
+            message?: string;
+            details?: {
+                [key: string]: any;
+            };
+        }
+        export interface ExecuteAgentRequest {
+            input?: {
+                /**
+                 * Primary entity ID for context
+                 */
+                entity_id?: string;
+                /**
+                 * Schema of the primary entity (e.g., "message", "contact")
+                 */
+                entity_schema?: string;
+                workflow_id?: string;
+                workflow_execution_id?: string;
+                task_id?: string;
+                custom_data?: {
+                    [name: string]: any;
+                };
+                /**
+                 * Array of entities from the flow trigger context (e.g., the message entity when triggered by email receive)
+                 */
+                flow_context?: {
+                    entity_id: string;
+                    entity_schema: string;
+                }[];
+            };
+            /**
+             * Runtime parameters (validated against input_parameters_schema)
+             */
+            parameters?: {
+                [name: string]: any;
+            };
+            execution_mode_override?: /**
+             * - automatic: Execute without human intervention
+             * - approval: Pause for human approval before tool execution
+             * - draft: Execute but mark output as draft for review
+             *
+             */
+            ExecutionMode;
+            execution_context?: /**
+             * Where the execution was triggered from:
+             * - flows: Triggered from workflow automation
+             * - copilot: Triggered from copilot assistant
+             * - api: Direct API call
+             *
+             */
+            ExecutionContext;
+            /**
+             * Webhook URL for async completion notification
+             */
+            callback_url?: string; // uri
+            /**
+             * Execution timeout in milliseconds
+             */
+            timeout_ms?: number;
+        }
+        /**
+         * Where the execution was triggered from:
+         * - flows: Triggered from workflow automation
+         * - copilot: Triggered from copilot assistant
+         * - api: Direct API call
+         *
+         */
+        export type ExecutionContext = "flows" | "copilot" | "api";
+        export type ExecutionError = {
+            code?: "TIMEOUT" | "MAX_ITERATIONS_EXCEEDED" | "TOOL_EXECUTION_FAILED" | "LLM_ERROR" | "INVALID_OUTPUT" | "REJECTED" | "INTERNAL_ERROR";
+            message?: string;
+            details?: {
+                [key: string]: any;
+            };
+        } | null;
+        export interface ExecutionIteration {
+            iteration_index?: number;
+            /**
+             * LLM reasoning/thinking
+             */
+            thought?: string;
+            action?: {
+                tool?: string;
+                input?: {
+                    [key: string]: any;
+                };
+            } | null;
+            /**
+             * Tool result
+             */
+            observation?: {
+                [key: string]: any;
+            } | null;
+            timestamp?: string; // date-time
+            tokens_used?: number;
+            latency_ms?: number;
+        }
+        export interface ExecutionMetrics {
+            total_tokens?: number;
+            input_tokens?: number;
+            output_tokens?: number;
+            total_cost_usd?: number; // float
+            duration_ms?: number;
+            iteration_count?: number;
+        }
+        /**
+         * - automatic: Execute without human intervention
+         * - approval: Pause for human approval before tool execution
+         * - draft: Execute but mark output as draft for review
+         *
+         */
+        export type ExecutionMode = "automatic" | "approval" | "draft";
+        /**
+         * - direct: Single LLM call, no tools
+         * - react: Multi-step reasoning with tool use
+         *
+         */
+        export type ExecutionPattern = "direct" | "react";
+        export interface ExecutionResponse {
+            execution_id?: string; // uuid
+            agent_id?: /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            AgentId;
+            agent_source?: /**
+             * - system: Pre-built by epilot (system skills)
+             * - custom: Created by organization
+             *
+             */
+            AgentSource;
+            /**
+             * Human-readable agent name (denormalized for display)
+             */
+            agent_name?: string;
+            execution_context?: /**
+             * Where the execution was triggered from:
+             * - flows: Triggered from workflow automation
+             * - copilot: Triggered from copilot assistant
+             * - api: Direct API call
+             *
+             */
+            ExecutionContext;
+            org_id?: string;
+            status?: ExecutionStatus;
+            input?: {
+                [key: string]: any;
+            };
+            parameters?: {
+                [key: string]: any;
+            };
+            /**
+             * Execution result (when status=completed)
+             */
+            result?: {
+                /**
+                 * Text response from the agent
+                 */
+                response?: string;
+                /**
+                 * Parsed structured output (only for direct mode with output_schema)
+                 */
+                structured_output?: {
+                    [key: string]: any;
+                } | null;
+            } | null;
+            error?: ExecutionError;
+            pending_action?: /* Action waiting for approval (when status=waiting_approval) */ PendingAction;
+            metrics?: ExecutionMetrics;
+            started_at?: string; // date-time
+            completed_at?: string | null; // date-time
+        }
+        export type ExecutionStatus = "pending" | "running" | "waiting_approval" | "completed" | "failed" | "cancelled";
+        export interface ExecutionTrace {
+            execution_id?: string; // uuid
+            iterations?: ExecutionIteration[];
+            total_iterations?: number;
+        }
+        export interface InputParameterDefinition {
+            /**
+             * Unique identifier for the parameter (used in API)
+             * example:
+             * target_schema
+             */
+            name: string;
+            /**
+             * Human-readable display label
+             * example:
+             * Target Schema
+             */
+            label: string;
+            type: /**
+             * Base types:
+             * - text: Text input field
+             * - textarea: Multi-line text input field
+             * - number: Numeric input field
+             * - boolean: Toggle switch
+             * - select: Dropdown selection (requires enum array)
+             *
+             * Custom types (domain-specific):
+             * - entity-schema: Entity schema selector (fetches from Entity API)
+             * - entity-attribute: Entity attribute selector (requires dependsOn)
+             * - entity-id: Entity picker (search and select entities)
+             * - taxonomy: Taxonomy selector (fetches from Taxonomy API)
+             * - taxonomy-classification: Classification selector (requires dependsOn)
+             * - shared-inbox: Shared inbox selector (fetches from Email Settings API)
+             *
+             */
+            ParameterType;
+            /**
+             * Help text for the parameter
+             */
+            description?: string;
+            /**
+             * Default value for the parameter
+             */
+            default?: any;
+            /**
+             * Allow multiple selections (value becomes array)
+             */
+            multi?: boolean;
+            /**
+             * Parent parameter this depends on (for entity-attribute, taxonomy-classification)
+             */
+            dependsOn?: string;
+            /**
+             * Conditional visibility rules (show when parent has specific values)
+             */
+            visibleWhen?: {
+                [name: string]: any[];
+            };
+            /**
+             * Allowed values (required for 'select' type)
+             */
+            enum?: string[];
+            /**
+             * Minimum value (for number type)
+             */
+            minimum?: number;
+            /**
+             * Maximum value (for number type)
+             */
+            maximum?: number;
+            /**
+             * Step increment (for number type)
+             */
+            step?: number;
+            /**
+             * Minimum length (for text type)
+             */
+            minLength?: number;
+            /**
+             * Maximum length (for text type)
+             */
+            maxLength?: number;
+            /**
+             * Filter to specific schemas (for entity-schema, entity-id)
+             */
+            schemaFilter?: string[];
+            /**
+             * Filter to specific attribute types (for entity-attribute)
+             */
+            attributeTypeFilter?: string[];
+        }
+        /**
+         * example:
+         * {
+         *   "type": "object",
+         *   "parameters": [
+         *     {
+         *       "name": "target_schema",
+         *       "label": "Target Schema",
+         *       "type": "entity-schema",
+         *       "description": "Entity type to create"
+         *     },
+         *     {
+         *       "name": "confidence_threshold",
+         *       "label": "Confidence Threshold",
+         *       "type": "number",
+         *       "minimum": 0,
+         *       "maximum": 1,
+         *       "default": 0.8
+         *     },
+         *     {
+         *       "name": "categories",
+         *       "label": "Categories",
+         *       "type": "select",
+         *       "enum": [
+         *         "invoice",
+         *         "contract",
+         *         "letter"
+         *       ],
+         *       "multi": true
+         *     }
+         *   ],
+         *   "required": [
+         *     "target_schema"
+         *   ]
+         * }
+         */
+        export interface InputParametersSchema {
+            /**
+             * Always "object"
+             */
+            type: "object";
+            /**
+             * Array of parameter definitions
+             */
+            parameters: InputParameterDefinition[];
+            /**
+             * Array of parameter names that are required
+             */
+            required?: string[];
+        }
+        export interface ListAgentsResponse {
+            agents?: AgentDefinition[];
+            next_cursor?: string | null;
+        }
+        export interface ListExecutionsResponse {
+            executions?: ExecutionResponse[];
+            next_cursor?: string | null;
+        }
+        export interface ModelConfig {
+            /**
+             * AWS Bedrock model ID
+             */
+            model_id?: string;
+            temperature?: number;
+            max_tokens?: number;
+        }
+        /**
+         * Base types:
+         * - text: Text input field
+         * - textarea: Multi-line text input field
+         * - number: Numeric input field
+         * - boolean: Toggle switch
+         * - select: Dropdown selection (requires enum array)
+         *
+         * Custom types (domain-specific):
+         * - entity-schema: Entity schema selector (fetches from Entity API)
+         * - entity-attribute: Entity attribute selector (requires dependsOn)
+         * - entity-id: Entity picker (search and select entities)
+         * - taxonomy: Taxonomy selector (fetches from Taxonomy API)
+         * - taxonomy-classification: Classification selector (requires dependsOn)
+         * - shared-inbox: Shared inbox selector (fetches from Email Settings API)
+         *
+         */
+        export type ParameterType = "text" | "textarea" | "number" | "boolean" | "select" | "entity-schema" | "entity-attribute" | "entity-id" | "taxonomy" | "taxonomy-classification" | "shared-inbox" | "label";
+        /**
+         * Action waiting for approval (when status=waiting_approval)
+         */
+        export type PendingAction = {
+            /**
+             * Tool ID that requires approval
+             */
+            tool?: string;
+            /**
+             * Tool input parameters
+             */
+            input?: {
+                [key: string]: any;
+            };
+            /**
+             * Human-readable description of the action
+             */
+            description?: string;
+            preview?: /* Structured preview data for approval UI. Provides a generic format that any tool can populate. */ ToolPreview;
+        } | null;
+        /**
+         * Type of action being previewed
+         */
+        export type PreviewActionType = "move" | "create" | "update" | "delete" | "apply" | "send" | "link" | "unlink";
+        /**
+         * A single field change in the preview
+         */
+        export interface PreviewChange {
+            /**
+             * Field identifier
+             */
+            field?: string;
+            /**
+             * Human-readable field label
+             */
+            label?: string;
+            from?: /* Typed value for preview display */ PreviewValue;
+            to?: /* Typed value for preview display */ PreviewValue;
+        }
+        /**
+         * Entity reference for preview display
+         */
+        export interface PreviewEntity {
+            /**
+             * Entity type (e.g., "inbox", "email", "contact", "label")
+             * example:
+             * inbox
+             */
+            type?: string;
+            /**
+             * Entity ID
+             */
+            id?: string;
+            /**
+             * Human-readable name for display
+             * example:
+             * Support Inbox
+             */
+            name?: string;
+            /**
+             * Entity schema (for epilot entities)
+             */
+            schema?: string;
+            /**
+             * Icon hint for UI
+             */
+            icon?: string;
+            /**
+             * Optional URL to view the entity
+             */
+            url?: string;
+        }
+        /**
+         * Typed value for preview display
+         */
+        export interface PreviewValue {
+            /**
+             * Value type for proper rendering
+             */
+            type: "text" | "number" | "boolean" | "list" | "entity" | "badge";
+            /**
+             * The actual value (type depends on "type" field)
+             */
+            value?: any;
+            /**
+             * Array of values (for list type)
+             */
+            values?: string[];
+            /**
+             * Entity ID (for entity type)
+             */
+            id?: string;
+            /**
+             * Display name (for entity type)
+             */
+            name?: string;
+            /**
+             * Entity schema (for entity type)
+             */
+            schema?: string;
+            /**
+             * Badge color (for badge type)
+             */
+            color?: "success" | "warning" | "error" | "info";
+        }
+        export interface RejectExecutionRequest {
+            /**
+             * Reason for rejection
+             */
+            reason: string;
+        }
+        /**
+         * Where the skill/agent is available:
+         * - flows: Available in workflow automations
+         * - copilot: Available as a sub-agent in copilot
+         * - all: Available everywhere
+         *
+         */
+        export type SkillAvailability = "flows" | "copilot" | "all";
+        export type SkillCategory = "message" | "entity" | "document" | "classification" | "custom";
+        export interface ToolDefinition {
+            /**
+             * example:
+             * entity.search
+             */
+            tool_id?: string;
+            /**
+             * example:
+             * Search Entities
+             */
+            name?: string;
+            /**
+             * Description for LLM to understand tool purpose
+             */
+            description?: string;
+            category?: "entity" | "email" | "taxonomy" | "rag" | "workflow";
+            /**
+             * JSON Schema for tool input
+             */
+            parameters?: {
+                [key: string]: any;
+            };
+            /**
+             * JSON Schema for tool output
+             */
+            returns?: {
+                [key: string]: any;
+            };
+            /**
+             * Whether this tool always requires human approval
+             */
+            requires_approval?: boolean;
+            enabled?: boolean;
+        }
+        /**
+         * Structured preview data for approval UI. Provides a generic format that any tool can populate.
+         */
+        export interface ToolPreview {
+            action?: {
+                type: /* Type of action being previewed */ PreviewActionType;
+                /**
+                 * Human-readable action verb
+                 * example:
+                 * Move Thread
+                 */
+                verb: string;
+            };
+            source?: /* Entity reference for preview display */ PreviewEntity;
+            target?: /* Entity reference for preview display */ PreviewEntity;
+            /**
+             * List of changes/modifications being made
+             */
+            changes?: /* A single field change in the preview */ PreviewChange[];
+            /**
+             * Additional context information
+             */
+            metadata?: {
+                [name: string]: /* Typed value for preview display */ PreviewValue;
+            };
+            /**
+             * AI reasoning for why this action is recommended
+             * example:
+             * This email discusses solar panel installation and should be handled by the Service team.
+             */
+            summary?: string;
+        }
+        export interface UpdateAgentRequest {
+            name?: string;
+            description?: string;
+            category?: SkillCategory;
+            icon?: string;
+            system_prompt?: string;
+            tools?: string[];
+            model_config?: ModelConfig;
+            max_iterations?: number;
+            execution_pattern?: /**
+             * - direct: Single LLM call, no tools
+             * - react: Multi-step reasoning with tool use
+             *
+             */
+            ExecutionPattern;
+            execution_mode?: /**
+             * - automatic: Execute without human intervention
+             * - approval: Pause for human approval before tool execution
+             * - draft: Execute but mark output as draft for review
+             *
+             */
+            ExecutionMode;
+            output_schema?: {
+                [key: string]: any;
+            };
+            input_parameters_schema?: /**
+             * example:
+             * {
+             *   "type": "object",
+             *   "parameters": [
+             *     {
+             *       "name": "target_schema",
+             *       "label": "Target Schema",
+             *       "type": "entity-schema",
+             *       "description": "Entity type to create"
+             *     },
+             *     {
+             *       "name": "confidence_threshold",
+             *       "label": "Confidence Threshold",
+             *       "type": "number",
+             *       "minimum": 0,
+             *       "maximum": 1,
+             *       "default": 0.8
+             *     },
+             *     {
+             *       "name": "categories",
+             *       "label": "Categories",
+             *       "type": "select",
+             *       "enum": [
+             *         "invoice",
+             *         "contract",
+             *         "letter"
+             *       ],
+             *       "multi": true
+             *     }
+             *   ],
+             *   "required": [
+             *     "target_schema"
+             *   ]
+             * }
+             */
+            InputParametersSchema;
+        }
+    }
+}
+declare namespace Paths {
+    namespace ApproveExecution {
+        namespace Parameters {
+            export type ExecutionId = string; // uuid
+        }
+        export interface PathParameters {
+            execution_id: Parameters.ExecutionId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.ApproveExecutionRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionResponse;
+            export type $400 = Components.Schemas.Error;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace CancelExecution {
+        namespace Parameters {
+            export type ExecutionId = string; // uuid
+        }
+        export interface PathParameters {
+            execution_id: Parameters.ExecutionId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionResponse;
+            export type $400 = Components.Schemas.Error;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace CreateAgent {
+        export type RequestBody = Components.Schemas.CreateAgentRequest;
+        namespace Responses {
+            export type $201 = Components.Schemas.AgentDefinition;
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+    namespace DeleteAgentById {
+        namespace Parameters {
+            export type AgentId = /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            Components.Schemas.AgentId;
+        }
+        export interface PathParameters {
+            agent_id: Parameters.AgentId;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+    namespace ExecuteAgent {
+        namespace Parameters {
+            export type AgentId = /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            Components.Schemas.AgentId;
+        }
+        export interface PathParameters {
+            agent_id: Parameters.AgentId;
+        }
+        export type RequestBody = Components.Schemas.ExecuteAgentRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionResponse;
+            export type $400 = Components.Schemas.Error;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace GetAgentById {
+        namespace Parameters {
+            export type AgentId = /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            Components.Schemas.AgentId;
+        }
+        export interface PathParameters {
+            agent_id: Parameters.AgentId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.AgentDefinition;
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+    namespace GetExecution {
+        namespace Parameters {
+            export type ExecutionId = string; // uuid
+        }
+        export interface PathParameters {
+            execution_id: Parameters.ExecutionId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionResponse;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace GetExecutionTrace {
+        namespace Parameters {
+            export type ExecutionId = string; // uuid
+        }
+        export interface PathParameters {
+            execution_id: Parameters.ExecutionId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionTrace;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace ListAgents {
+        namespace Parameters {
+            export type Availability = /**
+             * Where the skill/agent is available:
+             * - flows: Available in workflow automations
+             * - copilot: Available as a sub-agent in copilot
+             * - all: Available everywhere
+             *
+             */
+            Components.Schemas.SkillAvailability;
+            export type EntitySchema = string;
+            export type Source = /**
+             * - system: Pre-built by epilot (system skills)
+             * - custom: Created by organization
+             *
+             */
+            Components.Schemas.AgentSource;
+        }
+        export interface QueryParameters {
+            source?: Parameters.Source;
+            availability?: Parameters.Availability;
+            entity_schema?: Parameters.EntitySchema;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ListAgentsResponse;
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+    namespace ListExecutions {
+        namespace Parameters {
+            export type AgentId = string;
+            export type Limit = number;
+            export type Status = Components.Schemas.ExecutionStatus;
+        }
+        export interface QueryParameters {
+            agent_id?: Parameters.AgentId;
+            status?: Parameters.Status;
+            limit?: Parameters.Limit;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ListExecutionsResponse;
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+    namespace RejectExecution {
+        namespace Parameters {
+            export type ExecutionId = string; // uuid
+        }
+        export interface PathParameters {
+            execution_id: Parameters.ExecutionId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.RejectExecutionRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.ExecutionResponse;
+            export type $400 = Components.Schemas.Error;
+            export type $404 = Components.Schemas.Error;
+        }
+    }
+    namespace UpdateAgentById {
+        namespace Parameters {
+            export type AgentId = /**
+             * Agent identifier. Can be either:
+             * - System skill ID (prefixed): "skill:email-categorizer", "skill:email-labeler"
+             * - Custom agent UUID: "0336a235-9417-4dd8-894c-fe81285bba75"
+             *
+             * example:
+             * skill:email-categorizer
+             */
+            Components.Schemas.AgentId;
+        }
+        export interface PathParameters {
+            agent_id: Parameters.AgentId;
+        }
+        export type RequestBody = Components.Schemas.UpdateAgentRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.AgentDefinition;
+            export type $400 = Components.Schemas.Error;
+        }
+    }
+}
+
+
+interface OperationMethods {
+  /**
+   * listAgents - List all agent configurations
+   * 
+   * Lists agents from both system skills and custom agents.
+   * Use query parameters to filter by source, availability, or entity schema.
+   * 
+   */
+  'listAgents'(
+    parameters?: Parameters<Paths.ListAgents.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListAgents.Responses.$200>
+  /**
+   * createAgent - Create Agent definition
+   * 
+   * Creates a new custom agent. System skills cannot be created via this endpoint.
+   */
+  'createAgent'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CreateAgent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateAgent.Responses.$201>
+  /**
+   * getAgentById - Get the agent configuration by ID
+   * 
+   * Retrieves an agent by ID. Supports both:
+   * - System skill IDs (prefixed): "skill:email-categorizer"
+   * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
+   * 
+   */
+  'getAgentById'(
+    parameters?: Parameters<Paths.GetAgentById.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetAgentById.Responses.$200>
+  /**
+   * updateAgentById - Update the agent configuration by ID
+   * 
+   * Updates a custom agent. System skills cannot be updated via this endpoint.
+   */
+  'updateAgentById'(
+    parameters?: Parameters<Paths.UpdateAgentById.PathParameters> | null,
+    data?: Paths.UpdateAgentById.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.UpdateAgentById.Responses.$200>
+  /**
+   * deleteAgentById - Delete the agent configuration by ID
+   * 
+   * Deletes a custom agent. System skills cannot be deleted via this endpoint.
+   */
+  'deleteAgentById'(
+    parameters?: Parameters<Paths.DeleteAgentById.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteAgentById.Responses.$204>
+  /**
+   * executeAgent - Execute an agent
+   * 
+   * Executes an agent (system skill or custom agent).
+   * Supports both:
+   * - System skill IDs (prefixed): "skill:email-categorizer"
+   * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
+   * 
+   */
+  'executeAgent'(
+    parameters?: Parameters<Paths.ExecuteAgent.PathParameters> | null,
+    data?: Paths.ExecuteAgent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ExecuteAgent.Responses.$200>
+  /**
+   * listExecutions - List executions
+   */
+  'listExecutions'(
+    parameters?: Parameters<Paths.ListExecutions.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListExecutions.Responses.$200>
+  /**
+   * getExecution - Get execution by ID
+   */
+  'getExecution'(
+    parameters?: Parameters<Paths.GetExecution.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetExecution.Responses.$200>
+  /**
+   * cancelExecution - Cancel execution
+   */
+  'cancelExecution'(
+    parameters?: Parameters<Paths.CancelExecution.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CancelExecution.Responses.$200>
+  /**
+   * getExecutionTrace - Get execution trace/iterations
+   * 
+   * Returns the step-by-step reasoning and tool calls for ReAct mode executions. Returns empty iterations array for direct mode executions.
+   */
+  'getExecutionTrace'(
+    parameters?: Parameters<Paths.GetExecutionTrace.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetExecutionTrace.Responses.$200>
+  /**
+   * approveExecution - Approve pending action
+   * 
+   * Approves a pending tool action when execution is in waiting_approval status
+   */
+  'approveExecution'(
+    parameters?: Parameters<Paths.ApproveExecution.PathParameters> | null,
+    data?: Paths.ApproveExecution.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ApproveExecution.Responses.$200>
+  /**
+   * rejectExecution - Reject pending action
+   * 
+   * Rejects a pending tool action when execution is in waiting_approval status
+   */
+  'rejectExecution'(
+    parameters?: Parameters<Paths.RejectExecution.PathParameters> | null,
+    data?: Paths.RejectExecution.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.RejectExecution.Responses.$200>
+}
+
+interface PathsDictionary {
+  ['/v1/agents']: {
+    /**
+     * createAgent - Create Agent definition
+     * 
+     * Creates a new custom agent. System skills cannot be created via this endpoint.
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CreateAgent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateAgent.Responses.$201>
+    /**
+     * listAgents - List all agent configurations
+     * 
+     * Lists agents from both system skills and custom agents.
+     * Use query parameters to filter by source, availability, or entity schema.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListAgents.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListAgents.Responses.$200>
+  }
+  ['/v1/agents/{agent_id}']: {
+    /**
+     * getAgentById - Get the agent configuration by ID
+     * 
+     * Retrieves an agent by ID. Supports both:
+     * - System skill IDs (prefixed): "skill:email-categorizer"
+     * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetAgentById.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetAgentById.Responses.$200>
+    /**
+     * updateAgentById - Update the agent configuration by ID
+     * 
+     * Updates a custom agent. System skills cannot be updated via this endpoint.
+     */
+    'put'(
+      parameters?: Parameters<Paths.UpdateAgentById.PathParameters> | null,
+      data?: Paths.UpdateAgentById.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.UpdateAgentById.Responses.$200>
+    /**
+     * deleteAgentById - Delete the agent configuration by ID
+     * 
+     * Deletes a custom agent. System skills cannot be deleted via this endpoint.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteAgentById.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteAgentById.Responses.$204>
+  }
+  ['/v1/agents/{agent_id}/execute']: {
+    /**
+     * executeAgent - Execute an agent
+     * 
+     * Executes an agent (system skill or custom agent).
+     * Supports both:
+     * - System skill IDs (prefixed): "skill:email-categorizer"
+     * - Custom agent IDs (UUID): "0336a235-9417-4dd8-894c-fe81285bba75"
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.ExecuteAgent.PathParameters> | null,
+      data?: Paths.ExecuteAgent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ExecuteAgent.Responses.$200>
+  }
+  ['/v1/executions']: {
+    /**
+     * listExecutions - List executions
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListExecutions.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListExecutions.Responses.$200>
+  }
+  ['/v1/executions/{execution_id}']: {
+    /**
+     * getExecution - Get execution by ID
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetExecution.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetExecution.Responses.$200>
+    /**
+     * cancelExecution - Cancel execution
+     */
+    'delete'(
+      parameters?: Parameters<Paths.CancelExecution.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CancelExecution.Responses.$200>
+  }
+  ['/v1/executions/{execution_id}/trace']: {
+    /**
+     * getExecutionTrace - Get execution trace/iterations
+     * 
+     * Returns the step-by-step reasoning and tool calls for ReAct mode executions. Returns empty iterations array for direct mode executions.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetExecutionTrace.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetExecutionTrace.Responses.$200>
+  }
+  ['/v1/executions/{execution_id}/approve']: {
+    /**
+     * approveExecution - Approve pending action
+     * 
+     * Approves a pending tool action when execution is in waiting_approval status
+     */
+    'post'(
+      parameters?: Parameters<Paths.ApproveExecution.PathParameters> | null,
+      data?: Paths.ApproveExecution.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ApproveExecution.Responses.$200>
+  }
+  ['/v1/executions/{execution_id}/reject']: {
+    /**
+     * rejectExecution - Reject pending action
+     * 
+     * Rejects a pending tool action when execution is in waiting_approval status
+     */
+    'post'(
+      parameters?: Parameters<Paths.RejectExecution.PathParameters> | null,
+      data?: Paths.RejectExecution.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.RejectExecution.Responses.$200>
+  }
+}
+
+type Client = OpenAPIClient<OperationMethods, PathsDictionary>
+
+
+type AgentDefinition = Components.Schemas.AgentDefinition;
+type AgentId = Components.Schemas.AgentId;
+type AgentSource = Components.Schemas.AgentSource;
+type ApproveExecutionRequest = Components.Schemas.ApproveExecutionRequest;
+type CreateAgentRequest = Components.Schemas.CreateAgentRequest;
+type Error = Components.Schemas.Error;
+type ExecuteAgentRequest = Components.Schemas.ExecuteAgentRequest;
+type ExecutionContext = Components.Schemas.ExecutionContext;
+type ExecutionError = Components.Schemas.ExecutionError;
+type ExecutionIteration = Components.Schemas.ExecutionIteration;
+type ExecutionMetrics = Components.Schemas.ExecutionMetrics;
+type ExecutionMode = Components.Schemas.ExecutionMode;
+type ExecutionPattern = Components.Schemas.ExecutionPattern;
+type ExecutionResponse = Components.Schemas.ExecutionResponse;
+type ExecutionStatus = Components.Schemas.ExecutionStatus;
+type ExecutionTrace = Components.Schemas.ExecutionTrace;
+type InputParameterDefinition = Components.Schemas.InputParameterDefinition;
+type InputParametersSchema = Components.Schemas.InputParametersSchema;
+type ListAgentsResponse = Components.Schemas.ListAgentsResponse;
+type ListExecutionsResponse = Components.Schemas.ListExecutionsResponse;
+type ModelConfig = Components.Schemas.ModelConfig;
+type ParameterType = Components.Schemas.ParameterType;
+type PendingAction = Components.Schemas.PendingAction;
+type PreviewActionType = Components.Schemas.PreviewActionType;
+type PreviewChange = Components.Schemas.PreviewChange;
+type PreviewEntity = Components.Schemas.PreviewEntity;
+type PreviewValue = Components.Schemas.PreviewValue;
+type RejectExecutionRequest = Components.Schemas.RejectExecutionRequest;
+type SkillAvailability = Components.Schemas.SkillAvailability;
+type SkillCategory = Components.Schemas.SkillCategory;
+type ToolDefinition = Components.Schemas.ToolDefinition;
+type ToolPreview = Components.Schemas.ToolPreview;
+type UpdateAgentRequest = Components.Schemas.UpdateAgentRequest;
+
+export { type AgentDefinition as A, type Client as C, type Error as E, type InputParameterDefinition as I, type ListAgentsResponse as L, type ModelConfig as M, type OperationMethods as O, Paths as P, type RejectExecutionRequest as R, type SkillAvailability as S, type ToolDefinition as T, type UpdateAgentRequest as U, Components as a, type PathsDictionary as b, type AgentId as c, type AgentSource as d, type ApproveExecutionRequest as e, type CreateAgentRequest as f, type ExecuteAgentRequest as g, type ExecutionContext as h, type ExecutionError as i, type ExecutionIteration as j, type ExecutionMetrics as k, type ExecutionMode as l, type ExecutionPattern as m, type ExecutionResponse as n, type ExecutionStatus as o, type ExecutionTrace as p, type InputParametersSchema as q, type ListExecutionsResponse as r, type ParameterType as s, type PendingAction as t, type PreviewActionType as u, type PreviewChange as v, type PreviewEntity as w, type PreviewValue as x, type SkillCategory as y, type ToolPreview as z };