byterover-cli 1.0.4 → 1.1.0

package/dist/core/domain/knowledge/relation-parser.d.ts

@@ -1,10 +1,10 @@
 /**
  * Utilities for parsing and managing context relations.
- * Relations are expressed using @ notation: @domain/topic or @domain/topic/subtopic
+ * Relations are expressed using @ notation: @domain/topic/title.md or @domain/topic/subtopic/title.md
  */
 /**
- * Parse relations from context.md content.
- * Extracts all @domain/topic or @domain/topic/subtopic references.
+ * Parse relations from title.md content.
+ * Extracts all @domain/topic/title.md or @domain/topic/subtopic/title.md references.
  *
  * @param content - Markdown content to parse
  * @returns Array of unique relation paths (without @ prefix)
@@ -13,43 +13,27 @@
  * ```ts
  * const content = `
  * ## Relations
- * @code_style/error-handling
- * @structure/api-endpoints
+ * @code_style/error-handling/overview.md
+ * @structure/api/endpoints/rest.md
  * `
- * parseRelations(content) // ['code_style/error-handling', 'structure/api-endpoints']
+ * parseRelations(content) // ['code_style/error-handling/overview.md', 'structure/api/endpoints/rest.md']
  * ```
  */
 export declare function parseRelations(content: string): string[];
-/**
- * Validate a relation path format.
- * Valid formats: domain/topic or domain/topic/subtopic
- *
- * @param path - Relation path to validate (without @ prefix)
- * @returns True if path format is valid
- *
- * @example
- * ```ts
- * validateRelationPath('code_style/error-handling') // true
- * validateRelationPath('code_style/error-handling/try-catch') // true
- * validateRelationPath('invalid') // false
- * validateRelationPath('too/many/parts/here') // false
- * ```
- */
-export declare function validateRelationPath(path: string): boolean;
 /**
  * Resolve a relation path to an absolute file system path.
  *
  * @param basePath - Base path to context tree (e.g., '.brv/context-tree')
- * @param relation - Relation path (e.g., 'domain/topic' or 'domain/topic/subtopic')
- * @returns Absolute path to the context.md file
+ * @param relation - Relation path (e.g., 'domain/topic/title.md' or 'domain/topic/subtopic/title.md')
+ * @returns Absolute path to the title.md file
  *
  * @example
  * ```ts
- * resolveRelationPath('.brv/context-tree', 'code_style/error-handling')
- * // => '.brv/context-tree/code_style/error-handling/context.md'
+ * resolveRelationPath('.brv/context-tree', 'code_style/error-handling/overview.md')
+ * // => '.brv/context-tree/code_style/error-handling/overview.md'
  *
- * resolveRelationPath('.brv/context-tree', 'structure/api/endpoints')
- * // => '.brv/context-tree/structure/api/endpoints/context.md'
+ * resolveRelationPath('.brv/context-tree', 'structure/api/endpoints/rest.md')
+ * // => '.brv/context-tree/structure/api/endpoints/rest.md'
  * ```
  */
 export declare function resolveRelationPath(basePath: string, relation: string): string;
@@ -58,31 +42,33 @@ export declare function resolveRelationPath(basePath: string, relation: string):
  *
  * @param domain - Domain name
  * @param topic - Topic name
+ * @param title - Title (with .md extension)
  * @param subtopic - Optional subtopic name
  * @returns Formatted relation string with @ prefix
  *
  * @example
  * ```ts
- * formatRelation('code_style', 'error-handling')
- * // => '@code_style/error-handling'
+ * formatRelation('code_style', 'error-handling', 'overview.md')
+ * // => '@code_style/error-handling/overview.md'
  *
- * formatRelation('structure', 'api', 'endpoints')
- * // => '@structure/api/endpoints'
+ * formatRelation('structure', 'api', 'endpoints', 'rest.md')
+ * // => '@structure/api/endpoints/rest.md'
  * ```
  */
