@xopcai/xopcbot 0.1.0

package/dist/session/chat-manager.d.ts

@@ -0,0 +1,49 @@
+import { SessionStore } from './store.js';
+import type { ChatInfo, ChatListQuery, ChatListResult } from './chat-types.js';
+export declare class ChatManager {
+    private store;
+    constructor(store: SessionStore);
+    /**
+     * List all known chats from sessions
+     */
+    listChats(query?: ChatListQuery): Promise<ChatListResult>;
+    /**
+     * Get a single chat by ID (channel:chatId)
+     */
+    getChat(chatId: string): Promise<ChatInfo | null>;
+    /**
+     * Get the most recently active chat
+     */
+    getLastActiveChat(): Promise<ChatInfo | null>;
+    /**
+     * Get recent chats for quick selection
+     */
+    getRecentChats(limit?: number): Promise<ChatInfo[]>;
+    /**
+     * Resolve a chat reference for cron job delivery
+     * Supports:
+     * - "last" -> most recently active chat
+     * - "channel:chatId" -> specific chat
+     * - "telegram:123456" -> specific Telegram chat
+     */
+    resolveChatForDelivery(ref: string): Promise<{
+        channel: string;
+        chatId: string;
+        chat?: ChatInfo;
+    } | null>;
+    /**
+     * Convert session metadata to chat info
+     */
+    private sessionToChatInfo;
+    /**
+     * Build display options for UI dropdown
+     */
+    buildChatOptions(): Promise<Array<{
+        value: string;
+        label: string;
+        displayName: string;
+        channel: string;
+        type: string;
+        lastActivity: string;
+    }>>;
+}

package/dist/session/chat-manager.js

