dsh-lsp-actions 0.2.0

package/lib/extra-tools.js

@@ -0,0 +1,406 @@
+/**
+ * The extended read-only LSP action tools: `lsp_code_action` (server-verified quickfixes, never
+ * applied), `lsp_symbols` (workspace-wide or per-document symbol search), `lsp_signature`
+ * (signature help at a cursor), and `lsp_inlay_hints` (server type/parameter hints). All four are
+ * read-only: results are reference material, and applying anything is the model's own write/edit
+ * decision. All declare `timeoutMs` for the official timeout policy and observe `exec.signal`.
+ * @module dsh-lsp-actions/extra-tools
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { OUTPUT_RANGE_SCHEMA, parseCursor, parseFilePath, parseOptionalRange, POSITION_SCHEMA, prepareRequest, requireWorkspace } from "./tools.js";
+import { formatCodeActions, formatInlayHints, formatSignatures, formatSymbols, presentLspCodeActionCall, presentLspCodeActionResult, presentLspInlayHintsCall, presentLspInlayHintsResult, presentLspSignatureCall, presentLspSignatureResult, presentLspSymbolsCall, presentLspSymbolsResult, symbolKindLabel, } from "./render.js";
+/** The one-based range schema, shared by the range-accepting extended tools. */
+const RANGE_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    description: 'Optional selection as one-based UTF-16 line/character (cursor convention); omit for the whole file.',
+    properties: {
+        start: { type: 'object', additionalProperties: false, required: true, properties: { line: { type: 'integer', required: true }, character: { type: 'integer', required: true } } },
+        end: { type: 'object', additionalProperties: false, required: true, properties: { line: { type: 'integer', required: true }, character: { type: 'integer', required: true } } },
+    },
+};
+/**
+ * Register the `lsp_code_action` tool: server-verified fixes for a range (or the first
+ * diagnostic's range) as reference-only items — the tool never applies edits or runs commands.
+ * @param ctx - the plugin context.
+ * @param runner - the seam-first action runner.
+ * @param config - the resolved plugin configuration.
+ */
+export function registerCodeActionTool(ctx, runner, config) {
+    ctx.tools.register(defineTool({
+        name: 'lsp_code_action',
+        description: 'Request server-verified code actions (quickfixes, refactorings) for a range — or for the first reported diagnostic when no range is given. Reference-only: edits and commands are reported, never applied — apply an action\'s edits yourself with write/edit.',
+        parameters: {
+            file_path: { type: 'string', required: true, description: 'The source file, relative to the workspace or absolute.' },
+            range: RANGE_SCHEMA,
+            only: {
+                type: 'array',
+                description: 'Optional CodeActionKind filters, e.g. ["quickfix"], ["refactor"].',
+                items: { type: 'string' },
+            },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'codeActions' },
+                    file_path: { type: 'string', required: true },
+                    range: {
+                        type: 'object',
+                        additionalProperties: false,
+                        properties: {
+                            start: { ...POSITION_SCHEMA, required: true },
+                            end: { ...POSITION_SCHEMA, required: true },
+                        },
+                    },
+                    items: {
+                        type: 'array',
+                        required: true,
+                        items: {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                title: { type: 'string', required: true },
+                                kind: { type: 'string' },
+                                isPreferred: { type: 'boolean' },
+                                edits: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                        additionalProperties: false,
+                                        properties: {
+                                            uri: { type: 'string', required: true },
+                                            edits: {
+                                                type: 'array',
+                                                required: true,
+                                                items: {
+                                                    type: 'object',
+                                                    additionalProperties: false,
+                                                    properties: {
+                                                        range: { ...OUTPUT_RANGE_SCHEMA, required: true },
+                                                        newText: { type: 'string', required: true },
+                                                    },
+                                                },
+                                            },
+                                        },
+                                    },
+                                },
+                                command: {
+                                    type: 'object',
+                                    additionalProperties: false,
+                                    properties: {
+                                        title: { type: 'string', required: true },
+                                        command: { type: 'string', required: true },
+                                        arguments: { type: 'array' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    truncated: { type: 'boolean', required: true },
+                    total: { type: 'integer', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: formatCodeActions(value.file_path, value.items, config.maxResultChars) }],
+            presentationMeta: (_args, value) => ({
+                items: value.items.map((item) => ({
+                    title: item.title,
+                    ...item.kind === undefined ? {} : { kind: item.kind },
+                    ...item.isPreferred === undefined ? {} : { isPreferred: item.isPreferred },
+                })),
+            }),
+        },
+        timeoutMs: config.timeoutMs,
+        async execute(args, exec) {
+            const filePath = parseFilePath(args.file_path);
+            const workspaceRoot = requireWorkspace(exec);
+            const wireRange = parseOptionalRange(args.range);
+            const request = await prepareRequest(ctx, config, filePath, workspaceRoot, exec);
+            const result = await runner.codeActions({
+                ...request,
+                ...wireRange === undefined ? {} : { range: wireRange },
+                ...args.only === undefined || args.only.length === 0 ? {} : { onlyKinds: args.only },
+            }, exec.signal);
+            const capped = result.items.slice(0, config.maxCodeActions);
+            // Project the grouped edit record into the schema-friendly uri→edits list form.
+            const items = capped.map(action => ({
+                title: action.title,
+                ...action.kind === undefined ? {} : { kind: action.kind },
+                ...action.isPreferred === undefined ? {} : { isPreferred: action.isPreferred },
+                edits: Object.entries(action.edits).map(([uri, edits]) => ({
+                    uri,
+                    edits: edits.map(edit => ({ range: edit.range, newText: edit.newText })),
+                })),
+                ...action.command === undefined ? {} : {
+                    command: {
+                        title: action.command.title,
+                        command: action.command.command,
+                        ...Array.isArray(action.command.arguments) ? { arguments: action.command.arguments } : {},
+                    },
+                },
+            }));
+            return {
+                kind: 'codeActions',
+                file_path: filePath,
+                // Echo the caller's one-based range (the model-facing convention), not the wire range.
+                ...args.range === undefined ? {} : { range: args.range },
+                items,
+                truncated: result.items.length > capped.length,
+                total: result.items.length,
+            };
+        },
+        presentCall: presentLspCodeActionCall,
+        presentResult: presentLspCodeActionResult,
+    }));
+}
+/**
+ * Register the `lsp_symbols` tool: workspace-wide symbol search by name (`query`) or a per-file
+ * symbol outline (`file_path` without `query`). At least one of the two must be supplied.
+ * @param ctx - the plugin context.
+ * @param runner - the seam-first action runner.
+ * @param config - the resolved plugin configuration.
+ */
+export function registerSymbolsTool(ctx, runner, config) {
+    ctx.tools.register(defineTool({
+        name: 'lsp_symbols',
+        description: 'Search symbols: with query, a workspace-wide name search through the language server; with file_path but no query, the symbol outline of one file. Read-only.',
+        parameters: {
+            query: { type: 'string', description: 'The symbol name to search across the workspace (substring match).' },
+            file_path: { type: 'string', description: 'Restrict the search to one file\'s symbols when query is omitted; with query, the file only routes the server selection.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'symbols' },
+                    items: {
+                        type: 'array',
+                        required: true,
+                        items: {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                name: { type: 'string', required: true },
+                                kind: { type: 'integer', required: true },
+                                location: {
+                                    type: 'object',
+                                    additionalProperties: false,
+                                    required: true,
+                                    properties: {
+                                        uri: { type: 'string', required: true },
+                                        range: { ...OUTPUT_RANGE_SCHEMA, required: true },
+                                    },
+                                },
+                                containerName: { type: 'string' },
+                            },
+                        },
+                    },
+                    truncated: { type: 'boolean', required: true },
+                    total: { type: 'integer', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: formatSymbols(value.items, config.maxResultChars) }],
+            presentationMeta: (_args, value) => ({
+                items: value.items.map((item) => ({
+                    name: item.name,
+                    kind: item.kind,
+                    location: {
+                        uri: item.location.uri,
+                        line: item.location.range.start.line + 1,
+                        character: item.location.range.start.character + 1,
+                    },
+                })),
+            }),
+        },
+        timeoutMs: config.timeoutMs,
+        async execute(args, exec) {
+            if ((args.query ?? '').trim() === '' && (args.file_path ?? '').trim() === '') {
+                throw new Error('lsp_symbols requires a non-empty query or file_path');
+            }
+            const workspaceRoot = requireWorkspace(exec);
+            const project = (result) => {
+                const capped = result.items.slice(0, config.maxSymbols);
+                return { items: [...capped], truncated: result.items.length > capped.length, total: result.items.length };
+            };
+            if (args.query !== undefined && args.query.trim() !== '') {
+                // Workspace-wide search. The optional file_path routes the server selection and, when
+                // given, is kept transiently open so project-based servers (tsls) can serve the search.
+                const query = args.query.trim();
+                if (args.file_path !== undefined && args.file_path.trim() !== '') {
+                    const filePath = parseFilePath(args.file_path);
+                    const request = await prepareRequest(ctx, config, filePath, workspaceRoot, exec);
+                    const result = await runner.workspaceSymbols({ ...request, query }, exec.signal);
+                    return { kind: 'symbols', ...project(result) };
+                }
+                const result = await runner.workspaceSymbols({ filePath: '', workspaceRoot, query }, exec.signal);
+                return { kind: 'symbols', ...project(result) };
+            }
+            const filePath = parseFilePath(args.file_path);
+            const request = await prepareRequest(ctx, config, filePath, workspaceRoot, exec);
+            const result = await runner.documentSymbols(request, exec.signal);
+            return { kind: 'symbols', ...project(result) };
+        },
+        presentCall: presentLspSymbolsCall,
+        presentResult: presentLspSymbolsResult,
+    }));
+}
+/**
+ * Register the `lsp_signature` tool: signature help at a cursor position.
+ * @param ctx - the plugin context.
+ * @param runner - the seam-first action runner.
+ * @param config - the resolved plugin configuration.
+ */
+export function registerSignatureTool(ctx, runner, config) {
+    ctx.tools.register(defineTool({
+        name: 'lsp_signature',
+        description: 'Request signature help (parameter list and documentation) at a one-based UTF-16 cursor position from the file\'s language server. Read-only.',
+        parameters: {
+            file_path: { type: 'string', required: true, description: 'The source file, relative to the workspace or absolute.' },
+            line: { type: 'integer', required: true, description: 'One-based line of the cursor (inside the call).' },
+            character: { type: 'integer', required: true, description: 'One-based UTF-16 column of the cursor.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'signatures' },
+                    file_path: { type: 'string', required: true },
+                    signatures: {
+                        type: 'array',
+                        required: true,
+                        items: {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                label: { type: 'string', required: true },
+                                documentation: { type: 'string' },
+                                parameters: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                        additionalProperties: false,
+                                        properties: {
+                                            label: { type: 'string', required: true },
+                                            documentation: { type: 'string' },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    activeSignature: { type: 'integer' },
+                    activeParameter: { type: 'integer' },
+                },
+            },
+            render: (args, value) => [{ type: 'text', text: formatSignatures(value.file_path, value.signatures, value.activeSignature, value.activeParameter, config.maxResultChars) }],
+            presentationMeta: (_args, value) => ({
+                signatures: value.signatures.map((signature) => ({
+                    label: signature.label,
+                    ...signature.documentation === undefined ? {} : { documentation: signature.documentation },
+                })),
+            }),
+        },
+        timeoutMs: config.timeoutMs,
+        async execute(args, exec) {
+            const filePath = parseFilePath(args.file_path);
+            const position = parseCursor(args.line, args.character);
+            const workspaceRoot = requireWorkspace(exec);
+            const request = await prepareRequest(ctx, config, filePath, workspaceRoot, exec);
+            const result = await runner.signatureHelp({ ...request, position }, exec.signal);
+            const signatures = result.signatures.slice(0, config.maxSignatures).map((signature) => ({
+                label: signature.label,
+                ...signature.documentation === undefined ? {} : { documentation: signature.documentation },
+                ...signature.parameters === undefined ? {} : {
+                    parameters: signature.parameters.map(parameter => ({
+                        label: parameter.label,
+                        ...parameter.documentation === undefined ? {} : { documentation: parameter.documentation },
+                    })),
+                },
+            }));
+            return {
+                kind: 'signatures',
+                file_path: filePath,
+                signatures,
+                ...result.activeSignature === undefined ? {} : { activeSignature: result.activeSignature },
+                ...result.activeParameter === undefined ? {} : { activeParameter: result.activeParameter },
+            };
+        },
+        presentCall: presentLspSignatureCall,
+        presentResult: presentLspSignatureResult,
+    }));
+}
+/**
+ * Register the `lsp_inlay_hints` tool: server type/parameter inlay hints for a file or range.
+ * @param ctx - the plugin context.
+ * @param runner - the seam-first action runner.
+ * @param config - the resolved plugin configuration.
+ */
+export function registerInlayHintsTool(ctx, runner, config) {
+    ctx.tools.register(defineTool({
+        name: 'lsp_inlay_hints',
+        description: 'Request inlay hints (type annotations, parameter names) for a file or a one-based selection from its language server. Read-only.',
+        parameters: {
+            file_path: { type: 'string', required: true, description: 'The source file, relative to the workspace or absolute.' },
+            range: RANGE_SCHEMA,
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    kind: { type: 'string', required: true, const: 'inlayHints' },
+                    file_path: { type: 'string', required: true },
+                    items: {
+                        type: 'array',
+                        required: true,
+                        items: {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                position: { ...POSITION_SCHEMA, required: true },
+                                label: { type: 'string', required: true },
+                                kind: { type: 'integer' },
+                                paddingLeft: { type: 'boolean' },
+                                paddingRight: { type: 'boolean' },
+                            },
+                        },
+                    },
+                    truncated: { type: 'boolean', required: true },
+                    total: { type: 'integer', required: true },
+                },
+            },
+            render: (_args, value) => [{ type: 'text', text: formatInlayHints(value.file_path, value.items, config.maxResultChars) }],
+            presentationMeta: (_args, value) => ({
+                items: value.items.map((item) => ({
+                    line: item.position.line + 1,
+                    character: item.position.character + 1,
+                    label: item.label,
+                })),
+            }),
+        },
+        timeoutMs: config.timeoutMs,
+        async execute(args, exec) {
+            const filePath = parseFilePath(args.file_path);
+            const workspaceRoot = requireWorkspace(exec);
+            const range = parseOptionalRange(args.range);
+            const request = await prepareRequest(ctx, config, filePath, workspaceRoot, exec);
+            const result = await runner.inlayHints({ ...request, ...range === undefined ? {} : { range } }, exec.signal);
+            const capped = result.items.slice(0, config.maxInlayHints);
+            return {
+                kind: 'inlayHints',
+                file_path: filePath,
+                items: capped,
+                truncated: result.items.length > capped.length,
+                total: result.items.length,
+            };
+        },
+        presentCall: presentLspInlayHintsCall,
+        presentResult: presentLspInlayHintsResult,
+    }));
+}
+/** The human-readable label for a numeric symbol kind, re-exported for tests. */
+export { symbolKindLabel };
+//# sourceMappingURL=extra-tools.js.map

