mocode-ai 1.2.7 → 1.2.9

package/dist/config/index.d.ts

@@ -1,114 +0,0 @@
-export interface Config {
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    maxTokens?: number;
-    systemPrompt: string;
-    /** 模型上下文窗口(token)。须对齐真实模型窗口(GLM-4.6≈128k,DeepSeek-V3≈64k,Qwen 视版本)。 */
-    contextWindowTokens: number;
-    /** 自动压缩触发阈值(占窗口比例)。默认 0.85,保守偏早以吸收估算误差与下一步增长。 */
-    compactThreshold: number;
-    /** 流式请求里带 stream_options.include_usage 拿真实 usage。后端不认 stream_options 时关掉。 */
-    includeUsage: boolean;
-    /** 自动压缩总开关。关掉则只靠手动 /compact。 */
-    autoCompact: boolean;
-    /** Context Optimization Pipeline 总开关(工具结果进 LLM 前的类型化编码:tree/search/log/…)。
-     *  关掉则工具结果原样进 LLM(仅长度裁剪),零行为变化。默认 true。 */
-    contextOptimize: boolean;
-    /** 相关性裁剪总开关(read_file 跨条裁剪:同 path 旧 read + 已被 mutation 覆写的旧 read
-     *  自动替换为存根)。纯静态、不调 LLM;关掉则保留所有 read 结果(只受 capToolResultForHistory
-     *  单条上限与 microcompact 旧区截短影响)。默认 true;
-     *  设 MOCODE_CONTEXT_RELPRUNE=false 全局回退。 */
-    contextRelprune: boolean;
-    /** 观察者生命周期总开关(LIVE→REFERENCED→OBSOLETE→STUB 四态机;grep/glob/codegraph
-     *  producer ↔ read/edit/write consumer 引用追踪;孤立+老化非观察类工具自动 STUB;
-     *  观察类工具永远只到 REFERENCED,不自动 STUB)。与 contextRelprune 并列,纯静态、不调 LLM。
-     *  默认 true;设 MOCODE_LIFECYCLE=false 全局回退。 */
-    contextLifecycle: boolean;
-    /** Context Budget Scheduler 总开关(五区分账 + ROI 排序调度)。
-     *  关掉则 agent 步前退化为 maybeCompact(history) 老路径(只看总占用 0.85 阈值),
-     *  零行为变化。默认 true;设 MOCODE_BUDGET_SCHEDULER=false 全局回退。 */
-    contextBudget: boolean;
-    /** 后台反思 pass 总开关。关掉则只靠手动 /reflect + 机会主义 memory_update。 */
-    autoReflect: boolean;
-    /**
-     * 记忆子系统总开关。关闭时:5 个 memory_* 工具不进工具表,buildSystemPrompt
-     * 里的 Memory Index 段 + memory_* 工具使用说明整段不出现,plan 模式提示词里的
-     * 工具名也跟着消失。运行时 /memory_switch 改;持久化 MEMORY_ENABLED。
-     * 默认 false:新用户零侵入,想用记忆功能显式打开。
-     */
-    memoryEnabled: boolean;
-    /** 每 N 个轮次触发一次后台反思 pass(与 agent 并发,不阻塞)。默认 5。 */
-    reflectEveryN: number;
-    /** 每轮 agent 循环最大步数(防无限循环)。默认 25。 */
-    maxSteps: number;
-    /** 子 agent(task 工具派生)默认步数上限。防子任务失控耗尽配额。默认 50。 */
-    subAgentMaxSteps: number;
-    /** 会话落盘目录(cwd 下)。 */
-    sessionDir: string;
-    /** AnySearch 联网搜索 API key(可选)。不配则走匿名免费额度(按 IP 限流)。 */
-    searchApiKey?: string;
-    /** 沙箱根目录(文件操作边界,可选)。未配则 startRepl 用 process.cwd() 兜底。优先级:--sandbox-root > 本项 > cwd。 */
-    sandboxRoot?: string;
-    /** AnySearch API base,默认官方端点。 */
-    searchBaseUrl: string;
-    /** 单张图片内联字节上限(base64 前的原始字节);超此大小拒绝并提示 TODO 走 URL 上传。默认 4MB。 */
-    maxImageBytes?: number;
-    /** 主题名(对应 src/ui/theme.ts 的 THEMES 表键)。默认 default;shell env MOCODE_THEME 覆盖文件。 */
-    theme: string;
-    /** MOCODE_THEME 是否由 shell 环境变量设置(非文件回填)。若是,/theme 写文件下次启动仍被 shell 盖。 */
-    themeFromShell: boolean;
-    /** 由 shell 环境变量设置的 LLM 键名列表(非文件回填)。若含某键,/model 写该键下次启动仍被 shell 盖。 */
-    llmKeysFromShell: string[];
-}
-/**
- * 模型是否已配置(baseURL + apiKey 非空)。REPL 开场据此决定是否提示 /model。
- * 未配置时 config.model 仍回退 'gpt-4o-mini',但发消息会因 baseURL/apiKey 空而失败——由 runTurn catch 友好提示。
- */
-export declare function isModelConfigured(): boolean;
-/** 兼容旧名字:repl 的 buildSystemMessage 仍引 PLAN_MODE_SUFFIX(变量)。运行时按需现拼。 */
-export declare function buildBasePrompt(): string;
-/**
- * plan 模式追加到系统提示末尾的指令。
- * 历史曾是 `export const PLAN_MODE_SUFFIX`(顶层字面量);现改为按 isMemoryEnabled()
- * 动态拼:false 时不出现 memory_* 工具名,避免 LLM 想调不存在的工具。
- *
- * 注意:已改为 getter(每次访问现拼),让运行时切 /memory_switch 后立即生效。
- * 旧 import `PLAN_MODE_SUFFIX` 路径不变;repl 推荐改用 getPlanModeSuffix()(语义更清晰)。
- * 不能直接 `export const PLAN_MODE_SUFFIX = buildPlanModeSuffix()`:
- * 该表达式在模块初始化时立即求值,而 buildPlanModeSuffix 内部读 config,config 还未求值 → TDZ。
- */
-export declare function getPlanModeSuffix(): string;
-export declare const config: Config;
-/**
- * 运行时更新模型相关配置(/model 命令调)。
- * - 更新 config 对象字段(即时生效:chat() 读 config.model,reconfigureClient 读 config.baseURL/apiKey)。
- * - 同步 process.env(保持内存一致:其他读 process.env 的路径也拿到新值;且使新值在下次启动的
- *   loadEnvFiles 中被视为"已设",不被文件回填覆盖——即"优先拿这里的")。
- * 持久化(写 ~/.mocode/config)由调用方走 writeConfigKeys,此处只管内存 + env。
- * 重建 OpenAI 客户端(baseURL/apiKey 是构造时固化的实例字段)由调用方走 reconfigureClient。
- */
-export declare function updateModelConfig(opts: {
-    model?: string;
-    baseURL?: string;
-    apiKey?: string;
-    contextWindowTokens?: number;
-}): void;
-/**
- * 记忆子系统总开关:单一来源。/memory_switch、/memory_status、buildSystemPrompt、
- * tools/builtins/index.ts、tools/constants.ts 的 plan-mode 列表都从这里查。
- * 默认 false(新用户零侵入)。
- */
-export declare function isMemoryEnabled(): boolean;
-/**
- * 切换记忆子系统开关(/memory_switch on|off 调)。
- * - 更新 config 单例字段(其它模块下次调 isMemoryEnabled() 即拿新值)。
- * - 同步 process.env.MEMORY_ENABLED(下次启动 loadEnvFiles 不被文件回填)。
- * 持久化(写 ~/.mocode/config 的 MEMORY_ENABLED 键)由调用方走 writeConfigKeys。
- *
- * 注:开关切换对当前会话的 tool list / 已拼好的 systemPrompt 不会自动重算 —
- * 工具表在 REPL 启动时构建,systemPrompt 在每轮 chat() 拼时按 isMemoryEnabled()
- * 现查现拼(关掉时该轮拼出来的 prompt 即不带 memory_* 段)。所以切换在「下一轮
- * agent 调用」起即时生效,本轮已发出的请求不会回滚。
- */
-export declare function updateMemoryConfig(enabled: boolean): void;

