@ai-agent-forge/plugin-lsp-diagnostics 0.85.0

package/dist/node-adapter.js

@@ -0,0 +1,404 @@
+import { projectPluginContextV1 } from "@agent-forge/plugin-sdk";
+import { sanitizeBinaryOutput } from "./shell-utils.js";
+import { LSP_DIAGNOSTICS_HOST_ADAPTER_ID_V1, LSP_DIAGNOSTICS_HOST_ADAPTER_VERSION_V1, LSP_DIAGNOSTICS_MAX_ITEMS_V1, } from "./types.js";
+export const LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1 = 512;
+export const LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1 = 256;
+export const LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1 = 64 * 1024;
+const DEFAULT_TIMEOUT_MS_V1 = 30_000;
+const MAX_TIMEOUT_MS_V1 = 120_000;
+const MAX_HOST_DIAGNOSTICS_V1 = 4096;
+const MAX_FILE_CHARS_V1 = 512;
+const MAX_SOURCE_CHARS_V1 = 128;
+const MAX_CODE_CHARS_V1 = 128;
+const MAX_REF_CHARS_V1 = 256;
+const MAX_LANGUAGE_CHARS_V1 = 64;
+const MAX_POSITION_V1 = 10_000_000;
+const OPAQUE_REF_V1 = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u;
+const LANGUAGE_V1 = /^[A-Za-z][A-Za-z0-9_.+-]{0,63}$/u;
+const RELATIVE_FILE_V1 = /^[A-Za-z0-9_][A-Za-z0-9._/-]{0,511}$/u;
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOnlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.includes(key));
+}
+function safeOpaqueRef(value) {
+    return value.length <= MAX_REF_CHARS_V1 && OPAQUE_REF_V1.test(value);
+}
+function sanitizeLspText(value, maximum) {
+    const text = sanitizeBinaryOutput(value)
+        .replace(/((?:api[-_ ]?key|access[-_ ]?token|auth(?:orization)?|bearer|password|passwd|secret|token)\s*[:=]\s*)([^\s,;]+)/giu, "$1[redacted-secret]")
+        .replace(/(?:[A-Za-z]:[\\/]|\\\\|\/(?:home|Users|private|tmp|var|workspace)\/)[^\s"'<>]*/gu, "[redacted-path]");
+    const chars = [...text];
+    return chars.length <= maximum ? text : chars.slice(0, maximum).join("");
+}
+/** Sanitizes host error/diagnostic text before the capability boundary. */
+export function sanitizeLspDiagnosticsTextV1(value, maximum = LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1) {
+    return sanitizeLspText(value, maximum);
+}
+function validPositiveInteger(value, maximum) {
+    return Number.isSafeInteger(value) && value >= 1 && value <= maximum;
+}
+function validNonNegativeInteger(value, maximum) {
+    return Number.isSafeInteger(value) && value >= 0 && value <= maximum;
+}
+function emptySummary() {
+    return { total: 0, error: 0, warning: 0, info: 0, hint: 0 };
+}
+function invalidInput(operationId, message) {
+    return {
+        version: 1,
+        operationId,
+        status: "failed",
+        summary: emptySummary(),
+        diagnostics: [],
+        diagnosticsTruncated: false,
+        error: { version: 1, code: "invalid_input", message },
+    };
+}
+function unsupported(operationId) {
+    return {
+        version: 1,
+        operationId,
+        status: "unsupported",
+        summary: emptySummary(),
+        diagnostics: [],
+        diagnosticsTruncated: false,
+        error: { version: 1, code: "lsp_unavailable", message: "No language server is bound by this host" },
+    };
+}
+function cancelled(operationId) {
+    return {
+        version: 1,
+        operationId,
+        status: "cancelled",
+        summary: emptySummary(),
+        diagnostics: [],
+        diagnosticsTruncated: false,
+        error: { version: 1, code: "cancelled", message: "LSP diagnostics were cancelled" },
+    };
+}
+function timedOut(operationId) {
+    return {
+        version: 1,
+        operationId,
+        status: "failed",
+        summary: emptySummary(),
+        diagnostics: [],
+        diagnosticsTruncated: false,
+        error: { version: 1, code: "timeout", message: "LSP diagnostics timed out" },
+    };
+}
+function adapterFailed(operationId) {
+    return {
+        version: 1,
+        operationId,
+        status: "failed",
+        summary: emptySummary(),
+        diagnostics: [],
+        diagnosticsTruncated: false,
+        error: { version: 1, code: "adapter_failed", message: "LSP adapter returned an invalid result" },
+    };
+}
+function validateRequest(request) {
+    if (request.version !== 1)
+        return "version must be 1";
+    if (typeof request.operationId !== "string" ||
+        request.operationId.trim() === "" ||
+        request.operationId.length > LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1)
+        return "operationId is invalid";
+    if (typeof request.workspaceRef !== "string" || !safeOpaqueRef(request.workspaceRef))
+        return "workspaceRef must be a safe opaque host handle";
+    if (typeof request.documentRef !== "string" || !safeOpaqueRef(request.documentRef))
+        return "documentRef must be a safe opaque host handle";
+    if (request.documentPath !== undefined &&
+        (typeof request.documentPath !== "string" ||
+            request.documentPath.length > MAX_FILE_CHARS_V1 ||
+            !RELATIVE_FILE_V1.test(request.documentPath) ||
+            request.documentPath.split("/").some((part) => part === "." || part === "..")))
+        return "documentPath must be a safe workspace-relative identifier";
+    if (typeof request.language !== "string" ||
+        request.language.length > MAX_LANGUAGE_CHARS_V1 ||
+        !LANGUAGE_V1.test(request.language))
+        return "language is invalid";
+    if (request.diagnosticsLimit !== undefined &&
+        !validPositiveInteger(request.diagnosticsLimit, LSP_DIAGNOSTICS_MAX_ITEMS_V1))
+        return `diagnosticsLimit must be a positive integer at most ${LSP_DIAGNOSTICS_MAX_ITEMS_V1}`;
+    return undefined;
+}
+function projectPosition(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["line", "column"]))
+        return undefined;
+    if (!validNonNegativeInteger(value.line, MAX_POSITION_V1) || !validNonNegativeInteger(value.column, MAX_POSITION_V1))
+        return undefined;
+    return { line: value.line, column: value.column };
+}
+function projectRange(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["start", "end"]))
+        return undefined;
+    const start = projectPosition(value.start);
+    const end = projectPosition(value.end);
+    if (start === undefined || end === undefined)
+        return undefined;
+    if (end.line < start.line || (end.line === start.line && end.column < start.column))
+        return undefined;
+    return { start, end };
+}
+function projectDiagnostic(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["file", "range", "severity", "code", "source", "message"]))
+        return undefined;
+    if (typeof value.file !== "string" ||
+        value.file.length > MAX_FILE_CHARS_V1 ||
+        !RELATIVE_FILE_V1.test(value.file) ||
+        value.file.split("/").some((part) => part === "." || part === ".."))
+        return undefined;
+    const range = projectRange(value.range);
+    if (range === undefined)
+        return undefined;
+    if (value.severity !== "error" &&
+        value.severity !== "warning" &&
+        value.severity !== "info" &&
+        value.severity !== "hint")
+        return undefined;
+    if (typeof value.message !== "string" || value.message.trim() === "" || value.message.length > 8192)
+        return undefined;
+    if (value.code !== undefined &&
+        !(typeof value.code === "string" || (typeof value.code === "number" && Number.isSafeInteger(value.code))))
+        return undefined;
+    if (typeof value.code === "string" && (value.code.length > MAX_CODE_CHARS_V1 || /[\u0000\r\n]/u.test(value.code)))
+        return undefined;
+    if (value.source !== undefined && (typeof value.source !== "string" || value.source.length > MAX_SOURCE_CHARS_V1))
+        return undefined;
+    return {
+        file: value.file,
+        range,
+        severity: value.severity,
+        ...(value.code === undefined
+            ? {}
+            : { code: typeof value.code === "string" ? sanitizeLspText(value.code, MAX_CODE_CHARS_V1) : value.code }),
+        ...(value.source === undefined ? {} : { source: sanitizeLspText(value.source, MAX_SOURCE_CHARS_V1) }),
+        message: sanitizeLspText(value.message, LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1),
+    };
+}
+function summaryFor(diagnostics) {
+    const summary = { total: diagnostics.length, error: 0, warning: 0, info: 0, hint: 0 };
+    for (const diagnostic of diagnostics)
+        summary[diagnostic.severity] += 1;
+    return summary;
+}
+function validSummary(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["total", "error", "warning", "info", "hint"]))
+        return false;
+    const counts = [value.total, value.error, value.warning, value.info, value.hint];
+    if (counts.some((count) => !Number.isSafeInteger(count) || count < 0 || count > MAX_HOST_DIAGNOSTICS_V1))
+        return false;
+    return (value.error + value.warning + value.info + value.hint ===
+        value.total);
+}
+function contextBoundResult(result) {
+    for (let count = result.diagnostics.length; count >= 0; count--) {
+        const diagnostics = result.diagnostics.slice(0, count);
+        const candidate = {
+            ...result,
+            diagnostics,
+            diagnosticsTruncated: result.diagnosticsTruncated || count < result.diagnostics.length,
+        };
+        const projection = projectPluginContextV1({
+            version: 1,
+            operationId: result.operationId,
+            items: [
+                candidate.summary,
+                ...diagnostics.map((item) => ({ ...item })),
+            ],
+            ...(candidate.reportArtifactRef === undefined ? {} : { outputArtifactRef: candidate.reportArtifactRef }),
+            truncated: candidate.diagnosticsTruncated,
+        }, {
+            maxOutputBytes: LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1,
+            maxInlineItems: LSP_DIAGNOSTICS_MAX_ITEMS_V1 + 1,
+            maxCellChars: 512,
+        });
+        if (projection.status === "succeeded" &&
+            new TextEncoder().encode(JSON.stringify(candidate)).byteLength <= LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1)
+            return candidate;
+    }
+    return adapterFailed(result.operationId);
+}
+/** Projects arbitrary host output into a bounded, path-safe model DTO. */
+export function projectLspDiagnosticsResultV1(value, operationId) {
+    if (!isRecord(value) ||
+        !hasOnlyKeys(value, [
+            "version",
+            "operationId",
+            "status",
+            "summary",
+            "diagnostics",
+            "diagnosticsTruncated",
+            "reportArtifactRef",
+            "error",
+        ]))
+        return undefined;
+    if (value.version !== 1 ||
+        value.operationId !== operationId ||
+        value.status !== "succeeded" ||
+        !validSummary(value.summary) ||
+        !Array.isArray(value.diagnostics))
+        return undefined;
+    if (value.diagnostics.length > LSP_DIAGNOSTICS_MAX_ITEMS_V1 || typeof value.diagnosticsTruncated !== "boolean")
+        return undefined;
+    const diagnostics = value.diagnostics.map(projectDiagnostic);
+    if (diagnostics.some((diagnostic) => diagnostic === undefined))
+        return undefined;
+    if (value.reportArtifactRef !== undefined &&
+        (typeof value.reportArtifactRef !== "string" || !safeOpaqueRef(value.reportArtifactRef)))
+        return undefined;
+    if (value.error !== undefined)
+        return undefined;
+    const projected = {
+        version: 1,
+        operationId,
+        status: "succeeded",
+        summary: summaryFor(diagnostics),
+        diagnostics: diagnostics,
+        diagnosticsTruncated: value.diagnosticsTruncated,
+        ...(value.reportArtifactRef === undefined ? {} : { reportArtifactRef: value.reportArtifactRef }),
+    };
+    return contextBoundResult(projected);
+}
+const CANCELLATION_V1 = Symbol("lsp-cancelled");
+const TIMEOUT_V1 = Symbol("lsp-timeout");
+async function runBounded(run, timeoutMs, signal) {
+    const controller = new AbortController();
+    let stop;
+    const abort = () => {
+        stop ??= CANCELLATION_V1;
+        controller.abort();
+    };
+    if (signal?.aborted)
+        return CANCELLATION_V1;
+    signal?.addEventListener("abort", abort, { once: true });
+    const timeout = setTimeout(() => {
+        stop ??= TIMEOUT_V1;
+        controller.abort();
+    }, timeoutMs);
+    const completed = Promise.resolve()
+        .then(() => run(controller.signal))
+        .then((value) => value, () => undefined);
+    const stopped = new Promise((resolve) => {
+        controller.signal.addEventListener("abort", () => {
+            if (stop !== undefined)
+                resolve(stop);
+        }, { once: true });
+    });
+    try {
+        return await Promise.race([completed, stopped]);
+    }
+    finally {
+        clearTimeout(timeout);
+        signal?.removeEventListener("abort", abort);
+    }
+}
+function validSession(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ["sessionRef"]) &&
+        typeof value.sessionRef === "string" &&
+        safeOpaqueRef(value.sessionRef));
+}
+function completeResult(operationId, value, limit) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ["status", "diagnostics", "reportArtifactRef"]))
+        return adapterFailed(operationId);
+    if (value.status === "unsupported")
+        return unsupported(operationId);
+    if (value.status !== "completed" || (value.diagnostics !== undefined && !Array.isArray(value.diagnostics)))
+        return adapterFailed(operationId);
+    const rawDiagnostics = value.diagnostics ?? [];
+    if (rawDiagnostics.length > MAX_HOST_DIAGNOSTICS_V1)
+        return adapterFailed(operationId);
+    const projected = rawDiagnostics.map(projectDiagnostic);
+    if (projected.some((diagnostic) => diagnostic === undefined))
+        return adapterFailed(operationId);
+    const bounded = projected.slice(0, Math.min(limit, LSP_DIAGNOSTICS_MAX_ITEMS_V1));
+    const result = {
+        version: 1,
+        operationId,
+        status: "succeeded",
+        summary: summaryFor(projected),
+        diagnostics: bounded,
+        diagnosticsTruncated: rawDiagnostics.length > bounded.length,
+        ...(value.reportArtifactRef === undefined ? {} : { reportArtifactRef: value.reportArtifactRef }),
+    };
+    if (value.reportArtifactRef !== undefined &&
+        (typeof value.reportArtifactRef !== "string" || !safeOpaqueRef(value.reportArtifactRef)))
+        return adapterFailed(operationId);
+    return contextBoundResult(result);
+}
+/** Creates a host-bound Node adapter. No command, cwd, environment, or source-text input is accepted. */
+export function createNodeLspAdapterV1(options = {}) {
+    const defaultTimeoutMs = options.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS_V1;
+    if (!validPositiveInteger(defaultTimeoutMs, MAX_TIMEOUT_MS_V1))
+        throw new Error(`defaultTimeoutMs must be a positive integer at most ${MAX_TIMEOUT_MS_V1}`);
+    return {
+        adapterId: LSP_DIAGNOSTICS_HOST_ADAPTER_ID_V1,
+        adapterVersion: LSP_DIAGNOSTICS_HOST_ADAPTER_VERSION_V1,
+        async run(request, signal) {
+            const operationId = typeof request.operationId === "string" && request.operationId.trim() !== ""
+                ? request.operationId.length <= LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1
+                    ? request.operationId
+                    : "profile-runtime-tool-call"
+                : "invalid-lsp-operation";
+            const invalid = validateRequest(request);
+            if (invalid !== undefined)
+                return invalidInput(operationId, invalid);
+            if (signal?.aborted)
+                return cancelled(operationId);
+            if (options.resolver === undefined || options.client === undefined)
+                return unsupported(operationId);
+            const resolution = await runBounded((internalSignal) => options.resolver.resolve(request, internalSignal).then((session) => ({ session })), defaultTimeoutMs, signal);
+            if (resolution === CANCELLATION_V1)
+                return cancelled(operationId);
+            if (resolution === TIMEOUT_V1)
+                return timedOut(operationId);
+            if (resolution === undefined)
+                return adapterFailed(operationId);
+            if (signal?.aborted)
+                return cancelled(operationId);
+            const session = resolution.session;
+            if (session === undefined)
+                return unsupported(operationId);
+            if (!validSession(session))
+                return adapterFailed(operationId);
+            const raw = await runBounded((internalSignal) => options.client.diagnose({ session, request }, internalSignal), defaultTimeoutMs, signal);
+            if (raw === CANCELLATION_V1)
+                return cancelled(operationId);
+            if (raw === TIMEOUT_V1)
+                return timedOut(operationId);
+            if (raw === undefined)
+                return adapterFailed(operationId);
+            return completeResult(operationId, raw, request.diagnosticsLimit ?? LSP_DIAGNOSTICS_MAX_ITEMS_V1);
+        },
+    };
+}
+/** Deterministic fixture adapter for tests; it never starts a language server. */
+export function createDeterministicLspAdapterV1(fixtures) {
+    const fixtureByKey = new Map();
+    for (const fixture of fixtures) {
+        const key = `${fixture.workspaceRef}\u0000${fixture.language}\u0000${fixture.documentRef}`;
+        if (fixtureByKey.has(key))
+            throw new Error("Deterministic LSP fixtures must be unique");
+        fixtureByKey.set(key, fixture);
+    }
+    return createNodeLspAdapterV1({
+        resolver: {
+            async resolve(request) {
+                const fixture = fixtureByKey.get(`${request.workspaceRef}\u0000${request.language}\u0000${request.documentRef}`);
+                return fixture === undefined ? undefined : { sessionRef: `fixture:${request.documentRef}` };
+            },
+        },
+        client: {
+            async diagnose(input) {
+                const fixture = fixtureByKey.get(`${input.request.workspaceRef}\u0000${input.request.language}\u0000${input.request.documentRef}`);
+                return fixture?.result ?? { status: "unsupported" };
+            },
+        },
+    });
+}
+//# sourceMappingURL=node-adapter.js.map

