@elqnt/agents 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1297 @@
+import { JSONSchema, ProductNameTS, ResponseMetadata } from '@elqnt/types';
+
+/**
+ * AgentContext accumulates meaningful state from agentic tool executions.
+ * It provides a structured, schema-driven view of what happened during a chat
+ * and what meaningful data was extracted.
+ * Stored in: agent_contexts_org_{orgId} with key: {agentId}:{chatKey}
+ */
+interface AgentContext {
+    /**
+     * Identity - used for storage key and cross-references
+     */
+    orgId: string;
+    agentId: string;
+    chatKey: string;
+    /**
+     * Schema defines the shape of accumulated variables
+     * Tools contribute to this schema as they execute
+     */
+    schema: any;
+    /**
+     * Variables is the merged view of all important outputs
+     * This is what gets displayed in the "Agent Context" panel
+     */
+    variables: {
+        [key: string]: any;
+    };
+    /**
+     * Executions tracks each tool call with full input/output
+     * Similar to NodeStates in workflow engine
+     */
+    executions: AgentExecution[];
+    /**
+     * PendingPlan holds an execution plan awaiting user approval
+     * Part of the Plan → Approve → Execute flow
+     */
+    pendingPlan?: ExecutionPlan;
+    /**
+     * CompletedPlans holds historical plans (for reference/audit)
+     */
+    completedPlans?: ExecutionPlan[];
+    /**
+     * Tracking
+     */
+    createdAt: number;
+    lastUpdated: number;
+    /**
+     * Size management
+     */
+    archivedExecutionCount?: number;
+}
+/**
+ * AgentExecution represents one tool call during the agentic loop.
+ * Similar to NodeState in the workflow engine.
+ */
+interface AgentExecution {
+    /**
+     * Identity
+     */
+    id: string;
+    toolName: string;
+    toolId?: string;
+    /**
+     * Display
+     */
+    title: string;
+    type: string;
+    icon?: string;
+    /**
+     * Status
+     */
+    status: ExecutionStatusTS;
+    error?: string;
+    /**
+     * Schema-driven Input/Output (like NodeInput/NodeOutput)
+     */
+    inputSchema?: any;
+    input: {
+        [key: string]: any;
+    };
+    outputSchema?: any;
+    output?: {
+        [key: string]: any;
+    };
+    /**
+     * Merge Configuration - how this execution's output merges into Variables
+     */
+    mergeConfig?: MergeConfig;
+    /**
+     * Timing
+     */
+    startedAt: number;
+    completedAt?: number;
+    duration?: number;
+}
+/**
+ * ExecutionStatus represents the status of a tool execution
+ */
+type ExecutionStatus = string;
+declare const ExecutionStatusPending: ExecutionStatus;
+declare const ExecutionStatusRunning: ExecutionStatus;
+declare const ExecutionStatusCompleted: ExecutionStatus;
+declare const ExecutionStatusFailed: ExecutionStatus;
+declare const ExecutionStatusSkipped: ExecutionStatus;
+type ExecutionStatusTS = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+/**
+ * MergeConfig defines how tool output gets merged into AgentContext.Variables
+ */
+interface MergeConfig {
+    /**
+     * Keys to extract from output and merge into variables
+     */
+    mergeKeys?: string[];
+    /**
+     * Target path in variables
+     * Examples: "shipperName" (direct), "documents[]" (append to array)
+     */
+    targetPath?: string;
+    /**
+     * Strategy: "replace" | "merge" | "append"
+     * - replace: overwrite the target path
+     * - merge: deep merge objects
+     * - append: append to array (use with "path[]" syntax)
+     */
+    strategy?: MergeStrategy;
+}
+/**
+ * MergeStrategy defines how values are merged into variables
+ */
+type MergeStrategy = string;
+declare const MergeStrategyReplace: MergeStrategy;
+declare const MergeStrategyMerge: MergeStrategy;
+declare const MergeStrategyAppend: MergeStrategy;
+type MergeStrategyTS = 'replace' | 'merge' | 'append';
+/**
+ * AgentContextConfig is defined on the Agent to configure how context is managed
+ */
+interface AgentContextConfig {
+    /**
+     * Base schema - defines the expected shape of accumulated context
+     */
+    schema: any;
+    /**
+     * Default/initial values when context is created
+     */
+    defaultVariables?: {
+        [key: string]: any;
+    };
+    /**
+     * Whether to extend schema at runtime when new keys appear
+     */
+    allowSchemaExtension: boolean;
+}
+/**
+ * Constants for size management
+ */
+declare const MaxExecutions = 100;
+/**
+ * Constants for size management
+ */
+declare const ExecutionTTLHours = 72;
+/**
+ * ExecutionPlan represents a planned sequence of tool executions
+ * that requires user approval before execution.
+ */
+interface ExecutionPlan {
+    /**
+     * Identity
+     */
+    id: string;
+    chatKey: string;
+    agentId: string;
+    orgId: string;
+    /**
+     * Plan metadata
+     */
+    title: string;
+    description: string;
+    createdAt: number;
+    /**
+     * Planned steps
+     */
+    steps: PlannedStep[];
+    /**
+     * Status tracking
+     */
+    status: PlanStatusTS;
+    approvedAt?: number;
+    approvedBy?: string;
+    rejectedAt?: number;
+    rejectionReason?: string;
+    /**
+     * Execution tracking (populated after approval)
+     */
+    executionStartedAt?: number;
+    executionCompletedAt?: number;
+    currentStepIndex: number;
+}
+/**
+ * PlanStatus represents the status of an execution plan
+ */
+type PlanStatus = string;
+declare const PlanStatusPendingApproval: PlanStatus;
+declare const PlanStatusApproved: PlanStatus;
+declare const PlanStatusExecuting: PlanStatus;
+declare const PlanStatusCompleted: PlanStatus;
+declare const PlanStatusRejected: PlanStatus;
+declare const PlanStatusCancelled: PlanStatus;
+type PlanStatusTS = 'pending_approval' | 'approved' | 'executing' | 'completed' | 'rejected' | 'cancelled';
+/**
+ * PlannedStep represents a single step in an execution plan
+ */
+interface PlannedStep {
+    /**
+     * Identity
+     */
+    id: string;
+    order: number;
+    /**
+     * Tool information
+     */
+    toolName: string;
+    toolId?: string;
+    title: string;
+    description: string;
+    icon?: string;
+    /**
+     * Planned input (may reference outputs from previous steps)
+     */
+    plannedInput: {
+        [key: string]: any;
+    };
+    /**
+     * Dependencies (step IDs that must complete before this one)
+     */
+    dependsOn?: string[];
+    /**
+     * Optional: user can toggle individual steps
+     */
+    enabled: boolean;
+    /**
+     * After execution (populated during/after execution)
+     */
+    status: ExecutionStatusTS;
+    output?: {
+        [key: string]: any;
+    };
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+/**
+ * PlanApprovalConfig configures when an agent requires plan approval
+ */
+interface PlanApprovalConfig {
+    /**
+     * Always require approval for any multi-tool operation
+     */
+    alwaysRequire: boolean;
+    /**
+     * Require approval only for these tool names
+     */
+    requireForTools?: string[];
+    /**
+     * Require approval when estimated execution time exceeds threshold (seconds)
+     */
+    timeThresholdSeconds?: number;
+    /**
+     * Require approval when number of steps exceeds threshold
+     */
+    stepCountThreshold?: number;
+    /**
+     * Auto-approve if user has previously approved similar plans
+     */
+    allowAutoApprove: boolean;
+}
+/**
+ * CreateToolRequest represents a request to create a tool
+ */
+interface CreateToolRequest {
+    orgId: string;
+    tool?: Tool;
+}
+/**
+ * UpdateToolRequest represents a request to update a tool
+ */
+interface UpdateToolRequest {
+    orgId: string;
+    tool?: Tool;
+}
+/**
+ * GetToolRequest represents a request to get a tool
+ */
+interface GetToolRequest {
+    orgId: string;
+    toolId: string;
+}
+/**
+ * DeleteToolRequest represents a request to delete a tool
+ */
+interface DeleteToolRequest {
+    orgId: string;
+    toolId: string;
+}
+/**
+ * ListToolsRequest represents a request to list tools
+ */
+interface ListToolsRequest {
+    orgId: string;
+    onlySystem?: boolean;
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * ToolResponse represents a response containing a tool
+ */
+interface ToolResponse {
+    tool?: Tool;
+    metadata: any;
+}
+/**
+ * ToolsListResponse represents a response containing multiple tools
+ */
+interface ToolsListResponse {
+    tools: Tool[];
+    total: number;
+    metadata: any;
+}
+/**
+ * CreateSubAgentRequest represents a request to create a sub-agent
+ */
+interface CreateSubAgentRequest {
+    orgId: string;
+    subAgent?: SubAgent;
+}
+/**
+ * UpdateSubAgentRequest represents a request to update a sub-agent
+ */
+interface UpdateSubAgentRequest {
+    orgId: string;
+    subAgent?: SubAgent;
+}
+/**
+ * GetSubAgentRequest represents a request to get a sub-agent
+ */
+interface GetSubAgentRequest {
+    orgId: string;
+    subAgentId: string;
+}
+/**
+ * DeleteSubAgentRequest represents a request to delete a sub-agent
+ */
+interface DeleteSubAgentRequest {
+    orgId: string;
+    subAgentId: string;
+}
+/**
+ * ListSubAgentsRequest represents a request to list sub-agents
+ */
+interface ListSubAgentsRequest {
+    orgId: string;
+    onlySystem?: boolean;
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * SubAgentResponse represents a response containing a sub-agent
+ */
+interface SubAgentResponse {
+    subAgent?: SubAgent;
+    metadata: any;
+}
+/**
+ * SubAgentsListResponse represents a response containing multiple sub-agents
+ */
+interface SubAgentsListResponse {
+    subAgents: SubAgent[];
+    total: number;
+    metadata: any;
+}
+/**
+ * GetToolsByIDsRequest represents a request to get multiple tools by IDs
+ */
+interface GetToolsByIDsRequest {
+    orgId: string;
+    toolIds: string[];
+}
+/**
+ * GetToolsByIDsResponse represents a response containing multiple tools
+ */
+interface GetToolsByIDsResponse {
+    tools: Tool[];
+    metadata: any;
+}
+/**
+ * GetSubAgentsByIDsRequest represents a request to get multiple sub-agents by IDs
+ */
+interface GetSubAgentsByIDsRequest {
+    orgId: string;
+    subAgentIds: string[];
+}
+/**
+ * GetSubAgentsByIDsResponse represents a response containing multiple sub-agents
+ */
+interface GetSubAgentsByIDsResponse {
+    subAgents: SubAgent[];
+    metadata: any;
+}
+interface ExecuteToolRequest {
+    orgId: string;
+    tool?: AgentTool;
+    input: {
+        [key: string]: any;
+    };
+    metadata?: {
+        [key: string]: any;
+    };
+    context?: {
+        [key: string]: any;
+    };
+    chatKey?: string;
+}
+interface ExecuteToolResponse {
+    result: {
+        [key: string]: any;
+    };
+    metadata: any;
+}
+type AgentTypeTS = 'chat' | 'react';
+type AgentSubTypeTS = 'chat' | 'react' | 'workflow' | 'document';
+type AgentStatusTS = 'draft' | 'active' | 'inactive' | 'archived';
+type AgentType = string;
+declare const AgentTypeChat: AgentType;
+declare const AgentTypeReact: AgentType;
+type AgentSubType = string;
+/**
+ * Agent SubTypes
+ */
+declare const AgentSubTypeChat: AgentSubType;
+/**
+ * Agent SubTypes
+ */
+declare const AgentSubTypeReact: AgentSubType;
+/**
+ * Agent SubTypes
+ */
+declare const AgentSubTypeWorkflow: AgentSubType;
+/**
+ * Agent SubTypes
+ */
+declare const AgentSubTypeDocument: AgentSubType;
+type AgentStatus = string;
+declare const AgentStatusDraft: AgentStatus;
+declare const AgentStatusActive: AgentStatus;
+declare const AgentStatusInactive: AgentStatus;
+declare const AgentStatusArchived: AgentStatus;
+interface DefaultDefinitions {
+    agents: Agent[];
+    tools: Tool[];
+    subAgents: SubAgent[];
+}
+/**
+ * AgentTool represents an agent's configuration for a specific tool
+ * Includes denormalized tool information to avoid joins at runtime
+ */
+interface AgentTool {
+    toolId: string;
+    toolName: string;
+    title?: string;
+    description?: string;
+    type?: string;
+    inputSchema?: JSONSchema;
+    outputSchema?: JSONSchema;
+    configSchema?: JSONSchema;
+    config?: {
+        [key: string]: any;
+    };
+    mergeConfig?: MergeConfig;
+    enabled: boolean;
+    isSystem?: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    order?: number;
+}
+/**
+ * Core agent entity - shared by both types
+ */
+interface Agent {
+    id?: string;
+    orgId: string;
+    product: ProductNameTS;
+    type: AgentTypeTS;
+    subType: AgentSubTypeTS;
+    name: string;
+    title: string;
+    description?: string;
+    status: AgentStatusTS;
+    version: string;
+    /**
+     * === LLM CONFIG ===
+     */
+    provider: string;
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    systemPrompt: string;
+    /**
+     * Shared metadata
+     */
+    tags?: string[];
+    isDefault: boolean;
+    isPublic: boolean;
+    /**
+     * === Tool and SubAgent References ===
+     */
+    tools?: AgentTool[];
+    subAgentIds?: string[];
+    /**
+     * === Essential Configs ===
+     */
+    csatConfig: CSATConfig;
+    handoffConfig: HandoffConfig;
+    /**
+     * === TYPE-SPECIFIC CORE CONFIG ===
+     */
+    reactConfig?: ReactAgentConfig;
+    /**
+     * === CROSS-CUTTING FEATURES (can be used by any agent type) ===
+     */
+    userSuggestedActionsConfig?: UserSuggestedActionsConfig;
+    /**
+     * === AGENT CONTEXT CONFIG ===
+     * Defines how AgentContext is initialized and managed for this agent
+     */
+    contextConfig?: AgentContextConfig;
+    /**
+     * === SCHEMA-DRIVEN AGENT CONFIG ===
+     * Use ConfigSchema to auto-generate UI and validate values in Config
+     */
+    configSchema: JSONSchema;
+    config?: {
+        [key: string]: any;
+    };
+    /**
+     * === UI DISPLAY CONFIG ===
+     */
+    iconName?: string;
+    capabilities?: string[];
+    samplePrompts?: string[];
+    /**
+     * === SHARED BEHAVIOR CONFIG ===
+     */
+    responseStyle?: string;
+    personalityTraits?: string[];
+    fallbackMessage?: string;
+    /**
+     * === SHARED PERFORMANCE CONFIG ===
+     */
+    responseDelay?: number;
+    maxConcurrency?: number;
+    sessionTimeout?: number;
+    /**
+     * Audit fields
+     */
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Handoff Configuration
+ */
+interface HandoffConfig {
+    enabled: boolean;
+    triggerKeywords: string[];
+    queueId?: string;
+    handoffMessage: string;
+}
+/**
+ * AgentFilters for filtering agents in list operations
+ */
+interface AgentFilters {
+    product?: ProductNameTS;
+    type?: AgentType;
+    subType?: AgentSubType;
+    status?: AgentStatus;
+    isDefault?: boolean;
+    isPublic?: boolean;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+}
+/**
+ * AgentSummary is a lightweight representation of an agent for list views
+ * Contains essential display fields plus metadata needed for chat initialization
+ */
+interface AgentSummary {
+    id: string;
+    name: string;
+    title: string;
+    description?: string;
+    iconName?: string;
+    type: AgentTypeTS;
+    status: AgentStatusTS;
+    isDefault: boolean;
+    isPublic: boolean;
+    capabilities?: string[];
+    samplePrompts?: string[];
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Tool represents a tool that can be called by an agent
+ */
+interface Tool {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    type?: string;
+    inputSchema: JSONSchema;
+    outputSchema?: JSONSchema;
+    configSchema: JSONSchema;
+    config?: {
+        [key: string]: any;
+    };
+    mergeConfig?: MergeConfig;
+    enabled: boolean;
+    isSystem: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * ToolExecution represents the execution context for a tool
+ */
+interface ToolExecution {
+    id: string;
+    title: string;
+    toolId: string;
+    toolName: string;
+    status: ToolExecutionStatusTS;
+    input: {
+        [key: string]: any;
+    };
+    result?: {
+        [key: string]: any;
+    };
+    error?: string;
+    context?: {
+        [key: string]: any;
+    };
+    startedAt: number;
+    completedAt?: number;
+    retryCount: number;
+    progress?: ToolExecutionProgress[];
+}
+interface ToolExecutionProgress {
+    status: ToolExecutionStatusTS;
+    timestamp: number;
+    message?: string;
+    error?: string;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * ToolExecutionStatus represents the status of a tool execution
+ */
+type ToolExecutionStatus = string;
+declare const ToolExecutionStatusStarted: ToolExecutionStatus;
+declare const ToolExecutionStatusExecuting: ToolExecutionStatus;
+declare const ToolExecutionStatusCompleted: ToolExecutionStatus;
+declare const ToolExecutionStatusFailed: ToolExecutionStatus;
+declare const ToolExecutionStatusTimeout: ToolExecutionStatus;
+declare const ToolExecutionStatusSkipped: ToolExecutionStatus;
+/**
+ * SubAgent represents a sub-agent composed of tools
+ */
+interface SubAgent {
+    id: string;
+    orgId: string;
+    name: string;
+    title: string;
+    description: string;
+    prompt: string;
+    toolIds: string[];
+    inputSchema: JSONSchema;
+    outputSchema: JSONSchema;
+    configSchema: JSONSchema;
+    config?: {
+        [key: string]: any;
+    };
+    version: string;
+    enabled: boolean;
+    isSystem: boolean;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+/**
+ * AgentToolConfiguration represents how an agent uses tools
+ */
+interface AgentToolConfiguration {
+    enabledTools: string[];
+    enabledSubAgents: string[];
+    toolConfigs: {
+        [key: string]: ToolConfig;
+    };
+    executionPolicy: ToolExecutionPolicy;
+    maxParallelCalls: number;
+    requireApproval: boolean;
+}
+/**
+ * ToolExecutionPolicy defines how tools are executed
+ */
+interface ToolExecutionPolicy {
+    mode: ExecutionModeTS;
+    maxIterations: number;
+    stopOnError: boolean;
+    retryOnFailure: boolean;
+    timeoutSeconds: number;
+}
+/**
+ * ExecutionMode defines how tools are executed
+ */
+type ExecutionMode = string;
+declare const ExecutionModeSync: ExecutionMode;
+declare const ExecutionModeAsync: ExecutionMode;
+declare const ExecutionModeAsyncClient: ExecutionMode;
+/**
+ * CreateExecutionPlanRequest represents a request to create an execution plan
+ */
+interface CreateExecutionPlanRequest {
+    agentInstanceId: string;
+    orgId: string;
+    input: string;
+    context?: {
+        [key: string]: any;
+    };
+    availableTools: Tool[];
+}
+/**
+ * CreateExecutionPlanResponse represents the response with an execution plan
+ */
+interface CreateExecutionPlanResponse {
+    agentInstanceId: string;
+    executionPlan: ToolExecution[];
+    estimatedTime?: any;
+}
+/**
+ * ExecutePlanRequest represents a request to execute the plan
+ */
+interface ExecutePlanRequest {
+    agentInstanceId: string;
+    orgId: string;
+    approveAll?: boolean;
+}
+/**
+ * ExecutePlanResponse represents the response after executing the plan
+ */
+interface ExecutePlanResponse {
+    stateId: string;
+    status: ToolExecutionStatusTS;
+    executedTools: ToolExecution[];
+    finalResult?: any;
+    errors?: string[];
+}
+type ToolExecutionStatusTS = 'pending' | 'executing' | 'completed' | 'failed' | 'timeout' | 'skipped';
+type ExecutionModeTS = 'sync' | 'async' | 'asyncClient';
+/**
+ * CSAT Configuration
+ */
+interface CSATConfig {
+    enabled: boolean;
+    survey?: CSATSurvey;
+}
+interface CSATQuestion {
+    question: {
+        [key: string]: string;
+    };
+    showRating: boolean;
+    showComment: boolean;
+}
+interface CSATSurvey {
+    questions: CSATQuestion[];
+    timeThreshold: number;
+    closeOnResponse: boolean;
+}
+interface CSATAnswer {
+    question: string;
+    lang?: string;
+    rating?: number;
+    comment?: string;
+}
+interface CSATResponse {
+    answers: CSATAnswer[];
+    submittedAt: number;
+    overallRating: number;
+}
+/**
+ * ReAct Agent Configuration
+ */
+interface ReactAgentConfig {
+    /**
+     * Core ReAct Configuration
+     */
+    maxIterations: number;
+    reasoningPrompt: string;
+    stopConditions: string[];
+    availableTools: string[];
+    requireConfirmation: boolean;
+    /**
+     * LLM Configuration
+     */
+    model: string;
+    temperature: number;
+    maxTokens: number;
+    provider: string;
+    /**
+     * Context Management
+     */
+    maxContextLength: number;
+    memoryRetention: number;
+    compressionStrategy: string;
+    /**
+     * Tool Configuration
+     */
+    toolConfigs?: {
+        [key: string]: ToolConfig;
+    };
+    mcpServers?: MCPServerConfig[];
+    /**
+     * Execution Configuration
+     */
+    timeoutMinutes: number;
+    retryAttempts: number;
+    parallelExecution: boolean;
+    /**
+     * Safety Configuration
+     */
+    dangerousOperations?: string[];
+    allowedFileTypes?: string[];
+    restrictedPaths?: string[];
+}
+interface ToolConfig {
+    enabled: boolean;
+    timeoutSeconds: number;
+    retryPolicy: RetryPolicy;
+    configuration?: {
+        [key: string]: any;
+    };
+}
+interface RetryPolicy {
+    maxAttempts: number;
+    backoffStrategy: string;
+    backoffDelay: any;
+}
+interface MCPServerConfig {
+    name: string;
+    endpoint: string;
+    trusted: boolean;
+    timeout: number;
+    credentials?: {
+        [key: string]: string;
+    };
+}
+interface CreateAgentRequest {
+    agent?: Agent;
+    orgId: string;
+}
+interface AgentResponse {
+    agent?: Agent;
+    metadata: any;
+}
+interface GetAgentRequest {
+    id?: string;
+    name?: string;
+    orgId: string;
+}
+interface UpdateAgentRequest {
+    agent: Agent;
+    orgId: string;
+}
+interface DeleteAgentRequest {
+    id: string;
+    orgId: string;
+}
+interface ListAgentsRequest {
+    orgId: string;
+    filters?: AgentFilters;
+}
+interface ListAgentsResponse {
+    agents: Agent[];
+    metadata: any;
+}
+/**
+ * ListAgentsSummaryRequest requests a lightweight list of agents
+ */
+interface ListAgentsSummaryRequest {
+    orgId: string;
+    filters?: AgentFilters;
+}
+/**
+ * ListAgentsSummaryResponse returns lightweight agent summaries for list views
+ */
+interface ListAgentsSummaryResponse {
+    agents: AgentSummary[];
+    metadata: any;
+}
+interface GetDefaultAgentRequest {
+    orgId: string;
+    agentType: AgentType;
+}
+interface UpdateOrgAgentsRequest {
+    orgId: string;
+    defaultDefinitions?: DefaultDefinitions;
+}
+interface UpdateOrgAgentsResponse {
+    toolsCreated: number;
+    subAgentsCreated: number;
+    agentsCreated: number;
+    metadata: ResponseMetadata;
+}
+/**
+ * Core Agent Operations
+ */
+declare const AgentCreateSubject = "agent.create";
+/**
+ * Core Agent Operations
+ */
+declare const AgentCreatedSubject = "agent.created";
+/**
+ * Core Agent Operations
+ */
+declare const AgentGetSubject = "agent.get";
+/**
+ * Core Agent Operations
+ */
+declare const AgentUpdateSubject = "agent.update";
+/**
+ * Core Agent Operations
+ */
+declare const AgentUpdatedSubject = "agent.updated";
+/**
+ * Core Agent Operations
+ */
+declare const AgentDeleteSubject = "agent.delete";
+/**
+ * Core Agent Operations
+ */
+declare const AgentDeletedSubject = "agent.deleted";
+/**
+ * Core Agent Operations
+ */
+declare const AgentListSubject = "agent.list";
+/**
+ * Core Agent Operations
+ */
+declare const AgentListSummarySubject = "agent.list.summary";
+/**
+ * Core Agent Operations
+ */
+declare const AgentSearchSubject = "agent.search";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentChatCreateSubject = "agent.chat.create";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentChatUpdateSubject = "agent.chat.update";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentChatGetSubject = "agent.chat.get";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentChatValidateSubject = "agent.chat.validate";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentReactCreateSubject = "agent.react.create";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentReactUpdateSubject = "agent.react.update";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentReactGetSubject = "agent.react.get";
+/**
+ * Agent Type Specific Operations
+ */
+declare const AgentReactValidateSubject = "agent.react.validate";
+/**
+ * Execution Coordination
+ */
+declare const AgentExecuteSubject = "agent.execute";
+/**
+ * Execution Coordination
+ */
+declare const AgentExecuteStatusSubject = "agent.execute.status";
+/**
+ * Execution Coordination
+ */
+declare const AgentExecuteStopSubject = "agent.execute.stop";
+/**
+ * Version Management
+ */
+declare const AgentVersionCreateSubject = "agent.version.create";
+/**
+ * Version Management
+ */
+declare const AgentVersionCreatedSubject = "agent.version.created";
+/**
+ * Version Management
+ */
+declare const AgentVersionGetSubject = "agent.version.get";
+/**
+ * Version Management
+ */
+declare const AgentVersionListSubject = "agent.version.list";
+/**
+ * Version Management
+ */
+declare const AgentVersionActivateSubject = "agent.version.activate";
+/**
+ * Version Management
+ */
+declare const AgentVersionActivatedSubject = "agent.version.activated";
+/**
+ * Default Agent Management
+ */
+declare const AgentEnsureDefaultSubject = "agent.ensure-default";
+/**
+ * Default Agent Management
+ */
+declare const AgentGetDefaultSubject = "agent.get-default";
+/**
+ * Organization Management
+ */
+declare const AgentGetByOrgSubject = "agent.get-by-org";
+/**
+ * Organization Management
+ */
+declare const AgentCloneSubject = "agent.clone";
+/**
+ * Organization Management
+ */
+declare const AgentExportSubject = "agent.export";
+/**
+ * Organization Management
+ */
+declare const AgentImportSubject = "agent.import";
+/**
+ * Organization Management
+ */
+declare const AgentUpdateOrgSubject = "agent.update-org-agents";
+/**
+ * Configuration Templates
+ */
+declare const AgentTemplateListSubject = "agent.template.list";
+/**
+ * Configuration Templates
+ */
+declare const AgentTemplateGetSubject = "agent.template.get";
+/**
+ * Configuration Templates
+ */
+declare const AgentFromTemplateSubject = "agent.from-template";
+/**
+ * Chat Service Integration
+ */
+declare const ChatAgentExecuteSubject = "chat.agent.execute";
+/**
+ * Execution Service Integration
+ */
+declare const ChatAgentStatusSubject = "chat.agent.status";
+/**
+ * ReAct Service Integration
+ */
+declare const ReactAgentExecuteSubject = "react.agent.execute";
+/**
+ * Execution Service Integration
+ */
+declare const ReactAgentStatusSubject = "react.agent.status";
+/**
+ * Execution Service Integration
+ */
+declare const ReactAgentStopSubject = "react.agent.stop";
+/**
+ * Workflow Service Integration
+ */
+declare const WorkflowAgentGetSubject = "workflow.agent.get";
+/**
+ * Execution Service Integration
+ */
+declare const WorkflowAgentUpdateSubject = "workflow.agent.update";
+/**
+ * Tools Management
+ */
+declare const ToolsCreateSubject = "agents.tools.create";
+/**
+ * Tools Management
+ */
+declare const ToolsCreatedSubject = "agents.tools.created";
+/**
+ * Tools Management
+ */
+declare const ToolsGetSubject = "agents.tools.get";
+/**
+ * Tools Management
+ */
+declare const ToolsUpdateSubject = "agents.tools.update";
+/**
+ * Tools Management
+ */
+declare const ToolsUpdatedSubject = "agents.tools.updated";
+/**
+ * Tools Management
+ */
+declare const ToolsDeleteSubject = "agents.tools.delete";
+/**
+ * Tools Management
+ */
+declare const ToolsDeletedSubject = "agents.tools.deleted";
+/**
+ * Tools Management
+ */
+declare const ToolsListSubject = "agents.tools.list";
+/**
+ * Tools Management
+ */
+declare const ToolsGetByIDsSubject = "agents.tools.get-by-ids";
+/**
+ * Tools Management
+ */
+declare const ToolsExecuteSubject = "agents.tools.execute";
+/**
+ * Tools Management
+ */
+declare const ToolsValidateSubject = "agents.tools.validate";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsCreateSubject = "agents.subagents.create";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsCreatedSubject = "agents.subagents.created";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsGetSubject = "agents.subagents.get";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsUpdateSubject = "agents.subagents.update";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsUpdatedSubject = "agents.subagents.updated";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsDeleteSubject = "agents.subagents.delete";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsDeletedSubject = "agents.subagents.deleted";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsListSubject = "agents.subagents.list";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsGetByIDsSubject = "agents.subagents.get-by-ids";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsExecuteSubject = "agents.subagents.execute";
+/**
+ * SubAgents Management
+ */
+declare const SubAgentsValidateSubject = "agents.subagents.validate";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceCreateSubject = "agents.instance.create";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceCreatedSubject = "agents.instance.created";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceGetSubject = "agents.instance.get";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceUpdateSubject = "agents.instance.update";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceUpdatedSubject = "agents.instance.updated";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceListSubject = "agents.instance.list";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceDeleteSubject = "agents.instance.delete";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceDeletedSubject = "agents.instance.deleted";
+/**
+ * Execution Plan Operations
+ */
+declare const AgentInstanceCreatePlanSubject = "agents.instance.create-plan";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceExecutePlanSubject = "agents.instance.execute-plan";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstancePausePlanSubject = "agents.instance.pause-plan";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceResumePlanSubject = "agents.instance.resume-plan";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceCancelPlanSubject = "agents.instance.cancel-plan";
+/**
+ * Execution History
+ */
+declare const AgentInstanceGetHistorySubject = "agents.instance.get-history";
+/**
+ * Agent Instance Management
+ */
+declare const AgentInstanceClearHistorySubject = "agents.instance.clear-history";
+/**
+ * Config and request models for product service integration
+ */
+interface UserSuggestedActionsConfig {
+    enabled: boolean;
+    actionTypes: string[];
+    maxActions: number;
+    cooldownSeconds: number;
+}
+interface UserSuggestedAction {
+    title: string;
+    actionType: string;
+    input?: string;
+    priority?: number;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+interface UserSuggestedActionsRequest {
+    orgId: string;
+    chatKey: string;
+    config: UserSuggestedActionsConfig;
+    metadata?: {
+        [key: string]: any;
+    };
+}
+interface UserSuggestedActionsResponse {
+    actions: UserSuggestedAction[];
+    metadata: any;
+}
+/**
+ * ValidationError represents a validation error with field and message
+ */
+interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * ValidationErrors represents a collection of validation errors
+ */
+type ValidationErrors = ValidationError[];
+
+export { type Agent, AgentChatCreateSubject, AgentChatGetSubject, AgentChatUpdateSubject, AgentChatValidateSubject, AgentCloneSubject, type AgentContext, type AgentContextConfig, AgentCreateSubject, AgentCreatedSubject, AgentDeleteSubject, AgentDeletedSubject, AgentEnsureDefaultSubject, AgentExecuteStatusSubject, AgentExecuteStopSubject, AgentExecuteSubject, type AgentExecution, AgentExportSubject, type AgentFilters, AgentFromTemplateSubject, AgentGetByOrgSubject, AgentGetDefaultSubject, AgentGetSubject, AgentImportSubject, AgentInstanceCancelPlanSubject, AgentInstanceClearHistorySubject, AgentInstanceCreatePlanSubject, AgentInstanceCreateSubject, AgentInstanceCreatedSubject, AgentInstanceDeleteSubject, AgentInstanceDeletedSubject, AgentInstanceExecutePlanSubject, AgentInstanceGetHistorySubject, AgentInstanceGetSubject, AgentInstanceListSubject, AgentInstancePausePlanSubject, AgentInstanceResumePlanSubject, AgentInstanceUpdateSubject, AgentInstanceUpdatedSubject, AgentListSubject, AgentListSummarySubject, AgentReactCreateSubject, AgentReactGetSubject, AgentReactUpdateSubject, AgentReactValidateSubject, type AgentResponse, AgentSearchSubject, type AgentStatus, AgentStatusActive, AgentStatusArchived, AgentStatusDraft, AgentStatusInactive, type AgentStatusTS, type AgentSubType, AgentSubTypeChat, AgentSubTypeDocument, AgentSubTypeReact, type AgentSubTypeTS, AgentSubTypeWorkflow, type AgentSummary, AgentTemplateGetSubject, AgentTemplateListSubject, type AgentTool, type AgentToolConfiguration, type AgentType, AgentTypeChat, AgentTypeReact, type AgentTypeTS, AgentUpdateOrgSubject, AgentUpdateSubject, AgentUpdatedSubject, AgentVersionActivateSubject, AgentVersionActivatedSubject, AgentVersionCreateSubject, AgentVersionCreatedSubject, AgentVersionGetSubject, AgentVersionListSubject, type CSATAnswer, type CSATConfig, type CSATQuestion, type CSATResponse, type CSATSurvey, ChatAgentExecuteSubject, ChatAgentStatusSubject, type CreateAgentRequest, type CreateExecutionPlanRequest, type CreateExecutionPlanResponse, type CreateSubAgentRequest, type CreateToolRequest, type DefaultDefinitions, type DeleteAgentRequest, type DeleteSubAgentRequest, type DeleteToolRequest, type ExecutePlanRequest, type ExecutePlanResponse, type ExecuteToolRequest, type ExecuteToolResponse, type ExecutionMode, ExecutionModeAsync, ExecutionModeAsyncClient, ExecutionModeSync, type ExecutionModeTS, type ExecutionPlan, type ExecutionStatus, ExecutionStatusCompleted, ExecutionStatusFailed, ExecutionStatusPending, ExecutionStatusRunning, ExecutionStatusSkipped, type ExecutionStatusTS, ExecutionTTLHours, type GetAgentRequest, type GetDefaultAgentRequest, type GetSubAgentRequest, type GetSubAgentsByIDsRequest, type GetSubAgentsByIDsResponse, type GetToolRequest, type GetToolsByIDsRequest, type GetToolsByIDsResponse, type HandoffConfig, type ListAgentsRequest, type ListAgentsResponse, type ListAgentsSummaryRequest, type ListAgentsSummaryResponse, type ListSubAgentsRequest, type ListToolsRequest, type MCPServerConfig, MaxExecutions, type MergeConfig, type MergeStrategy, MergeStrategyAppend, MergeStrategyMerge, MergeStrategyReplace, type MergeStrategyTS, type PlanApprovalConfig, type PlanStatus, PlanStatusApproved, PlanStatusCancelled, PlanStatusCompleted, PlanStatusExecuting, PlanStatusPendingApproval, PlanStatusRejected, type PlanStatusTS, type PlannedStep, type ReactAgentConfig, ReactAgentExecuteSubject, ReactAgentStatusSubject, ReactAgentStopSubject, type RetryPolicy, type SubAgent, type SubAgentResponse, SubAgentsCreateSubject, SubAgentsCreatedSubject, SubAgentsDeleteSubject, SubAgentsDeletedSubject, SubAgentsExecuteSubject, SubAgentsGetByIDsSubject, SubAgentsGetSubject, type SubAgentsListResponse, SubAgentsListSubject, SubAgentsUpdateSubject, SubAgentsUpdatedSubject, SubAgentsValidateSubject, type Tool, type ToolConfig, type ToolExecution, type ToolExecutionPolicy, type ToolExecutionProgress, type ToolExecutionStatus, ToolExecutionStatusCompleted, ToolExecutionStatusExecuting, ToolExecutionStatusFailed, ToolExecutionStatusSkipped, ToolExecutionStatusStarted, type ToolExecutionStatusTS, ToolExecutionStatusTimeout, type ToolResponse, ToolsCreateSubject, ToolsCreatedSubject, ToolsDeleteSubject, ToolsDeletedSubject, ToolsExecuteSubject, ToolsGetByIDsSubject, ToolsGetSubject, type ToolsListResponse, ToolsListSubject, ToolsUpdateSubject, ToolsUpdatedSubject, ToolsValidateSubject, type UpdateAgentRequest, type UpdateOrgAgentsRequest, type UpdateOrgAgentsResponse, type UpdateSubAgentRequest, type UpdateToolRequest, type UserSuggestedAction, type UserSuggestedActionsConfig, type UserSuggestedActionsRequest, type UserSuggestedActionsResponse, type ValidationError, type ValidationErrors, WorkflowAgentGetSubject, WorkflowAgentUpdateSubject };