remnote-bridge 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 remnote-bridge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# remnote-bridge
+
+[中文文档](./README_CN.md)
+
+Bridge toolkit that exposes your RemNote knowledge base to AI agents. Single package — CLI, MCP Server, and Plugin all in one.
+
+## Install
+
+```bash
+npm install -g remnote-bridge
+```
+
+## Quick Start
+
+```bash
+# 1. Start the daemon (launches WS server + plugin dev server)
+remnote-bridge connect
+
+# 2. Load the plugin in RemNote
+#    Open RemNote → Settings → Plugins → Add Local Plugin
+#    Enter: http://localhost:8080
+
+# 3. Check system status
+remnote-bridge health
+
+# 4. Explore your knowledge base
+remnote-bridge read-globe                    # Global document overview
+remnote-bridge read-context                  # Current focus in RemNote
+remnote-bridge search "machine learning"     # Full-text search
+remnote-bridge read-tree <remId>             # Expand a subtree
+remnote-bridge read-rem <remId>              # Read Rem properties
+
+# 5. Edit content
+remnote-bridge edit-rem <remId> --old-str '"concept"' --new-str '"descriptor"'
+remnote-bridge edit-tree <remId> --old-str '  old line <!--id-->' --new-str '  new line\n  old line <!--id-->'
+
+# 6. Stop the daemon
+remnote-bridge disconnect
+```
+
+## Commands
+
+### Infrastructure
+
+| Command | Description |
+|:--------|:------------|
+| `connect` | Start the daemon process (WS server + plugin dev server) |
+| `health` | Check daemon, Plugin, and SDK status |
+| `disconnect` | Stop the daemon and release resources |
+
+### Read
+
+| Command | Description | Caches |
+|:--------|:------------|:-------|
+| `read-globe` | Global document-level overview | No |
+| `read-context` | Current focus/page context view | No |
+| `read-tree <remId>` | Subtree as Markdown outline | Yes |
+| `read-rem <remId>` | Single Rem's full JSON properties | Yes |
+| `search <query>` | Full-text search | No |
+
+### Write
+
+| Command | Description | Prerequisite |
+|:--------|:------------|:-------------|
+| `edit-rem <remId>` | Edit Rem JSON fields via str_replace | `read-rem` first |
+| `edit-tree <remId>` | Edit tree structure via str_replace | `read-tree` first |
+
+### Utilities
+
+| Command | Description |
+|:--------|:------------|
+| `mcp` | Start the MCP Server (stdio transport) |
+| `install skill` | Install Claude Code skill to `~/.claude/skills/remnote-bridge/` |
+
+## MCP Server
+
+Use `remnote-bridge mcp` as an MCP server for AI clients:
+
+```json
+{
+  "mcpServers": {
+    "remnote-bridge": {
+      "command": "remnote-bridge",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+The MCP server exposes all CLI commands as tools, plus documentation resources.
+
+## Claude Code Skill
+
+```bash
+remnote-bridge install skill
+```
+
+Installs the skill to `~/.claude/skills/remnote-bridge/`, enabling Claude Code to operate your RemNote knowledge base through natural language.
+
+## JSON Mode
+
+All commands support `--json` for programmatic usage. In JSON mode, both input and output are JSON:
+
+```bash
+# Input: all parameters packed in a JSON string
+remnote-bridge --json read-rem '{"remId":"abc123","fields":["text","type"]}'
+
+# Output: single-line JSON
+# {"ok":true,"command":"read-rem","timestamp":"...","data":{...}}
+```
+
+## Architecture
+
+```
+AI Agent (Claude Code / MCP Client)
+    ↕  CLI commands (stateless short processes)
+remnote-bridge CLI
+    ↕  WebSocket IPC
+Daemon (long-lived process: WS server + handlers + cache)
+    ↕  WebSocket
+remnote-plugin (runs inside RemNote browser)
+    ↕
+RemNote SDK → Knowledge Base
+```
+
+- **CLI commands** are stateless — each invocation is an independent OS process
+- **Daemon** holds state: cache, WS connections, timeout timer
+- **Plugin** runs in the browser, calls RemNote SDK on behalf of the daemon
+- **Three safety guards** protect edits: cache existence check, optimistic concurrency detection, str_replace exact match
+
+## Configuration
+
+Optional config file: `.remnote-bridge.json` in project root.
+
+```json
+{
+  "wsPort": 3002,
+  "devServerPort": 8080,
+  "configPort": 3003,
+  "daemonTimeoutMinutes": 30,
+  "defaults": {
+    "maxNodes": 200,
+    "maxSiblings": 20,
+    "readTreeDepth": 3
+  }
+}
+```
+
+All values have sensible defaults — the config file is not required.
+
+## Acknowledgements
+
+This project was inspired by and learned from:
+
+- [remnote-mcp-bridge](https://github.com/quentintou/remnote-mcp-bridge) by [@quentintou](https://github.com/quentintou) — The original MCP bridge connecting RemNote to AI assistants. Pioneered the idea of bridging RemNote SDK to external tools via MCP.
+- [remnote-mcp-bridge (fork)](https://github.com/robert7/remnote-mcp-bridge) by [@robert7](https://github.com/robert7) — Extended the original with a generic, extensible WebSocket bridge architecture. Its Plugin ↔ WebSocket ↔ CLI layered design gave us valuable architectural insights.
+
+## Roadmap
+
+- **MCP tool decomposition** — Break the current 1:1 CLI-to-MCP mapping into finer-grained tools, giving AI agents more flexible and composable operations
+- **Improved agent instructions** — Refine Skill documentation and MCP server instructions for better AI agent comprehension
+- **RAG-powered search** — Research RemNote's local database structure to enable retrieval-augmented search, replacing the current SDK-based full-text search with more efficient semantic retrieval
+- **Multi-language support** — Internationalization for broader accessibility
+
+## License
+
+MIT

package/dist/cli/main.js

@@ -53,7 +53,7 @@ function parseJsonInput(command, jsonStr, requiredFields = []) {
 program
     .name('remnote-bridge')
     .description('RemNote Bridge — CLI + MCP Server + Plugin')
-    .version('0.1.0')
+    .version('0.1.1')
     .option('--json', '以 JSON 格式输出（适用于程序化调用）');
 program
     .command('connect')

package/dist/mcp/index.js

@@ -17,7 +17,7 @@ import { SEPARATOR_FLASHCARD_CONTENT } from './resources/separator-flashcard.js'
 export async function startMcpServer() {
     const server = new FastMCP({
         name: 'remnote-bridge',
-        version: '0.1.0',
+        version: '0.1.1',
         instructions: SERVER_INSTRUCTIONS,
     });
     registerInfraTools(server);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remnote-bridge",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "RemNote 自动化桥接工具集：CLI + MCP Server + Plugin",
   "type": "module",
   "bin": {
@@ -8,8 +8,15 @@
     "unofficial-remnote-bridge": "./dist/cli/main.js"
   },
   "files": [
-    "dist/",
-    "remnote-plugin/src/",
+    "dist/**/*.js",
+    "remnote-plugin/src/bridge/",
+    "remnote-plugin/src/services/",
+    "remnote-plugin/src/utils/",
+    "remnote-plugin/src/widgets/",
+    "remnote-plugin/src/index.css",
+    "remnote-plugin/src/style.css",
+    "remnote-plugin/src/settings.ts",
+    "remnote-plugin/src/types.ts",
     "remnote-plugin/public/",
     "remnote-plugin/package.json",
     "remnote-plugin/postcss.config.js",
@@ -31,6 +38,7 @@
     "fastmcp": "latest",
     "zod": "^3.23.0"
   },
+  "license": "MIT",
   "devDependencies": {
     "typescript": "^5.4.0",
     "tsx": "^4.7.0",

package/dist/cli/commands/connect.d.ts

@@ -1,12 +0,0 @@
-/**
- * connect 命令
- *
- * 启动后台守护进程（WS Server + webpack-dev-server），等待 Plugin 连接。
- * - 已在运行 → 打印提示，退出码 0
- * - stale PID → 清理后正常启动
- * - 启动失败 → 退出码 1
- */
-export interface ConnectOptions {
-    json?: boolean;
-}
-export declare function connectCommand(options?: ConnectOptions): Promise<void>;

package/dist/cli/commands/disconnect.d.ts

@@ -1,11 +0,0 @@
-/**
- * disconnect 命令
- *
- * 停止守护进程，释放端口和资源。
- * - 守护进程运行中 → 发送 SIGTERM，等待退出
- * - 守护进程未运行 → 打印提示，退出码 0
- */
-export interface DisconnectOptions {
-    json?: boolean;
-}
-export declare function disconnectCommand(options?: DisconnectOptions): Promise<void>;

package/dist/cli/commands/edit-rem.d.ts

@@ -1,13 +0,0 @@
-/**
- * edit-rem 命令
- *
- * 通过 str_replace 编辑 Rem 的 JSON 序列化。
- * 三道防线保证安全：缓存存在性、并发检测、精确匹配。
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface EditRemOptions {
-    json?: boolean;
-    oldStr: string;
-    newStr: string;
-}
-export declare function editRemCommand(remId: string, options: EditRemOptions): Promise<void>;

package/dist/cli/commands/edit-tree.d.ts

@@ -1,14 +0,0 @@
-/**
- * edit-tree 命令
- *
- * 通过 str_replace 编辑 Rem 子树结构（行级增/删/移/重排）。
- * - 禁止修改已有行内容（走 edit-rem）
- * - --json 结构化 JSON 输出
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface EditTreeOptions {
-    json?: boolean;
-    oldStr: string;
-    newStr: string;
-}
-export declare function editTreeCommand(remId: string, options: EditTreeOptions): Promise<void>;

package/dist/cli/commands/health.d.ts

@@ -1,12 +0,0 @@
-/**
- * health 命令
- *
- * 检查守护进程、Plugin 连接、SDK 状态，输出 ✅/❌ 列表。
- * - 全部健康 → 退出码 0
- * - 部分不健康 → 退出码 1
- * - 守护进程不可达 → 退出码 2
- */
-export interface HealthOptions {
-    json?: boolean;
-}
-export declare function healthCommand(options?: HealthOptions): Promise<void>;

package/dist/cli/commands/install-skill.d.ts

@@ -1,6 +0,0 @@
-/**
- * install skill 命令
- *
- * 将 SKILL.md 和 docs/instruction/*.md 安装到 ~/.claude/skills/remnote-bridge/
- */
-export declare function installSkillCommand(): Promise<void>;

package/dist/cli/commands/read-context.d.ts

@@ -1,20 +0,0 @@
-/**
- * read-context 命令
- *
- * 读取当前上下文视图。
- * - --mode focus|page（默认 focus）
- * - --ancestor-levels N 向上追溯几层祖先（默认 2，仅 focus 模式）
- * - --depth N 展开深度（默认 3，仅 page 模式）
- * - --max-nodes N 全局节点上限（默认 200）
- * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface ReadContextOptions {
-    json?: boolean;
-    mode?: string;
-    ancestorLevels?: string;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-}
-export declare function readContextCommand(options?: ReadContextOptions): Promise<void>;

package/dist/cli/commands/read-globe.d.ts

@@ -1,16 +0,0 @@
-/**
- * read-globe 命令
- *
- * 读取知识库全局概览（仅 Document 层级）。
- * - --depth N 控制 Document 嵌套深度（默认 -1 无限）
- * - --max-nodes N 全局节点上限（默认 200）
- * - --max-siblings N 每个父节点下展示的 children 上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface ReadGlobeOptions {
-    json?: boolean;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-}
-export declare function readGlobeCommand(options?: ReadGlobeOptions): Promise<void>;

package/dist/cli/commands/read-rem.d.ts

@@ -1,16 +0,0 @@
-/**
- * read-rem 命令
- *
- * 读取单个 Rem 的完整 JSON 对象。
- * - 默认输出 [RW] + [R] 字段（34 个）
- * - --full 输出全部 51 个字段（含 [R-F]）
- * - --fields 指定输出字段子集
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface ReadRemOptions {
-    json?: boolean;
-    fields?: string;
-    full?: boolean;
-    includePowerup?: boolean;
-}
-export declare function readRemCommand(remId: string, options?: ReadRemOptions): Promise<void>;

package/dist/cli/commands/read-tree.d.ts

@@ -1,17 +0,0 @@
-/**
- * read-tree 命令
- *
- * 读取 Rem 子树并序列化为带缩进的 Markdown 大纲。
- * - --depth N 控制展开深度（默认 3，-1 = 全部展开）
- * - --json 结构化 JSON 输出
- * - 退出码：0 成功 / 1 业务错误 / 2 守护进程不可达
- */
-export interface ReadTreeOptions {
-    json?: boolean;
-    depth?: string;
-    maxNodes?: string;
-    maxSiblings?: string;
-    ancestorLevels?: string;
-    includePowerup?: boolean;
-}
-export declare function readTreeCommand(remId: string, options?: ReadTreeOptions): Promise<void>;

package/dist/cli/commands/search.d.ts

@@ -1,12 +0,0 @@
-/**
- * search 命令
- *
- * 在知识库中按文本搜索 Rem。
- * - --limit N 结果数量上限（默认 20）
- * - --json 结构化 JSON 输出
- */
-export interface SearchOptions {
-    json?: boolean;
-    limit?: string;
-}
-export declare function searchCommand(query: string, options?: SearchOptions): Promise<void>;

package/dist/cli/config.d.ts

@@ -1,55 +0,0 @@
-/**
- * 配置加载
- *
- * 从项目根目录读取 .remnote-bridge.json，合并默认值。
- * 文件不存在时使用全部默认值，不报错。
- */
-export interface DefaultsConfig {
-    maxNodes: number;
-    maxSiblings: number;
-    cacheMaxSize: number;
-    readTreeDepth: number;
-    readTreeAncestorLevels: number;
-    readTreeIncludePowerup: boolean;
-    readGlobeDepth: number;
-    readContextMode: 'focus' | 'page';
-    readContextAncestorLevels: number;
-    readContextDepth: number;
-    searchNumResults: number;
-}
-export declare const DEFAULT_DEFAULTS: Readonly<DefaultsConfig>;
-export interface BridgeConfig {
-    wsPort: number;
-    devServerPort: number;
-    configPort: number;
-    daemonTimeoutMinutes: number;
-    defaults: DefaultsConfig;
-}
-export declare const DEFAULT_CONFIG: Readonly<BridgeConfig>;
-/**
- * 查找项目根目录（monorepo 根：包含 .git 目录的最近祖先）
- *
- * 从 startDir 向上查找 .git 目录，找到即返回。
- * 到达文件系统根仍未找到时回退到 cwd。
- */
-export declare function findProjectRoot(startDir?: string): string;
-/**
- * 加载配置。不存在时返回默认值。
- */
-export declare function loadConfig(projectRoot?: string): BridgeConfig;
-/**
- * 获取配置文件路径
- */
-export declare function configFilePath(projectRoot?: string): string;
-/**
- * 原子写入配置文件（写临时文件 → rename）
- */
-export declare function saveConfig(filePath: string, config: BridgeConfig): void;
-/**
- * PID 文件路径
- */
-export declare function pidFilePath(projectRoot?: string): string;
-/**
- * 日志文件路径
- */
-export declare function logFilePath(projectRoot?: string): string;

package/dist/cli/daemon/daemon.d.ts

@@ -1,11 +0,0 @@
-/**
- * 守护进程主逻辑
- *
- * 作为 fork 子进程运行：
- * 1. 启动 WS Server
- * 2. 启动 webpack-dev-server 子进程
- * 3. 写入 PID 文件
- * 4. 管理自动超时关闭
- * 5. 通过 IPC 向父进程发送 ready 信号
- */
-export {};

package/dist/cli/daemon/dev-server.d.ts

@@ -1,26 +0,0 @@
-/**
- * webpack-dev-server 子进程管理
- *
- * 在 remnote-plugin 目录下启动 npm run dev。
- */
-export interface DevServerOptions {
-    pluginDir: string;
-    port: number;
-    onLog?: (message: string, level: 'info' | 'warn' | 'error') => void;
-    onExit?: (code: number | null) => void;
-}
-export declare class DevServerManager {
-    private child;
-    private options;
-    constructor(options: DevServerOptions);
-    /**
-     * 启动 webpack-dev-server。
-     * 如果 remnote-plugin 目录不存在，抛出错误。
-     */
-    start(): void;
-    /**
-     * 停止 webpack-dev-server。
-     */
-    stop(): Promise<void>;
-    isRunning(): boolean;
-}

package/dist/cli/daemon/pid.d.ts

@@ -1,34 +0,0 @@
-/**
- * PID 文件管理
- *
- * 写入、读取、stale 检测、清理。
- */
-/**
- * 写入 PID 文件
- */
-export declare function writePid(filePath: string, pid: number): void;
-/**
- * 读取 PID 文件。文件不存在返回 null。
- */
-export declare function readPid(filePath: string): number | null;
-/**
- * 删除 PID 文件
- */
-export declare function removePid(filePath: string): void;
-/**
- * 检查进程是否存活
- */
-export declare function isProcessAlive(pid: number): boolean;
-/**
- * 检查守护进程状态。返回：
- * - { running: true, pid } — 守护进程正在运行
- * - { running: false } — 守护进程未运行（无 PID 文件或 stale）
- *
- * 若 PID 文件存在但进程已死（stale），自动清理 PID 文件。
- */
-export declare function checkDaemon(pidPath: string): {
-    running: true;
-    pid: number;
-} | {
-    running: false;
-};

package/dist/cli/daemon/send-request.d.ts

@@ -1,24 +0,0 @@
-/**
- * Daemon 通信工具 — CLI 命令向守护进程发送请求的通用方法
- *
- * 封装 WS 连接建立、请求发送、响应等待、超时处理的完整流程。
- * 所有业务命令（health、read-rem、edit-rem 等）均通过此函数与 daemon 通信。
- */
-export declare class DaemonNotRunningError extends Error {
-    constructor();
-}
-export declare class DaemonUnreachableError extends Error {
-    constructor(cause: string);
-}
-/**
- * 向守护进程发送请求并等待响应。
- *
- * 流程：读取 PID 文件 → 建立 WS 连接 → 发送 BridgeRequest → 等待 BridgeResponse → 关闭连接
- *
- * @throws DaemonNotRunningError — PID 文件不存在或进程已死
- * @throws DaemonUnreachableError — WS 连接失败
- * @throws Error — daemon 返回 error 字段或响应超时
- */
-export declare function sendDaemonRequest(action: string, payload?: Record<string, unknown>, options?: {
-    timeout?: number;
-}): Promise<unknown>;

package/dist/cli/handlers/context-read-handler.d.ts

@@ -1,18 +0,0 @@
-/**
- * ContextReadHandler — read-context 请求的业务编排
- *
- * 职责：转发到 Plugin 获取上下文视图，返回结果。
- */
-import type { DefaultsConfig } from '../config.js';
-export interface ContextReadResult {
-    nodeCount: number;
-    outline: string;
-    breadcrumb: string[];
-    mode: 'focus' | 'page';
-}
-export declare class ContextReadHandler {
-    private forwardToPlugin;
-    private defaults;
-    constructor(forwardToPlugin: (action: string, payload: Record<string, unknown>) => Promise<unknown>, defaults?: DefaultsConfig);
-    handleReadContext(payload: Record<string, unknown>): Promise<ContextReadResult>;
-}

package/dist/cli/handlers/edit-handler.d.ts

@@ -1,30 +0,0 @@
-/**
- * EditHandler — edit-rem 命令的编排器
- *
- * 在 daemon 层实现三道防线 + str_replace + 后处理校验。
- * Plugin 只负责原子写入（write_rem_fields）。
- *
- * 防线 1：缓存存在性检查（必须先 read 再 edit）
- * 防线 2：乐观并发检测（当前 JSON 与缓存 JSON 比较）
- * 防线 3：str_replace 精确匹配（old_str 必须唯一匹配）
- */
-import { RemCache } from './rem-cache.js';
-export interface EditRemPayload {
-    remId: string;
-    oldStr: string;
-    newStr: string;
-}
-export interface EditRemResult {
-    ok: boolean;
-    changes: string[];
-    warnings: string[];
-    error?: string;
-    appliedChanges?: string[];
-    failedField?: string;
-}
-export declare class EditHandler {
-    private cache;
-    private forwardToPlugin;
-    constructor(cache: RemCache, forwardToPlugin: (action: string, payload: Record<string, unknown>) => Promise<unknown>);
-    handleEditRem(payload: EditRemPayload): Promise<EditRemResult>;
-}

package/dist/cli/handlers/globe-read-handler.d.ts

@@ -1,17 +0,0 @@
-/**
- * GlobeReadHandler — read-globe 请求的业务编排
- *
- * 职责：转发到 Plugin 获取知识库概览，返回结果。
- * globe 是低频操作，不做缓存。
- */
-import type { DefaultsConfig } from '../config.js';
-export interface GlobeReadResult {
-    nodeCount: number;
-    outline: string;
-}
-export declare class GlobeReadHandler {
-    private forwardToPlugin;
-    private defaults;
-    constructor(forwardToPlugin: (action: string, payload: Record<string, unknown>) => Promise<unknown>, defaults?: DefaultsConfig);
-    handleReadGlobe(payload: Record<string, unknown>): Promise<GlobeReadResult>;
-}

package/dist/cli/handlers/read-handler.d.ts

@@ -1,16 +0,0 @@
-/**
- * ReadHandler — read-rem 请求的业务编排
- *
- * 职责：
- * 1. 转发到 Plugin 获取完整 RemObject
- * 2. 序列化为 JSON 字符串并缓存（完整版本）
- * 3. 根据 fields/full 参数过滤字段返回给 CLI
- */
-import { RemCache } from './rem-cache.js';
-export declare class ReadHandler {
-    private cache;
-    private forwardToPlugin;
-    private onLog?;
-    constructor(cache: RemCache, forwardToPlugin: (action: string, payload: Record<string, unknown>) => Promise<unknown>, onLog?: ((message: string, level: "info" | "warn" | "error") => void) | undefined);
-    handleReadRem(payload: Record<string, unknown>): Promise<unknown>;
-}

package/dist/cli/handlers/rem-cache.d.ts

@@ -1,19 +0,0 @@
-/**
- * RemCache — LRU 缓存，存储 Rem 的序列化 JSON
- *
- * 缓存存储在 daemon 内存中，生命周期与 daemon 一致。
- * disconnect 关闭 daemon → 缓存自然消失。
- */
-export declare class RemCache {
-    private cache;
-    private maxSize;
-    constructor(maxSize?: number);
-    get(remId: string): string | null;
-    /** 获取缓存条目的创建时间（ISO 8601），不存在返回 null */
-    getCreatedAt(remId: string): string | null;
-    set(remId: string, json: string): void;
-    has(remId: string): boolean;
-    delete(remId: string): void;
-    clear(): void;
-    get size(): number;
-}