@@ -0,0 +1,167 @@
+// Chat manager - provides chat discovery for cron job configuration
+// Inspired by openclaw's channel metadata design
+import { createLogger } from '../utils/logger.js';
+import { parseSessionKey, buildChatDisplayName, buildChatLabel } from './chat-types.js';
+const log = createLogger('ChatManager');
+export class ChatManager {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * List all known chats from sessions
+     */
+    async listChats(query = {}) {
+        // Get all sessions from store
+        const sessions = await this.store.list({
+            limit: 1000, // Get more to filter
+        });
+        // Convert sessions to chat info
+        let chats = sessions.items.map((session) => this.sessionToChatInfo(session));
+        // Remove duplicates (same channel:chatId)
+        const seen = new Set();
+        chats = chats.filter((chat) => {
+            if (seen.has(chat.id)) {
+                return false;
+            }
+            seen.add(chat.id);
+            return true;
+        });
+        // Apply filters
+        if (query.channel) {
+            chats = chats.filter((c) => c.channel === query.channel);
+        }
+        if (query.type) {
+            chats = chats.filter((c) => c.type === query.type);
+        }
+        if (query.search) {
+            const searchLower = query.search.toLowerCase();
+            chats = chats.filter((c) => c.chatId.toLowerCase().includes(searchLower) ||
+                c.name?.toLowerCase().includes(searchLower) ||
+                c.channel.toLowerCase().includes(searchLower));
+        }
+        // Apply sorting
+        const sortBy = query.sortBy || 'lastActivity';
+        const sortOrder = query.sortOrder || 'desc';
+        chats.sort((a, b) => {
+            let comparison = 0;
+            switch (sortBy) {
+                case 'lastActivity':
+                    comparison = new Date(a.lastActivityAt).getTime() - new Date(b.lastActivityAt).getTime();
+                    break;
+                case 'name':
+                    comparison = (a.name || '').localeCompare(b.name || '');
+                    break;
+                case 'messageCount':
+                    comparison = a.messageCount - b.messageCount;
+                    break;
+            }
+            return sortOrder === 'asc' ? comparison : -comparison;
+        });
+        // Apply pagination
+        const total = chats.length;
+        const limit = query.limit || 50;
+        const offset = query.offset || 0;
+        const items = chats.slice(offset, offset + limit);
+        return {
+            chats: items,
+            total,
+            limit,
+            offset,
+            hasMore: offset + limit < total,
+        };
+    }
+    /**
+     * Get a single chat by ID (channel:chatId)
+     */
+    async getChat(chatId) {
+        const result = await this.listChats({ search: chatId, limit: 1 });
+        return result.chats.find((c) => c.id === chatId) || null;
+    }
+    /**
+     * Get the most recently active chat
+     */
+    async getLastActiveChat() {
+        const result = await this.listChats({
+            sortBy: 'lastActivity',
+            sortOrder: 'desc',
+            limit: 1,
+        });
+        return result.chats[0] || null;
+    }
+    /**
+     * Get recent chats for quick selection
+     */
+    async getRecentChats(limit = 10) {
+        const result = await this.listChats({
+            sortBy: 'lastActivity',
+            sortOrder: 'desc',
+            limit,
+        });
+        return result.chats;
+    }
+    /**
+     * Resolve a chat reference for cron job delivery
+     * Supports:
+     * - "last" -> most recently active chat
+     * - "channel:chatId" -> specific chat
+     * - "telegram:123456" -> specific Telegram chat
+     */
+    async resolveChatForDelivery(ref) {
+        // Handle "last" reference
+        if (ref === 'last') {
+            const chat = await this.getLastActiveChat();
+            if (!chat) {
+                return null;
+            }
+            return {
+                channel: chat.channel,
+                chatId: chat.chatId,
+                chat,
+            };
+        }
+        // Parse channel:chatId format
+        const parsed = parseSessionKey(ref);
+        if (parsed.channel === 'unknown') {
+            return null;
+        }
+        // Try to find the chat for additional metadata
+        const chat = await this.getChat(ref);
+        return {
+            channel: parsed.channel,
+            chatId: parsed.chatId,
+            chat: chat || undefined,
+        };
+    }
+    /**
+     * Convert session metadata to chat info
+     */
+    sessionToChatInfo(session) {
+        const { channel, chatId, type } = parseSessionKey(session.key);
+        return {
+            id: `${channel}:${chatId}`,
+            channel,
+            chatId,
+            name: session.name,
+            type,
+            lastActivityAt: session.lastAccessedAt,
+            sessionKey: session.key,
+            messageCount: session.messageCount,
+        };
+    }
+    /**
+     * Build display options for UI dropdown
+     */
+    async buildChatOptions() {
+        const chats = await this.getRecentChats(20);
+        return chats.map((chat) => ({
+            value: chat.id,
+            label: buildChatLabel(chat),
+            displayName: buildChatDisplayName(chat),
+            channel: chat.channel,
+            type: chat.type,
+            lastActivity: chat.lastActivityAt,
+        }));
+    }
+}
+//# sourceMappingURL=chat-manager.js.map

package/dist/session/chat-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-manager.js","sourceRoot":"","sources":["../../src/session/chat-manager.ts"],"names":[],"mappings":"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"}

package/dist/session/chat-types.d.ts