-export declare function formatRelation(domain: string, topic: string, subtopic?: string): string;
+export declare function formatRelation(domain: string, topic: string, title: string, subtopic?: string): string;
 /**
  * Normalize a relation path by removing the @ prefix.
+ * Preserves file extensions (e.g., .md).
  *
  * @param relation - Relation path to normalize
- * @returns Normalized relation path
+ * @returns Normalized relation path without @ prefix (file extension preserved)
  *
  * @example
  * ```ts
- * normalizeRelation('code_style/error-handling') // 'code_style/error-handling'
- * normalizeRelation('@code_style/error-handling') // 'code_style/error-handling'
+ * normalizeRelation('code_style/error-handling.md') // 'code_style/error-handling.md'
+ * normalizeRelation('@code_style/error-handling.md') // 'code_style/error-handling.md'
  * normalizeRelation('code_style/error-handling/title.md') // 'code_style/error-handling/title.md'
- * normalizeRelation('@@@code_style/error-handling/title.md') // 'code_style/error-handling/title.md'
+ * normalizeRelation('code_style/error-handling/file.md') // 'code_style/error-handling/file.md'
  * ```
  */
 export declare function normalizeRelation(relation: string): string;
@@ -95,8 +81,8 @@ export declare function normalizeRelation(relation: string): string;
  *
  * @example
  * ```ts
- * generateRelationsSection(['code_style/error-handling', 'structure/api'])
- * // => '\n## Relations\n@code_style/error-handling\n@structure/api\n'
+ * generateRelationsSection(['code_style/error-handling/overview.md', 'structure/api/rest.md'])
+ * // => '\n## Relations\n@code_style/error-handling/overview.md\n@structure/api/rest.md\n'
  *
  * generateRelationsSection([])
  * // => ''

package/dist/core/domain/knowledge/relation-parser.js

@@ -1,15 +1,15 @@
 /**
  * Utilities for parsing and managing context relations.
- * Relations are expressed using @ notation: @domain/topic or @domain/topic/subtopic
+ * Relations are expressed using @ notation: @domain/topic/title.md or @domain/topic/subtopic/title.md
  */
 /**
  * Regular expression to match relation paths in markdown content.
- * Matches: @domain/topic or @domain/topic/subtopic
+ * Matches: @domain/topic/title.md or @domain/topic/subtopic/title.md
  */
-const RELATION_PATTERN = /@([\w-]+)\/([\w-]+)(?:\/([\w-]+))?/g;
+const RELATION_PATTERN = /@([\w-]+\/[\w-]+(?:\/[\w-]+)?\/[\w-]+(?:\.[\w]+)?)(?![\w/-])/g;
 /**
- * Parse relations from context.md content.
- * Extracts all @domain/topic or @domain/topic/subtopic references.
+ * Parse relations from title.md content.
+ * Extracts all @domain/topic/title.md or @domain/topic/subtopic/title.md references.
  *
  * @param content - Markdown content to parse
  * @returns Array of unique relation paths (without @ prefix)
@@ -18,104 +18,77 @@ const RELATION_PATTERN = /@([\w-]+)\/([\w-]+)(?:\/([\w-]+))?/g;
  * ```ts
  * const content = `
  * ## Relations
- * @code_style/error-handling
- * @structure/api-endpoints
+ * @code_style/error-handling/overview.md
+ * @structure/api/endpoints/rest.md
  * `
