@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

package/cli/dist-server/types/node/memory/memory-extraction-service.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Memory Extraction Service — 与 Claude Code extractMemories.ts 对齐
+ *
+ * 对话结束后，自动从对话中提取值得记住的信息并保存到记忆目录。
+ * 使用 PromptSuggestionService 的架构模式（复用 RunState + RunnerProvider）。
+ *
+ * 触发方式：通过 MemoryExtractionStopHook 在 HookEvent.STOP 时 fire-and-forget。
+ */
+import { RunnerProvider, Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { SettingsManager } from '../settings';
+export declare const MemoryExtractionService: unique symbol;
+export interface MemoryExtractionService {
+    /**
+     * 异步触发记忆提取（不阻塞）
+     */
+    extractAsync(session: Session): void;
+    /**
+     * 等待提取完成（headless 模式下使用）
+     */
+    waitForExtraction(): Promise<void>;
+    /**
+     * 检查功能是否启用
+     */
+    isEnabled(): Promise<boolean>;
+}
+export declare class MemoryExtractionServiceImpl implements MemoryExtractionService {
+    protected readonly runnerProvider: RunnerProvider;
+    protected readonly sessionManager: SessionManager;
+    protected readonly settingsManager: SettingsManager;
+    protected readonly logger: Logger;
+    /** 是否正在提取 — 防止并发 */
+    private inProgress;
+    /** 上一次提取处理到的消息 UUID */
+    private lastMemoryMessageUuid?;
+    protected init(): void;
+    isEnabled(): Promise<boolean>;
+    /** 最近一次提取的 Promise，用于 headless 模式等待完成 */
+    private lastExtractionPromise?;
+    extractAsync(session: Session): void;
+    /** 等待提取完成（headless 模式下使用） */
+    waitForExtraction(): Promise<void>;
+    private doExtract;
+    /**
+     * 计算自上次提取以来的新消息数量
+     */
+    private countNewMessages;
+    /**
+     * 检查主 agent 是否已写入记忆文件
+     */
+    private hasMemoryWritesSince;
+    /**
+     * 推进 cursor 到最新消息
+     */
+    private advanceCursor;
+}

package/cli/dist-server/types/node/memory/memory-extraction-stop-hook.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Memory Extraction Stop Hook
+ *
+ * 在主 agent 完成回复后触发记忆提取。
+ * 与 Claude Code 的 executeExtractMemories 在 handleStopHooks 中的行为对齐。
+ *
+ * 交互模式: fire-and-forget，不阻塞 UI
+ * Headless模式: await 提取完成，确保进程退出前提取执行完毕
+ */
+import { Hook, HookInput, HookPriority } from '../hooks/hook-protocol';
+import { HookEvent, HookExecutionResult } from '../../vendor/cbc-shared/node/index.js';
+import { MemoryExtractionService } from './memory-extraction-service';
+export declare class MemoryExtractionStopHook implements Hook {
+    readonly event = HookEvent.STOP;
+    readonly priority = HookPriority.Low;
+    protected readonly extractionService?: MemoryExtractionService;
+    execute(input: HookInput): Promise<HookExecutionResult | undefined>;
+}

package/cli/dist-server/types/node/memory/memory-freshness-post-tool-hook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Memory Freshness PostToolUse Hook
+ *
+ * 当 Read 工具读取记忆目录中的文件时，自动在 response 末尾追加陈旧警告。
+ * 与 Claude Code FileReadTool 中的 memoryFreshnessNote 对齐。
+ *
+ * 触发条件：PostToolUse + matcher="Read" + file_path 在 memory 目录内
+ */
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { Hook, HookInput, HookPriority } from '../hooks/hook-protocol';
+import { HookEvent, HookExecutionResult } from '../../vendor/cbc-shared/node/index.js';
+export declare class MemoryFreshnessPostToolHook implements Hook {
+    readonly event = HookEvent.POST_TOOL_USE;
+    readonly priority = HookPriority.Normal;
+    readonly matcher = "Read";
+    protected readonly logger: Logger;
+    execute(input: HookInput): Promise<HookExecutionResult | undefined>;
+    /**
+     * 检查文件路径是否在记忆目录中
+     */
+    private isMemoryPath;
+}

package/cli/dist-server/types/node/memory/memory-loader.d.ts

@@ -0,0 +1,62 @@
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { Memory, MemoryLoader, MemoryParser, MemoryValidator } from './memory-protocol';
+export declare class MemoryLoaderImpl implements MemoryLoader {
+    protected readonly parser: MemoryParser;
+    protected readonly validator: MemoryValidator;
+    protected readonly logger: Logger;
+    protected initialize(): void;
+    loadAll(): Promise<Memory[]>;
+    /**
+     * Map MemoryScope → Claude Code InstructionsLoaded.memory_type.
+     */
+    private mapScopeToMemoryType;
+    /**
+     * Fire InstructionsLoaded hooks for each loaded memory file.
+     * Skips silently when HookManager is unavailable or no hooks are configured.
+     */
+    private dispatchInstructionsLoadedHooks;
+    /**
+     * 加载用户级别的 memory
+     */
+    private loadUserMemories;
+    /**
+     * 加载项目级别的 memory
+     */
+    private loadProjectMemories;
+    /**
+     * 加载本地 memory
+     */
+    private loadLocalMemories;
+    /**
+     * 加载项目主文件
+     */
+    private loadProjectMainFiles;
+    /**
+     * 加载单个 memory 文件
+     */
+    private loadFile;
+    /**
+     * 解析文件真实路径
+     */
+    private resolveRealPath;
+    /**
+     * 检查是否可以加载（循环引用和深度检查）
+     */
+    private canLoad;
+    /**
+     * 加载 memory 中的 import 引用
+     */
+    private loadImports;
+    /**
+     * 处理加载错误
+     */
+    private handleLoadError;
+    /**
+     * 加载目录下的所有 memory 文件
+     */
+    private loadDirectory;
+    /**
+     * 检查是否是支持的文件类型
+     */
+    private isSupportedFile;
+}

package/cli/dist-server/types/node/memory/memory-manager.d.ts

@@ -0,0 +1,24 @@
+import { Logger } from '@celljs/core';
+import { GetMemoryOptions, Memory, MemoryCache, MemoryLoader, MemoryManager, MemoryScope } from './memory-protocol';
+export declare class MemoryManagerImpl implements MemoryManager {
+    protected readonly memoryLoader: MemoryLoader;
+    protected readonly memoryCache: MemoryCache;
+    protected readonly logger: Logger;
+    protected initialize(): void;
+    get(options?: GetMemoryOptions): Promise<Memory[]>;
+    addFact(fact: string, scope: MemoryScope): Promise<void>;
+    write(content: string, scope: MemoryScope): Promise<void>;
+    clear(): void;
+    /**
+     * 根据选项过滤 memory 列表
+     */
+    private filterMemories;
+    /**
+     * 将新项插入到 memory section 中
+     */
+    private insertIntoMemorySection;
+    /**
+     * 确保内容末尾有正确的换行分隔
+     */
+    private ensureNewlineSeparation;
+}

package/cli/dist-server/types/node/memory/memory-parser.d.ts

@@ -0,0 +1,15 @@
+import { Memory, MemoryParseOptions, MemoryParser } from './memory-protocol';
+/**
+ * 解析 YAML frontmatter（独立函数，供 memory-scan 使用）
+ *
+ * @param content 文件内容
+ * @returns frontmatter 对象，如果解析失败返回 undefined
+ */
+export declare function parseYamlFrontmatter(content: string): Record<string, unknown> | undefined;
+export declare class MemoryParserImpl implements MemoryParser {
+    parse(filePath: string, options: MemoryParseOptions): Promise<Memory>;
+    /**
+     * 解析 frontmatter 中的 globs
+     */
+    private parseGlobs;
+}

package/cli/dist-server/types/node/memory/memory-prompt-builder.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Memory Prompt Builder — 与 Claude Code memdir.ts 的 buildMemoryLines/buildMemoryPrompt 对齐
+ *
+ * 构建结构化记忆系统的 prompt 指导文本。
+ */
+/**
+ * 截断 MEMORY.md 内容到行数和字节数限制
+ */
+export declare function truncateEntrypointContent(raw: string): {
+    content: string;
+    lineCount: number;
+    /** UTF-16 code units 长度，作为近似字节数使用 */
+    charCount: number;
+    wasLineTruncated: boolean;
+    wasCharTruncated: boolean;
+};
+/**
+ * 构建记忆系统行为指导文本（不含 MEMORY.md 内容）
+ *
+ * 与 Claude Code 的 buildMemoryLines() 对齐。
+ *
+ * @param displayName 显示名称（如 "auto memory"）
+ * @param memoryDir 记忆目录路径
+ * @param projectId 项目 ID
+ * @param extraGuidelines 额外指导（可选）
+ */
+export declare function buildMemoryLines(displayName: string, memoryDir: string, projectId: string, extraGuidelines?: string[]): string[];
+/**
+ * 构建完整的记忆 prompt（含 MEMORY.md 内容）
+ *
+ * 与 Claude Code 的 buildMemoryPrompt() 对齐。
+ */
+export declare function buildMemoryPrompt(params: {
+    displayName: string;
+    memoryDir: string;
+    projectId: string;
+    extraGuidelines?: string[];
+}): string;

package/cli/dist-server/types/node/memory/memory-protocol.d.ts

@@ -0,0 +1,235 @@
+export declare const MemoryManager: unique symbol;
+export declare const MemoryLoader: unique symbol;
+export declare const MemoryParser: unique symbol;
+export declare const MemoryCache: unique symbol;
+export declare const MemoryValidator: unique symbol;
+export declare const GlobMatcher: unique symbol;
+export declare const SubdirectoryMemoryLoader: unique symbol;
+export declare const ConditionalRulesService: unique symbol;
+export declare const AGENTS_FILENAME = "AGENTS.md";
+export declare const AGENTS_FILENAME_MDC = "AGENTS.mdc";
+export declare const MAX_MEMORY_FILE_SIZE = 40000;
+/**
+ * 运行时解析 Memory / 指令文件名族：
+ * - 定制版 baseName 由 `instructionFiles.baseName` 提供（如 XXXCODE → XXXCODE.md 族）；
+ * - 无外置配置时回落官方 CODEBUDDY 族；
+ * - `AGENTS.md` 是跨产品行业兼容文件名，固定不派生。
+ *
+ * 关于旧文件名兼容：
+ * - 本函数只返回**当前生效的**文件名族；
+ * - 用户级旧数据（`~/.codebuddy/CODEBUDDY.md` 等）由启动期一次性复制迁移处理（`legacyReadFallback` 开关），
+ *   项目级旧文件名不做回落读取（定制版与官方版完全解耦）。
+ */
+export declare function resolveMemoryFileNames(): {
+    MEMORY_FILENAME: string;
+    MEMORY_FILENAME_MDC: string;
+    MEMORY_LOCAL_FILENAME: string;
+    MEMORY_LOCAL_FILENAME_MDC: string;
+    baseName: string;
+};
+/** 官方默认 Memory section 标题（无外置配置时）。用于兼容读：用户从官方版升级后，
+ *  存量 MEMORY.md 里仍是旧官方标题，品牌化后的新标题匹配失败会重复追加 section。 */
+export declare const DEFAULT_MEMORY_SECTION_HEADER = "## CodeBuddy Added Memories";
+/** 运行时解析 Memory section 标题（`## <ProductName> Added Memories`）。 */
+export declare function resolveMemorySectionHeader(): string;
+export declare enum MemoryScope {
+    MANAGED = "managed",
+    USER = "user",
+    PROJECT = "project",
+    PROJECT_LOCAL = "project-local"
+}
+export declare enum MemoryType {
+    ALWAYS = "always",
+    MANUAL = "manual"
+}
+/**
+ * Memory 实体
+ */
+export interface Memory {
+    /** 文件路径 */
+    filePath: string;
+    /** 作用域 */
+    scope: MemoryScope;
+    /** 类型 */
+    type: MemoryType;
+    /** 内容 */
+    content: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** glob 匹配模式 */
+    globs?: string[];
+    /** 是否始终应用 */
+    alwaysApply?: boolean;
+    /** 被导入的来源文件列表 */
+    importedFrom?: string[];
+}
+/**
+ * 获取 memory 的选项
+ */
+export interface GetMemoryOptions {
+    scope?: MemoryScope;
+    type?: MemoryType;
+}
+/**
+ * Memory 参数
+ */
+export interface MemoryArgument {
+    fact: string;
+    scope: MemoryScope;
+}
+/**
+ * Memory 解析选项
+ */
+export interface MemoryParseOptions {
+    scope: MemoryScope;
+    autoGeneratedGlobs?: string[];
+}
+/**
+ * Memory frontmatter 定义
+ */
+export interface MemoryFrontmatter {
+    enabled?: boolean;
+    paths?: string | string[];
+    alwaysApply?: boolean;
+}
+/**
+ * 条件规则状态
+ */
+export interface ConditionalRulesState {
+    /** 待处理的触发路径 */
+    pendingTriggers: Set<string>;
+    /** 已处理的规则路径 */
+    processedRules: Set<string>;
+}
+/**
+ * 条件规则消费结果
+ */
+export interface ConsumeResult {
+    /** 生成的内容 */
+    content: string;
+    /** 匹配的规则数量 */
+    matchedCount: number;
+}
+/**
+ * Memory 管理器，负责获取、添加和写入 memory
+ */
+export interface MemoryManager {
+    /**
+     * 获取 memory 列表
+     * @param options 过滤选项
+     * @returns memory 列表
+     */
+    get(options?: GetMemoryOptions): Promise<Memory[]>;
+    /**
+     * 添加一条记忆
+     * @param fact 记忆内容
+     * @param scope 作用域
+     */
+    addFact(fact: string, scope: MemoryScope): Promise<void>;
+    /**
+     * 写入 memory 内容
+     * @param content 内容
+     * @param scope 作用域
+     */
+    write(content: string, scope: MemoryScope): Promise<void>;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+}
+/**
+ * Memory 加载器，负责从文件系统加载所有 memory
+ */
+export interface MemoryLoader {
+    /**
+     * 加载所有 memory
+     * @returns memory 列表
+     */
+    loadAll(): Promise<Memory[]>;
+}
+/**
+ * Memory 解析器，负责解析单个 memory 文件
+ */
+export interface MemoryParser {
+    /**
+     * 解析 memory 文件
+     * @param filePath 文件路径
+     * @param options 解析选项
+     * @returns 解析后的 memory
+     */
+    parse(filePath: string, options: MemoryParseOptions): Promise<Memory>;
+}
+/**
+ * Memory 缓存管理器
+ */
+export interface MemoryCache {
+    /**
+     * 获取缓存或加载 memory
+     * @param loader 加载器函数
+     * @returns memory 列表
+     */
+    getOrLoad(loader: () => Promise<Memory[]>): Promise<Memory[]>;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+}
+/**
+ * Glob 模式匹配器
+ */
+export interface GlobMatcher {
+    /**
+     * 检查文件路径是否匹配任意一个 glob 模式
+     * @param filePath 文件路径
+     * @param globs glob 模式列表
+     * @returns 是否匹配
+     */
+    matches(filePath: string, globs: string[]): boolean;
+}
+/**
+ * 子目录 memory 加载器，支持懒加载和 LRU 缓存
+ */
+export interface SubdirectoryMemoryLoader {
+    /**
+     * 根据文件路径加载对应目录链上的所有 memory
+     * @param filePaths 文件路径列表
+     * @returns 去重后的 memory 列表
+     */
+    loadForPaths(filePaths: string[]): Promise<Memory[]>;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+}
+/**
+ * 条件规则服务，负责根据文件路径匹配并注入规则
+ */
+export interface ConditionalRulesService {
+    /**
+     * 消费待处理的条件规则
+     * @param state 条件规则状态
+     * @returns 消费结果
+     */
+    consume(state: ConditionalRulesState): Promise<ConsumeResult>;
+}
+/**
+ * Memory 验证选项
+ */
+export interface MemoryValidateOptions {
+    /** 是否是被其他规则导入的（跳过 enabled 和 alwaysApply 检查） */
+    isImported?: boolean;
+    /** 是否是子目录 memory（跳过 alwaysApply 检查） */
+    isSubdirectory?: boolean;
+}
+/**
+ * Memory 验证器，负责验证 memory 是否有效
+ */
+export interface MemoryValidator {
+    /**
+     * 验证 memory 是否有效
+     * @param memory 要验证的 memory
+     * @param options 验证选项
+     * @returns 是否有效
+     */
+    validate(memory: Memory, options?: MemoryValidateOptions): boolean;
+}

package/cli/dist-server/types/node/memory/memory-relevance-protocol.d.ts

@@ -0,0 +1,33 @@
+export declare const MemoryRelevanceService: unique symbol;
+/**
+ * 相关记忆信息
+ */
+export interface RelevantMemory {
+    /** 绝对文件路径 */
+    path: string;
+    /** 修改时间戳 (ms) */
+    mtimeMs: number;
+}
+/**
+ * 记忆相关性选择服务
+ *
+ * 使用 AI 模型从记忆目录中选择与当前查询最相关的记忆（最多 5 个）。
+ * 参考 Claude Code 的 findRelevantMemories 实现。
+ */
+export interface MemoryRelevanceService {
+    /**
+     * 选择与查询相关的记忆
+     *
+     * @param query 用户查询
+     * @param memoryDir 记忆目录路径
+     * @param recentTools 最近使用的工具名称列表
+     * @param alreadySurfaced 已经展示过的记忆路径集合
+     * @param signal 中断信号
+     * @returns 相关记忆列表（最多 5 个）
+     */
+    selectRelevantMemories(query: string, memoryDir: string, recentTools?: readonly string[], alreadySurfaced?: ReadonlySet<string>, signal?: AbortSignal): Promise<RelevantMemory[]>;
+    /**
+     * 检查功能是否启用
+     */
+    isEnabled(): Promise<boolean>;
+}

package/cli/dist-server/types/node/memory/memory-relevance-service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Memory Relevance Service — 使用 AI 语义匹配选择相关记忆
+ *
+ * 通过 memorySelector agent（product.json 配置，lite 模型）进行语义筛选：
+ * - 轻量单次调用，不需要对话历史
+ * - 返回最多 5 个相关记忆
+ */
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { SessionManager } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { MemoryRelevanceService, RelevantMemory } from './memory-relevance-protocol';
+export declare class MemoryRelevanceServiceImpl implements MemoryRelevanceService {
+    protected readonly settingsManager: SettingsManager;
+    protected readonly sessionManager: SessionManager;
+    protected readonly logger: Logger;
+    protected init(): void;
+    isEnabled(): Promise<boolean>;
+    selectRelevantMemories(query: string, memoryDir: string, recentTools?: readonly string[], alreadySurfaced?: ReadonlySet<string>, signal?: AbortSignal): Promise<RelevantMemory[]>;
+    /**
+     * 使用 memorySelector agent 进行 AI 语义匹配
+     *
+     * agent 在 product.json 中注册（instructions 引用 memory-selector-instructions 模板），
+     * 通过 agentService.runOneTime 调用，和 terminalTitleGenerator 等 agent 一致。
+     *
+     * ESC 取消支持：由于 runOneTime 会创建自己的 abortController 覆盖 options.signal，
+     * 外部 signal 无法直接中断内部的 runner.run。这里显式创建一个 ephemeral session
+     * 并桥接外部 signal 到它的 abortController，使主会话 ESC 能中断 memorySelector。
+     */
+    private doAISelection;
+}

package/cli/dist-server/types/node/memory/memory-scan.d.ts

@@ -0,0 +1,35 @@
+import { type MemorySemanticType } from './memory-types';
+/**
+ * 记忆文件头信息
+ */
+export interface MemoryHeader {
+    /** 相对于 memoryDir 的文件名 */
+    filename: string;
+    /** 绝对文件路径 */
+    filePath: string;
+    /** 文件修改时间戳 (ms) */
+    mtimeMs: number;
+    /** frontmatter 中的 description */
+    description: string | null;
+    /** 语义类型 */
+    type: MemorySemanticType | undefined;
+    /** frontmatter 中的 name */
+    name: string | null;
+}
+/**
+ * 扫描记忆目录，提取所有 .md 文件的 frontmatter 信息
+ *
+ * @param memoryDir 记忆目录路径
+ * @param signal 中断信号
+ * @returns 按修改时间排序的记忆头列表（最新在前，最多 MAX_MEMORY_FILES 个）
+ */
+export declare function scanMemoryFiles(memoryDir: string, signal?: AbortSignal): Promise<MemoryHeader[]>;
+/**
+ * 格式化记忆清单文本
+ *
+ * 用于提供给 AI 模型进行相关性选择
+ *
+ * @param memories 记忆头列表
+ * @returns 格式化的清单文本
+ */
+export declare function formatMemoryManifest(memories: MemoryHeader[]): string;

package/cli/dist-server/types/node/memory/memory-types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Memory Type Taxonomy — 与 Claude Code memoryTypes.ts 对齐
+ *
+ * 记忆被约束为四种类型，捕获无法从当前项目状态中推导出的上下文。
+ * 代码模式、架构、git 历史和文件结构是可推导的（通过 grep/git/CODEBUDDY.md），
+ * 不应作为记忆保存。
+ */
+export declare const MEMORY_SEMANTIC_TYPES: readonly ["user", "feedback", "project", "reference"];
+export type MemorySemanticType = (typeof MEMORY_SEMANTIC_TYPES)[number];
+/**
+ * 解析 frontmatter 中的记忆类型
+ */
+export declare function parseMemorySemanticType(raw: unknown): MemorySemanticType | undefined;
+/**
+ * `## Types of memory` — 个人模式（单目录）
+ * 无 <scope> 标签，示例使用 `[saves X memory: …]`
+ */
+export declare const TYPES_SECTION_INDIVIDUAL: readonly string[];
+/**
+ * `## What NOT to save in memory`
+ *
+ * 改为函数：resolveInstructionBaseName() 读取 customization.json snapshot，
+ * 模块级常量会在 import 时固化值，定制版场景下可能拿到错误的 baseName。
+ */
+export declare function getWhatNotToSaveSection(): readonly string[];
+/**
+ * 记忆漂移警告
+ */
+export declare const MEMORY_DRIFT_CAVEAT = "- Memory records can become stale over time. Use memory as context for what was true at a given point in time. Before answering the user or building assumptions based solely on information in memory records, verify that the memory is still correct and up-to-date by reading the current state of the files or resources. If a recalled memory conflicts with current information, trust what you observe now \u2014 and update or remove the stale memory rather than acting on it.";
+/**
+ * `## When to access memories`
+ */
+export declare const WHEN_TO_ACCESS_SECTION: readonly string[];
+/**
+ * `## Before recommending from memory`
+ *
+ * 验证记忆中的具体声明（文件路径、函数名等）是否仍然存在。
+ */
+export declare const TRUSTING_RECALL_SECTION: readonly string[];
+/**
+ * Frontmatter 格式示例
+ */
+export declare const MEMORY_FRONTMATTER_EXAMPLE: readonly string[];
+/**
+ * MEMORY.md 入口名称和限制
+ */
+export declare const ENTRYPOINT_NAME = "MEMORY.md";
+export declare const MAX_ENTRYPOINT_LINES = 200;
+export declare const MAX_ENTRYPOINT_BYTES = 40000;

package/cli/dist-server/types/node/memory/memory-validator.d.ts

@@ -0,0 +1,6 @@
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { Memory, MemoryValidateOptions, MemoryValidator } from './memory-protocol';
+export declare class MemoryValidatorImpl implements MemoryValidator {
+    protected readonly logger: Logger;
+    validate(memory: Memory, options?: MemoryValidateOptions): boolean;
+}