package/dist/config/presets.d.ts

@@ -1,57 +0,0 @@
-/**
- * 多模型预设(`/model save <name>` 保存的命名配置)的纯 I/O 叶子。
- *
- * 存储:每个预设一个独立 JSON 文件 `~/.mocode/models/<name>.json`。
- *   - 选用 per-file 而非单一 index.json:写不需要读-合并-写整本,天然原子(单文件 rename),
- *     符合 memory/store.ts 的惯例;并发写多个预设互不打架。
- *   - 路径前缀与 CONFIG_PATH 共享 `~/.mocode/`,保证权限/位置一致。
- *
- * 不读 process.env、不触发 config 单例初始化——repl(/model 子命令)与 commands/config.ts
- * 之外的脚本都能安全 import。错误一律抛(写失败属异常路径,调用方决定怎么提示用户)。
- *
- * 命名约束:[a-zA-Z0-9_-]{1,32}。理由:
- *   - 排除路径分隔符与 .. 防止越权写文件。
- *   - 与 dotenv key 风格一致,便于未来扩展到同名 env override。
- *   - 32 位上限防极长名撑爆文件名系统。
- */
-/** 预设目录:`~/.mocode/models/`(按需创建)。 */
-export declare const MODELS_DIR: string;
-/** 单个预设的内容:与 updateModelConfig 的可选字段对齐。 */
-export interface ModelPreset {
-    name: string;
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    contextWindow: number;
-}
-/** 名字是否合法(调用方复用,避免在多处重复同一正则)。 */
-export declare function isValidPresetName(name: string): boolean;
-/** 读单个预设;不存在抛错。 */
-export declare function getPreset(name: string): ModelPreset;
-/** 读单个预设;不存在返回 null(供列表/可选切换场景)。 */
-export declare function readPreset(name: string): ModelPreset | null;
-/** 写/覆盖一个预设(原子:写 tmp 再 rename)。 */
-export declare function savePreset(preset: ModelPreset): void;
-/** 删除一个预设;不存在返回 false,成功返回 true。 */
-export declare function deletePreset(name: string): boolean;
-/**
- * 重命名一个预设(原子:link+unlink,跨设备时退化为 copy+unlink)。
- * 用于 /model rename <old> <new>;不存在的旧名 / 已存在的新名返回 false,具体由调用方决定提示文案。
- */
-export declare function renamePreset(oldName: string, newName: string): boolean;
-/** 列出全部预设(按 name 升序);目录不存在返回空数组。 */
-export declare function listPresets(): ModelPreset[];
-/**
- * 把当前 config 的 LLM 四键(baseURL/apiKey/model/contextWindow)迁为命名预设。
- * 用于启动时一次性兜底老用户:加 /model 之前就已经在 ~/.mocode/config 写过的配置,
- * /model list 应该立刻能看到,而不是空。已有同名预设则不重复写。
- *
- * 返回新建的预设名;若未配置完整(baseURL/apiKey 缺失)或已有同名则返回 null。
- * 设计为幂等:重启调用一次也只会生效一次。
- */
-export declare function migrateCurrentToPreset(input: {
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    contextWindow: number;
-}): string | null;

