@co0ontty/wand 4.36.0 → 4.37.0

package/dist/pty-terminal-state.js

@@ -0,0 +1,93 @@
+import headless from "@xterm/headless";
+import { SerializeAddon } from "@xterm/addon-serialize";
+import { Unicode11Addon } from "@xterm/addon-unicode11";
+const { Terminal } = headless;
+/**
+ * Server-side xterm screen model used only for reconnect snapshots. Live PTY
+ * bytes still travel unchanged from node-pty to the browser terminal.
+ */
+export class PtyTerminalState {
+    terminal;
+    serializer = new SerializeAddon();
+    unicode = new Unicode11Addon();
+    pending = [];
+    tail = Promise.resolve();
+    checkpointTimer;
+    nextId = 1;
+    committedData = "";
+    committedCols;
+    committedRows;
+    disposed = false;
+    constructor(cols, rows, initialData = "") {
+        this.committedCols = cols;
+        this.committedRows = rows;
+        this.terminal = new Terminal({ cols, rows, allowProposedApi: true, scrollback: 5000 });
+        this.terminal.loadAddon(this.serializer);
+        this.terminal.loadAddon(this.unicode);
+        this.terminal.unicode.activeVersion = "11";
+        if (initialData)
+            this.write(initialData);
+    }
+    write(data) {
+        if (this.disposed || !data)
+            return;
+        const pending = this.addPending({ type: "data", data });
+        this.tail = this.tail.then(() => new Promise((resolve) => {
+            if (this.disposed)
+                return resolve();
+            this.terminal.write(data, () => resolve());
+        }));
+        this.scheduleCheckpoint(pending.id);
+    }
+    resize(cols, rows) {
+        if (this.disposed)
+            return;
+        const pending = this.addPending({ type: "resize", cols, rows });
+        this.tail = this.tail.then(() => {
+            if (!this.disposed)
+                this.terminal.resize(cols, rows);
+        });
+        this.scheduleCheckpoint(pending.id);
+    }
+    snapshot() {
+        return {
+            version: 1,
+            data: this.committedData,
+            cols: this.committedCols,
+            rows: this.committedRows,
+            pending: this.pending.map(({ operation }) => ({ ...operation })),
+        };
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.checkpointTimer)
+            clearTimeout(this.checkpointTimer);
+        this.checkpointTimer = undefined;
+        this.pending = [];
+        this.terminal.dispose();
+    }
+    addPending(operation) {
+        const pending = { id: this.nextId++, operation };
+        this.pending.push(pending);
+        return pending;
+    }
+    scheduleCheckpoint(_operationId) {
+        if (this.checkpointTimer || this.disposed)
+            return;
+        this.checkpointTimer = setTimeout(() => {
+            this.checkpointTimer = undefined;
+            const cutoff = this.pending.at(-1)?.id ?? 0;
+            this.tail = this.tail.then(() => {
+                if (this.disposed)
+                    return;
+                this.committedData = this.serializer.serialize({ scrollback: 5000 });
+                this.committedCols = this.terminal.cols;
+                this.committedRows = this.terminal.rows;
+                this.pending = this.pending.filter((entry) => entry.id > cutoff);
+            });
+        }, 100);
+        this.checkpointTimer.unref?.();
+    }
+}

package/dist/server.js

@@ -551,8 +551,8 @@ export async function startServer(config, configPath, options = {}) {
         res.setHeader("Cache-Control", "public, max-age=604800, immutable");
         res.type(asset.contentType).send(asset.content);
     };
-    app.get("/vendor/wterm/wterm.bundle.js", (req, res) => sendEmbeddedVendorAsset("/vendor/wterm/wterm.bundle.js", req, res));
-    app.get("/vendor/wterm/terminal.css", (req, res) => sendEmbeddedVendorAsset("/vendor/wterm/terminal.css", req, res));
+    app.get("/vendor/xterm/xterm.bundle.js", (req, res) => sendEmbeddedVendorAsset("/vendor/xterm/xterm.bundle.js", req, res));
+    app.get("/vendor/xterm/xterm.css", (req, res) => sendEmbeddedVendorAsset("/vendor/xterm/xterm.css", req, res));
     app.get("/vendor/qrcode/qrcode.bundle.js", (req, res) => sendEmbeddedVendorAsset("/vendor/qrcode/qrcode.bundle.js", req, res));
     // ── Web UI endpoints ──
     app.get("/", (_req, res) => {
@@ -1088,7 +1088,18 @@ export async function startServer(config, configPath, options = {}) {
         },
     });
     const wsManager = new WsBroadcastManager(wss, () => config.cardDefaults ?? {}, useHttps, authService);
-    wsManager.setup((id) => sessionRegistry.get(id));
+    wsManager.setup({
+        getSession: (id) => sessionRegistry.get(id),
+        getTerminalState: (id) => processes.getTerminalState(id),
+        sendPtyInput: (id, input, shortcutKey, userInput) => {
+            processes.sendInput(id, input, "terminal", shortcutKey, userInput);
+        },
+        resizePty: (id, cols, rows) => {
+            processes.resize(id, cols, rows);
+        },
+        pausePtyOutput: (id) => processes.pauseOutput(id),
+        resumePtyOutput: (id) => processes.resumeOutput(id),
+    });
     disconnectAuthenticatedSockets = () => wsManager.disconnectAll();
     wss.on("error", (err) => {
         if (err.code === "EADDRINUSE")

package/dist/session-transport.js

@@ -22,6 +22,8 @@ function sessionBase(snapshot) {
         automationId: snapshot.automationId,
         sessionKind: snapshot.sessionKind,
         provider: snapshot.provider,
+        providerCliActive: snapshot.providerCliActive,
+        providerCliExitCode: snapshot.providerCliExitCode,
         runner: snapshot.runner,
         command: snapshot.command,
         cwd: snapshot.cwd,

package/dist/types.d.ts

@@ -492,6 +492,10 @@ export interface SessionSnapshot {
     automationId?: string;
     sessionKind?: SessionKind;
     provider?: SessionProvider;
+    /** True while the provider CLI owns the PTY; false after it returns to the persistent shell. */
+    providerCliActive?: boolean;
+    /** Provider CLI exit status; separate from exitCode, which belongs to the persistent PTY shell. */
+    providerCliExitCode?: number | null;
     runner?: SessionRunner;
     command: string;
     cwd: string;