dsh-lsp-actions 0.2.0

package/README.zh-CN.md

@@ -0,0 +1,181 @@
+<div align="center">
+
+# 🛰️ dsh-lsp-actions
+
+**DeepSeek Harness 的 LSP 动作面 —— 真实的语言服务器，真实的反馈。**
+
+为你的 agent 编辑循环提供诊断、格式化、补全、快速修复、符号、签名提示与内联提示，驱动它们的正是你 IDE 所用的那些语言服务器。
+
+[![Topic: dsh](https://img.shields.io/badge/Topic-dsh-4D6BFE?style=for-the-badge)](https://github.com/topics/dsh)
+[![Topic: dsh-plugin](https://img.shields.io/badge/Topic-dsh--plugin-8257D0?style=for-the-badge)](https://github.com/topics/dsh-plugin)
+[![License](https://img.shields.io/badge/License-Apache%202.0-D22128?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/badge/Node-%5E22.19%20%7C%7C%20%3E%3D24-43853D?style=flat-square)](package.json)
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [हिन्दी](README.hi.md) · [Português](README.pt.md)
+
+</div>
+
+---
+
+## 这个插件给 agent 带来什么
+
+官方 DeepSeek Harness 的 `ctx.lsp` seam 只覆盖**导航**（跳转定义、引用、实现、悬停）。`dsh-lsp-actions` 补齐了**动作面** —— agent 写代码和修代码时需要的反馈闭环：
+
+| 工具 | 做什么 | 写盘？ |
+| --- | --- | --- |
+| `lsp_diagnostics <file>` | 编译器/分析器的错误、警告与提示（含严重级、范围、消息与来源服务器） | ❌ 只读 |
+| `lsp_format <file> [range?]` | 通过语言服务器格式化文件或选区并写入，返回 diff | ✅ 走 `fs/write-intent` + 沙箱策略 |
+| `lsp_completion <file> <line> <character>` | 光标处的补全建议，含实际插入文本 | ❌ 只读 |
+| `lsp_code_action <file> [range?] [only?]` | 服务器验证过的快速修复/重构（含其编辑） | ❌ 仅参考 |
+| `lsp_symbols <query?> <file_path?>` | 按名字全局搜索符号，或列出单个文件的符号大纲 | ❌ 只读 |
+| `lsp_signature <file> <line> <character>` | 调用点处的签名提示（参数与文档） | ❌ 只读 |
+| `lsp_inlay_hints <file> [range?]` | 服务器的类型标注与参数名提示 | ❌ 只读 |
+| `lsp_rename <file> <line> <character> <new_name>` | 服务器验证过的符号重命名，跨工作区应用并返回逐文件 diff | ✅ 走 `fs/write-intent` + 沙箱策略 |
+
+> ✨ 测试套件包含一次真实的 `typescript-language-server` 运行：诊断、格式化、补全、符号搜索与重命名都是对着活服务器端到端验证的，而非只有 mock。套件自包含（tsls 是 devDependency），并在 CI 中以 Node 22/24 × Linux/Windows/macOS 矩阵运行。
+
+## 快速开始
+
+```sh
+dsh plugin --profile <name> add <path-or-tarball-of-dsh-lsp-actions>
+```
+
+每个语言服务器配一条 entry（形态与官方 `lsp-stdio` 配置一致）：
+
+```yaml
+# 写在 profile 的 cordis.patch.yml（或 bundle 行）里
+- insert:
+    - id: lsp-actions
+      name: dsh-lsp-actions
+      inject: [tools, fs, subprocess]
+      config:
+        servers:
+          ts:
+            command: typescript-language-server
+            args: [--stdio]
+            extensionToLanguage:
+              ".ts": typescript
+            formattingOptions: { tabSize: 2, insertSpaces: true }
+          py:
+            command: pyright-langserver
+            args: [--stdio]
+            extensionToLanguage:
+              ".py": python
+        maxDiagnostics: 200
+        maxCompletionItems: 20
+        maxCodeActions: 50
+        maxSymbols: 100
+        maxSignatures: 10
+        maxInlayHints: 200
+        maxResultChars: 16000
+        timeoutMs: 60000
+```
+
+八个工具**始终注册**。当 `servers` 表为空且没有挂载 `ctx.lsp` seam 时，调用会**响亮失败**（`LSP_ACTION_UNAVAILABLE`，错误信息指明该配置什么）—— 插件绝不会启动你没有配置的服务器。**在插件之后**挂载的 `ctx.lsp` seam 会在下一次调用时被识别（seam 探测按调用惰性解析，加载顺序无关）。
+
+## 为什么按构造就安全
+
+- **格式化与重命名是真实写入，按 `write`/`edit` 同等对待。** 每个字节都经过 `fs/write-intent` waterfall（观测 → 守卫写 → 观测）与每次调用的沙箱策略。`lsp_rename` 会在第一笔写入**之前**对每个待改文件做预检（工作区包含性、重叠检查、字节上限读取），坏服务器响应不可能留下写了一半的重命名。
+- **其余一切按设计只读。** 代码动作、补全、符号、签名与提示都作为参考材料返回；应用它们由模型自行决定用 write/edit 完成。命令形态只报告、**绝不执行**。
+- **只读会话响亮、快速、结构化地失败** —— 在任何服务器往返之前抛出带共享 `[sandbox: …]` 标记的 `LSP_ACTION_READ_ONLY`。
+- **升级路径与官方工具一致。** 在受限文件系统下，`lsp_format` 与 `lsp_rename` 广告与 `write`/`edit` 相同的 `sandbox_permissions` / `justification` 一次性重试，经 `ctx.approval` 裁决。
+- **冲突绝不覆盖。** 若文件在读后被改动，守卫写以 `LSP_ACTION_CONFLICT` 失败，并让模型二选一：重读后重跑，或手工应用 diff。
+- **超时是平台职责。** 每个工具声明 `timeoutMs`，由官方 `dsh-tool-call-timeout-policy` 执行，所有 await 尊重 `exec.signal`。
+- **不缓存任何东西。** 结果只存在于会话日志，无跨会话持久化。
+- **坏服务器响亮失败。** 命令缺失在加载期即失败；启动即死的服务器以 `LSP_ACTION_SERVER_FAILED` + stderr 尾部失败（启动失败先自动换新进程重试一次）。
+
+## 架构
+
+动作**优先走官方 seam**，未命中则回落插件自带的最小 stdio 客户端：
+
+```
+lsp_diagnostics / lsp_format / lsp_completion / lsp_code_action /
+lsp_symbols / lsp_signature / lsp_inlay_hints / lsp_rename
+        │
+        ▼
+   ctx.lsp seam（扩展后：diagnostics / formatDocument / completion）
+        │  缺席 · 旧版 · 该文件无 provider
+        ▼
+   内置 stdio 客户端  ←  servers 表（ctx.subprocess.spawn + JSON-RPC）
+```
+
+seam 扩展已向上游提案（`upstream/lsp-action-seam.patch`，PR 描述见 `upstream/PR-description.md`）。合入后插件无需改动即自动迁移 —— 内置客户端停止被使用即可。内置客户端会保留为 `servers` 表的独立兜底。完整调研与设计笔记：[`docs/seam-extension-notes.md`](docs/seam-extension-notes.md)、[`upstream/README.md`](upstream/README.md)。
+
+## 配置参考
+
+```ts
+interface Config {
+  /** 命名的语言服务器；为空 = 插件自带客户端不服务任何文件。 */
+  servers?: Record<string, LspServerEntry>
+  maxDiagnostics?: number        // 默认 200
+  maxCompletionItems?: number    // 默认 20
+  maxCodeActions?: number        // 默认 50
+  maxSymbols?: number            // 默认 100
+  maxSignatures?: number         // 默认 10
+  maxInlayHints?: number         // 默认 200
+  maxResultChars?: number        // 默认 16000（完整渲染结果上限）
+  maxDocumentBytes?: number      // 默认 4000000
+  timeoutMs?: number             // 默认 60000（由官方超时策略执行）
+}
+
+interface LspServerEntry {
+  command: string                        // 可执行文件，加载期在 PATH 上解析
+  extensionToLanguage: Record<string, string>  // ".ts" → "typescript"
+  fileGlobs?: string[]                   // 可选；glob 命中优先于扩展名映射
+  args?: string[]                        // 不经 shell
+  env?: Record<string, string>
+  initializationOptions?: unknown
+  configuration?: unknown                // 对象形态按 section 应答 workspace/configuration
+  formattingOptions?: unknown            // 例如 { tabSize: 2, insertSpaces: true }
+  maxMessageBytes?: number               // 默认 16000000
+  maxStderrBytes?: number                // 默认 1000000
+  killGraceMs?: number                   // 默认 2000
+  shutdownTimeoutMs?: number             // 默认 5000
+  diagnosticsSettleMs?: number           // 默认 2000（仅推送诊断的收集窗口）
+  diagnosticsDebounceMs?: number         // 默认 250（最后一批推送后的安静期）
+  idleTimeoutMs?: number                 // 默认 0（0 = 服务器进程常驻）
+}
+```
+
+### 错误码
+
+每个失败都在错误结果上携带稳定 `code`；模型与调用方按 code 路由，绝不解析消息文本。
+
+| Code | 含义 |
+| --- | --- |
+| `LSP_ACTION_UNAVAILABLE` | 没有服务器 entry、seam provider 也不处理该文件。 |
+| `LSP_ACTION_UNSUPPORTED` | 服务器（或 seam provider）未广告该操作。 |
+| `LSP_ACTION_SERVER_FAILED` | 服务器失败（附 stderr 尾部）；启动失败重试一次。 |
+| `LSP_ACTION_MALFORMED_RESPONSE` | 服务器返回了结构非法的负载。 |
+| `LSP_ACTION_CONFLICT` | 文件读后已变，或服务器返回的编辑重叠/越界/越出工作区。 |
+| `LSP_ACTION_READ_ONLY` | 会话沙箱模式禁止格式化/重命名写入。 |
+| `LSP_ACTION_WORKSPACE_REQUIRED` | 调用会话没有可扎根的 workspace cwd。 |
+| `LSP_ACTION_NO_SYMBOL` | 服务器在光标位置找不到可重命名的符号。 |
+
+### 宿主版本支持
+
+插件把 DeepSeek Harness 各包声明为 **peerDependencies**（`@deepseek-ai/dsh-fs`、`dsh-llm`、`dsh-sandbox`、`dsh-subprocess`、`dsh-tools` ≥ `0.1.0-rc.6`），宿主与插件共享同一份副本。已在 `0.1.0-rc.6` 上实测。
+
+### 已知限制
+
+- **瞬态文档。** 每次动作都是打开文件 → 发一个请求 → 关闭文件（与官方 stdio host 一致）。依赖常驻打开文件的基于项目的服务器（tsls 在无打开文档时拒绝 `workspace/symbol`）可通过给 `lsp_symbols` 传 `file_path` 解决 —— 插件会在该请求期间保持路由文件打开。tsls 在该生命周期下对 `textDocument/signatureHelp` 返回 `null`；其他服务器（gopls、pyright、rust-analyzer）正常应答。
+- **范围格式化要求服务器广告 range provider。** 只广告全文格式化的服务器对范围请求以 `LSP_ACTION_UNSUPPORTED` 失败。
+- **重命名只应用文本编辑。** 服务器重命名结果中的资源操作（新建/删除/重命名文件）以 `LSP_ACTION_UNSUPPORTED` 拒绝；越出工作区的编辑在任何写入发生前以 `LSP_ACTION_CONFLICT` 失败。在 `utf-8`/`utf-32` 服务器上，跨文件重命名位置通过逐个读取被编辑文件来解码；被编辑文件不可读时以冲突失败，绝不错误解码位置。
+
+## 开发
+
+```sh
+pnpm install
+pnpm run lint        # oxlint 检查 src/ 与 tests/
+pnpm test            # 240+ 测试：单元 + fixture 服务器集成 + 真实 tsls e2e
+pnpm run test:coverage   # 门禁：行/语句/函数 ≥ 90%，分支 ≥ 85%
+pnpm build           # 产出 lib/
+```
+
+### 发布
+
+CI 在每次推送与 PR 上运行 lint/构建/测试矩阵 + 覆盖率门禁。推送 `v*` tag 会触发发布工作流：先验证全套测试再发布到 npm —— 需要在仓库里一次性配置 `NPM_TOKEN` Actions secret（发布权限的 npm access token）。版本号在打 tag 前于 `package.json` / `CHANGELOG.md` 中手动提升。
+
+## License
+
+[Apache License 2.0](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,17 @@
+# LSP action surface: diagnostics, formatting, completion, code actions, symbols, signature
+# help, inlay hints, and rename over language servers.
+# Default config activates no servers (empty table); add one entry per language server.
+- insert:
+    - id: lsp-actions
+      name: dsh-lsp-actions
+      inject: [tools, fs, subprocess]
+      config:
+        servers: {}
+        maxDiagnostics: 200
+        maxCompletionItems: 20
+        maxCodeActions: 50
+        maxSymbols: 100
+        maxSignatures: 10
+        maxInlayHints: 200
+        maxResultChars: 16000
+        timeoutMs: 60000

package/lib/abort.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Abort helpers: race any promise against a signal, and throw the signal's reason once it fires.
+ * @module dsh-lsp-actions/abort
+ */
+/**
+ * Race `promise` against `signal`; the returned promise rejects with the signal's reason the
+ * moment it aborts, without disturbing the underlying promise's own settlement.
+ * @param promise - the work to race.
+ * @param signal - optional cancellation; undefined returns the promise unchanged.
+ * @returns the raced promise.
+ */
+export declare function abortable<T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/lib/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB7F"}

package/lib/abort.js

@@ -0,0 +1,31 @@
+/**
+ * Abort helpers: race any promise against a signal, and throw the signal's reason once it fires.
+ * @module dsh-lsp-actions/abort
+ */
+/**
+ * Race `promise` against `signal`; the returned promise rejects with the signal's reason the
+ * moment it aborts, without disturbing the underlying promise's own settlement.
+ * @param promise - the work to race.
+ * @param signal - optional cancellation; undefined returns the promise unchanged.
+ * @returns the raced promise.
+ */
+export function abortable(promise, signal) {
+    if (signal === undefined)
+        return promise;
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason);
+            return;
+        }
+        const onAbort = () => { reject(signal.reason); };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/lib/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAI,OAAmB,EAAE,MAA+B;IAC/E,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IACxC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACrB,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,GAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,CAAC,KAAK,CAAC,CAAA;QACf,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/client.d.ts

@@ -0,0 +1,173 @@
+/**
+ * The plugin's own minimal LSP action client — the fallback for compositions where the official
+ * `ctx.lsp` seam does not serve action operations yet. One server process per (server entry,
+ * canonical workspace), lazily spawned and serialized; each action runs the transient
+ * didOpen→request→didClose lifecycle the servers expect, and teardown is bounded. See
+ * `docs/seam-extension-notes.md` for the migration story to the official seam.
+ * @module dsh-lsp-actions/client
+ */
+import type { FileSystem } from '@deepseek-ai/dsh-fs';
+import type { Context } from '@deepseek-ai/cordis';
+import type { HostSource } from './host.ts';
+import type { LspCodeActionsResult, LspCompletionResult, LspDiagnosticsResult, LspEditsResult, LspInlayHintsResult, LspPosition, LspRange, LspRenameResult, LspSignaturesResult, LspSymbolsResult } from './vocabulary.ts';
+import type { ResolvedServer } from './servers.ts';
+/** One action call as the client receives it: everything the tool already knows. */
+export interface ActionRequest {
+    /** The source file (relative to `workspaceRoot` or absolute). */
+    readonly filePath: string;
+    /** The workspace root the client resolves against and indexes. */
+    readonly workspaceRoot: string;
+    /** The pre-read, byte-capped source the didOpen synchronizes with the server. */
+    readonly source: HostSource;
+    /** The LSP language id for `filePath`, from the routed server's extension mapping. */
+    readonly languageId: string;
+    /** The cursor position, for completion and signature help. */
+    readonly position?: LspPosition;
+    /** The formatting/code-action/inlay-hint range, when the caller narrowed it. */
+    readonly range?: LspRange;
+    /** CodeActionKind filters for code actions (e.g. `quickfix`). */
+    readonly onlyKinds?: readonly string[];
+}
+/**
+ * Pooled minimal LSP action client. Instances are single-flight per canonical workspace and are
+ * evicted as soon as they die; every await observes cancellation.
+ */
+export declare class LspActionClient {
+    private readonly subprocess;
+    private readonly fs;
+    /** Byte cap for documents the rename flow reads back to decode cross-file positions. */
+    private readonly maxDocumentBytes;
+    private readonly instances;
+    private readonly lifetime;
+    private disposed;
+    constructor(subprocess: Context['subprocess'], fs: FileSystem, 
+    /** Byte cap for documents the rename flow reads back to decode cross-file positions. */
+    maxDocumentBytes?: number);
+    /** Spawn one connection through the subprocess seam (the real provider at runtime). */
+    private readonly spawner;
+    /**
+     * Run the diagnostics action through the routed server.
+     * @param server - the routed server entry.
+     * @param request - the action request.
+     * @param signal - optional cancellation.
+     * @returns the normalized diagnostics result.
+     */
+    diagnostics(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspDiagnosticsResult>;
+    /**
+     * Run the formatting action through the routed server; the client only RETURNS edits, it never
+     * writes files — the tool applies them through `ctx.fs` write-intent.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the optional range).
+     * @param signal - optional cancellation.
+     * @returns the normalized edits result.
+     */
+    formatDocument(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspEditsResult>;
+    /**
+     * Run the completion action through the routed server.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the cursor position).
+     * @param signal - optional cancellation.
+     * @returns the normalized completion result.
+     */
+    completion(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspCompletionResult>;
+    /**
+     * Run the code actions action through the routed server; the client only REPORTS edits and
+     * commands, it never applies them — applying one is the model's own write/edit decision.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the optional range and kind filters).
+     * @param signal - optional cancellation.
+     * @returns the normalized code actions result.
+     */
+    codeActions(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspCodeActionsResult>;
+    /**
+     * Run a workspace-wide symbol search through the routed server (no document involved).
+     * @param server - the routed server entry.
+     * @param workspaceRoot - the workspace to search.
+     * @param query - the symbol name query.
+     * @param signal - optional cancellation.
+     * @returns the normalized symbols result.
+     */
+    workspaceSymbols(server: ResolvedServer, workspaceRoot: string, query: string, signal?: AbortSignal): Promise<LspSymbolsResult>;
+    /**
+     * Run a workspace-wide symbol search with one document kept open: project-based servers (tsls)
+     * refuse document-free `workspace/symbol`, so the routing file stays transiently open for the
+     * request and closes afterwards.
+     * @param server - the routed server entry.
+     * @param request - the action request (whose source is kept open during the search).
+     * @param query - the symbol name query.
+     * @param signal - optional cancellation.
+     * @returns the normalized symbols result.
+     */
+    workspaceSymbolsInDocument(server: ResolvedServer, request: ActionRequest, query: string, signal?: AbortSignal): Promise<LspSymbolsResult>;
+    /**
+     * Run a document symbol listing through the routed server.
+     * @param server - the routed server entry.
+     * @param request - the action request.
+     * @param signal - optional cancellation.
+     * @returns the normalized symbols result.
+     */
+    documentSymbols(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspSymbolsResult>;
+    /**
+     * Run signature help through the routed server.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the cursor position).
+     * @param signal - optional cancellation.
+     * @returns the normalized signatures result.
+     */
+    signatureHelp(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspSignaturesResult>;
+    /**
+     * Run inlay hints through the routed server.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the optional range).
+     * @param signal - optional cancellation.
+     * @returns the normalized inlay hints result.
+     */
+    inlayHints(server: ResolvedServer, request: ActionRequest, signal?: AbortSignal): Promise<LspInlayHintsResult>;
+    /**
+     * Run a symbol rename through the routed server; the client only RETURNS the grouped edits, it
+     * never writes files — the tool applies them through `ctx.fs` write-intent. Cross-document
+     * positions are decoded per document (reading the target text for non-utf-16 servers), so the
+     * returned edits are utf-16 for every document.
+     * @param server - the routed server entry.
+     * @param request - the action request (carries the cursor position).
+     * @param newName - the new symbol name.
+     * @param signal - optional cancellation.
+     * @returns the normalized, decoded rename result.
+     */
+    rename(server: ResolvedServer, request: ActionRequest, newName: string, signal?: AbortSignal): Promise<LspRenameResult>;
+    /** Disposed flag through a method so an await cannot narrow it to a literal. */
+    private isDisposed;
+    /** Reject work that cannot publish or use a client-owned instance. */
+    private assertActive;
+    /** Fuse caller cancellation with client disposal for every filesystem and protocol await. */
+    private querySignal;
+    private run;
+    /** The document-free sibling of {@link run}: serves workspace-scoped actions (symbol search). */
+    private runBare;
+    /** Serialize and run one action attempt pair (retry-once included) for a canonical workspace. */
+    private runScoped;
+    /** One attempt: publish/borrow the instance, run the action, evict the dead, arm the idle timer. */
+    private runOnce;
+    /** Idle-eviction timers per workspace key; a use resets, a fire disposes and evicts. */
+    private readonly idleTimers;
+    private armIdleTimer;
+    private clearIdleTimer;
+    /** Serialize one complete action lifecycle per canonical workspace. */
+    private enqueue;
+    /** The serialization tail for one workspace key (per-instance queues live on the instance). */
+    private tails;
+    private tailFor;
+    private setTail;
+    /** Return or synchronously publish the one instance for a canonical workspace. */
+    private instanceFor;
+    /** Dispose every live instance and block further actions. */
+    disposeAll(): Promise<void>;
+    /**
+     * Decode one rename's grouped wire edits into utf-16, per document: the origin document uses
+     * the source text the server saw; any other document is read back for its codec (utf-16 servers
+     * need no read — their positions are already utf-16). An unreadable or out-of-workspace target
+     * on a non-utf-16 server is a structured conflict, never silently mis-decoded positions.
+     */
+    private decodeRenameEdits;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}