@robosystems/client 0.2.7 → 0.2.9

package/sdk/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.batchProcessQueries = exports.executeSpecificAgent = exports.autoSelectAgent = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.oauthCallback = exports.initOAuth = exports.createLinkToken = exports.exchangeLinkToken = exports.getConnectionOptions = 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.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.completeSsoAuth = exports.ssoTokenExchange = exports.generateSsoToken = exports.resetPassword = exports.validateResetToken = exports.forgotPassword = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.verifyEmail = exports.resendVerificationEmail = exports.refreshAuthSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
-exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.selectGraph = exports.getAvailableGraphTiers = exports.getAvailableExtensions = exports.createGraph = exports.getGraphs = exports.queryTables = exports.ingestTables = exports.updateFileStatus = exports.getFileInfo = exports.deleteFile = exports.getUploadUrl = exports.listTableFiles = exports.listTables = 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.validateSchema = exports.exportGraphSchema = exports.getGraphSchema = exports.executeCypherQuery = exports.getGraphUsageStats = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = exports.getAgentMetadata = exports.listAgents = void 0;
+exports.getGraphUsageAnalytics = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = exports.getAgentMetadata = exports.listAgents = exports.batchProcessQueries = exports.executeSpecificAgent = exports.autoSelectAgent = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.oauthCallback = exports.initOAuth = exports.createLinkToken = exports.exchangeLinkToken = exports.getConnectionOptions = exports.createConnection = exports.listConnections = exports.getUserLimits = exports.updateUserApiKey = exports.revokeUserApiKey = exports.createUserApiKey = exports.listUserApiKeys = exports.updateUserPassword = exports.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.completeSsoAuth = exports.ssoTokenExchange = exports.generateSsoToken = exports.resetPassword = exports.validateResetToken = exports.forgotPassword = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.verifyEmail = exports.resendVerificationEmail = exports.refreshAuthSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
+exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.selectGraph = exports.getAvailableGraphTiers = exports.getAvailableExtensions = exports.createGraph = exports.getGraphs = exports.queryTables = exports.ingestTables = exports.updateFileStatus = exports.getFileInfo = exports.deleteFile = exports.getUploadUrl = exports.listTableFiles = exports.listTables = exports.upgradeSubscription = exports.createRepositorySubscription = exports.getGraphSubscription = exports.cancelSubscription = 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.validateSchema = exports.exportGraphSchema = exports.getGraphSchema = exports.executeCypherQuery = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Register New User
@@ -269,33 +269,6 @@ const updateUser = (options) => {
     });
 };
 exports.updateUser = updateUser;
-/**
- * Get All Credit Summaries
- * Get credit summaries for all graphs owned by the user.
- *
- * This endpoint provides a consolidated view of credit usage across
- * all graphs where the user has access, helping to monitor overall
- * credit consumption and plan usage.
- *
- * No credits are consumed for viewing summaries.
- */
-const getAllCreditSummaries = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/credits',
-        ...options
-    });
-};
-exports.getAllCreditSummaries = getAllCreditSummaries;
 /**
  * Update Password
  * Update the current user's password.
@@ -414,8 +387,8 @@ const updateUserApiKey = (options) => {
 };
 exports.updateUserApiKey = updateUserApiKey;
 /**
- * Get user limits
- * Retrieve current limits and restrictions for the authenticated user
+ * Get user limits and usage
+ * Retrieve current limits and usage statistics for the authenticated user (simple safety valve for graph creation)
  */
 const getUserLimits = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -434,253 +407,6 @@ const getUserLimits = (options) => {
     });
 };
 exports.getUserLimits = getUserLimits;