package/dist/context/budget.d.ts

@@ -1,79 +0,0 @@
-import type { ChatMessage } from '../llm/index.js';
-/** 五区分账(占比对齐 CONTEXT_WINDOW)。顺序固定,便于遍历。 */
-export declare const BUDGET_LAYERS: readonly ["system", "history", "toolRecent", "toolOld", "summary", "reserve"];
-export type BudgetLayer = (typeof BUDGET_LAYERS)[number];
-/** 占比(总和 = 0.95,留 5% 给 Reserve)。对齐用户修正版:
- *  Recent Tool 25%(原 40% 偏大,因 Hot 区不该被压)+ Old Tool 25% 同等 +
- *  History 20% + System 15% + Summary 10%(平时 0 占用,触发后才用) */
-export declare const BUDGET_RATIO: Record<BudgetLayer, number>;
-/** Hot/Cold 划分:当前 step 起往前 HOT_TURN_WINDOW 个 user turn 之内的工具结果视为 Hot,
- * 之外的视为 Cold。0 = 全 Cold(等同老路径);越短 Hot 越小,压缩越激进。 */
-export declare const HOT_TURN_WINDOW = 4;
-/** 工具消息推入历史后,经过的「消费者 push 次数」即 age。
- * Cold 区内:age ≥ TOOL_OLD_AGE 的非观察类工具结果可被调度器就地 stub。
- * 默认 2 = 跨过 2 个消费者 push 仍未被消费,等同 lifecycle 的 DEFAULT_AGE_THRESHOLD。 */
-export declare const TOOL_OLD_AGE = 2;
-/** 从 history 末尾向前找最后一个 user 消息的索引;无 user 返 -1。 */
-export declare function lastUserIndex(history: ChatMessage[]): number;
-/** 从 idx 处向前数第 N 个 user turn 的边界 index(含该 user 之后的内容)。
- * 用于把 history 切成 Hot 区(tail 一段,endExclusive=history.length)与 Cold 区(0..endExclusive)。
- * 若 N 个 user 不足,Hot 区 = history.length(全保护);Cold 区空,无压缩目标。 */
-export declare function userTurnBoundary(history: ChatMessage[], window: number): number;
-/** 单区预算分配。绝对值 = ratio * window。 */
-export interface LayerBudget {
-    actual: number;
-    budget: number;
-    overBudget: boolean;
-    /** overBudget 比值 = max(0, actual - budget) / budget;无超 = 0。
-     * 调度器用此值做 ROI 排序——溢出越多,优先处理。 */
-    overRatio: number;
-}
-/** 一次评估的完整报告(供 agent/core.ts 决策)。 */
-export interface BudgetReport {
-    step: number;
-    total: number;
-    window: number;
-    layers: Record<BudgetLayer, LayerBudget>;
-    /** 实际超预算的层(按 overRatio 降序,排前面先处理)。 */
-    triggers: BudgetLayer[];
-    /** 总占用超总阈(0.85*window)的兜底触发 — 单独字段,与 layers.triggers 分开。 */
-    totalOver: boolean;
-    /** Hot/Cold 边界:Cold 区 = [1, hotBoundary);Hot 区 = [hotBoundary, length)。
-     * agent/core.ts 拿到后可对 Cold 区做就地 stub,Hot 区只 cap。 */
-    hotBoundary: number;
-}
-/** 评估当前 history 的五区预算(纯函数,改不动 history)。
- * 传入 step 是当前所在 step 编号(agent 循环 step 变量),用于日志/调试。 */
-export declare function evaluateBudget(history: ChatMessage[], window: number, step?: number): BudgetReport;
-/** 调度器决策动作(纯数据,不动 history)。agent/core.ts 据此调用既有闸。 */
-export type ScheduleAction = {
-    kind: 'warn';
-    layer: BudgetLayer;
-    reason: string;
-} | {
-    /** 对 Cold 区(hotBoundary 之前)的 tool 消息按 ROI 做 L1→L2→L3 渐进压缩。
-     *  注意:Hot 区永不发此 action——精细剔除由 lifecycle/pruner/drop_context 负责。 */
-    kind: 'shrink_cold_tools';
-    level: 1 | 2 | 3;
-} | {
-    /** Hot 区只 cap(降单条上限),不 stub;aggressive = true 时调低阈值走更严的 cap。
-     * 精细剔除(cap 不够时)由 lifecycle age stub 与 drop_context 工具兜底。 */
-    kind: 'cap_hot_tools';
-    aggressive: boolean;
-} | {
-    kind: 'compact_history';
-    focus?: string;
-};
-/** 根据 BudgetReport 生成调度动作(从轻到重,直至总占用回落到 0.85 以下)。
- * 规则:
- *   - system 超 → warn(不压,配置问题不是内容问题)
- *   - toolOld 超 → 先 L1(中截超大)→ L2(same-path 已有 relevance)→ L3(age stub,新增)
- *   - toolRecent 超 → cap(只降低单条上限,不 stub)
- *   - history 超 或 totalOver → compact_history(调 maybeCompact / compactHistory)
- *   - summary 超 → 不动(摘要本身就压缩产物,删它等于丢历史,只能放任或扩 Recent 预算) */
-export declare function scheduleActions(report: BudgetReport): ScheduleAction[];
-/** 拍平成人类可读(供 /context 命令与 check-budget 脚本用)。 */
-export declare function formatReport(report: BudgetReport): string;
-/** 便捷:把 history 一把估成总 token 数(给 cap.js 等复用,避免重复实现)。
- * 注意:此处是粗估(只看 content 长度),不区分五区——只用于「系统层整体还剩多少」快查。 */
-export declare function quickEstimate(history: ChatMessage[]): number;