package/lib/extra-tools.js.map

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

package/lib/framing.d.ts

@@ -0,0 +1,33 @@
+/**
+ * LSP stdio framing: `Content-Length`-prefixed JSON messages, encode side and incremental decode
+ * side. The decoder retains only one incomplete message plus a bounded header window and rejects
+ * oversize, malformed, or unterminated frames — the stream position is then unrecoverable, so the
+ * connection fails fast instead of guessing.
+ * @module dsh-lsp-actions/framing
+ */
+import { Buffer } from 'node:buffer';
+/**
+ * Encode one JSON-RPC message as a Content-Length framed buffer.
+ * @param message - the JSON-serializable message.
+ * @returns the framed bytes (header + UTF-8 body).
+ */
+export declare function encodeMessage(message: unknown): Buffer;
+/**
+ * Incremental LSP message decoder over an incoming byte stream.
+ */
+export declare class MessageDecoder {
+    private readonly maxMessageBytes;
+    private buffer;
+    /**
+     * @param maxMessageBytes - largest single framed message accepted; exceeding it is fatal.
+     */
+    constructor(maxMessageBytes: number);
+    /**
+     * Feed a chunk of bytes and drain every complete message.
+     * @param chunk - newly received bytes.
+     * @returns the decoded messages in delivery order.
+     * @throws Error on an oversized frame, a missing Content-Length header, or invalid JSON.
+     */
+    push(chunk: Buffer): unknown[];
+}
+//# sourceMappingURL=framing.d.ts.map