-/**
- * Get user usage statistics
- * Retrieve current usage statistics and remaining limits for the authenticated user
- */
-const getUserUsage = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/limits/usage',
-        ...options
-    });
-};
-exports.getUserUsage = getUserUsage;
-/**
- * Get all shared repository limits
- * Get rate limit status for all shared repositories the user has access to.
- */
-const getAllSharedRepositoryLimits = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/limits/shared-repositories/summary',
-        ...options
-    });
-};
-exports.getAllSharedRepositoryLimits = getAllSharedRepositoryLimits;
-/**
- * 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 included - this only shows rate limit status.
- */
-const getSharedRepositoryLimits = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/limits/shared-repositories/{repository}',
-        ...options
-    });
-};
-exports.getSharedRepositoryLimits = getSharedRepositoryLimits;
-/**
- * Get User Usage Overview
- * Get a high-level overview of usage statistics for the current user.
- */
-const getUserUsageOverview = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/analytics/overview',
-        ...options
-    });
-};
-exports.getUserUsageOverview = getUserUsageOverview;
-/**
- * Get Detailed User Analytics
- * Get comprehensive analytics for the current user including API usage and recent activity.
- */
-const getDetailedUserAnalytics = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/analytics/detailed',
-        ...options
-    });
-};
-exports.getDetailedUserAnalytics = getDetailedUserAnalytics;
-/**
- * Get User Subscriptions
- * Retrieve user's current shared repository subscriptions with detailed information
- */
-const getUserSharedSubscriptions = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories',
-        ...options
-    });
-};
-exports.getUserSharedSubscriptions = getUserSharedSubscriptions;
-/**
- * Subscribe to Shared Repository
- * Create a new subscription to a shared repository add-on with specified tier
- */
-const subscribeToSharedRepository = (options) => {
-    return (options.client ?? client_gen_1.client).post({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories/subscribe',
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers
-        }
-    });
-};
-exports.subscribeToSharedRepository = subscribeToSharedRepository;
-/**
- * Upgrade Subscription Tier
- * Upgrade a subscription to a higher tier with immediate credit adjustment
- */
-const upgradeSharedRepositorySubscription = (options) => {
-    return (options.client ?? client_gen_1.client).put({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories/{subscription_id}/upgrade',
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers
-        }
-    });
-};
-exports.upgradeSharedRepositorySubscription = upgradeSharedRepositorySubscription;
-/**
- * Cancel Subscription
- * Cancel a shared repository subscription and disable associated credit pool
- */
-const cancelSharedRepositorySubscription = (options) => {
-    return (options.client ?? client_gen_1.client).delete({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories/{subscription_id}',
-        ...options
-    });
-};
-exports.cancelSharedRepositorySubscription = cancelSharedRepositorySubscription;
-/**
- * Get Credit Balances
- * Retrieve credit balances for all shared repository subscriptions
- */
-const getSharedRepositoryCredits = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories/credits',
-        ...options
-    });
-};
-exports.getSharedRepositoryCredits = getSharedRepositoryCredits;
-/**
- * Get Repository Credits
- * Get credit balance for a specific shared repository
- */
-const getRepositoryCredits = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/user/subscriptions/shared-repositories/credits/{repository}',
-        ...options
-    });
-};
-exports.getRepositoryCredits = getRepositoryCredits;
 /**
  * List Connections
  * List all data connections in the graph.
@@ -1665,32 +1391,38 @@ const getGraphMetrics = (options) => {
 };
 exports.getGraphMetrics = getGraphMetrics;
 /**
- * Get Usage Statistics
- * Get detailed usage statistics for the graph.
+ * Get Graph Usage Analytics
+ * Get comprehensive usage analytics tracked by the GraphUsageTracking model.
  *
  * Provides temporal usage patterns including:
- * - **Query Volume**: API calls per day/hour
- * - **Credit Consumption**: Usage patterns and trends
- * - **Operation Breakdown**: Usage by operation type
- * - **User Activity**: Access patterns by user role
- * - **Peak Usage Times**: Identify high-activity periods
+ * - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
+ * - **Credit Analytics**: Consumption patterns, operation breakdown, cached vs billable
+ * - **Performance Insights**: Operation stats, slow queries, performance scoring
+ * - **Recent Events**: Latest usage events with full details
  *
  * Time ranges available:
- * - Last 24 hours (hourly breakdown)
- * - Last 7 days (daily breakdown)
- * - Last 30 days (daily breakdown)
- * - Custom date ranges
+ * - `24h` - Last 24 hours (hourly breakdown)
+ * - `7d` - Last 7 days (daily breakdown)
+ * - `30d` - Last 30 days (daily breakdown)
+ * - `current_month` - Current billing month
+ * - `last_month` - Previous billing month
+ *
+ * Include options:
+ * - `storage` - Storage usage summary (GB-hours, averages, peaks)
+ * - `credits` - Credit consumption analytics
+ * - `performance` - Performance insights and optimization opportunities
+ * - `events` - Recent usage events (last 50)
  *
  * Useful for:
+ * - Billing and cost analysis
  * - Capacity planning
- * - Cost optimization
+ * - Performance optimization
  * - Usage trend analysis
- * - Performance tuning
  *
  * Note:
  * This operation is included - no credit consumption required.
  */
