@robosystems/client 0.2.10 → 0.2.12

package/sdk.gen.js

@@ -1,12 +1,17 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-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.cancelSubscription2 = exports.getSubscription = exports.listSubscriptions = exports.getUpcomingInvoice = exports.listInvoices = exports.updatePaymentMethod = exports.getBillingCustomer = exports.getCheckoutStatus = exports.createCheckoutSession = 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;
+exports.batchProcessQueries = exports.executeSpecificAgent = exports.getAgentMetadata = exports.autoSelectAgent = exports.listAgents = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.oauthCallback = exports.initOAuth = exports.createLinkToken = exports.exchangeLinkToken = exports.getConnectionOptions = exports.createConnection = exports.listConnections = exports.getOrgUsage = exports.getOrgLimits = exports.updateOrgMemberRole = exports.removeOrgMember = exports.inviteOrgMember = exports.listOrgMembers = exports.listOrgGraphs = exports.updateOrg = exports.getOrg = exports.createOrg = exports.listUserOrgs = 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.updateOrgPaymentMethod = exports.getOrgBillingCustomer = 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 = exports.getGraphUsageAnalytics = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = void 0;
+exports.getCheckoutStatus = exports.createCheckoutSession = exports.getOrgUpcomingInvoice = exports.listOrgInvoices = exports.cancelOrgSubscription = exports.getOrgSubscription = exports.listOrgSubscriptions = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Register New User
- * Register a new user account with email and password. Security controls vary by environment: CAPTCHA and email verification are disabled in development for API testing, but required in production.
+ * Register a new user account with email and password.
+ *
+ * **Organization Creation**: RoboSystems is an org-centric platform. When you register, a personal organization is automatically created for you. All resources (graphs, subscriptions, billing) belong to organizations, not individual users. You can later upgrade your personal org to a team or enterprise organization.
+ *
+ * **Security Controls**: CAPTCHA and email verification are disabled in development for API testing, but required in production.
  */
 const registerUser = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -387,10 +392,10 @@ const updateUserApiKey = (options) => {
 };
 exports.updateUserApiKey = updateUserApiKey;
 /**
- * Get user limits and usage
- * Retrieve current limits and usage statistics for the authenticated user (simple safety valve for graph creation)
+ * List User's Organizations
+ * Get all organizations the current user belongs to, with their role in each.
  */
-const getUserLimits = (options) => {
+const listUserOrgs = (options) => {
     return (options?.client ?? client_gen_1.client).get({
         security: [
             {
@@ -402,11 +407,240 @@ const getUserLimits = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/user/limits',
+        url: '/v1/orgs',
+        ...options
+    });
+};
+exports.listUserOrgs = listUserOrgs;
+/**
+ * Create Organization
+ * Create a new organization. The creating user becomes the owner.
+ */
+const createOrg = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createOrg = createOrg;
+/**
+ * Get Organization
+ * Get detailed information about an organization.
+ */
+const getOrg = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}',
+        ...options
+    });
+};
+exports.getOrg = getOrg;
+/**
+ * Update Organization
+ * Update organization information. Requires admin or owner role.
+ */
+const updateOrg = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.updateOrg = updateOrg;
+/**
+ * List Organization Graphs
+ * Get all graphs belonging to an organization.
+ */
+const listOrgGraphs = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/graphs',
+        ...options
+    });
+};
+exports.listOrgGraphs = listOrgGraphs;
+/**
+ * List Organization Members
+ * Get all members of an organization with their roles.
+ */
+const listOrgMembers = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members',
+        ...options
+    });
+};
+exports.listOrgMembers = listOrgMembers;
+/**
+ * Invite Member
+ * Invite a user to join the organization. Requires admin or owner role.
+ *
+ * **⚠️ FEATURE NOT READY**: This endpoint is disabled by default (ORG_MEMBER_INVITATIONS_ENABLED=false).
+ * Returns 501 NOT IMPLEMENTED when disabled. See endpoint implementation for TODO list before enabling.
+ */
+const inviteOrgMember = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.inviteOrgMember = inviteOrgMember;
+/**
+ * Remove Member
+ * Remove a member from the organization. Requires admin or owner role.
+ */
+const removeOrgMember = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members/{user_id}',
+        ...options
+    });
+};
+exports.removeOrgMember = removeOrgMember;
+/**
+ * Update Member Role
+ * Update a member's role in the organization. Requires admin or owner role.
+ */
+const updateOrgMemberRole = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members/{user_id}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.updateOrgMemberRole = updateOrgMemberRole;
+/**
+ * Get Organization Limits
+ * Get the current limits and quotas for an organization.
+ */
+const getOrgLimits = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/limits',
         ...options
     });
 };
