parasor 0.1.0

package/server/bootstrap/wire-runtime.js.map

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

package/server/cli/help.d.ts

@@ -0,0 +1,3 @@
+export declare function printHelp(log?: (line: string) => void): void;
+export declare function printHelpAll(log?: (line: string) => void): void;
+//# sourceMappingURL=help.d.ts.map

package/server/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAkCA,wBAAgB,SAAS,CAAC,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAEzE;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,GAAG,IAAI,CAE5E"}

package/server/cli/help.js

@@ -0,0 +1,39 @@
+const HELP = `parasor -- web-based multi-client terminal multiplexer
+
+Usage:
+  parasor [--host <addr>] [--port <n>] [--no-qr] [--qr=<iface>]
+  parasor <command>
+
+Commands:
+  qr         Re-render QR + access URLs for a running server
+  service    Install/manage as a login service (LaunchAgent / systemd user)
+  restart    Restart the running server (graceful, then SIGTERM + respawn)
+  stop       Stop the running server and its PTY host daemon
+  help       Show this message (\`--help-all\` for advanced commands)
+
+Run \`parasor <command> --help\` for command-specific options.
+Docs:  https://github.com/artcodec-hq/parasor#readme`;
+const HELP_ALL = `${HELP}
+
+Advanced commands:
+  notify     Push an agent state into a running server (manual hook bridge)
+  pty-host   Manage the parasor-pty-host daemon
+  open       Open a URL in the host browser (requires PARASOR_SOCKET; PTY-only)
+
+Internal commands (not for direct use):
+  hook       Agent hook bridge -- invoked by Claude Code / Codex hook systems
+  shim-open  PATH shim for macOS \`open\` / Linux \`xdg-open\` -- PTY-only
+
+Environment:
+  PORT                     Listen port (default 7681)
+  HOST                     Bind address (default 0.0.0.0 -- all IPv4)
+  PARASOR_AUTH             token | none (default token; none requires loopback)
+  PARASOR_ALLOWED_ORIGINS  Extra browser origins for WebSocket allowlist
+  PARASOR_CONFIG_DIR       Persistent state dir (default ~/.config/parasor)`;
+export function printHelp(log = console.log) {
+    log(HELP);
+}
+export function printHelpAll(log = console.log) {
+    log(HELP_ALL);
+}
+//# sourceMappingURL=help.js.map

package/server/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG;;;;;;;;;;;;;;qDAcwC,CAAC;AAEtD,MAAM,QAAQ,GAAG,GAAG,IAAI;;;;;;;;;;;;;;;;4EAgBoD,CAAC;AAE7E,MAAM,UAAU,SAAS,CAAC,MAA8B,OAAO,CAAC,GAAG;IACjE,GAAG,CAAC,IAAI,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA8B,OAAO,CAAC,GAAG;IACpE,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChB,CAAC"}

package/server/cli/hook-client.d.ts

@@ -0,0 +1,12 @@
+interface PostHookNotifyArgs {
+    sessionId: string;
+    agent: string;
+    event: string;
+}
+interface PostResult {
+    ok: boolean;
+    error?: string;
+}
+export declare function postHookNotify(args: PostHookNotifyArgs): Promise<PostResult>;
+export {};
+//# sourceMappingURL=hook-client.d.ts.map

package/server/cli/hook-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-client.d.ts","sourceRoot":"","sources":["../../src/cli/hook-client.ts"],"names":[],"mappings":"AAaA,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CAoDrB"}

package/server/cli/hook-client.js

