@jini-ai/platform 0.1.0

package/dist/terminal.js

@@ -0,0 +1,398 @@
+/**
+ * @module terminal
+ *
+ * In-memory interactive terminal (PTY) session manager. Each session keeps
+ * a bounded event ring-buffer so a reattaching client can replay recent
+ * scrollback after a last-seen event id, then fans out live output to every
+ * attached sink. Sessions are process-local and never persisted — shutting
+ * the host down kills every PTY (see {@link TerminalService.shutdownActive}).
+ *
+ * Generalized from OD's `apps/daemon/src/terminals.ts`: the origin imported
+ * `node-pty` directly and coupled `stream()` to an Express `req`/`res` pair.
+ * Both couplings are real ports here instead — {@link PtySpawn} (the caller
+ * supplies node-pty, or any PTY backend, or a fake for tests) and
+ * {@link TerminalSseSink} (a minimal push/end sink; no Express/HTTP types
+ * enter this package). This keeps the module transport- and PTY-backend-
+ * agnostic, which matters beyond OD: Zana and Open-Marketing both
+ * independently need a terminal/PTY port, so this shape is designed to be
+ * the shared foundation rather than scoped narrowly to one daemon's routes.
+ */
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import os from 'node:os';
+import path from 'node:path';
+const require = createRequire(import.meta.url);
+/**
+ * Resolves the candidate paths to node-pty's `spawn-helper` binary. On
+ * macOS/Linux, `pty.fork` shells out to this helper via `posix_spawn`;
+ * node-pty looks for the native artifacts under `build/Release` first and a
+ * platform-tagged `prebuilds/<platform>-<arch>` dir second. Returns both so
+ * {@link ensureSpawnHelperExecutable} covers whichever one a given install
+ * produced. Empty on win32 (ConPTY has no helper) or when node-pty can't be
+ * resolved at all (not installed, or a workspace that doesn't use it).
+ *
+ * @param options.platform - Defaults to `process.platform`; injectable for tests.
+ * @param options.resolve - Defaults to a `require.resolve`-shaped resolver for
+ *   `'node-pty'`; injectable so this stays testable without the native module.
+ */
+export function spawnHelperCandidatePaths(options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform === 'win32')
+        return [];
+    const resolve = options.resolve ?? resolveNodePtyEntryPoint;
+    let pkgRoot;
+    try {
+        // node-pty's "main" is `lib/index.js`, so the package root is two levels
+        // up from the resolved entry.
+        pkgRoot = path.dirname(path.dirname(resolve('node-pty')));
+    }
+    catch {
+        return [];
+    }
+    return [
+        path.join(pkgRoot, 'build', 'Release', 'spawn-helper'),
+        path.join(pkgRoot, 'prebuilds', `${platform}-${process.arch}`, 'spawn-helper'),
+    ];
+}
+function resolveNodePtyEntryPoint(specifier) {
+    // A runtime `require.resolve` call (not a static `import`) avoids a
+    // module specifier TypeScript would try to resolve at compile time —
+    // node-pty is an optional peer a consumer brings, not a dependency of
+    // this package.
+    return require.resolve(specifier);
+}
+/**
+ * Restores the executable bit on node-pty's `spawn-helper`. pnpm unpacks
+ * node-pty's prebuilt binaries with mode 0644 — and node-pty's own
+ * post-install hook only chmods `build/Release`, which a prebuild-based
+ * install never creates. Re-adding +x before the first fork makes the
+ * terminal self-heal across reinstalls without depending on an install hook.
+ * Best-effort and idempotent: a missing file or a read-only filesystem is
+ * swallowed, and the subsequent spawn surfaces the real error instead.
+ *
+ * @param candidatePaths - Defaults to {@link spawnHelperCandidatePaths}'s result.
+ */
+export function ensureSpawnHelperExecutable(candidatePaths = spawnHelperCandidatePaths()) {
+    for (const file of candidatePaths) {
+        try {
+            const stat = fs.statSync(file);
+            if (stat.mode & 0o100)
+                continue;
+            fs.chmodSync(file, stat.mode | 0o111);
+        }
+        catch {
+            // Candidate not present on this install, or fs is read-only: ignore and
+            // let the spawn attempt report the underlying failure.
+        }
+    }
+}
+/**
+ * Resolves the shell binary for a new PTY. Honors an explicit request
+ * override, then the user's environment (`SHELL` on posix, `ComSpec` on
+ * win32), and finally a per-platform default.
+ */
+export function resolveShell(requested, options = {}) {
+    const explicit = typeof requested === 'string' && requested.trim() ? requested.trim() : null;
+    if (explicit)
+        return explicit;
+    const platform = options.platform ?? process.platform;
+    const env = options.env ?? process.env;
+    if (platform === 'win32') {
+        return env.ComSpec || 'powershell.exe';
+    }
+    return env.SHELL || '/bin/bash';
+}
+function clampDimension(value, fallback) {
+    const n = Number(value);
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(Math.max(Math.trunc(n), 1), 1000);
+}
+const TERMINAL_STATUSES = new Set(['exited']);
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+function toPublicSession(session) {
+    return {
+        id: session.id,
+        projectId: session.projectId,
+        cwd: session.cwd,
+        shell: session.shell,
+        cols: session.cols,
+        rows: session.rows,
+        status: session.status,
+        createdAt: session.createdAt,
+        updatedAt: session.updatedAt,
+        exitCode: session.exitCode,
+        signal: session.signal,
+    };
+}
+/**
+ * Builds an in-memory terminal session manager. See the module docblock for
+ * the design rationale; see {@link CreateTerminalServiceOptions} for tuning.
+ */
+export function createTerminalService(options) {
+    const { loadSpawnPty, maxEvents = 2_000, maxBufferBytes = 512 * 1024, exitTailBytes = 64 * 1024, flushIntervalMs = 16, flushThresholdBytes = 64 * 1024, ttlMs = 30 * 60 * 1000, shutdownGraceMs = 3_000, } = options;
+    const sessions = new Map();
+    let cachedSpawnPty = null;
+    const loadPty = async () => {
+        if (!cachedSpawnPty)
+            cachedSpawnPty = await loadSpawnPty();
+        return cachedSpawnPty;
+    };
+    const scheduleCleanup = (session) => {
+        setTimeout(() => {
+            if (TERMINAL_STATUSES.has(session.status))
+                sessions.delete(session.id);
+        }, ttlMs).unref?.();
+    };
+    const recordByteLength = (data) => ('data' in data ? data.data.length : 0);
+    const trimBuffer = (session) => {
+        if (session.bufferedBytes <= maxBufferBytes && session.events.length <= maxEvents)
+            return;
+        const targetBytes = Math.floor(maxBufferBytes * 0.75);
+        let dropCount = 0;
+        let freed = 0;
+        for (let i = 0; i < session.events.length - 1; i++) {
+            const overBytes = session.bufferedBytes - freed > targetBytes;
+            const overCount = session.events.length - dropCount > maxEvents;
+            if (!overBytes && !overCount)
+                break;
+            freed += session.events[i].byteLength;
+            dropCount++;
+        }
+        if (dropCount > 0) {
+            session.events.splice(0, dropCount);
+            session.bufferedBytes -= freed;
+        }
+    };
+    const emit = (session, event, data) => {
+        const id = session.nextEventId++;
+        const byteLength = recordByteLength(data);
+        const record = { id, event, data, timestamp: Date.now(), byteLength };
+        session.events.push(record);
+        session.bufferedBytes += byteLength;
+        trimBuffer(session);
+        session.updatedAt = record.timestamp;
+        for (const sink of session.clients)
+            sink.send(event, data, id);
+        return record;
+    };
+    const flushData = (session) => {
+        if (session.flushTimer != null) {
+            clearTimeout(session.flushTimer);
+            session.flushTimer = null;
+        }
+        if (!session.pendingData)
+            return;
+        const chunk = session.pendingData;
+        session.pendingData = '';
+        emit(session, 'data', { data: chunk });
+    };
+    const finish = (session, code, signal) => {
+        if (TERMINAL_STATUSES.has(session.status))
+            return;
+        flushData(session);
+        session.status = 'exited';
+        session.exitCode = code;
+        session.signal = signal;
+        session.updatedAt = Date.now();
+        emit(session, 'exit', { code, signal });
+        // Bound the memory an exited-but-not-yet-reaped session pins: keep only
+        // the trailing scrollback (the exit event is last, so it's always kept).
+        let keptBytes = 0;
+        let firstKeep = session.events.length;
+        for (let i = session.events.length - 1; i >= 0; i--) {
+            firstKeep = i;
+            keptBytes += session.events[i].byteLength;
+            if (keptBytes >= exitTailBytes)
+                break;
+        }
+        if (firstKeep > 0) {
+            const dropped = session.events.splice(0, firstKeep);
+            for (const r of dropped)
+                session.bufferedBytes -= r.byteLength;
+        }
+        for (const sink of session.clients)
+            sink.end();
+        session.clients.clear();
+        scheduleCleanup(session);
+    };
+    const create = async (createOptions) => {
+        const spawnPty = await loadPty();
+        const now = Date.now();
+        const id = randomUUID();
+        const cols = clampDimension(createOptions.cols, DEFAULT_COLS);
+        const rows = clampDimension(createOptions.rows, DEFAULT_ROWS);
+        const shell = resolveShell(createOptions.shell);
+        const pty = spawnPty(shell, [], {
+            name: 'xterm-color',
+            cols,
+            rows,
+            cwd: createOptions.cwd,
+            env: { ...process.env },
+        });
+        const session = {
+            id,
+            projectId: typeof createOptions.projectId === 'string' && createOptions.projectId ? createOptions.projectId : null,
+            cwd: createOptions.cwd,
+            shell,
+            cols,
+            rows,
+            status: 'running',
+            createdAt: now,
+            updatedAt: now,
+            exitCode: null,
+            signal: null,
+            events: [],
+            nextEventId: 1,
+            clients: new Set(),
+            pty,
+            bufferedBytes: 0,
+            pendingData: '',
+            flushTimer: null,
+        };
+        sessions.set(id, session);
+        pty.onData((chunk) => {
+            session.pendingData += chunk;
+            if (session.pendingData.length >= flushThresholdBytes) {
+                flushData(session);
+                return;
+            }
+            if (session.flushTimer == null) {
+                session.flushTimer = setTimeout(() => flushData(session), flushIntervalMs);
+                session.flushTimer.unref?.();
+            }
+        });
+        pty.onExit(({ exitCode, signal }) => {
+            // `exitCode` is typed non-nullable on `PtyProcess.onExit` (matching
+            // node-pty's own exit-event shape), so no `?? null` fallback is
+            // reachable here — passed through directly rather than defensively
+            // re-guarded against a case the type already rules out.
+            finish(session, exitCode, signal ? signalName(signal) : null);
+        });
+        return toPublicSession(session);
+    };
+    const get = (id) => {
+        const session = sessions.get(id);
+        return session ? toPublicSession(session) : null;
+    };
+    const list = (filter = {}) => Array.from(sessions.values())
+        .filter((session) => {
+        if (typeof filter.projectId === 'string' && filter.projectId && session.projectId !== filter.projectId) {
+            return false;
+        }
+        return true;
+    })
+        .map(toPublicSession);
+    const attach = (id, lastEventId, sink) => {
+        const session = sessions.get(id);
+        if (!session)
+            return 'not-found';
+        let sent = 0;
+        for (const record of session.events) {
+            if (!Number.isFinite(lastEventId) || record.id > lastEventId) {
+                sink.send(record.event, record.data, record.id);
+                sent++;
+            }
+        }
+        if (TERMINAL_STATUSES.has(session.status)) {
+            // Guarantee a reattaching client sees the terminal `exit` even if its
+            // cursor is already past the final event id.
+            if (sent === 0 && session.events.length > 0) {
+                const last = session.events[session.events.length - 1];
+                sink.send(last.event, last.data, last.id);
+            }
+            sink.end();
+            return 'ended';
+        }
+        session.clients.add(sink);
+        return 'attached';
+    };
+    const detach = (id, sink) => {
+        sessions.get(id)?.clients.delete(sink);
+    };
+    const write = (id, input) => {
+        const session = sessions.get(id);
+        if (!session || TERMINAL_STATUSES.has(session.status))
+            return false;
+        try {
+            session.pty.write(input);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const resize = (id, cols, rows) => {
+        const session = sessions.get(id);
+        if (!session || TERMINAL_STATUSES.has(session.status))
+            return false;
+        const nextCols = clampDimension(cols, session.cols);
+        const nextRows = clampDimension(rows, session.rows);
+        try {
+            session.pty.resize(nextCols, nextRows);
+            session.cols = nextCols;
+            session.rows = nextRows;
+            session.updatedAt = Date.now();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const kill = (id, signal = 'SIGTERM') => {
+        const session = sessions.get(id);
+        if (!session || TERMINAL_STATUSES.has(session.status))
+            return false;
+        try {
+            session.pty.kill(signal);
+            return true;
+        }
+        catch {
+            // If the kill throws, force the terminal state so clients unblock.
+            finish(session, null, signal);
+            return false;
+        }
+    };
+    const shutdownActive = async ({ graceMs = shutdownGraceMs } = {}) => {
+        const active = Array.from(sessions.values()).filter((session) => !TERMINAL_STATUSES.has(session.status));
+        for (const session of active) {
+            try {
+                session.pty.kill('SIGTERM');
+            }
+            catch {
+                // best-effort
+            }
+            finish(session, null, 'SIGTERM');
+        }
+        if (active.length > 0 && graceMs > 0) {
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, Math.min(graceMs, 1000));
+                timer.unref?.();
+            });
+        }
+    };
+    return {
+        create,
+        get,
+        list,
+        write,
+        resize,
+        kill,
+        attach,
+        detach,
+        shutdownActive,
+        isTerminal(status) {
+            return TERMINAL_STATUSES.has(status);
+        },
+    };
+}
+// Map the numeric signal node-pty reports on exit back to a name. Only
+// SIGTERM is ever sent by this module; anything else falls back to a
+// generic label.
+function signalName(signal) {
+    const entry = Object.entries(os.constants.signals).find(([, value]) => value === signal);
+    return entry ? entry[0] : `SIG${signal}`;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/toolchain.d.ts

@@ -0,0 +1,17 @@
+export type WellKnownUserToolchainOptions = {
+    home?: string;
+    includeSystemBins?: boolean;
+    env?: NodeJS.ProcessEnv;
+};
+/**
+ * Assemble the ordered list of user-level toolchain bin directories to prepend
+ * to PATH so a GUI-launched daemon can find CLIs installed under the user's own
+ * toolchain even when it inherits a stripped PATH. Entries are search-path
+ * candidates (existence is not required) except version-manager install roots,
+ * which are probed and version-sorted.
+ *
+ * @param options - Optional `home`, `includeSystemBins`, and `env` overrides (all default to real values).
+ * @returns The ordered list of candidate bin directories, most-specific first.
+ */
+export declare function wellKnownUserToolchainBins(options?: WellKnownUserToolchainOptions): string[];
+//# sourceMappingURL=toolchain.d.ts.map

package/dist/toolchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain.d.ts","sourceRoot":"","sources":["../src/toolchain.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,6BAA6B,GAAG;IAG1C,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAK5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAuBF;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,6BAAkC,GAC1C,MAAM,EAAE,CAgKV"}