@tianshu-ai/tianshu 0.3.0

package/packages/server/dist/lsp/client.d.ts

@@ -0,0 +1,53 @@
+import type { Diagnostic } from "vscode-languageserver-types";
+import type { LanguageDefinition } from "./language-registry.js";
+export type { Diagnostic };
+export interface LSPClientOptions {
+    language: LanguageDefinition;
+    /** Workspace root the LS will be scoped to. Absolute path,
+     *  must be inside the tenant's workspace boundary (caller
+     *  enforces). */
+    root: string;
+    /** Optional logger. Falls back to no-op. */
+    log?: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+export declare class LSPClient {
+    private proc;
+    private conn;
+    private opts;
+    private log;
+    /** Latest diagnostics keyed by absolute file path, replaced on
+     *  every publishDiagnostics. */
+    private diagnostics;
+    /** Wall-clock ms of the most recent publish per file, used by
+     *  `waitForDiagnostics` to know "is this fresh?" */
+    private lastPublishMs;
+    /** Pending listeners waiting for a fresh publish for a given file. */
+    private waiters;
+    /** Files we've already sent didOpen for. */
+    private openDocs;
+    private initialized;
+    private closed;
+    private closePromise;
+    private lastUsedMs;
+    constructor(opts: LSPClientOptions);
+    /** Run the LSP initialize handshake. Throws on timeout. Idempotent. */
+    init(): Promise<void>;
+    /** Tell the LS the contents of a file. First call is didOpen;
+     *  subsequent calls are didChange (full sync). */
+    notifyChanged(absPath: string, contents: string): void;
+    /** Block up to `timeoutMs` for diagnostics fresh enough to
+     *  reflect the most recent `notifyChanged`. Returns whatever's
+     *  in the cache for this file (may be empty array if no errors,
+     *  or null if no publish ever arrived). */
+    waitForDiagnostics(absPath: string, sinceMs: number, timeoutMs: number): Promise<Diagnostic[] | null>;
+    private removeWaiter;
+    /** ms since last activity, used by manager LRU/idle eviction. */
+    idleMs(): number;
+    isClosed(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/packages/server/dist/lsp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lsp/client.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKjE,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;qBAEiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC9B,CAAC;CACH;AAcD,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,GAAG,CAAuC;IAElD;oCACgC;IAChC,OAAO,CAAC,WAAW,CAAmC;IAEtD;wDACoD;IACpD,OAAO,CAAC,aAAa,CAA6B;IAElD,sEAAsE;IACtE,OAAO,CAAC,OAAO,CAAwC;IAEvD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAE9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,UAAU,CAAc;gBAEpB,IAAI,EAAE,gBAAgB;IAuElC,uEAAuE;IACjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;sDACkD;IAClD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA4BtD;;;+CAG2C;IACrC,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IAqB/B,OAAO,CAAC,YAAY;IAQpB,iEAAiE;IACjE,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,OAAO;IAIb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B7B"}

package/packages/server/dist/lsp/client.js

@@ -0,0 +1,258 @@
+// Minimal LSP client: spawn a language-server process, run the
+// initialize handshake, push file contents via didOpen/didChange,
+// listen for publishDiagnostics, expose a synchronous-ish
+// `waitForDiagnostics(file, timeoutMs)` for the edit/write tools.
+//
+// Modelled on OpenCode's lsp/client.ts (sst/opencode) but trimmed:
+//   - push diagnostics only (no pull / textDocument/diagnostic);
+//     all three v0.1 servers (typescript / gopls / pyright)
+//     publish without us asking.
+//   - no dynamic capability registration listener.
+//   - no document version tracking; we send incrementing ints
+//     and don't validate echoes.
+//   - hard timeouts at every blocking step so a wedged LS can't
+//     wedge an edit_file call.
+//
+// The client is owned by LSPManager: one per (tenant, language,
+// root) tuple. The client doesn't know about tenants — that
+// scoping happens one layer up.
+import { spawn } from "node:child_process";
+import { pathToFileURL } from "node:url";
+import path from "node:path";
+import { createMessageConnection, StreamMessageReader, StreamMessageWriter, } from "vscode-jsonrpc/node";
+const INIT_TIMEOUT_MS = 30_000;
+const SHUTDOWN_TIMEOUT_MS = 2_000;
+const noLog = {
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+export class LSPClient {
+    proc;
+    conn;
+    opts;
+    log;
+    /** Latest diagnostics keyed by absolute file path, replaced on
+     *  every publishDiagnostics. */
+    diagnostics = new Map();
+    /** Wall-clock ms of the most recent publish per file, used by
+     *  `waitForDiagnostics` to know "is this fresh?" */
+    lastPublishMs = new Map();
+    /** Pending listeners waiting for a fresh publish for a given file. */
+    waiters = new Map();
+    /** Files we've already sent didOpen for. */
+    openDocs = new Map();
+    initialized = false;
+    closed = false;
+    closePromise = null;
+    lastUsedMs = Date.now();
+    constructor(opts) {
+        this.opts = opts;
+        this.log = opts.log ?? noLog;
+        this.proc = spawn(opts.language.command, [...opts.language.args], {
+            cwd: opts.root,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.proc.on("exit", (code, signal) => {
+            this.closed = true;
+            if (code !== 0 && code !== null) {
+                this.log.warn(`lsp[${opts.language.id}] exited code=${code} signal=${signal}`);
+            }
+        });
+        this.proc.on("error", (err) => {
+            this.log.error(`lsp[${opts.language.id}] spawn error: ${String(err)}`);
+            this.closed = true;
+        });
+        this.proc.stderr?.on("data", (buf) => {
+            // gopls and pyright are noisy on stderr; downgrade to debug.
+            // We keep this discardable but log at debug level.
+            const text = buf.toString("utf8").trim();
+            if (text)
+                this.log.info(`lsp[${opts.language.id}] stderr: ${text}`);
+        });
+        if (!this.proc.stdout || !this.proc.stdin) {
+            throw new Error(`LSPClient: spawn produced no stdio for ${opts.language.id}`);
+        }
+        this.conn = createMessageConnection(new StreamMessageReader(this.proc.stdout), new StreamMessageWriter(this.proc.stdin));
+        // Diagnostics: route every publish into the local map and
+        // wake up any waiter that's parked on this file.
+        this.conn.onNotification("textDocument/publishDiagnostics", (params) => {
+            const filePath = uriToPath(params.uri);
+            if (!filePath)
+                return;
+            this.diagnostics.set(filePath, params.diagnostics);
+            this.lastPublishMs.set(filePath, Date.now());
+            const ws = this.waiters.get(filePath);
+            if (ws) {
+                this.waiters.delete(filePath);
+                for (const w of ws)
+                    w();
+            }
+        });
+        // Workspace folders + configuration: replies that satisfy
+        // most servers' init expectations without us configuring
+        // anything tenant-specific.
+        this.conn.onRequest("workspace/workspaceFolders", async () => [
+            { name: "workspace", uri: pathToFileURL(opts.root).href },
+        ]);
+        this.conn.onRequest("workspace/configuration", async () => null);
+        this.conn.onRequest("client/registerCapability", async () => null);
+        this.conn.onRequest("client/unregisterCapability", async () => null);
+        this.conn.onRequest("window/workDoneProgress/create", async () => null);
+        this.conn.listen();
+    }
+    /** Run the LSP initialize handshake. Throws on timeout. Idempotent. */
+    async init() {
+        if (this.initialized)
+            return;
+        const rootUri = pathToFileURL(this.opts.root).href;
+        await withTimeout(this.conn.sendRequest("initialize", {
+            processId: this.proc.pid ?? null,
+            rootUri,
+            workspaceFolders: [{ name: "workspace", uri: rootUri }],
+            capabilities: {
+                textDocument: {
+                    synchronization: { didOpen: true, didChange: true },
+                    publishDiagnostics: { versionSupport: false },
+                },
+                workspace: {
+                    configuration: true,
+                    workspaceFolders: true,
+                },
+            },
+        }), INIT_TIMEOUT_MS, `lsp[${this.opts.language.id}] initialize timed out`);
+        this.conn.sendNotification("initialized", {});
+        this.initialized = true;
+        this.log.info(`lsp[${this.opts.language.id}] ready (root=${this.opts.root})`);
+    }
+    /** Tell the LS the contents of a file. First call is didOpen;
+     *  subsequent calls are didChange (full sync). */
+    notifyChanged(absPath, contents) {
+        if (!this.initialized || this.closed)
+            return;
+        this.lastUsedMs = Date.now();
+        const uri = pathToFileURL(absPath).href;
+        const existing = this.openDocs.get(absPath);
+        if (!existing) {
+            this.conn.sendNotification("textDocument/didOpen", {
+                textDocument: {
+                    uri,
+                    languageId: this.opts.language.id,
+                    version: 1,
+                    text: contents,
+                },
+            });
+            this.openDocs.set(absPath, {
+                version: 1,
+                uri,
+                languageId: this.opts.language.id,
+            });
+            return;
+        }
+        existing.version += 1;
+        this.conn.sendNotification("textDocument/didChange", {
+            textDocument: { uri, version: existing.version },
+            contentChanges: [{ text: contents }],
+        });
+    }
+    /** Block up to `timeoutMs` for diagnostics fresh enough to
+     *  reflect the most recent `notifyChanged`. Returns whatever's
+     *  in the cache for this file (may be empty array if no errors,
+     *  or null if no publish ever arrived). */
+    async waitForDiagnostics(absPath, sinceMs, timeoutMs) {
+        this.lastUsedMs = Date.now();
+        const last = this.lastPublishMs.get(absPath) ?? 0;
+        if (last >= sinceMs) {
+            return this.diagnostics.get(absPath) ?? null;
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.removeWaiter(absPath, wake);
+                resolve(this.diagnostics.get(absPath) ?? null);
+            }, timeoutMs);
+            const wake = () => {
+                clearTimeout(timer);
+                resolve(this.diagnostics.get(absPath) ?? null);
+            };
+            const ws = this.waiters.get(absPath) ?? [];
+            ws.push(wake);
+            this.waiters.set(absPath, ws);
+        });
+    }
+    removeWaiter(absPath, w) {
+        const ws = this.waiters.get(absPath);
+        if (!ws)
+            return;
+        const idx = ws.indexOf(w);
+        if (idx >= 0)
+            ws.splice(idx, 1);
+        if (ws.length === 0)
+            this.waiters.delete(absPath);
+    }
+    /** ms since last activity, used by manager LRU/idle eviction. */
+    idleMs() {
+        return Date.now() - this.lastUsedMs;
+    }
+    isClosed() {
+        return this.closed;
+    }
+    async close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closePromise = (async () => {
+            try {
+                if (this.initialized && !this.closed) {
+                    // Best-effort graceful shutdown; ignore failures.
+                    await Promise.race([
+                        this.conn.sendRequest("shutdown"),
+                        new Promise((r) => setTimeout(r, SHUTDOWN_TIMEOUT_MS)),
+                    ]).catch(() => undefined);
+                    try {
+                        this.conn.sendNotification("exit");
+                    }
+                    catch {
+                        /* ignored */
+                    }
+                }
+            }
+            finally {
+                try {
+                    this.conn.dispose();
+                }
+                catch {
+                    /* ignored */
+                }
+                if (!this.closed) {
+                    this.proc.kill("SIGTERM");
+                    this.closed = true;
+                }
+            }
+        })();
+        return this.closePromise;
+    }
+}
+function uriToPath(uri) {
+    if (!uri.startsWith("file://"))
+        return undefined;
+    try {
+        const u = new URL(uri);
+        return path.normalize(decodeURIComponent(u.pathname));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function withTimeout(p, ms, err) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(err)), ms);
+    });
+    try {
+        return await Promise.race([p, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

package/packages/server/dist/lsp/client.js.map

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

package/packages/server/dist/lsp/format.d.ts

@@ -0,0 +1,13 @@
+import type { Diagnostic } from "vscode-languageserver-types";
+export interface FormatOptions {
+    /** Skip warnings, info, hint — only ERROR. False by default
+     *  (the model benefits from seeing warnings too, especially
+     *  unused-variable hints right after an edit). */
+    errorsOnly?: boolean;
+    /** Cap on how many entries to list. We want the model to fix
+     *  the most important things, not drown in 200 deprecations
+     *  in a stale file. */
+    maxEntries?: number;
+}
+export declare function formatDiagnostics(diags: readonly Diagnostic[], opts?: FormatOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/packages/server/dist/lsp/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lsp/format.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAS9D,MAAM,WAAW,aAAa;IAC5B;;sDAEkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;2BAEuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,IAAI,GAAE,aAAkB,GACvB,MAAM,CAmCR"}

package/packages/server/dist/lsp/format.js

@@ -0,0 +1,55 @@
+// Format a list of LSP diagnostics into a human-readable block
+// suitable for appending to an edit_file / write_file tool result.
+//
+// The shape mirrors what OpenCode emits in its tool output:
+//
+//   LSP errors detected in this file, please fix:
+//   ERROR [12:5] TS2322: Type 'string' is not assignable to type 'number'.
+//   WARN  [13:1] TS6133: 'foo' is declared but its value is never read.
+//
+// The model is supposed to read this and act on it on the next
+// turn. Empty diagnostics => empty output (caller should skip
+// the block entirely).
+const SEVERITY = {
+    1: "ERROR",
+    2: "WARN ",
+    3: "INFO ",
+    4: "HINT ",
+};
+const DEFAULT_MAX = 20;
+export function formatDiagnostics(diags, opts = {}) {
+    const filtered = opts.errorsOnly
+        ? diags.filter((d) => (d.severity ?? 1) === 1)
+        : diags.slice();
+    if (filtered.length === 0)
+        return "";
+    // Stable sort: errors before warnings before info, then by line.
+    filtered.sort((a, b) => {
+        const sa = a.severity ?? 1;
+        const sb = b.severity ?? 1;
+        if (sa !== sb)
+            return sa - sb;
+        return a.range.start.line - b.range.start.line;
+    });
+    const max = opts.maxEntries ?? DEFAULT_MAX;
+    const shown = filtered.slice(0, max);
+    const lines = shown.map((d) => {
+        const sev = SEVERITY[d.severity ?? 1] ?? "??   ";
+        const line = d.range.start.line + 1;
+        const col = d.range.start.character + 1;
+        const code = d.code !== undefined ? ` ${d.code}:` : ":";
+        const source = d.source ? ` [${d.source}]` : "";
+        // Squash newlines in messages so the output stays one-line-
+        // per-diagnostic — easier for the model to scan.
+        // d.message is `string | MarkupContent` per LSP types; almost
+        // every server sends a plain string, but coerce defensively.
+        const rawMsg = typeof d.message === "string" ? d.message : d.message.value;
+        const msg = rawMsg.replace(/\s*\n\s*/g, " ");
+        return `${sev} [${line}:${col}]${source}${code} ${msg}`;
+    });
+    if (filtered.length > max) {
+        lines.push(`(... ${filtered.length - max} more)`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/packages/server/dist/lsp/format.js.map

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

package/packages/server/dist/lsp/index.d.ts

@@ -0,0 +1,20 @@
+import { LSPManager } from "./manager.js";
+export { LSPManager } from "./manager.js";
+export { allLanguages, languageForFile, type LanguageDefinition, } from "./language-registry.js";
+export type { DiagnoseInput, DiagnoseResult, LSPManagerOptions, } from "./manager.js";
+export { formatDiagnostics } from "./format.js";
+/** Returns the process-wide LSPManager. Created lazily on first
+ *  call so test harnesses that don't touch LSP don't pay the
+ *  spawn-interval cost.
+ *
+ *  The singleton is host-wide (not per-tenant) — tenant scoping
+ *  is enforced inside the manager via the tenantId argument on
+ *  every call.
+ *
+ *  Honours TIANSHU_LSP_ENABLED env var: when set to "0" or "false"
+ *  the manager is created with `enabled: false`, which short-
+ *  circuits diagnoseAfterEdit to a no-op. */
+export declare function getLSPManager(): LSPManager;
+/** Test-only: replace the singleton (or clear it). */
+export declare function _setLSPManagerForTests(m: LSPManager | undefined): void;
+//# sourceMappingURL=index.d.ts.map

package/packages/server/dist/lsp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lsp/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD;;;;;;;;;;6CAU6C;AAC7C,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAEtE"}

package/packages/server/dist/lsp/index.js

@@ -0,0 +1,32 @@
+// Public surface of the LSP service. Importers use the singleton
+// returned by `getLSPManager()`; the underlying class is exported
+// for tests.
+import { LSPManager } from "./manager.js";
+export { LSPManager } from "./manager.js";
+export { allLanguages, languageForFile, } from "./language-registry.js";
+export { formatDiagnostics } from "./format.js";
+let singleton;
+/** Returns the process-wide LSPManager. Created lazily on first
+ *  call so test harnesses that don't touch LSP don't pay the
+ *  spawn-interval cost.
+ *
+ *  The singleton is host-wide (not per-tenant) — tenant scoping
+ *  is enforced inside the manager via the tenantId argument on
+ *  every call.
+ *
+ *  Honours TIANSHU_LSP_ENABLED env var: when set to "0" or "false"
+ *  the manager is created with `enabled: false`, which short-
+ *  circuits diagnoseAfterEdit to a no-op. */
+export function getLSPManager() {
+    if (!singleton) {
+        const flag = (process.env.TIANSHU_LSP_ENABLED ?? "").toLowerCase();
+        const enabled = flag !== "0" && flag !== "false";
+        singleton = new LSPManager({ enabled });
+    }
+    return singleton;
+}
+/** Test-only: replace the singleton (or clear it). */
+export function _setLSPManagerForTests(m) {
+    singleton = m;
+}
+//# sourceMappingURL=index.js.map

package/packages/server/dist/lsp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lsp/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,kEAAkE;AAClE,aAAa;AAEb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,eAAe,GAEhB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,IAAI,SAAiC,CAAC;AAEtC;;;;;;;;;;6CAU6C;AAC7C,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,OAAO,CAAC;QACjD,SAAS,GAAG,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,sBAAsB,CAAC,CAAyB;IAC9D,SAAS,GAAG,CAAC,CAAC;AAChB,CAAC"}

package/packages/server/dist/lsp/language-registry.d.ts

@@ -0,0 +1,29 @@
+export interface LanguageDefinition {
+    /** Stable id used as the LSP pool key segment. Matches OpenCode's
+     *  ids so prompts / docs read the same. */
+    id: "typescript" | "gopls" | "pyright";
+    /** File extensions this language owns (lowercase, with dot). */
+    extensions: readonly string[];
+    /** Project markers walked up from the edited file to find the
+     *  workspace root. First hit wins; if none found we fall back to
+     *  the tenant workspace root (the manager enforces the upper
+     *  bound). */
+    rootMarkers: readonly string[];
+    /** Spawn command. `which` resolves it; auto-install runs the
+     *  install script if missing. */
+    command: string;
+    /** Args for `command`. Most LS take `--stdio`. */
+    args: readonly string[];
+    /** Lazy install hook — invoked at most once per host process if
+     *  `command` is missing. Returns the shell command(s) that
+     *  install the binary. */
+    installCommand: string;
+    /** Human-readable name, used in error messages. */
+    displayName: string;
+}
+/** Look up the language that owns a file by its extension.
+ *  Returns undefined for unsupported types. */
+export declare function languageForFile(absPath: string): LanguageDefinition | undefined;
+/** All known languages, for diagnostics / status surfaces. */
+export declare function allLanguages(): readonly LanguageDefinition[];
+//# sourceMappingURL=language-registry.d.ts.map

package/packages/server/dist/lsp/language-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-registry.d.ts","sourceRoot":"","sources":["../../src/lsp/language-registry.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC;+CAC2C;IAC3C,EAAE,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;IAEvC,gEAAgE;IAChE,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9B;;;kBAGc;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/B;qCACiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAEhB,kDAAkD;IAClD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAExB;;8BAE0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AA6CD;+CAC+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAI/E;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,IAAI,SAAS,kBAAkB,EAAE,CAE5D"}

package/packages/server/dist/lsp/language-registry.js

@@ -0,0 +1,62 @@
+// Static registry of language-server bootstrap info. Modelled on
+// OpenCode's `Server.Info` (packages/opencode/src/lsp/server.ts) but
+// trimmed to what v0.1 ships: 3 languages, push diagnostics, no
+// experimental flags, no special initialization quirks beyond
+// what each server documents.
+//
+// Adding a language is a registry entry — no code change in the
+// manager or client.
+const LANGUAGES = [
+    {
+        id: "typescript",
+        extensions: [".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"],
+        rootMarkers: ["tsconfig.json", "jsconfig.json", "package.json"],
+        command: "typescript-language-server",
+        args: ["--stdio"],
+        installCommand: "npm install -g typescript-language-server typescript",
+        displayName: "TypeScript Language Server",
+    },
+    {
+        id: "gopls",
+        extensions: [".go"],
+        rootMarkers: ["go.mod", "go.work"],
+        command: "gopls",
+        args: [],
+        installCommand: "go install golang.org/x/tools/gopls@latest",
+        displayName: "gopls",
+    },
+    {
+        id: "pyright",
+        extensions: [".py", ".pyi"],
+        rootMarkers: [
+            "pyproject.toml",
+            "setup.py",
+            "setup.cfg",
+            "requirements.txt",
+            "Pipfile",
+        ],
+        command: "pyright-langserver",
+        args: ["--stdio"],
+        installCommand: "npm install -g pyright",
+        displayName: "Pyright",
+    },
+];
+const byExtension = new Map();
+for (const lang of LANGUAGES) {
+    for (const ext of lang.extensions) {
+        byExtension.set(ext.toLowerCase(), lang);
+    }
+}
+/** Look up the language that owns a file by its extension.
+ *  Returns undefined for unsupported types. */
+export function languageForFile(absPath) {
+    const dot = absPath.lastIndexOf(".");
+    if (dot < 0)
+        return undefined;
+    return byExtension.get(absPath.slice(dot).toLowerCase());
+}
+/** All known languages, for diagnostics / status surfaces. */
+export function allLanguages() {
+    return LANGUAGES;
+}
+//# sourceMappingURL=language-registry.js.map

package/packages/server/dist/lsp/language-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-registry.js","sourceRoot":"","sources":["../../src/lsp/language-registry.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,qEAAqE;AACrE,gEAAgE;AAChE,8DAA8D;AAC9D,8BAA8B;AAC9B,EAAE;AACF,gEAAgE;AAChE,qBAAqB;AAgCrB,MAAM,SAAS,GAAkC;IAC/C;QACE,EAAE,EAAE,YAAY;QAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC1E,WAAW,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;QAC/D,OAAO,EAAE,4BAA4B;QACrC,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,cAAc,EAAE,sDAAsD;QACtE,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,EAAE,EAAE,OAAO;QACX,UAAU,EAAE,CAAC,KAAK,CAAC;QACnB,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QAClC,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,EAAE;QACR,cAAc,EAAE,4CAA4C;QAC5D,WAAW,EAAE,OAAO;KACrB;IACD;QACE,EAAE,EAAE,SAAS;QACb,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE;YACX,gBAAgB;YAChB,UAAU;YACV,WAAW;YACX,kBAAkB;YAClB,SAAS;SACV;QACD,OAAO,EAAE,oBAAoB;QAC7B,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,cAAc,EAAE,wBAAwB;QACxC,WAAW,EAAE,SAAS;KACvB;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;AAC1D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;+CAC+C;AAC/C,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/server/dist/lsp/manager.d.ts

@@ -0,0 +1,77 @@
+import { allLanguages, languageForFile, type LanguageDefinition } from "./language-registry.js";
+type ManagerLogger = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export interface LSPManagerOptions {
+    /** Logger; falls back to no-op. */
+    log?: ManagerLogger;
+    /** Per-tenant LSP process cap. */
+    perTenantCap?: number;
+    /** Global LSP process cap. */
+    globalCap?: number;
+    /** Master kill-switch. When false the manager pretends all
+     *  languages are uninstalled (`diagnoseAfterEdit` returns
+     *  undefined immediately). Used to disable LSP per-tenant or
+     *  globally without uninstalling anything. */
+    enabled?: boolean;
+}
+export interface DiagnoseInput {
+    tenantId: string;
+    /** Workspace root for the tenant (absolute). The manager will
+     *  refuse to spawn an LS rooted above this path. */
+    tenantWorkspaceRoot: string;
+    /** Absolute path of the file the agent just edited/wrote. */
+    filePath: string;
+    /** New contents of the file (post-edit). The manager will push
+     *  these to the LS via didChange before requesting diagnostics. */
+    contents: string;
+}
+export interface DiagnoseResult {
+    /** Formatted diagnostic text suitable to append to a tool
+     *  result. Empty string when LSP returned no diagnostics. */
+    text: string;
+    /** True if LSP returned at least one ERROR-severity diagnostic.
+     *  Callers may use this for downstream "did this edit break
+     *  the build?" decisions. */
+    hasErrors: boolean;
+    /** Set when diagnostics were unavailable for a known reason.
+     *  Manager-side outages (auto-install failed, LS crashed, etc.)
+     *  populate this so the tool can surface a one-liner instead of
+     *  silently dropping the diagnostics block. */
+    unavailable?: string;
+}
+export declare class LSPManager {
+    private opts;
+    private pool;
+    /** LRU order: most recently used at the end. */
+    private lru;
+    private installState;
+    private installAttempted;
+    /** Background eviction interval handle. */
+    private sweeper?;
+    constructor(opts?: LSPManagerOptions);
+    /** Edit/write tool entry point. Returns a diagnose result; the
+     *  caller should append `result.text` to the tool output if
+     *  non-empty, and surface `result.unavailable` (if set) as a
+     *  one-liner. Never throws — we catch and degrade. */
+    diagnoseAfterEdit(input: DiagnoseInput): Promise<DiagnoseResult>;
+    /** Shut every pooled client down. Idempotent. */
+    shutdown(): Promise<void>;
+    /** Test/debug surface: number of pooled processes. */
+    poolSize(): number;
+    private ensureInstalled;
+    /** Walk up from `filePath` to find the closest root marker for
+     *  this language, never crossing `tenantRoot`. Returns
+     *  `tenantRoot` if no marker found before the boundary.
+     *  Returns undefined if `filePath` is outside `tenantRoot`. */
+    private resolveRoot;
+    private getOrCreate;
+    private touchLru;
+    private removeEntry;
+    private evictIfOverCap;
+    private sweepIdle;
+}
+export { allLanguages, languageForFile, type LanguageDefinition };
+//# sourceMappingURL=manager.d.ts.map