dsh-lsp-actions 0.2.0

package/lib/host.js

@@ -0,0 +1,152 @@
+/**
+ * Filesystem-seam source access for the LSP action client: canonicalizing the workspace and
+ * reading the byte-bounded transient document that `didOpen` synchronizes with the server.
+ * @module dsh-lsp-actions/host
+ */
+import { Buffer } from 'node:buffer';
+/**
+ * Resolve and validate one workspace through `ctx.fs`.
+ * @param fs - filesystem provider sharing the language server's execution world.
+ * @param workspaceRoot - caller-supplied workspace path.
+ * @param signal - optional cancellation around provider operations.
+ * @returns stable identity plus process path and file URI.
+ */
+export async function canonicalizeWorkspace(fs, workspaceRoot, signal) {
+    throwIfAborted(signal);
+    let target;
+    try {
+        target = await fs.resolve(workspaceRoot, signal === undefined ? {} : { signal });
+    }
+    catch (error) {
+        throwIfAborted(signal);
+        throw new Error(`workspace root "${workspaceRoot}" cannot be resolved: ${messageOf(error)}`, { cause: error });
+    }
+    throwIfAborted(signal);
+    const info = await fs.stat(target, signal).catch((error) => {
+        throwIfAborted(signal);
+        throw error;
+    });
+    throwIfAborted(signal);
+    if (info?.type !== 'directory') {
+        throw new Error(`workspace root "${workspaceRoot}" is not a directory`);
+    }
+    return {
+        target,
+        canonicalPath: fs.processPath(target),
+        fileUrl: fs.fileUrl(target),
+    };
+}
+/**
+ * Resolve, contain, and read one byte-bounded source through `ctx.fs`, carrying back the
+ * freshness token so a formatting write can observe and guard the exact bytes the server saw.
+ * @param fs - filesystem provider sharing the server's execution world.
+ * @param filePath - absolute source path or path relative to `workspace`.
+ * @param workspace - already-canonical workspace.
+ * @param maxDocumentBytes - largest complete source accepted by this host.
+ * @param signal - optional cancellation.
+ * @returns canonical file URI, current text, and freshness token.
+ */
+export async function readHostSource(fs, filePath, workspace, maxDocumentBytes, signal) {
+    throwIfAborted(signal);
+    let target;
+    try {
+        target = await fs.resolve(filePath, {
+            cwd: workspace.canonicalPath,
+            ...signal === undefined ? {} : { signal },
+        });
+    }
+    catch (error) {
+        throwIfAborted(signal);
+        throw new Error(`source "${filePath}" cannot be resolved: ${messageOf(error)}`, { cause: error });
+    }
+    throwIfAborted(signal);
+    if (!fs.contains(workspace.target, target)) {
+        throw new Error(`source "${filePath}" resolves outside the workspace`);
+    }
+    const info = await fs.stat(target, signal).catch((error) => {
+        throwIfAborted(signal);
+        throw error;
+    });
+    throwIfAborted(signal);
+    const chunks = [];
+    let bytes = 0;
+    try {
+        const stream = await fs.streamText(target, signal);
+        for await (const chunk of stream) {
+            throwIfAborted(signal);
+            bytes += Buffer.byteLength(chunk);
+            if (bytes > maxDocumentBytes)
+                break;
+            chunks.push(chunk);
+        }
+    }
+    catch (error) {
+        throwIfAborted(signal);
+        throw new Error(`source "${filePath}" could not be read: ${messageOf(error)}`, { cause: error });
+    }
+    if (bytes > maxDocumentBytes) {
+        throw new Error(`source "${filePath}" exceeds the ${maxDocumentBytes}-byte limit; reading stopped after ${bytes} bytes`);
+    }
+    throwIfAborted(signal);
+    return {
+        target,
+        fileUrl: fs.fileUrl(target),
+        text: chunks.join(''),
+        ...info === undefined ? {} : { version: info.version },
+    };
+}
+/** Throw the signal's abort reason when the signal has fired. */
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw signal.reason;
+}
+/** Normalize a `file:` URI for identity comparison: decoded path, case-folded on Windows. */
+export function normalizeFileUri(uri) {
+    return foldFileUri(decodeFileUri(uri));
+}
+/** Decode a `file:` URI's percent escapes without case-folding, so path slicing stays exact. */
+export function decodeFileUri(uri) {
+    try {
+        const url = new URL(uri);
+        if (url.protocol !== 'file:')
+            return uri;
+        return `file://${decodeURIComponent(url.pathname)}`;
+    }
+    catch {
+        return uri;
+    }
+}
+function foldFileUri(uri) {
+    if (process.platform !== 'win32')
+        return uri;
+    const marker = 'file://';
+    if (!uri.startsWith(marker))
+        return uri;
+    return `${marker}${uri.slice(marker.length).toLowerCase()}`;
+}
+/**
+ * The workspace-relative path one document URI points at, when the URI lies under the canonical
+ * workspace URI. Servers re-spell the root URI sent at `initialize` (lowercase drive letters and
+ * percent-encoded colons on Windows, a trailing slash on either side), so containment is judged on
+ * decoded, case-insensitive forms while the relative path itself is sliced from the decoded URI —
+ * a normalized string can differ in length from the raw one, which would shift the cut.
+ * @param workspace - the canonical workspace.
+ * @param uri - the document URI the server named.
+ * @returns the relative path (`.` for the workspace root itself), or undefined when the URI does
+ *   not fall under the workspace.
+ */
+export function workspaceRelativePath(workspace, uri) {
+    const root = decodeFileUri(workspace.fileUrl);
+    const decoded = decodeFileUri(uri);
+    const identity = (candidate) => process.platform === 'win32' ? candidate.toLowerCase() : candidate;
+    if (identity(decoded) === identity(root))
+        return '.';
+    const prefix = root.endsWith('/') ? root : `${root}/`;
+    if (!identity(decoded).startsWith(identity(prefix)))
+        return undefined;
+    return decoded.slice(prefix.length);
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=host.js.map

package/lib/host.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * LSP action surface for DeepSeek Harness: diagnostics, formatting, completion, code actions,
+ * symbols, signature help, inlay hints, and rename tools over language servers. Actions go through
+ * the extended official `ctx.lsp` seam when it is mounted (the upstream PR proposal); otherwise
+ * the plugin's own minimal stdio client serves them from the `servers` table, resolved and
+ * validated at load. With an empty servers table and no seam, the tools are still registered and
+ * fail loudly with `LSP_ACTION_UNAVAILABLE` on use — the seam is resolved per call, so a seam
+ * mounted after this plugin is served without a reload.
+ *
+ * Namespace plugin (named exports, no default export).
+ * @module dsh-lsp-actions
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { Config as ConfigSchema } from './servers.ts';
+import type { Config as ConfigType } from './servers.ts';
+export { LspServerEntry } from './servers.ts';
+export { LspActionClient } from './client.ts';
+export { LspActionError } from './vocabulary.ts';
+export type { LspActionErrorCode, LspActionResult, LspCodeActionItem, LspCodeActionsResult, LspCompletionItem, LspDiagnostic, LspDiagnosticSeverity, LspDiagnosticsResult, LspEditsResult, LspInlayHint, LspInlayHintsResult, LspPosition, LspRange, LspRenameResult, LspSignature, LspSignaturesResult, LspSymbol, LspSymbolsResult, LspTextEdit, } from './vocabulary.ts';
+export { applyEdits } from './edits.ts';
+export { encodeMessage, MessageDecoder } from './framing.ts';
+export { formatAppliedEdits, formatCodeActions, formatCompletionList, formatDiagnostics, formatInlayHints, formatRenameResult, formatSignatures, formatSymbols, presentLspCodeActionCall, presentLspCodeActionResult, presentLspCompletionCall, presentLspCompletionResult, presentLspDiagnosticsCall, presentLspDiagnosticsResult, presentLspFormatCall, presentLspFormatResult, presentLspInlayHintsCall, presentLspInlayHintsResult, presentLspRenameCall, presentLspRenameResult, presentLspSignatureCall, presentLspSignatureResult, presentLspSymbolsCall, presentLspSymbolsResult, symbolKindLabel, } from './render.ts';
+export { globToRegExp, routeFile, resolveServers, } from './servers.ts';
+export { decodeTextEdits, negotiatePositionEncoding, normalizeCodeActions, normalizeCompletionItems, normalizeDiagnostics, normalizeEdits, normalizeInlayHints, normalizeSignatures, normalizeSymbols, normalizeWorkspaceEdit, PositionCodec, requestMethod, supportsAction, supportsPullDiagnostics, supportsTransientOpen, } from './translate.ts';
+/** Cordis plugin name for loader diagnostics. */
+export declare const name = "lsp-actions";
+/** Services required by this plugin. */
+export declare const inject: string[];
+/** Plugin configuration schema (schemastery fills every default; misconfiguration fails at load). */
+export declare const Config: import("@deepseek-ai/schemastery").default<ConfigSchema>;
+/**
+ * Register the eight LSP action tools. Resolves every configured server executable at load (fail
+ * loud on a missing command) before registering anything; tool, client, and server lifecycles are
+ * effect-scoped, so disposal unregisters the tools and tears down every live server. The official
+ * seam is resolved lazily per call (see the runner), so registration is independent of the seam's
+ * load order; without servers and without a seam, calls fail loudly with `LSP_ACTION_UNAVAILABLE`
+ * instead of the plugin silently contributing nothing.
+ * @param ctx - the plugin context (must inject `tools`, `fs`, `subprocess`).
+ * @param config - the resolved plugin configuration.
+ */
+export declare function apply(ctx: Context, config: ConfigType): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,EAAsC,MAAM,IAAI,YAAY,EAAkB,MAAM,cAAc,CAAA;AACzG,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAuC,MAAM,cAAc,CAAA;AAG7F,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,iDAAiD;AACjD,eAAO,MAAM,IAAI,gBAAgB,CAAA;AAEjC,wCAAwC;AACxC,eAAO,MAAM,MAAM,UAAgC,CAAA;AAEnD,qGAAqG;AACrG,eAAO,MAAM,MAAM,0DAAe,CAAA;AAElC;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3E"}

package/lib/index.js

@@ -0,0 +1,78 @@
+/**
+ * LSP action surface for DeepSeek Harness: diagnostics, formatting, completion, code actions,
+ * symbols, signature help, inlay hints, and rename tools over language servers. Actions go through
+ * the extended official `ctx.lsp` seam when it is mounted (the upstream PR proposal); otherwise
+ * the plugin's own minimal stdio client serves them from the `servers` table, resolved and
+ * validated at load. With an empty servers table and no seam, the tools are still registered and
+ * fail loudly with `LSP_ACTION_UNAVAILABLE` on use — the seam is resolved per call, so a seam
+ * mounted after this plugin is served without a reload.
+ *
+ * Namespace plugin (named exports, no default export).
+ * @module dsh-lsp-actions
+ */
+import { LspActionClient } from "./client.js";
+import { registerCodeActionTool, registerInlayHintsTool, registerSignatureTool, registerSymbolsTool } from "./extra-tools.js";
+import { createActionRunner } from "./runner.js";
+import { FormatSandboxController } from "./sandbox.js";
+import { assertPositiveInteger, assertTimer, Config as ConfigSchema, resolveServers } from "./servers.js";
+import { registerCompletionTool, registerDiagnosticsTool, registerFormatTool, registerRenameTool } from "./tools.js";
+export { LspServerEntry } from "./servers.js";
+export { LspActionClient } from "./client.js";
+export { LspActionError } from "./vocabulary.js";
+export { applyEdits } from "./edits.js";
+export { encodeMessage, MessageDecoder } from "./framing.js";
+export { formatAppliedEdits, formatCodeActions, formatCompletionList, formatDiagnostics, formatInlayHints, formatRenameResult, formatSignatures, formatSymbols, presentLspCodeActionCall, presentLspCodeActionResult, presentLspCompletionCall, presentLspCompletionResult, presentLspDiagnosticsCall, presentLspDiagnosticsResult, presentLspFormatCall, presentLspFormatResult, presentLspInlayHintsCall, presentLspInlayHintsResult, presentLspRenameCall, presentLspRenameResult, presentLspSignatureCall, presentLspSignatureResult, presentLspSymbolsCall, presentLspSymbolsResult, symbolKindLabel, } from "./render.js";
+export { globToRegExp, routeFile, resolveServers, } from "./servers.js";
+export { decodeTextEdits, negotiatePositionEncoding, normalizeCodeActions, normalizeCompletionItems, normalizeDiagnostics, normalizeEdits, normalizeInlayHints, normalizeSignatures, normalizeSymbols, normalizeWorkspaceEdit, PositionCodec, requestMethod, supportsAction, supportsPullDiagnostics, supportsTransientOpen, } from "./translate.js";
+/** Cordis plugin name for loader diagnostics. */
+export const name = 'lsp-actions';
+/** Services required by this plugin. */
+export const inject = ['tools', 'fs', 'subprocess'];
+/** Plugin configuration schema (schemastery fills every default; misconfiguration fails at load). */
+export const Config = ConfigSchema;
+/**
+ * Register the eight LSP action tools. Resolves every configured server executable at load (fail
+ * loud on a missing command) before registering anything; tool, client, and server lifecycles are
+ * effect-scoped, so disposal unregisters the tools and tears down every live server. The official
+ * seam is resolved lazily per call (see the runner), so registration is independent of the seam's
+ * load order; without servers and without a seam, calls fail loudly with `LSP_ACTION_UNAVAILABLE`
+ * instead of the plugin silently contributing nothing.
+ * @param ctx - the plugin context (must inject `tools`, `fs`, `subprocess`).
+ * @param config - the resolved plugin configuration.
+ */
+export async function apply(ctx, config) {
+    const resolved = config;
+    assertPositiveInteger('maxDiagnostics', resolved.maxDiagnostics);
+    assertPositiveInteger('maxCompletionItems', resolved.maxCompletionItems);
+    assertPositiveInteger('maxCodeActions', resolved.maxCodeActions);
+    assertPositiveInteger('maxSymbols', resolved.maxSymbols);
+    assertPositiveInteger('maxSignatures', resolved.maxSignatures);
+    assertPositiveInteger('maxInlayHints', resolved.maxInlayHints);
+    assertPositiveInteger('maxResultChars', resolved.maxResultChars);
+    assertPositiveInteger('maxDocumentBytes', resolved.maxDocumentBytes);
+    assertTimer('timeoutMs', resolved.timeoutMs);
+    // Resolve every executable BEFORE registering anything: a bad later command must not publish an
+    // earlier tool, matching the official lsp-stdio load contract.
+    const servers = await resolveServers(ctx, resolved.servers);
+    const sandbox = new FormatSandboxController(ctx);
+    const client = new LspActionClient(ctx.subprocess, ctx.fs, resolved.maxDocumentBytes);
+    // `ctx.lsp` is an optional capability: typed required by the seam package, absent at runtime in
+    // compositions without a provider. Consume it structurally and lazily, never by import or by an
+    // apply-time snapshot — the seam may load after this plugin or be re-added mid-session.
+    const getSeam = () => ctx.get('lsp');
+    const runner = createActionRunner({ getSeam, client, servers });
+    ctx.effect(() => {
+        registerDiagnosticsTool(ctx, runner, resolved);
+        registerCompletionTool(ctx, runner, resolved);
+        registerFormatTool(ctx, runner, sandbox, resolved);
+        registerCodeActionTool(ctx, runner, resolved);
+        registerSymbolsTool(ctx, runner, resolved);
+        registerSignatureTool(ctx, runner, resolved);
+        registerInlayHintsTool(ctx, runner, resolved);
+        registerRenameTool(ctx, runner, sandbox, resolved);
+        return async () => {
+            await client.disposeAll();
+        };
+    }, 'lsp-actions.registerTools');
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/render.d.ts

@@ -0,0 +1,364 @@
+/**
+ * Pure formatting and presentation for the three LSP action tools: severity-labeled diagnostic
+ * text, completion listings marked as reference-only, bounded result truncation, and the pure
+ * UI card presenters. No I/O — a UI may call the presenters on live streaming and on replay, so
+ * they depend only on tool arguments (and persisted result metadata).
+ * @module dsh-lsp-actions/render
+ */
+import type { GenericCallView, GenericResultView, DiffResultView, ToolResult } from '@deepseek-ai/dsh-tools';
+/** The human-readable label for a numeric LSP symbol/completion kind. */
+export declare function symbolKindLabel(kind: number): string;
+/** Projected metadata shapes persisted with the session log (pure projections of canonical values). */
+export interface DiagnosticsCardMeta {
+    readonly diagnostics: readonly {
+        readonly line: number;
+        readonly character?: number;
+        readonly severity: number;
+        readonly message: string;
+        readonly source?: string;
+        readonly code?: string | number;
+    }[];
+}
+export interface CompletionCardMeta {
+    readonly items: readonly {
+        readonly label: string;
+        readonly detail?: string;
+        readonly insertText?: string;
+    }[];
+}
+export interface FormatCardMeta {
+    readonly diffs: readonly {
+        readonly path: string;
+        readonly oldText: string | null;
+        readonly newText: string;
+    }[];
+}
+export interface CodeActionCardMeta {
+    readonly items: readonly {
+        readonly title: string;
+        readonly kind?: string;
+        readonly isPreferred?: boolean;
+    }[];
+}
+export interface SymbolsCardMeta {
+    readonly items: readonly {
+        readonly name: string;
+        readonly kind: number;
+        readonly location: {
+            readonly uri: string;
+            readonly line: number;
+            readonly character: number;
+        };
+    }[];
+}
+export interface SignaturesCardMeta {
+    readonly signatures: readonly {
+        readonly label: string;
+        readonly documentation?: string;
+    }[];
+}
+export interface InlayHintsCardMeta {
+    readonly items: readonly {
+        readonly line: number;
+        readonly character: number;
+        readonly label: string;
+    }[];
+}
+export interface RenameCardMeta {
+    readonly diffs: readonly {
+        readonly path: string;
+        readonly oldText: string | null;
+        readonly newText: string;
+    }[];
+}
+/**
+ * Format a diagnostics result as model-facing text: one `path:line:character  [Severity] message`
+ * line per diagnostic, an omission marker past `maxDiagnostics`, then the complete result cap.
+ * @param filePath - the diagnosed file (all diagnostics belong to it).
+ * @param diagnostics - the already count-capped diagnostics (the canonical schema's projection).
+ * @param maxResultChars - the complete rendered-text cap, including truncation metadata.
+ * @returns the rendered text; a distinct no-result line when there are none.
+ */
+export declare function formatDiagnostics(filePath: string, diagnostics: readonly {
+    severity: number;
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+    };
+    message: string;
+    source?: string;
+    code?: string | number;
+}[], maxResultChars: number): string;
+/**
+ * Format a completion result as model-facing text. The header marks the items as reference-only:
+ * nothing was executed, and applying one is the model's own write/edit decision. Each item shows
+ * its label and detail, plus the actual insertion text (textEdit.newText, else insertText, else
+ * the label) on an indented `→` line when it adds information — the label alone is often not what
+ * the server would insert.
+ * @param filePath - the completed file.
+ * @param line - the one-based cursor line.
+ * @param character - the one-based cursor character.
+ * @param items - the already count-capped items (the canonical schema's projection).
+ * @param maxResultChars - the complete rendered-text cap, including truncation metadata.
+ * @returns the rendered text; a distinct no-result line when there are none.
+ */
+export declare function formatCompletionList(filePath: string, line: number, character: number, items: readonly {
+    label: string;
+    detail?: string;
+    insertText?: string;
+    textEdit?: {
+        newText: string;
+    };
+}[], maxResultChars: number): string;
+/**
+ * Format a formatting outcome as one model-facing line; the UI diff card carries the applied
+ * change, so the text stays a summary and the model re-reads the file for the full result. The
+ * optional one-based line span names how much of the file changed, so the model can decide whether
+ * a re-read is worth the tokens.
+ * @param filePath - the formatted file.
+ * @param appliedEdits - how many edits were applied.
+ * @param linesChanged - the one-based line span the edits touch; omitted keeps the bare summary.
+ * @returns the summary text.
+ */
+export declare function formatAppliedEdits(filePath: string, appliedEdits: number, linesChanged?: number): string;
+/**
+ * Format a code action result as model-facing text: one numbered line per action, then each
+ * action's edits with the replacement text. Reference-only — nothing is applied, and a command
+ * form is reported but never executed.
+ * @param filePath - the file actions were requested for.
+ * @param items - the normalized actions (edits in the uri→list projection).
+ * @param maxResultChars - the complete rendered-text cap.
+ * @returns the rendered text.
+ */
+export declare function formatCodeActions(filePath: string, items: readonly {
+    title: string;
+    kind?: string;
+    isPreferred?: boolean;
+    edits?: readonly {
+        uri: string;
+        edits: readonly {
+            range: {
+                start: {
+                    line: number;
+                    character: number;
+                };
+            };
+            newText: string;
+        }[];
+    }[];
+    command?: {
+        readonly title: string;
+        readonly command: string;
+    };
+}[], maxResultChars: number): string;
+/**
+ * Format a symbol result as model-facing text: one `name [Kind] at uri:line:col` line per symbol.
+ * @param items - the normalized symbols.
+ * @param maxResultChars - the complete rendered-text cap.
+ * @returns the rendered text.
+ */
+export declare function formatSymbols(items: readonly {
+    name: string;
+    kind: number;
+    location: {
+        uri: string;
+        range: {
+            start: {
+                line: number;
+                character: number;
+            };
+        };
+    };
+    containerName?: string;
+}[], maxResultChars: number): string;
+/**
+ * Format a signature help result as model-facing text: the signatures with the active one and
+ * active parameter marked, plus parameter labels and documentation.
+ * @param filePath - the completed file.
+ * @param signatures - the normalized signatures.
+ * @param activeSignature - the server's active signature index.
+ * @param activeParameter - the server's active parameter index.
+ * @param maxResultChars - the complete rendered-text cap.
+ * @returns the rendered text.
+ */
+export declare function formatSignatures(filePath: string, signatures: readonly {
+    label: string;
+    documentation?: string;
+    parameters?: readonly {
+        label: string;
+        documentation?: string;
+    }[];
+}[], activeSignature: number | undefined, activeParameter: number | undefined, maxResultChars: number): string;
+/**
+ * Format an inlay hint result as model-facing text: one `line:col label` line per hint.
+ * @param filePath - the hinted file.
+ * @param items - the normalized hints.
+ * @param maxResultChars - the complete rendered-text cap.
+ * @returns the rendered text.
+ */
+export declare function formatInlayHints(filePath: string, items: readonly {
+    position: {
+        line: number;
+        character: number;
+    };
+    label: string;
+    kind?: number;
+}[], maxResultChars: number): string;
+/**
+ * Format a rename outcome as one model-facing line; the UI diff cards carry the applied changes
+ * per file, so the text stays a summary and the model re-reads the files for the full result.
+ * @param filePath - the file the rename was requested in.
+ * @param line - the one-based cursor line.
+ * @param character - the one-based cursor character.
+ * @param newName - the new symbol name.
+ * @param appliedEdits - how many edits were applied across the workspace.
+ * @param filesChanged - how many files changed.
+ * @returns the summary text.
+ */
+export declare function formatRenameResult(filePath: string, line: number, character: number, newName: string, appliedEdits: number, filesChanged: number): string;
+/** The raw, schema-typed argument shapes the presenters soft-validate against. */
+export interface DiagnosticsToolArgs {
+    readonly file_path: string;
+}
+export interface CompletionToolArgs {
+    readonly file_path: string;
+    readonly line: number;
+    readonly character: number;
+}
+export interface FormatToolArgs {
+    readonly file_path: string;
+}
+/**
+ * Pending-state presenter for `lsp_diagnostics`: a generic search card focused on the file.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspDiagnosticsCall(args: DiagnosticsToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_diagnostics`: severity-labeled lines rebuilt from the
+ * persisted projection, with a follow-along location on the first diagnostic.
+ * @param _args - the raw tool arguments (unused; the projection carries the result facts).
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspDiagnosticsResult(_args: DiagnosticsToolArgs, result: ToolResult): GenericResultView | undefined;
+/**
+ * Pending-state presenter for `lsp_completion`: a generic search card at the cursor.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspCompletionCall(args: CompletionToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_completion`: the reference-only item list rebuilt from the
+ * persisted projection.
+ * @param args - the raw tool arguments (used for the title).
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspCompletionResult(args: CompletionToolArgs, result: ToolResult): GenericResultView | undefined;
+/**
+ * Pending-state presenter for `lsp_format`: the diff exists only after the server answers, so the
+ * pending card is a generic edit card; the completed diff card replaces it.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspFormatCall(args: FormatToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_format`: the applied whole-file diff rebuilt from the
+ * persisted projection, so replay reproduces the card without re-reading the file.
+ * @param args - the raw tool arguments (used for the title).
+ * @param result - the completed tool result.
+ * @returns the diff result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspFormatResult(args: FormatToolArgs, result: ToolResult): DiffResultView | undefined;
+export interface CodeActionToolArgs {
+    readonly file_path: string;
+}
+export interface SymbolsToolArgs {
+    readonly query?: string;
+    readonly file_path?: string;
+}
+export interface SignatureToolArgs {
+    readonly file_path: string;
+    readonly line: number;
+    readonly character: number;
+}
+export interface InlayHintsToolArgs {
+    readonly file_path: string;
+}
+/**
+ * Pending-state presenter for `lsp_code_action`: a generic search card on the file.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspCodeActionCall(args: CodeActionToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_code_action`: the reference-only action list.
+ * @param _args - the raw tool arguments.
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspCodeActionResult(_args: CodeActionToolArgs, result: ToolResult): GenericResultView | undefined;
+/**
+ * Pending-state presenter for `lsp_symbols`: a generic search card.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspSymbolsCall(args: SymbolsToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_symbols`: name, kind, and location lines.
+ * @param _args - the raw tool arguments.
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspSymbolsResult(_args: SymbolsToolArgs, result: ToolResult): GenericResultView | undefined;
+/**
+ * Pending-state presenter for `lsp_signature`: a generic search card at the cursor.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspSignatureCall(args: SignatureToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_signature`: the signature labels.
+ * @param _args - the raw tool arguments.
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspSignatureResult(_args: SignatureToolArgs, result: ToolResult): GenericResultView | undefined;
+/**
+ * Pending-state presenter for `lsp_inlay_hints`: a generic search card on the file.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspInlayHintsCall(args: InlayHintsToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_inlay_hints`: one line per hint.
+ * @param _args - the raw tool arguments.
+ * @param result - the completed tool result.
+ * @returns the generic result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspInlayHintsResult(_args: InlayHintsToolArgs, result: ToolResult): GenericResultView | undefined;
+export interface RenameToolArgs {
+    readonly file_path: string;
+    readonly line: number;
+    readonly character: number;
+    readonly new_name: string;
+}
+/**
+ * Pending-state presenter for `lsp_rename`: the diffs exist only after the server answers, so the
+ * pending card is a generic edit card; the completed diff cards replace it.
+ * @param args - the raw tool arguments.
+ * @returns the generic call view.
+ */
+export declare function presentLspRenameCall(args: RenameToolArgs): GenericCallView;
+/**
+ * Completed-state presenter for `lsp_rename`: one applied diff card per changed file, rebuilt
+ * from the persisted projection so replay reproduces the cards without re-reading the files.
+ * @param args - the raw tool arguments (used for the title).
+ * @param result - the completed tool result.
+ * @returns the diff result view, or undefined to keep the fallback card.
+ */
+export declare function presentLspRenameResult(args: RenameToolArgs, result: ToolResult): DiffResultView | undefined;
+//# sourceMappingURL=render.d.ts.map