@datalayer/core 1.1.41 → 1.1.45

package/README.md

@@ -25,12 +25,10 @@ This package serves as the base foundation used by many other Datalayer packages
 ## Key Features
 
 - **🔐 Simple Authentication**: Easy token-based authentication with environment variable support
-- **⚡ Runtime Management**: Create and manage scalable compute runtimes (CPU/GPU) for code execution
-- **📸 Snapshot Management**: Create and manage compute snapshots of your runtimes for reproducible environments
 - **🔒 Secrets Management**: Securely handle sensitive data and credentials in your workflows
 - **🐍 Python Client**: Programmatic access to Datalayer platform with context managers and clean resource management
 - **🌐 TypeScript/React Client**: React components and services for building Jupyter-based applications
-- **💻 Command Line Interface**: CLI tools for managing runtimes, snapshots, and platform resources
+- **💻 Command Line Interface**: CLI tools for account and platform operations
 - **🔧 Base Classes**: Core application classes and configuration inherited by other Datalayer projects
 - **📓 Jupyter Integration**: ServiceManager and collaboration providers for notebook experiences
 - **🧭 Universal Navigation**: Smart navigation hooks that auto-detect and work with React Router, Next.js, or native browser
@@ -85,136 +83,27 @@ from datalayer_core import DatalayerClient
 client = DatalayerClient()
 
 # Or pass token directly
