hyacinth-ai 0.9.6

package/dist/context/index.d.ts

@@ -0,0 +1,14 @@
+export { type ComposeOptions, type ContextComposer } from './interface.js';
+export type { ContextSourceStrategy, ContextSourceCacheability, ContextSource, } from './interface.js';
+export type { LayeredComposeOptions, ZoneBreakdown, CacheMarker, LayeredContext, } from './interface.js';
+export { LayeredContextComposer } from './composer.js';
+export type { LayeredComposeOptions as LayeredComposeOptionsDirect, ZoneBreakdown as ZoneBreakdownDirect, LayeredContext as LayeredContextDirect, } from './composer.js';
+export type { CacheMarker as CacheMarkerDirect } from './cache-strategy.js';
+export { getCacheStrategy, registerStrategy, } from './cache-strategy.js';
+export type { CacheStrategy, CacheMode, ZoneInfo, ComputeMarkersInput, } from './cache-strategy.js';
+export { ToolOutputTrimmer, StructuredSummarizer, CompressorOrchestrator, STRUCTURED_SUMMARY_TEMPLATE, } from './compressor.js';
+export type { CompressionResult, CompressionStats } from './compressor.js';
+export { type SystemPromptSection, SystemPromptBuilder, loadProjectContext, } from './prompt-builder.js';
+export { Retriever } from './retriever.js';
+export type { RetrieveOptions, RetrieveResult } from './retriever.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.js

@@ -0,0 +1,8 @@
+export { LayeredContextComposer } from './composer.js';
+export { getCacheStrategy, registerStrategy, } from './cache-strategy.js';
+export { ToolOutputTrimmer, StructuredSummarizer, CompressorOrchestrator, STRUCTURED_SUMMARY_TEMPLATE, } from './compressor.js';
+export { SystemPromptBuilder, loadProjectContext, } from './prompt-builder.js';
+export { Retriever } from './retriever.js';
+// ScheduleMode is already exported above via ./interface.js (re-exported from ./composer.js)
+// modes.ts defines an identical ScheduleMode type; we export it only once to avoid duplicates.
+//# sourceMappingURL=index.js.map

package/dist/context/interface.d.ts

