@robosystems/client 0.1.14 → 0.1.16

package/sdk-extensions/index.ts

@@ -0,0 +1,123 @@
+/**
+ * RoboSystems SDK Extensions
+ * Enhanced clients with SSE support for the RoboSystems API
+ */
+
+import { client } from '../sdk/client.gen'
+import { OperationClient } from './OperationClient'
+import { QueryClient } from './QueryClient'
+import { SSEClient } from './SSEClient'
+
+export interface RoboSystemsExtensionConfig {
+  baseUrl?: string
+  credentials?: 'include' | 'same-origin' | 'omit'
+  maxRetries?: number
+  retryDelay?: number
+}
+
+export class RoboSystemsExtensions {
+  public readonly query: QueryClient
+  public readonly operations: OperationClient
+  private config: Required<RoboSystemsExtensionConfig>
+
+  constructor(config: RoboSystemsExtensionConfig = {}) {
+    // Get base URL from SDK client config or use provided/default
+    const sdkConfig = client.getConfig()
+
+    this.config = {
+      baseUrl: config.baseUrl || sdkConfig.baseUrl || 'http://localhost:8000',
+      credentials: config.credentials || 'include',
+      maxRetries: config.maxRetries || 5,
+      retryDelay: config.retryDelay || 1000,
+    }
+
+    this.query = new QueryClient({
+      baseUrl: this.config.baseUrl,
+      credentials: this.config.credentials,
+    })
+
+    this.operations = new OperationClient({
+      baseUrl: this.config.baseUrl,
+      credentials: this.config.credentials,
+    })
+  }
+
+  /**
+   * Convenience method to monitor any operation
+   */
+  async monitorOperation(operationId: string, onProgress?: (progress: any) => void): Promise<any> {
+    return this.operations.monitorOperation(operationId, { onProgress })
+  }
+
+  /**
+   * Create custom SSE client for advanced use cases
+   */
+  createSSEClient(): SSEClient {
+    return new SSEClient({
+      baseUrl: this.config.baseUrl,
+      credentials: this.config.credentials,
+      maxRetries: this.config.maxRetries,
+      retryDelay: this.config.retryDelay,
+    })
+  }
+
+  /**
+   * Clean up all active connections
+   */
+  close(): void {
+    this.query.close()
+    this.operations.closeAll()
+  }
+}
+
+// Export all types and classes
+export * from './OperationClient'
+export * from './QueryClient'
+export * from './SSEClient'
+export { OperationClient, QueryClient, SSEClient }
+
+// Export React hooks
+export {
+  useMultipleOperations,
+  useOperation,
+  useQuery,
+  useSDKClients,
+  useStreamingQuery,
+} from './hooks'
+
+// Lazy initialization of default instance
+let _extensions: RoboSystemsExtensions | null = null
+
+function getExtensions(): RoboSystemsExtensions {
+  if (!_extensions) {
+    _extensions = new RoboSystemsExtensions()
+  }
+  return _extensions
+}
+
+export const extensions = {
+  get query() {
+    return getExtensions().query
+  },
+  get operations() {
+    return getExtensions().operations
+  },
+  monitorOperation: (operationId: string, onProgress?: (progress: any) => void) =>
+    getExtensions().monitorOperation(operationId, onProgress),
+  createSSEClient: () => getExtensions().createSSEClient(),
+  close: () => getExtensions().close(),
+}
+
+// Export convenience functions that use the default instance
+export const monitorOperation = (operationId: string, onProgress?: (progress: any) => void) =>
+  getExtensions().monitorOperation(operationId, onProgress)
+
+export const executeQuery = (graphId: string, query: string, parameters?: Record<string, any>) =>
+  getExtensions().query.query(graphId, query, parameters)
+
+export const streamQuery = (
+  graphId: string,
+  query: string,
+  parameters?: Record<string, any>,
+  chunkSize?: number
+) => getExtensions().query.streamQuery(graphId, query, parameters, chunkSize)

