@prismatic-io/lux 0.0.1

package/lib/drivers/mcp/transport.js

@@ -0,0 +1,190 @@
+import { JSONRPCMessageSchema } from "@modelcontextprotocol/sdk/types.js";
+import { spawnManagedProcess } from "../../core/index.js";
+const DEFAULT_MAX_PROTOCOL_LINE_BYTES = 10_000_000;
+const DEFAULT_MAX_STDERR_TAIL_CHARS = 8_192;
+const DEFAULT_KILL_GRACE_MS = 5_000;
+/**
+ * MCP's stdio framing with Lux-owned process-group and memory boundaries.
+ * Protocol messages remain SDK-validated, but no SDK process lifecycle leaks
+ * through this transport.
+ */
+export class McpStdioClientTransport {
+    onclose;
+    onerror;
+    onmessage;
+    options;
+    maxProtocolLineBytes;
+    maxStderrTailChars;
+    process = null;
+    stdoutChunks = [];
+    stdoutBytes = 0;
+    stderrTail = "";
+    stderrTruncated = false;
+    closePromise = null;
+    closeNotified = false;
+    started = false;
+    closing = false;
+    transportError = null;
+    constructor(options) {
+        this.options = options;
+        this.maxProtocolLineBytes = options.maxProtocolLineBytes ?? DEFAULT_MAX_PROTOCOL_LINE_BYTES;
+        this.maxStderrTailChars = options.maxStderrTailChars ?? DEFAULT_MAX_STDERR_TAIL_CHARS;
+    }
+    get failure() {
+        return this.transportError;
+    }
+    get pid() {
+        return this.process?.child.pid ?? null;
+    }
+    async start() {
+        if (this.started)
+            throw new Error("MCP stdio transport already started");
+        this.started = true;
+        const managed = spawnManagedProcess(this.options.command, this.options.args ?? [], {
+            killGraceMs: this.options.killGraceMs ?? DEFAULT_KILL_GRACE_MS,
+            ...(this.options.cwd === undefined ? {} : { cwd: this.options.cwd }),
+            ...(this.options.env === undefined ? {} : { env: this.options.env }),
+        });
+        this.process = managed;
+        const { child } = managed;
+        child.stdout.on("data", (chunk) => this.readStdout(chunk));
+        child.stdout.on("end", () => {
+            if (!this.closing && this.stdoutBytes > 0) {
+                this.fail(new Error(`MCP server stdout ended with an unterminated ${this.stdoutBytes}-byte protocol line`));
+            }
+            this.clearStdout();
+        });
+        child.stdout.on("error", (err) => this.fail(new Error(`MCP server stdout: ${err.message}`)));
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => this.readStderr(chunk));
+        child.stderr.on("end", () => this.flushStderr());
+        child.stderr.on("error", (err) => this.fail(new Error(`MCP server stderr: ${err.message}`)));
+        void managed.exited.then(() => {
+            this.flushStderr();
+            this.clearStdout();
+            this.process = null;
+            this.notifyClose();
+        });
+        try {
+            await managed.spawned;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.transportError ??= error;
+            await managed.terminate();
+            throw error;
+        }
+    }
+    async send(message) {
+        const stdin = this.process?.child.stdin;
+        if (!stdin || this.closing || stdin.destroyed)
+            throw new Error("MCP stdio transport is closed");
+        const serialized = `${JSON.stringify(message)}\n`;
+        await new Promise((resolve, reject) => {
+            stdin.write(serialized, (err) => {
+                if (err)
+                    reject(new Error(`MCP server stdin: ${err.message}`, { cause: err }));
+                else
+                    resolve();
+            });
+        });
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closing = true;
+        this.closePromise = (async () => {
+            const managed = this.process;
+            if (managed) {
+                managed.child.stdin.end();
+                await managed.terminate();
+            }
+            this.clearStdout();
+            this.flushStderr();
+            this.notifyClose();
+        })();
+        return this.closePromise;
+    }
+    readStdout(chunk) {
+        if (this.transportError || this.closing)
+            return;
+        let offset = 0;
+        while (offset < chunk.length) {
+            const newline = chunk.indexOf(0x0a, offset);
+            const end = newline === -1 ? chunk.length : newline;
+            const segment = chunk.subarray(offset, end);
+            const lineBytes = this.stdoutBytes + segment.length;
+            if (lineBytes > this.maxProtocolLineBytes) {
+                this.fail(new Error(`MCP server stdout protocol line exceeded ${this.maxProtocolLineBytes} bytes`));
+                return;
+            }
+            if (segment.length > 0) {
+                this.stdoutChunks.push(segment);
+                this.stdoutBytes = lineBytes;
+            }
+            if (newline === -1)
+                return;
+            this.dispatchLine(Buffer.concat(this.stdoutChunks, this.stdoutBytes));
+            if (this.transportError)
+                return;
+            this.clearStdout();
+            offset = newline + 1;
+        }
+    }
+    clearStdout() {
+        this.stdoutChunks = [];
+        this.stdoutBytes = 0;
+    }
+    dispatchLine(lineBuffer) {
+        const line = lineBuffer.toString("utf8").replace(/\r$/, "");
+        try {
+            const message = JSONRPCMessageSchema.parse(JSON.parse(line));
+            this.onmessage?.(message);
+        }
+        catch (err) {
+            this.fail(new Error(`MCP server emitted an invalid JSON-RPC line: ${err instanceof Error ? err.message : String(err)}`, { cause: err }));
+        }
+    }
+    readStderr(chunk) {
+        let offset = 0;
+        while (offset < chunk.length) {
+            const newline = chunk.indexOf("\n", offset);
+            const end = newline === -1 ? chunk.length : newline;
+            this.appendStderr(chunk.slice(offset, end));
+            if (newline === -1)
+                return;
+            this.flushStderr();
+            offset = newline + 1;
+        }
+    }
+    appendStderr(text) {
+        if (text.length === 0)
+            return;
+        if (this.stderrTail.length + text.length > this.maxStderrTailChars) {
+            this.stderrTruncated = true;
+        }
+        this.stderrTail = `${this.stderrTail}${text}`.slice(-this.maxStderrTailChars);
+    }
+    flushStderr() {
+        if (!this.stderrTail && !this.stderrTruncated)
+            return;
+        const line = this.stderrTail.replace(/\r$/, "");
+        this.options.writeStderr?.(this.stderrTruncated ? `[truncated] …${line}` : line);
+        this.stderrTail = "";
+        this.stderrTruncated = false;
+    }
+    fail(error) {
+        if (this.transportError || this.closing)
+            return;
+        this.transportError = error;
+        this.onerror?.(error);
+        void this.close();
+    }
+    notifyClose() {
+        if (this.closeNotified)
+            return;
+        this.closeNotified = true;
+        this.onclose?.();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/lib/drivers/mcp/transport.js.map

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

package/lib/drivers/shared/artifacts.d.ts

@@ -0,0 +1,4 @@
+import { type Artifact } from "../../core/index.js";
+/** Enumerate agent-authored files without following symlinks or build/dependency trees. */
+export declare const walkArtifacts: (root: string, max?: number) => Promise<Artifact[]>;
+//# sourceMappingURL=artifacts.d.ts.map

package/lib/drivers/shared/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/drivers/shared/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,qBAAqB,CAAC;AAI7B,2FAA2F;AAC3F,eAAO,MAAM,aAAa,SAAgB,MAAM,mBAAc,OAAO,CAAC,QAAQ,EAAE,CA0E/E,CAAC"}

package/lib/drivers/shared/artifacts.js

@@ -0,0 +1,81 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { ARTIFACT_SNAPSHOT_MANIFEST, readArtifactSnapshotManifest, } from "../../core/index.js";
+const IGNORED_DIRS = new Set(["node_modules", "lib", "dist"]);
+/** Enumerate agent-authored files without following symlinks or build/dependency trees. */
+export const walkArtifacts = async (root, max = 500) => {
+    if (!Number.isSafeInteger(max) || max <= 0) {
+        throw new RangeError("artifact collection max must be a positive safe integer");
+    }
+    const requestedRoot = resolve(root);
+    const rootMetadata = await lstat(requestedRoot);
+    if (!rootMetadata.isDirectory() || rootMetadata.isSymbolicLink()) {
+        throw new Error(`artifact root must be a real directory: ${root}`);
+    }
+    const canonicalRoot = await realpath(requestedRoot);
+    const out = [];
+    const addArtifact = (path, size) => {
+        if (out.length >= max) {
+            throw new Error(`artifact collection exceeds ${max} files: ${root}`);
+        }
+        out.push({ path, size });
+    };
+    const collectSnapshot = async (dir) => {
+        const manifest = await readArtifactSnapshotManifest(dir);
+        if (!manifest)
+            return false;
+        if (manifest.name !== basename(dir)) {
+            throw new Error(`artifact snapshot manifest names ${manifest.name}, expected ${basename(dir)}`);
+        }
+        const canonicalSnapshotRoot = await realpath(dir);
+        for (const file of manifest.files) {
+            const full = resolve(dir, file.path);
+            const canonicalParent = await realpath(dirname(full));
+            if (canonicalParent !== canonicalSnapshotRoot &&
+                !canonicalParent.startsWith(`${canonicalSnapshotRoot}${sep}`)) {
+                throw new Error(`artifact snapshot path resolves outside its root: ${file.path}`);
+            }
+            const metadata = await lstat(full);
+            if (metadata.isSymbolicLink() || !metadata.isFile() || metadata.size !== file.bytes) {
+                throw new Error(`artifact snapshot file does not match its manifest: ${file.path}`);
+            }
+            addArtifact(relative(requestedRoot, full).split(sep).join("/"), metadata.size);
+        }
+        const manifestPath = join(dir, ARTIFACT_SNAPSHOT_MANIFEST);
+        const manifestStats = await lstat(manifestPath);
+        addArtifact(relative(requestedRoot, manifestPath).split(sep).join("/"), manifestStats.size);
+        return true;
+    };
+    const walk = async (dir) => {
+        const canonicalDirectory = await realpath(dir);
+        if (canonicalDirectory !== canonicalRoot &&
+            !canonicalDirectory.startsWith(`${canonicalRoot}${sep}`)) {
+            throw new Error(`artifact directory resolves outside its root: ${dir}`);
+        }
+        if (await collectSnapshot(dir))
+            return;
+        const entries = await readdir(dir, { withFileTypes: true });
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.isSymbolicLink())
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (await collectSnapshot(full))
+                    continue;
+                if (entry.name.startsWith(".") || IGNORED_DIRS.has(entry.name))
+                    continue;
+                await walk(full);
+            }
+            else if (entry.isFile()) {
+                const metadata = await lstat(full);
+                if (metadata.isFile()) {
+                    addArtifact(relative(requestedRoot, full).split(sep).join("/"), metadata.size);
+                }
+            }
+        }
+    };
+    await walk(requestedRoot);
+    return out;
+};
+//# sourceMappingURL=artifacts.js.map