- * parseRelations(content) // ['code_style/error-handling', 'structure/api-endpoints']
+ * parseRelations(content) // ['code_style/error-handling/overview.md', 'structure/api/endpoints/rest.md']
  * ```
  */
 export function parseRelations(content) {
     const relations = new Set();
-    // Extract all @domain/topic or @domain/topic/subtopic patterns
+    // Extract all @domain/topic/title.md or @domain/topic/subtopic/title.md patterns
     const matches = content.matchAll(RELATION_PATTERN);
     for (const match of matches) {
-        const [, domain, topic, subtopic] = match;
-        const relation = subtopic
-            ? `${domain}/${topic}/${subtopic}`
-            : `${domain}/${topic}`;
-        relations.add(relation);
+        const [, fullPath] = match;
+        relations.add(fullPath.trim());
     }
     return [...relations];
 }
-/**
- * Validate a relation path format.
- * Valid formats: domain/topic or domain/topic/subtopic
- *
- * @param path - Relation path to validate (without @ prefix)
- * @returns True if path format is valid
- *
- * @example
- * ```ts
- * validateRelationPath('code_style/error-handling') // true
- * validateRelationPath('code_style/error-handling/try-catch') // true
- * validateRelationPath('invalid') // false
- * validateRelationPath('too/many/parts/here') // false
- * ```
- */
-export function validateRelationPath(path) {
-    const parts = path.split('/');
-    // Must have 2 or 3 parts: domain/topic or domain/topic/subtopic
-    if (parts.length < 2 || parts.length > 3) {
-        return false;
-    }
-    // Each part must be non-empty and contain only valid characters
-    const validPartPattern = /^[\w-]+$/;
-    return parts.every(part => validPartPattern.test(part));
-}
 /**
  * Resolve a relation path to an absolute file system path.
  *
  * @param basePath - Base path to context tree (e.g., '.brv/context-tree')
- * @param relation - Relation path (e.g., 'domain/topic' or 'domain/topic/subtopic')
- * @returns Absolute path to the context.md file
+ * @param relation - Relation path (e.g., 'domain/topic/title.md' or 'domain/topic/subtopic/title.md')
+ * @returns Absolute path to the title.md file
  *
  * @example
  * ```ts
- * resolveRelationPath('.brv/context-tree', 'code_style/error-handling')
- * // => '.brv/context-tree/code_style/error-handling/context.md'
+ * resolveRelationPath('.brv/context-tree', 'code_style/error-handling/overview.md')
+ * // => '.brv/context-tree/code_style/error-handling/overview.md'
  *
- * resolveRelationPath('.brv/context-tree', 'structure/api/endpoints')
- * // => '.brv/context-tree/structure/api/endpoints/context.md'
+ * resolveRelationPath('.brv/context-tree', 'structure/api/endpoints/rest.md')
+ * // => '.brv/context-tree/structure/api/endpoints/rest.md'
  * ```
  */
 export function resolveRelationPath(basePath, relation) {
-    const parts = relation.split('/');
-    return `${basePath}/${parts.join('/')}/context.md`;
+    return `${basePath}/${relation}`;
 }
 /**
  * Format a relation path using @ notation.
  *
  * @param domain - Domain name
  * @param topic - Topic name
+ * @param title - Title (with .md extension)
  * @param subtopic - Optional subtopic name
  * @returns Formatted relation string with @ prefix
  *
  * @example
  * ```ts
- * formatRelation('code_style', 'error-handling')
- * // => '@code_style/error-handling'
+ * formatRelation('code_style', 'error-handling', 'overview.md')
+ * // => '@code_style/error-handling/overview.md'
  *
- * formatRelation('structure', 'api', 'endpoints')
- * // => '@structure/api/endpoints'
+ * formatRelation('structure', 'api', 'endpoints', 'rest.md')
+ * // => '@structure/api/endpoints/rest.md'
  * ```
  */
-export function formatRelation(domain, topic, subtopic) {
+export function formatRelation(domain, topic, title, subtopic) {
     return subtopic
-        ? `@${domain}/${topic}/${subtopic}`
-        : `@${domain}/${topic}`;
+        ? `@${domain}/${topic}/${subtopic}/${title}`
+        : `@${domain}/${topic}/${title}`;
 }
 /**
  * Normalize a relation path by removing the @ prefix.
+ * Preserves file extensions (e.g., .md).
  *
  * @param relation - Relation path to normalize
- * @returns Normalized relation path
+ * @returns Normalized relation path without @ prefix (file extension preserved)
  *
  * @example
  * ```ts