@@ -0,0 +1,33 @@
+import type { Message, ToolDefinition } from '../types.js';
+export interface ComposeOptions {
+    systemPrompt: string;
+    tools: ToolDefinition[];
+    history: Message[];
+    userInput: string;
+    maxContextTokens: number;
+    /** conversation.jsonl 全量历史，用于 Zone 4 池检索 */
+    fullHistory?: Message[];
+}
+export interface ContextComposer {
+    compose(options: ComposeOptions): Message[] | Promise<Message[]>;
+}
+export type { LayeredComposeOptions, ZoneBreakdown, LayeredContext, } from './composer.js';
+export type { CacheMarker } from './cache-strategy.js';
+/** Strategy for loading a context source */
+export type ContextSourceStrategy = 'always_inline' | 'index_only' | 'lazy_expand' | 'phase_bound';
+/** Cacheability zone for a context source */
+export type ContextSourceCacheability = 'anchor' | 'manifest' | 'summarized' | 'live';
+/** A registered context source with loading strategy */
+export interface ContextSource {
+    /** Unique name for this source */
+    name: string;
+    /** Loading strategy */
+    strategy: ContextSourceStrategy;
+    /** Which cache zone this source belongs to */
+    cacheability: ContextSourceCacheability;
+    /** Short description for index display (used by index_only strategy) */
+    description?: string;
+    /** Callback to get the full content (used by always_inline and lazy_expand) */
+    getContent: () => string | Promise<string>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/context/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/context/manifest-defaults.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 默认上下文清单（Context Manifest）。
+ *
+ * 可通过 `.agent/context-manifest.json` 覆盖。
+ *
+ * ── 加载链 ──────────────────────────────────────────────
+ * ManifestLoader (src/context/manifest-loader.ts)
+ *   → {cwd}/.agent/context-manifest.json    ← 项目级覆盖（优先）
+ *   → manifest-defaults.ts                  ← 本文件（兜底默认）
+ *
+ * 修改上下文布局时：
+ *   1. 改本文件的 section 定义 → 影响所有未覆盖的项目
+ *   2. 改 .agent/context-manifest.json → 仅影响当前项目
+ *   3. 新增 prompt 文件 → 放在 src/prompts/ 下，由 loadPrompt() 加载
+ *      （加载优先级：.agent/prompts/ > ~/.agent/prompts/ > dist/prompts/）
+ *
+ * ── Section 类型说明 ─────────────────────────────────────
+ *   static     — 直接加载 prompt 文件，每次 compose 注入
+ *   runtime    — 由 section-resolver.ts 的 resolveRuntime() 动态生成
+ *   retrieval  — 检索型（如知识库、项目上下文），按需拉取
+ *   conditional — 满足 condition 时才注入（如 precise_mode）
+ *   template   — 含 {{变量}}，由 resolveTemplate() 渲染
+ *
+ * ── 各 Section 的注册位置索引 ───────────────────────────
+ *   persona_soul  → src/prompts/persona/ (SOUL.md, IDENTITY.md, USER.md)
+ *   tool_rules    → src/prompts/tools/tool-rules.md
+ *   tool_bundles  → src/gateway/factory.ts (ContextSource 注册)
+ *                  + src/tools/bundle-registry.ts (ToolBundleRegistry)
+ *   skills        → ContextSource 'skill-*' (index_only, factory.ts 注册)
+ *   agents        → ContextSource 'agent-*' (index_only, factory.ts 注册)
+ *   mcp           → ContextSource 'mcp-*' (index_only, factory.ts 注册)
+ *   memory        → ContextSource 'memory' (factory.ts 注册)
+ *                  + src/memory/store.ts (MemoryStore)
+ *   timestamp     → section-resolver.ts resolveRuntime('runtime:timestamp')
+ *   user_input    → section-resolver.ts resolveRuntime('runtime:userInput')
+ *
+ * Zone 布局规范：
+ *   Zone 1 (Anchor)   — 身份 / 人设 / 环境 / 框架能力 / 工具规则 / 注册表 / 记忆 / 注意
+ *                        装入稳定、极少变动的内容，享受前缀缓存。
+ *   Zone 2 (Manifest) — 辅助索引区，默认关闭
+ *                        供需要独立缓存断点的 Provider 使用。
+ *   Zone 3 (History)  — 压缩摘要 / 项目上下文 / 对话历史
+ *                        内容随对话增长，由压缩器管理边界。
+ *   Zone 4 (Context)  — 知识库检索结果（可独立开关）
+ *                        外部知识注入区，用户可在 config 中关闭以节省 tokens。
+ *   Zone 5 (Live)     — 工作流注入 / 时间戳 / 用户输入 / 会话临时工具
+ *                        每轮都会变化的内容，不适合缓存。
+ */
+import type { ContextManifest } from './manifest-types.js';
+export declare const DEFAULT_CONTEXT_MANIFEST: ContextManifest;
+//# sourceMappingURL=manifest-defaults.d.ts.map

package/dist/context/manifest-defaults.js

@@ -0,0 +1,133 @@
+/**
+ * 默认上下文清单（Context Manifest）。
+ *
+ * 可通过 `.agent/context-manifest.json` 覆盖。
+ *
+ * ── 加载链 ──────────────────────────────────────────────
+ * ManifestLoader (src/context/manifest-loader.ts)
+ *   → {cwd}/.agent/context-manifest.json    ← 项目级覆盖（优先）
+ *   → manifest-defaults.ts                  ← 本文件（兜底默认）
+ *
+ * 修改上下文布局时：
+ *   1. 改本文件的 section 定义 → 影响所有未覆盖的项目
+ *   2. 改 .agent/context-manifest.json → 仅影响当前项目
+ *   3. 新增 prompt 文件 → 放在 src/prompts/ 下，由 loadPrompt() 加载
+ *      （加载优先级：.agent/prompts/ > ~/.agent/prompts/ > dist/prompts/）
+ *
+ * ── Section 类型说明 ─────────────────────────────────────
+ *   static     — 直接加载 prompt 文件，每次 compose 注入
+ *   runtime    — 由 section-resolver.ts 的 resolveRuntime() 动态生成
+ *   retrieval  — 检索型（如知识库、项目上下文），按需拉取
+ *   conditional — 满足 condition 时才注入（如 precise_mode）
+ *   template   — 含 {{变量}}，由 resolveTemplate() 渲染
+ *
+ * ── 各 Section 的注册位置索引 ───────────────────────────
+ *   persona_soul  → src/prompts/persona/ (SOUL.md, IDENTITY.md, USER.md)
+ *   tool_rules    → src/prompts/tools/tool-rules.md
+ *   tool_bundles  → src/gateway/factory.ts (ContextSource 注册)
+ *                  + src/tools/bundle-registry.ts (ToolBundleRegistry)
+ *   skills        → ContextSource 'skill-*' (index_only, factory.ts 注册)
+ *   agents        → ContextSource 'agent-*' (index_only, factory.ts 注册)
+ *   mcp           → ContextSource 'mcp-*' (index_only, factory.ts 注册)
+ *   memory        → ContextSource 'memory' (factory.ts 注册)
+ *                  + src/memory/store.ts (MemoryStore)
+ *   timestamp     → section-resolver.ts resolveRuntime('runtime:timestamp')
+ *   user_input    → section-resolver.ts resolveRuntime('runtime:userInput')
+ *
+ * Zone 布局规范：
+ *   Zone 1 (Anchor)   — 身份 / 人设 / 环境 / 框架能力 / 工具规则 / 注册表 / 记忆 / 注意
+ *                        装入稳定、极少变动的内容，享受前缀缓存。
+ *   Zone 2 (Manifest) — 辅助索引区，默认关闭
+ *                        供需要独立缓存断点的 Provider 使用。
+ *   Zone 3 (History)  — 压缩摘要 / 项目上下文 / 对话历史
+ *                        内容随对话增长，由压缩器管理边界。
+ *   Zone 4 (Context)  — 知识库检索结果（可独立开关）
+ *                        外部知识注入区，用户可在 config 中关闭以节省 tokens。
+ *   Zone 5 (Live)     — 工作流注入 / 时间戳 / 用户输入 / 会话临时工具
+ *                        每轮都会变化的内容，不适合缓存。
+ */
+export const DEFAULT_CONTEXT_MANIFEST = {
+    version: 1,
+    zones: {
+        // ── Zone 1: Anchor ──────────────────────────────────────────────
+        // 身份/人设、环境、框架能力、工具规则、Skill/Agent/MCP 注册表、记忆
+        // 最稳定的内容层，享受前缀缓存。变更需重启或热重载触发重算。
+        zone1: {
+            name: 'Anchor',
+            order: 1,
+            enabled: true,
+            role: 'system',
+            sections: [
+                // ── 核心身份 ──
+                { name: 'persona_precise', source: 'prompts/precise/persona', priority: 0, type: 'conditional', condition: 'precise_mode', description: '精确模式约束（替代 persona）' },
+                { name: 'persona_soul', source: 'prompts/persona', priority: 1, type: 'static', description: '用户 persona（SOUL/IDENTITY/USER）' },
+                // { name: 'environment',             source: 'runtime:env',                   priority: 10, type: 'runtime',    description: '运行环境信息 → 已迁移为 system_info / channel_info 工具' },
+                // framework_capabilities 已移除（2026-07-10）：工具描述已通过 API tools 字段提供，
+                // TUI 斜杠命令（/session、/channel 等）不应进入 LLM 上下文，避免引发模型幻觉。
+                // { name: 'framework_capabilities',  source: 'prompts/framework-capabilities', priority: 15, type: 'static' },
+                // ── 工具 / Skill / Agent / MCP 注册表 ──
+                // tool-rules.md → 模型工具使用规范。内容在 src/prompts/tools/tool-rules.md
+                { name: 'tool_rules', source: 'prompts/tool-rules', priority: 20, type: 'static', description: '工具使用规则' },
+                // tool_bundles → ContextSource 注册在 src/gateway/factory.ts，数据源在 src/tools/bundle-registry.ts
+                { name: 'tool_bundles', source: 'runtime:tool_bundles', priority: 21, type: 'runtime', description: '工具包索引' },
+                { name: 'skills', source: 'runtime:skills', priority: 22, type: 'runtime', description: 'Skill 注册表内容' },
+                { name: 'agents', source: 'runtime:agents', priority: 23, type: 'runtime', description: '子 Agent 注册表内容' },
+                { name: 'mcp', source: 'runtime:mcp', priority: 24, type: 'runtime', description: 'MCP 工具注册表内容' },
+                { name: 'memory', source: 'runtime:memory', priority: 25, type: 'runtime', description: '跨会话项目记忆' },
+                // ── 尾部注意 ──
+                { name: 'attention', source: 'prompts/attention', priority: 30, type: 'static' },
+            ],
+        },
+        // ── Zone 2: Manifest ────────────────────────────────────────────
+        // 辅助索引区，默认关闭。供需要独立构建缓存断点的 Provider 使用。
+        zone2: {
+            name: 'Manifest',
+            order: 2,
+            enabled: false,
+            sections: [],
+        },
+        // ── Zone 3: History ─────────────────────────────────────────────
+        // 压缩摘要、项目上下文文件、对话历史消息。
+        // 唯一的持续增长区，由压缩器按阈值管理。
+        zone3: {
+            name: 'History',
+            order: 3,
+            enabled: true,
+            sections: [
+                { name: 'project_context', source: 'runtime:projectContext', priority: 0, type: 'retrieval', description: '项目上下文文件 (.agent.md / AGENTS.md / CLAUDE.md)' },
+                { name: 'history_summary', source: 'runtime:summary', priority: 1, type: 'runtime', description: '上下文压缩摘要' },
+                { name: 'history', source: 'runtime:history', priority: 3, type: 'runtime', description: '对话历史消息（含边界标记）' },
+            ],
+        },
+        // ── Zone 4: Context ─────────────────────────────────────────────
+        // 知识库检索结果（可独立开关）。
+        // 外部知识注入层，用户可通过 hotReload.watchContextManifest 或直接
+        // 编辑 .agent/context-manifest.json 关闭此 Zone 以节省 tokens。
+        zone4: {
+            name: 'Context',
+            order: 4,
+            enabled: true,
+            sections: [
+                { name: 'kb_context', source: 'runtime:kb_context', priority: 0, type: 'runtime', description: '知识库检索结果' },
+            ],
+        },
+        // ── Zone 5: Live ───────────────────────────────────────────────
+        // 每轮都可能变化的内容：工作流注入、时间戳、用户输入、会话临时工具等。
+        // 不适合前缀缓存，始终实时计算。
+        zone5: {
+            name: 'Live',
+            order: 5,
+            enabled: true,
+            sections: [
+                { name: 'flow_injection', source: 'runtime:flow', priority: 1, type: 'runtime', description: 'Flow 步骤注入（bootstrap/TODO/plan 等）' },
+                { name: 'channel_context', source: 'runtime:channel_context', priority: 2, type: 'runtime', description: '当前渠道和会话上下文' },
+                { name: 'session_mcp', source: 'runtime:mcp_live', priority: 3, type: 'runtime', description: '会话中热插拔的 MCP 工具索引' },
+                { name: 'session_tools', source: 'runtime:tools_live', priority: 4, type: 'runtime', description: '会话中热插拔的工具' },
+                { name: 'orchestrator_hint', source: 'runtime:orchestrator_hint', priority: 5, type: 'runtime', description: '旁路Agent注入（意图/约束/纠正）' },
+                { name: 'timestamp', source: 'runtime:timestamp', priority: 6, type: 'runtime', description: '当前时间戳' },
+                { name: 'user_input', source: 'runtime:userInput', priority: 7, type: 'runtime', description: '用户当前输入（每轮变化）' },
+            ],
+        },
+    },
+};
+//# sourceMappingURL=manifest-defaults.js.map

package/dist/context/manifest-loader.d.ts

@@ -0,0 +1,16 @@
+import type { ContextManifest, ZoneEntry, SectionEntry } from './manifest-types.js';
+export declare class ManifestLoader {
+    private manifest;
+    private cwd;
+    constructor(cwd: string);
+    private get manifestPath();
+    load(): ContextManifest;
+    reload(): ContextManifest;
+    getZone(name: string): ZoneEntry | undefined;
+    getEnabledZones(): Array<[string, ZoneEntry]>;
+    getSections(zoneName: string): SectionEntry[];
+    getManifest(): ContextManifest;
+    isZoneEnabled(zoneName: string): boolean;
+    private generateDefaults;
+}
+//# sourceMappingURL=manifest-loader.d.ts.map

package/dist/context/manifest-loader.js

@@ -0,0 +1,103 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DEFAULT_CONTEXT_MANIFEST } from './manifest-defaults.js';
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('manifest-loader');
+const MANIFEST_FILENAME = 'context-manifest.json';
+export class ManifestLoader {
+    manifest = null;
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    get manifestPath() {
+        return path.join(this.cwd, '.agent', MANIFEST_FILENAME);
+    }
+    load() {
+        if (this.manifest)
+            return this.manifest;
+        const filePath = this.manifestPath;
+        try {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== 'object') {
+                throw new Error('Invalid manifest: not a JSON object');
+            }
+            if (parsed.version !== 1) {
+                throw new Error(`Unsupported manifest version: ${parsed.version}. Expected: 1`);
+            }
+            if (!parsed.zones || typeof parsed.zones !== 'object') {
+                throw new Error('Invalid manifest: missing "zones" object');
+            }
+            for (const [zoneKey, zoneDef] of Object.entries(parsed.zones)) {
+                const zone = zoneDef;
+                if (typeof zone.enabled !== 'boolean') {
+                    throw new Error(`Invalid zone "${zoneKey}": missing "enabled" boolean`);
+                }
+                if (!Array.isArray(zone.sections)) {
+                    throw new Error(`Invalid zone "${zoneKey}": missing "sections" array`);
+                }
+                for (const section of zone.sections) {
+                    if (!section.name || !section.source || section.priority == null || !section.type) {
+                        throw new Error(`Invalid section in zone "${zoneKey}": missing required fields (name, source, priority, type)`);
+                    }
+                }
+            }
+            this.manifest = parsed;
+            logger.info('context-manifest.json loaded');
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT') {
+                this.manifest = this.generateDefaults();
+            }
+            else if (err instanceof SyntaxError) {
+                logger.warn('context-manifest.json parse error, generating defaults', { error: err.message });
+                this.manifest = this.generateDefaults();
+            }
+            else {
+                throw err;
+            }
+        }
+        return this.manifest;
+    }
+    reload() {
+        this.manifest = null;
+        return this.load();
+    }
+    getZone(name) {
+        const m = this.load();
+        return m.zones[name];
+    }
+    getEnabledZones() {
+        const m = this.load();
+        return Object.entries(m.zones)
+            .filter(([, zone]) => zone.enabled)
+            .sort(([, a], [, b]) => a.order - b.order);
+    }
+    getSections(zoneName) {
+        const zone = this.getZone(zoneName);
+        if (!zone)
+            return [];
+        return [...zone.sections].sort((a, b) => a.priority - b.priority);
+    }
+    getManifest() {
+        return this.load();
+    }
+    isZoneEnabled(zoneName) {
+        const zone = this.getZone(zoneName);
+        return zone?.enabled ?? false;
+    }
+    generateDefaults() {
+        const m = JSON.parse(JSON.stringify(DEFAULT_CONTEXT_MANIFEST));
+        try {
+            fs.writeFileSync(this.manifestPath, JSON.stringify(m, null, 2) + '\n', 'utf-8');
+            logger.info('Generated default context-manifest.json');
+        }
+        catch (err) {
+            logger.warn('Failed to write default context-manifest.json', { error: err.message });
+        }
+        return m;
+    }
+}
+//# sourceMappingURL=manifest-loader.js.map

