@robosystems/client 0.1.15 → 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, 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, 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
@@ -443,7 +443,7 @@ export declare const oauthCallback: <ThrowOnError extends boolean = false>(optio
  *
  * **Credit Consumption:**
  * - AI operations consume credits based on actual token usage
- * - Claude 4 Opus: ~15 credits per 1K input tokens, ~75 credits per 1K output tokens
+ * - 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
  *
@@ -991,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.

package/sdk.gen.js

@@ -2,7 +2,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listBackups = exports.createBackup = exports.callMcpTool = exports.listMcpTools = exports.queryFinancialAgent = exports.oauthCallback = exports.initOAuth = exports.exchangeLinkToken = exports.createLinkToken = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.createConnection = exports.listConnections = exports.getConnectionOptions = exports.getRepositoryCredits = exports.getSharedRepositoryCredits = exports.cancelSharedRepositorySubscription = exports.upgradeSharedRepositorySubscription = exports.subscribeToSharedRepository = exports.getUserSharedSubscriptions = exports.getDetailedUserAnalytics = exports.getUserUsageOverview = exports.getAllSharedRepositoryLimits = exports.getSharedRepositoryLimits = 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.checkPasswordStrength = exports.getPasswordPolicy = exports.getCaptchaConfig = 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.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.getCreditBillingInfoV1GraphIdBillingCreditsGet = exports.getAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGet = exports.getGraphSubscriptionV1GraphIdBillingSubscriptionGet = exports.upgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePost = exports.getGraphPricingInfoV1GraphIdBillingPricingGet = exports.getGraphUsageDetails = exports.getGraphBillingHistory = exports.getGraphMonthlyBill = exports.getCurrentGraphBill = exports.listSchemaExtensions = exports.exportGraphSchema = exports.validateSchema = exports.getGraphSchemaInfo = exports.executeCypherQuery = exports.getGraphUsageStats = exports.getGraphMetrics = exports.getBackupDownloadUrl = exports.kuzuBackupHealth = exports.getBackupStats = exports.restoreBackup = exports.exportBackup = void 0;
+exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.getAvailableExtensions = exports.createGraph = exports.getSubgraphInfo = exports.getSubgraphQuota = exports.deleteSubgraph = exports.createSubgraph = exports.listSubgraphs = exports.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.getCreditBillingInfoV1GraphIdBillingCreditsGet = exports.getAvailableSubscriptionPlansV1GraphIdBillingAvailablePlansGet = exports.getGraphSubscriptionV1GraphIdBillingSubscriptionGet = exports.upgradeGraphSubscriptionV1GraphIdBillingSubscriptionUpgradePost = exports.getGraphPricingInfoV1GraphIdBillingPricingGet = exports.getGraphUsageDetails = exports.getGraphBillingHistory = exports.getGraphMonthlyBill = exports.getCurrentGraphBill = exports.listSchemaExtensions = exports.exportGraphSchema = exports.validateSchema = exports.getGraphSchemaInfo = exports.executeCypherQuery = exports.getGraphUsageStats = exports.getGraphMetrics = exports.getBackupDownloadUrl = exports.kuzuBackupHealth = exports.getBackupStats = exports.restoreBackup = exports.exportBackup = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Register New User
@@ -1096,7 +1096,7 @@ exports.oauthCallback = oauthCallback;
  *
  * **Credit Consumption:**
  * - AI operations consume credits based on actual token usage
- * - Claude 4 Opus: ~15 credits per 1K input tokens, ~75 credits per 1K output tokens
+ * - 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
  *
@@ -2208,6 +2208,220 @@ const getDatabaseInfo = (options) => {
     });
 };
 exports.getDatabaseInfo = getDatabaseInfo;
+/**
+ * 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
+ */
+const listSubgraphs = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/subgraphs',
+        ...options
+    });
+};
+exports.listSubgraphs = listSubgraphs;
+/**
+ * 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
+ */
+const createSubgraph = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/subgraphs',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createSubgraph = createSubgraph;
+/**
+ * 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`
+ */
+const deleteSubgraph = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/subgraphs/{subgraph_name}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.deleteSubgraph = deleteSubgraph;
+/**
+ * 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.
+ */
+const getSubgraphQuota = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/subgraphs/quota',
+        ...options
+    });
+};
+exports.getSubgraphQuota = getSubgraphQuota;
+/**
+ * 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
+ */
+const getSubgraphInfo = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/{graph_id}/subgraphs/{subgraph_name}/info',
+        ...options
+    });
+};
+exports.getSubgraphInfo = getSubgraphInfo;
 /**
  * Create New Graph Database
  * Create a new graph database with specified schema and optionally an initial entity.