- * normalizeRelation('code_style/error-handling') // 'code_style/error-handling'
- * normalizeRelation('@code_style/error-handling') // 'code_style/error-handling'
+ * normalizeRelation('code_style/error-handling.md') // 'code_style/error-handling.md'
+ * normalizeRelation('@code_style/error-handling.md') // 'code_style/error-handling.md'
  * normalizeRelation('code_style/error-handling/title.md') // 'code_style/error-handling/title.md'
- * normalizeRelation('@@@code_style/error-handling/title.md') // 'code_style/error-handling/title.md'
+ * normalizeRelation('code_style/error-handling/file.md') // 'code_style/error-handling/file.md'
  * ```
  */
 export function normalizeRelation(relation) {
@@ -130,8 +103,8 @@ export function normalizeRelation(relation) {
  *
  * @example
  * ```ts
- * generateRelationsSection(['code_style/error-handling', 'structure/api'])
- * // => '\n## Relations\n@code_style/error-handling\n@structure/api\n'
+ * generateRelationsSection(['code_style/error-handling/overview.md', 'structure/api/rest.md'])
+ * // => '\n## Relations\n@code_style/error-handling/overview.md\n@structure/api/rest.md\n'
  *
  * generateRelationsSection([])
  * // => ''
@@ -142,7 +115,12 @@ export function generateRelationsSection(relations) {
         return '';
     }
     const formattedRelations = relations
-        .map(rel => `@${normalizeRelation(rel)}`)
+        .map(rel => {
+        const normalized = normalizeRelation(rel);
+        // Ensure .md extension is present
+        const withExtension = normalized.endsWith('.md') ? normalized : `${normalized}.md`;
+        return `@${withExtension}`;
+    })
         .join('\n');
     return `\n## Relations\n${formattedRelations}\n`;
 }

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