package/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from './client';
-import type { RegisterUserData, RegisterUserResponses, RegisterUserErrors, LoginUserData, LoginUserResponses, LoginUserErrors, LogoutUserData, LogoutUserResponses, LogoutUserErrors, GetCurrentAuthUserData, GetCurrentAuthUserResponses, GetCurrentAuthUserErrors, RefreshSessionData, RefreshSessionResponses, RefreshSessionErrors, GenerateSsoTokenData, GenerateSsoTokenResponses, GenerateSsoTokenErrors, SsoLoginData, SsoLoginResponses, SsoLoginErrors, SsoTokenExchangeData, SsoTokenExchangeResponses, SsoTokenExchangeErrors, CompleteSsoAuthData, CompleteSsoAuthResponses, CompleteSsoAuthErrors, GetCaptchaConfigData, GetCaptchaConfigResponses, GetPasswordPolicyData, GetPasswordPolicyResponses, CheckPasswordStrengthData, CheckPasswordStrengthResponses, CheckPasswordStrengthErrors, GetServiceStatusData, GetServiceStatusResponses, GetMcpHealthData, GetMcpHealthResponses, GetCurrentUserData, GetCurrentUserResponses, GetCurrentUserErrors, UpdateUserData, UpdateUserResponses, UpdateUserErrors, GetUserGraphsData, GetUserGraphsResponses, GetUserGraphsErrors, SelectUserGraphData, SelectUserGraphResponses, SelectUserGraphErrors, GetAllCreditSummariesData, GetAllCreditSummariesResponses, GetAllCreditSummariesErrors, UpdateUserPasswordData, UpdateUserPasswordResponses, UpdateUserPasswordErrors, ListUserApiKeysData, ListUserApiKeysResponses, ListUserApiKeysErrors, CreateUserApiKeyData, CreateUserApiKeyResponses, CreateUserApiKeyErrors, RevokeUserApiKeyData, RevokeUserApiKeyResponses, RevokeUserApiKeyErrors, UpdateUserApiKeyData, UpdateUserApiKeyResponses, UpdateUserApiKeyErrors, GetUserLimitsData, GetUserLimitsResponses, GetUserLimitsErrors, GetUserUsageData, GetUserUsageResponses, GetUserUsageErrors, GetUserUsageOverviewData, GetUserUsageOverviewResponses, GetUserUsageOverviewErrors, GetDetailedUserAnalyticsData, GetDetailedUserAnalyticsResponses, GetDetailedUserAnalyticsErrors, GetUserSharedSubscriptionsData, GetUserSharedSubscriptionsResponses, GetUserSharedSubscriptionsErrors, SubscribeToSharedRepositoryData, SubscribeToSharedRepositoryResponses, SubscribeToSharedRepositoryErrors, UpgradeSharedRepositorySubscriptionData, UpgradeSharedRepositorySubscriptionResponses, UpgradeSharedRepositorySubscriptionErrors, CancelSharedRepositorySubscriptionData, CancelSharedRepositorySubscriptionResponses, CancelSharedRepositorySubscriptionErrors, GetSharedRepositoryCreditsData, GetSharedRepositoryCreditsResponses, GetSharedRepositoryCreditsErrors, GetRepositoryCreditsData, GetRepositoryCreditsResponses, GetRepositoryCreditsErrors, GetConnectionOptionsData, GetConnectionOptionsResponses, GetConnectionOptionsErrors, ListConnectionsData, ListConnectionsResponses, ListConnectionsErrors, CreateConnectionData, CreateConnectionResponses, CreateConnectionErrors, DeleteConnectionData, DeleteConnectionResponses, DeleteConnectionErrors, GetConnectionData, GetConnectionResponses, GetConnectionErrors, SyncConnectionData, SyncConnectionResponses, SyncConnectionErrors, CreateLinkTokenData, CreateLinkTokenResponses, CreateLinkTokenErrors, ExchangeLinkTokenData, ExchangeLinkTokenResponses, ExchangeLinkTokenErrors, InitOAuthData, InitOAuthResponses, InitOAuthErrors, OauthCallbackData, OauthCallbackResponses, OauthCallbackErrors, QueryFinancialAgentData, QueryFinancialAgentResponses, QueryFinancialAgentErrors, ListMcpToolsData, ListMcpToolsResponses, ListMcpToolsErrors, CallMcpToolData, CallMcpToolResponses, CallMcpToolErrors, CreateBackupData, CreateBackupResponses, CreateBackupErrors, ListBackupsData, ListBackupsResponses, ListBackupsErrors, ExportBackupData, ExportBackupResponses, ExportBackupErrors, RestoreBackupData, RestoreBackupResponses, RestoreBackupErrors, GetBackupStatsData, GetBackupStatsResponses, GetBackupStatsErrors, KuzuBackupHealthData, KuzuBackupHealthResponses, KuzuBackupHealthErrors, GetBackupDownloadUrlData, GetBackupDownloadUrlResponses, GetBackupDownloadUrlErrors, GetGraphMetricsData, GetGraphMetricsResponses, GetGraphMetricsErrors, GetGraphUsageStatsData, GetGraphUsageStatsResponses, GetGraphUsageStatsErrors, ExecuteCypherQueryData, ExecuteCypherQueryResponses, ExecuteCypherQueryErrors, GetGraphSchemaInfoData, GetGraphSchemaInfoResponses, GetGraphSchemaInfoErrors, ValidateSchemaData, ValidateSchemaResponses, ValidateSchemaErrors, ExportGraphSchemaData, ExportGraphSchemaResponses, ExportGraphSchemaErrors, ListSchemaExtensionsData, ListSchemaExtensionsResponses, ListSchemaExtensionsErrors, GetCurrentGraphBillData, GetCurrentGraphBillResponses, GetCurrentGraphBillErrors, GetGraphMonthlyBillData, GetGraphMonthlyBillResponses, GetGraphMonthlyBillErrors, GetGraphBillingHistoryData, GetGraphBillingHistoryResponses, GetGraphBillingHistoryErrors, GetGraphUsageDetailsData, GetGraphUsageDetailsResponses, GetGraphUsageDetailsErrors, GetGraphPricingInfoV1GraphIdBillingPricingGetData, GetGraphPricingInfoV1GraphIdBillingPricingGetResponses, GetGraphPricingInfoV1GraphIdBillingPricingGetErrors, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostData, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostResponses, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostErrors, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetData, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetResponses, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetErrors, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetData, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetResponses, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetErrors, GetCreditBillingInfoV1GraphIdBillingCreditsGetData, GetCreditBillingInfoV1GraphIdBillingCreditsGetResponses, GetCreditBillingInfoV1GraphIdBillingCreditsGetErrors, GetCreditSummaryData, GetCreditSummaryResponses, GetCreditSummaryErrors, ListCreditTransactionsData, ListCreditTransactionsResponses, ListCreditTransactionsErrors, CheckCreditBalanceData, CheckCreditBalanceResponses, CheckCreditBalanceErrors, GetStorageUsageData, GetStorageUsageResponses, GetStorageUsageErrors, CheckStorageLimitsData, CheckStorageLimitsResponses, CheckStorageLimitsErrors, GetDatabaseHealthData, GetDatabaseHealthResponses, GetDatabaseHealthErrors, GetDatabaseInfoData, GetDatabaseInfoResponses, GetDatabaseInfoErrors, CreateGraphData, CreateGraphResponses, CreateGraphErrors, GetAvailableExtensionsData, GetAvailableExtensionsResponses, GetServiceOfferingsData, GetServiceOfferingsResponses, GetServiceOfferingsErrors, StreamOperationEventsData, StreamOperationEventsResponses, StreamOperationEventsErrors, GetOperationStatusData, GetOperationStatusResponses, GetOperationStatusErrors, CancelOperationData, CancelOperationResponses, CancelOperationErrors } from './types.gen';
+import type { RegisterUserData, RegisterUserResponses, RegisterUserErrors, LoginUserData, LoginUserResponses, LoginUserErrors, LogoutUserData, LogoutUserResponses, LogoutUserErrors, GetCurrentAuthUserData, GetCurrentAuthUserResponses, GetCurrentAuthUserErrors, RefreshSessionData, RefreshSessionResponses, RefreshSessionErrors, GenerateSsoTokenData, GenerateSsoTokenResponses, GenerateSsoTokenErrors, SsoLoginData, SsoLoginResponses, SsoLoginErrors, SsoTokenExchangeData, SsoTokenExchangeResponses, SsoTokenExchangeErrors, CompleteSsoAuthData, CompleteSsoAuthResponses, CompleteSsoAuthErrors, GetCaptchaConfigData, GetCaptchaConfigResponses, GetPasswordPolicyData, GetPasswordPolicyResponses, CheckPasswordStrengthData, CheckPasswordStrengthResponses, CheckPasswordStrengthErrors, GetServiceStatusData, GetServiceStatusResponses, GetCurrentUserData, GetCurrentUserResponses, GetCurrentUserErrors, UpdateUserData, UpdateUserResponses, UpdateUserErrors, GetUserGraphsData, GetUserGraphsResponses, GetUserGraphsErrors, SelectUserGraphData, SelectUserGraphResponses, SelectUserGraphErrors, GetAllCreditSummariesData, GetAllCreditSummariesResponses, GetAllCreditSummariesErrors, UpdateUserPasswordData, UpdateUserPasswordResponses, UpdateUserPasswordErrors, ListUserApiKeysData, ListUserApiKeysResponses, ListUserApiKeysErrors, CreateUserApiKeyData, CreateUserApiKeyResponses, CreateUserApiKeyErrors, RevokeUserApiKeyData, RevokeUserApiKeyResponses, RevokeUserApiKeyErrors, UpdateUserApiKeyData, UpdateUserApiKeyResponses, UpdateUserApiKeyErrors, GetUserLimitsData, GetUserLimitsResponses, GetUserLimitsErrors, GetUserUsageData, GetUserUsageResponses, GetUserUsageErrors, GetSharedRepositoryLimitsData, GetSharedRepositoryLimitsResponses, GetSharedRepositoryLimitsErrors, GetAllSharedRepositoryLimitsData, GetAllSharedRepositoryLimitsResponses, GetAllSharedRepositoryLimitsErrors, GetUserUsageOverviewData, GetUserUsageOverviewResponses, GetUserUsageOverviewErrors, GetDetailedUserAnalyticsData, GetDetailedUserAnalyticsResponses, GetDetailedUserAnalyticsErrors, GetUserSharedSubscriptionsData, GetUserSharedSubscriptionsResponses, GetUserSharedSubscriptionsErrors, SubscribeToSharedRepositoryData, SubscribeToSharedRepositoryResponses, SubscribeToSharedRepositoryErrors, UpgradeSharedRepositorySubscriptionData, UpgradeSharedRepositorySubscriptionResponses, UpgradeSharedRepositorySubscriptionErrors, CancelSharedRepositorySubscriptionData, CancelSharedRepositorySubscriptionResponses, CancelSharedRepositorySubscriptionErrors, GetSharedRepositoryCreditsData, GetSharedRepositoryCreditsResponses, GetSharedRepositoryCreditsErrors, GetRepositoryCreditsData, GetRepositoryCreditsResponses, GetRepositoryCreditsErrors, GetConnectionOptionsData, GetConnectionOptionsResponses, GetConnectionOptionsErrors, ListConnectionsData, ListConnectionsResponses, ListConnectionsErrors, CreateConnectionData, CreateConnectionResponses, CreateConnectionErrors, DeleteConnectionData, DeleteConnectionResponses, DeleteConnectionErrors, GetConnectionData, GetConnectionResponses, GetConnectionErrors, SyncConnectionData, SyncConnectionResponses, SyncConnectionErrors, CreateLinkTokenData, CreateLinkTokenResponses, CreateLinkTokenErrors, ExchangeLinkTokenData, ExchangeLinkTokenResponses, ExchangeLinkTokenErrors, InitOAuthData, InitOAuthResponses, InitOAuthErrors, OauthCallbackData, OauthCallbackResponses, OauthCallbackErrors, QueryFinancialAgentData, QueryFinancialAgentResponses, QueryFinancialAgentErrors, ListMcpToolsData, ListMcpToolsResponses, ListMcpToolsErrors, CallMcpToolData, CallMcpToolResponses, CallMcpToolErrors, CreateBackupData, CreateBackupResponses, CreateBackupErrors, ListBackupsData, ListBackupsResponses, ListBackupsErrors, ExportBackupData, ExportBackupResponses, ExportBackupErrors, RestoreBackupData, RestoreBackupResponses, RestoreBackupErrors, GetBackupStatsData, GetBackupStatsResponses, GetBackupStatsErrors, KuzuBackupHealthData, KuzuBackupHealthResponses, KuzuBackupHealthErrors, GetBackupDownloadUrlData, GetBackupDownloadUrlResponses, GetBackupDownloadUrlErrors, GetGraphMetricsData, GetGraphMetricsResponses, GetGraphMetricsErrors, GetGraphUsageStatsData, GetGraphUsageStatsResponses, GetGraphUsageStatsErrors, ExecuteCypherQueryData, ExecuteCypherQueryResponses, ExecuteCypherQueryErrors, GetGraphSchemaInfoData, GetGraphSchemaInfoResponses, GetGraphSchemaInfoErrors, ValidateSchemaData, ValidateSchemaResponses, ValidateSchemaErrors, ExportGraphSchemaData, ExportGraphSchemaResponses, ExportGraphSchemaErrors, ListSchemaExtensionsData, ListSchemaExtensionsResponses, ListSchemaExtensionsErrors, GetCurrentGraphBillData, GetCurrentGraphBillResponses, GetCurrentGraphBillErrors, GetGraphMonthlyBillData, GetGraphMonthlyBillResponses, GetGraphMonthlyBillErrors, GetGraphBillingHistoryData, GetGraphBillingHistoryResponses, GetGraphBillingHistoryErrors, GetGraphUsageDetailsData, GetGraphUsageDetailsResponses, GetGraphUsageDetailsErrors, GetGraphPricingInfoV1GraphIdBillingPricingGetData, GetGraphPricingInfoV1GraphIdBillingPricingGetResponses, GetGraphPricingInfoV1GraphIdBillingPricingGetErrors, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostData, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostResponses, UpgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePostErrors, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetData, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetResponses, GetGraphSubscriptionV1GraphIdBillingSubscriptionGetErrors, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetData, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetResponses, GetAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGetErrors, GetCreditBillingInfoV1GraphIdBillingCreditsGetData, GetCreditBillingInfoV1GraphIdBillingCreditsGetResponses, GetCreditBillingInfoV1GraphIdBillingCreditsGetErrors, GetCreditSummaryData, GetCreditSummaryResponses, GetCreditSummaryErrors, ListCreditTransactionsData, ListCreditTransactionsResponses, ListCreditTransactionsErrors, CheckCreditBalanceData, CheckCreditBalanceResponses, CheckCreditBalanceErrors, GetStorageUsageData, GetStorageUsageResponses, GetStorageUsageErrors, CheckStorageLimitsData, CheckStorageLimitsResponses, CheckStorageLimitsErrors, GetDatabaseHealthData, GetDatabaseHealthResponses, GetDatabaseHealthErrors, GetDatabaseInfoData, GetDatabaseInfoResponses, GetDatabaseInfoErrors, ListSubgraphsData, ListSubgraphsResponses, ListSubgraphsErrors, CreateSubgraphData, CreateSubgraphResponses, CreateSubgraphErrors, DeleteSubgraphData, DeleteSubgraphResponses, DeleteSubgraphErrors, GetSubgraphQuotaData, GetSubgraphQuotaResponses, GetSubgraphQuotaErrors, GetSubgraphInfoData, GetSubgraphInfoResponses, GetSubgraphInfoErrors, CreateGraphData, CreateGraphResponses, CreateGraphErrors, GetAvailableExtensionsData, GetAvailableExtensionsResponses, GetServiceOfferingsData, GetServiceOfferingsResponses, GetServiceOfferingsErrors, StreamOperationEventsData, StreamOperationEventsResponses, StreamOperationEventsErrors, GetOperationStatusData, GetOperationStatusResponses, GetOperationStatusErrors, CancelOperationData, CancelOperationResponses, CancelOperationErrors } from './types.gen';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -78,11 +78,6 @@ export declare const checkPasswordStrength: <ThrowOnError extends boolean = fals
  * Service health check endpoint for monitoring and load balancers
  */
 export declare const getServiceStatus: <ThrowOnError extends boolean = false>(options?: Options<GetServiceStatusData, ThrowOnError>) => import("./client").RequestResult<GetServiceStatusResponses, unknown, ThrowOnError, "fields">;
