aws-runtime-bridge 1.9.91 → 1.9.93

package/package/acode/dist/compaction.d.ts

@@ -1,42 +1,15 @@
-/**
- * 上下文压缩模块 — 参考 OpenCode compaction.ts 的设计
- *
- * 核心策略：
- * 1. Prune（裁剪）：从旧到新遍历工具输出，超过保护线后用占位符替换内容
- * 2. Summarize（摘要）：将早期对话结构化摘要，保留目标/指令/发现/已完成/相关文件
- *
- * 触发时机：在每次 AI 请求前检测 token 是否溢出，溢出则执行压缩
- *
- * 与 OpenCode 的对应关系：
- * - isOverflow  ↔  SessionCompaction.isOverflow
- * - prune       ↔  SessionCompaction.prune
- * - summarize   ↔  SessionCompaction.process (LLM 摘要的简化版)
- */
-/** 压缩缓冲区：保留这么多 token 的空闲空间，避免压缩过程中溢出 */
+
+
 export declare const COMPACTION_BUFFER = 20000;
-/**
- * 基础压缩触发比例（兜底默认值，仅用于 contextLimit <= 0 的异常场景）。
- * 正常情况下通过 {@link getCompactionTriggerRatio} 按窗口大小动态分级。
- */
+
 export declare const COMPACTION_TRIGGER_RATIO = 0.55;
-/** 按上下文窗口大小返回压缩触发比例（大窗口更高，充分利用空间）。 */
+
 export declare function getCompactionTriggerRatio(contextLimit: number): number;
-/** Prune 保护线默认值：保留最近 PRUNE_PROTECT token 的工具输出完整。
- *  注意：实际使用时会按 contextLimit 比例调整（见 pruneToolOutputs），
- *  避免在小上下文窗口（如 60k）下保护线过高导致 prune 永不触发。
- */
+
 export declare const PRUNE_PROTECT = 40000;
-/** Prune 最小收益默认值：累计可释放 token 不足此数时跳过修剪。
- *  注意：实际使用时会按 contextLimit 比例调整。
- */
+
 export declare const PRUNE_MINIMUM = 20000;
