byterover-cli 1.7.2 → 2.0.0

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

@@ -6,7 +6,7 @@
 import { z } from 'zod';
 import { ErrorScope, ErrorType, LLMErrorCode } from './error-codes.js';
 import { acceptsAnyModel, getMaxInputTokensForModel, getSupportedModels, isValidProviderModel } from './registry.js';
-import { LLM_PROVIDERS } from './types.js';
+import { PROVIDER_TYPES } from './types.js';
 /**
  * Default-free field definitions for LLM configuration.
  * Used to build both the full config schema (with defaults) and the updates schema (no defaults).
@@ -34,8 +34,8 @@ const LLMConfigFields = {
         .min(1, 'Model name is required')
         .describe('Specific model name for the selected provider'),
     provider: z
-        .enum(LLM_PROVIDERS)
-        .describe("LLM provider (e.g., 'claude', 'gemini', 'openrouter')"),
+        .enum(PROVIDER_TYPES)
+        .describe("LLM provider type (e.g., 'claude', 'gemini', 'openai')"),
     temperature: z.coerce
         .number()
         .min(0)

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

@@ -4,13 +4,23 @@
  * This module defines the core types for LLM provider abstraction,
  */
 /**
- * Supported LLM providers as a const array for runtime validation.
+ * Provider types for formatter/tokenizer selection.
+ * These represent the underlying API format, NOT provider IDs.
+ * e.g., OpenRouter, xAI, Groq, Mistral all use 'openai' format.
  */
-export declare const LLM_PROVIDERS: readonly ["claude", "gemini", "openrouter"];
+export declare const PROVIDER_TYPES: readonly ["claude", "gemini", "openai"];
 /**
- * Union type of all supported LLM providers.
+ * Union type of provider types.
  */
-export type LLMProvider = (typeof LLM_PROVIDERS)[number];
+export type ProviderType = (typeof PROVIDER_TYPES)[number];
+/**
+ * @deprecated Use PROVIDER_TYPES instead. Kept for backward compatibility.
+ */
+export declare const LLM_PROVIDERS: readonly ["claude", "gemini", "openai"];
+/**
+ * @deprecated Use ProviderType instead. Kept for backward compatibility.
+ */
+export type LLMProvider = ProviderType;
 /**
  * Supported file types for multimodal input.
  */
@@ -84,7 +94,7 @@ export interface LLMContext {
     /** Current model name */
     model: string;
     /** Current provider */
-    provider: LLMProvider;
+    provider: ProviderType;
 }
 /**
  * Token usage statistics.

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

@@ -4,9 +4,15 @@
  * This module defines the core types for LLM provider abstraction,
  */
 /**
- * Supported LLM providers as a const array for runtime validation.
+ * Provider types for formatter/tokenizer selection.
+ * These represent the underlying API format, NOT provider IDs.
+ * e.g., OpenRouter, xAI, Groq, Mistral all use 'openai' format.
  */
-export const LLM_PROVIDERS = ['claude', 'gemini', 'openrouter'];
+export const PROVIDER_TYPES = ['claude', 'gemini', 'openai'];
+/**
+ * @deprecated Use PROVIDER_TYPES instead. Kept for backward compatibility.
+ */
+export const LLM_PROVIDERS = PROVIDER_TYPES;
 /**
  * Supported file types for multimodal input.
  */

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

