@linkshell/host 0.1.0

package/dist/host/src/fs.js

@@ -0,0 +1,198 @@
+import { existsSync } from "node:fs";
+import { mkdir, open, readdir, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { RpcError } from "@linkshell/wire";
+// Browsing and searching the host's directories, to pick where a session runs.
+const PROJECT_MARKERS = [".git", "package.json", "Cargo.toml", "go.mod", "pyproject.toml", "Package.swift", "pom.xml", "build.gradle", "Gemfile", "composer.json", "deno.json", "CMakeLists.txt"];
+/** Directories never worth descending into when searching. */
+const SKIP = new Set([
+    "node_modules", ".git", "Library", "Pods", "DerivedData", "build", "dist", ".next", ".expo", "target", "vendor",
+    ".Trash", "Applications", "Movies", "Music", "Pictures", ".cache", ".npm", ".pnpm-store", "venv", ".venv", "__pycache__",
+]);
+function isProject(names) {
+    return PROJECT_MARKERS.some((marker) => names.has(marker));
+}
+function expand(path) {
+    if (!path || path === "~")
+        return homedir();
+    if (path.startsWith("~/"))
+        return join(homedir(), path.slice(2));
+    return resolve(path);
+}
+async function subdirectories(path, hidden) {
+    const dirents = await readdir(path, { withFileTypes: true });
+    const names = new Set(dirents.map((d) => d.name));
+    const dirs = dirents.filter((d) => (d.isDirectory() || d.isSymbolicLink()) && (hidden || !d.name.startsWith(".")));
+    const entries = await Promise.all(dirs.map(async (d) => {
+        const full = join(path, d.name);
+        try {
+            if (d.isSymbolicLink() && !(await stat(full)).isDirectory())
+                return undefined;
+            const children = new Set(await readdir(full).catch(() => []));
+            return { name: d.name, path: full, project: isProject(children) || undefined };
+        }
+        catch {
+            return undefined;
+        }
+    }));
+    return {
+        entries: entries
+            .filter((e) => Boolean(e))
+            .sort((a, b) => Number(Boolean(b.project)) - Number(Boolean(a.project)) || a.name.localeCompare(b.name, undefined, { sensitivity: "base" })),
+        names,
+    };
+}
+export async function listDirectory(input) {
+    const path = expand(input.path);
+    if (!existsSync(path) || !(await stat(path)).isDirectory())
+        throw RpcError.app("not_found", `no such directory: ${path}`);
+    const { entries } = await subdirectories(path, input.hidden).catch(() => {
+        throw RpcError.app("not_found", `can't read ${path}`);
+    });
+    const parent = dirname(path);
+    return { path, parent: parent === path ? undefined : parent, home: homedir(), entries };
+}
+/**
+ * Breadth-first under the home directory, a few levels deep, within a time
+ * budget: good enough to find "claude-remote" or "rtranslate" by typing.
+ */
+export async function searchDirectories(input, budgetMs = 1500) {
+    const query = input.query.toLowerCase().trim();
+    const deadline = Date.now() + budgetMs;
+    const found = [];
+    let queue = [{ path: homedir(), depth: 0 }];
+    let truncated = false;
+    while (queue.length > 0) {
+        if (Date.now() > deadline) {
+            truncated = true;
+            break;
+        }
+        const next = [];
+        for (const { path, depth } of queue) {
+            if (Date.now() > deadline) {
+                truncated = true;
+                break;
+            }
+            let dirents;
+            try {
+                dirents = await readdir(path, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const d of dirents) {
+                if (!d.isDirectory() || d.name.startsWith(".") || SKIP.has(d.name))
+                    continue;
+                const full = join(path, d.name);
+                if (d.name.toLowerCase().includes(query)) {
+                    const children = new Set(await readdir(full).catch(() => []));
+                    found.push({ name: d.name, path: full, project: isProject(children) || undefined });
+                }
+                if (depth < 4)
+                    next.push({ path: full, depth: depth + 1 });
+            }
+        }
+        queue = next;
+    }
+    // Code projects first (that's what a session runs in), then how well the name matches.
+    const score = (e) => (e.project ? 0 : 10) + (e.name.toLowerCase() === query ? 0 : e.name.toLowerCase().startsWith(query) ? 1 : 2);
+    found.sort((a, b) => score(a) - score(b) || a.path.split("/").length - b.path.split("/").length);
+    if (found.length > input.limit)
+        truncated = true;
+    return { entries: found.slice(0, input.limit), truncated };
+}
+const IMAGE_TYPES = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    heic: "image/heic",
+};
+/** Reads a file for the phone's viewer. Text is detected by content, not extension. */
+export async function readFile(input) {
+    const path = expand(input.path);
+    let info;
+    try {
+        info = await stat(path);
+    }
+    catch {
+        throw RpcError.app("not_found", `no such file: ${path}`);
+    }
+    if (!info.isFile())
+        throw RpcError.app("invalid_params", `not a file: ${path}`);
+    const extension = path.split(".").pop()?.toLowerCase() ?? "";
+    const image = IMAGE_TYPES[extension];
+    const limit = image ? Math.min(input.maxBytes * 3, 8_000_000) : input.maxBytes;
+    const length = Math.min(info.size, limit);
+    const handle = await open(path, "r");
+    const buffer = Buffer.alloc(length);
+    try {
+        await handle.read(buffer, 0, length, 0);
+    }
+    finally {
+        await handle.close();
+    }
+    const base = { path, size: info.size, modifiedAt: info.mtimeMs, truncated: info.size > length };
+    if (image && !base.truncated)
+        return { ...base, kind: "image", data: buffer.toString("base64"), mimeType: image };
+    // Text: no NUL bytes in the first 8KB.
+    if (buffer.subarray(0, 8192).includes(0))
+        return { ...base, kind: "binary" };
+    let text = buffer.toString("utf8");
+    // Don't end on half a multi-byte character.
+    if (base.truncated)
+        text = text.replace(/\uFFFD+$/, "");
+    return { ...base, kind: "text", text };
+}
+/** A single path component: no separators, no `.`/`..`, nothing a shell or filesystem would choke on. */
+function safeName(name) {
+    const cleaned = name.replace(/[/\\\0]/g, "_").trim();
+    if (!cleaned || cleaned === "." || cleaned === "..")
+        throw RpcError.app("invalid_params", "invalid name");
+    return cleaned;
+}
+async function existingDirectory(path) {
+    const dir = resolve(path.replace(/^~(?=$|\/)/, homedir()));
+    const info = await stat(dir).catch(() => undefined);
+    if (!info?.isDirectory())
+        throw RpcError.app("not_found", `no such directory: ${path}`);
+    return dir;
+}
+/** Writes an uploaded file into `dir`, never over an existing one. */
+export async function uploadFile(input) {
+    const dir = await existingDirectory(input.dir);
+    const name = safeName(input.name);
+    const bytes = Buffer.from(input.data, "base64");
+    const ext = extname(name);
+    const stem = basename(name, ext);
+    for (let attempt = 1; attempt < 1000; attempt++) {
+        const path = join(dir, attempt === 1 ? name : `${stem} ${attempt}${ext}`);
+        try {
+            // "wx": fails if the file exists, so a race can't overwrite either.
+            await writeFile(path, bytes, { flag: "wx" });
+            return { path, size: bytes.length };
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+    }
+    throw RpcError.app("busy", "too many files with this name");
+}
+export async function makeDirectory(input) {
+    const parent = await existingDirectory(input.parent);
+    const path = join(parent, safeName(input.name));
+    try {
+        await mkdir(path);
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            throw RpcError.app("invalid_params", "a file or folder with this name already exists");
+        throw error;
+    }
+    return { path };
+}
+//# sourceMappingURL=fs.js.map

package/dist/host/src/fs.js.map

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

package/dist/host/src/gateway.d.ts

@@ -0,0 +1,55 @@
+import { type GatewayStatus, type Identity } from "@linkshell/wire";
+import type { RpcTransport } from "./rpc/server.js";
+export interface GatewayLinkOptions {
+    /** Gateway base URL (ws:// or wss://, or http(s):// which is converted). */
+    url: string;
+    home: string;
+    /** Account token (from `linkshell login`); the machine then belongs to that account. */
+    token?: () => Promise<string | undefined> | string | undefined;
+    name?: string;
+    /** Serves a decrypted channel as a client connection. */
+    serve: (transport: RpcTransport) => void;
+    onChange?: (status: GatewayStatus) => void;
+    onPaired?: (device: {
+        id: string;
+        name: string;
+    }) => void;
+    log: (message: string) => void;
+}
+export declare function relayUrl(base: string): string;
+export declare class GatewayLink {
+    private readonly options;
+    readonly identity: Identity;
+    private readonly relay;
+    private readonly devicesPath;
+    private devices;
+    private pairing?;
+    private readonly tunnels;
+    private readonly online;
+    private readonly name;
+    constructor(options: GatewayLinkOptions);
+    start(): void;
+    stop(): void;
+    status(): GatewayStatus;
+    /** Opens a pairing window; the returned link goes in the QR code. */
+    startPairing(): Promise<{
+        link: string;
+        code: string;
+        expiresAt: number;
+        gateway: string;
+    }>;
+    revoke(deviceId: string): Promise<void>;
+    private onPairRequest;
+    private onFrame;
+    /**
+     * Whose hello to accept: devices paired here (with the keys stored at
+     * pairing, not whatever the gateway says now), or, when this machine is
+     * signed in, devices the gateway says share its account.
+     */
+    private authorize;
+    private closeTunnel;
+    private refreshPresence;
+    private changed;
+    private loadDevices;
+    private saveDevices;
+}

package/dist/host/src/gateway.js

@@ -0,0 +1,263 @@
+import { chmodSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { hostname, platform } from "node:os";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+import WebSocket from "ws";
+import { answerTunnel, checkPairingProof, codeSecret, createIdentity, encodePairingLink, RELAY_PATH, RelayClient, RpcError, toBase64, } from "@linkshell/wire";
+export function relayUrl(base) {
+    const url = new URL(base.replace(/^http/, "ws"));
+    if (!url.pathname.endsWith(RELAY_PATH))
+        url.pathname = url.pathname.replace(/\/$/, "") + RELAY_PATH;
+    return url.toString();
+}
+function loadIdentity(home) {
+    const path = join(home, "identity.json");
+    try {
+        const stored = JSON.parse(readFileSync(path, "utf8"));
+        if (stored.id && stored.signSecret && stored.boxSecret)
+            return stored;
+    }
+    catch {
+        // First run: create below.
+    }
+    const identity = createIdentity();
+    writeFileSync(path, `${JSON.stringify(identity, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+    return identity;
+}
+export class GatewayLink {
+    options;
+    identity;
+    relay;
+    devicesPath;
+    devices;
+    pairing;
+    tunnels = new Map();
+    online = new Set();
+    name;
+    constructor(options) {
+        this.options = options;
+        this.identity = loadIdentity(options.home);
+        this.devicesPath = join(options.home, "paired-devices.json");
+        this.devices = this.loadDevices();
+        this.name = options.name ?? hostname().replace(/\.local$/, "");
+        this.relay = new RelayClient({
+            url: relayUrl(options.url),
+            identity: this.identity,
+            role: "machine",
+            name: this.name,
+            platform: platform(),
+            token: options.token,
+            createSocket: (url) => new WebSocket(url, { perMessageDeflate: false }),
+        });
+        this.relay.onStatus((status, error) => {
+            if (status === "online") {
+                this.options.log(`[gateway] online as ${this.identity.id.slice(0, 8)}${this.relay.account ? ` (${this.relay.account.email ?? "account"})` : ""}`);
+                void this.refreshPresence();
+            }
+            else if (error && status === "offline") {
+                this.options.log(`[gateway] ${error.code}: ${error.message}`);
+                for (const tunnel of this.tunnels.values())
+                    this.closeTunnel(tunnel, "gateway disconnected");
+            }
+            this.changed();
+        });
+        this.relay.onFrame((from, via, frame) => this.onFrame(from, via, frame));
+        this.relay.on("pair.request", (request) => void this.onPairRequest(request));
+        this.relay.on("presence", ({ id, online }) => {
+            if (online)
+                this.online.add(id);
+            else {
+                this.online.delete(id);
+                for (const tunnel of this.tunnels.values())
+                    if (tunnel.deviceId === id)
+                        this.closeTunnel(tunnel, "device went offline");
+            }
+            this.changed();
+        });
+    }
+    start() {
+        this.relay.start();
+    }
+    stop() {
+        for (const tunnel of this.tunnels.values())
+            this.closeTunnel(tunnel, "host stopping");
+        this.relay.stop();
+    }
+    status() {
+        const status = this.relay.status;
+        return {
+            url: this.options.url,
+            status: status === "stopped" ? "off" : status,
+            error: status === "online" ? undefined : this.relay.lastError,
+            machine: { id: this.identity.id, name: this.name },
+            account: this.relay.account,
+            devices: this.devices.map((device) => ({
+                id: device.id,
+                name: device.name,
+                pairedAt: device.pairedAt,
+                online: this.online.has(device.id),
+            })),
+        };
+    }
+    /** Opens a pairing window; the returned link goes in the QR code. */
+    async startPairing() {
+        if (!(await this.relay.waitOnline(8000))) {
+            throw RpcError.app("offline", `can't reach the gateway (${this.options.url})${this.relay.lastError ? `: ${this.relay.lastError.message}` : ""}`);
+        }
+        const offer = await this.relay.request("pair.offer", {});
+        const secret = toBase64(randomBytes(16));
+        this.pairing = { secret, code: offer.code, expiresAt: offer.expiresAt };
+        const link = encodePairingLink({ gateway: this.options.url, signKey: this.identity.signKey, secret, code: offer.code });
+        return { link, code: offer.code, expiresAt: offer.expiresAt, gateway: this.options.url };
+    }
+    async revoke(deviceId) {
+        this.devices = this.devices.filter((device) => device.id !== deviceId);
+        this.saveDevices();
+        for (const tunnel of this.tunnels.values())
+            if (tunnel.deviceId === deviceId)
+                this.closeTunnel(tunnel, "unpaired");
+        await this.relay.request("devices.revoke", { deviceId }).catch(() => { });
+        this.changed();
+    }
+    // ── pairing ───────────────────────────────────────────────────────
+    async onPairRequest(request) {
+        const pairing = this.pairing;
+        const valid = !!pairing &&
+            pairing.expiresAt > Date.now() &&
+            request.code === pairing.code &&
+            (checkPairingProof(pairing.secret, request.device, request.proof) || checkPairingProof(codeSecret(pairing.code), request.device, request.proof));
+        if (valid) {
+            this.devices = [
+                ...this.devices.filter((device) => device.id !== request.device.id),
+                { ...request.device, pairedAt: Date.now() },
+            ];
+            this.saveDevices();
+            this.pairing = undefined;
+            this.online.add(request.device.id);
+            this.options.log(`[gateway] paired with "${request.device.name}"`);
+            this.options.onPaired?.({ id: request.device.id, name: request.device.name });
+            this.changed();
+        }
+        else {
+            this.options.log(`[gateway] refused a pairing attempt from "${request.device.name}"`);
+        }
+        await this.relay.request("pair.decide", { requestId: request.requestId, accept: valid }).catch(() => { });
+    }
+    // ── channels ──────────────────────────────────────────────────────
+    onFrame(from, via, frame) {
+        const key = `${from.id}:${frame.ch}`;
+        switch (frame.k) {
+            case "hello": {
+                const device = this.authorize(from, via);
+                if (!device) {
+                    this.relay.send(from.id, { k: "refuse", ch: frame.ch, code: "not_paired", message: "this device isn't paired with this computer" });
+                    return;
+                }
+                let answer;
+                try {
+                    answer = answerTunnel(this.identity, device, frame);
+                }
+                catch {
+                    this.relay.send(from.id, { k: "refuse", ch: frame.ch, code: "bad_hello", message: "handshake failed" });
+                    return;
+                }
+                const previous = this.tunnels.get(key);
+                if (previous)
+                    this.closeTunnel(previous, "reopened");
+                const tunnel = { channel: answer.channel, deviceId: from.id, ch: frame.ch, closed: false };
+                this.tunnels.set(key, tunnel);
+                this.relay.send(from.id, answer.welcome);
+                this.options.serve({
+                    local: false,
+                    send: (text) => {
+                        if (!tunnel.closed)
+                            this.relay.send(from.id, { k: "data", ch: frame.ch, box: tunnel.channel.seal(text) });
+                    },
+                    close: () => this.closeTunnel(tunnel, "closed by host", true),
+                    onMessage: (listener) => (tunnel.message = listener),
+                    onClose: (listener) => (tunnel.close = listener),
+                });
+                return;
+            }
+            case "data": {
+                const tunnel = this.tunnels.get(key);
+                if (!tunnel)
+                    return;
+                let text;
+                try {
+                    text = tunnel.channel.open(frame.box);
+                }
+                catch {
+                    // Tampered, replayed or out of order: the channel can't be trusted any more.
+                    this.closeTunnel(tunnel, "bad frame", true);
+                    return;
+                }
+                tunnel.message?.(text);
+                return;
+            }
+            case "close": {
+                const tunnel = this.tunnels.get(key);
+                if (tunnel)
+                    this.closeTunnel(tunnel, frame.reason ?? "closed by device");
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    /**
+     * Whose hello to accept: devices paired here (with the keys stored at
+     * pairing, not whatever the gateway says now), or, when this machine is
+     * signed in, devices the gateway says share its account.
+     */
+    authorize(from, via) {
+        const paired = this.devices.find((device) => device.id === from.id);
+        if (paired)
+            return paired.signKey === from.signKey && paired.boxKey === from.boxKey ? paired : undefined;
+        if (via === "account" && this.relay.account)
+            return from;
+        return undefined;
+    }
+    closeTunnel(tunnel, reason, notify = false) {
+        if (tunnel.closed)
+            return;
+        tunnel.closed = true;
+        this.tunnels.delete(`${tunnel.deviceId}:${tunnel.ch}`);
+        if (notify)
+            this.relay.send(tunnel.deviceId, { k: "close", ch: tunnel.ch, reason });
+        tunnel.close?.();
+    }
+    async refreshPresence() {
+        try {
+            const { devices } = await this.relay.request("devices.list", {});
+            this.online.clear();
+            for (const device of devices)
+                if (device.online)
+                    this.online.add(device.id);
+            this.changed();
+        }
+        catch {
+            // Presence events will correct it.
+        }
+    }
+    changed() {
+        this.options.onChange?.(this.status());
+    }
+    loadDevices() {
+        if (!existsSync(this.devicesPath))
+            return [];
+        try {
+            const parsed = JSON.parse(readFileSync(this.devicesPath, "utf8"));
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    saveDevices() {
+        writeFileSync(this.devicesPath, `${JSON.stringify(this.devices, null, 2)}\n`, { mode: 0o600 });
+        chmodSync(this.devicesPath, 0o600);
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/host/src/gateway.js.map

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

package/dist/host/src/host.d.ts

@@ -0,0 +1,51 @@
+import type { MachineInfo } from "@linkshell/wire";
+import type { AgentDriver } from "./drivers/types.js";
+import { SessionHub } from "./hub.js";
+import { HostRpcServer } from "./rpc/server.js";
+import { GatewayLink } from "./gateway.js";
+export interface HostPaths {
+    home: string;
+    runDir: string;
+    hostSocket: string;
+    codexSocket: string;
+    database: string;
+}
+/** `~/.linkshell`, or `$LINKSHELL_HOME` (tests, multiple instances). */
+export declare function defaultHome(): string;
+export declare function hostPaths(home?: string): HostPaths;
+export interface HostOptions {
+    home?: string;
+    version: string;
+    /** Environment agents run with — should be the user's login-shell environment. */
+    env?: NodeJS.ProcessEnv;
+    codexCommand?: string;
+    claudeCommand?: string;
+    /** Overrides the bundled Claude ACP adapter. */
+    claudeAdapter?: {
+        command: string;
+        args: string[];
+    };
+    /** Extra drivers (tests) or a full replacement of the default set. */
+    drivers?: (paths: HostPaths) => AgentDriver[];
+    tcpPort?: number;
+    log?: (message: string) => void;
+    /** A v2 gateway to reach this machine through, from anywhere. */
+    gateway?: {
+        url: string;
+        token?: () => Promise<string | undefined> | string | undefined;
+        name?: string;
+    };
+    /** How often to re-list sessions started outside LinkShell; 0 disables. */
+    discoveryIntervalMs?: number;
+}
+export interface RunningHost {
+    paths: HostPaths;
+    hub: SessionHub;
+    server: HostRpcServer;
+    gateway?: GatewayLink;
+    machineInfo(): MachineInfo;
+    stop(): Promise<void>;
+}
+/** True when another host already answers on the socket. */
+export declare function isHostRunning(socketPath: string): Promise<boolean>;
+export declare function startHost(options: HostOptions): Promise<RunningHost>;