linkshell-cli 0.5.42 → 0.6.1

package/dist/host/src/host.js

@@ -0,0 +1,133 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, hostname, platform } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { defaultDrivers } from "./drivers/registry.js";
+import { SessionHub } from "./hub.js";
+import { connectHost } from "./rpc/client.js";
+import { HostRpcServer } from "./rpc/server.js";
+import { GatewayLink } from "./gateway.js";
+import { HostStore } from "./store.js";
+import { TerminalManager } from "./terminals.js";
+/** macOS sun_path is 104 bytes including the terminator. */
+const MAX_SOCKET_PATH = 100;
+/** `~/.linkshell`, or `$LINKSHELL_HOME` (tests, multiple instances). */
+export function defaultHome() {
+    return process.env.LINKSHELL_HOME || join(homedir(), ".linkshell");
+}
+export function hostPaths(home = defaultHome()) {
+    let runDir = join(home, "run");
+    if (join(runDir, "codex.sock").length > MAX_SOCKET_PATH) {
+        // Very long home directories: fall back to a short per-user directory.
+        runDir = join("/tmp", `linkshell-${process.getuid?.() ?? "user"}`);
+    }
+    return {
+        home,
+        runDir,
+        hostSocket: join(runDir, "host.sock"),
+        codexSocket: join(runDir, "codex.sock"),
+        database: join(home, "state.db"),
+    };
+}
+function loadMachineId(home) {
+    const path = join(home, "machine.json");
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof parsed.machineId === "string" && parsed.machineId)
+            return parsed.machineId;
+    }
+    catch {
+        // Missing or unreadable: mint a new identity below.
+    }
+    const machineId = randomUUID();
+    writeFileSync(path, `${JSON.stringify({ machineId, createdAt: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+    return machineId;
+}
+/** True when another host already answers on the socket. */
+export async function isHostRunning(socketPath) {
+    if (!existsSync(socketPath))
+        return false;
+    try {
+        const client = await connectHost(socketPath);
+        client.close();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function startHost(options) {
+    const log = options.log ?? ((message) => process.stderr.write(`${message}\n`));
+    const paths = hostPaths(options.home);
+    mkdirSync(paths.home, { recursive: true, mode: 0o700 });
+    mkdirSync(paths.runDir, { recursive: true, mode: 0o700 });
+    chmodSync(paths.runDir, 0o700);
+    if (await isHostRunning(paths.hostSocket)) {
+        throw new Error(`a LinkShell host is already running (${paths.hostSocket})`);
+    }
+    const machineId = loadMachineId(paths.home);
+    const drivers = options.drivers
+        ? options.drivers(paths)
+        : defaultDrivers({
+            env: options.env,
+            hostVersion: options.version,
+            codexSocket: paths.codexSocket,
+            codexCommand: options.codexCommand,
+            claudeCommand: options.claudeCommand,
+            claudeAdapter: options.claudeAdapter,
+        });
+    const store = new HostStore(paths.database);
+    const hub = new SessionHub(store, drivers, log);
+    await hub.start({ discoveryIntervalMs: options.discoveryIntervalMs });
+    const machineInfo = () => ({
+        machineId,
+        hostname: hostname(),
+        platform: platform(),
+        hostVersion: options.version,
+        agents: hub.agents(),
+    });
+    const terminals = new TerminalManager(options.env, store);
+    const server = new HostRpcServer({
+        hub,
+        terminals,
+        machineInfo,
+        socketPath: paths.hostSocket,
+        tcpPort: options.tcpPort,
+        log,
+    });
+    await server.start();
+    let gateway;
+    if (options.gateway) {
+        gateway = new GatewayLink({
+            url: options.gateway.url,
+            home: paths.home,
+            token: options.gateway.token,
+            name: options.gateway.name,
+            serve: (transport) => server.connect(transport),
+            onChange: (status) => server.broadcast("gateway.changed", status),
+            onPaired: (device) => server.broadcast("pairing.done", { device }),
+            log,
+        });
+        server.setGateway(gateway);
+        gateway.start();
+    }
+    let stopping;
+    return {
+        paths,
+        hub,
+        server,
+        gateway,
+        machineInfo,
+        stop() {
+            stopping ??= (async () => {
+                gateway?.stop();
+                await server.stop();
+                terminals.stop();
+                await hub.stop();
+                store.close();
+            })();
+            return stopping;
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

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

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

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

@@ -0,0 +1,89 @@
+import { type AgentInfo, type ContentBlock, type SessionEvent, type SessionSummary } from "@linkshell/wire";
+import type { AgentDriver, DesktopController, DesktopLaunchContext, DriverHost, LaunchSpec } from "./drivers/types.js";
+import type { HostStore } from "./store.js";
+export interface Subscriber {
+    event(event: SessionEvent): void;
+}
+/**
+ * The host's source of truth for sessions. Drivers push native events in;
+ * the hub logs them with a per-session seq, keeps summaries current and fans
+ * events out to subscribed clients.
+ */
+export declare class SessionHub {
+    private readonly store;
+    private readonly log;
+    private readonly drivers;
+    private readonly live;
+    private readonly summaryListeners;
+    private readonly auth;
+    /** Terminals (`linkshell <agent>`) currently driving handoff sessions. */
+    private readonly desktops;
+    private discoveryTimer?;
+    private authRefreshing?;
+    readonly driverHost: DriverHost;
+    constructor(store: HostStore, drivers: AgentDriver[], log?: (message: string) => void);
+    start(options?: {
+        discoveryIntervalMs?: number;
+    }): Promise<void>;
+    /** Re-lists recent sessions from every running agent. */
+    refreshDiscovery(limit?: number): Promise<void>;
+    stop(): Promise<void>;
+    agents(): AgentInfo[];
+    /** Re-checks login state in the background when the cached answer is older than `maxAgeMs`. */
+    refreshAuthIfStale(maxAgeMs?: number): Promise<void>;
+    private refreshAuth;
+    onSummary(listener: (summary: SessionSummary) => void): () => void;
+    listSessions(options: {
+        limit?: number;
+        before?: number;
+        includeArchived?: boolean;
+    }): {
+        sessions: SessionSummary[];
+        nextBefore?: number;
+    };
+    listProjects(limit?: number): {
+        cwd: string;
+        name: string;
+        lastActiveAt: number;
+        sessionCount: number;
+    }[];
+    getSession(sessionId: string): SessionSummary;
+    /** Adds the live-only fields (current activity, first pending permission) to a stored summary. */
+    private decorate;
+    createSession(input: {
+        agent: string;
+        cwd: string;
+        model?: string;
+        prompt?: ContentBlock[];
+        clientMessageId?: string;
+    }): Promise<SessionSummary>;
+    /**
+     * Sends everything after `fromSeq`, then streams live events. The backlog read
+     * and the subscriber registration happen in one synchronous step, so no event
+     * can fall between them.
+     */
+    subscribe(sessionId: string, fromSeq: number, subscriber: Subscriber): Promise<SessionSummary>;
+    unsubscribe(sessionId: string, subscriber: Subscriber): void;
+    prompt(sessionId: string, clientMessageId: string, content: ContentBlock[]): Promise<"started" | "steered" | "queued" | "duplicate">;
+    /** Retries attaching a session that just became joinable. */
+    private attachWhenReady;
+    cancel(sessionId: string): Promise<void>;
+    respondPermission(sessionId: string, requestId: string, optionId: string): Promise<void>;
+    desktopLaunch(agent: string, args: string[], sessionId: string | undefined, context: DesktopLaunchContext): Promise<LaunchSpec & {
+        sessionId?: string;
+    }>;
+    /** Registers the terminal driving a handoff session; returns the unregister function. */
+    registerDesktop(sessionId: string, controller: DesktopController): () => void;
+    takeover(sessionId: string): Promise<SessionSummary>;
+    reclaim(sessionId: string, context: DesktopLaunchContext): Promise<LaunchSpec>;
+    setConfig(sessionId: string, optionId: string, value: string): Promise<void>;
+    private requireDriver;
+    private liveFor;
+    /** Never throws synchronously: failures always arrive as a rejected promise. */
+    private ensureAttached;
+    private recordDiscovered;
+    private ingest;
+    private commit;
+    private applyToSummary;
+    private emitSummary;
+}