-exports.getUserLimits = getUserLimits;
+exports.getOrgLimits = getOrgLimits;
+/**
+ * Get Organization Usage
+ * Get detailed usage statistics for an organization aggregated across all graphs.
+ */
+const getOrgUsage = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/usage',
+        ...options
+    });
+};
+exports.getOrgUsage = getOrgUsage;
 /**
  * List Connections
  * List all data connections in the graph.
@@ -788,9 +1022,38 @@ const syncConnection = (options) => {
     });
 };
 exports.syncConnection = syncConnection;
+/**
+ * List available agents
+ * Get a comprehensive list of all available agents with their metadata.
+ *
+ * **Returns:**
+ * - Agent types and names
+ * - Capabilities and supported modes
+ * - Version information
+ * - Credit requirements
+ *
+ * Use the optional `capability` filter to find agents with specific capabilities.
+ */
+const listAgents = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/agent',
+        ...options
+    });
+};
+exports.listAgents = listAgents;
 /**
  * Auto-select agent for query
- * Automatically select the best agent for your query.
+ * Automatically select the best agent for your query with intelligent execution strategy.
  *
  * **Agent Selection Process:**
  *
@@ -799,7 +1062,8 @@ exports.syncConnection = syncConnection;
  * 2. Enriching context with RAG if enabled
  * 3. Evaluating all available agents against selection criteria
  * 4. Selecting the best match based on confidence scores
- * 5. Executing the query with the selected agent
+ * 5. Choosing execution strategy (sync/SSE/async) based on expected time
+ * 6. Executing the query with the selected agent
  *
  * **Available Agent Types:**
  * - `financial`: Financial analysis, SEC filings, company metrics
@@ -812,6 +1076,14 @@ exports.syncConnection = syncConnection;
  * - `extended`: Comprehensive analysis (~15-60s), deep research
  * - `streaming`: Real-time response streaming
  *
+ * **Execution Strategies (automatic):**
+ * - Fast operations (<5s): Immediate synchronous response
+ * - Medium operations (5-30s): SSE streaming with progress updates
+ * - Long operations (>30s): Async Celery worker with operation tracking
+ *
+ * **Response Mode Override:**
+ * Use query parameter `?mode=sync|async` to override automatic strategy selection.
+ *
  * **Confidence Score Interpretation:**
  * - `0.9-1.0`: High confidence, agent is ideal match
  * - `0.7-0.9`: Good confidence, agent is suitable
@@ -854,15 +1126,54 @@ const autoSelectAgent = (options) => {
     });
 };
 exports.autoSelectAgent = autoSelectAgent;
+/**
+ * Get agent metadata
+ * Get comprehensive metadata for a specific agent type.
+ *
+ * **Returns:**
+ * - Agent name and description
+ * - Version information
+ * - Supported capabilities and modes
+ * - Credit requirements
+ * - Author and tags
+ * - Configuration options
+ *
+ * Use this to understand agent capabilities before execution.
+ */
+const getAgentMetadata = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/graphs/{graph_id}/agent/{agent_type}',
+        ...options
+    });
+};
+exports.getAgentMetadata = getAgentMetadata;
 /**
  * Execute specific agent
- * Execute a specific agent type directly.
+ * Execute a specific agent type directly with intelligent execution strategy.
  *
  * Available agents:
  * - **financial**: Financial analysis, SEC filings, accounting data
  * - **research**: Deep research and comprehensive analysis
  * - **rag**: Fast retrieval without AI (no credits required)
  *
+ * **Execution Strategies (automatic):**
+ * - Fast operations (<5s): Immediate synchronous response
+ * - Medium operations (5-30s): SSE streaming with progress updates
+ * - Long operations (>30s): Async Celery worker with operation tracking
+ *
+ * **Response Mode Override:**
+ * Use query parameter `?mode=sync|async` to override automatic strategy selection.
+ *
  * Use this endpoint when you know which agent you want to use.
  */
 const executeSpecificAgent = (options) => {
@@ -924,66 +1235,6 @@ const batchProcessQueries = (options) => {
     });
 };
 exports.batchProcessQueries = batchProcessQueries;