@@ -429,6 +429,8 @@ export declare const TransportLlmEventList: readonly ["llmservice:thinking", "ll
 export declare const TransportAgentEventNames: {
     readonly CONNECTED: "agent:connected";
     readonly DISCONNECTED: "agent:disconnected";
+    readonly NEW_SESSION: "agent:newSession";
+    readonly NEW_SESSION_CREATED: "agent:newSessionCreated";
     readonly REGISTER: "agent:register";
     readonly RESTART: "agent:restart";
     readonly RESTARTED: "agent:restarted";
@@ -449,10 +451,10 @@ export declare const TransportSessionEventNames: {
  * Internal message, not exposed to external clients
  */
 export declare const TaskExecuteSchema: z.ZodObject<{
-    /** Client ID that created the task (for response routing) */
-    clientId: z.ZodString;
     /** Client's working directory for file validation */
     clientCwd: z.ZodOptional<z.ZodString>;
+    /** Client ID that created the task (for response routing) */
+    clientId: z.ZodString;
     /** Task content/prompt */
     content: z.ZodString;
     /** Optional file paths for curate --files */
@@ -1137,6 +1139,77 @@ export declare const AgentRestartResponseSchema: z.ZodObject<{
     success: boolean;
     error?: string | undefined;
 }>;
+/**
+ * Request to create a new session (end current, start fresh).
+ * Used by /new command to start a fresh conversation.
+ */
+export declare const AgentNewSessionRequestSchema: z.ZodObject<{
+    /** Optional reason for new session (for logging) */
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reason?: string | undefined;
+}, {
+    reason?: string | undefined;
+}>;
+/**
+ * Response after new session is created.
+ */
+export declare const AgentNewSessionResponseSchema: z.ZodObject<{
+    /** Error message if session creation failed */
+    error: z.ZodOptional<z.ZodString>;
+    /** The new session ID */
+    sessionId: z.ZodOptional<z.ZodString>;
+    /** Whether the new session was created successfully */
+    success: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+}>;
+/**
+ * Agent status event names.
+ */
+export declare const AgentStatusEventNames: {
+    /** Status changed broadcast */
+    readonly STATUS_CHANGED: "agent:status:changed";
+};
+/**
+ * Agent health status for monitoring.
+ * Used by Transport to check if CipherAgent is ready before forwarding tasks.
+ */
+export declare const AgentStatusSchema: z.ZodObject<{
+    /** Number of tasks currently processing */
+    activeTasks: z.ZodNumber;
+    /** Whether auth token is loaded and valid */
+    hasAuth: z.ZodBoolean;
+    /** Whether BrvConfig is loaded */
+    hasConfig: z.ZodBoolean;
+    /** Whether CipherAgent is initialized and ready */
+    isInitialized: z.ZodBoolean;
+    /** Last initialization error message */
+    lastError: z.ZodOptional<z.ZodString>;
+    /** Number of tasks waiting in queue */
+    queuedTasks: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    activeTasks: number;
+    hasAuth: boolean;
+    hasConfig: boolean;
+    isInitialized: boolean;
+    queuedTasks: number;
+    lastError?: string | undefined;
+}, {
+    activeTasks: number;
+    hasAuth: boolean;
+    hasConfig: boolean;
+    isInitialized: boolean;
+    queuedTasks: number;
+    lastError?: string | undefined;
+}>;
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
 export type TodoItem = z.infer<typeof TodoItemSchema>;
 export type ChunkPayload = z.infer<typeof ChunkPayloadSchema>;
 export type ResponsePayload = z.infer<typeof ResponsePayloadSchema>;
@@ -1163,3 +1236,5 @@ export type SessionSwitchResponse = z.infer<typeof SessionSwitchResponseSchema>;
 export type SessionSwitchedBroadcast = z.infer<typeof SessionSwitchedBroadcastSchema>;
 export type AgentRestartRequest = z.infer<typeof AgentRestartRequestSchema>;
 export type AgentRestartResponse = z.infer<typeof AgentRestartResponseSchema>;
+export type AgentNewSessionRequest = z.infer<typeof AgentNewSessionRequestSchema>;
+export type AgentNewSessionResponse = z.infer<typeof AgentNewSessionResponseSchema>;

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

@@ -249,6 +249,8 @@ export const TransportLlmEventList = [
 export const TransportAgentEventNames = {
     CONNECTED: 'agent:connected',
     DISCONNECTED: 'agent:disconnected',
+    NEW_SESSION: 'agent:newSession',
+    NEW_SESSION_CREATED: 'agent:newSessionCreated',
     REGISTER: 'agent:register',
     RESTART: 'agent:restart',
     RESTARTED: 'agent:restarted',
@@ -272,10 +274,10 @@ export const TransportSessionEventNames = {
  * Internal message, not exposed to external clients
  */
 export const TaskExecuteSchema = z.object({
-    /** Client ID that created the task (for response routing) */
-    clientId: z.string(),
     /** Client's working directory for file validation */
     clientCwd: z.string().optional(),
+    /** Client ID that created the task (for response routing) */
+    clientId: z.string(),
     /** Task content/prompt */
     content: z.string(),
     /** Optional file paths for curate --files */
@@ -560,3 +562,50 @@ export const AgentRestartResponseSchema = z.object({
     /** Whether the restart was initiated successfully */
     success: z.boolean(),
 });
+/**
+ * Request to create a new session (end current, start fresh).
+ * Used by /new command to start a fresh conversation.
+ */
+export const AgentNewSessionRequestSchema = z.object({
+    /** Optional reason for new session (for logging) */
+    reason: z.string().optional(),
+});
+/**
+ * Response after new session is created.
+ */
+export const AgentNewSessionResponseSchema = z.object({
+    /** Error message if session creation failed */
+    error: z.string().optional(),
+    /** The new session ID */
+    sessionId: z.string().optional(),
+    /** Whether the new session was created successfully */
+    success: z.boolean(),
+});
+// ============================================================================
+// Agent Status (health check)
+// ============================================================================
+/**
+ * Agent status event names.
+ */
+export const AgentStatusEventNames = {
+    /** Status changed broadcast */
+    STATUS_CHANGED: 'agent:status:changed',
+};
+/**
+ * Agent health status for monitoring.
+ * Used by Transport to check if CipherAgent is ready before forwarding tasks.
+ */
+export const AgentStatusSchema = z.object({
+    /** Number of tasks currently processing */
+    activeTasks: z.number().int().nonnegative(),
+    /** Whether auth token is loaded and valid */
+    hasAuth: z.boolean(),
+    /** Whether BrvConfig is loaded */
+    hasConfig: z.boolean(),
+    /** Whether CipherAgent is initialized and ready */
+    isInitialized: z.boolean(),
+    /** Last initialization error message */
+    lastError: z.string().optional(),
+    /** Number of tasks waiting in queue */
+    queuedTasks: z.number().int().nonnegative(),
+});

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

@@ -0,0 +1,133 @@
+/**
+ * Interface for Session Persistence Operations
+ *
+ * Defines the contract for session metadata storage and retrieval.
+ * Implementation uses JSON files in .brv/sessions/ directory.
+ */
+import type { ActiveSessionPointer, SessionInfo, SessionMetadata } from '../../domain/cipher/session/session-metadata.js';
+/**
+ * Session retention configuration for auto-cleanup.
+ */
+export interface SessionRetentionConfig {
+    /** Maximum age in days before auto-cleanup */
+    maxAgeDays: number;
+    /** Maximum number of sessions to keep */
+    maxCount: number;
+    /** Whether to run cleanup on startup */
+    runOnStartup: boolean;
+}
+/**
+ * Result of session cleanup operation.
+ */
+export interface SessionCleanupResult {
+    /** Number of corrupted session files removed */
+    corruptedRemoved: number;
+    /** Number of sessions deleted due to age */
+    deletedByAge: number;
+    /** Number of sessions deleted due to count limit */
+    deletedByCount: number;
+    /** Total sessions remaining after cleanup */
+    remaining: number;
+}
+/**
+ * Interface for session metadata persistence.
+ *
+ * Manages session metadata stored in .brv/sessions/ directory:
+ * - active.json: Current active session pointer
+ * - session-*.json: Individual session metadata files
+ */
+export interface ISessionPersistence {
+    /**
+     * Clean up expired sessions based on retention policy.
+     *
+     * @param config - Retention configuration
+     * @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.
+     *
+     * @returns Active session pointer or null if no active session
+     */
+    getActiveSession(): Promise<ActiveSessionPointer | null>;
+    /**
+     * Get session metadata by ID.
+     *
+     * @param sessionId - Session ID to look up
+     * @returns Session metadata or null if not found
+     */
+    getSession(sessionId: string): Promise<null | SessionMetadata>;
+    /**
+     * Check if the active session pointer is stale (process not running).
+     *
+     * @returns True if active session exists but process is not running
+     */
+    isActiveSessionStale(): Promise<boolean>;
+    /**
+     * Validate that a session belongs to the current working directory.
+     *
+     * @param sessionId - Session ID to validate
+     * @returns True if session belongs to current project
+     */
+    isSessionForCurrentProject(sessionId: string): Promise<boolean>;
+    /**
+     * List all session metadata files.
+     *
+     * @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'.
+     *
+     * @param sessionId - Session ID to mark as interrupted
+     */
+    markSessionInterrupted(sessionId: string): Promise<void>;
+    /**
+     * Save session metadata to disk.
+     * Creates or updates the session metadata file.
+     *
+     * @param metadata - Session metadata to save
+     */
+    saveSession(metadata: SessionMetadata): Promise<void>;
+    /**
+     * Set the active session pointer.
+     * Creates or updates .brv/sessions/active.json
+     *
+     * @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/core/interfaces/cipher/i-session-persistence.js

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

package/dist/core/interfaces/cipher/message-types.d.ts

@@ -302,6 +302,12 @@ export interface ToolCall {
      * Unique identifier for this tool call
      */
     id: string;
+    /**
+     * Thought signature for Gemini 3+ models.
+     * Required by Gemini 3 preview models to validate function calls.
+     * Uses 'skip_thought_signature_validator' as synthetic signature.
+     */
+    thoughtSignature?: string;
     /**
      * The type of tool call (currently only 'function' is supported)
      */