@linkshell/host 0.1.0

package/dist/host/src/store.js

@@ -0,0 +1,265 @@
+import { DatabaseSync } from "node:sqlite";
+import { basename } from "node:path";
+const SCHEMA = `
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  agent TEXT NOT NULL,
+  native_id TEXT NOT NULL,
+  title TEXT,
+  preview TEXT,
+  cwd TEXT NOT NULL,
+  state TEXT NOT NULL,
+  driver TEXT,
+  pending_permissions INTEGER NOT NULL DEFAULT 0,
+  model TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  last_seq INTEGER NOT NULL DEFAULT 0,
+  archived INTEGER NOT NULL DEFAULT 0
+);
+CREATE INDEX IF NOT EXISTS sessions_by_updated ON sessions (updated_at DESC);
+CREATE TABLE IF NOT EXISTS events (
+  session_id TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  ts INTEGER NOT NULL,
+  body TEXT NOT NULL,
+  PRIMARY KEY (session_id, seq)
+) WITHOUT ROWID;
+CREATE TABLE IF NOT EXISTS logged_items (
+  session_id TEXT NOT NULL,
+  item_id TEXT NOT NULL,
+  PRIMARY KEY (session_id, item_id)
+) WITHOUT ROWID;
+CREATE TABLE IF NOT EXISTS driver_state (
+  session_id TEXT NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  PRIMARY KEY (session_id, key)
+) WITHOUT ROWID;
+CREATE TABLE IF NOT EXISTS client_messages (
+  session_id TEXT NOT NULL,
+  client_message_id TEXT NOT NULL,
+  ts INTEGER NOT NULL,
+  PRIMARY KEY (session_id, client_message_id)
+) WITHOUT ROWID;
+CREATE TABLE IF NOT EXISTS terminals (
+  id TEXT PRIMARY KEY,
+  cwd TEXT NOT NULL,
+  title TEXT NOT NULL,
+  command TEXT,
+  cols INTEGER NOT NULL,
+  rows INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  active_at INTEGER NOT NULL,
+  exit_code INTEGER,
+  ended INTEGER NOT NULL DEFAULT 0,
+  buffer TEXT NOT NULL DEFAULT ''
+);
+`;
+const PATCH_COLUMNS = {
+    title: "title",
+    preview: "preview",
+    cwd: "cwd",
+    state: "state",
+    driver: "driver",
+    pendingPermissions: "pending_permissions",
+    model: "model",
+    updatedAt: "updated_at",
+    archived: "archived",
+};
+function toSummary(row) {
+    return {
+        id: row.id,
+        agent: row.agent,
+        nativeId: row.native_id,
+        title: row.title ?? undefined,
+        preview: row.preview ?? undefined,
+        cwd: row.cwd,
+        state: row.state,
+        driver: (row.driver ?? undefined),
+        pendingPermissions: row.pending_permissions,
+        model: row.model ?? undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        lastSeq: row.last_seq,
+        archived: row.archived === 1,
+    };
+}
+/**
+ * Durable host state: session summaries plus one append-only event log per
+ * session. Every update a client sees gets a per-session `seq`, so a client
+ * that reconnects asks for "everything after seq N" and gets exactly that.
+ */
+export class HostStore {
+    db;
+    constructor(path) {
+        this.db = new DatabaseSync(path);
+        this.db.exec(SCHEMA);
+    }
+    close() {
+        this.db.close();
+    }
+    // ── terminals ─────────────────────────────────────────────────────
+    saveTerminal(t) {
+        this.db
+            .prepare(`INSERT INTO terminals (id, cwd, title, command, cols, rows, created_at, active_at, exit_code, ended, buffer)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(id) DO UPDATE SET title = excluded.title, cols = excluded.cols, rows = excluded.rows,
+           active_at = excluded.active_at, exit_code = excluded.exit_code, ended = excluded.ended, buffer = excluded.buffer`)
+            .run(t.id, t.cwd, t.title, t.command ?? null, t.cols, t.rows, t.createdAt, t.activeAt, t.exitCode, t.ended ? 1 : 0, t.buffer);
+    }
+    listTerminals() {
+        const rows = this.db.prepare("SELECT * FROM terminals ORDER BY active_at DESC").all();
+        return rows.map((row) => ({
+            id: String(row.id),
+            cwd: String(row.cwd),
+            title: String(row.title),
+            command: row.command ? String(row.command) : undefined,
+            cols: Number(row.cols),
+            rows: Number(row.rows),
+            createdAt: Number(row.created_at),
+            activeAt: Number(row.active_at),
+            exitCode: row.exit_code === null ? null : Number(row.exit_code),
+            ended: Number(row.ended) === 1,
+            buffer: String(row.buffer),
+        }));
+    }
+    deleteTerminal(id) {
+        this.db.prepare("DELETE FROM terminals WHERE id = ?").run(id);
+    }
+    /** Inserts a session, or refreshes discovery fields of an existing one. */
+    upsertSession(input) {
+        const existing = this.getSession(input.id);
+        if (!existing) {
+            this.db
+                .prepare(`INSERT INTO sessions (id, agent, native_id, title, preview, cwd, state, model, created_at, updated_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(input.id, input.agent, input.nativeId, input.title ?? null, input.preview ?? null, input.cwd, input.state ?? "idle", input.model ?? null, input.createdAt, input.updatedAt);
+            return { summary: this.getSession(input.id), created: true };
+        }
+        const patch = {};
+        if (input.title && input.title !== existing.title)
+            patch.title = input.title;
+        if (input.preview && !existing.preview)
+            patch.preview = input.preview;
+        if (input.cwd && input.cwd !== existing.cwd)
+            patch.cwd = input.cwd;
+        if (input.model && input.model !== existing.model)
+            patch.model = input.model;
+        if (input.state && input.state !== existing.state)
+            patch.state = input.state;
+        if (input.updatedAt > existing.updatedAt)
+            patch.updatedAt = input.updatedAt;
+        const summary = Object.keys(patch).length > 0 ? this.patchSession(input.id, patch) : existing;
+        return { summary, created: false };
+    }
+    patchSession(id, patch) {
+        const sets = [];
+        const values = [];
+        for (const [key, value] of Object.entries(patch)) {
+            if (value === undefined)
+                continue;
+            sets.push(`${PATCH_COLUMNS[key]} = ?`);
+            values.push(typeof value === "boolean" ? (value ? 1 : 0) : value);
+        }
+        if (sets.length > 0) {
+            this.db.prepare(`UPDATE sessions SET ${sets.join(", ")} WHERE id = ?`).run(...values, id);
+        }
+        const summary = this.getSession(id);
+        if (!summary)
+            throw new Error(`unknown session ${id}`);
+        return summary;
+    }
+    getSession(id) {
+        const row = this.db.prepare("SELECT * FROM sessions WHERE id = ?").get(id);
+        return row ? toSummary(row) : undefined;
+    }
+    listSessions(options = {}) {
+        const where = [];
+        const values = [];
+        if (!options.includeArchived)
+            where.push("archived = 0");
+        if (options.before !== undefined) {
+            where.push("updated_at < ?");
+            values.push(options.before);
+        }
+        const sql = `SELECT * FROM sessions ${where.length ? `WHERE ${where.join(" AND ")}` : ""}
+      ORDER BY updated_at DESC LIMIT ?`;
+        const rows = this.db.prepare(sql).all(...values, options.limit ?? 50);
+        return rows.map(toSummary);
+    }
+    listProjects(limit = 50) {
+        const rows = this.db
+            .prepare(`SELECT cwd, MAX(updated_at) AS last_active_at, COUNT(*) AS session_count
+         FROM sessions WHERE archived = 0 GROUP BY cwd ORDER BY last_active_at DESC LIMIT ?`)
+            .all(limit);
+        return rows.map((row) => ({
+            cwd: row.cwd,
+            name: basename(row.cwd) || row.cwd,
+            lastActiveAt: row.last_active_at,
+            sessionCount: row.session_count,
+        }));
+    }
+    /** Appends one update to the session's log and returns it with its seq. */
+    appendEvent(sessionId, update, ts = Date.now()) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const row = this.db.prepare("SELECT last_seq FROM sessions WHERE id = ?").get(sessionId);
+            if (!row)
+                throw new Error(`unknown session ${sessionId}`);
+            const seq = row.last_seq + 1;
+            this.db
+                .prepare("INSERT INTO events (session_id, seq, ts, body) VALUES (?, ?, ?, ?)")
+                .run(sessionId, seq, ts, JSON.stringify(update));
+            this.db.prepare("UPDATE sessions SET last_seq = ?, updated_at = MAX(updated_at, ?) WHERE id = ?").run(seq, ts, sessionId);
+            this.db.exec("COMMIT");
+            return { sessionId, seq, ts, update };
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    readEvents(sessionId, afterSeq, limit = 5000) {
+        const rows = this.db
+            .prepare("SELECT seq, ts, body FROM events WHERE session_id = ? AND seq > ? ORDER BY seq ASC LIMIT ?")
+            .all(sessionId, afterSeq, limit);
+        return rows.map((row) => ({ sessionId, seq: row.seq, ts: row.ts, update: JSON.parse(row.body) }));
+    }
+    /** Marks a native item (message, tool call) as present in the log. Returns false if it already was. */
+    markItemLogged(sessionId, itemId) {
+        const result = this.db
+            .prepare("INSERT OR IGNORE INTO logged_items (session_id, item_id) VALUES (?, ?)")
+            .run(sessionId, itemId);
+        return Number(result.changes) > 0;
+    }
+    isItemLogged(sessionId, itemId) {
+        return (this.db.prepare("SELECT 1 FROM logged_items WHERE session_id = ? AND item_id = ?").get(sessionId, itemId) !==
+            undefined);
+    }
+    /** Records a client message id. Returns false when it was already delivered. */
+    claimClientMessage(sessionId, clientMessageId, ts = Date.now()) {
+        const result = this.db
+            .prepare("INSERT OR IGNORE INTO client_messages (session_id, client_message_id, ts) VALUES (?, ?, ?)")
+            .run(sessionId, clientMessageId, ts);
+        return Number(result.changes) > 0;
+    }
+    /** Small per-session values a driver keeps across restarts (e.g. a transcript read offset). */
+    getDriverState(sessionId, key) {
+        const row = this.db.prepare("SELECT value FROM driver_state WHERE session_id = ? AND key = ?").get(sessionId, key);
+        return row?.value;
+    }
+    setDriverState(sessionId, key, value) {
+        this.db
+            .prepare("INSERT INTO driver_state (session_id, key, value) VALUES (?, ?, ?) ON CONFLICT (session_id, key) DO UPDATE SET value = excluded.value")
+            .run(sessionId, key, value);
+    }
+    releaseClientMessage(sessionId, clientMessageId) {
+        this.db
+            .prepare("DELETE FROM client_messages WHERE session_id = ? AND client_message_id = ?")
+            .run(sessionId, clientMessageId);
+    }
+}
+//# sourceMappingURL=store.js.map

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

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

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

@@ -0,0 +1,55 @@
+import { type TerminalInfo } from "@linkshell/wire";
+import type { HostStore } from "./store.js";
+export type OutputListener = (seq: number, data: string) => void;
+export type TerminalChangeListener = (terminal: TerminalInfo, closed?: boolean) => void;
+/**
+ * Live shells plus the history of ended ones. Everything is saved, so after
+ * a shell exits (or the host restarts) its output can still be read, and it
+ * can be run again.
+ */
+export declare class TerminalManager {
+    private readonly env?;
+    private readonly store?;
+    private readonly terminals;
+    /** Ended terminals, as saved. */
+    private readonly history;
+    private readonly timer;
+    private readonly changeListeners;
+    private stopped;
+    /** @param env The user's login-shell environment. */
+    constructor(env?: NodeJS.ProcessEnv | undefined, store?: HostStore | undefined);
+    onChange(listener: TerminalChangeListener): () => void;
+    private emit;
+    private save;
+    list(): TerminalInfo[];
+    create(options: {
+        cwd?: string;
+        command?: string;
+        cols: number;
+        rows: number;
+    }): TerminalInfo;
+    attach(id: string, listener: OutputListener, fromSeq?: number): {
+        replay: string;
+        reset: boolean;
+        seq: number;
+        terminal: {
+            id: string;
+            title: string;
+            cwd: string;
+            createdAt: number;
+            cols: number;
+            rows: number;
+            activeAt: number;
+            command?: string | undefined;
+            exitCode?: number | null | undefined;
+            interrupted?: boolean | undefined;
+        };
+    };
+    detach(id: string, listener: OutputListener): void;
+    input(id: string, data: string): void;
+    resize(id: string, cols: number, rows: number): void;
+    /** Ends a live terminal and forgets it, or deletes an ended one from history. */
+    close(id: string): void;
+    stop(): void;
+    private live;
+}