@@ -0,0 +1,53 @@
+export interface ChatInfo {
+    /** Unique identifier: channel:chatId */
+    id: string;
+    /** Channel type: telegram, whatsapp, etc. */
+    channel: string;
+    /** Chat ID (numeric or string) */
+    chatId: string;
+    /** Human-readable name */
+    name?: string;
+    /** Chat type: direct (DM) or group */
+    type: 'direct' | 'group' | 'unknown';
+    /** Last activity timestamp */
+    lastActivityAt: string;
+    /** Session key associated with this chat */
+    sessionKey: string;
+    /** Number of messages in session */
+    messageCount: number;
+}
+export interface ChatListQuery {
+    /** Filter by channel */
+    channel?: string;
+    /** Filter by chat type */
+    type?: 'direct' | 'group';
+    /** Search by name or chatId */
+    search?: string;
+    /** Sort by: lastActivity, name, messageCount */
+    sortBy?: 'lastActivity' | 'name' | 'messageCount';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+export interface ChatListResult {
+    chats: ChatInfo[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+/** Channel labels for display */
+export declare const CHANNEL_LABELS: Record<string, string>;
+/** Parse a session key to extract chat information */
+export declare function parseSessionKey(key: string): {
+    channel: string;
+    chatId: string;
+    type: 'direct' | 'group' | 'unknown';
+};
+/** Build a display name for a chat */
+export declare function buildChatDisplayName(chat: ChatInfo): string;
+/** Build a short display label for a chat */
+export declare function buildChatLabel(chat: ChatInfo): string;

package/dist/session/chat-types.js

@@ -0,0 +1,63 @@
+// Chat types for cron job channel selection
+// Inspired by openclaw's channel metadata design
+/** Channel labels for display */
+export const CHANNEL_LABELS = {
+    telegram: 'Telegram',
+    whatsapp: 'WhatsApp',
+    gateway: 'Web UI',
+    cli: 'CLI',
+};
+/** Parse a session key to extract chat information */
+export function parseSessionKey(key) {
+    // Format: channel:chatId (e.g., telegram:123456, whatsapp:123456@g.us)
+    const parts = key.split(':');
+    if (parts.length < 2) {
+        return { channel: 'unknown', chatId: key, type: 'unknown' };
+    }
+    const channel = parts[0];
+    const chatId = parts.slice(1).join(':');
+    // Detect type based on patterns
+    let type = 'unknown';
+    if (channel === 'telegram') {
+        // Telegram: negative IDs are groups/channels, positive are DMs
+        const numId = parseInt(chatId, 10);
+        if (!isNaN(numId)) {
+            type = numId < 0 ? 'group' : 'direct';
+        }
+    }
+    else if (channel === 'whatsapp') {
+        // WhatsApp: ends with @g.us is group, @s.whatsapp.net is DM
+        if (chatId.endsWith('@g.us')) {
+            type = 'group';
+        }
+        else if (chatId.endsWith('@s.whatsapp.net') || chatId.endsWith('@c.us')) {
+            type = 'direct';
+        }
+    }
+    else if (channel === 'gateway' || channel === 'cli') {
+        type = 'direct';
+    }
+    return { channel, chatId, type };
+}
+/** Build a display name for a chat */
+export function buildChatDisplayName(chat) {
+    const channelLabel = CHANNEL_LABELS[chat.channel] || chat.channel;
+    if (chat.name) {
+        return `${channelLabel} · ${chat.name}`;
+    }
+    if (chat.type === 'direct') {
+        return `${channelLabel} · ${chat.chatId}`;
+    }
+    return `${channelLabel} · Group ${chat.chatId}`;
+}
+/** Build a short display label for a chat */
+export function buildChatLabel(chat) {
+    if (chat.name) {
+        return chat.name;
+    }
+    if (chat.type === 'direct') {
+        return 'Direct Message';
+    }
+    return `Group ${chat.chatId.slice(0, 8)}...`;
+}
+//# sourceMappingURL=chat-types.js.map

package/dist/session/chat-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-types.js","sourceRoot":"","sources":["../../src/session/chat-types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,iDAAiD;AA8CjD,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,QAAQ;IACjB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,GAAW;IAKzC,uEAAuE;IACvE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAExC,gCAAgC;IAChC,IAAI,IAAI,GAAmC,SAAS,CAAC;IAErD,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,+DAA+D;QAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxC,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,4DAA4D;QAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,IAAI,GAAG,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtD,IAAI,GAAG,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,oBAAoB,CAAC,IAAc;IACjD,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC;IAElE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,YAAY,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,GAAG,YAAY,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,GAAG,YAAY,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC;AAClD,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC"}

package/dist/session/index.d.ts

@@ -0,0 +1,5 @@
+export { SessionManager } from './manager.js';
+export { SessionStore } from './store.js';
+export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionIndex, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, } from './types.js';
+export type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
+export type { WindowConfig } from '../agent/memory/window.js';

package/dist/session/index.js

@@ -0,0 +1,5 @@
+// Session module exports
+export { SessionManager } from './manager.js';
+export { SessionStore } from './store.js';
+export { SessionStatus, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,aAAa,GASd,MAAM,YAAY,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,103 @@
+import EventEmitter from 'events';
+import type { SessionMetadata, SessionDetail, SessionListQuery, PaginatedResult, SessionStats, ExportFormat, SessionStatus } from './types.js';
+import type { Message } from '../types/index.js';
+import type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
+import type { WindowConfig } from '../agent/memory/window.js';
+export interface SessionManagerConfig {
+    workspace: string;
+    windowConfig?: Partial<WindowConfig>;
+    compactionConfig?: Partial<CompactionConfig>;
+}
+export declare class SessionManager extends EventEmitter {
+    private store;
+    constructor(config: SessionManagerConfig);
+    initialize(): Promise<void>;
+    listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
+    /**
+     * List all subagent sessions.
+     * Subagent sessions have keys starting with 'subagent:'.
+     */
+    listSubagents(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
+    getSession(key: string): Promise<SessionDetail | null>;
+    getSessionMetadata(key: string): Promise<SessionMetadata | null>;
+    deleteSession(key: string): Promise<boolean>;
+    deleteSessions(keys: string[]): Promise<{
+        success: string[];
+        failed: string[];
+    }>;
+    renameSession(key: string, name: string): Promise<void>;
+    tagSession(key: string, tags: string[]): Promise<void>;
+    untagSession(key: string, tags: string[]): Promise<void>;
+    setSessionTags(key: string, tags: string[]): Promise<void>;
+    archiveSession(key: string): Promise<void>;
+    unarchiveSession(key: string): Promise<void>;
+    pinSession(key: string): Promise<void>;
+    unpinSession(key: string): Promise<void>;
+    setSessionStatus(key: string, status: SessionStatus): Promise<void>;
+    searchSessions(query: string): Promise<SessionMetadata[]>;
+    searchInSession(key: string, keyword: string): Promise<Message[]>;
+    exportSession(key: string, format: ExportFormat): Promise<string>;
+    getStats(): Promise<SessionStats>;
+    archiveOldSessions(olderThanDays: number): Promise<number>;
+    migrateFromLegacy(): Promise<number>;
+    onSessionCreated(callback: (metadata: SessionMetadata) => void): void;
+    onSessionUpdated(callback: (data: {
+        key: string;
+        name?: string;
+        tags?: string[];
+    }) => void): void;
+    onSessionDeleted(callback: (data: {
+        key: string;
+    }) => void): void;
+    onSessionArchived(callback: (data: {
+        key: string;
+    }) => void): void;
+    onSessionRestored(callback: (data: {
+        key: string;
+    }) => void): void;
+    onSessionPinned(callback: (data: {
+        key: string;
+    }) => void): void;
+    onSessionUnpinned(callback: (data: {
+        key: string;
+    }) => void): void;
+    onSessionStatusChanged(callback: (data: {
+        key: string;
+        status: SessionStatus;
+    }) => void): void;
+    onSessionAccessed(callback: (data: {
+        key: string;
+    }) => void): void;
+    /** Load messages (MemoryStore API) */
+    loadMessages(key: string): Promise<import("@mariozechner/pi-agent-core/dist/types.js").AgentMessage[]>;
+    /** Save messages (MemoryStore API) */
+    saveMessages(key: string, messages: any[]): Promise<void>;
+    /** Delete session (MemoryStore API) */
+    delete(key: string): Promise<void>;
+    /** Get window stats (MemoryStore API) */
+    getWindowStats(messages: any[]): {
+        total: number;
+        system: number;
+        user: number;
+        assistant: number;
+        tool: number;
+        needsTrim: boolean;
+    };
+    /** Prepare compaction (MemoryStore API) */
+    prepareCompaction(key: string, messages: any[], contextWindow: number): {
+        needsCompaction: boolean;
+        messages: import("@mariozechner/pi-agent-core/dist/types.js").AgentMessage[];
+        stats?: ReturnType<any>;
+    };
+    /** Compact session (MemoryStore API) */
+    compact(key: string, messages: any[], contextWindow: number, instructions?: string): Promise<CompactionResult>;
+    /** Get compaction stats (MemoryStore API) */
+    getCompactionStats(key: string): Promise<{
+        compactionCount: number;
+        totalTokensBefore: number;
+        totalTokensAfter: number;
+        lastCompactionAt: any;
+    }>;
+    /** Estimate token usage (MemoryStore API) */
+    estimateTokenUsage(key: string, messages: any[]): Promise<number>;
+}

package/dist/session/manager.js

@@ -0,0 +1,200 @@
+// Session manager - high-level session management service
+import EventEmitter from 'events';
+import { createLogger } from '../utils/logger.js';
+import { SessionStore } from './store.js';
+const log = createLogger('SessionManager');
+export class SessionManager extends EventEmitter {
+    store;
+    constructor(config) {
+        super();
+        this.store = new SessionStore(config.workspace, config.windowConfig, config.compactionConfig);
+    }
+    async initialize() {
+        await this.store.initialize();
+        this.emit('ready');
+    }
+    // ========== CRUD Operations ==========
+    async listSessions(query) {
+        return this.store.list(query);
+    }
+    /**
+     * List all subagent sessions.
+     * Subagent sessions have keys starting with 'subagent:'.
+     */
+    async listSubagents(query = {}) {
+        // Filter for subagent sessions only
+        const subagentQuery = {
+            ...query,
+            search: query.search ? `subagent:${query.search}` : 'subagent:',
+        };
+        const result = await this.store.list(subagentQuery);
+        // Additional filtering to ensure only subagent sessions
+        const subagentSessions = result.items.filter((s) => s.key.startsWith('subagent:'));
+        return {
+            ...result,
+            items: subagentSessions,
+            total: subagentSessions.length,
+            hasMore: false, // Simplified for now
+        };
+    }
+    async getSession(key) {
+        const session = await this.store.get(key);
+        if (session) {
+            this.emit('sessionAccessed', { key });
+        }
+        return session;
+    }
+    async getSessionMetadata(key) {
+        return this.store.getMetadata(key);
+    }
+    async deleteSession(key) {
+        const result = await this.store.delete(key);
+        if (result) {
+            this.emit('sessionDeleted', { key });
+        }
+        return result;
+    }
+    async deleteSessions(keys) {
+        const result = await this.store.deleteMany(keys);
+        for (const key of result.success) {
+            this.emit('sessionDeleted', { key });
+        }
+        return result;
+    }
+    // ========== Metadata Updates ==========
+    async renameSession(key, name) {
+        await this.store.updateMetadata(key, { name });
+        this.emit('sessionUpdated', { key, name });
+    }
+    async tagSession(key, tags) {
+        const existing = await this.store.getMetadata(key);
+        if (!existing) {
+            throw new Error(`Session not found: ${key}`);
+        }
+        // Merge tags, remove duplicates
+        const mergedTags = [...new Set([...existing.tags, ...tags])];
+        await this.store.updateMetadata(key, { tags: mergedTags });
+        this.emit('sessionUpdated', { key, tags: mergedTags });
+    }
+    async untagSession(key, tags) {
+        const existing = await this.store.getMetadata(key);
+        if (!existing) {
+            throw new Error(`Session not found: ${key}`);
+        }
+        const filteredTags = existing.tags.filter((t) => !tags.includes(t));
+        await this.store.updateMetadata(key, { tags: filteredTags });
+        this.emit('sessionUpdated', { key, tags: filteredTags });
+    }
+    async setSessionTags(key, tags) {
+        await this.store.updateMetadata(key, { tags: [...new Set(tags)] });
+        this.emit('sessionUpdated', { key, tags });
+    }
+    // ========== Status Management ==========
+    async archiveSession(key) {
+        await this.store.archive(key);
+        this.emit('sessionArchived', { key });
+    }
+    async unarchiveSession(key) {
+        await this.store.unarchive(key);
+        this.emit('sessionRestored', { key });
+    }
+    async pinSession(key) {
+        await this.store.pin(key);
+        this.emit('sessionPinned', { key });
+    }
+    async unpinSession(key) {
+        await this.store.unpin(key);
+        this.emit('sessionUnpinned', { key });
+    }
+    async setSessionStatus(key, status) {
+        await this.store.setStatus(key, status);
+        this.emit('sessionStatusChanged', { key, status });
+    }
+    // ========== Search ==========
+    async searchSessions(query) {
+        const result = await this.store.list({ search: query, limit: 100 });
+        return result.items;
+    }
+    async searchInSession(key, keyword) {
+        return this.store.searchInSession(key, keyword);
+    }
+    // ========== Export/Import ==========
+    async exportSession(key, format) {
+        return this.store.exportSession(key, format);
+    }
+    // ========== Statistics ==========
+    async getStats() {
+        return this.store.getStats();
+    }
+    // ========== Maintenance ==========
+    async archiveOldSessions(olderThanDays) {
+        const count = await this.store.archiveOld(olderThanDays);
+        log.info({ count, olderThanDays }, 'Archived old sessions');
+        return count;
+    }
+    async migrateFromLegacy() {
+        return this.store.migrateFromLegacy();
+    }
+    // ========== Event Helpers ==========
+    onSessionCreated(callback) {
+        this.on('sessionCreated', callback);
+    }
+    onSessionUpdated(callback) {
+        this.on('sessionUpdated', callback);
+    }
+    onSessionDeleted(callback) {
+        this.on('sessionDeleted', callback);
+    }
+    onSessionArchived(callback) {
+        this.on('sessionArchived', callback);
+    }
+    onSessionRestored(callback) {
+        this.on('sessionRestored', callback);
+    }
+    onSessionPinned(callback) {
+        this.on('sessionPinned', callback);
+    }
+    onSessionUnpinned(callback) {
+        this.on('sessionUnpinned', callback);
+    }
+    onSessionStatusChanged(callback) {
+        this.on('sessionStatusChanged', callback);
+    }
+    onSessionAccessed(callback) {
+        this.on('sessionAccessed', callback);
+    }
+    // ========== Legacy Compatibility (MemoryStore API) ==========
+    /** Load messages (MemoryStore API) */
+    async loadMessages(key) {
+        return this.store.loadMessages(key);
+    }
+    /** Save messages (MemoryStore API) */
+    async saveMessages(key, messages) {
+        return this.store.saveMessages(key, messages);
+    }
+    /** Delete session (MemoryStore API) */
+    async delete(key) {
+        await this.store.delete(key);
+    }
+    /** Get window stats (MemoryStore API) */
+    getWindowStats(messages) {
+        return this.store.getWindowStats(messages);
+    }
+    /** Prepare compaction (MemoryStore API) */
+    prepareCompaction(key, messages, contextWindow) {
+        return this.store.prepareCompaction(key, messages, contextWindow);
+    }
+    /** Compact session (MemoryStore API) */
+    compact(key, messages, contextWindow, instructions) {
+        return this.store.compact(key, messages, contextWindow, instructions);
+    }
+    /** Get compaction stats (MemoryStore API) */
+    async getCompactionStats(key) {
+        return this.store.getCompactionStats(key);
+    }
+    /** Estimate token usage (MemoryStore API) */
+    async estimateTokenUsage(key, messages) {
+        return this.store.estimateTokens(messages);
+    }
+}
+//# sourceMappingURL=manager.js.map