@robosystems/client 0.1.19 → 0.1.20

package/sdk.gen.js

@@ -1,8 +1,8 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.queryFinancialAgent = exports.oauthCallback = exports.initOAuth = exports.exchangeLinkToken = exports.createLinkToken = exports.syncConnection = exports.getConnectionOptions = exports.getConnection = exports.deleteConnection = exports.createConnection = exports.listConnections = exports.getRepositoryCredits = exports.getSharedRepositoryCredits = exports.cancelSharedRepositorySubscription = exports.upgradeSharedRepositorySubscription = exports.subscribeToSharedRepository = exports.getUserSharedSubscriptions = exports.getDetailedUserAnalytics = exports.getUserUsageOverview = exports.getSharedRepositoryLimits = exports.getAllSharedRepositoryLimits = exports.getUserUsage = exports.getUserLimits = exports.updateUserApiKey = exports.revokeUserApiKey = exports.createUserApiKey = exports.listUserApiKeys = exports.updateUserPassword = exports.getAllCreditSummaries = exports.selectUserGraph = exports.getUserGraphs = exports.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.completeSsoAuth = exports.ssoTokenExchange = exports.ssoLogin = exports.generateSsoToken = exports.refreshSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
-exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.getAvailableExtensions = exports.createGraph = exports.copyDataToGraph = exports.getSubgraphQuota = exports.getSubgraphInfo = exports.deleteSubgraph = exports.createSubgraph = exports.listSubgraphs = exports.getGraphLimits = exports.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.getGraphMonthlyBill = exports.getGraphBillingHistory = exports.getGraphUsageDetails = exports.getCurrentGraphBill = exports.listSchemaExtensions = exports.exportGraphSchema = exports.validateSchema = exports.getGraphSchemaInfo = exports.executeCypherQuery = exports.getGraphUsageStats = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.exportBackup = void 0;
+exports.getAgentMetadata = exports.listAgents = exports.batchProcessQueries = exports.executeSpecificAgent = exports.autoSelectAgent = exports.getConnection = exports.deleteConnection = exports.createConnection = exports.listConnections = exports.oauthCallback = exports.initOAuth = exports.exchangeLinkToken = exports.createLinkToken = exports.syncConnection = exports.getConnectionOptions = exports.getRepositoryCredits = exports.getSharedRepositoryCredits = exports.cancelSharedRepositorySubscription = exports.upgradeSharedRepositorySubscription = exports.subscribeToSharedRepository = exports.getUserSharedSubscriptions = exports.getDetailedUserAnalytics = exports.getUserUsageOverview = exports.getSharedRepositoryLimits = exports.getAllSharedRepositoryLimits = exports.getUserUsage = exports.getUserLimits = exports.updateUserApiKey = exports.revokeUserApiKey = exports.createUserApiKey = exports.listUserApiKeys = exports.updateUserPassword = exports.getAllCreditSummaries = exports.selectUserGraph = exports.getUserGraphs = exports.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.completeSsoAuth = exports.ssoTokenExchange = exports.ssoLogin = exports.generateSsoToken = exports.refreshSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
+exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.getAvailableExtensions = exports.createGraph = exports.copyDataToGraph = exports.getSubgraphQuota = exports.getSubgraphInfo = exports.deleteSubgraph = exports.createSubgraph = exports.listSubgraphs = exports.getGraphLimits = exports.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.getGraphMonthlyBill = exports.getGraphBillingHistory = exports.getGraphUsageDetails = exports.getCurrentGraphBill = exports.listSchemaExtensions = exports.exportGraphSchema = exports.validateSchema = exports.getGraphSchemaInfo = exports.executeCypherQuery = exports.getGraphUsageStats = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.exportBackup = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Register New User
@@ -671,147 +671,6 @@ const getRepositoryCredits = (options) => {
     });
 };
 exports.getRepositoryCredits = getRepositoryCredits;