package/dist/node-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-adapter.js","sourceRoot":"","sources":["../src/node-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EACN,kCAAkC,EAClC,uCAAuC,EACvC,4BAA4B,GAW5B,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,yCAAyC,GAAG,GAAG,CAAC;AAC7D,MAAM,CAAC,MAAM,mCAAmC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7D,MAAM,qBAAqB,GAAG,MAAM,CAAC;AACrC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAC7D,MAAM,WAAW,GAAG,kCAAkC,CAAC;AACvD,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AAEjE,SAAS,QAAQ,CAAC,KAAc,EAAoC;IACnE,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAAA,CAC5E;AAED,SAAS,WAAW,CAAC,KAA8B,EAAE,OAA0B,EAAW;IACzF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAAA,CAChE;AAED,SAAS,aAAa,CAAC,KAAa,EAAW;IAC9C,OAAO,KAAK,CAAC,MAAM,IAAI,gBAAgB,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAAA,CACrE;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,OAAe,EAAU;IAChE,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC;SACtC,OAAO,CACP,oHAAoH,EACpH,qBAAqB,CACrB;SACA,OAAO,CAAC,kFAAkF,EAAE,iBAAiB,CAAC,CAAC;IACjH,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAAA,CACzE;AAED,2EAA2E;AAC3E,MAAM,UAAU,4BAA4B,CAAC,KAAa,EAAE,OAAO,GAAG,oCAAoC,EAAU;IACnH,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAAA,CACvC;AAED,SAAS,oBAAoB,CAAC,KAAc,EAAE,OAAe,EAAmB;IAC/E,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,IAAK,KAAgB,IAAI,OAAO,CAAC;AAAA,CAC7F;AAED,SAAS,uBAAuB,CAAC,KAAc,EAAE,OAAe,EAAmB;IAClF,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,IAAK,KAAgB,IAAI,OAAO,CAAC;AAAA,CAC7F;AAED,SAAS,YAAY,GAAsC;IAC1D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAAA,CAC5D;AAED,SAAS,YAAY,CAAC,WAAmB,EAAE,OAAe,EAA0B;IACnF,OAAO;QACN,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,YAAY,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,KAAK;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE;KACrD,CAAC;AAAA,CACF;AAED,SAAS,WAAW,CAAC,WAAmB,EAA0B;IACjE,OAAO;QACN,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,YAAY,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,KAAK;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,0CAA0C,EAAE;KACnG,CAAC;AAAA,CACF;AAED,SAAS,SAAS,CAAC,WAAmB,EAA0B;IAC/D,OAAO;QACN,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,YAAY,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,KAAK;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gCAAgC,EAAE;KACnF,CAAC;AAAA,CACF;AAED,SAAS,QAAQ,CAAC,WAAmB,EAA0B;IAC9D,OAAO;QACN,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,YAAY,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,KAAK;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE;KAC5E,CAAC;AAAA,CACF;AAED,SAAS,aAAa,CAAC,WAAmB,EAA0B;IACnE,OAAO;QACN,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,YAAY,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,oBAAoB,EAAE,KAAK;QAC3B,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,wCAAwC,EAAE;KAChG,CAAC;AAAA,CACF;AAED,SAAS,eAAe,CAAC,OAAgC,EAAsB;IAC9E,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACtD,IACC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE;QACjC,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,yCAAyC;QAEtE,OAAO,wBAAwB,CAAC;IACjC,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC;QACnF,OAAO,gDAAgD,CAAC;IACzD,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC;QACjF,OAAO,+CAA+C,CAAC;IACxD,IACC,OAAO,CAAC,YAAY,KAAK,SAAS;QAClC,CAAC,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ;YACxC,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,iBAAiB;YAC/C,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YAC5C,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;QAE/E,OAAO,2DAA2D,CAAC;IACpE,IACC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,qBAAqB;QAC/C,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAEnC,OAAO,qBAAqB,CAAC;IAC9B,IACC,OAAO,CAAC,gBAAgB,KAAK,SAAS;QACtC,CAAC,oBAAoB,CAAC,OAAO,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;QAE7E,OAAO,uDAAuD,4BAA4B,EAAE,CAAC;IAC9F,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,eAAe,CAAC,KAAc,EAAuC;IAC7E,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAClF,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC;QACnH,OAAO,SAAS,CAAC;IAClB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAAA,CAClD;AAED,SAAS,YAAY,CAAC,KAAc,EAAoC;IACvE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACtG,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,CACtB;AAED,SAAS,iBAAiB,CAAC,KAAc,EAA+B;IACvE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtG,OAAO,SAAS,CAAC;IAClB,IACC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,iBAAiB;QACrC,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;QAEnE,OAAO,SAAS,CAAC;IAClB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IACC,KAAK,CAAC,QAAQ,KAAK,OAAO;QAC1B,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,QAAQ,KAAK,MAAM;QACzB,KAAK,CAAC,QAAQ,KAAK,MAAM;QAEzB,OAAO,SAAS,CAAC;IAClB,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI;QAClG,OAAO,SAAS,CAAC;IAClB,IACC,KAAK,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzG,OAAO,SAAS,CAAC;IAClB,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,iBAAiB,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChH,OAAO,SAAS,CAAC;IAClB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,mBAAmB,CAAC;QAChH,OAAO,SAAS,CAAC;IAClB,OAAO;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,QAAmC;QACnD,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YAC3B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1G,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC;QACrG,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,oCAAoC,CAAC;KAC7E,CAAC;AAAA,CACF;AAED,SAAS,UAAU,CAAC,WAAuC,EAAqC;IAC/F,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACtF,KAAK,MAAM,UAAU,IAAI,WAAW;QAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AAAA,CACf;AAED,SAAS,YAAY,CAAC,KAAc,EAA8C;IACjF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACzG,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjF,IACC,MAAM,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE,CACT,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,GAAG,CAAC,IAAK,KAAgB,GAAG,uBAAuB,CACrG;QAED,OAAO,KAAK,CAAC;IACd,OAAO,CACL,KAAK,CAAC,KAAgB,GAAI,KAAK,CAAC,OAAkB,GAAI,KAAK,CAAC,IAAe,GAAI,KAAK,CAAC,IAAe;QACrG,KAAK,CAAC,KAAK,CACX,CAAC;AAAA,CACF;AAED,SAAS,kBAAkB,CAAC,MAA8B,EAA0B;IACnF,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvD,MAAM,SAAS,GAA2B;YACzC,GAAG,MAAM;YACT,WAAW;YACX,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM;SACtF,CAAC;QACF,MAAM,UAAU,GAAG,sBAAsB,CACxC;YACC,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE;gBACN,SAAS,CAAC,OAA+B;gBACzC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAyB,CAAC;aACnE;YACD,GAAG,CAAC,SAAS,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,CAAC,iBAAiB,EAAE,CAAC;YACxG,SAAS,EAAE,SAAS,CAAC,oBAAoB;SACzC,EACD;YACC,cAAc,EAAE,mCAAmC;YACnD,cAAc,EAAE,4BAA4B,GAAG,CAAC;YAChD,YAAY,EAAE,GAAG;SACjB,CACD,CAAC;QACF,IACC,UAAU,CAAC,MAAM,KAAK,WAAW;YACjC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,mCAAmC;YAErG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAAA,CACzC;AAED,0EAA0E;AAC1E,MAAM,UAAU,6BAA6B,CAAC,KAAc,EAAE,WAAmB,EAAsC;IACtH,IACC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,CAAC,WAAW,CAAC,KAAK,EAAE;YACnB,SAAS;YACT,aAAa;YACb,QAAQ;YACR,SAAS;YACT,aAAa;YACb,sBAAsB;YACtB,mBAAmB;YACnB,OAAO;SACP,CAAC;QAEF,OAAO,SAAS,CAAC;IAClB,IACC,KAAK,CAAC,OAAO,KAAK,CAAC;QACnB,KAAK,CAAC,WAAW,KAAK,WAAW;QACjC,KAAK,CAAC,MAAM,KAAK,WAAW;QAC5B,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QAEjC,OAAO,SAAS,CAAC;IAClB,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,4BAA4B,IAAI,OAAO,KAAK,CAAC,oBAAoB,KAAK,SAAS;QAC7G,OAAO,SAAS,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7D,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACjF,IACC,KAAK,CAAC,iBAAiB,KAAK,SAAS;QACrC,CAAC,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAExF,OAAO,SAAS,CAAC;IAClB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,SAAS,GAA2B;QACzC,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,UAAU,CAAC,WAAgC,CAAC;QACrD,WAAW,EAAE,WAAgC;QAC7C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;KAChG,CAAC;IACF,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAAA,CACrC;AAED,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzC,KAAK,UAAU,UAAU,CACxB,GAAwC,EACxC,SAAiB,EACjB,MAA+B,EACuC;IACtE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,IAA4D,CAAC;IACjE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACnB,IAAI,KAAK,eAAe,CAAC;QACzB,UAAU,CAAC,KAAK,EAAE,CAAC;IAAA,CACnB,CAAC;IACF,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,eAAe,CAAC;IAC5C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;QAChC,IAAI,KAAK,UAAU,CAAC;QACpB,UAAU,CAAC,KAAK,EAAE,CAAC;IAAA,CACnB,EAAE,SAAS,CAAC,CAAC;IACd,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE;SACjC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SAClC,IAAI,CACJ,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAChB,GAAG,EAAE,CAAC,SAAS,CACf,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,OAAO,CAA6C,CAAC,OAAO,EAAE,EAAE,CAAC;QACpF,UAAU,CAAC,MAAM,CAAC,gBAAgB,CACjC,OAAO,EACP,GAAG,EAAE,CAAC;YACL,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAA,CACtC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACd,CAAC;IAAA,CACF,CAAC,CAAC;IACH,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;YAAS,CAAC;QACV,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;AAAA,CACD;AAED,SAAS,YAAY,CAAC,KAAc,EAAyB;IAC5D,OAAO,CACN,QAAQ,CAAC,KAAK,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAC/B,CAAC;AAAA,CACF;AAED,SAAS,cAAc,CAAC,WAAmB,EAAE,KAAc,EAAE,KAAa,EAA0B;IACnG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;QAC1F,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACzG,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;IAC/C,IAAI,cAAc,CAAC,MAAM,GAAG,uBAAuB;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACxD,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC;QAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IAChG,MAAM,OAAO,GAAI,SAA+B,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACzG,MAAM,MAAM,GAA2B;QACtC,OAAO,EAAE,CAAC;QACV,WAAW;QACX,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,UAAU,CAAC,SAA8B,CAAC;QACnD,WAAW,EAAE,OAAO;QACpB,oBAAoB,EAAE,cAAc,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;QAC5D,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAA2B,EAAE,CAAC;KAC1G,CAAC;IACF,IACC,KAAK,CAAC,iBAAiB,KAAK,SAAS;QACrC,CAAC,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAExF,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAAA,CAClC;AAED,yGAAyG;AACzG,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAA4B,EAAE,EAA2B;IACtG,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,qBAAqB,CAAC;IAC3E,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,uDAAuD,iBAAiB,EAAE,CAAC,CAAC;IAC7F,OAAO;QACN,SAAS,EAAE,kCAAkC;QAC7C,cAAc,EAAE,uCAAuC;QACvD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE;YAC1B,MAAM,WAAW,GAChB,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC3E,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,IAAI,yCAAyC;oBACxE,CAAC,CAAC,OAAO,CAAC,WAAW;oBACrB,CAAC,CAAC,2BAA2B;gBAC9B,CAAC,CAAC,uBAAuB,CAAC;YAC5B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrE,IAAI,MAAM,EAAE,OAAO;gBAAE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;YACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;YACpG,MAAM,UAAU,GAAG,MAAM,UAAU,CAClC,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,QAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EACvG,gBAAgB,EAChB,MAAM,CACN,CAAC;YACF,IAAI,UAAU,KAAK,eAAe;gBAAE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;YAClE,IAAI,UAAU,KAAK,UAAU;gBAAE,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC5D,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;YAChE,IAAI,MAAM,EAAE,OAAO;gBAAE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;gBAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,MAAM,UAAU,CAC3B,CAAC,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,MAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,EAClF,gBAAgB,EAChB,MAAM,CACN,CAAC;YACF,IAAI,GAAG,KAAK,eAAe;gBAAE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;YACzD,OAAO,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,gBAAgB,IAAI,4BAA4B,CAAC,CAAC;QAAA,CAClG;KACD,CAAC;AAAA,CACF;AAED,kFAAkF;AAClF,MAAM,UAAU,+BAA+B,CAAC,QAA8C,EAAE;IAC/F,MAAM,YAAY,GAAG,IAAI,GAAG,EAAqC,CAAC;IAClE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,YAAY,SAAS,OAAO,CAAC,QAAQ,SAAS,OAAO,CAAC,WAAW,EAAE,CAAC;QAC3F,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACxF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,sBAAsB,CAAC;QAC7B,QAAQ,EAAE;YACT,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;gBACtB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAC/B,GAAG,OAAO,CAAC,YAAY,SAAS,OAAO,CAAC,QAAQ,SAAS,OAAO,CAAC,WAAW,EAAE,CAC9E,CAAC;gBACF,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAAA,CAC5F;SACD;QACD,MAAM,EAAE;YACP,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE;gBACrB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAC/B,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,SAAS,KAAK,CAAC,OAAO,CAAC,QAAQ,SAAS,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAChG,CAAC;gBACF,OAAO,OAAO,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;YAAA,CACpD;SACD;KACD,CAAC,CAAC;AAAA,CACH","sourcesContent":["import type { JsonValue } from \"@agent-forge/plugin-sdk\";\nimport { projectPluginContextV1 } from \"@agent-forge/plugin-sdk\";\nimport { sanitizeBinaryOutput } from \"./shell-utils.ts\";\nimport {\n\tLSP_DIAGNOSTICS_HOST_ADAPTER_ID_V1,\n\tLSP_DIAGNOSTICS_HOST_ADAPTER_VERSION_V1,\n\tLSP_DIAGNOSTICS_MAX_ITEMS_V1,\n\ttype LspDeterministicFixtureV1,\n\ttype LspDiagnosticPositionV1,\n\ttype LspDiagnosticRangeV1,\n\ttype LspDiagnosticSeverityV1,\n\ttype LspDiagnosticsAdapterV1,\n\ttype LspDiagnosticsRequestV1,\n\ttype LspDiagnosticsResultV1,\n\ttype LspDiagnosticV1,\n\ttype LspSessionV1,\n\ttype NodeLspAdapterOptionsV1,\n} from \"./types.ts\";\n\nexport const LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1 = 512;\nexport const LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1 = 256;\nexport const LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1 = 64 * 1024;\n\nconst DEFAULT_TIMEOUT_MS_V1 = 30_000;\nconst MAX_TIMEOUT_MS_V1 = 120_000;\nconst MAX_HOST_DIAGNOSTICS_V1 = 4096;\nconst MAX_FILE_CHARS_V1 = 512;\nconst MAX_SOURCE_CHARS_V1 = 128;\nconst MAX_CODE_CHARS_V1 = 128;\nconst MAX_REF_CHARS_V1 = 256;\nconst MAX_LANGUAGE_CHARS_V1 = 64;\nconst MAX_POSITION_V1 = 10_000_000;\n\nconst OPAQUE_REF_V1 = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u;\nconst LANGUAGE_V1 = /^[A-Za-z][A-Za-z0-9_.+-]{0,63}$/u;\nconst RELATIVE_FILE_V1 = /^[A-Za-z0-9_][A-Za-z0-9._/-]{0,511}$/u;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, allowed: readonly string[]): boolean {\n\treturn Object.keys(value).every((key) => allowed.includes(key));\n}\n\nfunction safeOpaqueRef(value: string): boolean {\n\treturn value.length <= MAX_REF_CHARS_V1 && OPAQUE_REF_V1.test(value);\n}\n\nfunction sanitizeLspText(value: string, maximum: number): string {\n\tconst text = sanitizeBinaryOutput(value)\n\t\t.replace(\n\t\t\t/((?:api[-_ ]?key|access[-_ ]?token|auth(?:orization)?|bearer|password|passwd|secret|token)\\s*[:=]\\s*)([^\\s,;]+)/giu,\n\t\t\t\"$1[redacted-secret]\",\n\t\t)\n\t\t.replace(/(?:[A-Za-z]:[\\\\/]|\\\\\\\\|\\/(?:home|Users|private|tmp|var|workspace)\\/)[^\\s\"'<>]*/gu, \"[redacted-path]\");\n\tconst chars = [...text];\n\treturn chars.length <= maximum ? text : chars.slice(0, maximum).join(\"\");\n}\n\n/** Sanitizes host error/diagnostic text before the capability boundary. */\nexport function sanitizeLspDiagnosticsTextV1(value: string, maximum = LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1): string {\n\treturn sanitizeLspText(value, maximum);\n}\n\nfunction validPositiveInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 1 && (value as number) <= maximum;\n}\n\nfunction validNonNegativeInteger(value: unknown, maximum: number): value is number {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0 && (value as number) <= maximum;\n}\n\nfunction emptySummary(): LspDiagnosticsResultV1[\"summary\"] {\n\treturn { total: 0, error: 0, warning: 0, info: 0, hint: 0 };\n}\n\nfunction invalidInput(operationId: string, message: string): LspDiagnosticsResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"failed\",\n\t\tsummary: emptySummary(),\n\t\tdiagnostics: [],\n\t\tdiagnosticsTruncated: false,\n\t\terror: { version: 1, code: \"invalid_input\", message },\n\t};\n}\n\nfunction unsupported(operationId: string): LspDiagnosticsResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"unsupported\",\n\t\tsummary: emptySummary(),\n\t\tdiagnostics: [],\n\t\tdiagnosticsTruncated: false,\n\t\terror: { version: 1, code: \"lsp_unavailable\", message: \"No language server is bound by this host\" },\n\t};\n}\n\nfunction cancelled(operationId: string): LspDiagnosticsResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"cancelled\",\n\t\tsummary: emptySummary(),\n\t\tdiagnostics: [],\n\t\tdiagnosticsTruncated: false,\n\t\terror: { version: 1, code: \"cancelled\", message: \"LSP diagnostics were cancelled\" },\n\t};\n}\n\nfunction timedOut(operationId: string): LspDiagnosticsResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"failed\",\n\t\tsummary: emptySummary(),\n\t\tdiagnostics: [],\n\t\tdiagnosticsTruncated: false,\n\t\terror: { version: 1, code: \"timeout\", message: \"LSP diagnostics timed out\" },\n\t};\n}\n\nfunction adapterFailed(operationId: string): LspDiagnosticsResultV1 {\n\treturn {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"failed\",\n\t\tsummary: emptySummary(),\n\t\tdiagnostics: [],\n\t\tdiagnosticsTruncated: false,\n\t\terror: { version: 1, code: \"adapter_failed\", message: \"LSP adapter returned an invalid result\" },\n\t};\n}\n\nfunction validateRequest(request: LspDiagnosticsRequestV1): string | undefined {\n\tif (request.version !== 1) return \"version must be 1\";\n\tif (\n\t\ttypeof request.operationId !== \"string\" ||\n\t\trequest.operationId.trim() === \"\" ||\n\t\trequest.operationId.length > LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1\n\t)\n\t\treturn \"operationId is invalid\";\n\tif (typeof request.workspaceRef !== \"string\" || !safeOpaqueRef(request.workspaceRef))\n\t\treturn \"workspaceRef must be a safe opaque host handle\";\n\tif (typeof request.documentRef !== \"string\" || !safeOpaqueRef(request.documentRef))\n\t\treturn \"documentRef must be a safe opaque host handle\";\n\tif (\n\t\trequest.documentPath !== undefined &&\n\t\t(typeof request.documentPath !== \"string\" ||\n\t\t\trequest.documentPath.length > MAX_FILE_CHARS_V1 ||\n\t\t\t!RELATIVE_FILE_V1.test(request.documentPath) ||\n\t\t\trequest.documentPath.split(\"/\").some((part) => part === \".\" || part === \"..\"))\n\t)\n\t\treturn \"documentPath must be a safe workspace-relative identifier\";\n\tif (\n\t\ttypeof request.language !== \"string\" ||\n\t\trequest.language.length > MAX_LANGUAGE_CHARS_V1 ||\n\t\t!LANGUAGE_V1.test(request.language)\n\t)\n\t\treturn \"language is invalid\";\n\tif (\n\t\trequest.diagnosticsLimit !== undefined &&\n\t\t!validPositiveInteger(request.diagnosticsLimit, LSP_DIAGNOSTICS_MAX_ITEMS_V1)\n\t)\n\t\treturn `diagnosticsLimit must be a positive integer at most ${LSP_DIAGNOSTICS_MAX_ITEMS_V1}`;\n\treturn undefined;\n}\n\nfunction projectPosition(value: unknown): LspDiagnosticPositionV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"line\", \"column\"])) return undefined;\n\tif (!validNonNegativeInteger(value.line, MAX_POSITION_V1) || !validNonNegativeInteger(value.column, MAX_POSITION_V1))\n\t\treturn undefined;\n\treturn { line: value.line, column: value.column };\n}\n\nfunction projectRange(value: unknown): LspDiagnosticRangeV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"start\", \"end\"])) return undefined;\n\tconst start = projectPosition(value.start);\n\tconst end = projectPosition(value.end);\n\tif (start === undefined || end === undefined) return undefined;\n\tif (end.line < start.line || (end.line === start.line && end.column < start.column)) return undefined;\n\treturn { start, end };\n}\n\nfunction projectDiagnostic(value: unknown): LspDiagnosticV1 | undefined {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"file\", \"range\", \"severity\", \"code\", \"source\", \"message\"]))\n\t\treturn undefined;\n\tif (\n\t\ttypeof value.file !== \"string\" ||\n\t\tvalue.file.length > MAX_FILE_CHARS_V1 ||\n\t\t!RELATIVE_FILE_V1.test(value.file) ||\n\t\tvalue.file.split(\"/\").some((part) => part === \".\" || part === \"..\")\n\t)\n\t\treturn undefined;\n\tconst range = projectRange(value.range);\n\tif (range === undefined) return undefined;\n\tif (\n\t\tvalue.severity !== \"error\" &&\n\t\tvalue.severity !== \"warning\" &&\n\t\tvalue.severity !== \"info\" &&\n\t\tvalue.severity !== \"hint\"\n\t)\n\t\treturn undefined;\n\tif (typeof value.message !== \"string\" || value.message.trim() === \"\" || value.message.length > 8192)\n\t\treturn undefined;\n\tif (\n\t\tvalue.code !== undefined &&\n\t\t!(typeof value.code === \"string\" || (typeof value.code === \"number\" && Number.isSafeInteger(value.code)))\n\t)\n\t\treturn undefined;\n\tif (typeof value.code === \"string\" && (value.code.length > MAX_CODE_CHARS_V1 || /[\\u0000\\r\\n]/u.test(value.code)))\n\t\treturn undefined;\n\tif (value.source !== undefined && (typeof value.source !== \"string\" || value.source.length > MAX_SOURCE_CHARS_V1))\n\t\treturn undefined;\n\treturn {\n\t\tfile: value.file,\n\t\trange,\n\t\tseverity: value.severity as LspDiagnosticSeverityV1,\n\t\t...(value.code === undefined\n\t\t\t? {}\n\t\t\t: { code: typeof value.code === \"string\" ? sanitizeLspText(value.code, MAX_CODE_CHARS_V1) : value.code }),\n\t\t...(value.source === undefined ? {} : { source: sanitizeLspText(value.source, MAX_SOURCE_CHARS_V1) }),\n\t\tmessage: sanitizeLspText(value.message, LSP_DIAGNOSTICS_MAX_MESSAGE_CHARS_V1),\n\t};\n}\n\nfunction summaryFor(diagnostics: readonly LspDiagnosticV1[]): LspDiagnosticsResultV1[\"summary\"] {\n\tconst summary = { total: diagnostics.length, error: 0, warning: 0, info: 0, hint: 0 };\n\tfor (const diagnostic of diagnostics) summary[diagnostic.severity] += 1;\n\treturn summary;\n}\n\nfunction validSummary(value: unknown): value is LspDiagnosticsResultV1[\"summary\"] {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"total\", \"error\", \"warning\", \"info\", \"hint\"])) return false;\n\tconst counts = [value.total, value.error, value.warning, value.info, value.hint];\n\tif (\n\t\tcounts.some(\n\t\t\t(count) =>\n\t\t\t\t!Number.isSafeInteger(count) || (count as number) < 0 || (count as number) > MAX_HOST_DIAGNOSTICS_V1,\n\t\t)\n\t)\n\t\treturn false;\n\treturn (\n\t\t(value.error as number) + (value.warning as number) + (value.info as number) + (value.hint as number) ===\n\t\tvalue.total\n\t);\n}\n\nfunction contextBoundResult(result: LspDiagnosticsResultV1): LspDiagnosticsResultV1 {\n\tfor (let count = result.diagnostics.length; count >= 0; count--) {\n\t\tconst diagnostics = result.diagnostics.slice(0, count);\n\t\tconst candidate: LspDiagnosticsResultV1 = {\n\t\t\t...result,\n\t\t\tdiagnostics,\n\t\t\tdiagnosticsTruncated: result.diagnosticsTruncated || count < result.diagnostics.length,\n\t\t};\n\t\tconst projection = projectPluginContextV1(\n\t\t\t{\n\t\t\t\tversion: 1,\n\t\t\t\toperationId: result.operationId,\n\t\t\t\titems: [\n\t\t\t\t\tcandidate.summary as unknown as JsonValue,\n\t\t\t\t\t...diagnostics.map((item) => ({ ...item }) as unknown as JsonValue),\n\t\t\t\t],\n\t\t\t\t...(candidate.reportArtifactRef === undefined ? {} : { outputArtifactRef: candidate.reportArtifactRef }),\n\t\t\t\ttruncated: candidate.diagnosticsTruncated,\n\t\t\t},\n\t\t\t{\n\t\t\t\tmaxOutputBytes: LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1,\n\t\t\t\tmaxInlineItems: LSP_DIAGNOSTICS_MAX_ITEMS_V1 + 1,\n\t\t\t\tmaxCellChars: 512,\n\t\t\t},\n\t\t);\n\t\tif (\n\t\t\tprojection.status === \"succeeded\" &&\n\t\t\tnew TextEncoder().encode(JSON.stringify(candidate)).byteLength <= LSP_DIAGNOSTICS_MAX_OUTPUT_BYTES_V1\n\t\t)\n\t\t\treturn candidate;\n\t}\n\treturn adapterFailed(result.operationId);\n}\n\n/** Projects arbitrary host output into a bounded, path-safe model DTO. */\nexport function projectLspDiagnosticsResultV1(value: unknown, operationId: string): LspDiagnosticsResultV1 | undefined {\n\tif (\n\t\t!isRecord(value) ||\n\t\t!hasOnlyKeys(value, [\n\t\t\t\"version\",\n\t\t\t\"operationId\",\n\t\t\t\"status\",\n\t\t\t\"summary\",\n\t\t\t\"diagnostics\",\n\t\t\t\"diagnosticsTruncated\",\n\t\t\t\"reportArtifactRef\",\n\t\t\t\"error\",\n\t\t])\n\t)\n\t\treturn undefined;\n\tif (\n\t\tvalue.version !== 1 ||\n\t\tvalue.operationId !== operationId ||\n\t\tvalue.status !== \"succeeded\" ||\n\t\t!validSummary(value.summary) ||\n\t\t!Array.isArray(value.diagnostics)\n\t)\n\t\treturn undefined;\n\tif (value.diagnostics.length > LSP_DIAGNOSTICS_MAX_ITEMS_V1 || typeof value.diagnosticsTruncated !== \"boolean\")\n\t\treturn undefined;\n\tconst diagnostics = value.diagnostics.map(projectDiagnostic);\n\tif (diagnostics.some((diagnostic) => diagnostic === undefined)) return undefined;\n\tif (\n\t\tvalue.reportArtifactRef !== undefined &&\n\t\t(typeof value.reportArtifactRef !== \"string\" || !safeOpaqueRef(value.reportArtifactRef))\n\t)\n\t\treturn undefined;\n\tif (value.error !== undefined) return undefined;\n\tconst projected: LspDiagnosticsResultV1 = {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"succeeded\",\n\t\tsummary: summaryFor(diagnostics as LspDiagnosticV1[]),\n\t\tdiagnostics: diagnostics as LspDiagnosticV1[],\n\t\tdiagnosticsTruncated: value.diagnosticsTruncated,\n\t\t...(value.reportArtifactRef === undefined ? {} : { reportArtifactRef: value.reportArtifactRef }),\n\t};\n\treturn contextBoundResult(projected);\n}\n\nconst CANCELLATION_V1 = Symbol(\"lsp-cancelled\");\nconst TIMEOUT_V1 = Symbol(\"lsp-timeout\");\n\nasync function runBounded<T>(\n\trun: (signal: AbortSignal) => Promise<T>,\n\ttimeoutMs: number,\n\tsignal: AbortSignal | undefined,\n): Promise<T | typeof CANCELLATION_V1 | typeof TIMEOUT_V1 | undefined> {\n\tconst controller = new AbortController();\n\tlet stop: typeof CANCELLATION_V1 | typeof TIMEOUT_V1 | undefined;\n\tconst abort = () => {\n\t\tstop ??= CANCELLATION_V1;\n\t\tcontroller.abort();\n\t};\n\tif (signal?.aborted) return CANCELLATION_V1;\n\tsignal?.addEventListener(\"abort\", abort, { once: true });\n\tconst timeout = setTimeout(() => {\n\t\tstop ??= TIMEOUT_V1;\n\t\tcontroller.abort();\n\t}, timeoutMs);\n\tconst completed = Promise.resolve()\n\t\t.then(() => run(controller.signal))\n\t\t.then(\n\t\t\t(value) => value,\n\t\t\t() => undefined,\n\t\t);\n\tconst stopped = new Promise<typeof CANCELLATION_V1 | typeof TIMEOUT_V1>((resolve) => {\n\t\tcontroller.signal.addEventListener(\n\t\t\t\"abort\",\n\t\t\t() => {\n\t\t\t\tif (stop !== undefined) resolve(stop);\n\t\t\t},\n\t\t\t{ once: true },\n\t\t);\n\t});\n\ttry {\n\t\treturn await Promise.race([completed, stopped]);\n\t} finally {\n\t\tclearTimeout(timeout);\n\t\tsignal?.removeEventListener(\"abort\", abort);\n\t}\n}\n\nfunction validSession(value: unknown): value is LspSessionV1 {\n\treturn (\n\t\tisRecord(value) &&\n\t\thasOnlyKeys(value, [\"sessionRef\"]) &&\n\t\ttypeof value.sessionRef === \"string\" &&\n\t\tsafeOpaqueRef(value.sessionRef)\n\t);\n}\n\nfunction completeResult(operationId: string, value: unknown, limit: number): LspDiagnosticsResultV1 {\n\tif (!isRecord(value) || !hasOnlyKeys(value, [\"status\", \"diagnostics\", \"reportArtifactRef\"]))\n\t\treturn adapterFailed(operationId);\n\tif (value.status === \"unsupported\") return unsupported(operationId);\n\tif (value.status !== \"completed\" || (value.diagnostics !== undefined && !Array.isArray(value.diagnostics)))\n\t\treturn adapterFailed(operationId);\n\tconst rawDiagnostics = value.diagnostics ?? [];\n\tif (rawDiagnostics.length > MAX_HOST_DIAGNOSTICS_V1) return adapterFailed(operationId);\n\tconst projected = rawDiagnostics.map(projectDiagnostic);\n\tif (projected.some((diagnostic) => diagnostic === undefined)) return adapterFailed(operationId);\n\tconst bounded = (projected as LspDiagnosticV1[]).slice(0, Math.min(limit, LSP_DIAGNOSTICS_MAX_ITEMS_V1));\n\tconst result: LspDiagnosticsResultV1 = {\n\t\tversion: 1,\n\t\toperationId,\n\t\tstatus: \"succeeded\",\n\t\tsummary: summaryFor(projected as LspDiagnosticV1[]),\n\t\tdiagnostics: bounded,\n\t\tdiagnosticsTruncated: rawDiagnostics.length > bounded.length,\n\t\t...(value.reportArtifactRef === undefined ? {} : { reportArtifactRef: value.reportArtifactRef as string }),\n\t};\n\tif (\n\t\tvalue.reportArtifactRef !== undefined &&\n\t\t(typeof value.reportArtifactRef !== \"string\" || !safeOpaqueRef(value.reportArtifactRef))\n\t)\n\t\treturn adapterFailed(operationId);\n\treturn contextBoundResult(result);\n}\n\n/** Creates a host-bound Node adapter. No command, cwd, environment, or source-text input is accepted. */\nexport function createNodeLspAdapterV1(options: NodeLspAdapterOptionsV1 = {}): LspDiagnosticsAdapterV1 {\n\tconst defaultTimeoutMs = options.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS_V1;\n\tif (!validPositiveInteger(defaultTimeoutMs, MAX_TIMEOUT_MS_V1))\n\t\tthrow new Error(`defaultTimeoutMs must be a positive integer at most ${MAX_TIMEOUT_MS_V1}`);\n\treturn {\n\t\tadapterId: LSP_DIAGNOSTICS_HOST_ADAPTER_ID_V1,\n\t\tadapterVersion: LSP_DIAGNOSTICS_HOST_ADAPTER_VERSION_V1,\n\t\tasync run(request, signal) {\n\t\t\tconst operationId =\n\t\t\t\ttypeof request.operationId === \"string\" && request.operationId.trim() !== \"\"\n\t\t\t\t\t? request.operationId.length <= LSP_DIAGNOSTICS_MAX_OPERATION_ID_CHARS_V1\n\t\t\t\t\t\t? request.operationId\n\t\t\t\t\t\t: \"profile-runtime-tool-call\"\n\t\t\t\t\t: \"invalid-lsp-operation\";\n\t\t\tconst invalid = validateRequest(request);\n\t\t\tif (invalid !== undefined) return invalidInput(operationId, invalid);\n\t\t\tif (signal?.aborted) return cancelled(operationId);\n\t\t\tif (options.resolver === undefined || options.client === undefined) return unsupported(operationId);\n\t\t\tconst resolution = await runBounded(\n\t\t\t\t(internalSignal) => options.resolver!.resolve(request, internalSignal).then((session) => ({ session })),\n\t\t\t\tdefaultTimeoutMs,\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tif (resolution === CANCELLATION_V1) return cancelled(operationId);\n\t\t\tif (resolution === TIMEOUT_V1) return timedOut(operationId);\n\t\t\tif (resolution === undefined) return adapterFailed(operationId);\n\t\t\tif (signal?.aborted) return cancelled(operationId);\n\t\t\tconst session = resolution.session;\n\t\t\tif (session === undefined) return unsupported(operationId);\n\t\t\tif (!validSession(session)) return adapterFailed(operationId);\n\t\t\tconst raw = await runBounded(\n\t\t\t\t(internalSignal) => options.client!.diagnose({ session, request }, internalSignal),\n\t\t\t\tdefaultTimeoutMs,\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tif (raw === CANCELLATION_V1) return cancelled(operationId);\n\t\t\tif (raw === TIMEOUT_V1) return timedOut(operationId);\n\t\t\tif (raw === undefined) return adapterFailed(operationId);\n\t\t\treturn completeResult(operationId, raw, request.diagnosticsLimit ?? LSP_DIAGNOSTICS_MAX_ITEMS_V1);\n\t\t},\n\t};\n}\n\n/** Deterministic fixture adapter for tests; it never starts a language server. */\nexport function createDeterministicLspAdapterV1(fixtures: readonly LspDeterministicFixtureV1[]) {\n\tconst fixtureByKey = new Map<string, LspDeterministicFixtureV1>();\n\tfor (const fixture of fixtures) {\n\t\tconst key = `${fixture.workspaceRef}\\u0000${fixture.language}\\u0000${fixture.documentRef}`;\n\t\tif (fixtureByKey.has(key)) throw new Error(\"Deterministic LSP fixtures must be unique\");\n\t\tfixtureByKey.set(key, fixture);\n\t}\n\treturn createNodeLspAdapterV1({\n\t\tresolver: {\n\t\t\tasync resolve(request) {\n\t\t\t\tconst fixture = fixtureByKey.get(\n\t\t\t\t\t`${request.workspaceRef}\\u0000${request.language}\\u0000${request.documentRef}`,\n\t\t\t\t);\n\t\t\t\treturn fixture === undefined ? undefined : { sessionRef: `fixture:${request.documentRef}` };\n\t\t\t},\n\t\t},\n\t\tclient: {\n\t\t\tasync diagnose(input) {\n\t\t\t\tconst fixture = fixtureByKey.get(\n\t\t\t\t\t`${input.request.workspaceRef}\\u0000${input.request.language}\\u0000${input.request.documentRef}`,\n\t\t\t\t);\n\t\t\t\treturn fixture?.result ?? { status: \"unsupported\" };\n\t\t\t},\n\t\t},\n\t});\n}\n"]}