package/lib/drivers/shared/artifacts.js.map

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

package/lib/drivers/shared/secure-copy.d.ts

@@ -0,0 +1,2 @@
+export declare const copyRegularFileNoFollow: (sourceRoot: string, sourcePath: string, targetPath: string) => Promise<void>;
+//# sourceMappingURL=secure-copy.d.ts.map

package/lib/drivers/shared/secure-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-copy.d.ts","sourceRoot":"","sources":["../../../src/drivers/shared/secure-copy.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,uBAAuB,eACtB,MAAM,cACN,MAAM,cACN,MAAM,KACjB,OAAO,CAAC,IAAI,CA0Bd,CAAC"}

package/lib/drivers/shared/secure-copy.js

@@ -0,0 +1,35 @@
+import { constants, lstat, open, realpath, stat } from "node:fs/promises";
+import { resolve, sep } from "node:path";
+const isWithin = (parent, child) => {
+    const root = resolve(parent);
+    const path = resolve(child);
+    return path === root || path.startsWith(`${root}${sep}`);
+};
+export const copyRegularFileNoFollow = async (sourceRoot, sourcePath, targetPath) => {
+    if ((await lstat(sourcePath)).isSymbolicLink()) {
+        throw new Error(`artifact cannot be a symlink: ${sourcePath}`);
+    }
+    const source = await open(sourcePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    let target;
+    try {
+        const sourceStat = await source.stat();
+        if (!sourceStat.isFile())
+            throw new Error(`artifact is not a regular file: ${sourcePath}`);
+        const resolvedSource = await realpath(sourcePath);
+        if (!isWithin(sourceRoot, resolvedSource)) {
+            throw new Error(`artifact resolves outside the isolated workspace: ${sourcePath}`);
+        }
+        const resolvedStat = await stat(resolvedSource);
+        if (!resolvedStat.isFile() ||
+            resolvedStat.dev !== sourceStat.dev ||
+            resolvedStat.ino !== sourceStat.ino) {
+            throw new Error(`artifact changed while being collected: ${sourcePath}`);
+        }
+        target = await open(targetPath, "wx", sourceStat.mode & 0o777);
+        await target.writeFile(source.createReadStream({ autoClose: false }));
+    }
+    finally {
+        await Promise.allSettled([source.close(), ...(target ? [target.close()] : [])]);
+    }
+};
+//# sourceMappingURL=secure-copy.js.map

package/lib/drivers/shared/secure-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-copy.js","sourceRoot":"","sources":["../../../src/drivers/shared/secure-copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,KAAa,EAAW,EAAE;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,UAAkB,EAClB,UAAkB,EAClB,UAAkB,EACH,EAAE;IACjB,IAAI,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,MAAoD,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;QAC3F,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,qDAAqD,UAAU,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC;QAChD,IACE,CAAC,YAAY,CAAC,MAAM,EAAE;YACtB,YAAY,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG;YACnC,YAAY,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,UAAU,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAC/D,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;AACH,CAAC,CAAC"}

package/lib/drivers/subprocess/index.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { type DriverPlugin, type FormatAnswerFn, type ParseEventFn } from "../../core/index.js";
+export declare const SubprocessDriverConfigSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    inheritEnv: z.ZodOptional<z.ZodBoolean>;
+    protocol: z.ZodDefault<z.ZodEnum<{
+        custom: "custom";
+        "lux-jsonl": "lux-jsonl";
+    }>>;
+    idleTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxInterrupts: z.ZodDefault<z.ZodNumber>;
+    maxArtifactFiles: z.ZodOptional<z.ZodNumber>;
+    maxLineBytes: z.ZodOptional<z.ZodNumber>;
+    parseEvent: z.ZodOptional<z.ZodCustom<ParseEventFn, ParseEventFn>>;
+    formatAnswer: z.ZodOptional<z.ZodCustom<FormatAnswerFn, FormatAnswerFn>>;
+    formatPrompt: z.ZodOptional<z.ZodCustom<(text: string) => string, (text: string) => string>>;
+    closeStdinAfterPrompt: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type SubprocessDriverConfig = z.infer<typeof SubprocessDriverConfigSchema>;
+export declare const subprocessDriver: DriverPlugin<SubprocessDriverConfig>;
+//# sourceMappingURL=index.d.ts.map

package/lib/drivers/subprocess/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/subprocess/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAML,KAAK,YAAY,EAEjB,KAAK,cAAc,EAKnB,KAAK,YAAY,EAQlB,MAAM,qBAAqB,CAAC;AAG7B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;mDAoCP,MAAM,KAAK,MAAM;;kBAY/C,CAAC;AAEL,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAuZlF,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,sBAAsB,CAIjE,CAAC"}