@monotykamary/localterm-server 0.0.15

package/dist/session.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from "node:events";
+import type { SpawnPtyInput } from "./types.js";
+interface SessionEvents {
+    output: [data: string];
+    exit: [code: number | null];
+    title: [title: string];
+    cwd: [cwd: string];
+    foreground: [process: string | null];
+}
+export declare class Session extends EventEmitter<SessionEvents> {
+    readonly shell: string;
+    readonly cwd: string;
+    readonly createdAt: number;
+    private readonly pty;
+    private readonly shellName;
+    private currentCols;
+    private currentRows;
+    private exited;
+    private paused;
+    private titlePollTimer;
+    private lastEmittedTitle;
+    private lastEmittedCwd;
+    private lastEmittedForeground;
+    private nextCwdResolveAt;
+    private osc7Detected;
+    constructor(input: SpawnPtyInput);
+    get pid(): number;
+    get shellBaseName(): string;
+    get cols(): number;
+    get rows(): number;
+    get isExited(): boolean;
+    get isPaused(): boolean;
+    write(data: string): void;
+    /**
+     * Stop reading data from the PTY. node-pty buffers further child output in
+     * the OS pipe; once that fills, write() in the child process blocks, which
+     * propagates flow control all the way back to the producing program (e.g.
+     * `cat large_file`). Used by the WS layer to pause heavy output streams
+     * when the outbound socket buffer is filling, so we don't have to kill the
+     * connection just to recover memory.
+     */
+    pause(): void;
+    /**
+     * Reverse of `pause()`. Buffered child output starts flowing again and the
+     * child process unblocks if it was stuck in write().
+     */
+    resume(): void;
+    resize(cols: number, rows: number): void;
+    kill(signal?: NodeJS.Signals): void;
+    dispose(): void;
+    private onPtyOutput;
+    private scheduleTitlePoll;
+    private runTitlePoll;
+    private foregroundProcess;
+    private pollForeground;
+    private computeTitle;
+    private resolveLiveCwd;
+    private stopTitlePolling;
+}
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqB3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,UAAU,aAAa;IACrB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACtC;AAED,qBAAa,OAAQ,SAAQ,YAAY,CAAC,aAAa,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAO;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,qBAAqB,CAAwC;IACrE,OAAO,CAAC,gBAAgB,CAAK;IAI7B,OAAO,CAAC,YAAY,CAAS;gBAEjB,KAAK,EAAE,aAAa;IA8ChC,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAUb;;;OAGG;IACH,MAAM,IAAI,IAAI;IAUd,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAaxC,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAkB,GAAG,IAAI;IAS7C,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;YAQX,YAAY;IA2B1B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;YAMN,cAAc;IAS5B,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/session.js

