dev3000 0.0.185 → 0.0.187

package/dist/runtime/cli.js

@@ -1,42 +1,88 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
 import { Command } from "commander";
 import { getPortlessProxyStatus, installPortlessService } from "../portless.js";
 import { getAgentBrowserBinaryPath } from "../utils/agent-browser.js";
+import { readRecentEvents, selectEventView } from "./event-views.js";
+import { parseHarness } from "./harness.js";
 import { startRuntime } from "./runtime.js";
+import { addSandboxProjectOptions, registerSandboxCommand, runSandboxProject } from "./sandbox-command.js";
 import { queryRuntime, readRuntimeSession } from "./session.js";
-// The skill helper acquires this package outside the target pnpm workspace.
-// Restore the app cwd before any command resolves project/session state, and
-// do not pass this bootstrap-only setting to the app or browser.
 if (process.env.D3K_BOOTSTRAP_CWD) {
     process.chdir(process.env.D3K_BOOTSTRAP_CWD);
     delete process.env.D3K_BOOTSTRAP_CWD;
 }
 const print = (value) => console.log(JSON.stringify(value));
+const version = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8")).version;
 const program = new Command()
-    .name("d3k-runtime")
-    .description("Skill-owned dev server and browser evidence, held in memory");
+    .name("d3k")
+    .version(version)
+    .description("Dev server and managed browser with a bounded, in-memory event timeline");
+registerSandboxCommand(program);
+addSandboxProjectOptions(program)
+    .option("--command <command>", "Remote dev command")
+    .option("--headless", "Run local Chrome headlessly")
+    .action(runSandboxProject);
+function positiveInteger(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new Error("Expected a positive integer");
+    return parsed;
+}
+program
+    .command("sandbox-serve", { hidden: true })
+    .option("--command <command>")
+    .option("--startup-timeout <ms>", "Server startup deadline in milliseconds", "300000")
+    .action(async (options) => {
+    let input = "";
+    for await (const chunk of process.stdin) {
+        input += chunk.toString();
+        if (input.length > 8192)
+            throw new Error("Sandbox configuration too large");
+    }
+    const sandbox = JSON.parse(input);
+    if (!sandbox ||
+        ![sandbox.serverPort, sandbox.bridgePort].every((port) => Number.isSafeInteger(port) && port > 0 && port <= 65535) ||
+        sandbox.serverPort === sandbox.bridgePort)
+        throw new Error("Invalid sandbox ports");
+    await startRuntime({ command: options.command, startupTimeout: positiveInteger(options.startupTimeout), sandbox });
+});
 program
     .command("start")
-    .option("--command <command>", "Dev server command (defaults to package manager's dev script)")
+    .description("Start the local app and browser; retain this process while testing")
+    .option("--harness <name>", "Run fx, codex, or claude in this terminal when ready", parseHarness)
+    .option("--command <command>", "Dev command (defaults to the package manager's dev script)")
     .option("--headless", "Headless browser for CI")
     .option("--servers-only", "Intentionally omit browser monitoring")
-    .option("--startup-timeout <ms>", "Server startup deadline", "120000")
+    .option("--startup-timeout <ms>", "Server startup deadline in milliseconds", "120000")
+    .option("--browser-navigation-timeout <ms>", "Browser navigation deadline in milliseconds", "30000")
+    .option("--browser <path>", "Browser executable path")
+    .option("--profile-dir <dir>", "Browser profile directory (defaults to the project profile)")
+    .option("--debug", "Browser diagnostic output")
     .action(async (options) => {
-    const startupTimeout = Number(options.startupTimeout);
-    if (!Number.isSafeInteger(startupTimeout) || startupTimeout < 1)
-        throw new Error("Invalid startup timeout");
-    await startRuntime({ ...options, startupTimeout });
+    if (options.serversOnly && (options.headless || options.browser || options.profileDir || options.harness))
+        throw new Error("--servers-only cannot be combined with browser options");
+    if (options.harness && !process.stdin.isTTY)
+        throw new Error("--harness requires an interactive terminal");
+    await startRuntime({
+        ...options,
+        startupTimeout: positiveInteger(options.startupTimeout),
+        browserNavigationTimeout: positiveInteger(options.browserNavigationTimeout)
+    });
 });
