linkshell-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LinkShell Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# linkshell-cli
+
+在手机上远程查看和控制本地 Claude Code / Codex 终端会话。
+
+## 安装
+
+```bash
+npm install -g linkshell-cli
+```
+
+## 一条命令开始
+
+```bash
+linkshell start --provider claude
+```
+
+CLI 会自动：
+1. 启动内置 Gateway（端口 8787）
+2. 检测局域网 IP
+3. 创建配对并打印 QR 码
+4. 手机扫码即连
+
+```
+  Built-in gateway started on port 8787
+  LAN address: http://192.168.1.12:8787
+
+  Pairing code: 847293
+  Session: a1b2c3d4-...
+
+  Scan to connect:
+  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+  ...
+```
+
+## 更多用法
+
+```bash
+# 桥接 Claude Code
+linkshell start --provider claude
+
+# 桥接 Codex
+linkshell start --provider codex
+
+# 桥接任意命令
+linkshell start --provider custom --command bash
+
+# 指定端口
+linkshell start --provider claude --port 9000
+
+# 连接远程 Gateway（不启动内置 Gateway）
+linkshell start --gateway wss://your-server.com:8787/ws --provider claude
+
+# 指定 QR 码中的公网地址
+linkshell start --gateway ws://127.0.0.1:8787/ws --pairing-gateway 203.0.113.10 --provider claude
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `linkshell start` | 启动桥接会话（内置或远程 Gateway） |
+| `linkshell setup` | 交互式配置向导 |
+| `linkshell doctor` | 环境检查和连通性诊断 |
+
+## start 选项
+
+```
+--gateway <url>           远程 Gateway 地址（省略则启动内置 Gateway）
+--port <port>             内置 Gateway 端口（默认 8787）
+--pairing-gateway <url>   QR 码中给手机使用的地址
+--provider <name>         claude | codex | custom（默认 claude）
+--command <cmd>           自定义命令（custom provider 必填）
+--session-id <id>         手动指定 session ID
+--client-name <name>      显示名称（默认 local-cli）
+--cols <n>                终端列数（默认 120）
+--rows <n>                终端行数（默认 36）
+--verbose                 详细日志
+```
+
+## 配置持久化
+
+```bash
+linkshell setup
+```
+
+配置保存在 `~/.linkshell/config.json`，后续启动自动读取。
+
+## doctor 检查项
+
+```bash
+linkshell doctor
+```
+
+- Node.js 版本 >= 18
+- node-pty 原生模块
+- Claude / Codex CLI 是否安装
+- 配置文件状态
+- Gateway 连通性和延迟
+
+## 工作原理
+
+```
+你的电脑 (CLI + 内置 Gateway)  ◄──WebSocket──►  手机 (App)
+```
+
+1. CLI 启动内置 Gateway（或连接远程 Gateway）
+2. 通过 PTY 启动目标进程（Claude/Codex/bash）
+3. 终端输出通过 WebSocket 转发给手机 App
+4. App 的输入回传给 CLI，写入 PTY
+
+支持断线自动重连、ACK 确认、scrollback 缓冲（1000 条）、心跳检测（15s）和协议版本协商。
+
+## License
+
+MIT

package/dist/cli/src/commands/doctor.d.ts

@@ -0,0 +1 @@
+export declare function runDoctor(gatewayUrl?: string): Promise<void>;

package/dist/cli/src/commands/doctor.js

@@ -0,0 +1,112 @@
+import { execSync } from "node:child_process";
+import { loadConfig, getConfigPath } from "../config.js";
+function check(name, fn) {
+    try {
+        return { name, ok: true, detail: fn() };
+    }
+    catch (e) {
+        return { name, ok: false, detail: e instanceof Error ? e.message : String(e) };
+    }
+}
+function which(bin) {
+    try {
+        return execSync(`which ${bin}`, { encoding: "utf8", timeout: 5000 }).trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function checkGateway(url) {
+    try {
+        const httpUrl = url.replace(/\/ws\/?$/, "").replace(/^wss:/, "https:").replace(/^ws:/, "http:");
+        const start = Date.now();
+        const res = await fetch(`${httpUrl}/healthz`, { signal: AbortSignal.timeout(5000) });
+        const latency = Date.now() - start;
+        if (!res.ok)
+            return { name: "Gateway", ok: false, detail: `HTTP ${res.status}` };
+        return { name: "Gateway", ok: true, detail: `reachable (${latency}ms)` };
+    }
+    catch (e) {
+        return { name: "Gateway", ok: false, detail: e instanceof Error ? e.message : "unreachable" };
+    }
+}
+export async function runDoctor(gatewayUrl) {
+    const config = loadConfig();
+    const gateway = gatewayUrl ?? config.gateway;
+    process.stdout.write("\n  LinkShell Doctor\n\n");
+    const results = [];
+    // Node.js version
+    results.push(check("Node.js", () => {
+        const ver = process.versions.node;
+        const major = Number(ver.split(".")[0]);
+        if (major < 18)
+            throw new Error(`v${ver} (need >= 18)`);
+        return `v${ver}`;
+    }));
+    // node-pty
+    results.push(check("node-pty", () => {
+        try {
+            require("node-pty");
+            return "loaded";
+        }
+        catch {
+            // Try dynamic import path for ESM
+            try {
+                execSync("node -e \"require('node-pty')\"", { timeout: 5000, stdio: "pipe" });
+                return "loaded";
+            }
+            catch {
+                throw new Error("native module not built — run: pnpm approve-builds && pnpm install --force");
+            }
+        }
+    }));
+    // Claude CLI
+    const claudePath = which("claude");
+    if (claudePath) {
+        results.push(check("Claude CLI", () => {
+            const ver = execSync("claude --version 2>&1", { encoding: "utf8", timeout: 5000 }).trim();
+            return `${ver} (${claudePath})`;
+        }));
+    }
+    else {
+        results.push({ name: "Claude CLI", ok: false, detail: "not found — npm i -g @anthropic-ai/claude-code" });
+    }
+    // Codex CLI
+    const codexPath = which("codex");
+    if (codexPath) {
+        results.push(check("Codex CLI", () => `found (${codexPath})`));
+    }
+    else {
+        results.push({ name: "Codex CLI", ok: false, detail: "not found — npm i -g @openai/codex" });
+    }
+    // Config
+    results.push(check("Config", () => {
+        const path = getConfigPath();
+        const cfg = loadConfig();
+        const keys = Object.keys(cfg).filter((k) => cfg[k] !== undefined);
+        if (keys.length === 0)
+            return `${path} (empty — run: linkshell setup)`;
+        return `${path} (${keys.join(", ")})`;
+    }));
+    // Gateway
+    if (gateway) {
+        results.push(await checkGateway(gateway));
+    }
+    else {
+        results.push({ name: "Gateway", ok: false, detail: "no gateway configured — run: linkshell setup" });
+    }
+    // Print results
+    for (const r of results) {
+        const icon = r.ok ? "\x1b[32m✓\x1b[0m" : "\x1b[31m✗\x1b[0m";
+        process.stdout.write(`  ${icon} ${r.name}: ${r.detail}\n`);
+    }
+    const failed = results.filter((r) => !r.ok);
+    process.stdout.write("\n");
+    if (failed.length === 0) {
+        process.stdout.write("  \x1b[32mAll checks passed.\x1b[0m\n\n");
+    }
+    else {
+        process.stdout.write(`  \x1b[33m${failed.length} issue(s) found.\x1b[0m\n\n`);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/src/commands/doctor.js.map

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

package/dist/cli/src/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;

package/dist/cli/src/commands/setup.js

@@ -0,0 +1,48 @@
+import * as readline from "node:readline";
+import { loadConfig, saveConfig, getConfigPath } from "../config.js";
+function ask(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` (${defaultValue})` : "";
+    return new Promise((resolve) => {
+        rl.question(`  ${question}${suffix}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || "");
+        });
+    });
+}
+function choose(rl, question, options, defaultIdx = 0) {
+    return new Promise((resolve) => {
+        process.stdout.write(`  ${question}\n`);
+        for (let i = 0; i < options.length; i++) {
+            const marker = i === defaultIdx ? "\x1b[36m>\x1b[0m" : " ";
+            process.stdout.write(`  ${marker} ${i + 1}. ${options[i]}\n`);
+        }
+        rl.question(`  Choice (${defaultIdx + 1}): `, (answer) => {
+            const idx = Number(answer.trim()) - 1;
+            resolve(options[idx >= 0 && idx < options.length ? idx : defaultIdx]);
+        });
+    });
+}
+export async function runSetup() {
+    const existing = loadConfig();
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    process.stdout.write("\n  LinkShell Setup\n\n");
+    const gateway = await ask(rl, "Gateway URL", existing.gateway ?? "wss://localhost:8787/ws");
+    const provider = await choose(rl, "Default provider:", ["claude", "codex", "custom"], ["claude", "codex", "custom"].indexOf(existing.provider ?? "claude"));
+    let command;
+    if (provider === "custom") {
+        command = await ask(rl, "Custom command", existing.command ?? "bash");
+    }
+    const clientName = await ask(rl, "Client name", existing.clientName ?? require("os").hostname());
+    rl.close();
+    const config = {
+        gateway,
+        provider,
+        command,
+        clientName,
+    };
+    saveConfig(config);
+    process.stdout.write(`\n  \x1b[32mConfig saved to ${getConfigPath()}\x1b[0m\n\n`);
+    process.stdout.write("  Next steps:\n");
+    process.stdout.write("    linkshell doctor    — verify your setup\n");
+    process.stdout.write("    linkshell start     — start a bridge session\n\n");
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/src/commands/setup.js.map

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

package/dist/cli/src/config.d.ts

@@ -0,0 +1,12 @@
+export interface LinkShellConfig {
+    gateway?: string;
+    pairingGateway?: string;
+    provider?: "claude" | "codex" | "custom";
+    command?: string;
+    clientName?: string;
+    cols?: number;
+    rows?: number;
+}
+export declare function loadConfig(): LinkShellConfig;
+export declare function saveConfig(config: LinkShellConfig): void;
+export declare function getConfigPath(): string;

package/dist/cli/src/config.js

@@ -0,0 +1,23 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".linkshell");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+export function loadConfig() {
+    try {
+        if (!existsSync(CONFIG_FILE))
+            return {};
+        return JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAYlC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAoB,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/src/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { BridgeSession } from "./runtime/bridge-session.js";
+import { resolveProviderConfig } from "./providers.js";
+import { loadConfig } from "./config.js";
+import { runDoctor } from "./commands/doctor.js";
+import { runSetup } from "./commands/setup.js";
+import { getLanIp } from "./utils/lan-ip.js";
+const config = loadConfig();
+const program = new Command();
+program
+    .name("linkshell")
+    .description("Bridge a local Claude/Codex terminal session to a remote gateway")
+    .version("0.1.0");
+program
+    .command("start")
+    .description("Start a bridge session")
+    .option("--gateway <url>", "Gateway websocket URL (omit to start built-in gateway)", config.gateway)
+    .option("--pairing-gateway <url-or-host>", "Public HTTP gateway used in QR/deep link output", config.pairingGateway)
+    .option("--port <port>", "Port for built-in gateway (default: 8787)", "8787")
+    .option("--session-id <id>", "Session identifier (auto-created if omitted)")
+    .option("--provider <provider>", "claude | codex | custom", config.provider ?? "claude")
+    .option("--command <command>", "Override provider executable", config.command)
+    .option("--client-name <name>", "Display name for this CLI", config.clientName ?? "local-cli")
+    .option("--cols <cols>", "Initial terminal columns", String(config.cols ?? 120))
+    .option("--rows <rows>", "Initial terminal rows", String(config.rows ?? 36))
+    .option("--verbose", "Enable verbose logging")
+    .allowUnknownOption(true)
+    .action(async (options, command) => {
+    const passthroughArgs = command.args.filter((value) => value !== "--");
+    const providerConfig = resolveProviderConfig({
+        provider: options.provider,
+        command: options.command,
+        args: passthroughArgs,
+    });
+    let gatewayUrl = options.gateway;
+    let gatewayHttpUrl;
+    let pairingGateway = options.pairingGateway;
+    let embeddedGatewayHandle;
+    if (!gatewayUrl) {
+        // Start built-in gateway
+        const { startEmbeddedGateway } = await import("@linkshell/gateway/embedded");
+        const port = Number(options.port);
+        const gw = await startEmbeddedGateway({
+            port,
+            logLevel: options.verbose ? "debug" : "warn",
+            silent: false,
+        });
+        embeddedGatewayHandle = gw;
+        gatewayUrl = gw.wsUrl;
+        gatewayHttpUrl = gw.httpUrl;
+        // Auto-detect LAN IP for QR code
+        const lanIp = getLanIp();
+        if (!pairingGateway && lanIp !== "127.0.0.1") {
+            pairingGateway = `http://${lanIp}:${gw.port}`;
+        }
+        process.stderr.write(`\n  Built-in gateway started on port ${gw.port}\n`);
+        if (pairingGateway) {
+            process.stderr.write(`  LAN address: ${pairingGateway}\n`);
+        }
+        process.stderr.write("\n");
+    }
+    else {
+        gatewayHttpUrl = gatewayUrl
+            .replace(/\/ws\/?$/, "")
+            .replace(/^wss:/, "https:")
+            .replace(/^ws:/, "http:");
+    }
+    const session = new BridgeSession({
+        gatewayUrl,
+        gatewayHttpUrl,
+        pairingGateway,
+        sessionId: options.sessionId,
+        cols: Number(options.cols),
+        rows: Number(options.rows),
+        clientName: options.clientName,
+        verbose: Boolean(options.verbose),
+        providerConfig,
+    });
+    // Clean up embedded gateway on exit
+    if (embeddedGatewayHandle) {
+        const cleanup = async () => {
+            await embeddedGatewayHandle.close();
+        };
+        process.on("SIGINT", () => { cleanup().then(() => process.exit(0)); });
+        process.on("SIGTERM", () => { cleanup().then(() => process.exit(0)); });
+    }
+    await session.start();
+});
+program
+    .command("doctor")
+    .description("Check your environment and connectivity")
+    .option("--gateway <url>", "Gateway URL to test", config.gateway)
+    .action(async (options) => {
+    await runDoctor(options.gateway);
+});
+program
+    .command("setup")
+    .description("Interactive setup wizard")
+    .action(async () => {
+    await runSetup();
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/src/index.js.map

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

package/dist/cli/src/providers.d.ts

@@ -0,0 +1,12 @@
+export type ProviderName = "claude" | "codex" | "custom";
+export interface ProviderConfig {
+    provider: ProviderName;
+    command: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+}
+export declare function resolveProviderConfig(input: {
+    provider: ProviderName;
+    command?: string;
+    args: string[];
+}): ProviderConfig;

package/dist/cli/src/providers.js

@@ -0,0 +1,61 @@
+import { execSync } from "node:child_process";
+function which(bin) {
+    try {
+        return execSync(`which ${bin}`, { encoding: "utf8" }).trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveClaudeProvider(input) {
+    const command = input.command ?? "claude";
+    const resolved = which(command);
+    if (!resolved) {
+        throw new Error(`Claude CLI not found ("${command}"). Install it with: npm install -g @anthropic-ai/claude-code`);
+    }
+    // Claude starts an interactive REPL by default — that's exactly what we want in the PTY.
+    // Pass through any extra args the user provided.
+    return {
+        provider: "claude",
+        command: resolved,
+        args: input.args,
+        env: { ...process.env },
+    };
+}
+function resolveCodexProvider(input) {
+    const command = input.command ?? "codex";
+    const resolved = which(command);
+    if (!resolved) {
+        throw new Error(`Codex CLI not found ("${command}"). Install it with: npm install -g @openai/codex`);
+    }
+    if (!process.env.OPENAI_API_KEY) {
+        process.stderr.write("[warn] OPENAI_API_KEY not set — Codex may fail to authenticate\n");
+    }
+    return {
+        provider: "codex",
+        command: resolved,
+        args: input.args,
+        env: { ...process.env },
+    };
+}
+export function resolveProviderConfig(input) {
+    switch (input.provider) {
+        case "claude":
+            return resolveClaudeProvider(input);
+        case "codex":
+            return resolveCodexProvider(input);
+        case "custom": {
+            if (!input.command) {
+                throw new Error("custom provider requires --command");
+            }
+            const resolved = which(input.command);
+            return {
+                provider: "custom",
+                command: resolved ?? input.command,
+                args: input.args,
+                env: { ...process.env },
+            };
+        }
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/cli/src/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAW9C,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,SAAS,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAG9B;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,0BAA0B,OAAO,+DAA+D,CACjG,CAAC;IACJ,CAAC;IAED,yFAAyF;IACzF,iDAAiD;IACjD,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAG7B;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,mDAAmD,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kEAAkE,CACnE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAIrC;IACC,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACrC,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO;gBACL,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC,OAAO;gBAClC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/src/runtime/bridge-session.d.ts

@@ -0,0 +1,40 @@
+import type { ProviderConfig } from "../providers.js";
+export interface BridgeSessionOptions {
+    gatewayUrl: string;
+    gatewayHttpUrl: string;
+    pairingGateway?: string;
+    sessionId?: string;
+    cols: number;
+    rows: number;
+    clientName: string;
+    verbose?: boolean;
+    providerConfig: ProviderConfig;
+}
+export declare class BridgeSession {
+    private readonly options;
+    private socket;
+    private terminal;
+    private outputSeq;
+    private lastAckedSeq;
+    private scrollback;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private reconnecting;
+    private sessionId;
+    private exited;
+    private stopped;
+    constructor(options: BridgeSessionOptions);
+    private log;
+    start(): Promise<void>;
+    private createPairing;
+    private connectGateway;
+    private handleMessage;
+    private replayFrom;
+    private spawnTerminal;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    stop(exitCode?: number): void;
+}