-/**
- * List available agents
- * Get a comprehensive list of all available agents with their metadata.
- *
- * **Returns:**
- * - Agent types and names
- * - Capabilities and supported modes
- * - Version information
- * - Credit requirements
- *
- * Use the optional `capability` filter to find agents with specific capabilities.
- */
-const listAgents = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/agent/list',
-        ...options
-    });
-};
-exports.listAgents = listAgents;
-/**
- * Get agent metadata
- * Get comprehensive metadata for a specific agent type.
- *
- * **Returns:**
- * - Agent name and description
- * - Version information
- * - Supported capabilities and modes
- * - Credit requirements
- * - Author and tags
- * - Configuration options
- *
- * Use this to understand agent capabilities before execution.
- */
-const getAgentMetadata = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                name: 'X-API-Key',
-                type: 'apiKey'
-            },
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/v1/graphs/{graph_id}/agent/{agent_type}/metadata',
-        ...options
-    });
-};
-exports.getAgentMetadata = getAgentMetadata;
 /**
  * Get agent recommendations
  * Get intelligent agent recommendations for a specific query.
@@ -1392,7 +1643,7 @@ const getGraphMetrics = (options) => {
 exports.getGraphMetrics = getGraphMetrics;
 /**
  * Get Graph Usage Analytics
- * Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+ * Get comprehensive usage analytics tracked by the GraphUsage model.
  *
  * Provides temporal usage patterns including:
  * - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
@@ -3015,9 +3266,15 @@ exports.selectGraph = selectGraph;
  * and shared repository subscriptions. This is the primary endpoint for frontend
  * applications to display subscription options.
  *
+ * **Pricing Model:**
+ * - Graph subscriptions are **per-graph** with infrastructure-based pricing
+ * - Each graph you create has its own monthly subscription
+ * - Organizations can have multiple graphs with different infrastructure tiers
+ * - Credits are allocated per-graph, not shared across organization
+ *
  * Includes:
- * - Graph subscription tiers (standard, enterprise, premium)
- * - Shared repository subscriptions (SEC, industry, economic data)
+ * - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+ * - Shared repository subscriptions (SEC, industry, economic data) - org-level
  * - Operation costs and credit information
  * - Features and capabilities for each tier
  * - Enabled/disabled status for repositories
@@ -3163,25 +3420,17 @@ const cancelOperation = (options) => {
 };
 exports.cancelOperation = cancelOperation;
 /**
- * Create Payment Checkout Session
- * Create a Stripe checkout session for collecting payment method.
+ * Get Organization Customer Info
+ * Get billing customer information for an organization including payment methods on file.
  *
- * This endpoint is used when a user needs to add a payment method before
- * provisioning resources. It creates a pending subscription and redirects
- * the user to Stripe Checkout to collect payment details.
- *
- * **Flow:**
- * 1. User tries to create a graph but has no payment method
- * 2. Frontend calls this endpoint with graph configuration
- * 3. Backend creates a subscription in PENDING_PAYMENT status
- * 4. Returns Stripe Checkout URL
- * 5. User completes payment on Stripe
- * 6. Webhook activates subscription and provisions resource
+ * Returns customer details, payment methods, and whether invoice billing is enabled.
  *
- * **Enterprise customers** (with invoice_billing_enabled) should not call this endpoint.
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Sensitive payment details are only visible to owners
  */
-const createCheckoutSession = (options) => {
-    return (options.client ?? client_gen_1.client).post({
+const getOrgBillingCustomer = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3192,34 +3441,22 @@ const createCheckoutSession = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/checkout',
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers
-        }
+        url: '/v1/billing/customer/{org_id}',
+        ...options
     });
 };