-/**
- * MCP System Health Check
- * Basic health check for MCP system components
- */
-export declare const getMcpHealth: <ThrowOnError extends boolean = false>(options?: Options<GetMcpHealthData, ThrowOnError>) => import("./client").RequestResult<GetMcpHealthResponses, unknown, ThrowOnError, "fields">;
 /**
  * Get Current User
  * Returns information about the currently authenticated user.
@@ -149,6 +144,24 @@ export declare const getUserLimits: <ThrowOnError extends boolean = false>(optio
  * Retrieve current usage statistics and remaining limits for the authenticated user
  */
 export declare const getUserUsage: <ThrowOnError extends boolean = false>(options?: Options<GetUserUsageData, ThrowOnError>) => import("./client").RequestResult<GetUserUsageResponses, GetUserUsageErrors, ThrowOnError, "fields">;
+/**
+ * Get shared repository rate limit status
+ * Get current rate limit status and usage for a shared repository.
+ *
+ * Returns:
+ * - Current usage across different time windows
+ * - Rate limits based on subscription tier
+ * - Remaining quota
+ * - Reset times
+ *
+ * Note: All queries are FREE - this only shows rate limit status.
+ */
+export declare const getSharedRepositoryLimits: <ThrowOnError extends boolean = false>(options: Options<GetSharedRepositoryLimitsData, ThrowOnError>) => import("./client").RequestResult<GetSharedRepositoryLimitsResponses, GetSharedRepositoryLimitsErrors, ThrowOnError, "fields">;
+/**
+ * Get all shared repository limits
+ * Get rate limit status for all shared repositories the user has access to.
+ */
+export declare const getAllSharedRepositoryLimits: <ThrowOnError extends boolean = false>(options?: Options<GetAllSharedRepositoryLimitsData, ThrowOnError>) => import("./client").RequestResult<GetAllSharedRepositoryLimitsResponses, GetAllSharedRepositoryLimitsErrors, ThrowOnError, "fields">;
 /**
  * Get User Usage Overview
  * Get a high-level overview of usage statistics for the current user.
@@ -186,7 +199,7 @@ export declare const cancelSharedRepositorySubscription: <ThrowOnError extends b
 export declare const getSharedRepositoryCredits: <ThrowOnError extends boolean = false>(options?: Options<GetSharedRepositoryCreditsData, ThrowOnError>) => import("./client").RequestResult<GetSharedRepositoryCreditsResponses, GetSharedRepositoryCreditsErrors, ThrowOnError, "fields">;
 /**
  * Get Repository Credits
- * Get credit balance for a specific shared repository type
+ * Get credit balance for a specific shared repository
  */
 export declare const getRepositoryCredits: <ThrowOnError extends boolean = false>(options: Options<GetRepositoryCreditsData, ThrowOnError>) => import("./client").RequestResult<GetRepositoryCreditsResponses, GetRepositoryCreditsErrors, ThrowOnError, "fields">;
 /**
@@ -252,10 +265,8 @@ export declare const listConnections: <ThrowOnError extends boolean = false>(opt
  * - User completes bank authentication
  * - Exchange public token for access
  *
- * Credit consumption:
- * - Base cost: 5.0 credits
- * - Multiplied by graph tier
- * - Additional credits consumed during data sync
+ * Note:
+ * This operation is FREE - no credit consumption required.
  */
 export declare const createConnection: <ThrowOnError extends boolean = false>(options: Options<CreateConnectionData, ThrowOnError>) => import("./client").RequestResult<CreateConnectionResponses, CreateConnectionErrors, ThrowOnError, "fields">;
 /**
@@ -268,9 +279,8 @@ export declare const createConnection: <ThrowOnError extends boolean = false>(op
  * - Performs provider-specific cleanup
  * - Revokes stored credentials
  *
- * Credit consumption:
- * - Base cost: 2.0 credits
- * - Multiplied by graph tier
+ * Note:
+ * This operation is FREE - no credit consumption required.
  *
  * Only users with admin role can delete connections.
  */