@@ -6,8 +6,12 @@
  * Result of code execution in the sandbox.
  */
 export interface REPLResult {
+    /** Accumulated curate() call results from within sandbox execution */
+    curateResults?: unknown[];
     /** Execution time in milliseconds */
     executionTime: number;
+    /** If set by setFinalResult(), signals early termination of the agentic loop */
+    finalResult?: string;
     /** Current context state (variable names to values) */
     locals: Record<string, unknown>;
     /** Return value of the last expression (if any) */
@@ -25,6 +29,8 @@ export interface SandboxConfig {
     contextPayload?: Record<string, unknown> | string | unknown[];
     /** Language: 'javascript' or 'typescript' (default: auto-detect) */
     language?: 'javascript' | 'typescript';
+    /** Cap stdout buffer at this many characters. undefined = unlimited. */
+    maxStdoutChars?: number;
     /** Timeout in ms (default: 30000, max: 300000) */
     timeout?: number;
 }

package/dist/agent/core/domain/session/session-metadata.d.ts

@@ -2,7 +2,7 @@
  * Session Metadata Types and Schemas
  *
  * Defines the data structures for persistent session management.
- * Sessions are stored in .brv/sessions/ directory as JSON files.
+ * Sessions are stored in the XDG sessions directory as JSON files.
  *
  * Design adapted from gemini-cli's ChatRecordingService pattern.
  */
@@ -12,7 +12,7 @@ import { z } from 'zod';
  */
 export type SessionStatus = 'active' | 'ended' | 'interrupted';
 /**
- * Active session pointer stored in .brv/sessions/active.json
+ * Active session pointer stored in active.json within sessions directory
  * Points to the currently active session for auto-resume.
  */
 export interface ActiveSessionPointer {
@@ -41,6 +41,8 @@ export interface SessionMetadata {
     lastUpdated: string;
     /** Number of messages in session (cached for quick display) */
     messageCount: number;
+    /** Provider ID active when session was created (for cross-provider resume detection) */
+    providerId?: string;
     /** Unique session identifier (UUID) */
     sessionId: string;
     /** Session lifecycle status */
@@ -104,6 +106,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     createdAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
     lastUpdated: z.ZodUnion<[z.ZodString, z.ZodString]>;
     messageCount: z.ZodNumber;
+    providerId: z.ZodOptional<z.ZodString>;
     sessionId: z.ZodString;
     status: z.ZodEnum<["active", "ended", "interrupted"]>;
     summary: z.ZodOptional<z.ZodString>;
@@ -116,6 +119,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     lastUpdated: string;
     messageCount: number;
     workingDirectory: string;
+    providerId?: string | undefined;
     summary?: string | undefined;
     title?: string | undefined;
 }, {
@@ -125,6 +129,7 @@ export declare const SessionMetadataSchema: z.ZodObject<{
     lastUpdated: string;
     messageCount: number;
     workingDirectory: string;
+    providerId?: string | undefined;
     summary?: string | undefined;
     title?: string | undefined;
 }>;

package/dist/agent/core/domain/session/session-metadata.js

@@ -2,7 +2,7 @@
  * Session Metadata Types and Schemas
  *
  * Defines the data structures for persistent session management.
- * Sessions are stored in .brv/sessions/ directory as JSON files.
+ * Sessions are stored in the XDG sessions directory as JSON files.
  *
  * Design adapted from gemini-cli's ChatRecordingService pattern.
  */
@@ -14,7 +14,10 @@ import { z } from 'zod';
  * Schema for ActiveSessionPointer validation.
  */
 export const ActiveSessionPointerSchema = z.object({
-    activatedAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    activatedAt: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
     pid: z.number().int().positive(),
     // Optional for backward compatibility with existing session files (treated as stale if missing)
     processToken: z.string().optional(),
@@ -24,9 +27,16 @@ export const ActiveSessionPointerSchema = z.object({
  * Schema for SessionMetadata validation.
  */
 export const SessionMetadataSchema = z.object({
-    createdAt: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
-    lastUpdated: z.string().datetime({ offset: true }).or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    createdAt: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
+    lastUpdated: z
+        .string()
+        .datetime({ offset: true })
+        .or(z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/)),
     messageCount: z.number().int().nonnegative(),
+    providerId: z.string().optional(),
     sessionId: z.string().min(1),
     status: z.enum(['active', 'ended', 'interrupted']),
     summary: z.string().optional(),

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

@@ -89,6 +89,8 @@ export type StreamingEvent = {
 export interface StreamOptions {
     /** Execution context */
     executionContext?: ExecutionContext;
+    /** Session ID override — uses default session if not provided (for per-task session isolation) */
+    sessionId?: string;
     /** AbortSignal for cancellation */
     signal?: AbortSignal;
     /** Task ID for concurrent task isolation (included in all emitted events) */

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

@@ -3,29 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export declare const ToolName: {
-    readonly BASH_EXEC: 'bash_exec';
-    readonly BASH_OUTPUT: 'bash_output';
-    readonly BATCH: 'batch';
     readonly CODE_EXEC: 'code_exec';
-    readonly CREATE_KNOWLEDGE_TOPIC: 'create_knowledge_topic';
     readonly CURATE: 'curate';
-    readonly DELETE_MEMORY: 'delete_memory';
-    readonly EDIT_FILE: 'edit_file';
-    readonly EDIT_MEMORY: 'edit_memory';
     readonly GLOB_FILES: 'glob_files';
     readonly GREP_CONTENT: 'grep_content';
-    readonly KILL_PROCESS: 'kill_process';
     readonly LIST_DIRECTORY: 'list_directory';
-    readonly LIST_MEMORIES: 'list_memories';
     readonly READ_FILE: 'read_file';
-    readonly READ_MEMORY: 'read_memory';
-    readonly READ_TODOS: 'read_todos';
-    readonly SEARCH_HISTORY: 'search_history';
     readonly SEARCH_KNOWLEDGE: 'search_knowledge';
-    readonly SPEC_ANALYZE: 'spec_analyze';
     readonly WRITE_FILE: 'write_file';
-    readonly WRITE_MEMORY: 'write_memory';
-    readonly WRITE_TODOS: 'write_todos';
 };
 /**
  * Union type of all known tool names.

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

@@ -3,27 +3,12 @@
  * These constants ensure type safety and prevent typos.
  */
 export const ToolName = {
-    BASH_EXEC: 'bash_exec',
-    BASH_OUTPUT: 'bash_output',
-    BATCH: 'batch',
     CODE_EXEC: 'code_exec',
-    CREATE_KNOWLEDGE_TOPIC: 'create_knowledge_topic',
     CURATE: 'curate',
-    DELETE_MEMORY: 'delete_memory',
-    EDIT_FILE: 'edit_file',
-    EDIT_MEMORY: 'edit_memory',
     GLOB_FILES: 'glob_files',
     GREP_CONTENT: 'grep_content',
-    KILL_PROCESS: 'kill_process',
     LIST_DIRECTORY: 'list_directory',
-    LIST_MEMORIES: 'list_memories',
     READ_FILE: 'read_file',
-    READ_MEMORY: 'read_memory',
-    READ_TODOS: 'read_todos',
-    SEARCH_HISTORY: 'search_history',
     SEARCH_KNOWLEDGE: 'search_knowledge',
-    SPEC_ANALYZE: 'spec_analyze',
     WRITE_FILE: 'write_file',
-    WRITE_MEMORY: 'write_memory',
-    WRITE_TODOS: 'write_todos',
 };

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

@@ -82,6 +82,8 @@ export interface Tool {
  * Contains metadata about the execution environment.
  */
 export interface ToolExecutionContext {
+    /** Command type for context-aware tool behavior (e.g., 'curate', 'query') */
+    commandType?: string;
     /**
      * Callback for streaming metadata updates during execution.
      * Tools can use this to push real-time output (e.g., bash streaming).

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

@@ -48,7 +48,7 @@ export interface IChatSession {
      * Reset the conversation history.
      * Clears all messages except the system prompt (if present).
      */
-    reset(): void;
+    reset(): Promise<void>;
     /**
      * Send a message and get a response.
      * Handles tool execution loop automatically.

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

@@ -7,6 +7,8 @@ import type { ConversationMetadata } from '../domain/system-prompt/types.js';
  * Contains runtime information about how the agent is being executed
  */
 export interface ExecutionContext {
+    /** Clear conversation history before execution (RLM mode — prevents accumulation across calls) */
+    clearHistory?: boolean;
     /** Command type that initiated the execution (for command-specific prompt loading) */
     commandType?: 'chat' | 'curate' | 'query';
     /** Metadata about the conversation (for JSON input mode) */
@@ -15,6 +17,12 @@ export interface ExecutionContext {
     fileReferenceInstructions?: string;
     /** Whether running in JSON input mode (headless with conversation history) */
     isJsonInputMode?: boolean;
+    /** Override maxIterations for this execution (e.g., 2 for queries with pre-fetched context) */
+    maxIterations?: number;
+    /** Override maxTokens for this execution (e.g., 1024 for queries) */
+    maxTokens?: number;
+    /** Override temperature for this execution (e.g., 0.3 for factual queries) */
+    temperature?: number;
 }
 /**
  * Agent execution state (string union for external consumers).
@@ -56,12 +64,41 @@ export interface ICipherAgent {
      * @returns true if a run was in progress and was signaled to abort; false otherwise
      */
     cancel(): Promise<boolean>;
+    /**
+     * Create a task-scoped child session for parallel execution.
+     * The session gets its own sandbox, context manager, and LLM service.
+     *
+     * @param taskId - Unique task identifier (used as part of session ID)
+     * @param commandType - Command type for agent name tracking ('curate' | 'query')
+     * @returns Session ID of the created task session
+     */
+    createTaskSession(taskId: string, commandType: string): Promise<string>;
+    /**
+     * Delete a sandbox variable from the agent's default session.
+     *
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariable(key: string): void;
+    /**
+     * Delete a sandbox variable from a specific session's sandbox.
+     *
+     * @param sessionId - Target session
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariableOnSession(sessionId: string, key: string): void;
     /**
      * Delete a session completely (memory + history)
      * @param sessionId - Session ID to delete
      * @returns True if session existed and was deleted
      */
     deleteSession(sessionId: string): Promise<boolean>;
+    /**
+     * Delete a task session and all its resources (sandbox + history).
+     * Use this for cleanup after per-task session execution.
+     *
+     * @param sessionId - Task session ID to delete
+     */
+    deleteTaskSession(sessionId: string): Promise<void>;
     /**
      * Execute the agent with user input.
      * Uses the agent's default session (created during start()).
@@ -76,6 +113,19 @@ export interface 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.
+     *
+     * @param sessionId - Session to execute on
+     * @param input - User input string
+     * @param options - Optional execution options
+     * @returns Agent response
+     */
+    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.
@@ -107,6 +157,24 @@ export interface ICipherAgent {
      * Clears execution history and resets iteration counter
      */
     reset(): void;
+    /**
+     * Set a variable in the agent's default session sandbox.
+     * If the sandbox doesn't exist yet, the variable is buffered and injected
+     * when the sandbox is created on the first code execution.
+     *
+     * @param key - Variable name
+     * @param value - Variable value
+     */
+    setSandboxVariable(key: string, value: unknown): void;
+    /**
+     * Set a variable in a specific session's sandbox.
+     * Used for per-task session isolation in parallel execution.
+     *
+     * @param sessionId - Target session
+     * @param key - Variable name
+     * @param value - Variable value
+     */
+    setSandboxVariableOnSession(sessionId: string, key: string, value: unknown): void;
     /**
      * Start the agent - initializes all services asynchronously
      * Must be called before execute()

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

@@ -6,12 +6,20 @@
  * Raw concept metadata for a knowledge topic.
  */
 export interface CurateRawConcept {
-    /** What changes in the codebase are induced by this concept */
+    /** Author or source attribution */
+    author?: string;
+    /** Changes, updates, or modifications relevant to this concept (code changes, process updates, market shifts, etc.) */
     changes?: string[];
-    /** Which files are related to this concept */
+    /** Related resources: source files, documents, URLs, data sources, or references */
     files?: string[];
-    /** What is the flow included in this concept */
+    /** Process flow, workflow, or sequence of steps */
     flow?: string;
+    /** Regex or validation patterns with descriptions */
+    patterns?: Array<{
+        description: string;
+        flags?: string;
+        pattern: string;
+    }>;
     /** What is the task related to this concept */
     task?: string;
     /** When the concept was created or modified (ISO 8601 format) */
@@ -21,17 +29,36 @@ export interface CurateRawConcept {
  * Narrative section for descriptive and structural context.
  */
 export interface CurateNarrative {
-    /** Dependency management information */
+    /** Dependencies, prerequisites, blockers, or relationship information */
     dependencies?: string;
-    /** Feature documentation for this concept */
-    features?: string;
-    /** Code structure documentation */
+    /** Concrete examples, use cases, or action items */
+    examples?: string;
+    /** Key highlights, capabilities, deliverables, or notable outcomes */
+    highlights?: string;
+    /** Exact rules, constraints, or guidelines - preserved verbatim */
+    rules?: string;
+    /** Structural or organizational documentation (hierarchies, layouts, timelines, schemas) */
     structure?: string;
 }
+/**
+ * A factual statement extracted during curation.
+ */
+export interface CurateFact {
+    /** Category of the fact */
+    category?: 'convention' | 'environment' | 'other' | 'personal' | 'preference' | 'project' | 'team';
+    /** The full factual statement */
+    statement: string;
+    /** What the fact is about (e.g., "user_name", "database") */
+    subject?: string;
+    /** The extracted value (e.g., "Andy", "PostgreSQL 15") */
+    value?: string;
+}
 /**
  * Content structure for ADD and UPDATE operations.
  */
 export interface CurateContent {
+    /** Factual statements extracted from content */
+    facts?: CurateFact[];
     /** Narrative section with descriptive and structural context */
     narrative?: CurateNarrative;
     /** Raw concept section with metadata and technical footprint */

package/dist/agent/core/interfaces/i-history-storage.d.ts

@@ -7,6 +7,14 @@ import type { InternalMessage } from './message-types.js';
  * to persist and restore conversation history across sessions.
  */
 export interface IHistoryStorage {
+    /**
+     * Append a single message to the session history.
+     * More efficient than saveHistory for incremental updates.
+     *
+     * @param sessionId - Unique session identifier
+     * @param message - Single message to append
+     */
+    appendMessage(sessionId: string, message: InternalMessage): Promise<void>;
     /**
      * Delete all history for a specific session.
      *

package/dist/agent/core/interfaces/i-key-storage.d.ts

@@ -71,6 +71,17 @@ export interface IKeyStorage {
      * @returns Array of matching full keys
      */
     list(prefix: StorageKey): Promise<StorageKey[]>;
+    /**
+     * List all key-value pairs matching a prefix.
+     * More efficient than list() followed by individual get() calls.
+     *
+     * @param prefix - Key prefix to match
+     * @returns Array of key-value pairs
+     */
+    listWithValues<T>(prefix: StorageKey): Promise<Array<{
+        key: StorageKey;
+        value: T;
+    }>>;
     /**
      * Set a value at a composite key.
      * Creates or overwrites the value at the key.

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

@@ -1,5 +1,5 @@
+import type { LLMServiceConfig } from '../../infra/llm/agent-llm-service.js';
 import type { ContextManager, FileData, ImageData } from '../../infra/llm/context/context-manager.js';
-import type { LLMServiceConfig } from '../../infra/llm/internal-llm-service.js';
 import type { ToolSet } from '../domain/tools/types.js';
 import type { ExecutionContext } from './i-cipher-agent.js';
 /**

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

@@ -1,4 +1,5 @@
 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 { ICurateService } from './i-curate-service.js';
@@ -18,6 +19,14 @@ export interface ISandboxService {
      * @param sessionId - Session identifier
      */
     clearSession(sessionId: string): Promise<void>;
+    /**
+     * Delete a variable from a session's sandbox.
+     * If the sandbox doesn't exist yet, cleans up any pending variable with that key.
+     *
+     * @param sessionId - Session identifier
+     * @param key - Variable name to delete
+     */
+    deleteSandboxVariable(sessionId: string, key: string): void;
     /**
      * Execute JavaScript/TypeScript code in a sandbox.
      *
@@ -48,6 +57,16 @@ export interface ISandboxService {
      * @param fileSystem - File system service instance
      */
     setFileSystem?(fileSystem: IFileSystem): void;
+    /**
+     * Set a variable in a session's sandbox.
+     * If the sandbox doesn't exist yet, the variable is buffered and injected
+     * when the sandbox is created on the first executeCode() call.
+     *
+     * @param sessionId - Session identifier
+     * @param key - Variable name
+     * @param value - Variable value (must be JSON-serializable or a plain object)
+     */
+    setSandboxVariable(sessionId: string, key: string, value: unknown): void;
     /**
      * Set the search knowledge service for Tools SDK injection.
      * When set, sandboxes will have access to knowledge search via `tools.searchKnowledge()`.
@@ -55,4 +74,11 @@ export interface ISandboxService {
      * @param searchKnowledgeService - Search knowledge service instance
      */
     setSearchKnowledgeService?(searchKnowledgeService: ISearchKnowledgeService): void;
+    /**
+     * Set the session manager for sub-agent delegation.
+     * When set, sandboxes will have access to `tools.agentQuery()`.
+     *
+     * @param sessionManager - Session manager instance
+     */
+    setSessionManager?(sessionManager: SessionManager): void;
 }

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 {};