-/**
- * List Connections
- * List all data connections in the graph.
- *
- * Returns active and inactive connections with their current status.
- * Connections can be filtered by:
- * - **Entity**: Show connections for a specific entity
- * - **Provider**: Filter by connection type (sec, quickbooks, plaid)
- *
- * Each connection shows:
- * - Current sync status and health
- * - Last successful sync timestamp
- * - Configuration metadata
- * - Error messages if any
- *
- * No credits are consumed for listing connections.
- */
-const listConnections = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/{graph_id}/connections',
-        ...options
-    });
-};
-exports.listConnections = listConnections;
-/**
- * Create Connection
- * Create a new data connection for external system integration.
- *
- * This endpoint initiates connections to external data sources:
- *
- * **SEC Connections**:
- * - Provide entity CIK for automatic filing retrieval
- * - No authentication needed
- * - Begins immediate data sync
- *
- * **QuickBooks Connections**:
- * - Returns OAuth URL for authorization
- * - Requires admin permissions in QuickBooks
- * - Complete with OAuth callback
- *
- * **Plaid Connections**:
- * - Returns Plaid Link token
- * - User completes bank authentication
- * - Exchange public token for access
- *
- * Note:
- * This operation is FREE - no credit consumption required.
- */
-const createConnection = (options) => {
-    return (options.client ?? client_gen_1.client).post({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/{graph_id}/connections',
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers
-        }
-    });
-};
-exports.createConnection = createConnection;
-/**
- * Delete Connection
- * Delete a data connection and clean up related resources.
- *
- * This operation:
- * - Removes the connection configuration
- * - Preserves any imported data in the graph
- * - Performs provider-specific cleanup
- * - Revokes stored credentials
- *
- * Note:
- * This operation is FREE - no credit consumption required.
- *
- * Only users with admin role can delete connections.
- */
-const deleteConnection = (options) => {
-    return (options.client ?? client_gen_1.client).delete({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/{graph_id}/connections/{connection_id}',
-        ...options
-    });
-};
-exports.deleteConnection = deleteConnection;
-/**
- * Get Connection
- * Get detailed information about a specific connection.
- *
- * Returns comprehensive connection details including:
- * - Current status and health indicators
- * - Authentication state
- * - Sync history and statistics
- * - Error details if any
- * - Provider-specific metadata
- *
- * No credits are consumed for viewing connection details.
- */
-const getConnection = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/{graph_id}/connections/{connection_id}',
-        ...options
-    });
-};
-exports.getConnection = getConnection;
 /**
  * List Connection Options
  * Get metadata about all available data connection providers.
@@ -1053,56 +912,159 @@ const oauthCallback = (options) => {
 };
 exports.oauthCallback = oauthCallback;
 /**
- * Query Financial Agent
- * AI-powered financial analysis with direct access to graph data.
+ * List Connections
+ * List all data connections in the graph.
  *
- * This endpoint provides intelligent financial analysis using an AI agent that can:
- * - Analyze entity financial statements and SEC filings
- * - Review QuickBooks transactions and accounting data
- * - Perform multi-period trend analysis
- * - Generate insights from balance sheets and income statements
- * - Answer complex financial queries with contextual understanding
+ * Returns active and inactive connections with their current status.
+ * Connections can be filtered by:
+ * - **Entity**: Show connections for a specific entity
+ * - **Provider**: Filter by connection type (sec, quickbooks, plaid)
  *
- * **Execution Modes:**
- * - **Quick Analysis** (default): Synchronous responses for simple queries (1-2 tool calls)
- * - **Extended Analysis**: Asynchronous processing for complex research (returns operation_id for SSE monitoring)
+ * Each connection shows:
+ * - Current sync status and health
+ * - Last successful sync timestamp
+ * - Configuration metadata
+ * - Error messages if any
  *
- * **Extended Analysis Monitoring:**
- * For complex queries, connect to the SSE stream for real-time progress:
- * ```javascript
- * const eventSource = new EventSource('/v1/operations/{operation_id}/stream');
- * eventSource.onmessage = (event) => {
- * const data = JSON.parse(event.data);
- * console.log('Analysis:', data.message);
- * };
- * ```
+ * No credits are consumed for listing connections.
+ */
+const listConnections = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/connections',
+        ...options
+    });
+};
+exports.listConnections = listConnections;
+/**
+ * Create Connection
+ * Create a new data connection for external system integration.
  *
- * **SSE Connection Limits:**
- * - Maximum 5 concurrent SSE connections per user
- * - Rate limited to 10 new connections per minute
- * - Automatic circuit breaker for Redis failures
- * - Graceful degradation with fallback to polling if SSE unavailable
+ * This endpoint initiates connections to external data sources:
  *
- * **Events Emitted:**
- * - `operation_started`: Analysis begins
- * - `operation_progress`: Tool calls, analysis steps
- * - `operation_completed`: Final comprehensive analysis
- * - `operation_error`: Analysis failed
+ * **SEC Connections**:
+ * - Provide entity CIK for automatic filing retrieval
+ * - No authentication needed
+ * - Begins immediate data sync
  *
- * **Error Handling:**
- * - `429 Too Many Requests`: SSE connection limit exceeded
- * - `503 Service Unavailable`: SSE system temporarily disabled
- * - Fallback to status polling endpoint if SSE unavailable
+ * **QuickBooks Connections**:
+ * - Returns OAuth URL for authorization
+ * - Requires admin permissions in QuickBooks
+ * - Complete with OAuth callback
  *
- * **Credit Consumption:**
- * - AI operations consume credits based on actual token usage
- * - Claude 4/4.1 Opus: ~15 credits per 1K input tokens, ~75 credits per 1K output tokens
- * - Claude 4 Sonnet: ~3 credits per 1K input tokens, ~15 credits per 1K output tokens
- * - Credits are consumed after operation completes based on actual usage
+ * **Plaid Connections**:
+ * - Returns Plaid Link token
+ * - User completes bank authentication
+ * - Exchange public token for access
+ *
+ * Note:
+ * This operation is FREE - no credit consumption required.
+ */
+const createConnection = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/connections',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createConnection = createConnection;
+/**
+ * Delete Connection
+ * Delete a data connection and clean up related resources.
+ *
+ * This operation:
+ * - Removes the connection configuration
+ * - Preserves any imported data in the graph
+ * - Performs provider-specific cleanup
+ * - Revokes stored credentials
+ *
+ * Note:
+ * This operation is FREE - no credit consumption required.
+ *
+ * Only users with admin role can delete connections.
+ */
+const deleteConnection = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/connections/{connection_id}',
+        ...options
+    });
+};
+exports.deleteConnection = deleteConnection;
+/**
+ * Get Connection
+ * Get detailed information about a specific connection.
+ *
+ * Returns comprehensive connection details including:
+ * - Current status and health indicators
+ * - Authentication state
+ * - Sync history and statistics
+ * - Error details if any
+ * - Provider-specific metadata
+ *
+ * No credits are consumed for viewing connection details.
+ */
+const getConnection = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/connections/{connection_id}',
+        ...options
+    });
+};
+exports.getConnection = getConnection;
+/**
+ * Auto-select agent for query
+ * Automatically select the best agent for your query.
  *
- * The agent automatically determines query complexity or you can force extended analysis.
+ * The orchestrator will:
+ * 1. Enrich context with RAG if enabled
+ * 2. Evaluate all available agents
+ * 3. Select the best match based on confidence scores
+ * 4. Execute the query with the selected agent
+ *
+ * Use this endpoint when you want the system to intelligently route your query.
  */