-program.command("status").action(async () => {
-    if (!readRuntimeSession()) {
-        print({ running: false, ready: false });
-        return;
-    }
+program
+    .command("status")
+    .description("Show live runtime status")
+    .option("--json", "Output JSON (also the default)")
+    .action(async () => {
+    if (!readRuntimeSession())
+        return print({ running: false, ready: false });
     print(await queryRuntime("/status"));
 });
 program
     .command("events")
+    .description("Read timeline events after a cursor")
     .option("--after <cursor>", "Read after this sequence number", "0")
     .option("--session <id>", "Previous session id, to detect resets")
     .option("--limit <count>", "Maximum events, 1–500", "100")
@@ -52,9 +98,46 @@ program
         params.set("level", options.level);
     print(await queryRuntime(`/events?${params}`));
 });
-program.command("stop").action(async () => print(await queryRuntime("/stop", process.cwd(), "POST")));
+for (const errors of [false, true]) {
+    const command = program
+        .command(errors ? "errors" : "logs")
+        .description(errors ? "Show recent errors from the live timeline" : "Show recent events from the live timeline")
+        .option("-n, --count <count>", "Number of matching events, 1–500", errors ? "10" : "50")
+        .option("--json", "Include event cursor and evidence-gap metadata as JSON");
+    if (errors)
+        command.option("-c, --context", "Include up to five preceding events per error");
+    else
+        command.option("--type <source>", "Filter by server, browser, runtime, or all", "all");
+    command.action(async (options) => {
+        const source = options.type && options.type !== "all" ? options.type : undefined;
+        if (source && !["server", "browser", "runtime"].includes(source))
+            throw new Error("Invalid event source");
+        const count = positiveInteger(options.count);
+        if (count > 500)
+            throw new Error("count must be 1–500");
+        const view = selectEventView(await readRecentEvents(queryRuntime), {
+            count,
+            source,
+            errors,
+            context: options.context
+        });
+        if (options.json)
+            return print(view);
+        if (view.dropped)
+            console.log(`[runtime] ${view.dropped} earlier events are no longer retained`);
+        for (const event of view.events)
+            console.log(`${event.timestamp} [${event.source}/${event.level}] ${event.message}`);
+        if (!view.events.length)
+            console.log("No matching events in the retained timeline.");
+    });
+}
+program
+    .command("stop")
+    .description("Stop this project's app and browser")
+    .action(async () => print(await queryRuntime("/stop", process.cwd(), "POST")));
 program
     .command("browser")
+    .description("Drive the runtime's monitored browser with agent-browser")
     .allowUnknownOption()
     .argument("[args...]")
     .action(async (args) => {
@@ -67,22 +150,29 @@ program
     await new Promise((resolveRun, reject) => {
         const child = spawn(getAgentBrowserBinaryPath(), ["--session", `d3k-${session.sessionId}`, "--cdp", port, ...args], { stdio: "inherit" });
         child.on("error", reject);
-        child.on("exit", (code) => {
-            if (code !== 0)
-                reject(new Error(`agent-browser exited ${code}`));
-            else
-                resolveRun();
-        });
+        child.on("exit", (code) => (code !== 0 ? reject(new Error(`agent-browser exited ${code}`)) : resolveRun()));
     });
 });
-const portless = program.command("portless");
-portless.command("status").action(() => print(getPortlessProxyStatus()));
+const portless = program.command("portless").description("Prepare canonical local HTTPS");
+portless
+    .command("status")
+    .option("--json", "Output JSON (also the default)")
+    .action(() => print(getPortlessProxyStatus()));
 portless.command("setup").action(async () => {
     const result = await installPortlessService();
     print(result);
     if (!result.success)
         process.exitCode = 1;
 });
+program
+    .command("upgrade")
+    .description("Explicitly upgrade the global package with Bun")
+    .action(() => {
+    const result = spawnSync("bun", ["add", "--global", "dev3000@latest"], { stdio: "inherit", shell: false });
+    if (result.error)
+        throw result.error;
+    process.exitCode = result.status ?? 1;
+});
 program.parseAsync().catch((error) => {
     console.error(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }));
     process.exitCode = 1;

package/dist/runtime/cli.js.map

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

package/dist/runtime/event-views.d.ts

@@ -0,0 +1,21 @@
+import type { TimelineEvent } from "./timeline.js";
+export interface EventPage {
+    sessionId: string;
+    events: TimelineEvent[];
+    cursor: number;
+    latest: number;
+    oldest: number;
+    reset: boolean;
+    dropped: number;
+    hasMore: boolean;
+}
+/** Select recent events while preserving chronological context and evidence-gap metadata. */
+export declare function selectEventView(page: EventPage, options: {
+    count: number;
+    source?: string;
+    errors?: boolean;
+    context?: boolean;
+}): EventPage;
+/** Read at most the retained buffer, fenced at the status cursor so active traffic cannot cause endless paging. */
+export declare function readRecentEvents(query: (path: string) => Promise<unknown>): Promise<EventPage>;
+//# sourceMappingURL=event-views.d.ts.map

