@ai-setting/roy-agent-cli 1.3.19 → 1.3.22

package/dist/core/src/env/session/session-component.d.ts

@@ -1,290 +0,0 @@
-/**
- * @fileoverview Session Component
- *
- * Component for managing session lifecycle
- */
-import { BaseComponent, type ComponentConfig } from "../component";
-import { type SessionConfig, type Session, type CreateSessionOptions, type UpdateSessionOptions, type ListSessionsOptions, type SessionMessage, type AddMessageOptions, type SessionCheckpoint, // (new)
-type CompactOptions, // (new)
-type CompactResult, // (new)
-type CompactPreview, // (new)
-type GetContextOptions, // (new)
-type GetContextResult, // (new)
-type SearchMessagesOptions, // (new)
-type SearchResult } from "./types";
-import type { ConfigComponent } from "../../config/config-component";
-export type { SessionConfig, Session, SessionMessage, CreateSessionOptions, UpdateSessionOptions, ListSessionsOptions, AddMessageOptions, SessionCheckpoint, // (new)
-CompactOptions, // (new)
-CompactResult, // (new)
-CompactPreview, // (new)
-GetContextOptions, // (new)
-GetContextResult, // (new)
-SearchMessagesOptions, // (new) Search
-SearchResult, // (new) Search
-MessageMatch, } from "./types";
-/**
- * SessionComponent 配置选项（通过 options 传递）
- *
- * 配置加载顺序（优先级从低到高）：
- * 1. File - 配置文件（通过 configPath 指定）
- * 2. Env - 环境变量（通过 envPrefix 配置前缀）
- * 3. Object - 直接传入的 config 对象（最高优先级）
- */
-export interface SessionComponentOptions {
-    /** ConfigComponent 实例（必填） */
-    configComponent: ConfigComponent;
-    /** 配置文件相对路径（可选，基于 XDG_DATA_HOME） */
-    configPath?: string;
-    /** 环境变量前缀（可选，默认 "SESSION"） */
-    envPrefix?: string;
-    /** 直接传入的配置对象（可选，优先级最高） */
-    config?: Partial<SessionConfig>;
-}
-/**
- * SessionComponent
- *
- * Manages session lifecycle including:
- * - Session CRUD operations
- * - Message management
- * - Active session tracking
- */
-export declare class SessionComponent extends BaseComponent {
-    readonly name = "session";
-    readonly version = "1.1.0";
-    private config?;
-    private store?;
-    private activeSessionId?;
-    private hooksConfig;
-    /** ConfigComponent 用于配置管理 */
-    private configComponent?;
-    /** 配置变更 watcher 清理函数 */
-    private configWatcher?;
-    /** Summary Agent for checkpoint generation [new] */
-    private summaryAgent?;
-    /** PromptComponent reference for SummaryAgent */
-    private promptComponent?;
-    /** LLMComponent reference for SummaryAgent */
-    private llmComponent?;
-    constructor();
-    /**
-     * Initialize the component
-     *
-     * 配置加载优先级（从高到低）：
-     * 1. Object - 直接传入的 config 对象
-     * 2. Env - 环境变量（通过 envPrefix 配置前缀）
-     * 3. File - 配置文件（通过 configPath 指定）
-     */
-    init(config?: ComponentConfig): Promise<void>;
-    /**
-     * 获取默认 session 数据库路径
-     */
-    private getDefaultSessionDbPath;
-    /**
-     * 注册配置到 ConfigComponent
-     *
-     * 配置加载顺序（优先级从低到高）：
-     * 1. Defaults - 默认值（最低）
-     * 2. FileSource - 从配置文件加载
-     * 3. EnvSource - 从环境变量加载
-     * 4. config 对象 - 直接传入的配置（最高）
-     */
-    private registerConfig;
-    /**
-     * 构建最终配置对象
-     */
-    private buildConfig;
-    /**
-     * 将配置对象展平为点号路径
-     */
-    private flattenConfig;
-    /**
-     * 注册配置热更新监听
-     */
-    private registerConfigWatcher;
-    /**
-     * 处理配置变更
-     */
-    protected onConfigChange(event: {
-        key: string;
-        oldValue?: unknown;
-        newValue?: unknown;
-    }): void;
-    /**
-     * Start the component
-     */
-    onStart(): Promise<void>;
-    /**
-     * Stop the component
-     */
-    onStop(): Promise<void>;
-    /**
-     * Create a new session
-     */
-    create(options?: CreateSessionOptions): Promise<Session>;
-    /**
-     * Get a session by ID
-     */
-    get(id: string): Promise<Session | undefined>;
-    /**
-     * Get a session with full context (for Memory Agent)
-     */
-    getSession(id: string): Promise<{
-        sessionId: string;
-        title: string;
-        messages: any[];
-    } | null>;
-    /**
-     * Search sessions by query (for Memory Agent)
-     *
-     * Simple implementation: list all sessions and return them for the agent to filter
-     */
-    searchSessions(query: string, options?: {
-        session_id?: string;
-        limit?: number;
-    }): Promise<Array<{
-        sessionId: string;
-        title: string;
-        preview: string;
-        timestamp: number;
-    }>>;
-    /**
-     * List all sessions
-     */
-    list(options?: ListSessionsOptions): Promise<Session[]>;
-    /**
-     * Get total session count
-     */
-    getCount(): Promise<number>;
-    /**
-     * Update a session
-     */
-    update(id: string, updates: UpdateSessionOptions): Promise<boolean>;
-    /**
-     * Delete a session
-     */
-    delete(id: string): Promise<boolean>;
-    /**
-     * Get the current active session
-     */
-    getActiveSession(): Session | undefined;
-    /**
-     * Get the active session ID
-     */
-    getActiveSessionId(): string | undefined;
-    /**
-     * Set the active session
-     */
-    setActiveSession(id: string): Promise<boolean>;
-    /**
-     * Add a message to a session
-     */
-    addMessage(sessionId: string, message: AddMessageOptions): Promise<string | undefined>;
-    /**
-     * Get messages from a session
-     */
-    getMessages(sessionId: string, options?: {
-        offset?: number;
-        limit?: number;
-    }): Promise<SessionMessage[]>;
-    /**
-     * Get message count for a session
-     */
-    getMessageCount(sessionId: string, includeArchived?: boolean): Promise<number>;
-    /**
-     * Get indexes of all messages with the specified role
-     * @param sessionId - Session ID
-     * @param role - Role to filter by (e.g., "user", "assistant")
-     * @returns Array of message indexes (0-indexed, in chronological order)
-     */
-    getMessageIndexes(sessionId: string, role: string): Promise<number[]>;
-    private executeBeforeHooks;
-    private executeAfterHooks;
-    private generateTitle;
-    /**
-     * Set components for SummaryAgent
-     *
-     * Call this after initialization if you need compact functionality
-     */
-    setSummaryComponents(promptComponent: any, llmComponent: any): void;
-    /**
-     * 初始化 SummaryAgent（如未初始化）
-     */
-    private ensureSummaryAgent;
-    /**
-     * 生成场景化压缩提示 (Compact Hint)
-     *
-     * 两阶段自动压缩的第一阶段：
-     * 根据会话历史生成场景化的压缩提示
-     *
-     * @param sessionId 会话 ID
-     * @returns 生成的场景化提示
-     */
-    generateCompactHint(sessionId: string): Promise<string>;
-    /**
-     * Compact a session
-     *
-     * 1. Get messages from latest checkpoint to current
-     * 2. Call Summary Agent to generate checkpoint
-     * 3. Save checkpoint and archive messages
-     *
-     * 支持 scenarioHint 参数，用于指导不同场景下的压缩重点提取
-     */
-    compact(sessionId: string, options?: CompactOptions): Promise<CompactResult>;
-    /**
-     * Extract recent messages from the conversation for checkpoint context
-     *
-     * Extracts the last N turns of user query + assistant text response,
-     * excluding tool calls and tool results.
-     *
-     * @param messages - All messages in the conversation
-     * @param turnCount - Number of turns to extract (default: 2)
-     * @returns Array of recent messages formatted as { role, content }
-     */
-    private extractRecentMessages;
-    /**
-     * Preview compact operation
-     */
-    previewCompact(sessionId: string): Promise<CompactPreview>;
-    /**
-     * Get all checkpoints for a session
-     */
-    getCheckpoints(sessionId: string): Promise<SessionCheckpoint[]>;
-    /**
-     * Get a specific checkpoint
-     */
-    getCheckpoint(sessionId: string, checkpointId: string): Promise<SessionCheckpoint | undefined>;
-    /**
-     * Delete a checkpoint and restore archived messages
-     */
-    deleteCheckpoint(sessionId: string, checkpointId: string): Promise<boolean>;
-    /**
-     * Get session context
-     *
-     * Returns messages starting from the latest checkpoint by default
-     */
-    getContext(sessionId: string, options?: GetContextOptions): Promise<GetContextResult>;
-    /**
-     * Check if session needs compaction
-     */
-    shouldCompact(sessionId: string): Promise<boolean>;
-    /**
-     * Search messages across sessions
-     *
-     * Searches all messages matching the query, aggregated by session.
-     * Supports SQLite FTS5 for fast full-text search.
-     */
-    searchMessages(options: SearchMessagesOptions): Promise<SearchResult[]>;
-    /**
-     * Get latest checkpoint from session
-     */
-    private getLatestCheckpoint;
-    /**
-     * Create checkpoint message (user role)
-     *
-     * Generates a markdown-formatted checkpoint summary as a user message,
-     * allowing it to appear in the message list and provide context for
-     * subsequent LLM calls.
-     */
-    private createCheckpointMessage;
-}
-//# sourceMappingURL=session-component.d.ts.map