-exports.createCheckoutSession = createCheckoutSession;
+exports.getOrgBillingCustomer = getOrgBillingCustomer;
 /**
- * Get Checkout Session Status
- * Poll the status of a checkout session.
+ * Update Organization Default Payment Method
+ * Update the default payment method for the organization.
  *
- * Frontend should poll this endpoint after user returns from Stripe Checkout
- * to determine when the resource is ready.
- *
- * **Status Values:**
- * - `pending_payment`: Waiting for payment to complete
- * - `provisioning`: Payment confirmed, resource being created
- * - `completed`: Resource is ready (resource_id will be set)
- * - `failed`: Something went wrong (error field will be set)
+ * This changes which payment method will be used for future subscription charges.
  *
- * **When status is 'completed':**
- * - For graphs: `resource_id` will be the graph_id, and `operation_id` can be used to monitor SSE progress
- * - For repositories: `resource_id` will be the repository name and access is immediately available
+ * **Requirements:**
+ * - User must be an OWNER of the organization
  */
-const getCheckoutStatus = (options) => {
-    return (options.client ?? client_gen_1.client).get({
+const updateOrgPaymentMethod = (options) => {
+    return (options.client ?? client_gen_1.client).post({
         security: [
             {
                 name: 'X-API-Key',
@@ -3230,19 +3467,26 @@ const getCheckoutStatus = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/checkout/{session_id}/status',
-        ...options
+        url: '/v1/billing/customer/{org_id}/payment-method',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
     });
 };
-exports.getCheckoutStatus = getCheckoutStatus;
+exports.updateOrgPaymentMethod = updateOrgPaymentMethod;
 /**
- * Get Customer Info
- * Get billing customer information including payment methods on file.
+ * List Organization Subscriptions
+ * List all active and past subscriptions for an organization.
  *
- * Returns customer details, payment methods, and whether invoice billing is enabled.
+ * Includes both graph and repository subscriptions with their status, pricing, and billing information.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
  */
-const getBillingCustomer = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
+const listOrgSubscriptions = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3253,19 +3497,20 @@ const getBillingCustomer = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/customer',
+        url: '/v1/billing/subscriptions/{org_id}',
         ...options
     });
 };
-exports.getBillingCustomer = getBillingCustomer;
+exports.listOrgSubscriptions = listOrgSubscriptions;
 /**
- * Update Default Payment Method
- * Update the default payment method for the customer.
+ * Get Organization Subscription Details
+ * Get detailed information about a specific subscription.
  *
- * This changes which payment method will be used for future subscription charges.
+ * **Requirements:**
+ * - User must be a member of the organization
  */
-const updatePaymentMethod = (options) => {
-    return (options.client ?? client_gen_1.client).post({
+const getOrgSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3276,23 +3521,22 @@ const updatePaymentMethod = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/customer/payment-method',
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers
-        }
+        url: '/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}',
+        ...options
     });
 };
-exports.updatePaymentMethod = updatePaymentMethod;
+exports.getOrgSubscription = getOrgSubscription;
 /**
- * List Invoices
- * List payment history and invoices.
+ * Cancel Organization Subscription
+ * Cancel an organization subscription.
  *
- * Returns past invoices with payment status, amounts, and line items.
+ * The subscription will remain active until the end of the current billing period.
+ *
+ * **Requirements:**
+ * - User must be an OWNER of the organization
  */
-const listInvoices = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
+const cancelOrgSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).post({
         security: [
             {
                 name: 'X-API-Key',
@@ -3303,19 +3547,23 @@ const listInvoices = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/invoices',
+        url: '/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}/cancel',
         ...options
     });
 };
-exports.listInvoices = listInvoices;
+exports.cancelOrgSubscription = cancelOrgSubscription;
 /**
- * Get Upcoming Invoice
- * Get preview of the next invoice.
+ * List Organization Invoices
+ * List payment history and invoices for an organization.
  *
- * Returns estimated charges for the next billing period.
+ * Returns past invoices with payment status, amounts, and line items.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Full invoice details are only visible to owners and admins
  */
-const getUpcomingInvoice = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
+const listOrgInvoices = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3326,19 +3574,23 @@ const getUpcomingInvoice = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/invoices/upcoming',
+        url: '/v1/billing/invoices/{org_id}',
         ...options
     });
 };
