waterplane 0.0.1 → 0.1.6

package/packages/host/dist/plugins/pluginstreams.js

@@ -0,0 +1,418 @@
+/**
+ * Plugin streams, the host half (`api.stream`, plugin API 1.4; the contract is
+ * `@waterplane/shared`'s `stream.ts`, the reasoning docs/notes/plugins.md, "Streams").
+ *
+ * Two maps and a state machine:
+ * - per plugin, `name → handlers` (what `api.stream` registered while the plugin runs);
+ * - per socket, `streamId → sub` (what that socket opened; ids minted per socket, u16, non-zero);
+ * - per sub, the backpressure state: `needsKey` after any skipped frame, `keyAsked` so the
+ *   producer is asked for a keyframe once per drain, not once per skipped frame.
+ *
+ * Nothing here is durable. A stream is never queued, never in the ack ledger, never retried:
+ * a dead socket ends its subs (`socketGone`), and the phone reopens on reconnect. Binary frames
+ * go only to the socket that opened the stream, so a socket that never sent `stream.open` (an
+ * old APK bundle) never receives one.
+ *
+ * PTY first. One TCP connection carries the terminal and the video, so a frame of video never
+ * stands between a PTY frame and the phone:
+ * - while the socket's PTY is held back (`ptyHeld`: its buffer is past `WS_PTY_BACKLOG_BYTES`,
+ *   or a terminal on it is torn and waiting for its replay while bytes are still queued), EVERY
+ *   stream frame is skipped, a keyframe too. A skipped keyframe is "deferred" the simplest way:
+ *   the sub needs a key, and the producer is asked again for one once the PTY is no longer held
+ *   (on the next frame it offers, or the next `stream.ack`, whichever comes first). No timer, no
+ *   frame held in memory, nothing that can be sent late.
+ * - otherwise a `droppable` frame is skipped while the socket's buffer is past the sub's backlog
+ *   limit (`streamBacklogLimit` of the params' `bitrateKbps`, else the default), and a non-key
+ *   frame is skipped while the sub needs a key.
+ * - a key that ENDS an episode (the sub needs one) waits for the buffer to be back under the line,
+ *   and so does the ASK for it: the producer is asked only once the backlog has drained (on the
+ *   next frame it offers, or the next `stream.ack`). Before, a skip asked at once and the key went
+ *   out past the line regardless, so on a link slower than the bitrate every other frame was an
+ *   IDR into a socket already over its line — the buffer climbed to `WS_PTY_BACKLOG_BYTES`, and
+ *   the PTY was held: late, then torn. Now a recovery key costs one drain, and the buffer stays
+ *   near the line (the line, plus a frame).
+ * - a key in a healthy run (no episode: the producer's own GOP, a re-aim) may go out past the
+ *   line, but not once the buffer is past `STREAM_KEY_OVERSHOOT` × the line: that far behind it
+ *   is skipped, which starts an episode like any skip.
+ * - a frame marked BOTH key and droppable (a still the next still replaces) is droppable first: it
+ *   is skipped like any droppable frame, and when sent it clears the need for a key.
+ */
+import { encodeStreamFrame, jsonBytes, logTag, streamBacklogLimit, STREAM_FLAG_DROPPABLE, STREAM_FLAG_KEY, STREAM_INPUT_MAX, STREAM_MAX_PER_SOCKET, STREAM_NAME_RE, STREAM_PARAMS_MAX, STREAM_PAYLOAD_MAX, STREAM_STATUS_MAX, } from "@waterplane/shared";
+const WS_OPEN = 1;
+/** How far past the backlog line (a factor of it) a key that starts no episode may still go out. */
+export const STREAM_KEY_OVERSHOOT = 2;
+/** What one frame does, given the sub's and the socket's state. Pure; see the header. */
+export function streamFrameAction(f) {
+    if (f.ptyHeld)
+        return "skip";
+    if (f.needsKey && !f.key)
+        return "skip";
+    if (f.buffered > f.limit) {
+        if (f.droppable)
+            return "skip";
+        // A recovery key waits for the drain; a mid-run key may overshoot the line, but not far.
+        if (f.key && (f.needsKey || f.buffered > f.limit * STREAM_KEY_OVERSHOOT))
+            return "skip";
+    }
+    return "send";
+}
+/** Whether the producer may be asked for a key now: the PTY is not held and the socket's buffer is
+ *  back under the line. Asking past the line is what made every other frame an IDR. Pure. */
+export function streamMayAskKey(f) {
+    return !f.ptyHeld && f.buffered <= f.limit;
+}
+/** The backlog line for a sub's params: `bitrateKbps` when it is a positive number, else the default. */
+export function backlogLimitFor(params) {
+    const kbps = params && typeof params === "object" && !Array.isArray(params) ? params.bitrateKbps : undefined;
+    return streamBacklogLimit(typeof kbps === "number" && kbps > 0 ? kbps * 1000 : undefined);
+}
+const msgOf = (e) => (e instanceof Error ? e.message : String(e)).slice(0, 300);
+const bytes = (n) => `${n} bytes`;
+export class PluginStreams {
+    deps;
+    served = new Map();
+    sockets = new Map();
+    serial = 0;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    log(line) { (this.deps.log ?? ((l) => console.log(l)))(`${logTag} stream ${line}`); }
+    now() { return (this.deps.now ?? Date.now)(); }
+    held(ws) {
+        try {
+            return !!this.deps.sink()?.ptyHeld(ws);
+        }
+        catch {
+            return false;
+        }
+    }
+    // ── the plugin side ────────────────────────────────────────────────────────
+    /** `api.stream(name, handlers)`. THROWS a sentence on a bad name or one already served. */
+    serve(pluginId, pluginName, name, handlers) {
+        if (typeof name !== "string" || !STREAM_NAME_RE.test(name)) {
+            throw new Error(`${pluginName}: ${JSON.stringify(name ?? null)} is not a stream name (lower-case letters, digits and dashes, starting with a letter, at most 32)`);
+        }
+        if (!handlers || typeof handlers.open !== "function")
+            throw new Error(`${pluginName}: api.stream("${name}") needs an open handler`);
+        const k = `${pluginId}\0${name}`;
+        if (this.served.has(k))
+            throw new Error(`${pluginName} already serves a stream named "${name}"`);
+        const rec = { pluginId, pluginName, name, handlers };
+        this.served.set(k, rec);
+        return () => {
+            if (this.served.get(k) !== rec)
+                return;
+            this.served.delete(k);
+            this.endWhere((s) => s.served === rec, "plugin", `${pluginName} stopped serving "${name}"`, true);
+        };
+    }
+    /** The plugin was switched off, failed, or unloaded: every name it served goes, and every sub with it. */
+    dropPlugin(pluginId, reason) {
+        for (const [k, s] of this.served)
+            if (s.pluginId === pluginId)
+                this.served.delete(k);
+        this.endWhere((s) => s.served.pluginId === pluginId, "plugin", reason, true);
+    }
+    /** The names a plugin serves right now (tests, diagnostics). */
+    names(pluginId) {
+        return [...this.served.values()].filter((s) => s.pluginId === pluginId).map((s) => s.name);
+    }
+    // ── the socket side ────────────────────────────────────────────────────────
+    /** `stream.open`. Answers `stream.opened` or `stream.refused`; never throws. */
+    async open(ws, msg) {
+        const sink = this.deps.sink();
+        if (typeof msg.reqId !== "string" || !msg.reqId || msg.reqId.length > 128)
+            return; // nothing to address an answer to
+        const reqId = msg.reqId;
+        const plugin = String(msg.plugin ?? ""), name = String(msg.name ?? "");
+        const refuse = (reason) => {
+            this.log(`refused plugin=${plugin} name=${name}: ${reason}`);
+            sink?.sendJson(ws, { t: "stream.refused", reqId, reason });
+        };
+        if (!sink)
+            return refuse("this host cannot send streams");
+        if (ws.readyState !== WS_OPEN)
+            return;
+        const p = this.deps.plugin(plugin);
+        if (!p)
+            return refuse(`no plugin "${plugin}" is installed`);
+        if (p.refusal)
+            return refuse(p.refusal);
+        const served = STREAM_NAME_RE.test(name) ? this.served.get(`${plugin}\0${name}`) : undefined;
+        if (!served)
+            return refuse(`${p.name} serves no stream "${name}"`);
+        const params = msg.params ?? null;
+        const n = jsonBytes(params);
+        if (n < 0)
+            return refuse("the stream's settings are not JSON");
+        if (n > STREAM_PARAMS_MAX)
+            return refuse(`the stream's settings are ${bytes(n)}, over the ${bytes(STREAM_PARAMS_MAX)} they may carry`);
+        const sock = this.socket(ws);
+        if (sock.subs.size >= STREAM_MAX_PER_SOCKET)
+            return refuse(`this connection already has ${STREAM_MAX_PER_SOCKET} streams open; close one first`);
+        const id = this.mint(sock);
+        const sub = this.makeSub(ws, served, id, params);
+        sock.subs.set(id, sub); // reserved now, so two opens in flight count against the cap
+        let refusal = null;
+        let timer;
+        const openMs = this.deps.openMs ?? 10_000;
+        const late = Symbol("late");
+        const run = Promise.resolve().then(() => served.handlers.open(sub.facade, params));
+        try {
+            const r = await Promise.race([run, new Promise((res) => { timer = setTimeout(() => res(late), openMs); })]);
+            if (r === late) {
+                refusal = `${p.name} did not open "${name}" within ${Math.max(1, Math.round(openMs / 1000))} s`;
+                // A late yes still holds whatever the plugin started for it: close it the moment it lands.
+                run.then((v) => { if (typeof v !== "string" || !v.trim())
+                    this.callClose(sub, "error"); }, () => { });
+            }
+            else if (typeof r === "string" && r.trim())
+                refusal = r.trim().slice(0, 300);
+        }
+        catch (err) {
+            refusal = msgOf(err) || `${p.name} refused "${name}"`;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        sub.opening = false;
+        if (refusal !== null) {
+            this.forget(sub);
+            sub.ended = true;
+            if (sub.ws.readyState === WS_OPEN)
+                refuse(refusal);
+            return;
+        }
+        sub.accepted = true;
+        if (sub.ended) {
+            this.callClose(sub, sub.endCause ?? "socket");
+            return;
+        } // ended while opening: the socket died or the plugin stopped
+        this.log(`open plugin=${plugin} name=${name} id=${id}`);
+        sink.sendJson(ws, { t: "stream.opened", reqId, streamId: id, plugin, name });
+        this.maybeAskKey(sub);
+    }
+    /** `stream.params`: replaces the params, then tells the plugin. Unknown id ⇒ ignored. */
+    params(ws, streamId, params) {
+        const sub = this.live(ws, streamId);
+        if (!sub)
+            return;
+        const n = jsonBytes(params ?? null);
+        if (n < 0 || n > STREAM_PARAMS_MAX) {
+            this.log(`params dropped plugin=${sub.served.pluginId} name=${sub.served.name} id=${sub.id}: ${n < 0 ? "not JSON" : bytes(n)}`);
+            return;
+        }
+        sub.params = params ?? null;
+        this.call(sub, "params", () => sub.served.handlers.params?.(sub.facade, sub.params));
+    }
+    /** `stream.input`: one upstream event, at most once (never retried, so never twice). */
+    input(ws, streamId, ev) {
+        const sub = this.live(ws, streamId);
+        if (!sub)
+            return;
+        const n = jsonBytes(ev ?? null);
+        if (n < 0 || n > STREAM_INPUT_MAX) {
+            this.log(`input dropped plugin=${sub.served.pluginId} name=${sub.served.name} id=${sub.id}: ${n < 0 ? "not JSON" : `${n} bytes, over ${STREAM_INPUT_MAX}`}`);
+            return;
+        }
+        this.call(sub, "input", () => sub.served.handlers.input?.(sub.facade, ev ?? null));
+    }
+    /** `stream.keyframe`: the phone needs a decodable frame now. */
+    keyframe(ws, streamId) {
+        const sub = this.live(ws, streamId);
+        if (!sub)
+            return;
+        this.call(sub, "keyframe", () => sub.served.handlers.keyframe?.(sub.facade));
+    }
+    /** `stream.ack`: what the phone has received. Also the tick a deferred keyframe ask rides on. */
+    ack(ws, streamId, seq, rxBytes) {
+        const sub = this.live(ws, streamId);
+        if (!sub)
+            return;
+        if (typeof seq !== "number" || !Number.isFinite(seq) || typeof rxBytes !== "number" || !Number.isFinite(rxBytes) || rxBytes < 0)
+            return;
+        sub.lastAck = { seq: seq >>> 0, rxBytes, at: this.now() };
+        this.call(sub, "ack", () => sub.served.handlers.ack?.(sub.facade));
+        this.maybeAskKey(sub);
+    }
+    /** `stream.close`: the phone is done with it. Nothing is sent back. */
+    close(ws, streamId) {
+        const sub = this.live(ws, streamId);
+        if (sub)
+            this.end(sub, "closed", "closed by the phone", false);
+    }
+    /** The socket closed or was terminated: every sub on it ends, nothing is sent. */
+    socketGone(ws) {
+        const sock = this.sockets.get(ws);
+        if (!sock)
+            return;
+        for (const sub of [...sock.subs.values()])
+            this.end(sub, "socket", "the connection closed", false);
+        this.sockets.delete(ws);
+    }
+    /** Host shutdown: everything ends, nothing is sent (the sockets are going too). */
+    endAll() {
+        for (const ws of [...this.sockets.keys()])
+            this.socketGone(ws);
+    }
+    /** Open subs on a socket (tests, diagnostics). */
+    openOn(ws) { return this.sockets.get(ws)?.subs.size ?? 0; }
+    // ── internals ──────────────────────────────────────────────────────────────
+    socket(ws) {
+        let s = this.sockets.get(ws);
+        if (!s) {
+            s = { nextId: 1, subs: new Map() };
+            this.sockets.set(ws, s);
+        }
+        return s;
+    }
+    /** A u16, non-zero, not in use on this socket. The cap keeps the search short. */
+    mint(sock) {
+        let id = sock.nextId;
+        while (sock.subs.has(id))
+            id = id >= 0xffff ? 1 : id + 1;
+        sock.nextId = id >= 0xffff ? 1 : id + 1;
+        return id;
+    }
+    /** An open (accepted, not ended) sub on THIS socket, or null — a stale id after a reconnect is normal. */
+    live(ws, streamId) {
+        if (typeof streamId !== "number")
+            return null;
+        const sub = this.sockets.get(ws)?.subs.get(streamId);
+        return sub && !sub.ended && !sub.opening ? sub : null;
+    }
+    forget(sub) {
+        const sock = this.sockets.get(sub.ws);
+        if (sock?.subs.get(sub.id) === sub)
+            sock.subs.delete(sub.id);
+    }
+    endWhere(pred, cause, reason, tell) {
+        for (const sock of this.sockets.values())
+            for (const sub of [...sock.subs.values()])
+                if (pred(sub))
+                    this.end(sub, cause, reason, tell);
+    }
+    end(sub, cause, reason, tell) {
+        if (sub.ended)
+            return;
+        sub.ended = true;
+        sub.endCause = cause;
+        this.forget(sub);
+        if (sub.opening)
+            return; // `open` settles it: no `stream.opened`, and `close` only if the plugin said yes
+        this.log(`close plugin=${sub.served.pluginId} name=${sub.served.name} id=${sub.id} cause=${cause}`);
+        if (tell && sub.ws.readyState === WS_OPEN)
+            this.deps.sink()?.sendJson(sub.ws, { t: "stream.ended", streamId: sub.id, cause, reason: String(reason).slice(0, 300) });
+        this.callClose(sub, cause);
+    }
+    callClose(sub, cause) {
+        this.call(sub, "close", () => sub.served.handlers.close?.(sub.facade, cause), true);
+    }
+    /** Run one handler; a throw (or a rejected promise) is the plugin's status line. */
+    call(sub, what, fn, evenEnded = false) {
+        if (sub.ended && !evenEnded)
+            return;
+        const label = `stream "${sub.served.name}" ${what}`;
+        try {
+            const r = fn();
+            if (r && typeof r.then === "function")
+                r.catch((err) => this.deps.failed(sub.served.pluginId, label, err));
+        }
+        catch (err) {
+            this.deps.failed(sub.served.pluginId, label, err);
+        }
+    }
+    /** Ask the producer for a keyframe, once per drain: never while the PTY is held, and never while
+     *  the socket is past the sub's line (the key would be skipped, or pile onto a full pipe). The
+     *  next offered frame and the next `stream.ack` both come back here, so the ask follows the drain. */
+    maybeAskKey(sub) {
+        if (sub.ended || sub.opening || !sub.needsKey || sub.keyAsked)
+            return;
+        if (!streamMayAskKey({ ptyHeld: this.held(sub.ws), buffered: sub.ws.bufferedAmount, limit: backlogLimitFor(sub.params) }))
+            return;
+        sub.keyAsked = true;
+        this.call(sub, "keyframe", () => sub.served.handlers.keyframe?.(sub.facade));
+    }
+    send(sub, payload, o) {
+        if (!(payload instanceof Uint8Array))
+            throw new Error(`${sub.served.pluginName}: sub.send needs a Uint8Array payload`);
+        if (payload.byteLength > STREAM_PAYLOAD_MAX) {
+            throw new Error(`${sub.served.pluginName}: a frame of ${bytes(payload.byteLength)} is over the ${bytes(STREAM_PAYLOAD_MAX)} one frame may carry`);
+        }
+        if (sub.ended)
+            return "ended";
+        const key = !!o?.key, droppable = !!o?.droppable;
+        const flags = (key ? STREAM_FLAG_KEY : 0) | (droppable ? STREAM_FLAG_DROPPABLE : 0);
+        // Before `stream.opened` the phone cannot place a frame: skipped, and a key is asked for once it is open.
+        if (sub.opening) {
+            sub.needsKey = true;
+            sub.keyAsked = false;
+            return "skipped";
+        }
+        if (sub.ws.readyState !== WS_OPEN)
+            return "skipped"; // closing: `socketGone` ends it
+        const ptyHeld = this.held(sub.ws);
+        const action = streamFrameAction({ key, droppable, needsKey: sub.needsKey, ptyHeld, buffered: sub.ws.bufferedAmount, limit: backlogLimitFor(sub.params) });
+        if (action === "skip") {
+            // A key we drop is a key the producer has to send again: the ask is spent, re-made after the drain.
+            if (key || !sub.needsKey) {
+                sub.needsKey = true;
+                sub.keyAsked = false;
+            }
+            this.maybeAskKey(sub);
+            return "skipped";
+        }
+        const seq = sub.seq;
+        const buf = encodeStreamFrame({ streamId: sub.id, seq, kind: o.kind, flags }, payload); // throws on a bad kind
+        try {
+            sub.ws.send(buf, { binary: true, compress: false });
+        }
+        catch (err) {
+            this.end(sub, "error", `the frame could not be sent: ${msgOf(err)}`, false);
+            return "ended";
+        }
+        sub.seq = (seq + 1) >>> 0;
+        sub.sentBytes += payload.byteLength;
+        if (key) {
+            sub.needsKey = false;
+            sub.keyAsked = false;
+        }
+        return "sent";
+    }
+    status(sub, data) {
+        if (sub.ended)
+            return "the stream has ended";
+        if (sub.opening)
+            return "the stream is not open yet";
+        const n = jsonBytes(data ?? null);
+        if (n < 0)
+            return "a stream status must be JSON";
+        if (n > STREAM_STATUS_MAX)
+            return `a status of ${bytes(n)} is over the ${bytes(STREAM_STATUS_MAX)} one may carry`;
+        if (sub.ws.readyState !== WS_OPEN)
+            return "the connection is closing";
+        this.deps.sink()?.sendJson(sub.ws, { t: "stream.status", streamId: sub.id, data: data ?? null });
+        return null;
+    }
+    makeSub(ws, served, id, params) {
+        const self = this;
+        const sub = {
+            id, key: `${served.pluginId}:${++this.serial}`, ws, served, params, seq: 1, sentBytes: 0, lastAck: null,
+            opening: true, accepted: false, ended: false, needsKey: false, keyAsked: false,
+        };
+        // The plugin's view: read-only getters over the state, so nothing a plugin writes moves the machine.
+        sub.facade = Object.freeze({
+            get id() { return sub.id; },
+            get key() { return sub.key; },
+            get params() { return sub.params; },
+            get backlogBytes() { return sub.ws.bufferedAmount; },
+            get sentBytes() { return sub.sentBytes; },
+            get lastAck() { return sub.lastAck ? { ...sub.lastAck } : null; },
+            send: (payload, o) => self.send(sub, payload, o),
+            status: (data) => self.status(sub, data),
+            end: (reason, cause) => self.end(sub, cause === "replaced" ? "replaced" : "plugin", typeof reason === "string" && reason.trim() ? reason : `${served.pluginName} ended the stream`, true),
+        });
+        return sub;
+    }
+}
+//# sourceMappingURL=pluginstreams.js.map

package/packages/host/dist/plugins/pluginstreams.js.map

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

package/packages/host/dist/plugins/plugintoolkit/screen.d.ts

@@ -0,0 +1,9 @@
+export interface ScreenSessions {
+    get(id: string): unknown;
+    liveGrid(id: string): string;
+}
+export interface PluginScreen {
+    rows(lines?: number): string[];
+    squashed(lines?: number): string;
+}
+export declare function screenOf(sessions: ScreenSessions, sessionId: string): PluginScreen | null;

package/packages/host/dist/plugins/plugintoolkit/screen.js

@@ -0,0 +1,21 @@
+/**
+ * `api.screen` — the host's own reading of a session's screen, so a plugin stops copying regexes
+ * over raw bytes: the LIVE grid (`sessions.liveGrid`, the recorder's VT — synchronous, no replay)
+ * as rows, plus `squash` (`echo.ts`: whitespace gone, lower-cased), the form every host match uses.
+ * An unknown session is null. An empty grid is an empty list, which a caller reads as "unknown".
+ */
+import { squash } from "../../echo.js";
+const MAX_LINES = 500;
+export function screenOf(sessions, sessionId) {
+    if (typeof sessionId !== "string" || !sessions.get(sessionId))
+        return null;
+    const rows = (lines = 40) => {
+        const all = sessions.liveGrid(sessionId).replace(/\r/g, "").split("\n").map((r) => r.replace(/\s+$/, ""));
+        while (all.length && all[all.length - 1] === "")
+            all.pop();
+        const n = Math.max(1, Math.min(MAX_LINES, Math.floor(Number(lines)) || 40));
+        return all.slice(-n);
+    };
+    return { rows, squashed: (lines) => squash(rows(lines).join("\n")) };
+}
+//# sourceMappingURL=screen.js.map

package/packages/host/dist/plugins/plugintoolkit/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../../src/plugins/plugintoolkit/screen.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAYvC,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,MAAM,UAAU,QAAQ,CAAC,QAAwB,EAAE,SAAiB;IAClE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,IAAI,GAAG,CAAC,KAAK,GAAG,EAAE,EAAY,EAAE;QACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1G,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;YAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/packages/host/dist/plugins/plugintoolkit/sessionfiles.d.ts

@@ -0,0 +1,6 @@
+export interface FilesSessions {
+    get(id: string): {
+        backend?: string;
+    } | null | undefined;
+}
+export declare function sessionFilesDir(sessions: FilesSessions, stateDir: string, backends: ReadonlySet<string>, hostSessionId: string): string | null;

package/packages/host/dist/plugins/plugintoolkit/sessionfiles.js

@@ -0,0 +1,24 @@
+/**
+ * `api.sessionFiles` — the directory the host wrote a session's launch `files` into
+ * (`<state dir>/launch/<hostSessionId>/`, backend v2 WP3), but only for a session THIS plugin's
+ * backend spawned, and only if it exists. Anything else is null: a plugin never learns another
+ * backend's directory, and an id with a separator never reaches the filesystem.
+ */
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+export function sessionFilesDir(sessions, stateDir, backends, hostSessionId) {
+    if (typeof hostSessionId !== "string" || !/^[A-Za-z0-9._-]+$/.test(hostSessionId) || hostSessionId.includes(".."))
+        return null;
+    const s = sessions.get(hostSessionId);
+    const b = s?.backend;
+    if (!s || !b || !backends.has(b))
+        return null;
+    const dir = join(stateDir, "launch", hostSessionId);
+    try {
+        return existsSync(dir) && statSync(dir).isDirectory() ? dir : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sessionfiles.js.map

package/packages/host/dist/plugins/plugintoolkit/sessionfiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionfiles.js","sourceRoot":"","sources":["../../../src/plugins/plugintoolkit/sessionfiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE,QAAgB,EAAE,QAA6B,EAAE,aAAqB;IAC7H,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/H,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IACpD,IAAI,CAAC;QAAC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AACpG,CAAC"}

package/packages/host/dist/plugins/plugintoolkit/tail.d.ts

@@ -0,0 +1,10 @@
+/** One read window: bounds memory on a huge backlog; the caller loops while `advance()` is true. */
+export declare const TAIL_WINDOW_BYTES: number;
+export interface Tail {
+    advance(): boolean | null;
+    offset(): number;
+    close(): void;
+}
+export declare function tailJsonl(path: string, onLine: (obj: any) => void, opts?: {
+    filter?: (line: string) => boolean;
+}): Tail;

package/packages/host/dist/plugins/plugintoolkit/tail.js

@@ -0,0 +1,110 @@
+/**
+ * `api.tail` — follow a JSONL file a CLI appends to, rotation-safe. One implementation for every
+ * backend plugin (they each copied a `tail.mjs`).
+ *
+ * `advance()` reads at most one 1 MiB window from where it stopped and hands `onLine` each COMPLETE
+ * line that parses as JSON, once. A partial last line is held back until its newline arrives. The
+ * file counts as REPLACED (read again from 0) when its inode changed or it is shorter than the
+ * offset — a truncate-and-regrow is a new file. Unparsable lines are skipped, never thrown.
+ * Returns true when it consumed bytes, false when there was nothing new, null when the file is
+ * absent (unknown, not "no news") or the tail is closed.
+ */
+import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+/** One read window: bounds memory on a huge backlog; the caller loops while `advance()` is true. */
+export const TAIL_WINDOW_BYTES = 1024 * 1024;
+export function tailJsonl(path, onLine, opts = {}) {
+    let off = 0;
+    let ino = null;
+    let closed = false;
+    let skipping = false; // inside a line longer than a whole window: dropped up to its newline
+    const consume = (buf, upTo) => {
+        let start = 0;
+        for (let i = 0; i < upTo; i++) {
+            if (buf[i] !== 0x0a)
+                continue;
+            const line = buf.subarray(start, i).toString("utf8").trim();
+            start = i + 1;
+            if (skipping) {
+                skipping = false;
+                continue;
+            }
+            if (!line)
+                continue;
+            if (opts.filter) {
+                try {
+                    if (!opts.filter(line))
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+            }
+            let obj;
+            try {
+                obj = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            try {
+                onLine(obj);
+            }
+            catch { /* a plugin's handler throwing never stops the follow */ }
+        }
+    };
+    return {
+        advance() {
+            if (closed)
+                return null;
+            let fd;
+            try {
+                fd = openSync(path, "r");
+            }
+            catch {
+                return null;
+            }
+            try {
+                const st = fstatSync(fd);
+                if (ino !== null && st.ino !== ino) {
+                    off = 0;
+                    skipping = false;
+                }
+                ino = st.ino;
+                if (st.size < off) {
+                    off = 0;
+                    skipping = false;
+                }
+                if (st.size === off)
+                    return false;
+                const len = Math.min(TAIL_WINDOW_BYTES, st.size - off);
+                const buf = Buffer.alloc(len);
+                const n = readSync(fd, buf, 0, len, off);
+                if (n <= 0)
+                    return false;
+                const lastNl = buf.subarray(0, n).lastIndexOf(0x0a);
+                if (lastNl < 0) {
+                    if (n < TAIL_WINDOW_BYTES)
+                        return false; // a partial line: wait for its newline
+                    skipping = true;
+                    off += n;
+                    return true; // a line longer than a window is dropped, not stalled on
+                }
+                consume(buf, lastNl + 1);
+                off += lastNl + 1;
+                return true;
+            }
+            catch {
+                return null;
+            }
+            finally {
+                try {
+                    closeSync(fd);
+                }
+                catch { /* */ }
+            }
+        },
+        offset: () => off,
+        close() { closed = true; },
+    };
+}
+//# sourceMappingURL=tail.js.map