@linkshell/host 0.1.0

package/dist/wire/src/model.js

@@ -0,0 +1,163 @@
+import { z } from "zod";
+/**
+ * How far LinkShell can take a given agent. The UI renders capabilities from
+ * this instead of guessing:
+ * - multi_client: desktop TUI and remote devices are live clients of one agent
+ *   server (Codex app-server, OpenCode server).
+ * - handoff: the native TUI owns the session on the desktop; a remote device can
+ *   take it over and the session continues headlessly under the same id.
+ * - remote: structured control only; the desktop uses LinkShell's own UI.
+ * - terminal: PTY only.
+ */
+export const agentTierSchema = z.enum(["multi_client", "handoff", "remote", "terminal"]);
+export const agentCapabilitiesSchema = z.object({
+    interrupt: z.boolean(),
+    /** Inject a message into a running turn instead of queueing it. */
+    steer: z.boolean(),
+    permissions: z.boolean(),
+    images: z.boolean(),
+    fork: z.boolean(),
+    models: z.boolean(),
+    modes: z.boolean(),
+});
+/**
+ * How the agent authenticates on this machine, as the agent itself reports it
+ * (e.g. `claude auth status`, `codex login status`). LinkShell never handles
+ * the credentials; it runs agents with the user's own environment and config.
+ */
+export const agentAuthSchema = z.object({
+    state: z.enum(["ok", "missing", "unknown"]),
+    /** e.g. "claude.ai", "api_key", "oauth_token", "chatgpt", "bedrock". */
+    method: z.string().optional(),
+    /** What the user should do when state is "missing". */
+    hint: z.string().optional(),
+});
+export const agentInfoSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    tier: agentTierSchema,
+    installed: z.boolean(),
+    version: z.string().optional(),
+    /** Human-readable reason when the agent is installed but unusable. */
+    problem: z.string().optional(),
+    auth: agentAuthSchema.optional(),
+    capabilities: agentCapabilitiesSchema,
+});
+/**
+ * Who is driving a handoff session right now: the desktop's native UI, this
+ * host on behalf of a device, or nobody (either side can continue).
+ */
+export const sessionDriverSchema = z.enum(["desktop", "remote", "none"]);
+export const sessionStateSchema = z.enum(["idle", "running", "waiting", "error", "offline"]);
+export const toolKindSchema = z.enum([
+    "read",
+    "edit",
+    "delete",
+    "move",
+    "search",
+    "execute",
+    "think",
+    "fetch",
+    "other",
+]);
+export const permissionOptionSchema = z.object({
+    optionId: z.string().min(1),
+    name: z.string().min(1),
+    kind: z.enum(["allow_once", "allow_always", "reject_once", "reject_always"]),
+});
+/** What a running session is doing right now, for list rows. Live only. */
+export const sessionActivitySchema = z.object({
+    kind: z.enum(["thinking", "responding", "tool"]),
+    title: z.string().optional(),
+    toolKind: toolKindSchema.optional(),
+});
+/** The oldest unanswered permission request, so lists can offer approval inline. Live only. */
+export const pendingPermissionSchema = z.object({
+    requestId: z.string(),
+    toolCallId: z.string().optional(),
+    title: z.string(),
+    detail: z.string().optional(),
+    options: z.array(permissionOptionSchema).min(1),
+});
+export const sessionSummarySchema = z.object({
+    /** `${agent}:${nativeId}` — stable across daemon restarts and rediscovery. */
+    id: z.string().min(1),
+    agent: z.string().min(1),
+    nativeId: z.string().min(1),
+    title: z.string().optional(),
+    preview: z.string().optional(),
+    cwd: z.string(),
+    state: sessionStateSchema,
+    driver: sessionDriverSchema.optional(),
+    pendingPermissions: z.number().int().nonnegative(),
+    model: z.string().optional(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    lastSeq: z.number().int().nonnegative(),
+    archived: z.boolean(),
+    activity: sessionActivitySchema.optional(),
+    permission: pendingPermissionSchema.optional(),
+});
+export function sessionIdFor(agent, nativeId) {
+    return `${agent}:${nativeId}`;
+}
+export function parseSessionId(id) {
+    const index = id.indexOf(":");
+    if (index <= 0 || index === id.length - 1)
+        return null;
+    return { agent: id.slice(0, index), nativeId: id.slice(index + 1) };
+}
+export const projectSummarySchema = z.object({
+    cwd: z.string(),
+    name: z.string(),
+    lastActiveAt: z.number(),
+    sessionCount: z.number().int().nonnegative(),
+});
+export const machineInfoSchema = z.object({
+    machineId: z.string().min(1),
+    hostname: z.string(),
+    platform: z.string(),
+    hostVersion: z.string(),
+    agents: z.array(agentInfoSchema),
+});
+/** A server listening on the host, which a device can preview through the encrypted channel. */
+export const portInfoSchema = z.object({
+    port: z.number().int().min(1).max(65535),
+    /** The listening process ("node", "python3.12"). */
+    process: z.string(),
+    pid: z.number().int().optional(),
+    /** The process's working directory: which project the server belongs to. */
+    cwd: z.string().optional(),
+    /** The page title, when the port answers HTTP with an HTML page. */
+    title: z.string().optional(),
+    /** Answers HTTP at all (a dev server, not a database). */
+    http: z.boolean(),
+});
+/** A shell the host keeps open, independent of any device connection. */
+export const terminalInfoSchema = z.object({
+    id: z.string(),
+    /** What's running in the foreground (the shell or its current command). */
+    title: z.string(),
+    cwd: z.string(),
+    cols: z.number().int(),
+    rows: z.number().int(),
+    createdAt: z.number(),
+    /** Last output time. */
+    activeAt: z.number(),
+    /** The command it was started to run, if any (else it's a plain shell). */
+    command: z.string().optional(),
+    /** Set once the shell ended; the terminal and its output stay until deleted. */
+    exitCode: z.number().int().nullable().optional(),
+    /** Ended without an exit code: the host stopped while it ran. */
+    interrupted: z.boolean().optional(),
+});
+/** The host's link to a v2 gateway, for `linkshell status` and the app's computer page. */
+export const gatewayStatusSchema = z.object({
+    url: z.string().optional(),
+    status: z.enum(["off", "connecting", "online", "offline"]),
+    error: z.object({ code: z.string(), message: z.string() }).optional(),
+    machine: z.object({ id: z.string(), name: z.string() }).optional(),
+    account: z.object({ userId: z.string(), email: z.string().optional() }).optional(),
+    devices: z.array(z.object({ id: z.string(), name: z.string(), pairedAt: z.number(), online: z.boolean() })),
+});
+//# sourceMappingURL=model.js.map

package/dist/wire/src/model.js.map

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

package/dist/wire/src/peer.d.ts

@@ -0,0 +1,42 @@
+import type { RpcErrorObject, RpcId } from "./rpc.js";
+/** An error that crosses the wire as a JSON-RPC error object. */
+export declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+    static app(appCode: string, message: string, extra?: Record<string, unknown>): RpcError;
+    /** The `data.code` of an application error, if any. */
+    get appCode(): string | undefined;
+    toObject(): RpcErrorObject;
+}
+/** Returned by a request handler to leave a request unanswered for good. */
+export declare const ABANDON: unique symbol;
+export type RequestHandler = (method: string, params: unknown, id: RpcId) => unknown | Promise<unknown>;
+export type NotificationHandler = (method: string, params: unknown) => void;
+export interface RpcPeerOptions {
+    /** Sends one serialized JSON-RPC message. */
+    send: (text: string) => void;
+    onRequest?: RequestHandler;
+    onNotification?: NotificationHandler;
+    /** Default timeout for outgoing requests; 0 disables it. */
+    requestTimeoutMs?: number;
+}
+/**
+ * Transport-agnostic JSON-RPC 2.0 peer: both sides can issue requests and
+ * notifications. Feed incoming text frames to `receive()`.
+ */
+export declare class RpcPeer {
+    private readonly options;
+    private nextId;
+    private readonly pending;
+    private closed;
+    constructor(options: RpcPeerOptions);
+    request<T = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<T>;
+    notify(method: string, params?: unknown): void;
+    receive(text: string): void;
+    /** Rejects every in-flight request; later calls fail immediately. */
+    close(reason?: string): void;
+    get isClosed(): boolean;
+    private dispatch;
+    private write;
+}