package/lib/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOpC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,eAAe;IAL5C,OAAO,CAAC,MAAM,CAAkB;IAEhC;;OAEG;gBAC0B,eAAe,EAAE,MAAM;IAMpD;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;CAiC/B"}

package/lib/framing.js

@@ -0,0 +1,80 @@
+/**
+ * LSP stdio framing: `Content-Length`-prefixed JSON messages, encode side and incremental decode
+ * side. The decoder retains only one incomplete message plus a bounded header window and rejects
+ * oversize, malformed, or unterminated frames — the stream position is then unrecoverable, so the
+ * connection fails fast instead of guessing.
+ * @module dsh-lsp-actions/framing
+ */
+import { Buffer } from 'node:buffer';
+/** Largest retained header window when no `\r\n\r\n` terminator has arrived yet. */
+const MAX_HEADER_BYTES = 64 * 1024;
+const HEADER_TERMINATOR = '\r\n\r\n';
+/**
+ * Encode one JSON-RPC message as a Content-Length framed buffer.
+ * @param message - the JSON-serializable message.
+ * @returns the framed bytes (header + UTF-8 body).
+ */
+export function encodeMessage(message) {
+    const body = Buffer.from(JSON.stringify(message), 'utf8');
+    const header = Buffer.from(`Content-Length: ${body.byteLength}${HEADER_TERMINATOR}`, 'ascii');
+    return Buffer.concat([header, body]);
+}
+/**
+ * Incremental LSP message decoder over an incoming byte stream.
+ */
+export class MessageDecoder {
+    maxMessageBytes;
+    buffer = Buffer.alloc(0);
+    /**
+     * @param maxMessageBytes - largest single framed message accepted; exceeding it is fatal.
+     */
+    constructor(maxMessageBytes) {
+        this.maxMessageBytes = maxMessageBytes;
+        if (!Number.isInteger(maxMessageBytes) || maxMessageBytes < 1) {
+            throw new Error('maxMessageBytes must be a positive integer');
+        }
+    }
+    /**
+     * Feed a chunk of bytes and drain every complete message.
+     * @param chunk - newly received bytes.
+     * @returns the decoded messages in delivery order.
+     * @throws Error on an oversized frame, a missing Content-Length header, or invalid JSON.
+     */
+    push(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        const messages = [];
+        for (;;) {
+            const headerEnd = this.buffer.indexOf(HEADER_TERMINATOR);
+            if (headerEnd < 0) {
+                if (this.buffer.length > MAX_HEADER_BYTES) {
+                    throw new Error(`LSP stream sent ${this.buffer.length} bytes without a header terminator`);
+                }
+                break;
+            }
+            const header = this.buffer.subarray(0, headerEnd).toString('ascii');
+            const match = /^Content-Length: (\d+)\s*$/m.exec(header);
+            if (match === null)
+                throw new Error('LSP frame header is missing Content-Length');
+            const length = Number(match[1]);
+            if (!Number.isSafeInteger(length) || length < 0) {
+                throw new Error(`invalid Content-Length "${match[1]}"`);
+            }
+            if (length > this.maxMessageBytes) {
+                throw new Error(`LSP message of ${length} bytes exceeds the ${this.maxMessageBytes}-byte limit`);
+            }
+            const start = headerEnd + HEADER_TERMINATOR.length;
+            if (this.buffer.length < start + length)
+                break;
+            const body = this.buffer.subarray(start, start + length);
+            this.buffer = this.buffer.subarray(start + length);
+            try {
+                messages.push(JSON.parse(body.toString('utf8')));
+            }
+            catch {
+                throw new Error('LSP message body is not valid JSON');
+            }
+        }
+        return messages;
+    }
+}
+//# sourceMappingURL=framing.js.map

