byterover-cli 2.0.0 → 2.1.0

package/README.md

@@ -1,6 +1,6 @@
 # ByteRover CLI
 
-Command-line interface for ByteRover — an interactive REPL for managing your project's context tree and knowledge storage. Integrates with 22 AI coding agents including Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and more.
+Command-line interface for ByteRover — an interactive REPL for managing your project's context tree and knowledge storage. Integrates with 22+ AI coding agents.
 
 [![Version](https://img.shields.io/npm/v/byterover-cli.svg)](https://npmjs.org/package/byterover-cli)
 [![Downloads/week](https://img.shields.io/npm/dw/byterover-cli.svg)](https://npmjs.org/package/byterover-cli)
@@ -31,102 +31,27 @@ npm install -g byterover-cli
 brv --version
 ```
 
-### Uninstall
-
-If installed via `curl`:
-
-```bash
-curl -fsSL https://byterover.dev/uninstall.sh | sh
-```
-
-If installed via `npm`:
-
-```bash
-npm uninstall -g byterover-cli
-```
-
 ## Quick Start
 
-Visit [**ByteRover Docs**](https://docs.byterover.dev) for detailed guides.
-
-### 1. Start the REPL
-
 ```bash
 cd your/project
 brv
 ```
 
-The REPL auto-configures on first run — no setup commands needed.
-
-### 2. Curate and query
-
-Use `/curate` to add knowledge to your context tree and `/query` to retrieve it:
+The REPL auto-configures on first run — no setup needed. Use `/curate` to add knowledge and `/query` to retrieve it:
 
 ```
 /curate "Auth uses JWT with 24h expiry" @src/middleware/auth.ts
 /query How is authentication implemented?
 ```
 
-### 3. (Optional) Authenticate for cloud sync
-
-Authentication is only needed for syncing your context tree to the cloud via `/push` and `/pull`. Local usage works without login.
-
-```bash
-brv login -k <your-api-key>
-```
-
-Get your API key at [app.byterover.dev/settings/keys](https://app.byterover.dev/settings/keys).
-
-### 4. (Optional) Connect an LLM provider
-
-ByteRover works out of the box with its built-in provider. To use your own models, run `/providers` in the REPL to connect one of 20+ supported providers (Anthropic, OpenAI, Google, Groq, Mistral, and more).
-
-## Supported AI Agents
-
-ByteRover integrates with 22 AI coding agents including Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, Codex, Gemini CLI, Roo Code, Kiro, and more. Use `/connectors` in the REPL to manage integrations.
-
-See [ByteRover Docs](https://docs.byterover.dev) for the full list and integration details.
-
-## Key Commands
-
-### REPL Commands
-
-| Command                             | Description |
-|-------------------------------------|-------------|
-| `/curate [context] @files @folders` | Add context to the context tree |
-| `/query <question>`                 | Query the context tree (alias: `/q`) |
-| `/push [-b branch]`                 | Push context tree to cloud |
-| `/pull [-b branch]`                 | Pull context tree from cloud |
-| `/connectors`                       | Manage AI agent connectors |
-| `/hub`                              | Browse and install skills from the hub |
-| `/providers`                        | Connect an LLM provider |
-| `/model`                            | Select an LLM model |
-| `/status`                           | Show project and CLI status |
-| `/space`                            | Manage spaces |
-| `/new`                              | Start a fresh session |
-| `/login` / `/logout`                | Authenticate or log out |
-
-Type `/` in the REPL to see all commands with auto-completion.
-
-### CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `brv` | Start the interactive REPL |
-| `brv login -k <key>` | Authenticate with an API key |
-| `brv status` | Show CLI and project status |
-| `brv query <question>` | Query the context tree |
-| `brv curate [context]` | Curate context to the context tree |
-| `brv push` | Push context tree to cloud |
-| `brv pull` | Pull context tree from cloud |
+Type `/` in the REPL to discover all available commands.
 
-All commands support `--format json` flags for automation. Run `brv <command> --help` for details.
+## Documentation
 
-## Documentation & Help
+Visit [**docs.byterover.dev**](https://docs.byterover.dev) for full guides on cloud sync, AI agent integrations, LLM providers, and more.
 
-- [ByteRover Docs](https://docs.byterover.dev) — Full documentation
-- `brv --help` — CLI help
-- Type `/` in the REPL — Command discovery
+Run `brv --help` for CLI usage.
 
 ---
 

package/dist/agent/core/domain/llm/index.d.ts

@@ -4,6 +4,6 @@
  * Exports types, registry, and utilities for LLM provider abstraction.
  */
 export { ErrorScope, type ErrorScopeType, ErrorType, type ErrorTypeValue, LLMErrorCode, type LLMErrorCodeType, } from './error-codes.js';
-export { acceptsAnyModel, DEFAULT_CHARS_PER_TOKEN, DEFAULT_MAX_INPUT_TOKENS, getCharsPerToken, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getModelCapabilities, getModelInfo, getModelInfoWithFallback, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, isValidProviderModel, LLM_REGISTRY, modelSupportsFileType, } from './registry.js';
+export { acceptsAnyModel, DEFAULT_CHARS_PER_TOKEN, DEFAULT_MAX_INPUT_TOKENS, getCharsPerToken, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getModelCapabilities, getModelInfo, getModelInfoWithFallback, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, isValidProviderModel, LLM_REGISTRY, modelSupportsFileType, resolveRegistryProvider, } from './registry.js';
 export { type LLMConfig, LLMConfigBaseSchema, LLMConfigSchema, type LLMUpdates, LLMUpdatesSchema, safeParseLLMConfig, type ValidatedLLMConfig, validateLLMConfig, validateLLMUpdates, } from './schemas.js';
 export { getAllowedMimeTypes, getFileTypeFromMimeType, isSupportedMimeType, LLM_PROVIDERS, type LLMContext, type LLMProvider, type LLMTokenUsage, MIME_TYPE_TO_FILE_TYPE, type ModelCapabilities, type ModelInfo, PROVIDER_TYPES, type ProviderInfo, type ProviderType, SUPPORTED_FILE_TYPES, type SupportedFileType, } from './types.js';

package/dist/agent/core/domain/llm/index.js

@@ -6,7 +6,7 @@
 // Error Codes
 export { ErrorScope, ErrorType, LLMErrorCode, } from './error-codes.js';
 // Registry
-export { acceptsAnyModel, DEFAULT_CHARS_PER_TOKEN, DEFAULT_MAX_INPUT_TOKENS, getCharsPerToken, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getModelCapabilities, getModelInfo, getModelInfoWithFallback, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, isValidProviderModel, LLM_REGISTRY, modelSupportsFileType, } from './registry.js';
+export { acceptsAnyModel, DEFAULT_CHARS_PER_TOKEN, DEFAULT_MAX_INPUT_TOKENS, getCharsPerToken, getDefaultModelForProvider, getEffectiveMaxInputTokens, getMaxInputTokensForModel, getModelCapabilities, getModelInfo, getModelInfoWithFallback, getProviderFromModel, getSupportedFileTypesForModel, getSupportedModels, isValidProviderModel, LLM_REGISTRY, modelSupportsFileType, resolveRegistryProvider, } from './registry.js';
 // Schemas
 export { LLMConfigBaseSchema, LLMConfigSchema, LLMUpdatesSchema, safeParseLLMConfig, validateLLMConfig, validateLLMUpdates, } from './schemas.js';
 // Types

package/dist/agent/core/domain/llm/registry.d.ts

@@ -104,6 +104,14 @@ export declare function getModelCapabilities(provider: LLMProvider, model: strin
  * @returns Effective max input tokens (min of model limit and configured limit)
  */
 export declare function getEffectiveMaxInputTokens(provider: LLMProvider, model: string, configuredMax?: number): number;
+/**
+ * Resolve a user-facing provider ID (e.g. 'anthropic', 'openrouter', 'google-vertex')
+ * to a registry provider type ('claude' | 'gemini' | 'openai').
+ *
+ * Used by both AgentLLMService (tokenizer/formatter selection) and CipherAgent
+ * (registry-clamped maxInputTokens for map tools).
+ */
+export declare function resolveRegistryProvider(model: string, explicitProvider?: string): LLMProvider;
 /**
  * Check if OpenRouter accepts any model (custom models).
  * OpenRouter can route to many models not in our registry.

package/dist/agent/core/domain/llm/registry.js

@@ -622,6 +622,40 @@ export function getEffectiveMaxInputTokens(provider, model, configuredMax) {
     // Trust configuredMax when provided — it comes from an authoritative source like the OpenRouter API.
     return configuredMax ?? DEFAULT_MAX_INPUT_TOKENS;
 }
+/**
+ * Resolve a user-facing provider ID (e.g. 'anthropic', 'openrouter', 'google-vertex')
+ * to a registry provider type ('claude' | 'gemini' | 'openai').
+ *
+ * Used by both AgentLLMService (tokenizer/formatter selection) and CipherAgent
+ * (registry-clamped maxInputTokens for map tools).
+ */
+export function resolveRegistryProvider(model, explicitProvider) {
+    // 1. Explicit provider mapping takes priority
+    if (explicitProvider) {
+        if (explicitProvider === 'anthropic')
+            return 'claude';
+        if (explicitProvider === 'google' || explicitProvider === 'google-vertex')
+            return 'gemini';
+        if (['groq', 'mistral', 'openai', 'openai-compatible', 'openrouter', 'xai'].includes(explicitProvider)) {
+            return 'openai';
+        }
+    }
+    // 2. Use registry to detect provider from model name
+    const registryProvider = getProviderFromModel(model);
+    if (registryProvider)
+        return registryProvider;
+    // 3. Fallback to string prefix matching for unknown models
+    const lowerModel = model.toLowerCase();
+    if (lowerModel.startsWith('claude'))
+        return 'claude';
+    if (lowerModel.startsWith('gpt') ||
+        lowerModel.startsWith('o1') ||
+        lowerModel.startsWith('o3') ||
+        lowerModel.startsWith('o4')) {
+        return 'openai';
+    }
+    return 'gemini';
+}
 /**
  * Check if OpenRouter accepts any model (custom models).
  * OpenRouter can route to many models not in our registry.

package/dist/agent/core/domain/sandbox/types.d.ts

@@ -25,6 +25,8 @@ export interface REPLResult {
  * Configuration for sandbox execution.
  */
 export interface SandboxConfig {
+    /** Command type for gating SDK operations (e.g., 'query' disables curate/writeFile) */
+    commandType?: string;
     /** Context data to preload as "context" variable */
     contextPayload?: Record<string, unknown> | string | unknown[];
     /** Language: 'javascript' or 'typescript' (default: auto-detect) */

package/dist/agent/core/domain/tools/constants.d.ts

@@ -3,11 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export declare const ToolName: {
+    readonly AGENTIC_MAP: 'agentic_map';
     readonly CODE_EXEC: 'code_exec';
     readonly CURATE: 'curate';
+    readonly EXPAND_KNOWLEDGE: 'expand_knowledge';
     readonly GLOB_FILES: 'glob_files';
     readonly GREP_CONTENT: 'grep_content';
     readonly LIST_DIRECTORY: 'list_directory';
+    readonly LLM_MAP: 'llm_map';
     readonly READ_FILE: 'read_file';
     readonly SEARCH_KNOWLEDGE: 'search_knowledge';
     readonly WRITE_FILE: 'write_file';

package/dist/agent/core/domain/tools/constants.js

@@ -3,11 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export const ToolName = {
+    AGENTIC_MAP: 'agentic_map',
     CODE_EXEC: 'code_exec',
     CURATE: 'curate',
+    EXPAND_KNOWLEDGE: 'expand_knowledge',
     GLOB_FILES: 'glob_files',
     GREP_CONTENT: 'grep_content',
     LIST_DIRECTORY: 'list_directory',
+    LLM_MAP: 'llm_map',
     READ_FILE: 'read_file',
     SEARCH_KNOWLEDGE: 'search_knowledge',
     WRITE_FILE: 'write_file',

package/dist/agent/core/interfaces/cipher-services.d.ts

@@ -34,17 +34,15 @@ export interface CipherAgentServices {
     blobStorage: IBlobStorage;
     /**
      * CompactionService for context overflow management.
-     * Only available when granular storage is enabled (useGranularStorage: true).
      */
-    compactionService?: CompactionService;
+    compactionService: CompactionService;
     fileSystemService: FileSystemService;
     historyStorage: IHistoryStorage;
     memoryManager: MemoryManager;
     /**
      * MessageStorageService for direct granular message access.
-     * Only available when granular storage is enabled (useGranularStorage: true).
      */
-    messageStorageService?: MessageStorageService;
+    messageStorageService: MessageStorageService;
     policyEngine: IPolicyEngine;
     processService: ProcessService;
     sandboxService: ISandboxService;

package/dist/agent/core/interfaces/i-cipher-agent.d.ts

@@ -70,9 +70,15 @@ export interface ICipherAgent {
      *
      * @param taskId - Unique task identifier (used as part of session ID)
      * @param commandType - Command type for agent name tracking ('curate' | 'query')
+     * @param options - Optional configuration
+     * @param options.mapRootEligible - If true, registers the session as root-eligible for
+     *   agentic_map calls (Guard C). Only set for top-level task sessions that may invoke
+     *   agentic_map directly (e.g., curate-executor, folder-pack-executor). Defaults to false.
      * @returns Session ID of the created task session
      */
-    createTaskSession(taskId: string, commandType: string): Promise<string>;
+    createTaskSession(taskId: string, commandType: string, options?: {
+        mapRootEligible?: boolean;
+    }): Promise<string>;
     /**
      * Delete a sandbox variable from the agent's default session.
      *
@@ -120,6 +126,8 @@ export interface ICipherAgent {
      * @param sessionId - Session to execute on
      * @param input - User input string
      * @param options - Optional execution options
+     * @param options.executionContext - Optional context for command-specific behavior (curate/query/chat)
+     * @param options.taskId - Optional task ID for event routing (required for concurrent task isolation)
      * @returns Agent response
      */
     executeOnSession(sessionId: string, input: string, options?: {

package/dist/agent/core/interfaces/i-sandbox-service.d.ts

@@ -2,6 +2,7 @@ import type { ISearchKnowledgeService } from '../../infra/sandbox/tools-sdk.js';
 import type { SessionManager } from '../../infra/session/session-manager.js';
 import type { EnvironmentContext } from '../domain/environment/types.js';
 import type { REPLResult, SandboxConfig } from '../domain/sandbox/types.js';
+import type { IContentGenerator } from './i-content-generator.js';
 import type { ICurateService } from './i-curate-service.js';
 import type { IFileSystem } from './i-file-system.js';
 /**
@@ -36,6 +37,13 @@ export interface ISandboxService {
      * @returns Execution result with stdout, stderr, and locals
      */
     executeCode(code: string, sessionId: string, config?: SandboxConfig): Promise<REPLResult>;
+    /**
+     * Set the content generator for parallel LLM operations (mapExtract).
+     * When set, sandboxes will have access to `tools.curation.mapExtract()`.
+     *
+     * @param contentGenerator - Content generator instance
+     */
+    setContentGenerator?(contentGenerator: IContentGenerator): void;
     /**
      * Set the curate service for Tools SDK injection.
      * When set, sandboxes will have access to curate operations via `tools.curate()`.

package/dist/agent/core/interfaces/i-tool-provider.d.ts

@@ -62,4 +62,14 @@ export interface IToolProvider {
      * Registers all available tools based on available services.
      */
     initialize(): Promise<void>;
+    /**
+     * Atomically replace specific tools with new service dependencies.
+     * Builds new tool instances first, then swaps — if build fails, old tools remain.
+     * Throws if any requested tool cannot be rebuilt.
+     *
+     * @param toolNames - Names of tools to replace
+     * @param newServices - Updated services for tool construction (typed as Record at core level;
+     *                      infra implementation casts to Partial<ToolServices> internally)
+     */
+    replaceTools(toolNames: string[], newServices: Record<string, unknown>): void;
 }

package/dist/agent/core/interfaces/i-tool-scheduler.d.ts

@@ -8,6 +8,7 @@
  *
  * Based on gemini-cli's CoreToolScheduler pattern, simplified for autonomous mode.
  */
+import type { MetadataCallback } from '../domain/tools/types.js';
 import type { PolicyEvaluationResult } from './i-policy-engine.js';
 /**
  * Status of a scheduled tool execution.
@@ -58,6 +59,14 @@ export interface ScheduledToolExecution {
  * Context for tool execution.
  */
 export interface ToolSchedulerContext {
+    /**
+     * Command type for context-aware tool behavior (e.g., 'curate', 'query').
+     */
+    commandType?: string;
+    /**
+     * Callback for streaming metadata updates during execution.
+     */
+    metadata?: MetadataCallback;
     /**
      * Session ID for the current session.
      */

package/dist/agent/infra/agent/agent-schemas.d.ts

@@ -143,8 +143,6 @@ export declare const AgentConfigSchema: z.ZodObject<{
     providerApiKey: z.ZodOptional<z.ZodString>;
     providerBaseUrl: z.ZodOptional<z.ZodString>;
     providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    providerLocation: z.ZodOptional<z.ZodString>;
-    providerProject: z.ZodOptional<z.ZodString>;
     region: z.ZodOptional<z.ZodString>;
     sessionKey: z.ZodDefault<z.ZodString>;
     sessions: z.ZodDefault<z.ZodObject<{
@@ -161,7 +159,6 @@ export declare const AgentConfigSchema: z.ZodObject<{
     spaceId: z.ZodOptional<z.ZodString>;
     storagePath: z.ZodString;
     teamId: z.ZodOptional<z.ZodString>;
-    useGranularStorage: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     model: string;
     llm: {
@@ -180,7 +177,6 @@ export declare const AgentConfigSchema: z.ZodObject<{
     projectId: string;
     sessionKey: string;
     storagePath: string;
-    useGranularStorage: boolean;
     maxInputTokens?: number | undefined;
     provider?: string | undefined;
     blobStorage?: {
@@ -198,8 +194,6 @@ export declare const AgentConfigSchema: z.ZodObject<{
     providerApiKey?: string | undefined;
     providerBaseUrl?: string | undefined;
     providerHeaders?: Record<string, string> | undefined;
-    providerLocation?: string | undefined;
-    providerProject?: string | undefined;
     region?: string | undefined;
     siteName?: string | undefined;
     spaceId?: string | undefined;
@@ -238,14 +232,11 @@ export declare const AgentConfigSchema: z.ZodObject<{
     providerApiKey?: string | undefined;
     providerBaseUrl?: string | undefined;
     providerHeaders?: Record<string, string> | undefined;
-    providerLocation?: string | undefined;
-    providerProject?: string | undefined;
     region?: string | undefined;
     sessionKey?: string | undefined;
     siteName?: string | undefined;
     spaceId?: string | undefined;
     teamId?: string | undefined;
-    useGranularStorage?: boolean | undefined;
 }>;
 export type AgentConfig = z.input<typeof AgentConfigSchema>;
 export type ValidatedAgentConfig = z.output<typeof AgentConfigSchema>;

package/dist/agent/infra/agent/agent-schemas.js

@@ -63,8 +63,6 @@ export const AgentConfigSchema = z
     providerApiKey: z.string().optional().describe('API key for direct provider'),
     providerBaseUrl: z.string().optional().describe('Base URL for OpenAI-compatible provider'),
     providerHeaders: z.record(z.string()).optional().describe('Custom headers for provider'),
-    providerLocation: z.string().optional().describe('GCP location for Vertex AI (default: us-central1)'),
-    providerProject: z.string().optional().describe('GCP project ID for Vertex AI'),
     region: z.string().optional().describe('API region'),
     sessionKey: z.string().default('').describe('ByteRover session key'),
     sessions: SessionConfigSchema.default({}).describe('Session management configuration'),
@@ -72,7 +70,6 @@ export const AgentConfigSchema = z
     spaceId: z.string().optional().describe('ByteRover space ID'),
     storagePath: z.string().min(1).describe('XDG storage directory for blob, key, and session storage'),
     teamId: z.string().optional().describe('ByteRover team ID'),
-    useGranularStorage: z.boolean().default(false).describe('Enable granular history storage'),
 })
     .strict();
 /**

package/dist/agent/infra/agent/cipher-agent.d.ts

@@ -38,6 +38,8 @@ import { BaseAgent } from './base-agent.js';
 export declare class CipherAgent extends BaseAgent implements ICipherAgent {
     private readonly _agentEventBus;
     private readonly _brvConfig?;
+    /** Unique ID for this agent instance — scopes nesting registry ownership. */
+    private readonly _instanceId;
     private readonly _projectIdProvider?;
     /**
      * Session ID - created once during start().
@@ -50,6 +52,11 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
     private readonly _transportClient?;
     private readonly activeStreamControllers;
     private eventBridge?;
+    /**
+     * Tracks session IDs this agent instance registered as root-eligible.
+     * Used for bulk deregistration on agent teardown (cleanupServices).
+     */
+    private readonly rootEligibleSessions;
     private sessionManager?;
     /**
      * Creates a new CipherAgent instance.
@@ -105,7 +112,9 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      * Create a task-scoped child session for parallel execution.
      * The session gets its own sandbox, context manager, and LLM service.
      */
-    createTaskSession(taskId: string, commandType: string): Promise<string>;
+    createTaskSession(taskId: string, commandType: string, options?: {
+        mapRootEligible?: boolean;
+    }): Promise<string>;
     /**
      * Delete a sandbox variable from the agent's default session.
      */
@@ -255,4 +264,19 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
     private getSessionIdInternal;
     private getSessionManagerInternal;
     private getSystemPromptManagerInternal;
+    /**
+     * Handle SessionManager lifecycle removals (delete/end/TTL-expire) and keep
+     * root-eligible tracking synchronized with the global nesting registry.
+     */
+    private handleSessionRemoved;
+    /**
+     * Rebuild map tool dependencies and update ToolProvider + SandboxService.
+     * Called from both start() (initial setup) and refreshProviderConfig() (hot-swap).
+     */
+    private rebindMapTools;
+    /**
+     * Register a session as root-eligible and track it for lifecycle cleanup.
+     * Routes all root-eligible registrations through a single point.
+     */
+    private registerSessionInternal;
 }