package/dist/node-lsp-real-host.d.ts

@@ -0,0 +1,38 @@
+import type { LspClientV1, LspSessionResolverV1 } from "./types.ts";
+export interface LspServerSpecV1 {
+    readonly command: string;
+    readonly args: readonly string[];
+}
+export interface LspServerMapV1 {
+    readonly typescript?: LspServerSpecV1;
+    readonly python?: LspServerSpecV1;
+    readonly c?: LspServerSpecV1;
+}
+/**
+ * Host-owned language-server resolution: tsserver from the workspace-local
+ * TypeScript install, pyright from the workspace-local npm package or PATH,
+ * clangd from PATH. Unresolved languages stay absent so the wiring fails
+ * closed; `servers` injects deterministic overrides for tests.
+ */
+export declare function resolveLspServersV1(options: {
+    readonly workspaceDirectory: string;
+    readonly pathEnv?: string;
+    readonly servers?: LspServerMapV1;
+}): LspServerMapV1;
+/**
+ * Real language-server host over one workspace directory: resolves servers per
+ * language (tsserver/pyright/clangd), opens the requested workspace-relative
+ * document, collects push diagnostics over LSP or the tsserver protocol, and
+ * never returns server argv, cwd, environment, or absolute paths. Servers are
+ * injected per resolution; a workspace without a resolvable server reports
+ * `unsupported`.
+ */
+export declare function createNodeLspRealHostV1(options: {
+    readonly workspaceDirectory: string;
+    readonly pathEnv?: string;
+    readonly servers?: LspServerMapV1;
+}): {
+    readonly resolver: LspSessionResolverV1;
+    readonly client: LspClientV1;
+};
+//# sourceMappingURL=node-lsp-real-host.d.ts.map