-const queryFinancialAgent = (options) => {
+const autoSelectAgent = (options) => {
     return (options.client ?? client_gen_1.client).post({
         security: [
             {
@@ -1122,7 +1084,175 @@ const queryFinancialAgent = (options) => {
         }
     });
 };
-exports.queryFinancialAgent = queryFinancialAgent;
+exports.autoSelectAgent = autoSelectAgent;
+/**
+ * Execute specific agent
+ * Execute a specific agent type directly.
+ *
+ * Available agents:
+ * - **financial**: Financial analysis, SEC filings, accounting data
+ * - **research**: Deep research and comprehensive analysis
+ * - **rag**: Fast retrieval without AI (no credits required)
+ *
+ * Use this endpoint when you know which agent you want to use.
+ */
+const executeSpecificAgent = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/agent/{agent_type}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.executeSpecificAgent = executeSpecificAgent;
+/**
+ * Batch process multiple queries
+ * Process multiple queries either sequentially or in parallel.
+ *
+ * **Features:**
+ * - Process up to 10 queries in a single request
+ * - Sequential or parallel execution modes
+ * - Automatic error handling per query
+ * - Credit checking before execution
+ *
+ * **Use Cases:**
+ * - Bulk analysis of multiple entities
+ * - Comparative analysis across queries
+ * - Automated report generation
+ *
+ * Returns individual results for each query with execution metrics.
+ */
+const batchProcessQueries = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/agent/batch',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.batchProcessQueries = batchProcessQueries;
+/**
+ * List available agents
+ * Get a comprehensive list of all available agents with their metadata.
+ *
+ * **Returns:**
+ * - Agent types and names
+ * - Capabilities and supported modes
+ * - Version information
+ * - Credit requirements
+ *
+ * Use the optional `capability` filter to find agents with specific capabilities.
+ */
+const listAgents = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/agent/list',
+        ...options
+    });
+};
+exports.listAgents = listAgents;
+/**
+ * Get agent metadata
+ * Get comprehensive metadata for a specific agent type.
+ *
+ * **Returns:**
+ * - Agent name and description
+ * - Version information
+ * - Supported capabilities and modes
+ * - Credit requirements
+ * - Author and tags
+ * - Configuration options
+ *
+ * Use this to understand agent capabilities before execution.
+ */
+const getAgentMetadata = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/agent/{agent_type}/metadata',
+        ...options
+    });
+};
+exports.getAgentMetadata = getAgentMetadata;
+/**
+ * Get agent recommendations
+ * Get intelligent agent recommendations for a specific query.
+ *
+ * **How it works:**
+ * 1. Analyzes query content and structure
+ * 2. Evaluates agent capabilities
+ * 3. Calculates confidence scores
+ * 4. Returns ranked recommendations
+ *
+ * **Use this when:**
+ * - Unsure which agent to use
+ * - Need to understand agent suitability
+ * - Want confidence scores for decision making
+ *
+ * Returns top agents ranked by confidence with explanations.
+ */
+const recommendAgent = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/agent/recommend',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.recommendAgent = recommendAgent;
 /**
  * List MCP Tools
  * Get available Model Context Protocol tools for graph analysis.