package/lib/framing.js.map

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

package/lib/host.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 type { FileSystem, FsTarget } from '@deepseek-ai/dsh-fs';
+/** A canonical workspace in the filesystem/subprocess execution world. */
+export interface HostWorkspace {
+    /** Stable filesystem identity used for client pooling. */
+    readonly target: FsTarget;
+    /** Canonical absolute path accepted as a subprocess cwd. */
+    readonly canonicalPath: string;
+    /** Canonical file URI sent during LSP initialization. */
+    readonly fileUrl: string;
+}
+/** A validated source and the exact URI sent to the language server. */
+export interface HostSource {
+    /** The resolved file target, for observations and guarded writes. */
+    readonly target: FsTarget;
+    /** Canonical file URI in the execution world's platform syntax. */
+    readonly fileUrl: string;
+    /** Current complete UTF-8 text. */
+    readonly text: string;
+    /** Opaque freshness token of the target at read time, for guarded writes and observations. */
+    readonly version?: import('@deepseek-ai/dsh-fs').FsVersion;
+}
+/**
+ * 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 declare function canonicalizeWorkspace(fs: FileSystem, workspaceRoot: string, signal?: AbortSignal): Promise<HostWorkspace>;
+/**
+ * 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 declare function readHostSource(fs: FileSystem, filePath: string, workspace: HostWorkspace, maxDocumentBytes: number, signal?: AbortSignal): Promise<HostSource>;
+/** Throw the signal's abort reason when the signal has fired. */
+export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+/** Normalize a `file:` URI for identity comparison: decoded path, case-folded on Windows. */
+export declare function normalizeFileUri(uri: string): string;
+/** Decode a `file:` URI's percent escapes without case-folding, so path slicing stays exact. */
+export declare function decodeFileUri(uri: string): string;
+/**
+ * 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 declare function workspaceRelativePath(workspace: HostWorkspace, uri: string): string | undefined;
+//# sourceMappingURL=host.d.ts.map

package/lib/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE/D,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,SAAS,CAAA;CAC3D;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,EACxB,gBAAgB,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA+CrB;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAEpE;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ/F"}