package/dist/node-lsp-real-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-lsp-real-host.d.ts","sourceRoot":"","sources":["../src/node-lsp-real-host.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,WAAW,EAIX,oBAAoB,EAEpB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC;CAC7B;AAuBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CAClC,GAAG,cAAc,CAmBjB;AAuTD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CAClC,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CA2C5E","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { existsSync, statSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { sanitizeLspDiagnosticsTextV1 } from \"./node-adapter.ts\";\nimport type {\n\tLspClientV1,\n\tLspDiagnosticsRequestV1,\n\tLspDiagnosticV1,\n\tLspHostDiagnosticResultV1,\n\tLspSessionResolverV1,\n\tLspSessionV1,\n} from \"./types.ts\";\n\nconst LSP_DIAGNOSTICS_STABLE_MS_V1 = 300;\nconst LSP_DIAGNOSTICS_TIMEOUT_MS_V1 = 15_000;\nconst TSSERVER_DIAGNOSTICS_TIMEOUT_MS_V1 = 15_000;\nconst MAX_SERVER_STDOUT_BYTES_V1 = 8 * 1024 * 1024;\n\nexport interface LspServerSpecV1 {\n\treadonly command: string;\n\treadonly args: readonly string[];\n}\n\nexport interface LspServerMapV1 {\n\treadonly typescript?: LspServerSpecV1;\n\treadonly python?: LspServerSpecV1;\n\treadonly c?: LspServerSpecV1;\n}\n\nconst SERVER_LANGUAGE_V1: Record<string, keyof LspServerMapV1> = {\n\ttypescript: \"typescript\",\n\tjavascript: \"typescript\",\n\tpython: \"python\",\n\tc: \"c\",\n\tcpp: \"c\",\n};\n\nfunction pathExecutableV1(name: string, pathEnv: string | undefined): string | undefined {\n\tif (typeof pathEnv !== \"string\" || pathEnv.trim() === \"\") return undefined;\n\tconst names = process.platform === \"win32\" ? [`${name}.exe`, `${name}.cmd`] : [name];\n\tfor (const directory of pathEnv.split(process.platform === \"win32\" ? \";\" : \":\")) {\n\t\tif (directory.trim() === \"\") continue;\n\t\tfor (const candidate of names) {\n\t\t\tconst resolved = join(directory, candidate);\n\t\t\tif (existsSync(resolved)) return resolved;\n\t\t}\n\t}\n\treturn undefined;\n}\n\n/**\n * Host-owned language-server resolution: tsserver from the workspace-local\n * TypeScript install, pyright from the workspace-local npm package or PATH,\n * clangd from PATH. Unresolved languages stay absent so the wiring fails\n * closed; `servers` injects deterministic overrides for tests.\n */\nexport function resolveLspServersV1(options: {\n\treadonly workspaceDirectory: string;\n\treadonly pathEnv?: string;\n\treadonly servers?: LspServerMapV1;\n}): LspServerMapV1 {\n\tif (options.servers !== undefined) return options.servers;\n\tconst pathEnv = options.pathEnv ?? process.env.PATH;\n\tconst map: {\n\t\ttypescript?: LspServerSpecV1;\n\t\tpython?: LspServerSpecV1;\n\t\tc?: LspServerSpecV1;\n\t} = {};\n\tconst tsserver = join(options.workspaceDirectory, \"node_modules\", \"typescript\", \"lib\", \"tsserver.js\");\n\tif (isAbsolute(options.workspaceDirectory) && existsSync(tsserver))\n\t\tmap.typescript = { command: process.execPath, args: [tsserver] };\n\tconst pyrightLocal = join(options.workspaceDirectory, \"node_modules\", \"pyright\", \"dist\", \"pyright-langserver.js\");\n\tif (isAbsolute(options.workspaceDirectory) && existsSync(pyrightLocal))\n\t\tmap.python = { command: process.execPath, args: [pyrightLocal, \"--stdio\"] };\n\tconst pyrightPath = pathExecutableV1(\"pyright-langserver\", pathEnv);\n\tif (map.python === undefined && pyrightPath !== undefined) map.python = { command: pyrightPath, args: [\"--stdio\"] };\n\tconst clangd = pathExecutableV1(\"clangd\", pathEnv);\n\tif (clangd !== undefined) map.c = { command: clangd, args: [] };\n\treturn map;\n}\n\ninterface BoundedDiagnosticV1 {\n\treadonly file: string;\n\treadonly range: LspDiagnosticV1[\"range\"];\n\treadonly severity: LspDiagnosticV1[\"severity\"];\n\treadonly code?: string | number;\n\treadonly source?: string;\n\treadonly message: string;\n}\n\nfunction lspSeverityV1(value: unknown): LspDiagnosticV1[\"severity\"] {\n\tif (value === 1) return \"error\";\n\tif (value === 2) return \"warning\";\n\tif (value === 3) return \"info\";\n\tif (value === 4) return \"hint\";\n\treturn \"info\";\n}\n\nfunction tsserverCategoryV1(value: unknown): LspDiagnosticV1[\"severity\"] {\n\tif (value === \"error\") return \"error\";\n\tif (value === \"warning\") return \"warning\";\n\tif (value === \"suggestion\") return \"hint\";\n\treturn \"info\";\n}\n\ninterface SpawnedServerV1 {\n\treadonly stdout: AsyncIterable<Buffer>;\n\treadonly write: (chunk: string) => void;\n\treadonly kill: () => void;\n\treadonly exit: Promise<void>;\n}\n\nfunction spawnServerV1(spec: LspServerSpecV1, signal: AbortSignal): SpawnedServerV1 | undefined {\n\tconst child = spawn(spec.command, spec.args, {\n\t\tshell: false,\n\t\twindowsHide: true,\n\t\tstdio: [\"pipe\", \"pipe\", \"ignore\"],\n\t\tsignal,\n\t});\n\tif (child.stdout === null || child.stdin === null) {\n\t\tchild.kill();\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tstdout: child.stdout,\n\t\twrite: (chunk) => child.stdin!.write(chunk),\n\t\tkill: () => child.kill(),\n\t\texit: new Promise((resolveExit) => {\n\t\t\tchild.once(\"exit\", () => resolveExit());\n\t\t\tchild.once(\"error\", () => resolveExit());\n\t\t}),\n\t};\n}\n\n/** Frame reader over stdio: either Content-Length framed (LSP) or line-delimited JSON (tsserver). */\nasync function* readMessagesV1(server: SpawnedServerV1, framed: boolean): AsyncGenerator<string> {\n\tlet buffer = \"\";\n\tfor await (const chunk of server.stdout) {\n\t\tbuffer += chunk.toString(\"utf8\");\n\t\tif (buffer.length > MAX_SERVER_STDOUT_BYTES_V1) return;\n\t\tif (framed) {\n\t\t\tfor (;;) {\n\t\t\t\tconst headerEnd = buffer.indexOf(\"\\r\\n\\r\\n\");\n\t\t\t\tif (headerEnd === -1) break;\n\t\t\t\tconst header = buffer.slice(0, headerEnd);\n\t\t\t\tconst lengthMatch = header.match(/Content-Length:\\s*(\\d+)/i);\n\t\t\t\tif (lengthMatch === null) return;\n\t\t\t\tconst length = Number(lengthMatch[1]);\n\t\t\t\tconst bodyStart = headerEnd + 4;\n\t\t\t\tif (buffer.length < bodyStart + length) break;\n\t\t\t\tyield buffer.slice(bodyStart, bodyStart + length);\n\t\t\t\tbuffer = buffer.slice(bodyStart + length);\n\t\t\t}\n\t\t} else {\n\t\t\tfor (;;) {\n\t\t\t\tconst lineEnd = buffer.indexOf(\"\\n\");\n\t\t\t\tif (lineEnd === -1) break;\n\t\t\t\tconst line = buffer.slice(0, lineEnd).trim();\n\t\t\t\tbuffer = buffer.slice(lineEnd + 1);\n\t\t\t\tif (line !== \"\") yield line;\n\t\t\t}\n\t\t}\n\t}\n}\n\nfunction safePositionV1(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0 ? value : 0;\n}\n\nfunction parseLspDiagnosticsV1(documentPath: string, params: unknown): BoundedDiagnosticV1[] {\n\tif (typeof params !== \"object\" || params === null) return [];\n\tconst diagnostics = (params as { diagnostics?: unknown }).diagnostics;\n\tif (!Array.isArray(diagnostics)) return [];\n\tconst projected: BoundedDiagnosticV1[] = [];\n\tfor (const raw of diagnostics) {\n\t\tif (typeof raw !== \"object\" || raw === null) continue;\n\t\tconst item = raw as {\n\t\t\trange?: { start?: { line?: unknown; character?: unknown }; end?: { line?: unknown; character?: unknown } };\n\t\t\tseverity?: unknown;\n\t\t\tcode?: unknown;\n\t\t\tsource?: unknown;\n\t\t\tmessage?: unknown;\n\t\t};\n\t\tconst message = typeof item.message === \"string\" ? sanitizeLspDiagnosticsTextV1(item.message) : \"\";\n\t\tif (message === \"\") continue;\n\t\tconst line = safePositionV1(item.range?.start?.line);\n\t\tconst column = safePositionV1(item.range?.start?.character);\n\t\tconst endLine = Math.max(line, safePositionV1(item.range?.end?.line));\n\t\tconst endColumn =\n\t\t\tendLine === line\n\t\t\t\t? Math.max(column, safePositionV1(item.range?.end?.character))\n\t\t\t\t: safePositionV1(item.range?.end?.character);\n\t\tprojected.push({\n\t\t\tfile: documentPath,\n\t\t\trange: { start: { line, column }, end: { line: endLine, column: endColumn } },\n\t\t\tseverity: lspSeverityV1(item.severity),\n\t\t\t...(typeof item.code === \"string\" || (typeof item.code === \"number\" && Number.isSafeInteger(item.code))\n\t\t\t\t? { code: item.code }\n\t\t\t\t: {}),\n\t\t\t...(typeof item.source === \"string\" ? { source: sanitizeLspDiagnosticsTextV1(item.source, 128) } : {}),\n\t\t\tmessage,\n\t\t});\n\t}\n\treturn projected;\n}\n\nfunction parseTsserverDiagnosticsV1(documentPath: string, body: unknown): BoundedDiagnosticV1[] {\n\tif (typeof body !== \"object\" || body === null) return [];\n\tconst diagnostics = (body as { diagnostics?: unknown }).diagnostics;\n\tif (!Array.isArray(diagnostics)) return [];\n\tconst projected: BoundedDiagnosticV1[] = [];\n\tfor (const raw of diagnostics) {\n\t\tif (typeof raw !== \"object\" || raw === null) continue;\n\t\tconst item = raw as {\n\t\t\tstart?: { line?: unknown; offset?: unknown };\n\t\t\tend?: { line?: unknown; offset?: unknown };\n\t\t\ttext?: unknown;\n\t\t\tcode?: unknown;\n\t\t\tcategory?: unknown;\n\t\t};\n\t\tconst message = typeof item.text === \"string\" ? sanitizeLspDiagnosticsTextV1(item.text) : \"\";\n\t\tif (message === \"\") continue;\n\t\t// tsserver positions are 1-based; normalize to the 0-based public shape.\n\t\tconst line = Math.max(0, safePositionV1(item.start?.line) - 1);\n\t\tconst column = Math.max(0, safePositionV1(item.start?.offset) - 1);\n\t\tconst endLine = Math.max(line, Math.max(0, safePositionV1(item.end?.line) - 1));\n\t\tconst endColumn =\n\t\t\tendLine === line\n\t\t\t\t? Math.max(column, Math.max(0, safePositionV1(item.end?.offset) - 1))\n\t\t\t\t: Math.max(0, safePositionV1(item.end?.offset) - 1);\n\t\tprojected.push({\n\t\t\tfile: documentPath,\n\t\t\trange: { start: { line, column }, end: { line: endLine, column: endColumn } },\n\t\t\tseverity: tsserverCategoryV1(item.category),\n\t\t\t...(typeof item.code === \"number\" && Number.isSafeInteger(item.code) ? { code: item.code } : {}),\n\t\t\tmessage,\n\t\t});\n\t}\n\treturn projected;\n}\n\n/**\n * LSP push client: initialize → didOpen → collect publishDiagnostics →\n * shutdown. The server stream is consumed by exactly one loop — breaking out\n * of a for-await over a Node stream destroys it, so phase transitions happen\n * inside the loop and the stability window resolves the shared promise\n * without interrupting the iteration.\n */\nasync function diagnoseWithLspServerV1(\n\tspec: LspServerSpecV1,\n\trelativePath: string,\n\tabsolutePath: string,\n\tlanguage: string,\n\ttext: string,\n\tsignal: AbortSignal,\n): Promise<BoundedDiagnosticV1[] | undefined> {\n\tconst server = spawnServerV1(spec, signal);\n\tif (server === undefined) return undefined;\n\tlet sequence = 0;\n\tconst nextId = () => ++sequence;\n\tconst send = (message: Record<string, unknown>): void => {\n\t\tconst payload = Buffer.from(JSON.stringify(message), \"utf8\");\n\t\tserver.write(`Content-Length: ${payload.byteLength}\\r\\n\\r\\n${payload.toString(\"utf8\")}`);\n\t};\n\tconst uri = pathToFileURL(absolutePath).href;\n\ttry {\n\t\tconst consumed = new Promise<BoundedDiagnosticV1[] | undefined>((resolveConsume) => {\n\t\t\tlet stableTimer: NodeJS.Timeout | undefined;\n\t\t\tlet latest: BoundedDiagnosticV1[] | undefined;\n\t\t\t// The stability window arms only after the first push so cold-start\n\t\t\t// servers are not cut off before their first diagnostics.\n\t\t\tconst arm = () => {\n\t\t\t\tclearTimeout(stableTimer);\n\t\t\t\tstableTimer = setTimeout(() => resolveConsume(latest), LSP_DIAGNOSTICS_STABLE_MS_V1);\n\t\t\t};\n\t\t\tvoid (async () => {\n\t\t\t\tsend({ jsonrpc: \"2.0\", id: nextId(), method: \"initialize\", params: { processId: null, capabilities: {} } });\n\t\t\t\tlet initialized = false;\n\t\t\t\tfor await (const raw of readMessagesV1(server, true)) {\n\t\t\t\t\tlet message: Record<string, unknown>;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tmessage = JSON.parse(raw) as Record<string, unknown>;\n\t\t\t\t\t} catch {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (message.id !== undefined && message.method === undefined) {\n\t\t\t\t\t\tif (!initialized) {\n\t\t\t\t\t\t\tinitialized = true;\n\t\t\t\t\t\t\tsend({ jsonrpc: \"2.0\", method: \"initialized\", params: {} });\n\t\t\t\t\t\t\tsend({\n\t\t\t\t\t\t\t\tjsonrpc: \"2.0\",\n\t\t\t\t\t\t\t\tmethod: \"textDocument/didOpen\",\n\t\t\t\t\t\t\t\tparams: { textDocument: { uri, languageId: language, version: 1, text } },\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tif (message.method === \"textDocument/publishDiagnostics\") {\n\t\t\t\t\t\tconst pushed = parseLspDiagnosticsV1(relativePath, message.params);\n\t\t\t\t\t\tif (pushed.length > 0) {\n\t\t\t\t\t\t\tlatest = pushed;\n\t\t\t\t\t\t\tarm();\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tresolveConsume(latest);\n\t\t\t})().catch(() => resolveConsume(latest));\n\t\t});\n\t\tconst timeout = new Promise<undefined>((resolveTimeout) => {\n\t\t\tsetTimeout(() => resolveTimeout(undefined), LSP_DIAGNOSTICS_TIMEOUT_MS_V1);\n\t\t});\n\t\tconst result = await Promise.race([consumed, timeout]);\n\t\tsend({ jsonrpc: \"2.0\", id: nextId(), method: \"shutdown\", params: null });\n\t\tsend({ jsonrpc: \"2.0\", method: \"exit\" });\n\t\treturn result;\n\t} finally {\n\t\tserver.kill();\n\t\tawait server.exit;\n\t}\n}\n\n/** tsserver client: configure → open → geterr → syntaxDiag/semanticDiag events. */\nasync function diagnoseWithTsserverV1(\n\tspec: LspServerSpecV1,\n\trelativePath: string,\n\tabsolutePath: string,\n\ttext: string,\n\tsignal: AbortSignal,\n): Promise<BoundedDiagnosticV1[] | undefined> {\n\tconst server = spawnServerV1(spec, signal);\n\tif (server === undefined) return undefined;\n\tlet sequence = 0;\n\tconst send = (command: string, argumentsValue: Record<string, unknown>): void => {\n\t\tserver.write(`${JSON.stringify({ seq: ++sequence, type: \"request\", command, arguments: argumentsValue })}\\n`);\n\t};\n\tconst collected: BoundedDiagnosticV1[] = [];\n\tconst received = { syntax: false, semantic: false };\n\ttry {\n\t\tsend(\"configure\", { hostInfo: \"agent-forge\" });\n\t\tsend(\"open\", { file: absolutePath, fileContent: text });\n\t\tsend(\"geterr\", { file: absolutePath, delay: 0 });\n\t\tconst timeout = new Promise<undefined>((resolveTimeout) => {\n\t\t\tsetTimeout(() => resolveTimeout(undefined), TSSERVER_DIAGNOSTICS_TIMEOUT_MS_V1);\n\t\t});\n\t\tconst collectedPromise = (async () => {\n\t\t\tfor await (const raw of readMessagesV1(server, false)) {\n\t\t\t\tlet message: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tmessage = JSON.parse(raw) as Record<string, unknown>;\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (message.type !== \"event\") continue;\n\t\t\t\tif (message.event === \"syntaxDiag\" || message.event === \"syntacticDiag\") {\n\t\t\t\t\tcollected.push(...parseTsserverDiagnosticsV1(relativePath, message.body));\n\t\t\t\t\treceived.syntax = true;\n\t\t\t\t}\n\t\t\t\tif (message.event === \"semanticDiag\") {\n\t\t\t\t\tcollected.push(...parseTsserverDiagnosticsV1(relativePath, message.body));\n\t\t\t\t\treceived.semantic = true;\n\t\t\t\t}\n\t\t\t\tif (received.syntax && received.semantic) break;\n\t\t\t}\n\t\t\treturn collected;\n\t\t})().catch(() => collected);\n\t\tconst result = await Promise.race([collectedPromise, timeout]);\n\t\tsend(\"exit\", {});\n\t\treturn result;\n\t} finally {\n\t\tserver.kill();\n\t\tawait server.exit;\n\t}\n}\n\nfunction resolveDocumentPathV1(workspaceDirectory: string, request: LspDiagnosticsRequestV1): string | undefined {\n\tconst documentPath = request.documentPath;\n\tif (typeof documentPath !== \"string\" || documentPath.trim() === \"\" || !isAbsolute(workspaceDirectory))\n\t\treturn undefined;\n\tconst absolute = resolve(workspaceDirectory, documentPath);\n\tconst root = resolve(workspaceDirectory);\n\tif (!absolute.startsWith(root + (root.endsWith(\"\\\\\") || root.endsWith(\"/\") ? \"\" : \"\\\\\")) && absolute !== root)\n\t\treturn undefined;\n\ttry {\n\t\tif (!existsSync(absolute) || !statSync(absolute).isFile()) return undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n\treturn absolute;\n}\n\n/**\n * Real language-server host over one workspace directory: resolves servers per\n * language (tsserver/pyright/clangd), opens the requested workspace-relative\n * document, collects push diagnostics over LSP or the tsserver protocol, and\n * never returns server argv, cwd, environment, or absolute paths. Servers are\n * injected per resolution; a workspace without a resolvable server reports\n * `unsupported`.\n */\nexport function createNodeLspRealHostV1(options: {\n\treadonly workspaceDirectory: string;\n\treadonly pathEnv?: string;\n\treadonly servers?: LspServerMapV1;\n}): { readonly resolver: LspSessionResolverV1; readonly client: LspClientV1 } {\n\tconst workspaceDirectory = resolve(options.workspaceDirectory);\n\tconst servers = resolveLspServersV1({\n\t\tworkspaceDirectory,\n\t\t...(options.pathEnv === undefined ? {} : { pathEnv: options.pathEnv }),\n\t\t...(options.servers === undefined ? {} : { servers: options.servers }),\n\t});\n\treturn {\n\t\tresolver: {\n\t\t\tasync resolve(request: LspDiagnosticsRequestV1): Promise<LspSessionV1 | undefined> {\n\t\t\t\tconst language = SERVER_LANGUAGE_V1[request.language];\n\t\t\t\tif (language === undefined) return undefined;\n\t\t\t\tif (servers[language] === undefined) return undefined;\n\t\t\t\treturn { sessionRef: `lsp-${language}` };\n\t\t\t},\n\t\t},\n\t\tclient: {\n\t\t\tasync diagnose({ request }, signal): Promise<LspHostDiagnosticResultV1> {\n\t\t\t\tconst language = SERVER_LANGUAGE_V1[request.language];\n\t\t\t\tconst spec = language === undefined ? undefined : servers[language];\n\t\t\t\tif (spec === undefined) return { status: \"unsupported\" };\n\t\t\t\tconst documentPath = resolveDocumentPathV1(workspaceDirectory, request);\n\t\t\t\tif (documentPath === undefined) return { status: \"unsupported\" };\n\t\t\t\tconst abortSignal = signal ?? new AbortController().signal;\n\t\t\t\tconst text = await readFile(documentPath, \"utf8\").catch(() => undefined);\n\t\t\t\tif (text === undefined) return { status: \"unsupported\" };\n\t\t\t\tconst relativePath = request.documentPath ?? request.documentRef;\n\t\t\t\tconst diagnostics =\n\t\t\t\t\tlanguage === \"typescript\"\n\t\t\t\t\t\t? await diagnoseWithTsserverV1(spec, relativePath, documentPath, text, abortSignal)\n\t\t\t\t\t\t: await diagnoseWithLspServerV1(\n\t\t\t\t\t\t\t\tspec,\n\t\t\t\t\t\t\t\trelativePath,\n\t\t\t\t\t\t\t\tdocumentPath,\n\t\t\t\t\t\t\t\trequest.language,\n\t\t\t\t\t\t\t\ttext,\n\t\t\t\t\t\t\t\tabortSignal,\n\t\t\t\t\t\t\t);\n\t\t\t\tif (diagnostics === undefined) return { status: \"unsupported\" };\n\t\t\t\treturn { status: \"completed\", diagnostics };\n\t\t\t},\n\t\t},\n\t};\n}\n"]}