byterover-cli 1.8.0 → 2.1.0

package/dist/agent/core/interfaces/i-session-persistence.d.ts

@@ -2,7 +2,7 @@
  * Interface for Session Persistence Operations
  *
  * Defines the contract for session metadata storage and retrieval.
- * Implementation uses JSON files in .brv/sessions/ directory.
+ * Implementation uses JSON files in the XDG sessions directory.
  */
 import type { ActiveSessionPointer, SessionInfo, SessionMetadata } from '../domain/session/session-metadata.js';
 /**
@@ -32,7 +32,7 @@ export interface SessionCleanupResult {
 /**
  * Interface for session metadata persistence.
  *
- * Manages session metadata stored in .brv/sessions/ directory:
+ * Manages session metadata stored in the XDG sessions directory:
  * - active.json: Current active session pointer
  * - session-*.json: Individual session metadata files
  */
@@ -44,18 +44,6 @@ export interface ISessionPersistence {
      * @returns Cleanup result with counts
      */
     cleanupSessions(config: SessionRetentionConfig): Promise<SessionCleanupResult>;
-    /**
-     * Clear the active session pointer.
-     * Removes .brv/sessions/active.json
-     */
-    clearActiveSession(): Promise<void>;
-    /**
-     * Delete a session and its metadata.
-     *
-     * @param sessionId - Session ID to delete
-     * @returns True if session was deleted, false if not found
-     */
-    deleteSession(sessionId: string): Promise<boolean>;
     /**
      * Get the currently active session pointer.
      *
@@ -88,13 +76,6 @@ export interface ISessionPersistence {
      * @returns Array of session info sorted by lastUpdated (newest first)
      */
     listSessions(): Promise<SessionInfo[]>;
-    /**
-     * Mark a session as ended.
-     * Updates the session status to 'ended' and lastUpdated timestamp.
-     *
-     * @param sessionId - Session ID to mark as ended
-     */
-    markSessionEnded(sessionId: string): Promise<void>;
     /**
      * Mark a session as interrupted (e.g., process crashed).
      * Updates the session status to 'interrupted'.
@@ -111,23 +92,9 @@ export interface ISessionPersistence {
     saveSession(metadata: SessionMetadata): Promise<void>;
     /**
      * Set the active session pointer.
-     * Creates or updates .brv/sessions/active.json
+     * Creates or updates active.json in sessions directory
      *
      * @param sessionId - Session ID to set as active
      */
     setActiveSession(sessionId: string): Promise<void>;
-    /**
-     * Set session title from first user message.
-     *
-     * @param sessionId - Session ID to update
-     * @param title - Session title
-     */
-    setSessionTitle(sessionId: string, title: string): Promise<void>;
-    /**
-     * Update session activity (lastUpdated timestamp and message count).
-     *
-     * @param sessionId - Session ID to update
-     * @param messageCount - Current message count
-     */
-    updateSessionActivity(sessionId: string, messageCount: number): Promise<void>;
 }

package/dist/agent/core/interfaces/i-session-persistence.js

@@ -2,6 +2,6 @@
  * Interface for Session Persistence Operations
  *
  * Defines the contract for session metadata storage and retrieval.
- * Implementation uses JSON files in .brv/sessions/ directory.
+ * Implementation uses JSON files in the XDG sessions directory.
  */
 export {};

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