package/dist/wire/src/peer.js

@@ -0,0 +1,143 @@
+import { RPC_APP_ERROR, RPC_METHOD_NOT_FOUND } from "./rpc.js";
+/** An error that crosses the wire as a JSON-RPC error object. */
+export class RpcError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = "RpcError";
+    }
+    static app(appCode, message, extra) {
+        return new RpcError(RPC_APP_ERROR, message, { code: appCode, ...extra });
+    }
+    /** The `data.code` of an application error, if any. */
+    get appCode() {
+        const data = this.data;
+        return typeof data?.code === "string" ? data.code : undefined;
+    }
+    toObject() {
+        return this.data === undefined
+            ? { code: this.code, message: this.message }
+            : { code: this.code, message: this.message, data: this.data };
+    }
+}
+/** Returned by a request handler to leave a request unanswered for good. */
+export const ABANDON = Symbol("rpc.abandon");
+/**
+ * Transport-agnostic JSON-RPC 2.0 peer: both sides can issue requests and
+ * notifications. Feed incoming text frames to `receive()`.
+ */
+export class RpcPeer {
+    options;
+    nextId = 1;
+    pending = new Map();
+    closed = false;
+    constructor(options) {
+        this.options = options;
+    }
+    request(method, params, timeoutMs) {
+        if (this.closed)
+            return Promise.reject(new RpcError(RPC_APP_ERROR, `connection closed (${method})`));
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const entry = { resolve: resolve, reject, method };
+            const limit = timeoutMs ?? this.options.requestTimeoutMs ?? 30_000;
+            if (limit > 0) {
+                entry.timer = setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new RpcError(RPC_APP_ERROR, `${method} timed out after ${limit}ms`, { code: "timeout" }));
+                }, limit);
+            }
+            this.pending.set(id, entry);
+            this.write({ jsonrpc: "2.0", id, method, params: params ?? {} });
+        });
+    }
+    notify(method, params) {
+        if (this.closed)
+            return;
+        this.write({ jsonrpc: "2.0", method, params: params ?? {} });
+    }
+    receive(text) {
+        for (const line of text.split("\n")) {
+            if (!line.trim())
+                continue;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            this.dispatch(message);
+        }
+    }
+    /** Rejects every in-flight request; later calls fail immediately. */
+    close(reason = "connection closed") {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const [id, entry] of this.pending) {
+            if (entry.timer)
+                clearTimeout(entry.timer);
+            entry.reject(new RpcError(RPC_APP_ERROR, `${reason} (${entry.method})`, { code: "closed" }));
+            this.pending.delete(id);
+        }
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    dispatch(message) {
+        const id = message.id;
+        const method = typeof message.method === "string" ? message.method : undefined;
+        if (method === undefined) {
+            if (id === undefined)
+                return;
+            const entry = this.pending.get(id);
+            if (!entry)
+                return;
+            this.pending.delete(id);
+            if (entry.timer)
+                clearTimeout(entry.timer);
+            const error = message.error;
+            if (error)
+                entry.reject(new RpcError(error.code, error.message, error.data));
+            else
+                entry.resolve(message.result);
+            return;
+        }
+        if (id === undefined) {
+            this.options.onNotification?.(method, message.params);
+            return;
+        }
+        const handler = this.options.onRequest;
+        if (!handler) {
+            this.write({ jsonrpc: "2.0", id, error: { code: RPC_METHOD_NOT_FOUND, message: `no handler for ${method}` } });
+            return;
+        }
+        Promise.resolve()
+            .then(() => handler(method, message.params, id))
+            .then((result) => {
+            if (result === ABANDON)
+                return;
+            this.write({ jsonrpc: "2.0", id, result: result ?? {} });
+        }, (error) => {
+            const rpcError = error instanceof RpcError
+                ? error
+                : new RpcError(RPC_APP_ERROR, error instanceof Error ? error.message : String(error), { code: "internal" });
+            this.write({ jsonrpc: "2.0", id, error: rpcError.toObject() });
+        });
+    }
+    write(message) {
+        if (this.closed)
+            return;
+        try {
+            this.options.send(JSON.stringify(message));
+        }
+        catch {
+            this.close("send failed");
+        }
+    }
+}
+//# sourceMappingURL=peer.js.map