package/dist/context/manifest-types.d.ts

@@ -0,0 +1,26 @@
+export type SectionType = 'static' | 'template' | 'runtime' | 'retrieval' | 'conditional';
+export type ContextSourceStrategy = 'always_inline' | 'index_only' | 'lazy_expand' | 'phase_bound';
+export type ConditionName = 'precise_mode';
+export interface SectionEntry {
+    name: string;
+    source: string;
+    priority: number;
+    type: SectionType;
+    templateVars?: string[];
+    strategy?: ContextSourceStrategy;
+    condition?: ConditionName;
+    description?: string;
+    role?: 'system' | 'user' | 'assistant';
+}
+export interface ZoneEntry {
+    name: string;
+    order: number;
+    enabled: boolean;
+    sections: SectionEntry[];
+    role?: 'system' | 'user' | 'assistant';
+}
+export interface ContextManifest {
+    version: number;
+    zones: Record<string, ZoneEntry>;
+}
+//# sourceMappingURL=manifest-types.d.ts.map

package/dist/context/manifest-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest-types.js.map

package/dist/context/precision/analyzer.d.ts

@@ -0,0 +1,31 @@
+import type { Provider } from '../../provider/interface.js';
+import type { Message } from '../../types.js';
+import type { KeywordEntry } from './types.js';
+export interface TurnSummary {
+    /** 这段对话做了什么（一句话） */
+    summary: string;
+    /** 本段对话特有的关键词 */
+    keywords: string[];
+    /** 对应的 turn 编号（合并后可能覆盖多个 turn） */
+    indices: number[];
+}
+export interface AnalysisResult {
+    keywords: KeywordEntry[];
+    turns: TurnSummary[];
+}
+/**
+ * 异步分析对话：提取全局关键词 + 每段对话的摘要。
+ * 在 LLM 回复后调用，不阻塞主流程。
+ */
+export declare function analyzeConversation(messages: Message[], provider: Provider): Promise<AnalysisResult>;
+/** 从消息内容中提取纯文本 */
+export declare function extractText(content: Message['content']): string;
+/**
+ * 使用关键词 + 摘要匹配历史消息。
+ * @param history 完整历史
+ * @param keywords 全局关键词
+ * @param summaries 各 turn 的摘要
+ * @param minHits 最少命中数
+ */
+export declare function matchHistory(history: Message[], keywords: string[], summaries?: TurnSummary[], minHits?: number): Message[];
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/context/precision/analyzer.js