package/dist/context/classifier.d.ts

@@ -1,14 +0,0 @@
-import type { ContextKind } from './types.js';
-/**
- * 判定 ContextKind。
- *  - 有 BY_NAME 强先验 → 用之(内置工具确定性强)。
- *  - 否则形状启发(MCP / 未来工具)。
- *  - 都不中 → passthrough(不动)。
- *
- * @param toolName 工具名
- * @param output 工具原始输出(形状启发用;有 BY_NAME 时不读)
- * @param _args 已解析参数(预留:未来 read_file 的 offset/limit 可影响 code 编码策略;Phase 1 不用)
- */
-export declare function classify(toolName: string, output: string, _args: Record<string, unknown> | null): ContextKind;
-/** 暴露 BY_NAME 副本供调试 / 未来 /context 展示(只读视图)。 */
-export declare function knownToolKinds(): Record<string, ContextKind>;

package/dist/context/encoders/_util.d.ts

@@ -1,11 +0,0 @@
-/** 去 ANSI CSI 序列(颜色 / 光标 / 清屏等)。语义无损:颜色码不含信息。 */
-export declare function stripAnsi(s: string): string;
-/**
- * 折叠连续空行(只含空白字符的行)≥ threshold → 单个空行。
- * 用于 prose / source dump(web_fetch / use_skill / task / codegraph):HTML→文本与 markdown 常留多余空行,
- * 多空行与单空行语义等价,折叠无损。默认 threshold=3(只动真正过量的空行,常见 ≤2 空行不动)。
- *
- * 注意:用 `.trim() === ''` 判空——故 read_file 的 `     2\t`(行号前缀 + tab,trim 后剩 `2`)不会被
- * 视作空行。read_file 的空行折叠见 code encoder(前缀感知)。
- */
-export declare function collapseBlankRuns(text: string, threshold?: number): string;