@@ -0,0 +1,81 @@
+/*
+ * Tiny HTTP client used by all CLI subcommands that need to push an
+ * agent-state event to the running parasor server's /hook/notify
+ * endpoint. Centralized here so notify, hook (per-agent bridges), and
+ * any future commands share the same env resolution, timeout, and error
+ * shape.
+ *
+ * Loopback only -- the server's route handler enforces this independently
+ * (see routes/hook.ts), but it's also the only address we ever target
+ * here. Reads PARASOR_PORT from the env (set automatically when the
+ * parasor server spawned the parent PTY).
+ */
+const TIMEOUT_MS = 3000;
+export async function postHookNotify(args) {
+    const port = process.env.PARASOR_PORT;
+    if (!port) {
+        return {
+            ok: false,
+            error: "PARASOR_PORT not set. The parasor server is not running, or you are not inside one of its PTYs.",
+        };
+    }
+    // Defensive validation: a hostile or buggy env value like
+    // "@attacker.com:1234" or "8080#fragment" would otherwise be embedded
+    // into the URL string below and produce a request that escapes the
+    // 127.0.0.1 host (URL parser interprets `@` as userinfo separator,
+    // shifting the host). Refuse anything that isn't a plain decimal port.
+    if (!/^\d{1,5}$/.test(port) || Number(port) === 0 || Number(port) > 65535) {
+        return {
+            ok: false,
+            error: `PARASOR_PORT is not a valid port number: ${port}`,
+        };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const res = await fetch(`http://127.0.0.1:${port}/hook/notify`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                sessionId: args.sessionId,
+                agent: args.agent,
+                event: args.event,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const serverError = await safeReadServerError(res);
+            return {
+                ok: false,
+                error: `server returned ${res.status}${serverError ? `: ${serverError}` : ""}`,
+            };
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            return { ok: false, error: `timed out after ${TIMEOUT_MS}ms` };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: `network error: ${message}` };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function safeReadServerError(res) {
+    try {
+        const body = await res.json();
+        if (typeof body === "object" &&
+            body !== null &&
+            "error" in body &&
+            typeof body.error === "string") {
+            return body.error;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=hook-client.js.map

package/server/cli/hook-client.js.map

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

package/server/cli/hook.d.ts

@@ -0,0 +1,3 @@
+export declare function cliHook(args: string[]): Promise<void>;
+export declare function parseClaudeEvent(raw: string): string | null;
+//# sourceMappingURL=hook.d.ts.map

package/server/cli/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/cli/hook.ts"],"names":[],"mappings":"AAqCA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD3D;AA4DD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsB3D"}

package/server/cli/hook.js

@@ -0,0 +1,152 @@
+import { postHookNotify } from "./hook-client.js";
+const HOOKABLE_AGENTS = new Set([
+    "claude",
+    "codex",
+]);
+function isHookableAgent(value) {
+    return HOOKABLE_AGENTS.has(value);
+}
+// Hook stdin must arrive promptly; bail if it doesn't so we don't hang
+// the agent's own hook timeout (Claude Code's default is ~10s).
+const STDIN_TIMEOUT_MS = 1500;
+// Defensive cap on hook stdin size. Real hook payloads are a few KB at
+// most (an event name plus a small object). A buggy or hostile agent
+// could pipe an unbounded stream which would otherwise pin our heap.
+const STDIN_MAX_BYTES = 1_000_000;
+export async function cliHook(args) {
+    const agent = args[0];
+    if (!agent || !isHookableAgent(agent)) {
+        console.error(`Usage: parasor hook <claude|codex>\nReads the agent's hook payload from stdin (or argv for agents that pass it as an argument), translates the event, and posts it to the parasor server.`);
+        process.exit(1);
+    }
+    const sessionId = process.env.PARASOR_SESSION_ID;
+    if (!sessionId) {
+        // Hook scripts run inside the PTY where the parasor server set
+        // PARASOR_SESSION_ID. If we somehow got here without it, exit 0
+        // (not an error) so the agent doesn't get a non-zero hook return
+        // code that might surface in its UI.
+        process.exit(0);
+    }
+    // Some agents (Codex) pass the hook payload as the second argv. Most
+    // (Claude) pipe it on stdin. Try both, in that order.
+    let payload = args.slice(1).join(" ");
+    if (!payload)
+        payload = await readStdin();
+    if (!payload) {
+        // No payload, nothing to do -- exit 0 so we don't break the agent.
+        process.exit(0);
+    }
+    let event = null;
+    try {
+        if (agent === "claude") {
+            event = parseClaudeEvent(payload);
+        }
+        else if (agent === "codex") {
+            event = parseCodexEvent(payload);
+        }
+    }
+    catch {
+        // Parse failure should not break the agent's flow -- exit 0 silently.
+        process.exit(0);
+    }
+    if (process.env.PARASOR_HOOK_DEBUG === "1") {
+        console.error(`parasor hook ${agent}: parsed event=${event ?? "<null>"}`);
+    }
+    if (!event)
+        process.exit(0);
+    const result = await postHookNotify({ sessionId, agent, event });
+    if (!result.ok) {
+        // Don't print to stdout -- Claude Code displays hook stderr to the
+        // user. Use stderr for visibility but exit 0 so the agent isn't
+        // disrupted by network blips. Hook bridge failures are a UX
+        // degradation, not an agent error.
+        if (process.env.PARASOR_HOOK_DEBUG === "1") {
+            console.error(`parasor hook ${agent}: ${result.error}`);
+        }
+        process.exit(0);
+    }
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY) {
+            resolve("");
+            return;
+        }
+        let data = "";
+        let truncated = false;
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => {
+            if (truncated)
+                return;
+            data += chunk;
+            if (data.length >= STDIN_MAX_BYTES) {
+                truncated = true;
+                // Truncate so downstream parsers don't see partial trailing data
+                // mixed with real fields. We resolve with empty so the caller
+                // treats it as "no payload" and exits silently.
+                resolve("");
+            }
+        });
+        process.stdin.on("end", () => {
+            if (!truncated)
+                resolve(data);
+        });
+        process.stdin.on("error", () => resolve(""));
+        setTimeout(() => resolve(data), STDIN_TIMEOUT_MS);
+    });
+}
+/*
+ * Translate a Claude Code hook payload into the event name we forward to the
+ * server. Returns the bare `hook_event_name` for most events, but composes
+ * `<event>:<discriminator>` for two payload-dependent cases so the server's
+ * event-map can dispatch them to different states:
+ *
+ *   PreToolUse     -> `PreToolUse:<tool_name>` so user-input-required tools
+ *                    (AskUserQuestion, ExitPlanMode) map to `waiting`
+ *                    while every other tool stays at the default `running`.
+ *
+ *   Notification   -> `Notification:<notification_type>` so `auth_success`
+ *                    becomes a noop instead of flashing waiting, while real
+ *                    input-required types (`permission_prompt`,
+ *                    `idle_prompt`, `elicitation_dialog`) still resolve to
+ *                    waiting through their dedicated mappings.
+ *
+ * Newer Claude Code builds also emit explicit `PermissionRequest`,
+ * `PermissionDenied`, `Elicitation`, and `ElicitationResult` events.
+ * Those don't need extra discrimination here; we forward the bare
+ * `hook_event_name` and let the server-side event map decide.
+ *
+ * The server's `mapEventType` lower-cases the event before dictionary
+ * lookup, so the casing here doesn't matter.
+ */
+export function parseClaudeEvent(raw) {
+    const parsed = JSON.parse(raw);
+    const event = parsed.hook_event_name;
+    if (typeof event !== "string" || !event)
+        return null;
+    if (event === "PreToolUse" &&
+        typeof parsed.tool_name === "string" &&
+        parsed.tool_name) {
+        return `${event}:${parsed.tool_name}`;
+    }
+    if (event === "Notification" &&
+        typeof parsed.notification_type === "string" &&
+        parsed.notification_type) {
+        return `${event}:${parsed.notification_type}`;
+    }
+    return event;
+}
+function parseCodexEvent(raw) {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.hook_event_name === "string" && parsed.hook_event_name) {
+        return parsed.hook_event_name;
+    }
+    // Codex CLI has shipped a couple of variants over time -- `type` is the
+    // current one, `event` was used in an older draft schema.
+    if (typeof parsed.type === "string" && parsed.type)
+        return parsed.type;
+    if (typeof parsed.event === "string" && parsed.event)
+        return parsed.event;
+    return null;
+}
+//# sourceMappingURL=hook.js.map