-exports.getUpcomingInvoice = getUpcomingInvoice;
+exports.listOrgInvoices = listOrgInvoices;
 /**
- * List All Subscriptions
- * List all active and past subscriptions for the user.
+ * Get Organization Upcoming Invoice
+ * Get preview of the next invoice for an organization.
  *
- * Includes both graph and repository subscriptions with their status, pricing, and billing information.
+ * Returns estimated charges for the next billing period.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Full invoice details are only visible to owners and admins
  */
-const listSubscriptions = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
+const getOrgUpcomingInvoice = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3349,17 +3601,33 @@ const listSubscriptions = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/subscriptions',
+        url: '/v1/billing/invoices/{org_id}/upcoming',
         ...options
     });
 };
-exports.listSubscriptions = listSubscriptions;
+exports.getOrgUpcomingInvoice = getOrgUpcomingInvoice;
 /**
- * Get Subscription Details
- * Get detailed information about a specific subscription.
+ * Create Payment Checkout Session
+ * Create a Stripe checkout session for collecting payment method.
+ *
+ * This endpoint is used when an organization owner needs to add a payment method before
+ * provisioning resources. It creates a pending subscription and redirects
+ * to Stripe Checkout to collect payment details.
+ *
+ * **Flow:**
+ * 1. Owner tries to create a graph but org has no payment method
+ * 2. Frontend calls this endpoint with graph configuration
+ * 3. Backend creates a subscription in PENDING_PAYMENT status for the user's org
+ * 4. Returns Stripe Checkout URL
+ * 5. User completes payment on Stripe
+ * 6. Webhook activates subscription and provisions resource
+ *
+ * **Requirements:**
+ * - User must be an OWNER of their organization
+ * - Enterprise customers (with invoice_billing_enabled) should not call this endpoint.
  */
-const getSubscription = (options) => {
-    return (options.client ?? client_gen_1.client).get({
+const createCheckoutSession = (options) => {
+    return (options.client ?? client_gen_1.client).post({
         security: [
             {
                 name: 'X-API-Key',
@@ -3370,19 +3638,34 @@ const getSubscription = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/subscriptions/{subscription_id}',
-        ...options
+        url: '/v1/billing/checkout',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
     });
 };
-exports.getSubscription = getSubscription;
+exports.createCheckoutSession = createCheckoutSession;
 /**
- * Cancel Subscription
- * Cancel a subscription.
+ * Get Checkout Session Status
+ * Poll the status of a checkout session.
  *
- * The subscription will remain active until the end of the current billing period.
+ * Frontend should poll this endpoint after user returns from Stripe Checkout
+ * to determine when the resource is ready.
+ *
+ * **Status Values:**
+ * - `pending_payment`: Waiting for payment to complete
+ * - `provisioning`: Payment confirmed, resource being created
+ * - `completed`: Resource is ready (resource_id will be set)
+ * - `failed`: Something went wrong (error field will be set)
+ *
+ * **When status is 'completed':**
+ * - For graphs: `resource_id` will be the graph_id, and `operation_id` can be used to monitor SSE progress
+ * - For repositories: `resource_id` will be the repository name and access is immediately available
  */
-const cancelSubscription2 = (options) => {
-    return (options.client ?? client_gen_1.client).post({
+const getCheckoutStatus = (options) => {
+    return (options.client ?? client_gen_1.client).get({
         security: [
             {
                 name: 'X-API-Key',
@@ -3393,8 +3676,8 @@ const cancelSubscription2 = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/billing/subscriptions/{subscription_id}/cancel',
+        url: '/v1/billing/checkout/{session_id}/status',
         ...options
     });
 };
-exports.cancelSubscription2 = cancelSubscription2;
+exports.getCheckoutStatus = getCheckoutStatus;