-const getGraphUsageStats = (options) => {
+const getGraphUsageAnalytics = (options) => {
     return (options.client ?? client_gen_1.client).get({
         security: [
             {
@@ -1706,7 +1438,7 @@ const getGraphUsageStats = (options) => {
         ...options
     });
 };
-exports.getGraphUsageStats = getGraphUsageStats;
+exports.getGraphUsageAnalytics = getGraphUsageAnalytics;
 /**
  * Execute Cypher Query (Read-Only)
  * Execute a read-only Cypher query with intelligent response optimization.
@@ -1959,141 +1691,6 @@ const validateSchema = (options) => {
     });
 };
 exports.validateSchema = validateSchema;
-/**
- * Get Current Bill
- * Get current month's billing details for the graph.
- *
- * Returns comprehensive billing information including:
- * - **Credit Usage**: Consumed vs. allocated credits
- * - **Storage Charges**: Current storage usage and costs
- * - **Subscription Tier**: Current plan and features
- * - **Pro-rated Charges**: If plan changed mid-month
- * - **Estimated Total**: Current charges to date
- *
- * Billing calculations are updated hourly. Storage is measured in GB-months.
- *
- * ℹ️ No credits are consumed for viewing billing information.
- */
-const getCurrentGraphBill = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/billing/current',
-        ...options
-    });
-};
-exports.getCurrentGraphBill = getCurrentGraphBill;
-/**
- * Get Usage Details
- * Get detailed usage metrics for the graph.
- *
- * Provides granular usage information including:
- * - **Daily Credit Consumption**: Track credit usage patterns
- * - **Storage Growth**: Monitor database size over time
- * - **Operation Breakdown**: Credits by operation type
- * - **Peak Usage Times**: Identify high-activity periods
- * - **API Call Volumes**: Request counts and patterns
- *
- * Useful for:
- * - Optimizing credit consumption
- * - Capacity planning
- * - Usage trend analysis
- * - Cost optimization
- *
- * ℹ️ No credits are consumed for viewing usage details.
- */
-const getGraphUsageDetails = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/billing/usage',
-        ...options
-    });
-};
-exports.getGraphUsageDetails = getGraphUsageDetails;
-/**
- * Get Billing History
- * Get billing history for the graph.
- *
- * Returns a chronological list of monthly bills, perfect for:
- * - Tracking spending trends over time
- * - Identifying usage patterns
- * - Budget forecasting
- * - Financial reporting
- *
- * Each month includes:
- * - Credit usage and overages
- * - Storage charges
- * - Total charges
- * - Usage metrics
- *
- * ℹ️ No credits are consumed for viewing billing history.
- */
-const getGraphBillingHistory = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/billing/history',
-        ...options
-    });
-};
-exports.getGraphBillingHistory = getGraphBillingHistory;
-/**
- * Get Monthly Bill
- * Get billing details for a specific month.
- *
- * Retrieve historical billing information for any previous month.
- * Useful for:
- * - Reconciling past charges
- * - Tracking usage trends
- * - Expense reporting
- * - Budget analysis
- *
- * Returns the same detailed breakdown as the current bill endpoint.
- *
- * ℹ️ No credits are consumed for viewing billing history.
- */
-const getGraphMonthlyBill = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/billing/history/{year}/{month}',
-        ...options
-    });
-};
-exports.getGraphMonthlyBill = getGraphMonthlyBill;
 /**
  * Get Credit Summary
  * Retrieve comprehensive credit usage summary for the specified graph.
@@ -2541,6 +2138,116 @@ const getSubgraphQuota = (options) => {
     });
 };
 exports.getSubgraphQuota = getSubgraphQuota;
+/**
+ * Cancel Subscription
+ * Cancel a subscription.
+ *
+ * For shared repositories: Cancels the user's personal subscription
+ * For user graphs: Not allowed - delete the graph instead
+ *
+ * The subscription will be marked as canceled and will end at the current period end date.
+ */
+const cancelSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/subscriptions',
+        ...options
+    });
+};
+exports.cancelSubscription = cancelSubscription;
+/**
+ * Get Subscription
+ * Get subscription details for a graph or shared repository.
+ *
+ * For user graphs (kg*): Returns the graph's subscription (owned by graph creator)
+ * For shared repositories (sec, industry, etc.): Returns user's personal subscription to that repository
+ *
+ * This unified endpoint automatically detects the resource type and returns the appropriate subscription.
+ */
+const getGraphSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/subscriptions',
+        ...options
+    });
+};
+exports.getGraphSubscription = getGraphSubscription;
+/**
+ * Create Repository Subscription
+ * Create a new subscription to a shared repository.
+ *
+ * This endpoint is ONLY for shared repositories (sec, industry, economic).
+ * User graph subscriptions are created automatically when the graph is provisioned.
+ *
+ * The subscription will be created in ACTIVE status immediately and credits will be allocated.
+ */
+const createRepositorySubscription = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/subscriptions',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createRepositorySubscription = createRepositorySubscription;
+/**
+ * Upgrade Subscription
+ * Upgrade a subscription to a different plan.
+ *
+ * Works for both user graphs and shared repositories.
+ * The subscription will be immediately updated to the new plan and pricing.
+ */
+const upgradeSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/subscriptions/upgrade',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.upgradeSubscription = upgradeSubscription;
 /**
  * List Staging Tables
  * List all DuckDB staging tables with comprehensive metrics and status.
@@ -3006,38 +2713,45 @@ const queryTables = (options) => {
 };
 exports.queryTables = queryTables;
 /**
- * Get User Graphs
- * List all graph databases accessible to the current user with roles and selection status.
+ * Get User Graphs and Repositories
+ * List all graph databases and shared repositories accessible to the current user.
  *
- * Returns a comprehensive list of all graphs the user can access, including their
- * role in each graph (admin or member) and which graph is currently selected as
- * the active workspace.
+ * Returns a unified list of both user-created graphs and shared repositories (like SEC data)
+ * that the user has access to, including their role/access level and selection status.
  *
  * **Returned Information:**
- * - Graph ID and display name for each accessible graph
- * - User's role (admin/member) indicating permission level
- * - Selection status (one graph can be marked as "selected")
- * - Creation timestamp for each graph
- *
- * **Graph Roles:**
- * - `admin`: Full access - can manage graph settings, invite users, delete graph
- * - `member`: Read/write access - can query and modify data, cannot manage settings
+ * - Graph/Repository ID and display name
+ * - User's role/access level (admin/member for graphs, read/write/admin for repositories)
+ * - Selection status (only user graphs can be selected)
+ * - Creation timestamp
+ * - Repository type indicator (isRepository: true for shared repositories)
+ *
+ * **User Graphs (isRepository: false):**
+ * - Collaborative workspaces that can be shared with other users
+ * - Roles: `admin` (full access, can invite users) or `member` (read/write access)
+ * - Can be selected as active workspace
+ * - Graphs you create or have been invited to
+ *
+ * **Shared Repositories (isRepository: true):**
+ * - Read-only data repositories like SEC filings, industry benchmarks
+ * - Access levels: `read`, `write` (for data contributions), `admin`
+ * - Cannot be selected (each has separate subscription)
+ * - Require separate subscriptions (personal, cannot be shared)
  *
  * **Selected Graph Concept:**
- * The "selected" graph is the user's currently active workspace. Many API operations
- * default to the selected graph if no graph_id is provided. Users can change their
- * selected graph via the `POST /v1/graphs/{graph_id}/select` endpoint.
+ * The "selected" graph is the user's currently active workspace (user graphs only).
+ * Many API operations default to the selected graph if no graph_id is provided.
+ * Users can change their selected graph via `POST /v1/graphs/{graph_id}/select`.
  *
  * **Use Cases:**
- * - Display graph selector in UI
- * - Show user's accessible workspaces
- * - Identify which graph is currently active
- * - Filter graphs by role for permission-based features
+ * - Display unified graph/repository selector in UI
+ * - Show all accessible data sources (both owned graphs and subscribed repositories)
+ * - Identify currently active workspace
+ * - Filter by type (user graphs vs repositories)
  *
  * **Empty Response:**
- * New users or users without graph access will receive an empty list with
- * `selectedGraphId: null`. Users should create a new graph or request access
- * to an existing graph.
+ * New users receive an empty list with `selectedGraphId: null`. Users should create
+ * a graph or subscribe to a repository.
  *
  * **Note:**
  * Graph listing is included - no credit consumption required.