package/server/cli/hook.js.map

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

package/server/cli/main.d.ts

@@ -0,0 +1,2 @@
+export declare function runCli(args: string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/server/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwH1D"}

package/server/cli/main.js

@@ -0,0 +1,133 @@
+// Single-source CLI dispatcher.
+// bin/parasor.ts (dev) and dist/bin/parasor.mjs (publish) both delegate here
+// so subcommand surface cannot drift between dev and published binaries.
+export async function runCli(args) {
+    const command = args[0];
+    switch (command) {
+        case "help":
+        case "--help":
+        case "-h": {
+            const { printHelp } = await import("./help.js");
+            printHelp();
+            return;
+        }
+        case "--help-all":
+        case "help-all": {
+            const { printHelpAll } = await import("./help.js");
+            printHelpAll();
+            return;
+        }
+        case "open": {
+            const url = args[1];
+            if (!url) {
+                console.error("Usage: parasor open <url>");
+                process.exit(1);
+            }
+            const { cliOpen } = await import("./open.js");
+            await cliOpen(url);
+            return;
+        }
+        case "shim-open": {
+            const { shimOpen } = await import("./shim-open.js");
+            await shimOpen(args.slice(1));
+            return;
+        }
+        case "notify": {
+            const { cliNotify } = await import("./notify.js");
+            await cliNotify(args.slice(1));
+            return;
+        }
+        case "hook": {
+            const { cliHook } = await import("./hook.js");
+            await cliHook(args.slice(1));
+            return;
+        }
+        case "qr": {
+            const { cliQr } = await import("./qr.js");
+            await cliQr(args.slice(1));
+            return;
+        }
+        case "service": {
+            const { cliService } = await import("./service.js");
+            try {
+                await cliService(args.slice(1));
+            }
+            catch (err) {
+                console.error(err.message);
+                process.exit(1);
+            }
+            return;
+        }
+        case "restart": {
+            const { cliRestart } = await import("./restart.js");
+            try {
+                await cliRestart(undefined, args.slice(1));
+            }
+            catch (err) {
+                console.error(err.message);
+                process.exit(1);
+            }
+            return;
+        }
+        case "stop": {
+            const { cliStop } = await import("./stop.js");
+            try {
+                await cliStop(undefined, args.slice(1));
+            }
+            catch (err) {
+                console.error(err.message);
+                process.exit(1);
+            }
+            return;
+        }
+        case "pty-host": {
+            const { cliPtyHost } = await import("./pty-host.js");
+            const rc = await cliPtyHost(args.slice(1));
+            process.exit(rc);
+            return;
+        }
+        default: {
+            const { classifyTopLevelCommand } = await import("./unknown-command.js");
+            const classified = classifyTopLevelCommand(command);
+            if (classified.kind === "error") {
+                console.error(classified.message);
+                process.exit(1);
+            }
+            for (let i = 0; i < args.length; i++) {
+                const arg = args[i];
+                if (arg === undefined)
+                    continue;
+                if (arg === "--no-qr") {
+                    process.env.PARASOR_QR = "0";
+                }
+                else if (arg.startsWith("--qr=")) {
+                    process.env.PARASOR_QR_IFACE = arg.slice(5);
+                }
+                else if (arg === "--host") {
+                    const value = args[++i];
+                    if (!value) {
+                        console.error("--host requires a value");
+                        process.exit(1);
+                    }
+                    process.env.HOST = value;
+                }
+                else if (arg.startsWith("--host=")) {
+                    process.env.HOST = arg.slice(7);
+                }
+                else if (arg === "--port") {
+                    const value = args[++i];
+                    if (!value) {
+                        console.error("--port requires a value");
+                        process.exit(1);
+                    }
+                    process.env.PORT = value;
+                }
+                else if (arg.startsWith("--port=")) {
+                    process.env.PORT = arg.slice(7);
+                }
+            }
+            await import("../index.js");
+        }
+    }
+}
+//# sourceMappingURL=main.js.map

package/server/cli/main.js.map

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

package/server/cli/notify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Push an agent state into the running parasor server via the loopback
+ * HTTP hook endpoint. Invoked manually from shell scripts or arbitrary
+ * agent wrappers that don't have a typed `parasor hook` integration:
+ *
+ *   parasor notify running
+ *   parasor notify waiting --session abc-123
+ *
+ * Session resolution: --session flag first, then PARASOR_SESSION_ID env.
+ * Both are set automatically when the PTY was spawned by the parasor
+ * server (alongside PARASOR_PORT, which is what the HTTP client targets).
+ *
+ * Hook agents (Claude Code, Codex, ...) should NOT call this directly --
+ * they have their own typed bridge `parasor hook <agent>` that parses the
+ * native hook input on stdin and forwards a structured event to the same
+ * /hook/notify endpoint.
+ */
+export declare function cliNotify(args: string[]): Promise<void>;
+//# sourceMappingURL=notify.d.ts.map

package/server/cli/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/cli/notify.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD7D"}

package/server/cli/notify.js

@@ -0,0 +1,77 @@
+import { postHookNotify } from "./hook-client.js";
+const VALID_STATES = new Set(["running", "waiting", "completed", "idle"]);
+/**
+ * Push an agent state into the running parasor server via the loopback
+ * HTTP hook endpoint. Invoked manually from shell scripts or arbitrary
+ * agent wrappers that don't have a typed `parasor hook` integration:
+ *
+ *   parasor notify running
+ *   parasor notify waiting --session abc-123
+ *
+ * Session resolution: --session flag first, then PARASOR_SESSION_ID env.
+ * Both are set automatically when the PTY was spawned by the parasor
+ * server (alongside PARASOR_PORT, which is what the HTTP client targets).
+ *
+ * Hook agents (Claude Code, Codex, ...) should NOT call this directly --
+ * they have their own typed bridge `parasor hook <agent>` that parses the
+ * native hook input on stdin and forwards a structured event to the same
+ * /hook/notify endpoint.
+ */
+export async function cliNotify(args) {
+    let state;
+    let sessionId;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--session" && i + 1 < args.length) {
+            sessionId = args[++i];
+            continue;
+        }
+        if (a.startsWith("--session=")) {
+            sessionId = a.slice("--session=".length);
+            continue;
+        }
+        if (a === "-h" || a === "--help") {
+            printHelp();
+            process.exit(0);
+        }
+        if (state === undefined) {
+            state = a;
+        }
+    }
+    if (state === undefined) {
+        printHelp();
+        process.exit(1);
+    }
+    if (!VALID_STATES.has(state)) {
+        console.error(`parasor notify: unknown state "${state}". Expected one of: ${[...VALID_STATES].join(", ")}.`);
+        process.exit(1);
+    }
+    const resolvedSessionId = sessionId ?? process.env.PARASOR_SESSION_ID;
+    if (!resolvedSessionId) {
+        console.error("parasor notify: no session id available. Pass --session <id> or run inside a parasor PTY where PARASOR_SESSION_ID is set.");
+        process.exit(1);
+    }
+    const result = await postHookNotify({
+        sessionId: resolvedSessionId,
+        agent: "manual",
+        event: state,
+    });
+    if (!result.ok) {
+        console.error(`parasor notify: ${result.error}`);
+        process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`Usage: parasor notify <running|waiting|completed|idle> [--session <id>]
+
+Push an agent state into the running parasor server over the loopback
+HTTP hook endpoint. The session id is read from --session, then
+PARASOR_SESSION_ID. Requires PARASOR_PORT to point at the running
+server (set automatically inside parasor PTYs).
+
+Examples:
+  parasor notify running
+  parasor notify waiting --session abc-123
+  parasor notify completed`);
+}
+//# sourceMappingURL=notify.js.map

package/server/cli/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../src/cli/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,IAAI,KAAyB,CAAC;IAC9B,IAAI,SAA6B,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7C,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjC,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CACX,kCAAkC,KAAK,uBAAuB,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,iBAAiB,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACtE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CACX,2HAA2H,CAC5H,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,SAAS,EAAE,iBAAiB;QAC5B,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;2BAUa,CAAC,CAAC;AAC7B,CAAC"}

package/server/cli/open.d.ts

@@ -0,0 +1,2 @@
+export declare function cliOpen(url: string): Promise<void>;
+//# sourceMappingURL=open.d.ts.map

package/server/cli/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/cli/open.ts"],"names":[],"mappings":"AAEA,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBxD"}