package/dist/context/encoders/code.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const codeEncoder: ContextEncoder;

package/dist/context/encoders/doc.d.ts

@@ -1,14 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-/**
- * Doc Encoder(web_fetch / use_skill):折叠连续空行(≥3 → 1)。
- *
- * 输入:
- *  - web_fetch 的 `URL (HTTP ...)\n\n<body>`(HTML→文本,常留多余空行)。
- *  - use_skill 的 `# Skill: name\n\n<body>`(SKILL.md 正文,frontmatter 已剥离)。
- * 输出:空行折叠;正文 / 指令逐字保留。
- *
- * 不变量:URL 前缀行 / Skill 标题行保留;正文文本逐字保留(仅折叠空行——markdown / HTML 多空行与
- *  单空行语义等价,无损)。use_skill 走放宽 cap(MAX_SKILL_RESULT)保指令完整——本 encoder 在 cap 前先
- *  折叠空行,减少被 cap 截断的风险。
- */
-export declare const docEncoder: ContextEncoder;

package/dist/context/encoders/graph.d.ts

@@ -1,11 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-/**
- * Graph Encoder(codegraph):去 ANSI + 折叠连续空行(≥3 → 1)。
- *
- * 输入:codegraph CLI 返回的 `[退出码 N]\n<源码 + 调用路径>`(可能含 ANSI 颜色、多余空行)。
- * 输出:去 ANSI + 空行折叠;结构(调用路径块、源码段)不动。
- *
- * 不变量:退出码行保留;源码与调用路径文本逐字保留(仅去颜色码 + 折叠空行);不删内容行。
- * 保守:不重构调用路径 / 不去重源码(codegraph CLI 输出格式未稳定,需先采样真实输出定不变量,留后续)。
- */
-export declare const graphEncoder: ContextEncoder;

package/dist/context/encoders/graph.js

@@ -1,81 +0,0 @@
-import { stripAnsi, collapseBlankRuns } from './_util.js';
-function isAgedCold(input) {
-    return input.phase === 'sweep' && input.isCold === true && (input.age ?? 0) >= 2;
-}
-function normalizeBlock(block) {
-    return block
-        .replace(/\r\n/g, '\n')
-        .split('\n')
-        .map((line) => line.trimEnd())
-        .join('\n')
-        .trim();
-}
-function dedupeFencedBlocks(text) {
-    const seen = new Set();
-    let removed = 0;
-    const result = text.replace(/```[^\n]*\n[\s\S]*?\n```/g, (block) => {
-        const key = normalizeBlock(block);
-        if (key.length < 120 || !seen.has(key)) {
-            seen.add(key);
-            return block;
-        }
-        removed++;
-        return '… duplicate source block omitted (cold graph)';
-    });
-    return { text: result, removed };
-}
-function looksLikeSourceBlock(block) {
-    const lines = block.split('\n');
-    const sourceLines = lines.filter((line) => /^\s*\d+\t/.test(line) ||
-        /^\s*(?:L)?\d+[:|]\s/.test(line) ||
-        /^.*:\d+(?::\d+)?:\s/.test(line)).length;
-    return block.length >= 120 && sourceLines >= 3;
-}
-function dedupeParagraphSourceBlocks(text) {
-    const parts = text.split(/(\n{2,})/);
-    const seen = new Set();
-    let removed = 0;
-    for (let i = 0; i < parts.length; i += 2) {
-        const block = parts[i];
-        if (!looksLikeSourceBlock(block))
-            continue;
-        const key = normalizeBlock(block);
-        if (seen.has(key)) {
-            parts[i] = '… duplicate source block omitted (cold graph)';
-            removed++;
-        }
-        else {
-            seen.add(key);
-        }
-    }
-    return { text: parts.join(''), removed };
-}
-export const graphEncoder = {
-    kind: 'graph',
-    encode(input) {
-        const stripped = stripAnsi(input.output);
-        let text = stripped;
-        let duplicates = 0;
-        if (isAgedCold(input)) {
-            const fenced = dedupeFencedBlocks(text);
-            const paragraphs = dedupeParagraphSourceBlocks(fenced.text);
-            text = paragraphs.text;
-            duplicates = fenced.removed + paragraphs.removed;
-        }
-        text = collapseBlankRuns(text, 3);
-        const notes = [
-            /\x1b/.test(input.output) ? 'ANSI stripped' : '',
-            text !== stripped && duplicates === 0 ? 'blank runs collapsed' : '',
-            duplicates > 0 ? `${duplicates} duplicate source blocks omitted` : '',
-        ].filter(Boolean);
-        return {
-            text,
-            meta: {
-                kind: 'graph',
-                originalLen: input.output.length,
-                encodedLen: text.length,
-                note: notes.join(', ') || 'no change',
-            },
-        };
-    },
-};

