@specpow/framework 0.5.28 → 0.5.30

package/dist/core/memory/adapters/index.js

@@ -0,0 +1,184 @@
+/**
+ * 适配器注册表
+ *
+ * 统一管理所有会话适配器，提供数据源检测、会话索引等功能
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { ClaudeCodeAdapter } from './claude-code-adapter.js';
+import { CodeBuddyAdapter } from './codebuddy-adapter.js';
+/**
+ * 适配器注册表实现
+ */
+export class AdapterRegistryImpl {
+    adapters = new Map();
+    memoryManager = null;
+    projectRoot;
+    indexedSessionsPath;
+    constructor(projectRoot, memoryManager) {
+        this.projectRoot = projectRoot;
+        this.memoryManager = memoryManager || null;
+        this.indexedSessionsPath = join(projectRoot, '.specpow', 'memory', 'indexed-sessions.json');
+    }
+    /**
+     * 注册适配器
+     */
+    register(adapter) {
+        this.adapters.set(adapter.name, adapter);
+    }
+    /**
+     * 检测所有数据源
+     */
+    async detectSources() {
+        const results = [];
+        for (const [name, adapter] of this.adapters.entries()) {
+            try {
+                const detected = await adapter.detect();
+                if (detected) {
+                    const projects = await adapter.listProjects();
+                    let sessionCount = 0;
+                    for (const project of projects) {
+                        const sessions = await adapter.listSessions(project);
+                        sessionCount += sessions.length;
+                    }
+                    results.push({
+                        name,
+                        detected: true,
+                        sessionCount,
+                    });
+                }
+                else {
+                    results.push({
+                        name,
+                        detected: false,
+                    });
+                }
+            }
+            catch (error) {
+                results.push({
+                    name,
+                    detected: false,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * 获取指定适配器
+     */
+    getAdapter(name) {
+        return this.adapters.get(name);
+    }
+    /**
+     * 索引所有数据源
+     */
+    async indexAll(options) {
+        const result = {
+            indexed: 0,
+            skipped: 0,
+            errors: [],
+        };
+        // 加载已索引记录
+        const indexedSessions = this.loadIndexedSessions();
+        // 遍历所有适配器
+        for (const [name, adapter] of this.adapters.entries()) {
+            // 检查是否指定了数据源
+            if (options?.sources && !options.sources.includes(name)) {
+                continue;
+            }
+            try {
+                const detected = await adapter.detect();
+                if (!detected) {
+                    continue;
+                }
+                const projects = await adapter.listProjects();
+                for (const project of projects) {
+                    const sessions = await adapter.listSessions(project);
+                    for (const session of sessions) {
+                        const key = `${name}:${project}:${session.id}`;
+                        // 检查是否已索引
+                        if (!options?.force && indexedSessions.sessions[key]) {
+                            result.skipped++;
+                            continue;
+                        }
+                        try {
+                            // 加载会话
+                            const sessionLog = await adapter.loadSession(project, session.id);
+                            // 索引会话
+                            if (this.memoryManager) {
+                                await this.memoryManager.indexSession(sessionLog);
+                            }
+                            // 标记为已索引
+                            indexedSessions.sessions[key] = true;
+                            result.indexed++;
+                        }
+                        catch (error) {
+                            const errorMsg = `Failed to index session ${session.id}: ${error}`;
+                            result.errors.push(errorMsg);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                const errorMsg = `Failed to process adapter ${name}: ${error}`;
+                result.errors.push(errorMsg);
+            }
+        }
+        // 保存已索引记录
+        this.saveIndexedSessions(indexedSessions);
+        return result;
+    }
+    /**
+     * 设置 Memory 管理器
+     */
+    setMemoryManager(manager) {
+        this.memoryManager = manager;
+    }
+    /**
+     * 清除索引缓存
+     */
+    clearIndexCache() {
+        const empty = { sessions: {} };
+        this.saveIndexedSessions(empty);
+    }
+    /**
+     * 加载已索引记录
+     */
+    loadIndexedSessions() {
+        if (!existsSync(this.indexedSessionsPath)) {
+            return { sessions: {} };
+        }
+        try {
+            const content = readFileSync(this.indexedSessionsPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { sessions: {} };
+        }
+    }
+    /**
+     * 保存已索引记录
+     */
+    saveIndexedSessions(sessions) {
+        const dir = join(this.projectRoot, '.specpow', 'memory');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.indexedSessionsPath, JSON.stringify(sessions, null, 2), 'utf-8');
+    }
+}
+/**
+ * 创建适配器注册表
+ * 自动注册 Claude Code 和 CodeBuddy 适配器
+ */
+export function createAdapterRegistry(projectRoot, memoryManager) {
+    const registry = new AdapterRegistryImpl(projectRoot, memoryManager);
+    // 注册默认适配器
+    registry.register(new ClaudeCodeAdapter());
+    registry.register(new CodeBuddyAdapter());
+    return registry;
+}
+// 导出适配器
+export { ClaudeCodeAdapter } from './claude-code-adapter.js';
+export { CodeBuddyAdapter } from './codebuddy-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/memory/adapters/index.js.map

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

package/dist/core/memory/memory-injector.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 记忆注入器
+ *
+ * 将记忆条目格式化为可注入到 AI 上下文的文本
+ * 支持 token 预算控制
+ */
+import type { MemoryEntry, MemoryManager, WorkflowStage } from './memory-types.js';
+/**
+ * 注入配置
+ */
+export interface InjectionConfig {
+    /** 最大条目数 */
+    maxEntries: number;
+    /** 最小相关性 */
+    minRelevance: number;
+    /** Token 预算 */
+    tokenBudget: number;
+    /** 是否查询所有阶段（默认只查前一阶段） */
+    allPhases?: boolean;
+    /** 自定义关键词（优先级高于自动提取） */
+    customKeywords?: string[];
+}
+/**
+ * 查询上下文（用于增强关键词提取）
+ */
+export interface QueryContext {
+    /** 变更名称 */
+    changeName?: string;
+    /** 用户输入 */
+    userInput?: string;
+    /** 任务描述 */
+    taskDescription?: string;
+    /** 涉及文件 */
+    files?: string[];
+}
+/**
+ * 记忆注入器
+ */
+export declare class MemoryInjector {
+    private memoryManager;
+    constructor(memoryManager: MemoryManager);
+    /**
+     * 格式化用于 explore 阶段注入
+     */
+    formatForExplore(entries: MemoryEntry[], budget?: number): string;
+    /**
+     * 格式化用于 propose 阶段注入
+     */
+    formatForPropose(entries: MemoryEntry[], budget?: number): string;
+    /**
+     * 格式化用于 Brief 文件注入
+     */
+    formatForBrief(entries: MemoryEntry[], budget?: number): string;
+    /**
+     * 格式化用于 verify 阶段注入
+     */
+    formatForVerify(entries: MemoryEntry[], budget?: number): string;
+    /**
+     * 查询并格式化指定阶段的记忆
+     * @param changeName 变更名称（向后兼容）
+     * @param phase 工作流阶段
+     * @param config 注入配置
+     * @param context 查询上下文（可选，用于增强关键词提取）
+     */
+    queryForPhase(changeName: string, phase: WorkflowStage, config?: Partial<InjectionConfig>, context?: QueryContext): Promise<string>;
+    /**
+     * 方案 A: 从上下文综合提取关键词
+     */
+    extractKeywordsFromContext(context: QueryContext): string[];
+    /**
+     * 估算 token 数
+     * 简单估算：中文字符数 + 英文单词数/4
+     */
+    estimateTokens(text: string): number;
+    /**
+     * 格式化记忆条目
+     */
+    private formatEntries;
+    /**
+     * 提取关键词（增强版）
+     * 支持 kebab-case、camelCase、中文等多种格式
+     */
+    private extractKeywords;
+    /**
+     * 获取要查询的阶段
+     */
+    private getQueryPhases;
+    /**
+     * 获取阶段标签
+     */
+    private getPhaseLabel;
+    /**
+     * 获取章节标题
+     */
+    private getSectionTitle;
+}
+/**
+ * 创建记忆注入器
+ */
+export declare function createMemoryInjector(memoryManager: MemoryManager): MemoryInjector;
+//# sourceMappingURL=memory-injector.d.ts.map

package/dist/core/memory/memory-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-injector.d.ts","sourceRoot":"","sources":["../../../src/core/memory/memory-injector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAqB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,aAAa,CAAgB;gBAEzB,aAAa,EAAE,aAAa;IAIxC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,MAAoC,GAAG,MAAM;IAI9F;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,MAAoC,GAAG,MAAM;IAI9F;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,MAAkC,GAAG,MAAM;IAI1F;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,MAAmC,GAAG,MAAM;IAI5F;;;;;;OAMG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IAqClB;;OAEG;IACH,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE;IA6C3D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAuBpC;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAmCvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAWxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,cAAc,CAEjF"}

package/dist/core/memory/memory-injector.js

@@ -0,0 +1,269 @@
+/**
+ * 记忆注入器
+ *
+ * 将记忆条目格式化为可注入到 AI 上下文的文本
+ * 支持 token 预算控制
+ */
+/**
+ * 默认注入配置
+ */
+const DEFAULT_CONFIG = {
+    maxEntries: 3,
+    minRelevance: 0.3,
+    tokenBudget: 300,
+    allPhases: false,
+};
+/**
+ * 各阶段默认 token 预算
+ */
+const PHASE_TOKEN_BUDGETS = {
+    explore: 300,
+    propose: 500,
+    apply: 400,
+    verify: 200,
+    archive: 100,
+    idle: 200,
+};
+/**
+ * 记忆注入器
+ */
+export class MemoryInjector {
+    memoryManager;
+    constructor(memoryManager) {
+        this.memoryManager = memoryManager;
+    }
+    /**
+     * 格式化用于 explore 阶段注入
+     */
+    formatForExplore(entries, budget = PHASE_TOKEN_BUDGETS.explore) {
+        return this.formatEntries(entries, budget, '历史探索记忆');
+    }
+    /**
+     * 格式化用于 propose 阶段注入
+     */
+    formatForPropose(entries, budget = PHASE_TOKEN_BUDGETS.propose) {
+        return this.formatEntries(entries, budget, '历史决策参考');
+    }
+    /**
+     * 格式化用于 Brief 文件注入
+     */
+    formatForBrief(entries, budget = PHASE_TOKEN_BUDGETS.apply) {
+        return this.formatEntries(entries, budget, '历史上下文');
+    }
+    /**
+     * 格式化用于 verify 阶段注入
+     */
+    formatForVerify(entries, budget = PHASE_TOKEN_BUDGETS.verify) {
+        return this.formatEntries(entries, budget, '历史审查经验');
+    }
+    /**
+     * 查询并格式化指定阶段的记忆
+     * @param changeName 变更名称（向后兼容）
+     * @param phase 工作流阶段
+     * @param config 注入配置
+     * @param context 查询上下文（可选，用于增强关键词提取）
+     */
+    async queryForPhase(changeName, phase, config, context) {
+        const cfg = { ...DEFAULT_CONFIG, ...config };
+        const budget = PHASE_TOKEN_BUDGETS[phase] || cfg.tokenBudget;
+        // 方案 A: 增强关键词提取
+        let keywords;
+        if (cfg.customKeywords && cfg.customKeywords.length > 0) {
+            // 方案 C: 用户自定义关键词优先
+            keywords = cfg.customKeywords;
+        }
+        else if (context) {
+            // 从上下文综合提取
+            keywords = this.extractKeywordsFromContext(context);
+        }
+        else {
+            // 向后兼容：只从变更名称提取
+            keywords = this.extractKeywords(changeName);
+        }
+        // 方案 B: 扩大阶段范围
+        const queryPhases = cfg.allPhases
+            ? ['explore', 'propose', 'apply', 'verify', 'archive', 'idle']
+            : this.getQueryPhases(phase);
+        // 构建查询
+        const query = {
+            keywords: keywords.length > 0 ? keywords : undefined,
+            phases: queryPhases,
+            limit: cfg.maxEntries,
+            minRelevance: cfg.minRelevance,
+        };
+        // 执行查询
+        const result = await this.memoryManager.search(query);
+        // 格式化结果
+        return this.formatEntries(result.entries, budget, this.getSectionTitle(phase));
+    }
+    /**
+     * 方案 A: 从上下文综合提取关键词
+     */
+    extractKeywordsFromContext(context) {
+        const allWords = [];
+        // 从变更名称提取
+        if (context.changeName) {
+            allWords.push(...this.extractKeywords(context.changeName));
+        }
+        // 从用户输入提取
+        if (context.userInput) {
+            allWords.push(...this.extractKeywords(context.userInput));
+        }
+        // 从任务描述提取
+        if (context.taskDescription) {
+            allWords.push(...this.extractKeywords(context.taskDescription));
+        }
+        // 从文件路径提取（提取文件名和目录名）
+        if (context.files && context.files.length > 0) {
+            for (const file of context.files) {
+                // 提取文件名（不含扩展名）
+                const fileName = file.split('/').pop()?.split('.').shift() || '';
+                allWords.push(...this.extractKeywords(fileName));
+                // 提取目录名
+                const dirName = file.split('/').slice(-2, -1)[0] || '';
+                if (dirName && dirName !== 'src' && dirName !== 'lib') {
+                    allWords.push(...this.extractKeywords(dirName));
+                }
+            }
+        }
+        // 去重并按词频排序
+        const freq = new Map();
+        for (const word of allWords) {
+            freq.set(word, (freq.get(word) || 0) + 1);
+        }
+        return Array.from(freq.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([word]) => word)
+            .slice(0, 10); // 返回前 10 个关键词
+    }
+    /**
+     * 估算 token 数
+     * 简单估算：中文字符数 + 英文单词数/4
+     */
+    estimateTokens(text) {
+        let tokens = 0;
+        // 统计中文字符
+        const chineseChars = text.match(/[\u4e00-\u9fa3]/g);
+        if (chineseChars) {
+            tokens += chineseChars.length;
+        }
+        // 统计英文单词（去除中文后按空格分割）
+        const englishText = text.replace(/[\u4e00-\u9fa3]/g, ' ');
+        const englishWords = englishText.split(/\s+/).filter(w => w.length > 0);
+        tokens += Math.ceil(englishWords.length / 4);
+        // 加上标点符号
+        const punctuation = text.match(/[，。！？、；：""''（）【】]/g);
+        if (punctuation) {
+            tokens += punctuation.length;
+        }
+        return tokens;
+    }
+    /**
+     * 格式化记忆条目
+     */
+    formatEntries(entries, budget, sectionTitle) {
+        if (entries.length === 0) {
+            return `## ${sectionTitle}\n\n（无相关历史记忆）`;
+        }
+        const lines = [];
+        let currentTokens = this.estimateTokens(`## ${sectionTitle}`);
+        for (const entry of entries) {
+            const phaseLabel = this.getPhaseLabel(entry.phase);
+            const line = `- [${phaseLabel}] ${entry.content}`;
+            const lineTokens = this.estimateTokens(line);
+            if (currentTokens + lineTokens > budget) {
+                break;
+            }
+            lines.push(line);
+            currentTokens += lineTokens;
+        }
+        if (lines.length === 0) {
+            return `## ${sectionTitle}\n\n（无相关历史记忆）`;
+        }
+        return `## ${sectionTitle}\n\n${lines.join('\n')}`;
+    }
+    /**
+     * 提取关键词（增强版）
+     * 支持 kebab-case、camelCase、中文等多种格式
+     */
+    extractKeywords(text) {
+        // 预处理：将 kebab-case 和 camelCase 转换为空格分隔
+        let normalized = text
+            // kebab-case: memory-auto-adapter -> memory auto adapter
+            .replace(/-/g, ' ')
+            // camelCase: memoryAutoAdapter -> memory Auto Adapter
+            .replace(/([a-z])([A-Z])/g, '$1 $2')
+            // snake_case: memory_auto_adapter -> memory auto adapter
+            .replace(/_/g, ' ');
+        // 转为小写并分割
+        const words = normalized
+            .toLowerCase()
+            .replace(/[^\w\u4e00-\u9fa3\s]/g, ' ')
+            .split(/\s+/)
+            .filter(w => {
+            // 过滤短词和停用词
+            if (w.length <= 1)
+                return false;
+            const stopWords = new Set([
+                '的', '了', '在', '是', '我', '有', '就', '不', '也', '很', '到', '说', '要', '去',
+                'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+                'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+                'should', 'may', 'might', 'can', 'shall', 'must', 'need', 'dare',
+                'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as',
+                'into', 'through', 'during', 'before', 'after', 'above', 'below',
+                'and', 'but', 'or', 'nor', 'not', 'so', 'yet', 'both', 'either',
+                'this', 'that', 'these', 'those', 'it', 'its', 'he', 'she', 'they',
+            ]);
+            return !stopWords.has(w);
+        });
+        // 去重并返回前 10 个
+        return Array.from(new Set(words)).slice(0, 10);
+    }
+    /**
+     * 获取要查询的阶段
+     */
+    getQueryPhases(currentPhase) {
+        // 查询前一阶段的记忆
+        const phaseOrder = ['explore', 'propose', 'apply', 'verify', 'archive'];
+        const currentIndex = phaseOrder.indexOf(currentPhase);
+        if (currentIndex <= 0) {
+            return [currentPhase];
+        }
+        return [phaseOrder[currentIndex - 1], currentPhase];
+    }
+    /**
+     * 获取阶段标签
+     */
+    getPhaseLabel(phase) {
+        const labels = {
+            explore: '探索',
+            propose: '提案',
+            apply: '实现',
+            verify: '验证',
+            archive: '归档',
+            idle: '通用',
+        };
+        return labels[phase] || phase;
+    }
+    /**
+     * 获取章节标题
+     */
+    getSectionTitle(phase) {
+        const titles = {
+            explore: '历史探索记忆',
+            propose: '历史决策参考',
+            apply: '历史上下文',
+            verify: '历史审查经验',
+            archive: '历史归档记忆',
+            idle: '相关记忆',
+        };
+        return titles[phase] || '相关记忆';
+    }
+}
+/**
+ * 创建记忆注入器
+ */
+export function createMemoryInjector(memoryManager) {
+    return new MemoryInjector(memoryManager);
+}
+//# sourceMappingURL=memory-injector.js.map

package/dist/core/memory/memory-injector.js.map

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

package/dist/core/memory/memory-types.d.ts

@@ -151,4 +151,83 @@ export interface MemoryStats {
     /** 索引大小（字节） */
     indexSize: number;
 }
+/**
+ * 会话元数据
+ */
+export interface SessionMeta {
+    /** 会话 ID */
+    id: string;
+    /** 会话名称 */
+    name?: string;
+    /** 创建时间 */
+    createdAt: number;
+    /** 最后消息时间 */
+    lastMessageAt?: number;
+    /** 消息数量 */
+    messageCount?: number;
+}
+/**
+ * 会话适配器接口
+ * 用于从不同宿主工具（Claude Code、CodeBuddy 等）读取会话日志
+ */
+export interface SessionAdapter {
+    /** 适配器名称 */
+    name: string;
+    /** 检测当前环境是否支持此适配器 */
+    detect(): Promise<boolean>;
+    /** 列出所有项目 */
+    listProjects(): Promise<string[]>;
+    /** 列出指定项目的所有会话 */
+    listSessions(project: string): Promise<SessionMeta[]>;
+    /** 加载指定会话并转换为标准格式 */
+    loadSession(project: string, sessionId: string): Promise<SessionLog>;
+}
+/**
+ * 数据源检测结果
+ */
+export interface SourceDetection {
+    /** 数据源名称 */
+    name: string;
+    /** 是否检测到 */
+    detected: boolean;
+    /** 数据目录路径 */
+    baseDir?: string;
+    /** 当前项目标识 */
+    currentProject?: string;
+    /** 会话数量 */
+    sessionCount?: number;
+}
+/**
+ * 索引选项
+ */
+export interface IndexOptions {
+    /** 强制重新索引 */
+    force?: boolean;
+    /** 指定数据源 */
+    sources?: string[];
+}
+/**
+ * 索引结果
+ */
+export interface IndexResult {
+    /** 已索引数量 */
+    indexed: number;
+    /** 跳过数量 */
+    skipped: number;
+    /** 错误列表 */
+    errors: string[];
+}
+/**
+ * 适配器注册表接口
+ */
+export interface AdapterRegistry {
+    /** 注册适配器 */
+    register(adapter: SessionAdapter): void;
+    /** 检测所有数据源 */
+    detectSources(): Promise<SourceDetection[]>;
+    /** 获取指定适配器 */
+    getAdapter(name: string): SessionAdapter | undefined;
+    /** 索引所有数据源 */
+    indexAll(options?: IndexOptions): Promise<IndexResult>;
+}
 //# sourceMappingURL=memory-types.d.ts.map