package/dist/wire/src/peer.js.map

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

package/dist/wire/src/relay-client.d.ts

@@ -0,0 +1,82 @@
+import { type Identity, type PublicIdentity } from "./crypto.js";
+import { type PeerRole, type RelayEvents, type RelayMethod, type RelayMethods, type TunnelFrame } from "./relay.js";
+export interface RelaySocket {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((event: {
+        code?: number;
+        reason?: string;
+    }) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+}
+export type RelayStatus = "connecting" | "online" | "offline" | "stopped";
+export interface RelayClientOptions {
+    url: string;
+    identity: Identity;
+    role: PeerRole;
+    name: string;
+    platform?: string;
+    /** Account token, fetched fresh for each connection. */
+    token?: () => Promise<string | undefined> | string | undefined;
+    createSocket: (url: string) => RelaySocket;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    requestTimeoutMs?: number;
+}
+export declare class RelayRequestError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class RelayClient {
+    private readonly options;
+    private socket?;
+    private statusValue;
+    private attempt;
+    private timer?;
+    private nextId;
+    private readonly pending;
+    private readonly statusListeners;
+    private readonly frameListeners;
+    private readonly undeliverableListeners;
+    private readonly eventListeners;
+    private readonly waiters;
+    /** Account the gateway recognised on the last connection. */
+    account?: {
+        userId: string;
+        email?: string;
+    };
+    lastError?: {
+        code: string;
+        message: string;
+    };
+    constructor(options: RelayClientOptions);
+    get status(): RelayStatus;
+    get identity(): PublicIdentity;
+    onStatus(listener: (status: RelayStatus, error?: {
+        code: string;
+        message: string;
+    }) => void): () => void;
+    onFrame(listener: (from: PublicIdentity, via: "paired" | "account", frame: TunnelFrame) => void): () => void;
+    onUndeliverable(listener: (to: string, reason: string) => void): () => void;
+    on<N extends keyof RelayEvents>(name: N, listener: (data: RelayEvents[N]) => void): () => void;
+    start(): void;
+    stop(): void;
+    /** Reconnect now instead of waiting out the backoff (app foregrounded, network back). */
+    reconnectNow(): void;
+    /** Waits (up to `timeoutMs`) for the gateway connection. */
+    waitOnline(timeoutMs: number): Promise<boolean>;
+    request<M extends RelayMethod>(method: M, params: RelayMethods[M]["params"], timeoutMs?: number): Promise<RelayMethods[M]["result"]>;
+    /** Sends a tunnel frame to a peer. Returns false when not connected. */
+    send(to: string, frame: TunnelFrame): boolean;
+    private sendFrame;
+    private setStatus;
+    private failPending;
+    private open;
+    private authenticate;
+    private scheduleReconnect;
+}