@@ -311,10 +321,8 @@ export declare const getConnection: <ThrowOnError extends boolean = false>(optio
  * - Updates account balances
  * - Categorizes new transactions
  *
- * Credit consumption:
- * - Base cost: 20.0 credits
- * - Multiplied by graph tier
- * - Additional credits may be consumed during processing
+ * Note:
+ * This operation is FREE - no credit consumption required.
  *
  * Returns a task ID for monitoring sync progress.
  */
@@ -434,10 +442,10 @@ export declare const oauthCallback: <ThrowOnError extends boolean = false>(optio
  * - Fallback to status polling endpoint if SSE unavailable
  *
  * **Credit Consumption:**
- * - Variable based on complexity: 3-60 credits
- * - Simple queries: 3-15 credits
- * - Complex analysis: 15-60 credits
- * - Multiplied by graph tier (standard=1x, enterprise=2x, premium=4x)
+ * - 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
  *
  * The agent automatically determines query complexity or you can force extended analysis.
  */
@@ -495,11 +503,8 @@ export declare const listMcpTools: <ThrowOnError extends boolean = false>(option
  * - `408 Request Timeout`: Tool execution exceeded timeout
  * - Clients should implement exponential backoff on errors
  *
- * **Credit Consumption:**
- * - Simple tools: 2-5 credits
- * - Schema tools: 5-10 credits
- * - Query tools: 10-50 credits (based on complexity)
- * - Multiplied by graph tier
+ * **Note:**
+ * MCP tool calls are currently FREE and do not consume credits.
  */
 export declare const callMcpTool: <ThrowOnError extends boolean = false>(options: Options<CallMcpToolData, ThrowOnError>) => import("./client").RequestResult<CallMcpToolResponses, CallMcpToolErrors, ThrowOnError, "fields">;
 /**
@@ -636,9 +641,8 @@ export declare const getBackupDownloadUrl: <ThrowOnError extends boolean = false
  * - Capacity planning
  * - Performance optimization
  *
- * Credit consumption:
- * - Base cost: 15.0 credits
- * - Multiplied by graph tier (standard=1x, enterprise=2x, premium=4x)
+ * Note:
+ * This operation is FREE - no credit consumption required.
  */
 export declare const getGraphMetrics: <ThrowOnError extends boolean = false>(options: Options<GetGraphMetricsData, ThrowOnError>) => import("./client").RequestResult<GetGraphMetricsResponses, GetGraphMetricsErrors, ThrowOnError, "fields">;
 /**
@@ -664,9 +668,8 @@ export declare const getGraphMetrics: <ThrowOnError extends boolean = false>(opt
  * - Usage trend analysis
  * - Performance tuning
  *
- * Credit consumption:
- * - Base cost: 10.0 credits
- * - Multiplied by graph tier
+ * Note:
+ * This operation is FREE - no credit consumption required.
  */
 export declare const getGraphUsageStats: <ThrowOnError extends boolean = false>(options: Options<GetGraphUsageStatsData, ThrowOnError>) => import("./client").RequestResult<GetGraphUsageStatsResponses, GetGraphUsageStatsErrors, ThrowOnError, "fields">;
 /**
@@ -682,7 +685,7 @@ export declare const getGraphUsageStats: <ThrowOnError extends boolean = false>(
  * **Response Modes:**
  * - `auto` (default): Intelligent automatic selection
  * - `sync`: Force synchronous JSON response (best for testing)
- * - `async`: Force queued response with polling URLs
+ * - `async`: Force queued response with SSE monitoring endpoints (no polling needed)
  * - `stream`: Force streaming response (SSE or NDJSON)
  *
  * **Client Detection:**
@@ -705,19 +708,19 @@ export declare const getGraphUsageStats: <ThrowOnError extends boolean = false>(
  *
  * **Queue Management:**
  * - Automatic queuing under high load
- * - SSE-based queue monitoring (no polling needed)
+ * - Real-time monitoring via SSE events (no polling needed)
  * - Priority based on subscription tier
- * - Queue position updates via SSE events
+ * - Queue position and progress updates pushed via SSE
+ * - Connect to returned `/v1/operations/{id}/stream` endpoint for updates
  *
  * **Error Handling:**
  * - `429 Too Many Requests`: Rate limit or connection limit exceeded
  * - `503 Service Unavailable`: Circuit breaker open or SSE disabled
  * - Clients should implement exponential backoff
  *
- * **Credit Consumption:**
- * - Variable based on query complexity: 1-50 credits
- * - Streaming queries charged per 1000 rows
- * - Queue position based on subscription tier
+ * **Note:**
+ * Query operations are FREE - no credit consumption required.
+ * Queue position is based on subscription tier for priority.
  */
 export declare const executeCypherQuery: <ThrowOnError extends boolean = false>(options: Options<ExecuteCypherQueryData, ThrowOnError>) => import("./client").RequestResult<ExecuteCypherQueryResponses, ExecuteCypherQueryErrors, ThrowOnError, "fields">;
 /**
@@ -732,10 +735,7 @@ export declare const executeCypherQuery: <ThrowOnError extends boolean = false>(
  * This is different from custom schema management - it shows what actually exists in the database,
  * useful for understanding the current graph structure before writing queries.
  *
- * Credit consumption:
- * - Base cost: 2.0 credits
- * - Multiplied by graph tier (standard=1x, enterprise=2x, premium=4x)
- * - Schema information is cached for performance
+ * This operation is FREE - no credit consumption required.
  */
 export declare const getGraphSchemaInfo: <ThrowOnError extends boolean = false>(options: Options<GetGraphSchemaInfoData, ThrowOnError>) => import("./client").RequestResult<GetGraphSchemaInfoResponses, GetGraphSchemaInfoErrors, ThrowOnError, "fields">;
 /**
@@ -761,9 +761,7 @@ export declare const getGraphSchemaInfo: <ThrowOnError extends boolean = false>(
  * - Performance problems
  * - Naming conflicts
  *
- * Credit consumption:
- * - Base cost: 5.0 credits
- * - Multiplied by graph tier
+ * This operation is FREE - no credit consumption required.
  */
 export declare const validateSchema: <ThrowOnError extends boolean = false>(options: Options<ValidateSchemaData, ThrowOnError>) => import("./client").RequestResult<ValidateSchemaResponses, ValidateSchemaErrors, ThrowOnError, "fields">;
 /**
@@ -993,6 +991,132 @@ export declare const getDatabaseHealth: <ThrowOnError extends boolean = false>(o
  * This endpoint provides essential database information for capacity planning and monitoring.
  */
 export declare const getDatabaseInfo: <ThrowOnError extends boolean = false>(options: Options<GetDatabaseInfoData, ThrowOnError>) => import("./client").RequestResult<GetDatabaseInfoResponses, GetDatabaseInfoErrors, ThrowOnError, "fields">;
+/**
+ * List Subgraphs
+ * List all subgraphs for a parent graph.
+ *
+ * **Requirements:**
+ * - User must have at least read access to parent graph
+ *
+ * **Response includes:**
+ * - List of all subgraphs with metadata
+ * - Current usage vs limits
+ * - Size and statistics per subgraph
+ * - Creation timestamps
+ *
+ * **Filtering:**
+ * Currently returns all subgraphs. Future versions will support:
+ * - Filtering by status
+ * - Filtering by creation date
+ * - Pagination for large lists
+ */
+export declare const listSubgraphs: <ThrowOnError extends boolean = false>(options: Options<ListSubgraphsData, ThrowOnError>) => import("./client").RequestResult<ListSubgraphsResponses, ListSubgraphsErrors, ThrowOnError, "fields">;
+/**
+ * Create New Subgraph
+ * Create a new subgraph database under an Enterprise or Premium parent graph.
+ *
+ * **Requirements:**
+ * - Parent graph must be Enterprise or Premium tier
+ * - User must have admin access to parent graph
+ * - Subgraph name must be unique within parent
+ * - Subgraph name must be alphanumeric (1-20 chars)
+ *
+ * **Subgraph Benefits:**
+ * - Shares parent's infrastructure (no additional cost)
+ * - Inherits parent's credit pool
+ * - Isolated database on same instance
+ * - Full Kuzu database capabilities
+ *
+ * **Use Cases:**
+ * - Separate environments (dev/staging/prod)
+ * - Department-specific data isolation
+ * - Multi-tenant applications
+ * - Testing and experimentation
+ *
+ * **Schema Inheritance:**
+ * - Subgraphs can use parent's schema or custom extensions
+ * - Extensions are additive only
+ * - Base schema always included
+ *
+ * **Limits:**
+ * - Standard: Not supported (0 subgraphs)
+ * - Enterprise: Configurable limit (default: 10 subgraphs)
+ * - Premium: Unlimited subgraphs
+ * - Limits are defined in deployment configuration
+ *
+ * **Response includes:**
+ * - `graph_id`: Full subgraph identifier
+ * - `parent_graph_id`: Parent graph ID
+ * - `subgraph_name`: Short name within parent
+ * - `status`: Creation status
+ */
+export declare const createSubgraph: <ThrowOnError extends boolean = false>(options: Options<CreateSubgraphData, ThrowOnError>) => import("./client").RequestResult<CreateSubgraphResponses, CreateSubgraphErrors, ThrowOnError, "fields">;
+/**
+ * Delete Subgraph
+ * Delete a subgraph database.
+ *
+ * **Requirements:**
+ * - Must be a valid subgraph (not parent graph)
+ * - User must have admin access to parent graph
+ * - Optional backup before deletion
+ *
+ * **Deletion Options:**
+ * - `force`: Delete even if contains data
+ * - `backup_first`: Create backup before deletion
+ *
+ * **Warning:**
+ * Deletion is permanent unless backup is created.
+ * All data in the subgraph will be lost.
+ *
+ * **Backup Location:**
+ * If backup requested, stored in S3 at:
+ * `s3://robosystems-backups/{instance_id}/{database_name}_{timestamp}.backup`
+ */
+export declare const deleteSubgraph: <ThrowOnError extends boolean = false>(options: Options<DeleteSubgraphData, ThrowOnError>) => import("./client").RequestResult<DeleteSubgraphResponses, DeleteSubgraphErrors, ThrowOnError, "fields">;
+/**
+ * Get Subgraph Quota
+ * Get subgraph quota and usage information for a parent graph.
+ *
+ * **Shows:**
+ * - Current subgraph count
+ * - Maximum allowed subgraphs per tier
+ * - Remaining capacity
+ * - Total size usage across all subgraphs
+ *
+ * **Tier Limits:**
+ * - Standard: 0 subgraphs (not supported)
+ * - Enterprise: Configurable limit (default: 10 subgraphs)
+ * - Premium: Unlimited subgraphs
+ * - Limits are defined in deployment configuration
+ *
+ * **Size Tracking:**
+ * Provides aggregate size metrics when available.
+ * Individual subgraph sizes shown in list endpoint.
+ */
+export declare const getSubgraphQuota: <ThrowOnError extends boolean = false>(options: Options<GetSubgraphQuotaData, ThrowOnError>) => import("./client").RequestResult<GetSubgraphQuotaResponses, GetSubgraphQuotaErrors, ThrowOnError, "fields">;
+/**
+ * Get Subgraph Details
+ * Get detailed information about a specific subgraph.
+ *
+ * **Requirements:**
+ * - User must have read access to parent graph
+ *
+ * **Response includes:**
+ * - Full subgraph metadata
+ * - Database statistics (nodes, edges)
+ * - Size information
+ * - Schema configuration
+ * - Creation/modification timestamps
+ * - Last access time (when available)
+ *
+ * **Statistics:**
+ * Real-time statistics queried from Kuzu:
+ * - Node count
+ * - Edge count
+ * - Database size on disk
+ * - Schema information
+ */
+export declare const getSubgraphInfo: <ThrowOnError extends boolean = false>(options: Options<GetSubgraphInfoData, ThrowOnError>) => import("./client").RequestResult<GetSubgraphInfoResponses, GetSubgraphInfoErrors, ThrowOnError, "fields">;
 /**
  * Create New Graph Database
  * Create a new graph database with specified schema and optionally an initial entity.
@@ -1051,7 +1175,7 @@ export declare const getAvailableExtensions: <ThrowOnError extends boolean = fal
  * applications to display subscription options.
  *
  * Includes:
- * - Graph subscription tiers (trial, standard, enterprise, premium)
+ * - Graph subscription tiers (standard, enterprise, premium)
  * - Shared repository subscriptions (SEC, industry, economic data)
  * - Operation costs and credit information
  * - Features and capabilities for each tier