@@ -85,7 +85,6 @@ export type ValidatedBlobStorageConfig = z.output<typeof BlobStorageConfigSchema
  * configuration with all defaults applied.
  */
 export declare const AgentConfigSchema: z.ZodObject<{
-    accessToken: z.ZodString;
     apiBaseUrl: z.ZodString;
     blobStorage: z.ZodOptional<z.ZodObject<{
         maxBlobSize: z.ZodDefault<z.ZodNumber>;
@@ -136,11 +135,16 @@ export declare const AgentConfigSchema: z.ZodObject<{
         topP?: number | undefined;
         verbose?: boolean | undefined;
     }>>;
+    maxInputTokens: z.ZodOptional<z.ZodNumber>;
     model: z.ZodString;
     openRouterApiKey: z.ZodOptional<z.ZodString>;
     projectId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    providerApiKey: z.ZodOptional<z.ZodString>;
+    providerBaseUrl: z.ZodOptional<z.ZodString>;
+    providerHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     region: z.ZodOptional<z.ZodString>;
-    sessionKey: z.ZodString;
+    sessionKey: z.ZodDefault<z.ZodString>;
     sessions: z.ZodDefault<z.ZodObject<{
         maxSessions: z.ZodDefault<z.ZodNumber>;
         sessionTTL: z.ZodDefault<z.ZodNumber>;
@@ -153,8 +157,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
     }>>;
     siteName: z.ZodOptional<z.ZodString>;
     spaceId: z.ZodOptional<z.ZodString>;
+    storagePath: z.ZodString;
     teamId: z.ZodOptional<z.ZodString>;
-    useGranularStorage: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     model: string;
     llm: {
@@ -169,11 +173,12 @@ export declare const AgentConfigSchema: z.ZodObject<{
         maxSessions: number;
         sessionTTL: number;
     };
-    accessToken: string;
     apiBaseUrl: string;
     projectId: string;
     sessionKey: string;
-    useGranularStorage: boolean;
+    storagePath: string;
+    maxInputTokens?: number | undefined;
+    provider?: string | undefined;
     blobStorage?: {
         maxTotalSize: number;
         maxBlobSize: number;
@@ -186,16 +191,18 @@ export declare const AgentConfigSchema: z.ZodObject<{
     } | undefined;
     httpReferer?: string | undefined;
     openRouterApiKey?: string | undefined;
+    providerApiKey?: string | undefined;
+    providerBaseUrl?: string | undefined;
+    providerHeaders?: Record<string, string> | undefined;
     region?: string | undefined;
     siteName?: string | undefined;
     spaceId?: string | undefined;
     teamId?: string | undefined;
 }, {
     model: string;
-    accessToken: string;
     apiBaseUrl: string;
     projectId: string;
-    sessionKey: string;
+    storagePath: string;
     llm?: {
         maxIterations?: number | undefined;
         temperature?: number | undefined;
@@ -204,6 +211,8 @@ export declare const AgentConfigSchema: z.ZodObject<{
         topP?: number | undefined;
         verbose?: boolean | undefined;
     } | undefined;
+    maxInputTokens?: number | undefined;
+    provider?: string | undefined;
     sessions?: {
         maxSessions?: number | undefined;
         sessionTTL?: number | undefined;
@@ -220,11 +229,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
     } | undefined;
     httpReferer?: string | undefined;
     openRouterApiKey?: string | undefined;
+    providerApiKey?: string | undefined;
+    providerBaseUrl?: string | undefined;
+    providerHeaders?: Record<string, 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

@@ -50,22 +50,26 @@ export const BlobStorageConfigSchema = z
  */
 export const AgentConfigSchema = z
     .object({
-    accessToken: z.string().min(1).describe('ByteRover access token'),
     apiBaseUrl: z.string().url().describe('ByteRover API base URL'),
     blobStorage: BlobStorageConfigSchema.optional().describe('Blob storage configuration'),
     fileSystem: FileSystemConfigSchema.optional().describe('File system configuration'),
     httpReferer: z.string().optional().describe('HTTP Referer for OpenRouter rankings'),
     llm: LLMConfigSchema.default({}).describe('LLM configuration'),
+    maxInputTokens: z.number().positive().optional().describe('Context window size from provider API'),
     model: z.string().min(1).describe('LLM model identifier'),
-    openRouterApiKey: z.string().optional().describe('OpenRouter API key'),
+    openRouterApiKey: z.string().optional().describe('OpenRouter API key (backward compat)'),
     projectId: z.string().min(1).describe('ByteRover project ID'),
+    provider: z.string().optional().describe('Direct provider ID (anthropic, openai, google, xai, groq, mistral)'),
+    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'),
     region: z.string().optional().describe('API region'),
-    sessionKey: z.string().min(1).describe('ByteRover session key'),
+    sessionKey: z.string().default('').describe('ByteRover session key'),
     sessions: SessionConfigSchema.default({}).describe('Session management configuration'),
     siteName: z.string().optional().describe('Site name for OpenRouter rankings'),
     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

@@ -1,3 +1,4 @@
+import type { ITransportClient } from '@campfirein/brv-transport-client';
 import type { BrvConfig } from '../../../server/core/domain/entities/brv-config.js';
 import type { GenerateResponse, StreamingEvent, StreamOptions } from '../../core/domain/streaming/types.js';
 import type { CipherAgentServices } from '../../core/interfaces/cipher-services.js';
@@ -11,6 +12,7 @@ import type { SystemPromptManager } from '../system-prompt/system-prompt-manager
 import type { ToolManager } from '../tools/tool-manager.js';
 import type { ToolProvider } from '../tools/tool-provider.js';
 import type { AgentConfig } from './agent-schemas.js';
+import type { ProviderUpdateConfig } from './provider-update-config.js';
 import { AgentEventBus } from '../events/event-emitter.js';
 import { BaseAgent } from './base-agent.js';
 /**
@@ -36,12 +38,25 @@ 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().
      * Each agent has exactly 1 session (Single-Session pattern).
      */
     private _sessionId?;
+    private readonly _sessionKeyProvider?;
+    private readonly _spaceIdProvider?;
+    private readonly _teamIdProvider?;
+    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.
@@ -49,8 +64,20 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      *
      * @param config - Agent configuration (Zod-validated AgentConfig)
      * @param brvConfig - Optional ByteRover config for spaceId/teamId
+     * @param options - Optional lazy providers and transport client; resolved per HTTP request from StateServer
+     * @param options.projectIdProvider - Lazy provider for project ID
+     * @param options.sessionKeyProvider - Lazy provider for session key
+     * @param options.spaceIdProvider - Lazy provider for space ID
+     * @param options.teamIdProvider - Lazy provider for team ID
+     * @param options.transportClient - Transport client for daemon communication
      */
-    constructor(config: AgentConfig, brvConfig?: BrvConfig);
+    constructor(config: AgentConfig, brvConfig?: BrvConfig, options?: {
+        projectIdProvider?: () => string;
+        sessionKeyProvider?: () => string;
+        spaceIdProvider?: () => string;
+        teamIdProvider?: () => string;
+        transportClient?: ITransportClient;
+    });
     get agentEventBus(): AgentEventBus | undefined;
     get fileSystemService(): FileSystemService | undefined;
     get historyStorage(): IHistoryStorage | undefined;
@@ -64,6 +91,11 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
     get systemPromptManager(): SystemPromptManager | undefined;
     get toolManager(): ToolManager | undefined;
     get toolProvider(): ToolProvider | undefined;
+    /**
+     * Get the injected transport client (if any).
+     * Available when agent runs as a child process connected to daemon.
+     */
+    get transportClient(): ITransportClient | undefined;
     /**
      * Cancels the currently running turn for the agent's default session.
      * Safe to call even if no run is in progress.
@@ -76,10 +108,29 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      * Create a new session.
      */
     createSession(sessionId?: string): Promise<IChatSession>;
+    /**
+     * 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, options?: {
+        mapRootEligible?: boolean;
+    }): Promise<string>;
+    /**
+     * Delete a sandbox variable from the agent's default session.
+     */
+    deleteSandboxVariable(key: string): void;
+    /**
+     * Delete a sandbox variable from a specific session's sandbox.
+     */
+    deleteSandboxVariableOnSession(sessionId: string, key: string): void;
     /**
      * Delete a session completely (memory + history).
      */
     deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Delete a task session and all its resources (sandbox + history).
+     */
+    deleteTaskSession(sessionId: string): Promise<void>;
     /**
      * Execute the agent with user input.
      * Uses the agent's default session (created during start()).
@@ -94,6 +145,14 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
         executionContext?: ExecutionContext;
         taskId?: string;
     }): Promise<string>;
+    /**
+     * Execute the agent on a specific session (not the default session).
+     * Used for per-task session isolation in parallel execution.
+     */
+    executeOnSession(sessionId: string, input: string, options?: {
+        executionContext?: ExecutionContext;
+        taskId?: string;
+    }): Promise<string>;
     /**
      * Generate a complete response (waits for full completion).
      * Wrapper around stream() that collects all events and returns final result.
@@ -134,6 +193,17 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      * List all session IDs (in-memory only).
      */
     listSessions(): string[];
+    /**
+     * Hot-swap the provider/model configuration by rebuilding the SessionManager.
+     * Called by agent-process when a provider:updated event is received.
+     *
+     * Safety: this is called at the start of executeTask (before LLM calls), and
+     * the task queue is sequential (max concurrency = 1), so no concurrent task
+     * can be using the old SessionManager when this runs.
+     *
+     * @param providerUpdate - New provider configuration from daemon state server
+     */
+    refreshProviderConfig(providerUpdate: ProviderUpdateConfig): void;
     /**
      * Reset the agent to initial state.
      * Resets execution state only. To reset sessions, use resetSession(sessionId).
@@ -143,7 +213,26 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      * Reset a specific session's conversation history.
      * @param sessionId - The session ID to reset
      */
-    resetSession(sessionId: string): void;
+    resetSession(sessionId: string): Promise<void>;
+    /**
+     * Set a variable in the agent's default session sandbox.
+     */
+    setSandboxVariable(key: string, value: unknown): void;
+    /**
+     * Set a variable in a specific session's sandbox.
+     */
+    setSandboxVariableOnSession(sessionId: string, key: string, value: unknown): void;
+    /**
+     * Setup per-task event forwarding via TransportEventBridge.
+     * Registers listeners on AgentEventBus that forward llmservice:* events
+     * matching the given taskId to the transport server.
+     *
+     * Only effective when a transport client is injected (child process mode).
+     *
+     * @param taskId - Task ID to filter events by
+     * @returns Cleanup function that removes listeners, or undefined if no bridge
+     */
+    setupTaskForwarding(taskId: string): (() => void) | undefined;
     /**
      * Start the agent - initializes all services asynchronously.
      * Must be called before execute().
@@ -166,8 +255,28 @@ export declare class CipherAgent extends BaseAgent implements ICipherAgent {
      * @throws Error if session does not exist
      */
     switchDefaultSession(sessionId: string): void;
+    /**
+     * Build HTTP config for ByteRover API calls.
+     * Uses lazy providers when injected (child process mode), otherwise static config.
+     */
+    private buildHttpConfig;
     private getHistoryStorageInternal;
     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;
 }