package/dist/context/encoders/index.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const builtinEncoders: ContextEncoder[];

package/dist/context/encoders/log.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const logEncoder: ContextEncoder;

package/dist/context/encoders/log.js

@@ -1,2 +0,0 @@
-/** @deprecated 使用 commandEncoder；保留别名避免破坏已有直接导入。 */
-export { commandEncoder as logEncoder } from './command.js';

package/dist/context/encoders/memory.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const memoryEncoder: ContextEncoder;

package/dist/context/encoders/passthrough.d.ts

@@ -1,11 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-/**
- * 兜底 encoder:identity,原样返回。
- *  - classifier 未命中任何 kind(返回 'passthrough')时用。
- *  - pipeline 总开关关闭(MOCODE_CONTEXT_OPTIMIZE=false)时,所有 kind 都走它 → 行为与改造前逐字节一致。
- *  - Phase 1 阶段 registry 只注册它 → 全链路零行为变化。
- *  - 任何 encoder 报错时,pipeline catch 后回落到它(传原 output)。
- *
- * 永不抛错:output 可能是任意字符串(含 ANSI / 多行 / 非法 UTF-8 片段),identity 直接返回,无解析风险。
- */
-export declare const passthroughEncoder: ContextEncoder;

package/dist/context/encoders/search.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const searchEncoder: ContextEncoder;

package/dist/context/encoders/summary.d.ts

@@ -1,12 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-/**
- * Summary Encoder(task):折叠连续空行(≥3 → 1)。
- *
- * 输入:task 工具返回的子 agent 最终摘要文本(已是摘要,可能含多余空行),可能带截断尾标
- *  `…(子 agent 摘要已截断 N 字符)`。
- * 输出:空行折叠;摘要文本逐字保留。
- *
- * 不变量:摘要事实文本逐字保留(仅折叠空行);截断尾标保留。子 agent 摘要已是高密度文本,只做轻量去冗余,
- * 不再做进一步压缩(避免丢事实)。
- */
-export declare const summaryEncoder: ContextEncoder;

package/dist/context/encoders/table.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const tableEncoder: ContextEncoder;

package/dist/context/encoders/tree.d.ts

@@ -1,2 +0,0 @@
-import type { ContextEncoder } from '../types.js';
-export declare const treeEncoder: ContextEncoder;

package/dist/context/index.d.ts

@@ -1,6 +0,0 @@
-export { optimizeToolResult } from './pipeline.js';
-export type { ContextKind, ContextEncoder, EncoderInput, EncoderOutput, } from './types.js';
-export { classify, knownToolKinds } from './classifier.js';
-export { registerEncoder, registerAll, getEncoder, registeredKinds, } from './registry.js';
-export { evaluateBudget, scheduleActions, formatReport, quickEstimate, userTurnBoundary, lastUserIndex, BUDGET_LAYERS, BUDGET_RATIO, HOT_TURN_WINDOW, TOOL_OLD_AGE, } from './budget.js';
-export type { BudgetLayer, LayerBudget, BudgetReport, ScheduleAction, } from './budget.js';

package/dist/context/lifecycle.d.ts