package/dist/runtime/event-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-views.d.ts","sourceRoot":"","sources":["../../src/runtime/event-views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/E,SAAS,CAgBX;AAED,mHAAmH;AACnH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA+BpG"}

package/dist/runtime/event-views.js

@@ -0,0 +1,53 @@
+/** Select recent events while preserving chronological context and evidence-gap metadata. */
+export function selectEventView(page, options) {
+    if (!Number.isSafeInteger(options.count) || options.count < 1 || options.count > 500)
+        throw new Error("count must be 1–500");
+    const matches = page.events
+        .filter((event) => (!options.source || event.source === options.source) && (!options.errors || event.level === "error"))
+        .slice(-options.count);
+    const selected = new Set(matches.map((event) => event.seq));
+    if (options.context) {
+        for (const match of matches) {
+            const index = page.events.findIndex((event) => event.seq === match.seq);
+            for (const event of page.events.slice(Math.max(0, index - 5), index))
+                selected.add(event.seq);
+        }
+    }
+    return { ...page, events: page.events.filter((event) => selected.has(event.seq)) };
+}
+/** Read at most the retained buffer, fenced at the status cursor so active traffic cannot cause endless paging. */
+export async function readRecentEvents(query) {
+    const status = (await query("/status"));
+    let cursor = Math.max(0, status.cursor - 5000);
+    let combined;
+    for (let index = 0; index < 10; index++) {
+        const page = (await query(`/events?after=${cursor}&limit=500&sessionId=${encodeURIComponent(status.sessionId)}`));
+        if (page.reset)
+            throw new Error("Runtime restarted while reading events; retry against the new session");
+        const events = page.events.filter((event) => event.seq <= status.cursor);
+        combined = combined
+            ? {
+                ...combined,
+                events: [...combined.events, ...events],
+                dropped: combined.dropped + page.dropped,
+                cursor: Math.min(page.cursor, status.cursor),
+                hasMore: page.cursor < status.cursor
+            }
+            : {
+                ...page,
+                events,
+                latest: status.cursor,
+                cursor: Math.min(page.cursor, status.cursor),
+                hasMore: page.cursor < status.cursor
+            };
+        if (page.cursor >= status.cursor || !page.hasMore)
+            break;
+        if (page.cursor <= cursor)
+            throw new Error("Event cursor did not advance");
+        cursor = page.cursor;
+    }
+    if (!combined)
+        throw new Error("No event response");
+    return combined;
+}
+//# sourceMappingURL=event-views.js.map

package/dist/runtime/event-views.js.map

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

package/dist/runtime/harness.d.ts

