byterover-cli 1.0.4 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # ByteRover CLI
 
-Command-line interface for ByteRover, featuring an interactive REPL with a modern React/Ink terminal UI for managing your project's context tree and knowledge storage. Seamlessly integrate with AI coding agents like Claude Code, Cursor, Windsurf, and GitHub Copilot.
+Command-line interface for ByteRover, featuring an interactive REPL with a modern React/Ink terminal UI for managing your project's context tree and knowledge storage. Seamlessly integrate with 18+ AI coding agents including Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and more.
 
 [![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)
@@ -46,7 +46,7 @@ brv --version
 
 ## Quick Start
 
-Visit [**ByteRover's Beta Docs**](https://docs.byterover.dev/beta) for more information.
+Visit [**ByteRover Docs**](https://docs.byterover.dev) for more information.
 
 Get started with ByteRover CLI in three simple steps:
 
@@ -122,7 +122,7 @@ The **Context Tree** is ByteRover's structured knowledge system that helps you a
 - **Organized Knowledge**: Structure your project knowledge by domain and topic
 - **Easy Retrieval**: Find relevant context quickly when you need it
 - **Persistent Memory**: Maintain project-specific knowledge across sessions
-- **Agent-Friendly**: Works seamlessly with AI coding agents like Claude Code, Cursor, Windsurf, and GitHub Copilot
+- **Agent-Friendly**: Works seamlessly with 18+ AI coding agents (Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and more) via rules-based or hook-based integration
 - **Cloud Sync**: Push and sync your context tree to ByteRover's cloud storage for backup and team collaboration
 - **Dynamic Domains**: Automatically creates new domains as your knowledge grows
 
@@ -135,13 +135,15 @@ The context tree organizes knowledge into:
 
 ### Integrating with Coding Agents
 
-Use `/gen-rules` to generate rule instruction files that help your AI coding agents understand and work with ByteRover:
+Use `/connectors` to manage integrations with your AI coding agents:
 
 ```
-/gen-rules
+/connectors
 ```
 
-This creates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that instruct the agent how to read from and contribute to your context tree.
+ByteRover supports two connector types:
+- **Hook integration** (Claude Code): Direct injection via IDE settings for seamless integration
+- **Rules-based** (all agents): Generates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that instruct the agent how to read from and contribute to your context tree
 
 ## Slash Commands Reference
 
@@ -198,16 +200,27 @@ This creates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that
 - `-l, --limit <n>`: Maximum spaces to fetch (default: 50)
 - `-o, --offset <n>`: Number of spaces to skip
 
-### Context Tree Management
+### Connectors & Context Tree Management
 
 | Command | Description |
 |---------|-------------|
-| `/gen-rules` | Generate rule files for AI coding agents (Claude Code, Cursor, etc.) |
-| `/clear [-y] [directory]` | Reset context tree to default domains |
+| `/connectors` | Manage agent connectors (rules-based or hook integration) |
+| `/reset [-y] [directory]` | Reset context tree to empty state |
 
-**Clear options:**
+**Reset options:**
 - `-y, --yes`: Skip confirmation prompt
 
+### Session Management
+
+| Command | Description |
+|---------|-------------|
+| `/new [-y]` | Start a fresh session (ends current session, clears conversation) |
+
+**Options:**
+- `-y, --yes`: Skip confirmation prompt
+
+**Note:** This command does NOT affect the context tree—it only clears the conversation history and starts a new session.
+
 ### Project Setup
 
 | Command | Description |
@@ -328,7 +341,7 @@ If you encounter issues or have questions:
 
 1. Check the command help in the REPL
 2. Run `/status` to review your project state
-3. Visit [ByteRover Docs](https://docs.byterover.dev)
+3. Visit the [ByteRover Docs](https://docs.byterover.dev)
 4. Contact ByteRover support
 
 ---

package/dist/commands/curate.js

@@ -14,7 +14,7 @@ export default class Curate extends Command {
     };
     static description = `Curate context to the context tree (connects to running brv instance)
 
-Requires a running brv instance. Start one with: brv start
+Requires a running brv instance. Start one with: brv
 
 Good examples:
 - "Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts"

package/dist/commands/hook-prompt-submit.d.ts

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+import { ITemplateLoader } from '../core/interfaces/i-template-loader.js';
+/**
+ * Dependencies required by HookPromptSubmit command.
+ * Exported for test mocking.
+ */
+export type HookPromptSubmitDependencies = {
+    templateLoader: ITemplateLoader;
+};
+/**
+ * Hidden command for coding agent pre-prompt hooks.
+ * Outputs ByteRover workflow instructions to stdout.
+ * The agent wraps the output in system context (e.g., <system-reminder> tags).
+ *
+ * Supported agents:
+ * - Claude Code: .claude/settings.local.json (UserPromptSubmit)
+ */
+export default class HookPromptSubmit extends Command {
+    static description: string;
+    static hidden: boolean;
+    /**
+     * Factory method for creating dependencies.
+     * Override in tests to inject mock dependencies.
+     */
+    protected createDependencies(): HookPromptSubmitDependencies;
+    run(): Promise<void>;
+}

package/dist/commands/hook-prompt-submit.js

@@ -0,0 +1,39 @@
+import { Command } from '@oclif/core';
+import { isDevelopment } from '../config/environment.js';
+import { FsFileService } from '../infra/file/fs-file-service.js';
+import { FsTemplateLoader } from '../infra/template/fs-template-loader.js';
+/**
+ * Hidden command for coding agent pre-prompt hooks.
+ * Outputs ByteRover workflow instructions to stdout.
+ * The agent wraps the output in system context (e.g., <system-reminder> tags).
+ *
+ * Supported agents:
+ * - Claude Code: .claude/settings.local.json (UserPromptSubmit)
+ */
+export default class HookPromptSubmit extends Command {
+    static description = 'Internal: Pre-prompt hook for coding agents';
+    static hidden = true;
+    /**
+     * Factory method for creating dependencies.
+     * Override in tests to inject mock dependencies.
+     */
+    createDependencies() {
+        const fileService = new FsFileService();
+        const templateLoader = new FsTemplateLoader(fileService);
+        return { templateLoader };
+    }
+    async run() {
+        try {
+            const { templateLoader } = this.createDependencies();
+            const instructions = await templateLoader.loadSection('brv-instructions');
+            // Output to stdout (agent wraps in system context)
+            this.log(instructions);
+        }
+        catch (error) {
+            // Silently fail in production - don't interrupt agent workflow
+            if (isDevelopment()) {
+                console.error('[hook-prompt-submit] Template load failed:', error);
+            }
+        }
+    }
+}

package/dist/commands/main.d.ts

@@ -14,4 +14,17 @@ export default class Main extends Command {
      */
     static hidden: boolean;
     run(): Promise<void>;
+    /**
+     * Resolve session ID for the agent.
+     *
+     * Strategy:
+     * 1. Check for active session in .brv/sessions/active.json
+     * 2. If active session exists and is valid (not stale), resume it
+     * 3. If stale (process crashed), mark as interrupted and create new
+     * 4. If no active session, create new session
+     * 5. Run session cleanup on startup
+     *
+     * @returns Session ID to use
+     */
+    private resolveSessionId;
 }

package/dist/commands/main.js

@@ -1,4 +1,7 @@
 import { Command } from '@oclif/core';
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_SESSION_RETENTION } from '../core/domain/cipher/session/session-metadata.js';
+import { SessionMetadataStore } from '../infra/cipher/session/session-metadata-store.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { getProcessManager } from '../infra/process/index.js';
 import { startRepl } from '../infra/repl/repl-startup.js';
@@ -6,7 +9,7 @@ import { FileGlobalConfigStore } from '../infra/storage/file-global-config-store
 import { FileOnboardingPreferenceStore } from '../infra/storage/file-onboarding-preference-store.js';
 import { createTokenStore } from '../infra/storage/token-store.js';
 import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
-import { initSessionLog } from '../utils/process-logger.js';
+import { initSessionLog, processManagerLog } from '../utils/process-logger.js';
 /**
  * Main command - Entry point for ByteRover CLI.
  *
@@ -30,9 +33,13 @@ export default class Main extends Command {
             this.log("Run 'brv --help' for available commands.");
             return;
         }
+        // Resolve session ID (auto-resume or create new)
+        const sessionId = await this.resolveSessionId();
+        processManagerLog(`Session ID resolved: ${sessionId}`);
         // Start Transport and Agent processes (v0.5.0 architecture)
+        // Pass session ID to Agent via environment variable
         const processManager = getProcessManager();
-        await processManager.start();
+        await processManager.start({ sessionId });
         const tokenStore = createTokenStore();
         const globalConfigStore = new FileGlobalConfigStore();
         const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
@@ -52,4 +59,48 @@ export default class Main extends Command {
             await processManager.stop();
         }
     }
+    /**
+     * Resolve session ID for the agent.
+     *
+     * Strategy:
+     * 1. Check for active session in .brv/sessions/active.json
+     * 2. If active session exists and is valid (not stale), resume it
+     * 3. If stale (process crashed), mark as interrupted and create new
+     * 4. If no active session, create new session
+     * 5. Run session cleanup on startup
+     *
+     * @returns Session ID to use
+     */
+    async resolveSessionId() {
+        const sessionStore = new SessionMetadataStore();
+        // Run cleanup on startup (async, don't wait)
+        sessionStore.cleanupSessions(DEFAULT_SESSION_RETENTION).catch((error) => {
+            processManagerLog(`Session cleanup failed: ${error}`);
+        });
+        // Check for active session
+        const activeSession = await sessionStore.getActiveSession();
+        if (activeSession) {
+            // Check if the active session is stale (process not running)
+            const isStale = await sessionStore.isActiveSessionStale();
+            if (isStale) {
+                // Mark the old session as interrupted
+                processManagerLog(`Active session ${activeSession.sessionId} is stale, marking as interrupted`);
+                await sessionStore.markSessionInterrupted(activeSession.sessionId);
+            }
+            else {
+                // Valid active session - resume it
+                processManagerLog(`Resuming active session: ${activeSession.sessionId}`);
+                return activeSession.sessionId;
+            }
+        }
+        // Create new session
+        const newSessionId = `agent-session-${randomUUID()}`;
+        processManagerLog(`Creating new session: ${newSessionId}`);
+        // Save session metadata
+        const metadata = sessionStore.createSessionMetadata(newSessionId);
+        await sessionStore.saveSession(metadata);
+        // Set as active session
+        await sessionStore.setActiveSession(newSessionId);
+        return newSessionId;
+    }
 }

package/dist/commands/query.js

@@ -14,7 +14,7 @@ export default class Query extends Command {
     };
     static description = `Query and retrieve information from the context tree (connects to running brv instance)
 
-Requires a running brv instance. Start one with: brv start
+Requires a running brv instance. Start one with: brv
 
 Good:
 - "How is user authentication implemented?"

package/dist/commands/status.js

@@ -14,9 +14,14 @@ export default class Status extends Command {
     static description = 'Show CLI status and project information. Display local context tree managed by ByteRover CLI';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
-        '# Check status after login:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>',
-        '# Verify project initialization:\n<%= config.bin %> init\n<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %>',
+        '# Check status after login (in REPL):',
+        '/login',
+        '/status',
+        '',
+        '# Verify project initialization (in REPL):',
+        '/init',
+        '/status',
+        '',
         '<%= config.bin %> <%= command.id %> /path/to/project',
         '<%= config.bin %> <%= command.id %> --format json',
     ];

package/dist/constants.d.ts

@@ -23,7 +23,7 @@ export declare const DEFAULT_BRANCH = "main";
  * ByteRover documentation URL.
  * Used in CLI help output to direct users to online documentation.
  */
-export declare const DOCS_URL = "https://docs.byterover.dev/beta";
+export declare const DOCS_URL = "https://docs.byterover.dev";
 export declare const TRANSPORT_HOST = "127.0.0.1";
 export declare const TRANSPORT_REQUEST_TIMEOUT_MS = 10000;
 export declare const TRANSPORT_ROOM_TIMEOUT_MS = 2000;
@@ -34,4 +34,4 @@ export declare const TRANSPORT_RECONNECTION_ATTEMPTS = 30;
 export declare const TRANSPORT_PING_INTERVAL_MS = 5000;
 export declare const TRANSPORT_PING_TIMEOUT_MS = 10000;
 export declare const TRANSPORT_DEFAULT_TRANSPORTS: ('polling' | 'websocket')[];
-export declare const DEFAULT_LLM_MODEL = "gemini-2.5-pro";
+export declare const DEFAULT_LLM_MODEL = "gemini-3-flash-preview";

package/dist/constants.js

@@ -28,7 +28,7 @@ export const DEFAULT_BRANCH = 'main';
  * ByteRover documentation URL.
  * Used in CLI help output to direct users to online documentation.
  */
-export const DOCS_URL = 'https://docs.byterover.dev/beta';
+export const DOCS_URL = 'https://docs.byterover.dev';
 // Transport layer constants (optimized for localhost real-time)
 export const TRANSPORT_HOST = '127.0.0.1'; // Use hostname for better sandbox compatibility
 export const TRANSPORT_REQUEST_TIMEOUT_MS = 10_000; // 10s - most operations complete quickly
@@ -43,4 +43,4 @@ export const TRANSPORT_PING_TIMEOUT_MS = 10_000; // 10s timeout - avoid false di
 // HTTP polling may be blocked by IDE sandboxes causing "xhr poll error"
 export const TRANSPORT_DEFAULT_TRANSPORTS = ['websocket'];
 // LLM Model defaults
-export const DEFAULT_LLM_MODEL = 'gemini-2.5-pro';
+export const DEFAULT_LLM_MODEL = 'gemini-3-flash-preview';

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

@@ -27,19 +27,54 @@ export const LLM_REGISTRY = {
         supportedFileTypes: [],
     },
     gemini: {
-        defaultModel: 'gemini-2.5-flash',
+        defaultModel: 'gemini-3-flash-preview',
         models: [
-            // Gemini 2.5 series
+            // Gemini 3 series (Preview)
             {
                 capabilities: {
                     supportsAudio: true,
                     supportsImages: true,
+                    supportsMultimodalFunctionResponse: true,
                     supportsPdf: true,
                     supportsStreaming: true,
                     supportsThinking: true,
                 },
                 charsPerToken: 4,
                 default: true,
+                displayName: 'Gemini 3 Flash (Preview)',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-3-flash-preview',
+                pricing: { inputPerM: 0.075, outputPerM: 0.3 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsMultimodalFunctionResponse: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
+                displayName: 'Gemini 3 Pro (Preview)',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-3-pro-preview',
+                pricing: { inputPerM: 1.25, outputPerM: 5 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
+            // Gemini 2.5 series
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
                 displayName: 'Gemini 2.5 Flash',
                 maxInputTokens: 1_000_000,
                 maxOutputTokens: 8192,
@@ -47,6 +82,22 @@ export const LLM_REGISTRY = {
                 pricing: { inputPerM: 0.075, outputPerM: 0.3 },
                 supportedFileTypes: ['image', 'pdf', 'audio'],
             },
+            {
+                capabilities: {
+                    supportsAudio: true,
+                    supportsImages: true,
+                    supportsPdf: true,
+                    supportsStreaming: true,
+                    supportsThinking: true,
+                },
+                charsPerToken: 4,
+                displayName: 'Gemini 2.5 Pro',
+                maxInputTokens: 1_000_000,
+                maxOutputTokens: 8192,
+                name: 'gemini-2.5-pro',
+                pricing: { inputPerM: 1.25, outputPerM: 5 },
+                supportedFileTypes: ['image', 'pdf', 'audio'],
+            },
             // Gemini 1.5 series
             {
                 capabilities: {

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

@@ -28,6 +28,8 @@ export interface ModelCapabilities {
     supportsAudio: boolean;
     /** Whether the model supports image input */
     supportsImages: boolean;
+    /** Whether the model supports multimodal data in function responses (Gemini 3+) */
+    supportsMultimodalFunctionResponse?: boolean;
     /** Whether the model supports PDF input */
     supportsPdf: boolean;
     /** Whether the model supports streaming responses */

package/dist/core/domain/cipher/process/types.d.ts

@@ -17,6 +17,13 @@ export interface ProcessConfig {
      * Custom environment variables for all commands.
      */
     environment: Record<string, string>;
+    /**
+     * Grace period in milliseconds to wait after SIGTERM before sending SIGKILL.
+     * Allows processes time to clean up gracefully.
+     *
+     * @default 5000 (5 seconds)
+     */
+    killGracePeriod: number;
     /**
      * Maximum number of concurrent background processes.
      * @default 5

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

@@ -0,0 +1,178 @@
+/**
+ * Session Metadata Types and Schemas
+ *
+ * Defines the data structures for persistent session management.
+ * Sessions are stored in .brv/sessions/ directory as JSON files.
+ *
+ * Design adapted from gemini-cli's ChatRecordingService pattern.
+ */
+import { z } from 'zod';
+/**
+ * Session status indicating lifecycle state.
+ */
+export type SessionStatus = 'active' | 'ended' | 'interrupted';
+/**
+ * Active session pointer stored in .brv/sessions/active.json
+ * Points to the currently active session for auto-resume.
+ */
+export interface ActiveSessionPointer {
+    /** ISO timestamp when this session became active */
+    activatedAt: string;
+    /** PID of the process that activated this session (for stale detection) */
+    pid: number;
+    /**
+     * Unique token identifying this specific process instance.
+     * Used to detect PID reuse: if the PID exists but token differs,
+     * it's a different process that got the same PID after the original crashed.
+     * Optional for backward compatibility with existing session files.
+     */
+    processToken?: string;
+    /** Session ID of the currently active session */
+    sessionId: string;
+}
+/**
+ * Session metadata stored in .brv/sessions/session-*.json
+ * Contains metadata about a session for listing and management.
+ */
+export interface SessionMetadata {
+    /** ISO timestamp when session was created */
+    createdAt: string;
+    /** ISO timestamp of last activity */
+    lastUpdated: string;
+    /** Number of messages in session (cached for quick display) */
+    messageCount: number;
+    /** Unique session identifier (UUID) */
+    sessionId: string;
+    /** Session lifecycle status */
+    status: SessionStatus;
+    /** Optional AI-generated summary */
+    summary?: string;
+    /** Session title (generated from first user message) */
+    title?: string;
+    /** Project working directory (for validation) */
+    workingDirectory: string;
+}
+/**
+ * Session info for display purposes (extends metadata with computed fields).
+ */
+export interface SessionInfo extends SessionMetadata {
+    /** Filename without extension */
+    file: string;
+    /** Full filename including .json extension */
+    fileName: string;
+    /** First user message content (cleaned) */
+    firstUserMessage?: string;
+    /** Display index in the list (1-based) */
+    index: number;
+    /** Whether this is the currently active session */
+    isCurrentSession: boolean;
+}
+/**
+ * Result of resolving a session selection.
+ */
+export interface SessionSelectionResult {
+    /** Display info string for user feedback */
+    displayInfo: string;
+    /** Loaded session metadata */
+    sessionData: SessionMetadata;
+    /** Full path to session metadata file */
+    sessionPath: string;
+}
+/**
+ * Schema for ActiveSessionPointer validation.
+ */
+export declare const ActiveSessionPointerSchema: z.ZodObject<{
+    activatedAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    pid: z.ZodNumber;
+    processToken: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    pid: number;
+    activatedAt: string;
+    processToken?: string | undefined;
+}, {
+    sessionId: string;
+    pid: number;
+    activatedAt: string;
+    processToken?: string | undefined;
+}>;
+/**
+ * Schema for SessionMetadata validation.
+ */
+export declare const SessionMetadataSchema: z.ZodObject<{
+    createdAt: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    lastUpdated: z.ZodUnion<[z.ZodString, z.ZodString]>;
+    messageCount: z.ZodNumber;
+    sessionId: z.ZodString;
+    status: z.ZodEnum<["active", "ended", "interrupted"]>;
+    summary: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    workingDirectory: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "ended" | "interrupted";
+    sessionId: string;
+    createdAt: string;
+    lastUpdated: string;
+    messageCount: number;
+    workingDirectory: string;
+    summary?: string | undefined;
+    title?: string | undefined;
+}, {
+    status: "active" | "ended" | "interrupted";
+    sessionId: string;
+    createdAt: string;
+    lastUpdated: string;
+    messageCount: number;
+    workingDirectory: string;
+    summary?: string | undefined;
+    title?: string | undefined;
+}>;
+/** Prefix for session metadata files */
+export declare const SESSION_FILE_PREFIX = "session-";
+/** Directory name for session storage */
+export declare const SESSIONS_DIR = "sessions";
+/** Filename for active session pointer */
+export declare const ACTIVE_SESSION_FILE = "active.json";
+/** Default session retention config */
+export declare const DEFAULT_SESSION_RETENTION: {
+    /** Maximum age in days before auto-cleanup */
+    maxAgeDays: number;
+    /** Maximum number of sessions to keep */
+    maxCount: number;
+    /** Run cleanup on startup */
+    runOnStartup: boolean;
+};
+/**
+ * Generate a session filename from timestamp and session ID.
+ *
+ * @param sessionId - The session UUID
+ * @returns Filename in format: session-YYYY-MM-DDTHH-MM-SS-<uuid-prefix>.json
+ */
+export declare function generateSessionFilename(sessionId: string): string;
+/**
+ * Parse a session filename to extract timestamp and UUID prefix.
+ *
+ * @param filename - The session filename
+ * @returns Parsed components or null if invalid format
+ */
+export declare function parseSessionFilename(filename: string): null | {
+    timestamp: string;
+    uuidPrefix: string;
+};
+/**
+ * Format a timestamp as relative time.
+ *
+ * @param timestamp - ISO timestamp string
+ * @param style - 'long' (e.g., "2 hours ago") or 'short' (e.g., "2h")
+ * @returns Formatted relative time string
+ */
+export declare function formatRelativeTime(timestamp: string, style?: 'long' | 'short'): string;
+/**
+ * Clean and sanitize message content for display.
+ * Converts newlines to spaces, collapses whitespace, removes non-printable chars.
+ *
+ * @param message - Raw message content
+ * @returns Cleaned message suitable for display
+ */
+export declare function cleanMessageForTitle(message: string): string;