-client = DatalayerClient(token="your-token-here")
+client = DatalayerClient(api_key="your-api-key-here")
 
 if client.authenticate():
     print("Successfully authenticated!")
 ```
 
-### 2. Execute Code in a Runtime
+### 2. Runtime, Snapshots, and Evals
 
-> **Note:** Runtime creation and code execution have moved to the
-> [`agent-runtimes`](https://github.com/datalayer/agent-runtimes) package. Use its
-> `RuntimeClient` (and the `@datalayer` decorator) for runtime workloads. The
-> `datalayer-core` `DatalayerClient` now focuses on account/platform operations
-> (authentication, secrets, API keys, usage, profile).
+Runtime execution, snapshot workflows, and evals CLI are now documented and maintained in:
 
-```python
-from agent_runtimes.client import RuntimeClient
-
-client = RuntimeClient()
-
-# Execute code in a managed runtime
-with client.create_runtime() as runtime:
-    response = runtime.execute("print('Hello from Datalayer!')")
-    print(response.stdout)
-```
-
-### 3. Using the CLI
-
-The CLI provides command-line access to Datalayer platform features:
+- [agent-runtimes README](https://github.com/datalayer/agent-runtimes/blob/main/README.md)
+- [agent-runtimes CLI docs](https://agent-runtimes.datalayer.tech/cli)
 
-```bash
-# List available runtimes
-datalayer runtime list
-
-# Create a new runtime
-datalayer runtime create ai-env --given-name my-runtime-123
-
-# Execute a script in a runtime
-datalayer runtime exec my-script.py --agent <agent-id>
-
-# Create a snapshot from a runtime but do not terminate the runtime
-datalayer snapshots create <pod-name> my-snapshot 'AI work!' False
-```
-
-### 4. Subscription and Credits CLI
-
-Use these commands to inspect billing and manage credits distribution.
-
-```bash
-# End-user billing view
-datalayer subscriptions show
-datalayer subscriptions available
-datalayer subscriptions move
-datalayer subscriptions topups
-datalayer subscriptions dry-run
-
-# Organization and team credits visibility
-datalayer usage org-overview --organization-uid <org_uid>
-datalayer usage team-overview --team-uid <team_uid>
-
-# Monitoring-driven credit management
-datalayer usage org-monitor --organization-uid <org_uid> --window-hours 24
-datalayer usage team-monitor --team-uid <team_uid> --window-hours 24
-
-# Credits transfer operations (owners/admins)
-datalayer usage org-allocate-team --organization-uid <org_uid> --team-uid <team_uid> --amount 50
-datalayer usage org-revoke-team --organization-uid <org_uid> --team-uid <team_uid> --amount 20
-datalayer usage team-allocate-member --team-uid <team_uid> --member-uid <member_uid> --amount 15
-datalayer usage team-revoke-member --team-uid <team_uid> --member-uid <member_uid> --amount 5
-```
-
-### 5. Evals CLI (Multi-Agentspec)
-
-Use comma-separated agentspec ids to create one experiment per agentspec variant:
-
-```bash
-# Creates one experiment per agentspec in the list
-agent-runtimes evals experiments create my-exp \
-  --evalset-id <evalset_id> \
-  --agent-spec-ids example-evals,example-evals-nocodemode,example-custom
-```
-
-Generate a comparison report:
-
-```bash
-agent-runtimes evals report <evalset_id> --run-limit 50 --export
-```
-
-How to interpret grouped comparisons in the report:
-
-- `Within-Agentspec Pairwise Latest-Pass Deltas`: compares experiments using the same agentspec id.
-- `Cross-Agentspec Pairwise Latest-Pass Deltas`: compares experiments using different agentspec ids.
-- Pairwise sections compute all combinations for the selected experiments, not just two agentspecs.
+Use `agent-runtimes` for runtime workloads (`RuntimeClient`, `@datalayer`, snapshots, and evals), and use `datalayer-core` for account/platform operations (authentication, secrets, API keys, usage, profile).
 
 ## Examples
 
-### Python Examples
-
-For comprehensive Python usage examples, see the [`examples/`](https://github.com/datalayer/core/tree/main/examples) directory which includes:
-
-- **OpenTelemetry observability**: Traces and metrics instrumentation with a visualization UI
-
-The framework and client examples (**FastAPI + scikit-learn**, **Streamlit + scikit-learn**, **PyTorch GPU workloads**, **`@datalayer` decorator patterns**, and **Next.js**) have moved to the [Agent Runtimes examples](https://github.com/datalayer/agent-runtimes/tree/main/examples).
-
-### TypeScript/React Examples
-
-Run the interactive examples locally:
-
-```bash
-# Install dependencies
-npm install
-
-# Set your Datalayer API token in .env
-echo "VITE_DATALAYER_API_KEY=your-token-here" > .env
-
-# Start the examples server
-npm run examples
-```
-
-Available at http://localhost:3000/:
-
-- **DatalayerNotebookExample**: Full integration with Datalayer services and collaboration
-- **NotebookExample**: Basic Jupyter notebook in React
-- **CellExample**: Individual code cell execution
-- **ReactRouterAdvancedExample**: Comprehensive navigation demo with React Router integration
-- **ReactRouterNavigationExample**: Basic navigation with route parameters
-- **NativeNavigationExample**: Browser-native navigation fallback
-
-### Next.js Application Example
+Examples have moved to Agent Runtimes:
 
-The Next.js application example has moved to the [Agent Runtimes examples](https://github.com/datalayer/agent-runtimes/tree/main/examples/nextjs).
+- [Agent Runtimes examples README](https://github.com/datalayer/agent-runtimes/blob/main/examples/README.md)
+- [Agent Runtimes examples directory](https://github.com/datalayer/agent-runtimes/tree/main/examples)
 
 ## Platform Integration
 

package/lib/client/auth/AuthenticationManager.d.ts

@@ -10,15 +10,15 @@ import { UserDTO } from '../../models/UserDTO';
 export declare class AuthenticationManager {
     private strategies;
     private storage;
-    private iamRunUrl;
+    private iamUrl;
     private currentUser?;
     private currentToken?;
     /**
      * Create an AuthenticationManager instance
-     * @param iamRunUrl - IAM service URL (e.g., "https://prod1.datalayer.run")
+     * @param iamUrl - IAM service URL (e.g., "https://prod1.datalayer.run")
      * @param storage - Token storage backend (optional, defaults to auto-detected)
      */
-    constructor(iamRunUrl: string, storage?: TokenStorage);
+    constructor(iamUrl: string, storage?: TokenStorage);
     /**
      * Login using various authentication methods
      * Automatically selects the appropriate strategy based on options

package/lib/client/auth/AuthenticationManager.js

@@ -15,25 +15,25 @@ import { NodeStorage, BrowserStorage } from './storage.js';
 export class AuthenticationManager {
     strategies;
     storage;
-    iamRunUrl;
+    iamUrl;
     currentUser;
     currentToken;
     /**
      * Create an AuthenticationManager instance
-     * @param iamRunUrl - IAM service URL (e.g., "https://prod1.datalayer.run")
+     * @param iamUrl - IAM service URL (e.g., "https://prod1.datalayer.run")
      * @param storage - Token storage backend (optional, defaults to auto-detected)
      */
-    constructor(iamRunUrl, storage) {
-        this.iamRunUrl = iamRunUrl;
-        // Extract run_url (remove /api/iam/v1 if present)
-        const runUrl = iamRunUrl.replace('/api/iam/v1', '');
-        // CRITICAL: Pass runUrl to storage for keyring compatibility
+    constructor(iamUrl, storage) {
+        this.iamUrl = iamUrl;
+        // Extract datalayer_url (remove /api/iam/v1 if present)
+        const datalayerUrl = iamUrl.replace('/api/iam/v1', '');
+        // CRITICAL: Pass datalayerUrl to storage for keyring compatibility
         if (!storage) {
             if (typeof window !== 'undefined') {
                 this.storage = new BrowserStorage();
             }
             else {
-                this.storage = new NodeStorage(runUrl); // Pass runUrl as serviceUrl
+                this.storage = new NodeStorage(datalayerUrl); // Pass datalayerUrl as serviceUrl
             }
         }
         else {
@@ -41,10 +41,10 @@ export class AuthenticationManager {
         }
         // Initialize strategies
         this.strategies = [
-            new TokenAuthStrategy(this.iamRunUrl, this.storage),
-            new CredentialsAuthStrategy(this.iamRunUrl, this.storage),
-            new StorageAuthStrategy(this.iamRunUrl, this.storage),
-            new BrowserOAuthStrategy(this.iamRunUrl, this.storage),
+            new TokenAuthStrategy(this.iamUrl, this.storage),
+            new CredentialsAuthStrategy(this.iamUrl, this.storage),
+            new StorageAuthStrategy(this.iamUrl, this.storage),
+            new BrowserOAuthStrategy(this.iamUrl, this.storage),
         ];
     }
     /**
@@ -98,7 +98,7 @@ export class AuthenticationManager {
     async logout() {
         if (this.currentToken) {
             try {
-                await authentication.logout(this.currentToken, this.iamRunUrl);
+                await authentication.logout(this.currentToken, this.iamUrl);
             }
             catch (error) {
                 console.error('Error during logout API call:', error);

package/lib/client/auth/strategies.d.ts

@@ -4,9 +4,9 @@ import { UserDTO } from '../../models/UserDTO';
  * Base authentication strategy with common functionality
  */
 declare abstract class BaseAuthStrategy implements AuthStrategy {
-    protected iamRunUrl: string;
+    protected iamUrl: string;
     protected storage?: TokenStorage | undefined;
-    constructor(iamRunUrl: string, storage?: TokenStorage | undefined);
+    constructor(iamUrl: string, storage?: TokenStorage | undefined);
     abstract authenticate(options: AuthOptions): Promise<AuthResult>;
     abstract canHandle(options: AuthOptions): boolean;
     /**

package/lib/client/auth/strategies.js

@@ -17,17 +17,17 @@ import { UserDTO } from '../../models/UserDTO.js';
  * Base authentication strategy with common functionality
  */
 class BaseAuthStrategy {
-    iamRunUrl;
+    iamUrl;
     storage;
-    constructor(iamRunUrl, storage) {
-        this.iamRunUrl = iamRunUrl;
+    constructor(iamUrl, storage) {
+        this.iamUrl = iamUrl;
         this.storage = storage;
     }
     /**
      * Validate a token by calling whoami
      */
     async validateToken(token) {
-        const response = await profile.whoami(token, this.iamRunUrl);
+        const response = await profile.whoami(token, this.iamUrl);
         if (!response || !response.profile) {
             throw new Error('Invalid response from profile API');
         }
@@ -82,7 +82,7 @@ export class CredentialsAuthStrategy extends BaseAuthStrategy {
             throw new Error('Handle and password are required for credentials authentication');
         }
         // Call the login API
-        const response = await authentication.login({ handle: options.handle, password: options.password }, this.iamRunUrl);
+        const response = await authentication.login({ handle: options.handle, password: options.password }, this.iamUrl);
         if (!response || !response.success || !response.token) {
             throw new Error(response?.message || 'Login failed');
         }
@@ -158,7 +158,7 @@ export class BrowserOAuthStrategy extends BaseAuthStrategy {
         const callbackUri = options.callbackUri || `${window.location.origin}/auth/callback`;
         try {
             // Step 1: Get OAuth authorization URL
-            const authzResponse = await getOAuth2AuthzUrl(provider, callbackUri, this.iamRunUrl, options.nonce);
+            const authzResponse = await getOAuth2AuthzUrl(provider, callbackUri, this.iamUrl, options.nonce);
             // Step 2: Open OAuth URL in popup or redirect
             if (options.usePopup !== false) {
                 // Use popup window

package/lib/client/base.d.ts

@@ -14,11 +14,11 @@ export interface DatalayerClientConfig {
     /** Authentication token for API requests */
     token?: string;
     /** URL for the IAM service */
-    iamRunUrl?: string;
+    iamUrl?: string;
     /** URL for the Runtimes service */
-    runtimesRunUrl?: string;
+    runtimesUrl?: string;
     /** URL for the Spacer service */
-    spacerRunUrl?: string;
+    spacerUrl?: string;
     /** Custom token storage backend (optional, defaults to auto-detected) */
     storage?: TokenStorage;
     /** Handlers for intercepting Client method calls */
@@ -27,11 +27,11 @@ export interface DatalayerClientConfig {
 /** Base Client class providing core configuration and token management. */
 export declare class DatalayerClientBase {
     /** URL for IAM service */
-    readonly iamRunUrl: string;
+    readonly iamUrl: string;
     /** URL for Runtimes service */
-    readonly runtimesRunUrl: string;
+    readonly runtimesUrl: string;
     /** URL for Spacer service */
-    readonly spacerRunUrl: string;
+    readonly spacerUrl: string;
     /** Authentication token */
     token?: string;
     /** Method lifecycle handlers */
@@ -49,11 +49,11 @@ export declare class DatalayerClientBase {
      */
     getConfig(): DatalayerClientConfig;
     /** Get the IAM service URL. */
-    getIamRunUrl(): string;
+    getIamUrl(): string;
     /** Get the Runtimes service URL. */
-    getRuntimesRunUrl(): string;
+    getRuntimesUrl(): string;
     /** Get the Spacer service URL. */
-    getSpacerRunUrl(): string;
+    getSpacerUrl(): string;
     /** Get the current authentication token. */
     getToken(): string | undefined;
     /**

package/lib/client/base.js

@@ -11,11 +11,11 @@ import { AuthenticationManager } from './auth/index.js';
 /** Base Client class providing core configuration and token management. */
 export class DatalayerClientBase {
     /** URL for IAM service */
-    iamRunUrl;
+    iamUrl;
     /** URL for Runtimes service */
-    runtimesRunUrl;
+    runtimesUrl;
     /** URL for Spacer service */
-    spacerRunUrl;
+    spacerUrl;
     /** Authentication token */
     token;
     /** Method lifecycle handlers */
@@ -27,14 +27,14 @@ export class DatalayerClientBase {
      * @param config - Client configuration options
      */
     constructor(config) {
-        this.iamRunUrl = config.iamRunUrl || DEFAULT_SERVICE_URLS.IAM;
-        this.runtimesRunUrl =
-            config.runtimesRunUrl || DEFAULT_SERVICE_URLS.RUNTIMES;
-        this.spacerRunUrl = config.spacerRunUrl || DEFAULT_SERVICE_URLS.SPACER;
+        this.iamUrl = config.iamUrl || DEFAULT_SERVICE_URLS.IAM;
+        this.runtimesUrl =
+            config.runtimesUrl || DEFAULT_SERVICE_URLS.RUNTIMES;
+        this.spacerUrl = config.spacerUrl || DEFAULT_SERVICE_URLS.SPACER;
         this.token = config.token;
         this.handlers = config.handlers;
         // Initialize authentication manager with custom storage if provided
-        this.auth = new AuthenticationManager(this.iamRunUrl, config.storage);
+        this.auth = new AuthenticationManager(this.iamUrl, config.storage);
         // If a token was provided, store it in the auth manager
         if (this.token) {
             this.auth.storeToken(this.token);
@@ -46,23 +46,23 @@ export class DatalayerClientBase {
      */
     getConfig() {
         return {
-            iamRunUrl: this.iamRunUrl,
-            runtimesRunUrl: this.runtimesRunUrl,
-            spacerRunUrl: this.spacerRunUrl,
+            iamUrl: this.iamUrl,
+            runtimesUrl: this.runtimesUrl,
+            spacerUrl: this.spacerUrl,
             token: this.token,
         };
     }
     /** Get the IAM service URL. */
-    getIamRunUrl() {
-        return this.iamRunUrl;
+    getIamUrl() {
+        return this.iamUrl;
     }
     /** Get the Runtimes service URL. */
-    getRuntimesRunUrl() {
-        return this.runtimesRunUrl;
+    getRuntimesUrl() {
+        return this.runtimesUrl;
     }
     /** Get the Spacer service URL. */
-    getSpacerRunUrl() {
-        return this.spacerRunUrl;
+    getSpacerUrl() {
+        return this.spacerUrl;
     }
     /** Get the current authentication token. */
     getToken() {

package/lib/client/mixins/IAMMixin.js

@@ -29,8 +29,8 @@ export function IAMMixin(Base) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const token = this.getToken();
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await profile.whoami(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await profile.whoami(token, iamUrl);
             // Handle the whoami response format
             let userData;
             if (!response) {
@@ -83,8 +83,8 @@ export function IAMMixin(Base) {
         /** Log out the current user. */
         async logout() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await authentication.logout(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await authentication.logout(token, iamUrl);
             // Clear the token from the Client and cached user
             this.setToken('');
             this.currentUserCache = undefined;
@@ -95,8 +95,8 @@ export function IAMMixin(Base) {
          */
         async getCredits() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await usage.getCredits(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await usage.getCredits(token, iamUrl);
             if (!response || !response.credits) {
                 throw new Error('Invalid response from credits API');
             }
@@ -191,8 +191,8 @@ export function IAMMixin(Base) {
          */
         async createSecret(data) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.createSecret(token, data, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.createSecret(token, data, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -201,8 +201,8 @@ export function IAMMixin(Base) {
          */
         async listSecrets() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.listSecrets(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.listSecrets(token, iamUrl);
             return response.secrets.map(s => new SecretDTO(s, this));
         }
         /**
@@ -212,8 +212,8 @@ export function IAMMixin(Base) {
          */
         async getSecret(secretId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.getSecret(token, secretId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.getSecret(token, secretId, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -224,8 +224,8 @@ export function IAMMixin(Base) {
          */
         async updateSecret(secretId, updates) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await secrets.updateSecret(token, secretId, updates, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await secrets.updateSecret(token, secretId, updates, iamUrl);
             return new SecretDTO(response.secret, this);
         }
         /**
@@ -234,8 +234,8 @@ export function IAMMixin(Base) {
          */
         async deleteSecret(secretId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await secrets.deleteSecret(token, secretId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await secrets.deleteSecret(token, secretId, iamUrl);
         }
         // ========================================================================
         // Datasources Management
@@ -247,8 +247,8 @@ export function IAMMixin(Base) {
          */
         async createDatasource(data) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.createDatasource(token, data, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.createDatasource(token, data, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -257,8 +257,8 @@ export function IAMMixin(Base) {
          */
         async listDatasources() {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.listDatasources(token, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.listDatasources(token, iamUrl);
             return response.datasources.map(d => new DatasourceDTO(d, this));
         }
         /**
@@ -268,8 +268,8 @@ export function IAMMixin(Base) {
          */
         async getDatasource(datasourceId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.getDatasource(token, datasourceId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.getDatasource(token, datasourceId, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -280,8 +280,8 @@ export function IAMMixin(Base) {
          */
         async updateDatasource(datasourceId, updates) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            const response = await datasources.updateDatasource(token, datasourceId, updates, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            const response = await datasources.updateDatasource(token, datasourceId, updates, iamUrl);
             return new DatasourceDTO(response.datasource, this);
         }
         /**
@@ -290,8 +290,8 @@ export function IAMMixin(Base) {
          */
         async deleteDatasource(datasourceId) {
             const token = this.getToken();
-            const iamRunUrl = this.getIamRunUrl();
-            await datasources.deleteDatasource(token, datasourceId, iamRunUrl);
+            const iamUrl = this.getIamUrl();
+            await datasources.deleteDatasource(token, datasourceId, iamUrl);
         }
     };
 }

package/lib/components/auth/Login.js

@@ -22,7 +22,7 @@ export const Login = (props) => {
     const loginMutation = useLogin();
     const getOAuth2URLMutation = useOAuth2AuthorizationURL();
     const { loginAndNavigate, setLogin } = useIAM();
-    const { externalToken, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL, iamRunUrl, logout, checkIAMToken, } = useIAMStore();
+    const { externalToken, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL, iamUrl, logout, checkIAMToken, } = useIAMStore();
     const { enqueueToast } = useToast();
     const navigate = useNavigate();
     const [loading, setLoading] = useState(false);
@@ -76,7 +76,7 @@ export const Login = (props) => {
         if (!iamProvidersAuthorizationURL[IAMProvidersSpecs.LinkedIn.name]) {
             initIAMProvider(IAMProvidersSpecs.LinkedIn);
         }
-    }, [iamRunUrl, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL]);
+    }, [iamUrl, iamProvidersAuthorizationURL, addIAMProviderAuthorizationURL]);
     useEffect(() => {
         if (externalToken) {
             setLoadingWithToken(1);

package/lib/components/billing/BillingEntitySelect.d.ts

@@ -0,0 +1,35 @@
+export type BillingEntityType = 'user' | 'organization' | 'team';
+export type BillingEntity = {
+    accountUid: string;
+    accountType: BillingEntityType;
+    accountHandle: string;
+    accountName: string;
+    planName: string;
+    isEligible: boolean;
+    isPaidPlan: boolean;
+    sourceOrganizationUid?: string;
+    sourceOrganizationHandle?: string;
+    teamHandle?: string;
+};
+export type BillingEntitySelectProps = {
+    value: string;
+    onChange: (accountUid: string) => void;
+    onSelectedAccountChange?: (account: BillingEntity | undefined) => void;
+    onAccountsResolved?: (state: {
+        accounts: BillingEntity[];
+        eligibleAccounts: BillingEntity[];
+        isLoading: boolean;
+        hasEligibleAccount: boolean;
+    }) => void;
+    disabled?: boolean;
+    label?: string;
+    caption?: string;
+    emptyMessage?: string;
+    flashMessage?: string;
+    width?: string | number;
+    preferOrganizationDefault?: boolean;
+};
+export declare function resolveBillingPlanTier(value: unknown): 'free' | 'pro';
+export declare function formatBillingEntityPlanLabel(planName: string): string;
+export declare function BillingEntitySelect({ value, onChange, onSelectedAccountChange, onAccountsResolved, disabled, label, caption, emptyMessage, flashMessage, width, preferOrganizationDefault, }: BillingEntitySelectProps): JSX.Element;
+export default BillingEntitySelect;