@@ -1,51 +0,0 @@
-import type { ChatMessage } from '../llm/index.js';
-/** 工具消息的观察者生命周期状态。 */
-export type LifeState = 'LIVE' | 'REFERENCED' | 'OBSOLETE' | 'STUB';
-/**
- * Observation Lifecycle Engine。
- * 每个 runAgentCore 实例持一个;pushToolResult 出口调 pushTool、mutation 分支调 pushMutation。
- * 内部 try/catch 兜底,对外永不抛错。
- */
-export declare class LifecycleEngine {
-    private readonly ageThreshold;
-    /** 工具消息 idx → 状态。 */
-    private readonly states;
-    /** 工具消息 idx → 被消费的次数(同一上游被多次消费也只算 REFERENCED,不计并发)。 */
-    private readonly consumerCount;
-    /** 工具消息 idx → 自 push 以来的「消费者 push」次数(用于老化判定)。
-     * 每次 pushTool 触发,所有 LIVE 工具消息 age++。 */
-    private readonly age;
-    /** producer 路径 → 生产者工具消息 idx 列表(逆查用:某个 path 被消费时,反查上游 producer)。
-     * 注意:不存 read_file,因为 read 自身就是消费者不充当 producer。 */
-    private readonly producersByPath;
-    /** 当前步序号(用于 age 老化:每次 pushTool 自增,对比 age 阈值)。 */
-    private step;
-    /** 最后 user 索引缓存(pushTool 时重算;pushMutation 时也重算,因为 mutation 可能跟 user 同行)。 */
-    private lastUser;
-    constructor(ageThreshold?: number);
-    /** 新工具结果 push 进 history 时调;idx = history.length - 1。
-     *  mutation 工具(edit_file/write_file)的 push 跳过本轮的 autoStubOrphans(由调用方在
-     *  pushMutation 标完 read REFERENCED 之后再触发),避免刚被 mutation 消费的 read 被提前 STUB。 */
-    pushTool(history: ChatMessage[], idx: number): void;
-    /** mutation 工具(edit_file/write_file)push 后调。语义与 pushTool 一致,但额外标记「被 mutation 消费」的 read。
-     *  注意:本层不直接 stub read(那是 Relevance Pruner 的职责);本层只更新状态图。
-     *  注意:puhToolResult 出口已经登记过 mutation 本身,这里不再调 pushTool(避免 age 翻倍)。 */
-    pushMutation(history: ChatMessage[], mutationIdx: number, path: string): void;
-    /** 老化自动 STUB:扫描所有 LIVE(且非观察类)且 age ≥ 阈值且不在保护区的工具消息 → OBSOLETE → STUB。 */
-    private autoStubOrphans;
-    /** 实际替换 content 为存根。 */
-    private stubOne;
-    /** 找某条 tool 消息对应的 assistant.tool_calls.arguments。 */
-    private findToolArgs;
-    /** 拿某 idx 的当前状态;不在图里返 null。 */
-    getState(idx: number): LifeState | null;
-    /** 拿当前各状态计数。供 /context 显示「live=N, referenced=M, obsolete=K, stubbed=S」。 */
-    stats(): {
-        live: number;
-        referenced: number;
-        obsolete: number;
-        stubbed: number;
-    };
-}
-/** 默认单例工厂。runAgentCore 入口 new 一个,后续 pushTool / pushMutation 共享。 */
-export declare function createLifecycleEngine(ageThreshold?: number): LifecycleEngine;

package/dist/context/pipeline.d.ts

@@ -1,9 +0,0 @@
-/**
- * 优化工具结果为进 LLM 的 tool 消息 content。
- *
- * @param name 工具名
- * @param output executeTool 的原始返回字符串
- * @param argsRaw 工具 arguments 原始 JSON 字符串(tc.arguments,可空;未传则 args=null)
- * @returns 进 history 的 content 字符串(永不抛错)
- */
-export declare function optimizeToolResult(name: string, output: string, argsRaw?: string): string;

package/dist/context/registry.d.ts

@@ -1,9 +0,0 @@
-import type { ContextEncoder, ContextKind } from './types.js';
-/** 注册一个 encoder(后注册覆盖先注册,允许 MCP 覆盖默认)。返回 encoder 自身供链式。 */
-export declare function registerEncoder(enc: ContextEncoder): ContextEncoder;
-/** 批量注册(启动期 pipeline 调一次)。幂等:重复调忽略。 */
-export declare function registerAll(list: ContextEncoder[]): void;
-/** 取某 kind 的 encoder;未注册返 undefined(pipeline 回落 passthrough)。 */
-export declare function getEncoder(kind: ContextKind): ContextEncoder | undefined;
-/** 调试:列出已注册 kind。 */
-export declare function registeredKinds(): ContextKind[];

package/dist/context/relevance.d.ts