@@ -0,0 +1,131 @@
+import { loadPrompt } from '../../prompts/loader.js';
+/**
+ * 异步分析对话：提取全局关键词 + 每段对话的摘要。
+ * 在 LLM 回复后调用，不阻塞主流程。
+ */
+export async function analyzeConversation(messages, provider) {
+    const prompt = loadPrompt('precise/analyze');
+    if (!prompt)
+        return { keywords: [], turns: [] };
+    const turnsText = formatTurns(messages);
+    if (!turnsText)
+        return { keywords: [], turns: [] };
+    const systemMsg = {
+        role: 'system',
+        content: { type: 'text', text: prompt },
+    };
+    const userMsg = {
+        role: 'user',
+        content: { type: 'text', text: turnsText },
+    };
+    try {
+        let raw = '';
+        for await (const event of provider.createStream([systemMsg, userMsg])) {
+            if (event.type === 'TEXT')
+                raw += event.content;
+        }
+        return parseAnalysisResult(raw);
+    }
+    catch {
+        return { keywords: [], turns: [] };
+    }
+}
+function formatTurns(messages) {
+    const parts = [];
+    let turnIndex = 0;
+    for (const msg of messages) {
+        if (msg.role === 'system')
+            continue;
+        const text = extractText(msg.content);
+        if (msg.role === 'user' && text) {
+            turnIndex++;
+            parts.push(`[Turn ${turnIndex}] user: ${text.slice(0, 800)}`);
+        }
+        else if (msg.role === 'assistant' && text) {
+            parts.push(`[Turn ${turnIndex}] assistant: ${text.slice(0, 800)}`);
+        }
+    }
+    return parts.join('\n\n');
+}
+function parseAnalysisResult(raw) {
+    try {
+        const cleaned = raw.replace(/```(?:json)?\s*([\s\S]*?)```/, '$1').trim();
+        const obj = JSON.parse(cleaned);
+        const keywords = (obj.keywords || [])
+            .filter((item) => typeof item === 'object' && item !== null)
+            .map((item) => ({
+            keyword: String(item.keyword ?? ''),
+            weight: Number(item.weight ?? 1),
+            source: String(item.source ?? 'assistant'),
+        }))
+            .filter((e) => e.keyword.length > 0);
+        const turns = (obj.turns || [])
+            .filter((item) => typeof item === 'object' && item !== null)
+            .map((item, i) => ({
+            summary: String(item.summary ?? ''),
+            keywords: Array.isArray(item.keywords)
+                ? item.keywords.filter((k) => k.length > 0)
+                : [],
+            indices: [i + 1],
+        }))
+            .filter((t) => t.summary.length > 0);
+        return { keywords, turns };
+    }
+    catch {
+        // fallback: line-by-line keyword extraction
+        const lines = raw.split('\n').filter(l => l.trim());
+        const keywords = lines.map(line => ({
+            keyword: line.replace(/^[-*\d.]+\s*/, '').trim(),
+            weight: 1,
+            source: 'assistant',
+        })).filter(e => e.keyword.length > 0);
+        return { keywords, turns: [] };
+    }
+}
+/** 从消息内容中提取纯文本 */
+export function extractText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content.filter(c => c.type === 'text').map(c => c.text).join(' ');
+    }
+    if (content && typeof content === 'object' && content.type === 'text') {
+        return content.text;
+    }
+    return '';
+}
+/**
+ * 使用关键词 + 摘要匹配历史消息。
+ * @param history 完整历史
+ * @param keywords 全局关键词
+ * @param summaries 各 turn 的摘要
+ * @param minHits 最少命中数
+ */
+export function matchHistory(history, keywords, summaries = [], minHits = 2) {
+    if (keywords.length === 0 && summaries.length === 0)
+        return history.slice(-6);
+    // 摘要关键词：每个 turn 提取的关键词，权重高于全局关键词
+    const turnKeywords = [];
+    for (const s of summaries) {
+        turnKeywords.push(...s.keywords.map(k => k.toLowerCase()));
+    }
+    const matched = [];
+    for (const msg of history) {
+        const text = extractText(msg.content).toLowerCase();
+        let hits = 0;
+        // 全局关键词匹配
+        for (const kw of keywords) {
+            if (text.includes(kw.toLowerCase()))
+                hits++;
+        }
+        // 摘要关键词匹配（权重 ×2：摘要关键词更精准）
+        for (const kw of turnKeywords) {
+            if (text.includes(kw))
+                hits += 2;
+        }
+        if (hits >= minHits)
+            matched.push(msg);
+    }
+    return matched;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/context/precision/companion.d.ts

@@ -0,0 +1,27 @@
+import type { Message } from '../../types.js';
+import type { Provider } from '../../provider/interface.js';
+import type { ComposeStrategy, ComposeStrategyOptions } from './types.js';
+/**
+ * CompanionStrategy — 陪伴模式。
+ *
+ * 不做关键词分析、不截断历史。
+ * filterHistory 移除所有包含工具调用或工具相关文本的回合，
+ * 保持陪伴对话纯净——陪伴模式下不应夹杂任何"元操作"痕迹。
+ */
+export declare class CompanionStrategy implements ComposeStrategy {
+    name: string;
+    prepareCompose(_personaDir: string | undefined): ComposeStrategyOptions;
+    filterHistory(history: Message[]): Message[];
+    analyzeTurn(_messages: Message[], _provider: Provider): Promise<void>;
+}
+/**
+ * 从历史消息中移除所有包含工具调用或工具相关文本的完整回合。
+ *
+ * 检测两类情况：
+ *   A. assistant 消息中包含 tool_use 块（实际调用了工具）
+ *   B. assistant 的文本中出现了工具名或关键词（"你有哪些工具可用？"→ 列工具名）
+ *
+ * 两种情况都会移除整轮：用户消息 + assistant 消息 + tool_result + 跟进文本。
+ */
+export declare function filterToolRounds(history: Message[]): Message[];
+//# sourceMappingURL=companion.d.ts.map