@@ -0,0 +1,245 @@
+import { EventEmitter } from "node:events";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node-pty";
+import { COLORTERM_VALUE, CWD_RESOLVE_BACKOFF_MS, CWD_RESOLVE_COOLDOWN_MS, DEFAULT_COLS, DEFAULT_ROWS, PTY_ENV_DENYLIST, TERM_TYPE, TITLE_POLL_INTERVAL_MS, } from "./constants.js";
+// Note: titles are emitted on a dedicated `title` event so they travel as a
+// separate WebSocket frame. We deliberately do NOT splice OSC sequences into
+// the PTY output stream — doing so corrupts in-flight escape sequences from
+// modern TUIs (e.g. Cursor Agent / Claude Code use DECSET 2026 synchronized
+// output mode and any byte landing inside that frame breaks the parser state).
+import { ensureSpawnHelperExecutable } from "./ensure-spawn-helper-executable.js";
+import { getDefaultShell } from "./default-shell.js";
+import { formatWorkingDirectoryTitle } from "./utils/format-working-directory-title.js";
+import { parseOsc7FromChunk } from "./utils/parse-osc7.js";
+import { resolveCwdForPid } from "./utils/resolve-cwd-for-pid.js";
+export class Session extends EventEmitter {
+    shell;
+    cwd;
+    createdAt;
+    pty;
+    shellName;
+    currentCols;
+    currentRows;
+    exited = false;
+    paused = false;
+    titlePollTimer = null;
+    lastEmittedTitle = "";
+    lastEmittedCwd = "";
+    lastEmittedForeground = undefined;
+    nextCwdResolveAt = 0;
+    // Set to true once OSC 7 is observed from the PTY output. Once the shell
+    // advertises its working directory via OSC 7 we stop polling lsof entirely —
+    // the stream is the source of truth and lsof is just an expensive fallback.
+    osc7Detected = false;
+    constructor(input) {
+        super();
+        ensureSpawnHelperExecutable();
+        this.shell = input.shell ?? getDefaultShell();
+        this.shellName = path.basename(this.shell);
+        this.cwd = input.cwd ?? os.homedir();
+        this.currentCols = input.cols ?? DEFAULT_COLS;
+        this.currentRows = input.rows ?? DEFAULT_ROWS;
+        this.createdAt = Date.now();
+        const env = {};
+        const denied = new Set(PTY_ENV_DENYLIST);
+        for (const [key, value] of Object.entries(process.env)) {
+            if (denied.has(key))
+                continue;
+            if (typeof value === "string")
+                env[key] = value;
+        }
+        if (input.env) {
+            for (const [key, value] of Object.entries(input.env)) {
+                env[key] = value;
+            }
+        }
+        env.TERM = TERM_TYPE;
+        env.COLORTERM = COLORTERM_VALUE;
+        this.pty = spawn(this.shell, [], {
+            name: TERM_TYPE,
+            cols: this.currentCols,
+            rows: this.currentRows,
+            cwd: this.cwd,
+            env,
+        });
+        this.pty.onData((data) => {
+            this.onPtyOutput(data);
+            this.emit("output", data);
+        });
+        this.pty.onExit(({ exitCode }) => {
+            this.exited = true;
+            this.stopTitlePolling();
+            this.emit("exit", exitCode);
+        });
+        this.scheduleTitlePoll(0);
+    }
+    get pid() {
+        return this.pty.pid;
+    }
+    get shellBaseName() {
+        return this.shellName;
+    }
+    get cols() {
+        return this.currentCols;
+    }
+    get rows() {
+        return this.currentRows;
+    }
+    get isExited() {
+        return this.exited;
+    }
+    get isPaused() {
+        return this.paused;
+    }
+    write(data) {
+        if (this.exited)
+            return;
+        this.pty.write(data);
+    }
+    /**
+     * Stop reading data from the PTY. node-pty buffers further child output in
+     * the OS pipe; once that fills, write() in the child process blocks, which
+     * propagates flow control all the way back to the producing program (e.g.
+     * `cat large_file`). Used by the WS layer to pause heavy output streams
+     * when the outbound socket buffer is filling, so we don't have to kill the
+     * connection just to recover memory.
+     */
+    pause() {
+        if (this.exited || this.paused)
+            return;
+        this.paused = true;
+        try {
+            this.pty.pause();
+        }
+        catch {
+            /* PTY may have died between the exited check and the call */
+        }
+    }
+    /**
+     * Reverse of `pause()`. Buffered child output starts flowing again and the
+     * child process unblocks if it was stuck in write().
+     */
+    resume() {
+        if (this.exited || !this.paused)
+            return;
+        this.paused = false;
+        try {
+            this.pty.resume();
+        }
+        catch {
+            /* see pause() */
+        }
+    }
+    resize(cols, rows) {
+        if (this.exited)
+            return;
+        if (cols <= 0 || rows <= 0)
+            return;
+        if (cols === this.currentCols && rows === this.currentRows)
+            return;
+        this.currentCols = cols;
+        this.currentRows = rows;
+        try {
+            this.pty.resize(cols, rows);
+        }
+        catch {
+            /* PTY may have died between checks */
+        }
+    }
+    kill(signal = "SIGHUP") {
+        if (this.exited)
+            return;
+        try {
+            this.pty.kill(signal);
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    dispose() {
+        this.kill();
+        this.exited = true;
+        this.stopTitlePolling();
+        this.removeAllListeners();
+    }
+    onPtyOutput(data) {
+        const osc7Path = parseOsc7FromChunk(data);
+        if (osc7Path) {
+            this.osc7Detected = true;
+            if (osc7Path !== this.lastEmittedCwd) {
+                this.lastEmittedCwd = osc7Path;
+                this.emit("cwd", osc7Path);
+            }
+        }
+    }
+    scheduleTitlePoll(delayMs) {
+        if (this.exited)
+            return;
+        this.titlePollTimer = setTimeout(() => {
+            void this.runTitlePoll();
+        }, delayMs);
+        this.titlePollTimer.unref();
+    }
+    async runTitlePoll() {
+        if (this.exited)
+            return;
+        try {
+            // Once the shell advertises its CWD via OSC 7 we skip lsof — the stream
+            // is authoritative and lsof is expensive (spawns a child process that
+            // triggers syspolicyd validation on every call).
+            const liveCwd = this.osc7Detected ? this.lastEmittedCwd || null : await this.resolveLiveCwd();
+            if (this.exited)
+                return;
+            if (!this.osc7Detected && liveCwd && liveCwd !== this.lastEmittedCwd) {
+                this.lastEmittedCwd = liveCwd;
+                this.emit("cwd", liveCwd);
+            }
+            const nextTitle = this.computeTitle(this.osc7Detected ? this.lastEmittedCwd || this.cwd : (liveCwd ?? this.cwd));
+            if (nextTitle && nextTitle !== this.lastEmittedTitle) {
+                this.lastEmittedTitle = nextTitle;
+                this.emit("title", nextTitle);
+            }
+            this.pollForeground();
+        }
+        catch {
+            /* polling errors are non-fatal; the next tick will retry */
+        }
+        finally {
+            this.scheduleTitlePoll(TITLE_POLL_INTERVAL_MS);
+        }
+    }
+    foregroundProcess() {
+        const raw = this.pty.process?.trim() ?? "";
+        return raw && raw !== this.shellName ? raw : null;
+    }
+    pollForeground() {
+        const next = this.foregroundProcess();
+        if (next === this.lastEmittedForeground)
+            return;
+        this.lastEmittedForeground = next;
+        this.emit("foreground", next);
+    }
+    computeTitle(liveCwd) {
+        const foreground = this.foregroundProcess();
+        if (foreground)
+            return foreground;
+        return formatWorkingDirectoryTitle(liveCwd);
+    }
+    async resolveLiveCwd() {
+        const now = Date.now();
+        if (now < this.nextCwdResolveAt)
+            return null;
+        const liveCwd = await resolveCwdForPid(this.pid).catch(() => null);
+        this.nextCwdResolveAt =
+            now + (liveCwd === null ? CWD_RESOLVE_BACKOFF_MS : CWD_RESOLVE_COOLDOWN_MS);
+        return liveCwd;
+    }
+    stopTitlePolling() {
+        if (this.titlePollTimer === null)
+            return;
+        clearTimeout(this.titlePollTimer);
+        this.titlePollTimer = null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/static-resolver.d.ts

@@ -0,0 +1,7 @@
+export interface StaticAsset {
+    body: Buffer;
+    contentType: string;
+    status: number;
+}
+export declare const resolveStaticAsset: (root: string, urlPath: string) => StaticAsset | null;
+//# sourceMappingURL=static-resolver.d.ts.map

package/dist/static-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-resolver.d.ts","sourceRoot":"","sources":["../src/static-resolver.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAkBD,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,WAAW,GAAG,IAqBhF,CAAC"}

package/dist/static-resolver.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+const MIME = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".ico": "image/x-icon",
+    ".json": "application/json; charset=utf-8",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".map": "application/json; charset=utf-8",
+};
+const isContained = (root, resolved) => {
+    const relative = path.relative(root, resolved);
+    return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
+};
+const readFile = (target) => {
+    if (!existsSync(target))
+        return null;
+    if (!statSync(target).isFile())
+        return null;
+    const ext = path.extname(target).toLowerCase();
+    return {
+        body: readFileSync(target),
+        contentType: MIME[ext] ?? "application/octet-stream",
+        status: 200,
+    };
+};
+export const resolveStaticAsset = (root, urlPath) => {
+    const normalizedRoot = path.resolve(root);
+    let decoded;
+    try {
+        decoded = decodeURIComponent(urlPath.split("?", 1)[0] ?? "/");
+    }
+    catch {
+        return null;
+    }
+    const trimmed = decoded.replace(/^[/\\]+/, "");
+    const resolvedExact = path.resolve(normalizedRoot, trimmed);
+    if (isContained(normalizedRoot, resolvedExact)) {
+        const direct = readFile(resolvedExact);
+        if (direct)
+            return direct;
+        const indexed = readFile(path.join(resolvedExact, "index.html"));
+        if (indexed)
+            return indexed;
+    }
+    const hasFileExtension = /\.[a-z0-9]+$/i.test(trimmed);
+    if (hasFileExtension)
+        return null;
+    const fallback = readFile(path.join(normalizedRoot, "index.html"));
+    if (!fallback)
+        return null;
+    return { ...fallback, status: 200 };
+};
+//# sourceMappingURL=static-resolver.js.map

package/dist/static-resolver.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+import type { z } from "zod";
+import type { clientToServerMessageSchema, serverToClientMessageSchema } from "./schemas.js";
+export interface SpawnPtyInput {
+    cols?: number;
+    rows?: number;
+    shell?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export type ClientToServerMessage = z.infer<typeof clientToServerMessageSchema>;
+export type ServerToClientMessage = z.infer<typeof serverToClientMessageSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/format-working-directory-title.d.ts

@@ -0,0 +1,2 @@
+export declare const formatWorkingDirectoryTitle: (cwd: string, home?: string) => string;
+//# sourceMappingURL=format-working-directory-title.d.ts.map

package/dist/utils/format-working-directory-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-working-directory-title.d.ts","sourceRoot":"","sources":["../../src/utils/format-working-directory-title.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,2BAA2B,GAAI,KAAK,MAAM,EAAE,aAA4B,KAAG,MAQvF,CAAC"}

package/dist/utils/format-working-directory-title.js

@@ -0,0 +1,28 @@
+import os from "node:os";
+import path from "node:path";
+import { TITLE_MAX_PATH_SEGMENTS, TITLE_TRUNCATION_PREFIX } from "../constants.js";
+const HOME_PREFIX = "~";
+const PATH_SEPARATOR = "/";
+const CACHED_HOME_DIRECTORY = os.homedir();
+const abbreviateHome = (cwd, home) => {
+    const normalizedCwd = path.resolve(cwd);
+    const normalizedHome = path.resolve(home);
+    if (normalizedCwd === normalizedHome)
+        return HOME_PREFIX;
+    if (normalizedCwd.startsWith(`${normalizedHome}${PATH_SEPARATOR}`)) {
+        return `${HOME_PREFIX}${normalizedCwd.slice(normalizedHome.length)}`;
+    }
+    return normalizedCwd;
+};
+export const formatWorkingDirectoryTitle = (cwd, home = CACHED_HOME_DIRECTORY) => {
+    if (!cwd)
+        return cwd;
+    const abbreviated = abbreviateHome(cwd, home);
+    const segments = abbreviated.split(PATH_SEPARATOR).filter(Boolean);
+    if (segments.length <= TITLE_MAX_PATH_SEGMENTS)
+        return abbreviated;
+    return `${TITLE_TRUNCATION_PREFIX}${PATH_SEPARATOR}${segments
+        .slice(-TITLE_MAX_PATH_SEGMENTS)
+        .join(PATH_SEPARATOR)}`;
+};
+//# sourceMappingURL=format-working-directory-title.js.map

package/dist/utils/format-working-directory-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-working-directory-title.js","sourceRoot":"","sources":["../../src/utils/format-working-directory-title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,qBAAqB,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AAE3C,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,IAAY,EAAU,EAAE;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,aAAa,KAAK,cAAc;QAAE,OAAO,WAAW,CAAC;IACzD,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC,EAAE,CAAC;QACnE,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAW,EAAE,IAAI,GAAG,qBAAqB,EAAU,EAAE;IAC/F,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,IAAI,uBAAuB;QAAE,OAAO,WAAW,CAAC;IACnE,OAAO,GAAG,uBAAuB,GAAG,cAAc,GAAG,QAAQ;SAC1D,KAAK,CAAC,CAAC,uBAAuB,CAAC;SAC/B,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;AAC5B,CAAC,CAAC"}

package/dist/utils/parse-osc7.d.ts

@@ -0,0 +1,2 @@
+export declare const parseOsc7FromChunk: (data: string) => string | null;
+//# sourceMappingURL=parse-osc7.d.ts.map

package/dist/utils/parse-osc7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-osc7.d.ts","sourceRoot":"","sources":["../../src/utils/parse-osc7.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IA6B1D,CAAC"}

package/dist/utils/parse-osc7.js

@@ -0,0 +1,50 @@
+// OSC 7 (Set Working Directory) format:
+//   ESC ] 7 ; file://HOST/PATH ST
+// where ST is either BEL (0x07) or ESC \ (0x1b 0x5c).
+// The path is URL-encoded (spaces = %20, etc.).
+//
+// This parser scans a chunk of PTY output for the last OSC 7 in that chunk,
+// returning the decoded filesystem path (or null if none found).
+// It is deliberately simple: we only care about the *most recent* OSC 7,
+// and the sequences are short enough that they won't span huge buffers.
+const OSC7_PREFIX = "\x1b]7;";
+const BEL = "\x07";
+const ST = "\x1b\\";
+const extractPath = (url) => {
+    try {
+        const parsed = new URL(url);
+        return decodeURIComponent(parsed.pathname);
+    }
+    catch {
+        return null;
+    }
+};
+export const parseOsc7FromChunk = (data) => {
+    let searchFrom = 0;
+    let lastResult = null;
+    while (searchFrom < data.length) {
+        const start = data.indexOf(OSC7_PREFIX, searchFrom);
+        if (start === -1)
+            break;
+        const payloadStart = start + OSC7_PREFIX.length;
+        const belIndex = data.indexOf(BEL, payloadStart);
+        const stIndex = data.indexOf(ST, payloadStart);
+        let payloadEnd;
+        if (belIndex !== -1 && (stIndex === -1 || belIndex < stIndex)) {
+            payloadEnd = belIndex;
+        }
+        else if (stIndex !== -1) {
+            payloadEnd = stIndex;
+        }
+        else {
+            break;
+        }
+        const payload = data.slice(payloadStart, payloadEnd);
+        const path = extractPath(payload);
+        if (path)
+            lastResult = path;
+        searchFrom = payloadEnd + 1;
+    }
+    return lastResult;
+};
+//# sourceMappingURL=parse-osc7.js.map

package/dist/utils/parse-osc7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-osc7.js","sourceRoot":"","sources":["../../src/utils/parse-osc7.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,kCAAkC;AAClC,sDAAsD;AACtD,gDAAgD;AAChD,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,GAAG,GAAG,MAAM,CAAC;AACnB,MAAM,EAAE,GAAG,QAAQ,CAAC;AAEpB,MAAM,WAAW,GAAG,CAAC,GAAW,EAAiB,EAAE;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAiB,EAAE;IAChE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAkB,IAAI,CAAC;IAErC,OAAO,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,MAAM;QAExB,MAAM,YAAY,GAAG,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAE/C,IAAI,UAAkB,CAAC;QACvB,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;YAC9D,UAAU,GAAG,QAAQ,CAAC;QACxB,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,UAAU,GAAG,OAAO,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,IAAI;YAAE,UAAU,GAAG,IAAI,CAAC;QAE5B,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC"}

package/dist/utils/resolve-cwd-for-pid.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveCwdForPid: (pid: number) => Promise<string | null>;
+//# sourceMappingURL=resolve-cwd-for-pid.d.ts.map

package/dist/utils/resolve-cwd-for-pid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cwd-for-pid.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-cwd-for-pid.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAuBzE,CAAC"}

package/dist/utils/resolve-cwd-for-pid.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { readlink } from "node:fs/promises";
+import { promisify } from "node:util";
+import { CWD_RESOLVE_TIMEOUT_MS } from "../constants.js";
+const execFileAsync = promisify(execFile);
+export const resolveCwdForPid = async (pid) => {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return null;
+    if (process.platform === "linux") {
+        try {
+            return await readlink(`/proc/${pid}/cwd`);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (process.platform === "darwin") {
+        try {
+            const { stdout } = await execFileAsync("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], { timeout: CWD_RESOLVE_TIMEOUT_MS, windowsHide: true });
+            const cwdLine = stdout.split("\n").find((line) => line.startsWith("n"));
+            return cwdLine ? cwdLine.slice(1) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+};
+//# sourceMappingURL=resolve-cwd-for-pid.js.map

package/dist/utils/resolve-cwd-for-pid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cwd-for-pid.js","sourceRoot":"","sources":["../../src/utils/resolve-cwd-for-pid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAA0B,EAAE;IAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,MAAM,EACN,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAC7C,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,IAAI,EAAE,CACvD,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@monotykamary/localterm-server",
+  "version": "0.0.15",
+  "description": "PTY-backed HTTP/WebSocket server that powers localterm, built on Hono + node-pty.",
+  "keywords": [
+    "hono",
+    "localterm",
+    "node-pty",
+    "pty",
+    "terminal",
+    "websocket"
+  ],
+  "homepage": "https://github.com/aidenybai/localterm#readme",
+  "bugs": {
+    "url": "https://github.com/aidenybai/localterm/issues"
+  },
+  "license": "MIT",
+  "author": "Aiden Bai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aidenybai/localterm.git",
+    "directory": "packages/server"
+  },
+  "files": [
+    "dist"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.14.0",
+    "@hono/node-ws": "^1.1.1",
+    "hono": "^4.6.13",
+    "node-pty": "^1.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vite-plus": "^0.1.12"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vp test --run",
+    "typecheck": "tsc --noEmit"
+  }
+}