@@ -1,65 +0,0 @@
-import type { ChatMessage } from '../llm/index.js';
-/**
- * 维护「path → 该 path 所有 read_file tool 消息的 history index」映射。
- *  - observePush:把刚 push 的 read_file tool 消息登记,并把同 path 的"更早" read 全部 stub。
- *  - observeMutation:把该 mutation path 的"在 mutation 之前的" read 全部 stub。
- *
- * 设计:每个 agent 会话(每个 runAgentCore 实例)持有一个 pruner。会话结束/换 plan 时
- * 可新建;不持久化(history 重建时索引自然过期)。
- *
- * 零依赖:仅依赖 ChatMessage 形状;不 import llm / tools / agent。
- */
-export declare class RelevancePruner {
-    /** path → [history index, ...]  按插入序;最新在末尾。 */
-    private readonly readByPath;
-    /** 把刚 push 的消息通知 pruner。
-     *  - 只处理 tool 消息(role==='tool')。
-     *  - 只关心 read_file:登记 + 反向 stub 同 path 旧 read。
-     *  - 非 read_file 的 tool 消息:无操作(本层只管 read_file)。
-     *  - 非 tool 消息(assistant / user / system):无操作。
-     */
-    observePush(history: ChatMessage[], msg: ChatMessage): void;
-    /**
-     * 把该 mutation path 的"在 mutation 之前的" read 全部 stub。
-     * 通常用于 edit_file / write_file 工具:mutation 之后,之前的 read_file(p) 内容
-     * 已失效(已不再是文件当前状态),模型后续若依赖旧 read 来 edit_file 会失败,但 edit_file
-     * 的 old_string 来自模型记忆/后读,不依赖旧 read 结果文本。
-     *
-     * 调用时机:agent/core.ts 在 mutation 工具调用的 pushToolResult 之后立即调;
-     * 此时 history 末尾就是 mutation 的 tool 消息,prior reads 指 < idx。
-     */
-    observeMutation(history: ChatMessage[], path: string): void;
-    /**
-     * 把 history 里 "path 同 + index < beforeIdx + 不在当前轮保护区" 的所有 read_file
-     * tool 消息替换为存根(只改 .content,不动 id / 数组结构)。
-     *
-     * 实现:
-     *  - 用 readByPath[path] 直接拿到所有 index(已登记过),筛 < beforeIdx 的 stub。
-     *  - 同时扫一遍 [1, beforeIdx) 区间找未登记的(防御:索引可能漏登;不依赖索引也能 stub,
-     *    保证正确性。索引只用于"避免重复扫全表"的优化)。
-     *  - protectedFrom = lastUserIndex(history):user 之后一律不动。
-     *  - 幂等:已是 STUB_PREFIX 的跳过。
-     */
-    private stubPriorReads;
-}
-/** 默认单例:每个 agent 循环一个。runAgentCore 入口 new 一个,后续 observe 共享。 */
-export declare function createRelevancePruner(): RelevancePruner;
-/**
- * 扫 history,统计被相关性裁剪 stub 的 read_file tool 消息(条数 + 原字节数)。
- * 供 /context 渲染统计行用(让用户直观看到「prune 帮了多少」)。
- * 永不抛错(对齐本模块契约);history 为空 / 无 stub 时返零值。
- *
- * 注意:stub 后只剩 stub 字符串(原 content 已丢失),故只能从 stub 字符串里 parse
- * 原字节数,误差 = stub 时记录的 content.length(精确);token 估算走 estimateTokens。
- */
-export declare function computePruneStats(history: ChatMessage[]): {
-    stubbed: number;
-    /** 原 content 总字节数(仅 stubbed 的)。 */
-    originalChars: number;
-    /** 反推原 token 数(粗略:estimateTokens(originalChars 字符))。 */
-    originalTokens: number;
-    /** 当前 stub 字符串总字节数。 */
-    stubChars: number;
-    /** 估算释放的 token 数(originalTokens - 当前 stub 占的 token)。 */
-    freedTokens: number;
-};

package/dist/context/types.d.ts

@@ -1,36 +0,0 @@
-/** Context 的数据类型。classifier 据工具名 + 输出形状判定,选 encoder。 */
-export type ContextKind = 'tree' | 'search' | 'graph' | 'log' | 'code' | 'table' | 'memory' | 'doc' | 'status' | 'summary' | 'diff' | 'ast' | 'repo' | 'passthrough';
-/** encoder 的输入。pipeline 解析 argsRaw 后传入。 */
-export interface EncoderInput {
-    /** 工具名(强先验信号)。 */
-    toolName: string;
-    /** 工具原始输出字符串(executeTool 的返回值,未经任何编码)。 */
-    output: string;
-    /** 已解析的工具参数;非法或空返 null。encoder 可据此做上下文感知编码(如 read_file 的 offset/limit)。 */
-    args: Record<string, unknown> | null;
-    /** 软目标字符数(来自 tools/constants.ts 的 cap 常量,按工具名取)。encoder 应尽量压到 budget 内,
-     *  但最终长度裁剪仍由 pipeline 末尾的 capToolResultForHistory 兜底(保 head+标记+tail)。 */
-    budget?: number;
-}
-/** encoder 的输出。 */
-export interface EncoderOutput {
-    /** 编码后文本(喂给 LLM 的 tool 消息 content)。 */
-    text: string;
-    /** 编码元数据(调试 / 未来 /context 统计用;不影响喂给 LLM 的内容)。 */
-    meta?: {
-        kind: ContextKind;
-        originalLen: number;
-        encodedLen: number;
-        /** 给调试者的备注(如"12 files · tree-encoded")。 */
-        note?: string;
-    };
-}
-/**
- * Encoder 统一接口:一类型一 encoder,纯函数,不抛错(失败由 pipeline 兜底)。
- * 扩展:在 encoders/ 加 xxx.ts 导出 ContextEncoder,在 encoders/index.ts 的 builtinEncoders 加一行。
- * 无需动 agent / llm / core。
- */
-export interface ContextEncoder {
-    kind: ContextKind;
-    encode(input: EncoderInput): EncoderOutput;
-}