-/**
- * LLM 摘要 prompt 模板（OpenCode 风格结构化摘要）。
- *
- * 用于 summarizeConversationWithLLM：追加到 user 消息末尾，指导 LLM 按结构化
- * 段落（Goal/Instructions/Discoveries/Accomplished/Files）输出摘要，便于后续
- * 轮次快速恢复上下文。LLM 摘要失败时降级到 rule-based summarizeConversation。
- */
+
 export declare const COMPACTION_LLM_PROMPT_TEMPLATE: string;
 interface ChatMessageLike {
     role: "system" | "user" | "assistant" | "tool";
@@ -44,72 +17,52 @@ interface ChatMessageLike {
     tool_call_id?: string;
     tool_calls?: unknown[];
 }
-/** 压缩结果 */
+
 export interface CompactionResult {
-    /** 使用的策略 */
+    
     strategy: "prune" | "summarize" | "prune+summarize" | "none";
-    /** 释放的 token 数 */
+    
     freedTokens: number;
-    /** 压缩前对话大小（KB） */
+    
     sizeBeforeKB: number;
-    /** 压缩后对话大小（KB） */
+    
     sizeAfterKB: number;
-    /** 压缩前估算 token 数 */
+    
     tokensBefore: number;
-    /** 压缩后估算 token 数 */
+    
     tokensAfter: number;
-    /** 压缩前消息数 */
+    
     messageCountBefore: number;
-    /** 压缩后消息数 */
+    
     messageCountAfter: number;
-    /** 被裁剪的工具消息数 */
+    
     prunedToolMessages: number;
-    /** 被摘要化的消息数 */
+    
     summarizedMessages: number;
 }
-/**
- * 压缩阶段事件：由 performCompaction 通过 onPhase 回调发射，
- * 供 runtime 转换为时间线父子树结构（start → phase* → end）。
- */
+
 export interface CompactionPhaseEvent {
     phase: "prune_start" | "prune_end" | "summarize_start" | "summarize_end";
-    /** 涉及的消息数（prune/summarize 阶段开始时） */
+    
     messageCount?: number;
-    /** 已裁剪的工具消息数（prune_end） */
+    
     prunedCount?: number;
-    /** 释放的 token 数（prune_end） */
+    
     freedTokens?: number;
-    /** 已摘要化的消息数（summarize_end） */
+    
     summarizedCount?: number;
-    /** 是否使用了 LLM 摘要（summarize_end） */
+    
     usedLLM?: boolean;
 }
-/**
- * LLM 摘要器：由 runtime 注入，调用当前 provider 发起一次非流式摘要请求。
- * 失败时抛出异常，由 summarizeConversation 降级到规则摘要。
- */
+
 export type LLMSummarizer = (input: {
     conversationText: string;
     messageCount: number;
     contextLimit: number;
 }) => Promise<string>;
-/**
- * 计算压缩触发阈值：取 min(contextLimit × 动态比例, hardLimit - reserved)。
- *
- * - ratioBased = contextLimit × getCompactionTriggerRatio(contextLimit)（按窗口大小动态分级）
- * - hardLimit = inputLimit ?? contextLimit（provider 显式 inputLimit 优先）
- * - reserved = min(COMPACTION_BUFFER, maxOutput)（buffer 不超过输出上限）
- *
- * 取两者较小者，既避免小窗口下过早触发，又避免接近硬上限时来不及压缩。
- */
+
 export declare function calculateCompactionThreshold(contextLimit: number, maxOutput: number, inputLimit?: number): number;
-/**
- * 根据模型名查找上下文窗口大小。
- * 主流程：优先使用传入的 configOverrides → 精确匹配 → 前缀匹配（按长度降序）→ 默认值。
- *
- * @param modelName 模型名
- * @param configOverrides 可选的配置覆盖值（来自 acode.json 的 contextLimit/maxOutput）
- */
+
 export declare function lookupModelLimits(modelName: string, configOverrides?: {
     contextLimit?: number;
     maxOutput?: number;
@@ -117,125 +70,35 @@ export declare function lookupModelLimits(modelName: string, configOverrides?: {
     contextLimit: number;
     maxOutput: number;
 };
-/**
- * 中英文分离的文本 token 估算。
- * 对纯 ASCII 约 4 字符/token，对中文约 1.5 字符/token。
- * 参考：context-manager.ts 的同名方法。
- */
+
 export declare function estimateTextTokens(text: string): number;
-/**
- * 粗略估算文本的 token 数（保留向后兼容）。
- * 使用 estimateTextTokens 的中英文分离 + 安全填充。
- */
+
 export declare function estimateTokens(text: string): number;
-/**
- * 估算整个对话的 token 数。
- * 使用块级识别 + 中英文分离 + 安全填充。
- */
+
 export declare function estimateConversationTokens(messages: readonly ChatMessageLike[]): number;
-/**
- * 计算对话的 KB 大小。
- */
+
 export declare function conversationSizeKB(messages: readonly ChatMessageLike[]): number;
-/**
- * 判断对话是否上下文溢出（基于文本估算）。
- * 使用显式传入的 contextLimit 和比例触发，不依赖模型名查找表。
- *
- * @param messages 对话消息数组
- * @param contextLimit 上下文窗口上限
- * @param maxOutput 模型最大输出 token（未使用，保留参数兼容）
- */
+
 export declare function isOverflow(messages: readonly ChatMessageLike[], contextLimit: number, _maxOutput?: number): boolean;
-/**
- * 基于 provider 实际返回的累积 token 使用量判断是否应触发压缩。
- *
- * provider 每次请求都会返回实际 token 计数（input + output），
- * 这个计数比基于文本的估算（estimateConversationTokens）要准确得多。
- *
- * 触发条件：累积 tokens >= contextLimit * getCompactionTriggerRatio(contextLimit)
- * 使用显式传入的 contextLimit，不依赖模型名查找表。
- *
- * @param accumulatedInput  provider 实际累积的 input tokens
- * @param accumulatedOutput provider 实际累积的 output tokens
- * @param contextLimit 上下文窗口上限（来自模板配置，未配置时使用默认值）
- */
+
 export declare function isOverflowByActualUsage(accumulatedInput: number, accumulatedOutput: number, contextLimit: number): boolean;
-/**
- * Prune：从消息列表中裁剪旧工具消息的输出内容。
- *
- * 算法（参考 OpenCode compaction.ts:58-99）：
- * 1. 从最新消息往旧遍历
- * 2. 跳过前 2 轮对话（保护最近上下文）
- * 3. 累计工具消息的 token
- * 4. 超过保护线后，将工具输出替换为占位符
- * 5. 只有收益超过最小阈值才真正执行
- *
- * 保护线和最小阈值会按 contextLimit 比例调整：
- *   - protectLine = min(PRUNE_PROTECT, contextLimit * PRUNE_PROTECT_RATIO)
- *   - minimumGain = min(PRUNE_MINIMUM, contextLimit * PRUNE_MINIMUM_RATIO)
- * 这样在小上下文窗口（如 60k）下也能正常触发 prune，
- * 而不是固定 40k/20k 导致 60k 上下文永远无法 prune。
- *
- * @param messages 对话消息数组（会被原地修改）
- * @param contextLimit 上下文窗口大小，用于按比例调整阈值（默认使用 DEFAULT_CONTEXT_LIMIT）
- * @returns 裁剪结果
- */
+
 export declare function pruneToolOutputs(messages: ChatMessageLike[], contextLimit?: number): {
     prunedCount: number;
     freedTokens: number;
 };
-/**
- * Summarize：将早期对话消息替换为结构化摘要。
- *
- * 算法（参考 OpenCode compaction.ts:101-229 的 process 函数）：
- * 1. 分离 base system 消息和可压缩消息
- * 2. 保留最近 COMPACTION_RECENT_MESSAGE_COUNT 条消息
- * 3. 将早期消息生成结构化摘要
- * 4. 用摘要消息替换早期消息
- *
- * @param messages 对话消息数组（会被原地修改）
- * @returns 摘要化的消息数
- */
+
 export declare function summarizeConversation(messages: ChatMessageLike[], options?: {
     llmSummarizer?: LLMSummarizer;
     contextLimit?: number;
 }): Promise<number>;
-/**
- * Snip：删除最旧的一组消息（从第一个非 system 消息到下一个 user 消息之前）。
- *
- * 作为压缩的最终手段——当 prune 和 summarize 都无法释放足够空间时使用。
- * 能确保：
- *   1. 不删除 system 消息
- *   2. 删除的组不跨 user 边界（保证一个完整轮次）
- *   3. 删除后至少保留 1 组非 system 消息
- *
- * @param messages 对话消息数组（会被原地修改，通过 splice 删除）
- * @returns 删除的消息数
- */
+
 export declare function snipOldestMessageGroup(messages: ChatMessageLike[]): number;
-/**
- * 执行完整压缩流程：Prune → 若仍溢出则 Summarize。
- *
- * 参考 OpenCode 的两阶段策略：
- * 1. 先尝试 prune（低成本，只清除旧工具输出）
- * 2. 若 prune 后仍溢出，执行 summarize（高成本，摘要化早期对话）
- *
- * @param messages 对话消息数组（会被原地修改）
- * @param contextLimit 上下文窗口上限（来自模板配置，未配置时使用默认值）
- * @param maxOutput 模型最大输出 token
- * @param options 可选：llmSummarizer（LLM 摘要器，失败降级到规则摘要）、onPhase（阶段事件回调）
- * @returns 压缩结果
- */
+
 export declare function performCompaction(messages: ChatMessageLike[], contextLimit: number, maxOutput?: number, options?: {
     llmSummarizer?: LLMSummarizer;
     onPhase?: (event: CompactionPhaseEvent) => void;
-    /**
-     * Provider 实际累积 token 用量（来自 AI 请求返回的 usage）。
-     * 文本估算（estimateConversationTokens）可能低估实际 token 数，
-     * 导致 prune 后 isOverflow 返回 false 而跳过 summarize，最终策略为 "none"。
-     * 传入此值后，post-prune overflow 检测使用 textEstimated 与 actualUsed 的较大值，
-     * 避免因估算偏差导致压缩失效。
-     */
+    
     actualUsedTokens?: number;
 }): Promise<CompactionResult>;
 export {};

package/package/acode/dist/config.d.ts

@@ -1,8 +1,5 @@
 import type { ACodeConfigFile, ACodeSkillGroup, ACodeSkillMetadata } from './types.js';
 export declare function loadAcodeConfig(configPath: string | undefined): Promise<ACodeConfigFile>;
 export declare function loadAcodeSkills(skillsDir: string | undefined): Promise<ACodeSkillMetadata[]>;
-/**
- * 加载单个 skills 目录：返回目录路径、是否存在、以及该目录下的 skills 列表。
- * 目录不存在时返回 exists=false + 空 skills，供前端展示空节点。
- */
+
 export declare function loadAcodeSkillGroup(skillsDir: string): Promise<ACodeSkillGroup>;

package/package/acode/dist/fs-utils.d.ts

@@ -1,20 +1,2 @@
-/**
- * 对 `fs.rename` 做指数退避重试，仅针对 Windows 上目标被打开时
- * 的瞬时错误（EPERM/EBUSY/EACCES/ENOTEMPTY）。
- *
- * 其他错误（ENOENT 源不存在、ENOSPC 磁盘满等）直接抛出，不重试。
- *
- * ★ Windows EPERM 终极兜底：若全部重试仍失败（target 持续被 reader 持有 fd），
- *   fallback 到 `fs.copyFile(src, dest) + fs.unlink(src)`。
- *   - `fs.copyFile` 在 Windows 上走 `CopyFileEx` API，允许覆盖被其他进程打开的
- *     target（只要 reader 共享模式允许读，fs.readFile 默认如此），能绕开 EPERM。
- *   - 代价是失去原子性：写入过程中崩溃可能产生半成品 dest。
- *     但 sub-agent 记录非关键数据，配合 SubAgentStore.read() 的
- *     `SyntaxError → empty` 容错已够用（最坏情况是列表暂时少一条历史）。
- *   - POSIX 上 rename 重试一般不会失败（原子操作），fallback 路径极少触发。
- *
- * @param src 源文件路径（通常是 `.tmp` 临时文件）
- * @param dest 目标文件路径
- * @returns 成功时 resolve，全部重试都失败时 reject 最后一次错误
- */
+
 export declare function renameWithRetry(src: string, dest: string): Promise<void>;

package/package/acode/dist/hooks/hookBus.d.ts

@@ -9,10 +9,7 @@ export declare class ACodeHookBus {
     private readonly handlers;
     constructor(options: ACodeHookBusOptions);
     register(handler: ACodeHookHandler): void;
-    /**
-     * 分发 ACode 生命周期 Hook。
-     * 主流程：按注册顺序执行 handler -> fail-open 记录错误 -> 遇到 deny 立即返回。
-     */
+    
     dispatch(name: ACodeHookEventName, data: Record<string, unknown>): Promise<ACodeHookResult[]>;
 }
 export declare function findDeniedHookResult(results: readonly ACodeHookResult[]): ACodeHookResult | undefined;

package/package/acode/dist/mcpToolNames.d.ts

@@ -1,10 +1,4 @@
-/**
- * Main flow: normalize common MCP separators, then use the final segment as
- * the semantic tool name that controls timeout policy.
- */
+
 export declare function getSemanticToolName(toolName: string): string;
-/**
- * Main flow: classify only exact polling tool names so similarly named tools
- * keep the regular MCP timeout.
- */
+
 export declare function isMcpPollingToolName(toolName: string): boolean;

package/package/acode/dist/parsers/ast-cache.d.ts

@@ -1,32 +1,19 @@
 import type { Tree } from "web-tree-sitter";
-/**
- * AST 缓存：LRU + mtime/size 失效。
- *
- * 设计要点：
- *  - cache key 用 path + mtimeMs + size 三重校验，mtime 秒级精度不够时 size 兜底
- *  - LRU 用 JS Map 的插入顺序语义实现：命中时 delete+set 让它变最新
- *  - tree-sitter 的 Tree 是 WASM 对象，必须显式 tree.delete()，不归 V8 GC 管
- *  - capacity 默认 100，淘汰最旧时调 tree.delete() 释放 WASM 内存
- */
+
 export declare class AstCache {
     private map;
     private readonly capacity;
     constructor(capacity?: number);
-    /**
-     * 取缓存。mtimeMs 或 size 不匹配则视为 stale，删除并返回 null。
-     */
+    
     get(absolutePath: string, mtimeMs: number, size: number): Tree | null;
-    /**
-     * 存缓存。若 key 已存在则覆盖（旧 tree 释放）。
-     * 超容量时淘汰最旧（Map 的 keys().next().value）。
-     */
+    
     set(absolutePath: string, tree: Tree, language: string, mtimeMs: number, size: number): void;
-    /** 主动失效：删除并释放 tree */
+    
     invalidate(absolutePath: string): void;
-    /** 清空所有缓存并释放所有 tree */
+    
     clear(): void;
-    /** 当前缓存条目数（测试用） */
+    
     size(): number;
 }
-/** 进程级单例，容量 100 */
+
 export declare const astCache: AstCache;

package/package/acode/dist/parsers/language-detector.d.ts

@@ -1,6 +1,2 @@
-/**
- * 根据文件扩展名检测 tree-sitter language 名。
- * 大小写不敏感（扩展名统一转小写后查表）。
- * 未知扩展名返回 null。
- */
+
 export declare function detectLanguage(filePath: string): string | null;

package/package/acode/dist/parsers/language-queries.d.ts

@@ -1,4 +1,4 @@
 import type { LanguageQueryPack } from "./types.js";
 export declare const LANGUAGE_QUERIES: Record<string, LanguageQueryPack>;
-/** 所有支持的语言名（15 项，含 tsx/jsx） */
+
 export declare const SUPPORTED_LANGUAGES: string[];

package/package/acode/dist/parsers/tree-sitter-loader.d.ts

@@ -1,17 +1,9 @@
 import { Parser, Language } from "web-tree-sitter";
-/**
- * 懒初始化 Parser 单例。
- * web-tree-sitter v0.25 要求在 new Parser() 之前显式 await Parser.init()
- * 完成 WASM 运行时初始化，否则抛 "cannot construct a Parser before calling init()"。
- */
+
 export declare function getParser(): Promise<Parser>;
-/**
- * 懒加载语言 grammar。
- * 已加载的 language 直接复用 Map 缓存。
- * WASM 损坏或不存在返回 null（不抛异常，由 extractor 决定回退）。
- */
+
 export declare function loadLanguage(language: string): Promise<Language | null>;
-/** 查询某语言 grammar 是否已加载（测试用） */
+
 export declare function isLanguageLoaded(language: string): boolean;
-/** 重置 loader 状态（仅测试用：清空 parser 和 language 缓存） */
+
 export declare function resetLoader(): Promise<void>;

package/package/acode/dist/parsers/types.d.ts

@@ -1,60 +1,49 @@
-/**
- * tree-sitter symbols 工具的共享类型定义。
- *
- * SymbolKind 统一映射 13 种语言的 AST 节点类型，
- * 让 agent 不需要关心具体语言的节点名差异。
- */
-/** 符号类型（跨语言统一映射） */
+
+
 export type SymbolKind = "function" | "class" | "method" | "variable" | "import" | "error";
-/** 查询模式 */
+
 export type SymbolMode = "definitions" | "references" | "outline";
-/**
- * 单个符号结果。
- *
- * kind 语义：
- *  - definitions/outline 模式下：声明类型
- *  - references 模式下：被引用符号的类型（如对函数的调用 kind="function"）
- */
+
 export interface SymbolResult {
     kind: SymbolKind;
     name: string;
-    /** 1-based 起始行 */
+    
     line: number;
-    /** 1-based 结束行（definitions/outline 才有） */
+    
     endLine?: number;
-    /** 1-based 起始列 */
+    
     column?: number;
-    /** 函数签名/类声明头部（definitions/outline 才有） */
+    
     signature?: string;
-    /** 引用所在行的源码文本（references 模式才有） */
+    
     context?: string;
 }
-/** outline 模式下的嵌套节点 */
+
 export interface OutlineNode extends SymbolResult {
     children?: OutlineNode[];
 }
-/** symbols 工具的统一响应外壳 */
+
 export interface SymbolsResponse {
     ok: boolean;
     tool: "symbols";
-    /** workspace-relative 路径 */
+    
     path: string;
     mode: SymbolMode;
-    /** "typescript" | "python" | ... | "unknown" */
+    
     language: string;
     symbols: SymbolResult[];
     truncated: boolean;
-    /** 解析失败/不支持时的错误说明 */
+    
     error?: string;
 }
-/** 单条 query 模板定义 */
+
 export interface QueryPattern {
-    /** S-expression 查询字符串 */
+    
     query: string;
-    /** 匹配节点的 kind */
+    
     kind: SymbolKind;
-    /** 是否带 endLine（definitions/outline 才有） */
+    
     hasEndLine?: boolean;
 }
-/** 每语言的 query 模板集合 */
+
 export type LanguageQueryPack = Record<SymbolMode, QueryPattern[]>;