package/dist/core/src/env/session/session-component.extract-recent-messages.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * @fileoverview SessionComponent extractRecentMessages Tests
- *
- * Tests for the extractRecentMessages method
- */
-export {};
-//# sourceMappingURL=session-component.extract-recent-messages.test.d.ts.map

package/dist/core/src/env/session/session-component.extract-recent-messages.test.js

@@ -1,166 +0,0 @@
-/**
- * @fileoverview SessionComponent extractRecentMessages Tests
- *
- * Tests for the extractRecentMessages method
- */
-import { describe, it, expect, beforeEach } from 'bun:test';
-import { SessionComponent } from "./session-component.js";
-import { MemorySessionStore } from "./storage/memory.js";
-describe('SessionComponent.extractRecentMessages', () => {
-    let component;
-    let store;
-    beforeEach(async () => {
-        // Create component with memory store
-        component = new SessionComponent();
-        store = new MemorySessionStore();
-        // Inject mock dependencies
-        component.store = store;
-        component.hooksConfig = {};
-    });
-    // Helper to create test messages
-    function createMessage(id, role, content, parts) {
-        return {
-            id,
-            sessionID: 'test-session',
-            role,
-            content,
-            timestamp: Date.now(),
-            parts,
-            metadata: {},
-        };
-    }
-    describe('basic extraction', () => {
-        it('should extract 2 turns by default', async () => {
-            const messages = [
-                createMessage('1', 'user', 'First question'),
-                createMessage('2', 'assistant', 'First answer'),
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-                createMessage('5', 'user', 'Third question'),
-                createMessage('6', 'assistant', 'Third answer'),
-            ];
-            // Access private method via any cast
-            const result = component.extractRecentMessages(messages);
-            expect(result.length).toBe(4); // 2 turns = user + assistant pairs
-            expect(result[0]).toEqual({ role: 'user', content: 'Second question' });
-            expect(result[1]).toEqual({ role: 'assistant', content: 'Second answer' });
-            expect(result[2]).toEqual({ role: 'user', content: 'Third question' });
-            expect(result[3]).toEqual({ role: 'assistant', content: 'Third answer' });
-        });
-        it('should extract 1 turn when specified', async () => {
-            const messages = [
-                createMessage('1', 'user', 'First question'),
-                createMessage('2', 'assistant', 'First answer'),
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(2); // 1 turn = user + assistant
-            expect(result[0]).toEqual({ role: 'user', content: 'Second question' });
-            expect(result[1]).toEqual({ role: 'assistant', content: 'Second answer' });
-        });
-        it('should extract 3 turns when specified', async () => {
-            const messages = [
-                createMessage('1', 'user', 'First question'),
-                createMessage('2', 'assistant', 'First answer'),
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-                createMessage('5', 'user', 'Third question'),
-                createMessage('6', 'assistant', 'Third answer'),
-            ];
-            const result = component.extractRecentMessages(messages, 3);
-            expect(result.length).toBe(6); // 3 turns
-        });
-    });
-    describe('skip tool calls and results', () => {
-        it('should skip assistant messages with tool-call parts', async () => {
-            const messages = [
-                createMessage('1', 'user', 'Run a command'),
-                createMessage('2', 'assistant', 'I will run the command', [
-                    { type: 'tool-call', toolName: 'bash' }
-                ]),
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            // Should skip the tool-call message and find next user+assistant pair
-            expect(result.length).toBe(2);
-            expect(result[0]).toEqual({ role: 'user', content: 'Second question' });
-            expect(result[1]).toEqual({ role: 'assistant', content: 'Second answer' });
-        });
-        it('should skip assistant messages with tool-result parts', async () => {
-            const messages = [
-                createMessage('1', 'user', 'Run a command'),
-                createMessage('2', 'assistant', 'Command completed', [
-                    { type: 'tool-result', toolName: 'bash' }
-                ]),
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(2);
-            expect(result[0]).toEqual({ role: 'user', content: 'Second question' });
-            expect(result[1]).toEqual({ role: 'assistant', content: 'Second answer' });
-        });
-        it('should include assistant messages without tool parts', async () => {
-            const messages = [
-                createMessage('1', 'user', 'Hello'),
-                createMessage('2', 'assistant', 'Hi there!'), // No tool parts
-                createMessage('3', 'user', 'How are you?'),
-                createMessage('4', 'assistant', 'I am fine!'),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(2);
-            expect(result[1]).toEqual({ role: 'assistant', content: 'I am fine!' });
-        });
-    });
-    describe('skip checkpoint messages', () => {
-        it('should skip checkpoint messages when extracting', async () => {
-            const messages = [
-                createMessage('1', 'user', 'First question'),
-                createMessage('2', 'assistant', 'First answer'),
-                createMessage('3', 'user', '', undefined), // Will be checkpoint
-                createMessage('3', 'user', 'Second question'),
-                createMessage('4', 'assistant', 'Second answer'),
-            ];
-            // Mark checkpoint
-            messages[2].metadata = { isCheckpoint: true };
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(2);
-            expect(result[0]).toEqual({ role: 'user', content: 'Second question' });
-        });
-    });
-    describe('edge cases', () => {
-        it('should return empty array if no valid turns found', async () => {
-            const messages = [
-                createMessage('1', 'assistant', 'I started first', [
-                    { type: 'tool-call', toolName: 'bash' }
-                ]),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(0);
-        });
-        it('should handle empty messages array', async () => {
-            const messages = [];
-            const result = component.extractRecentMessages(messages);
-            expect(result.length).toBe(0);
-        });
-        it('should handle only user messages', async () => {
-            const messages = [
-                createMessage('1', 'user', 'Hello'),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            expect(result.length).toBe(0);
-        });
-        it('should handle messages with only empty content', async () => {
-            const messages = [
-                createMessage('1', 'user', ''),
-                createMessage('2', 'assistant', '  '),
-            ];
-            const result = component.extractRecentMessages(messages, 1);
-            // Empty content is filtered out
-            expect(result.length).toBe(0);
-        });
-    });
-});
-//# sourceMappingURL=session-component.extract-recent-messages.test.js.map