byterover-cli 3.12.0 → 3.13.0

package/.env.production

@@ -4,4 +4,5 @@ BRV_COGIT_BASE_URL=https://v3-cgit.byterover.dev
 BRV_GIT_REMOTE_BASE_URL=https://byterover.dev
 BRV_LLM_BASE_URL=https://llm.byterover.dev
 BRV_WEB_APP_URL=https://app.byterover.dev
-BRV_UI_SOURCE=lib
+BRV_UI_SOURCE=lib
+BRV_BILLING_BASE_URL=https://v3-billing.byterover.dev

package/dist/oclif/commands/curate/index.js

@@ -4,7 +4,9 @@ import { BRV_DIR, CONTEXT_TREE_DIR } from '../../../server/constants.js';
 import { TransportStateEventNames } from '../../../server/core/domain/transport/index.js';
 import { extractCurateOperations } from '../../../server/utils/curate-result-parser.js';
 import { TaskEvents } from '../../../shared/transport/events/index.js';
+import { printBillingLine } from '../../lib/billing-line.js';
 import { formatConnectionError, hasLeakedHandles, providerMissingMessage, withDaemonRetry, } from '../../lib/daemon-client.js';
+import { ensureBillingFunds } from '../../lib/insufficient-credits.js';
 import { writeJsonResponse } from '../../lib/json-response.js';
 import { DEFAULT_TIMEOUT_SECONDS, MAX_TIMEOUT_SECONDS, MIN_TIMEOUT_SECONDS, waitForTaskCompletion } from '../../lib/task-client.js';
 export default class Curate extends Command {
@@ -104,6 +106,10 @@ Bad examples:
                 if (active.providerKeyMissing) {
                     throw new Error(providerMissingMessage(active.activeProvider, active.authMethod));
                 }
+                const billing = await printBillingLine({ client, format, log: (msg) => this.log(msg) });
+                if (billing) {
+                    await ensureBillingFunds({ billing, client });
+                }
                 await this.submitTask({ client, content: resolvedContent, flags, format, projectRoot, taskType, worktreeRoot });
             }, {
                 ...this.getDaemonClientOptions(),

package/dist/oclif/commands/providers/connect.d.ts

@@ -1,7 +1,17 @@
 import { Command } from '@oclif/core';
-import type { ProviderDTO } from '../../../shared/transport/types/dto.js';
+import type { ProviderDTO, TeamDTO } from '../../../shared/transport/types/dto.js';
 import { type ModelListResponse } from '../../../shared/transport/events/model-events.js';
 import { type DaemonClientOptions } from '../../lib/daemon-client.js';
+type ConnectInfo = {
+    kind: 'apikey';
+    model?: string;
+    providerId: string;
+    providerName: string;
+} | {
+    kind: 'oauth';
+    providerName: string;
+    showInstructions: boolean;
+};
 export default class ProviderConnect extends Command {
     static args: {
         provider: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
@@ -15,7 +25,10 @@ export default class ProviderConnect extends Command {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         oauth: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        team: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    protected applyTeamPin(team: string, options?: DaemonClientOptions): Promise<TeamDTO>;
+    protected buildPinPayload(team: TeamDTO | undefined): Record<string, unknown>;
     protected connectProvider({ apiKey, baseUrl, model, providerId }: {
         apiKey?: string;
         baseUrl?: string;
@@ -36,6 +49,9 @@ export default class ProviderConnect extends Command {
     protected disconnectProvider(providerId: string, options?: DaemonClientOptions): Promise<void>;
     protected fetchModels(providerId: string, options?: DaemonClientOptions): Promise<ModelListResponse>;
     protected fetchProviders(options?: DaemonClientOptions): Promise<ProviderDTO[]>;
+    protected fetchTeams(options?: DaemonClientOptions): Promise<TeamDTO[]>;
+    protected logPinResult(team: TeamDTO | undefined): void;
+    protected matchTeam(teams: readonly TeamDTO[], value: string): TeamDTO | undefined;
     protected promptForApiKey(providerName: string, apiKeyUrl?: string, signal?: AbortSignal): Promise<string>;
     protected promptForAuthMethod(provider: ProviderDTO, signal?: AbortSignal): Promise<'api-key' | 'oauth'>;
     protected promptForBaseUrl(signal?: AbortSignal): Promise<string>;
@@ -46,6 +62,12 @@ export default class ProviderConnect extends Command {
     }[], signal?: AbortSignal): Promise<string | undefined>;
     protected promptForOptionalApiKey(providerName: string, signal?: AbortSignal): Promise<string | undefined>;
     protected promptForProvider(providers: ProviderDTO[], signal?: AbortSignal): Promise<string>;
+    protected renderConnectSuccess(params: {
+        connectInfo: ConnectInfo;
+        format: 'json' | 'text';
+        pinnedTeam: TeamDTO | undefined;
+        providerId: string;
+    }): void;
     run(): Promise<void>;
     /**
      * Interactive flow with cancel-to-go-back navigation.
@@ -58,8 +80,11 @@ export default class ProviderConnect extends Command {
         code: string | undefined;
         model: string | undefined;
         oauth: boolean;
+        team: string | undefined;
     }, format: 'json' | 'text'): Promise<void>;
+    protected setBillingPin(teamId: string | undefined, options?: DaemonClientOptions): Promise<void>;
     /** Returns true when wizard should end (skip model step), false to continue to model step. */
     private runAuthStep;
     private runModelStep;
 }
+export {};

package/dist/oclif/commands/providers/connect.js

@@ -2,12 +2,15 @@ import { input, password, select, Separator } from '@inquirer/prompts';
 import { Args, Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
 import { OAUTH_CALLBACK_TIMEOUT_MS } from '../../../shared/constants/oauth.js';
+import { BillingEvents, } from '../../../shared/transport/events/billing-events.js';
 import { ModelEvents, } from '../../../shared/transport/events/model-events.js';
 import { ProviderEvents, } from '../../../shared/transport/events/provider-events.js';
+import { TeamEvents } from '../../../shared/transport/events/team-events.js';
 import { withDaemonRetry } from '../../lib/daemon-client.js';
 import { writeJsonResponse } from '../../lib/json-response.js';
 import { createEscapeSignal, isEscBack, isPromptCancelled, validateUrl, wizardSelectTheme, } from '../../lib/prompt-utils.js';
 import { createSpinner } from '../../lib/spinner.js';
+const BYTEROVER_PROVIDER_ID = 'byterover';
 export default class ProviderConnect extends Command {
     static args = {
         provider: Args.string({
@@ -21,6 +24,7 @@ export default class ProviderConnect extends Command {
         '<%= config.bin %> providers connect anthropic --api-key sk-xxx',
         '<%= config.bin %> providers connect openai --oauth',
         '<%= config.bin %> providers connect byterover',
+        '<%= config.bin %> providers connect byterover --team acme',
         '<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx',
     ];
     static flags = {
@@ -51,7 +55,25 @@ export default class ProviderConnect extends Command {
             default: false,
             description: 'Connect via OAuth (browser-based)',
         }),
+        team: Flags.string({
+            description: 'Pin this project to a billing team (byterover only). Accepts team name or slug.',
+        }),
     };
+    async applyTeamPin(team, options) {
+        const teams = await this.fetchTeams(options);
+        const match = this.matchTeam(teams, team);
+        if (!match) {
+            const list = teams.length === 0 ? '' : ` Available: ${teams.map((t) => t.displayName).join(', ')}.`;
+            throw new Error(`No team matched "${team}".${list}`);
+        }
+        await this.setBillingPin(match.id, options);
+        return match;
+    }
+    buildPinPayload(team) {
+        if (!team)
+            return {};
+        return { team: { cleared: false, displayName: team.displayName, organizationId: team.id } };
+    }
     async connectProvider({ apiKey, baseUrl, model, providerId }, options) {
         return withDaemonRetry(async (client) => {
             // 1. Verify provider exists
@@ -152,7 +174,24 @@ export default class ProviderConnect extends Command {
         const { providers } = await withDaemonRetry(async (client) => client.requestWithAck(ProviderEvents.LIST), options);
         return providers;
     }
-    // All prompt methods emit a blank line before rendering for visual spacing between wizard steps.
+    async fetchTeams(options) {
+        return withDaemonRetry(async (client) => {
+            const response = await client.requestWithAck(TeamEvents.LIST);
+            if (response.error)
+                throw new Error(response.error);
+            return response.teams ?? [];
+        }, options);
+    }
+    logPinResult(team) {
+        if (!team)
+            return;
+        this.log(`ByteRover usage on this project will be billed to ${team.displayName}.`);
+    }
+    matchTeam(teams, value) {
+        const lower = value.toLowerCase();
+        return (teams.find((t) => t.displayName.toLowerCase() === lower) ??
+            teams.find((t) => t.name.toLowerCase() === lower));
+    }
     async promptForApiKey(providerName, apiKeyUrl, signal) {
         this.log();
         const hint = apiKeyUrl ? ` (get one at ${apiKeyUrl}):` : ':';
@@ -244,6 +283,28 @@ export default class ProviderConnect extends Command {
             theme: wizardSelectTheme,
         }, { signal });
     }
+    renderConnectSuccess(params) {
+        const { connectInfo, format, pinnedTeam, providerId } = params;
+        if (format === 'json') {
+            const data = connectInfo.kind === 'oauth'
+                ? { providerId }
+                : { model: connectInfo.model, providerId: connectInfo.providerId, providerName: connectInfo.providerName };
+            writeJsonResponse({ command: 'providers connect', data: { ...data, ...this.buildPinPayload(pinnedTeam) }, success: true });
+            return;
+        }
+        if (connectInfo.kind === 'oauth') {
+            if (!connectInfo.showInstructions) {
+                this.log(`Connected to ${connectInfo.providerName} via OAuth`);
+            }
+        }
+        else {
+            this.log(`Connected to ${connectInfo.providerName} (${connectInfo.providerId})`);
+            if (connectInfo.model) {
+                this.log(`Model set to: ${connectInfo.model}`);
+            }
+        }
+        this.logPinResult(pinnedTeam);
+    }
     async run() {
         const { args, flags } = await this.parse(ProviderConnect);
         const providerId = args.provider;
@@ -275,6 +336,7 @@ export default class ProviderConnect extends Command {
             code: flags.code,
             model: flags.model,
             oauth: flags.oauth,
+            team: flags.team,
         }, format);
     }
     /**
@@ -358,7 +420,7 @@ export default class ProviderConnect extends Command {
         }
     }
     async runNonInteractive(providerId, flags, format) {
-        const { apiKey, baseUrl, code, model, oauth } = flags;
+        const { apiKey, baseUrl, code, model, oauth, team } = flags;
         if (oauth && apiKey) {
             const msg = 'Cannot use --oauth and --api-key together';
             if (format === 'json') {
@@ -379,29 +441,34 @@ export default class ProviderConnect extends Command {
             }
             return;
         }
+        if (team !== undefined && providerId !== BYTEROVER_PROVIDER_ID) {
+            const msg = `--team is only supported for the "${BYTEROVER_PROVIDER_ID}" provider.`;
+            if (format === 'json') {
+                writeJsonResponse({ command: 'providers connect', data: { error: msg }, success: false });
+            }
+            else {
+                this.log(msg);
+            }
+            return;
+        }
         try {
+            let connectInfo;
             if (oauth) {
                 const onProgress = format === 'text' ? (msg) => this.log(msg) : undefined;
                 const result = await this.connectProviderOAuth({ code, providerId }, undefined, onProgress);
-                if (format === 'json') {
-                    writeJsonResponse({ command: 'providers connect', data: { providerId }, success: true });
-                }
-                else if (!result.showInstructions) {
-                    this.log(`Connected to ${result.providerName} via OAuth`);
-                }
+                connectInfo = { kind: 'oauth', providerName: result.providerName, showInstructions: result.showInstructions };
             }
             else {
                 const result = await this.connectProvider({ apiKey, baseUrl, model, providerId });
-                if (format === 'json') {
-                    writeJsonResponse({ command: 'providers connect', data: result, success: true });
-                }
-                else {
-                    this.log(`Connected to ${result.providerName} (${result.providerId})`);
-                    if (result.model) {
-                        this.log(`Model set to: ${result.model}`);
-                    }
-                }
+                connectInfo = {
+                    kind: 'apikey',
+                    model: result.model,
+                    providerId: result.providerId,
+                    providerName: result.providerName,
+                };
             }
+            const pinnedTeam = team === undefined ? undefined : await this.applyTeamPin(team);
+            this.renderConnectSuccess({ connectInfo, format, pinnedTeam, providerId });
         }
         catch (error) {
             const errorMessage = error instanceof Error
@@ -415,6 +482,17 @@ export default class ProviderConnect extends Command {
             }
         }
     }
+    async setBillingPin(teamId, options) {
+        await withDaemonRetry(async (client, projectRoot) => {
+            if (!projectRoot)
+                throw new Error('Failed to resolve project path for billing pin.');
+            const request = teamId === undefined ? { projectPath: projectRoot } : { projectPath: projectRoot, teamId };
+            const response = await client.requestWithAck(BillingEvents.SET_PINNED_TEAM, request);
+            if (!response.success) {
+                throw new Error(response.error ?? 'Failed to update billing pin.');
+            }
+        }, options);
+    }
     /* eslint-disable no-await-in-loop -- intentional retry loop for interactive auth */
     /** Returns true when wizard should end (skip model step), false to continue to model step. */
     async runAuthStep(providerId, provider, signal) {

package/dist/oclif/commands/providers/list.d.ts

@@ -1,12 +1,21 @@
 import { Command } from '@oclif/core';
+import type { StatusBillingDTO, TeamDTO } from '../../../shared/transport/types/dto.js';
 import { type ProviderListResponse } from '../../../shared/transport/events/provider-events.js';
 import { type DaemonClientOptions } from '../../lib/daemon-client.js';
+interface ProvidersListData {
+    billing?: StatusBillingDTO;
+    providers: ProviderListResponse['providers'];
+    teams: TeamDTO[];
+}
 export default class ProviderList extends Command {
     static description: string;
     static examples: string[];
     static flags: {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    protected fetchProviders(options?: DaemonClientOptions): Promise<ProviderListResponse>;
+    protected billingMarker(teamId: string, billing?: StatusBillingDTO): string | undefined;
+    protected fetchAll(options?: DaemonClientOptions): Promise<ProvidersListData>;
+    protected printByteRoverTeams(teams: readonly TeamDTO[], billing?: StatusBillingDTO): void;
     run(): Promise<void>;
 }
+export {};

package/dist/oclif/commands/providers/list.js

@@ -1,8 +1,12 @@
 import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
+import { BillingEvents } from '../../../shared/transport/events/billing-events.js';
 import { ProviderEvents } from '../../../shared/transport/events/provider-events.js';
+import { TeamEvents } from '../../../shared/transport/events/team-events.js';
 import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
 import { writeJsonResponse } from '../../lib/json-response.js';
+const BYTEROVER_PROVIDER_ID = 'byterover';
+const EMPTY_TEAMS = { teams: [] };
 export default class ProviderList extends Command {
     static description = 'List all available providers and their connection status';
     static examples = ['<%= config.bin %> providers list', '<%= config.bin %> providers list --format json'];
@@ -13,14 +17,39 @@ export default class ProviderList extends Command {
             options: ['text', 'json'],
         }),
     };
-    async fetchProviders(options) {
-        return withDaemonRetry(async (client) => client.requestWithAck(ProviderEvents.LIST), options);
+    billingMarker(teamId, billing) {
+        if (billing?.source !== 'paid')
+            return undefined;
+        if (billing.organizationId !== teamId)
+            return undefined;
+        return 'billing';
+    }
+    async fetchAll(options) {
+        return withDaemonRetry(async (client) => {
+            const { providers } = await client.requestWithAck(ProviderEvents.LIST);
+            const byterover = providers.find((p) => p.id === BYTEROVER_PROVIDER_ID);
+            if (!byterover?.isConnected)
+                return { providers, teams: [] };
+            const [teamsResponse, billingResponse] = await Promise.all([
+                client.requestWithAck(TeamEvents.LIST).catch(() => EMPTY_TEAMS),
+                client.requestWithAck(BillingEvents.RESOLVE).catch(() => { }),
+            ]);
+            return { billing: billingResponse?.billing, providers, teams: teamsResponse.teams ?? [] };
+        }, options);
+    }
+    printByteRoverTeams(teams, billing) {
+        this.log(`    ${chalk.dim('Your teams:')}`);
+        for (const team of teams) {
+            const marker = this.billingMarker(team.id, billing);
+            const suffix = marker ? ` ${chalk.dim(`(${marker})`)}` : '';
+            this.log(`      ${team.displayName}${suffix}`);
+        }
     }
     async run() {
         const { flags } = await this.parse(ProviderList);
         const format = flags.format;
         try {
-            const { providers } = await this.fetchProviders();
+            const { billing, providers, teams } = await this.fetchAll();
             if (format === 'json') {
                 writeJsonResponse({ command: 'providers list', data: { providers }, success: true });
                 return;
@@ -32,6 +61,9 @@ export default class ProviderList extends Command {
                 if (p.description) {
                     this.log(`    ${chalk.dim(p.description)}`);
                 }
+                if (p.id === BYTEROVER_PROVIDER_ID && p.isConnected && teams.length > 0) {
+                    this.printByteRoverTeams(teams, billing);
+                }
             }
         }
         catch (error) {

package/dist/oclif/commands/query.js

@@ -2,7 +2,9 @@ import { Args, Command, Flags } from '@oclif/core';
 import { randomUUID } from 'node:crypto';
 import { TransportStateEventNames } from '../../server/core/domain/transport/schemas.js';
 import { TaskEvents } from '../../shared/transport/events/index.js';
+import { printBillingLine } from '../lib/billing-line.js';
 import { formatConnectionError, hasLeakedHandles, providerMissingMessage, withDaemonRetry, } from '../lib/daemon-client.js';
+import { ensureBillingFunds } from '../lib/insufficient-credits.js';
 import { writeJsonResponse } from '../lib/json-response.js';
 import { DEFAULT_TIMEOUT_SECONDS, MAX_TIMEOUT_SECONDS, MIN_TIMEOUT_SECONDS, waitForTaskCompletion } from '../lib/task-client.js';
 export default class Query extends Command {
@@ -62,6 +64,10 @@ Bad:
                 if (active.providerKeyMissing) {
                     throw new Error(providerMissingMessage(active.activeProvider, active.authMethod));
                 }
+                const billing = await printBillingLine({ client, format, log: (msg) => this.log(msg) });
+                if (billing) {
+                    await ensureBillingFunds({ billing, client });
+                }
                 await this.submitTask({
                     client,
                     format,

package/dist/oclif/commands/status.js

@@ -2,6 +2,7 @@ import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
 import { StatusEvents, } from '../../shared/transport/events/status-events.js';
 import { formatConnectionError, withDaemonRetry } from '../lib/daemon-client.js';
+import { formatBillingLine } from '../lib/format-billing-line.js';
 import { writeJsonResponse } from '../lib/json-response.js';
 export default class Status extends Command {
     static description = 'Show CLI status and project information. Display local context tree managed by ByteRover CLI';
@@ -114,6 +115,9 @@ export default class Status extends Command {
         else {
             this.log('Space: Not connected');
         }
+        if (status.billing) {
+            this.log(formatBillingLine(status.billing));
+        }
         // Context tree status
         switch (status.contextTreeStatus) {
             case 'git_vc': {

package/dist/oclif/lib/billing-line.d.ts

@@ -0,0 +1,8 @@
+import type { ITransportClient } from '@campfirein/brv-transport-client';
+import type { StatusBillingDTO } from '../../shared/transport/types/dto.js';
+export interface PrintBillingLineDeps {
+    client: ITransportClient;
+    format: 'json' | 'text';
+    log: (msg: string) => void;
+}
+export declare function printBillingLine(deps: PrintBillingLineDeps): Promise<StatusBillingDTO | undefined>;

package/dist/oclif/lib/billing-line.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import { BillingEvents, } from '../../shared/transport/events/billing-events.js';
+import { formatBillingLine } from './format-billing-line.js';
+const SKIP_SOURCES = new Set(['other-provider']);
+const LOW_CREDIT_RATIO = 0.1;
+function tone(billing) {
+    if (billing.source === 'other-provider')
+        return 'normal';
+    const { remaining, total } = billing;
+    if (remaining === undefined || total === undefined || total <= 0)
+        return 'normal';
+    if (remaining <= 0)
+        return 'danger';
+    if (remaining / total < LOW_CREDIT_RATIO)
+        return 'warn';
+    return 'normal';
+}
+function colorize(line, t) {
+    switch (t) {
+        case 'danger': {
+            return chalk.red(line);
+        }
+        case 'warn': {
+            return chalk.yellow(line);
+        }
+        default: {
+            return chalk.dim(line);
+        }
+    }
+}
+export async function printBillingLine(deps) {
+    try {
+        const response = await deps.client.requestWithAck(BillingEvents.RESOLVE);
+        const { billing } = response;
+        if (!billing)
+            return undefined;
+        if (deps.format === 'text' && !SKIP_SOURCES.has(billing.source)) {
+            deps.log(colorize(formatBillingLine(billing), tone(billing)));
+        }
+        return billing;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/oclif/lib/format-billing-line.d.ts

@@ -0,0 +1,2 @@
+import type { StatusBillingDTO } from '../../shared/transport/types/dto.js';
+export declare function formatBillingLine(billing: StatusBillingDTO): string;

package/dist/oclif/lib/format-billing-line.js

@@ -0,0 +1,19 @@
+export function formatBillingLine(billing) {
+    if (billing.source === 'other-provider') {
+        return `Using ${billing.activeProvider ?? 'another provider'}`;
+    }
+    if (billing.source === 'free') {
+        const { remaining, total } = billing;
+        if (remaining === undefined || total === undefined)
+            return 'Billing: Personal free credits';
+        return `Billing: Personal free credits (${formatNumber(remaining)} / ${formatNumber(total)})`;
+    }
+    const label = billing.organizationName ?? billing.organizationId;
+    if (billing.remaining === undefined || billing.tier === undefined) {
+        return `Billing: ${label} (usage unavailable)`;
+    }
+    return `Billing: ${label} (${formatNumber(billing.remaining)} credits, ${billing.tier})`;
+}
+function formatNumber(value) {
+    return value.toLocaleString('en-US');
+}

package/dist/oclif/lib/insufficient-credits.d.ts

@@ -0,0 +1,11 @@
+import type { ITransportClient } from '@campfirein/brv-transport-client';
+import type { StatusBillingDTO } from '../../shared/transport/types/dto.js';
+export declare class InsufficientCreditsError extends Error {
+    constructor(message: string);
+}
+export declare function isBillingExhausted(billing: StatusBillingDTO): boolean;
+export interface EnsureBillingFundsDeps {
+    billing: StatusBillingDTO;
+    client: ITransportClient;
+}
+export declare function ensureBillingFunds(deps: EnsureBillingFundsDeps): Promise<void>;

package/dist/oclif/lib/insufficient-credits.js

@@ -0,0 +1,36 @@
+import { BillingEvents } from '../../shared/transport/events/billing-events.js';
+export class InsufficientCreditsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InsufficientCreditsError';
+    }
+}
+export function isBillingExhausted(billing) {
+    if (billing.source === 'other-provider')
+        return false;
+    return billing.remaining !== undefined && billing.remaining <= 0;
+}
+export async function ensureBillingFunds(deps) {
+    if (!isBillingExhausted(deps.billing))
+        return;
+    if (deps.billing.source === 'free') {
+        throw new InsufficientCreditsError('Your free monthly credits are exhausted. Upgrade to a paid team to continue using ByteRover provider.');
+    }
+    const currentTeamId = 'organizationId' in deps.billing ? deps.billing.organizationId : undefined;
+    const teams = await fetchOtherPaidTeamNames(deps.client, currentTeamId);
+    const suffix = teams.length > 0 ? ` Available teams: ${teams.join(', ')}.` : '';
+    throw new InsufficientCreditsError('ByteRover billing team is out of credits. Top up the team, or switch billing target with ' +
+        '`brv providers connect byterover --team <name>` before re-running.' +
+        suffix);
+}
+async function fetchOtherPaidTeamNames(client, excludeTeamId) {
+    try {
+        const response = await client.requestWithAck(BillingEvents.LIST_USAGE);
+        return Object.values(response.usage ?? {})
+            .filter((usage) => usage.tier !== 'FREE' && usage.organizationId !== excludeTeamId)
+            .map((usage) => usage.organizationName);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/server/config/environment.d.ts

@@ -15,6 +15,7 @@ export declare const ENVIRONMENT: Environment;
  */
 type EnvironmentConfig = {
     authorizationUrl: string;
+    billingBaseUrl: string;
     clientId: string;
     cogitBaseUrl: string;
     gitRemoteBaseUrl: string;

package/dist/server/config/environment.js

@@ -41,9 +41,12 @@ export const getCurrentConfig = () => {
     assertRootDomain('BRV_IAM_BASE_URL', iamBaseUrl);
     const cogitBaseUrl = readRequiredEnv('BRV_COGIT_BASE_URL');
     assertRootDomain('BRV_COGIT_BASE_URL', cogitBaseUrl);
+    const billingBaseUrl = readRequiredEnv('BRV_BILLING_BASE_URL');
+    assertRootDomain('BRV_BILLING_BASE_URL', billingBaseUrl);
     const oidcBase = `${iamBaseUrl}${API_V1_PATH}/oidc`;
     return {
         authorizationUrl: `${oidcBase}/authorize`,
+        billingBaseUrl,
         clientId: DEFAULTS.clientId,
         cogitBaseUrl,
         gitRemoteBaseUrl: readRequiredEnv('BRV_GIT_REMOTE_BASE_URL'),

package/dist/server/core/domain/transport/schemas.d.ts

@@ -449,6 +449,8 @@ export declare const TransportAgentEventNames: {
  */
 export declare const TransportStateEventNames: {
     readonly GET_AUTH: "state:getAuth";
+    readonly GET_BILLING_CONFIG: "state:getBillingConfig";
+    readonly GET_PAID_ORGANIZATIONS: "state:getPaidOrganizations";
     readonly GET_PROJECT_CONFIG: "state:getProjectConfig";
     readonly GET_PROVIDER_CONFIG: "state:getProviderConfig";
 };
@@ -457,8 +459,23 @@ export declare const TransportStateEventNames: {
  * Used to notify agent child processes of global state changes.
  */
 export declare const TransportDaemonEventNames: {
+    readonly BILLING_PIN_CHANGED: "billing:pinChanged";
     readonly PROVIDER_UPDATED: "provider:updated";
 };
+export interface BillingStateRequest {
+    projectPath: string;
+}
+export interface BillingStateResponse {
+    pinnedTeamId?: string;
+}
+export interface BillingPinChangedPayload {
+    projectPath: string;
+    teamId?: string;
+}
+export interface PaidOrganizationsResponse {
+    error?: string;
+    organizationIds: string[];
+}
 /**
  * Response payload for GET_PROVIDER_CONFIG — shared between daemon and agent process.
  *

package/dist/server/core/domain/transport/schemas.js

@@ -278,6 +278,8 @@ export const TransportAgentEventNames = {
  */
 export const TransportStateEventNames = {
     GET_AUTH: 'state:getAuth',
+    GET_BILLING_CONFIG: 'state:getBillingConfig',
+    GET_PAID_ORGANIZATIONS: 'state:getPaidOrganizations',
     GET_PROJECT_CONFIG: 'state:getProjectConfig',
     GET_PROVIDER_CONFIG: 'state:getProviderConfig',
 };
@@ -286,6 +288,7 @@ export const TransportStateEventNames = {
  * Used to notify agent child processes of global state changes.
  */
 export const TransportDaemonEventNames = {
+    BILLING_PIN_CHANGED: 'billing:pinChanged',
     PROVIDER_UPDATED: 'provider:updated',
 };
 /**

package/dist/server/core/interfaces/services/i-billing-service.d.ts

@@ -0,0 +1,26 @@
+import type { BillingFreeUserLimitDTO, BillingOrganizationTierDTO, BillingUsageDTO } from '../../../../shared/transport/types/dto.js';
+/**
+ * Reads compute-unit usage from the ByteRover billing service.
+ * Implementations may be HTTP-based (production) or stubbed (tests).
+ */
+export interface IBillingService {
+    /**
+     * Returns the user's free-tier daily/monthly limits.
+     *
+     * @param sessionKey Authenticated session token (passed via x-byterover-session-id).
+     */
+    getFreeUserLimit: (sessionKey: string) => Promise<BillingFreeUserLimitDTO>;
+    /**
+     * Returns the tier (FREE/PRO/ENTERPRISE) for every org the user belongs to.
+     *
+     * @param sessionKey Authenticated session token (passed via x-byterover-session-id).
+     */
+    getTiers: (sessionKey: string) => Promise<BillingOrganizationTierDTO[]>;
+    /**
+     * Fetches usage for every organization the authenticated user belongs to in
+     * a single round trip. Replaces the old per-org `getUsageByProjects` fan-out.
+     *
+     * @param sessionKey Authenticated session token (passed via x-byterover-session-id).
+     */
+    getUsages: (sessionKey: string) => Promise<BillingUsageDTO[]>;
+}

package/dist/server/core/interfaces/services/i-billing-service.js

@@ -0,0 +1 @@
+export {};

package/dist/server/core/interfaces/storage/i-billing-config-store.d.ts

@@ -0,0 +1,4 @@
+export interface IBillingConfigStore {
+    getPinnedTeamId: () => Promise<string | undefined>;
+    setPinnedTeamId: (teamId: string | undefined) => Promise<void>;
+}

package/dist/server/core/interfaces/storage/i-billing-config-store.js

@@ -0,0 +1 @@
+export {};