@@ -0,0 +1,16 @@
+export declare const HARNESS_NAMES: readonly ["fx", "codex", "claude"];
+export type Harness = (typeof HARNESS_NAMES)[number];
+export declare function parseHarness(value: string): Harness;
+export declare const bundledSkillPath: string;
+export declare function harnessSkill(): string;
+export declare function harnessInvocation(harness: Harness, skillPath: string, contextDirectory: string): {
+    binary: "claude" | "codex" | "fx";
+    args: string[];
+};
+/** Only fixed binaries and argument arrays; the selection never passes through a shell. */
+export declare function launchLocalHarness(harness: Harness, cwd: string, signal: AbortSignal): Promise<void>;
+export declare function runHarnessProcess(binary: string, args: string[], options: {
+    cwd: string;
+    signal: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/runtime/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/runtime/harness.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,YAAI,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAA;AAC/D,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAInD;AACD,eAAO,MAAM,gBAAgB,QAAuE,CAAA;AACpG,wBAAgB,YAAY,IAAI,MAAM,CAErC;AACD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM;IAGpF,MAAM;IAAW,IAAI;EAC/B;AAED,2FAA2F;AAC3F,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1G;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC5C,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/runtime/harness.js

@@ -0,0 +1,68 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { InvalidArgumentError } from "commander";
+export const HARNESS_NAMES = ["fx", "codex", "claude"];
+export function parseHarness(value) {
+    if (!HARNESS_NAMES.includes(value))
+        throw new InvalidArgumentError(`Choose a harness: ${HARNESS_NAMES.join(", ")}`);
+    return value;
+}
+export const bundledSkillPath = fileURLToPath(new URL("../../skills/d3k/SKILL.md", import.meta.url));
+export function harnessSkill() {
+    return `${readFileSync(bundledSkillPath, "utf8").replace(/Use `node <skill-directory>.*?## Prepare/s, "Use `d3k` as `runtime` below, from the project root. The runtime is already running; reuse it.\n\n## Prepare")}\n\n## Harness startup\n\nThe d3k runtime is already running in this workspace. Read its status and use its monitored browser and timeline; do not start another runtime. Await the user's instructions before modifying code. Use d3k status, d3k browser, and d3k events from the project directory.\n`;
+}
+export function harnessInvocation(harness, skillPath, contextDirectory) {
+    parseHarness(harness);
+    const prompt = `Load the d3k skill by reading ${skillPath}. The d3k runtime is already running in this workspace. Use its existing browser and timeline; do not start another runtime. Await further instruction.`;
+    return { binary: harness, args: harness === "fx" ? ["--add-dir", contextDirectory] : [prompt] };
+}
+/** Only fixed binaries and argument arrays; the selection never passes through a shell. */
+export async function launchLocalHarness(harness, cwd, signal) {
+    if (!process.stdin.isTTY)
+        throw new Error("--harness requires an interactive terminal");
+    const directory = mkdtempSync(join(tmpdir(), "d3k-harness-"));
+    const skillDirectory = join(directory, ".fx", "skills", "d3k");
+    mkdirSync(skillDirectory, { recursive: true });
+    const skillPath = join(skillDirectory, "SKILL.md");
+    writeFileSync(skillPath, harnessSkill(), { mode: 0o600 });
+    const invocation = harnessInvocation(harness, skillPath, directory);
+    try {
+        await runHarnessProcess(invocation.binary, invocation.args, { cwd, signal });
+    }
+    finally {
+        rmSync(directory, { recursive: true, force: true });
+    }
+}
+export async function runHarnessProcess(binary, args, options) {
+    if (options.signal.aborted)
+        return;
+    await new Promise((resolve, reject) => {
+        const child = spawn(binary, args, { cwd: options.cwd, stdio: "inherit", shell: false });
+        let timer;
+        const abort = () => {
+            child.kill("SIGTERM");
+            timer = setTimeout(() => child.kill("SIGKILL"), 1000);
+            timer.unref();
+        };
+        options.signal.addEventListener("abort", abort, { once: true });
+        const cleanup = () => {
+            options.signal.removeEventListener("abort", abort);
+            clearTimeout(timer);
+        };
+        child.on("error", (error) => {
+            cleanup();
+            reject(new Error(`Could not launch ${binary}: ${error.message}. Install and authenticate the harness first.`));
+        });
+        child.on("exit", (code) => {
+            cleanup();
+            if (options.signal.aborted || code === 0)
+                resolve();
+            else
+                reject(new Error(`${binary} exited with code ${code}`));
+        });
+    });
+}
+//# sourceMappingURL=harness.js.map

package/dist/runtime/harness.js.map

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

package/dist/runtime/local-proxy.d.ts

@@ -0,0 +1,12 @@
+import type { ConnectionOptions } from "node:tls";
+/** The browser keeps a stable local origin; only the transport host changes for Vercel routing. */
+export declare function startLocalProxy(options: {
+    appUrl: string;
+    upstreamUrl: string;
+    token: string;
+    ca?: ConnectionOptions["ca"];
+}): Promise<{
+    port: number;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=local-proxy.d.ts.map

package/dist/runtime/local-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-proxy.d.ts","sourceRoot":"","sources":["../../src/runtime/local-proxy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,mGAAmG;AACnG,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;CAC7B;;;GAkHA"}

package/dist/runtime/local-proxy.js

@@ -0,0 +1,114 @@
+import { createServer } from "node:http";
+import { Agent, request as httpsRequest } from "node:https";
+/** The browser keeps a stable local origin; only the transport host changes for Vercel routing. */
+export async function startLocalProxy(options) {
+    const origin = new URL(options.appUrl);
+    const target = new URL(options.upstreamUrl);
+    if (origin.protocol !== "https:" || target.protocol !== "https:")
+        throw new Error("Proxy origins must use HTTPS");
+    const sockets = new Set();
+    const agent = new Agent({ keepAlive: true, ca: options.ca });
+    const validPath = (path) => !!path?.startsWith("/") && !path.startsWith("//");
+    const headers = (input) => ({
+        ...input,
+        host: target.host,
+        "x-forwarded-host": origin.host,
+        "x-forwarded-proto": "https",
+        "x-d3k-proxy-token": options.token
+    });
+    const server = createServer((incoming, response) => {
+        if (incoming.headers.host !== origin.host) {
+            response.writeHead(421).end();
+            return;
+        }
+        if (!validPath(incoming.url)) {
+            response.writeHead(400).end();
+            return;
+        }
+        const upstream = httpsRequest(target, { method: incoming.method, path: incoming.url, headers: headers(incoming.headers), agent }, (result) => {
+            const output = { ...result.headers };
+            if (output.location) {
+                try {
+                    const location = new URL(output.location, new URL(incoming.url || "/", target));
+                    if (location.origin === target.origin)
+                        output.location = `${origin.origin}${location.pathname}${location.search}${location.hash}`;
+                }
+                catch {
+                    // Invalid application redirects must not crash the companion.
+                }
+            }
+            if (output["set-cookie"])
+                output["set-cookie"] = output["set-cookie"].map((cookie) => cookie.replace(/;\s*Domain=([^;]+)/gi, (field, domain) => domain.replace(/^\./, "").toLowerCase() === target.hostname ? "" : field));
+            response.writeHead(result.statusCode || 502, output);
+            result.pipe(response);
+            result.on("error", () => response.destroy());
+        });
+        upstream.on("error", () => response.headersSent ? response.destroy() : response.writeHead(502).end("Sandbox unavailable"));
+        incoming.on("aborted", () => upstream.destroy());
+        response.on("close", () => upstream.destroy());
+        incoming.pipe(upstream);
+    });
+    server.on("connection", (socket) => {
+        sockets.add(socket);
+        socket.on("close", () => sockets.delete(socket));
+    });
+    server.on("upgrade", (incoming, client, head) => {
+        if (incoming.headers.host !== origin.host ||
+            !validPath(incoming.url) ||
+            (incoming.headers.origin && incoming.headers.origin !== origin.origin)) {
+            client.end("HTTP/1.1 403 Forbidden\r\nConnection: close\r\n\r\n");
+            return;
+        }
+        const upstream = httpsRequest(target, {
+            method: incoming.method,
+            path: incoming.url,
+            headers: headers(incoming.headers),
+            agent
+        });
+        upstream.on("upgrade", (response, remote, remoteHead) => {
+            sockets.add(remote);
+            remote.on("close", () => {
+                sockets.delete(remote);
+                client.destroy();
+            });
+            remote.on("error", () => client.destroy());
+            client.on("error", () => remote.destroy());
+            client.on("close", () => remote.destroy());
+            const lines = response.rawHeaders.reduce((output, field, index, raw) => {
+                if (!(index % 2))
+                    output.push(`${field}: ${raw[index + 1]}`);
+                return output;
+            }, []);
+            client.write(`HTTP/1.1 ${response.statusCode} ${response.statusMessage}\r\n${lines.join("\r\n")}\r\n\r\n`);
+            if (remoteHead.length)
+                client.write(remoteHead);
+            if (head.length)
+                remote.write(head);
+            client.pipe(remote).pipe(client);
+        });
+        upstream.on("response", (response) => {
+            response.resume();
+            client.end(`HTTP/1.1 ${response.statusCode || 502} Upstream response\r\nConnection: close\r\n\r\n`);
+        });
+        upstream.on("error", () => client.destroy());
+        client.on("close", () => upstream.destroy());
+        upstream.end();
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", resolve);
+    });
+    const address = server.address();
+    if (!address || typeof address === "string")
+        throw new Error("Local proxy did not bind");
+    return {
+        port: address.port,
+        close: async () => {
+            agent.destroy();
+            for (const socket of sockets)
+                socket.destroy();
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
+    };
+}
+//# sourceMappingURL=local-proxy.js.map

package/dist/runtime/local-proxy.js.map

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

package/dist/runtime/runtime.d.ts

@@ -1,9 +1,23 @@
+import { type Harness } from "./harness.js";
 export interface RuntimeOptions {
     command?: string;
+    harness?: Harness;
     cwd?: string;
     headless?: boolean;
     serversOnly?: boolean;
     startupTimeout?: number;
+    browserNavigationTimeout?: number;
+    browser?: string;
+    profileDir?: string;
+    debug?: boolean;
+    /** Sandbox mode uses the companion’s stable local HTTPS origin; only the companion needs Portless. */
+    sandbox?: {
+        appUrl: string;
+        serverPort: number;
+        bridgePort: number;
+        token: string;
+        proxyToken?: string;
+    };
 }
 /** Own the server, browser, and evidence until the retained process is stopped. */
 export declare function startRuntime(options?: RuntimeOptions): Promise<void>;

package/dist/runtime/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAmCD,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsR9E"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,OAAO,EAAoC,MAAM,cAAc,CAAA;AAmB7E,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sGAAsG;IACtG,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzG;AAmCD,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8U9E"}