crewly 1.20.106 → 1.20.107

package/dist/cli/cli/src/scripts/ensure-node-pty.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Install-time node-pty check (#778), wired into `package.json` `postinstall`.
+ *
+ * node-pty ships prebuilt binaries for macOS and glibc Linux, so a plain
+ * `npm i -g crewly` needs no compiler. This script:
+ *
+ *   1. restores the exec bit on node-pty's `spawn-helper` (lost by some
+ *      package managers / node-pty 1.1.0's tarball);
+ *   2. checks that node-pty actually loads — in a child process, so a bad
+ *      binary cannot poison this one;
+ *   3. only if it does NOT load (musl, glibc < 2.28, unusual arch, stale
+ *      build), compiles it from source and checks again;
+ *   4. says clearly when node-pty still cannot load, and exits 1 so npm
+ *      shows that message (npm hides lifecycle output of scripts that pass).
+ *      The backend cannot boot without node-pty, so such an install is broken.
+ *
+ * It replaces an unconditional `npm rebuild node-pty --build-from-source`,
+ * which deletes node-pty's prebuilds and then fails without a toolchain.
+ * In every other case — including a failure of this script itself — it exits
+ * 0, so it never turns a working install into a failing one.
+ *
+ * @module cli/scripts/ensure-node-pty
+ */
+/** Result of a load probe. */
+export interface LoadProbeResult {
+    ok: boolean;
+    /** First line of the load error when not ok. */
+    error?: string;
+}
+/** Final state reported by {@link ensureNodePty}. */
+export type EnsureNodePtyStatus = 'ok' | 'rebuilt' | 'failed' | 'missing';
+/** Injection points (defaults do real work). */
+export interface EnsureNodePtyDeps {
+    /** Directory containing `package.json` and `node_modules/`. */
+    packageRoot: string;
+    /** Platform tag (defaults to the current one). */
+    platform?: string;
+    /** Arch tag (defaults to the current one). */
+    arch?: string;
+    /** Locate node-pty's package dir. */
+    findNodePtyDir?: (packageRoot: string) => string | null;
+    /** Check that `require('node-pty')` works. */
+    probeLoad?: (packageRoot: string) => LoadProbeResult;
+    /** Compile node-pty from source; true on success. */
+    rebuildFromSource?: (packageRoot: string) => boolean;
+    /** Message sink. */
+    log?: (message: string) => void;
+    /** Known reason the prebuild cannot run here (defaults to libc detection). */
+    prebuildProblem?: string | null;
+    /** Package-manager command that installs the build tools. */
+    installHint?: string;
+}
+/**
+ * Pick the thrown message out of a Node stack dump (`Error: ...`), skipping
+ * the echoed source line Node prints above it.
+ *
+ * @param stderr - Child stderr
+ * @returns The message line, or null when there is none
+ */
+export declare function firstErrorLine(stderr: string): string | null;
+/**
+ * Make node-pty usable, compiling only when the prebuilt binary does not load.
+ *
+ * @param deps - Injection points
+ * @returns Final status
+ */
+export declare function ensureNodePty(deps: EnsureNodePtyDeps): EnsureNodePtyStatus;
+//# sourceMappingURL=ensure-node-pty.d.ts.map

package/dist/cli/cli/src/scripts/ensure-node-pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-node-pty.d.ts","sourceRoot":"","sources":["../../../../../cli/src/scripts/ensure-node-pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAkBH,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1E,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IACjC,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,eAAe,CAAC;IACrD,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,oBAAoB;IACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AA6CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAkD1E"}

package/dist/cli/cli/src/scripts/ensure-node-pty.js

@@ -0,0 +1,167 @@
+/**
+ * Install-time node-pty check (#778), wired into `package.json` `postinstall`.
+ *
+ * node-pty ships prebuilt binaries for macOS and glibc Linux, so a plain
+ * `npm i -g crewly` needs no compiler. This script:
+ *
+ *   1. restores the exec bit on node-pty's `spawn-helper` (lost by some
+ *      package managers / node-pty 1.1.0's tarball);
+ *   2. checks that node-pty actually loads — in a child process, so a bad
+ *      binary cannot poison this one;
+ *   3. only if it does NOT load (musl, glibc < 2.28, unusual arch, stale
+ *      build), compiles it from source and checks again;
+ *   4. says clearly when node-pty still cannot load, and exits 1 so npm
+ *      shows that message (npm hides lifecycle output of scripts that pass).
+ *      The backend cannot boot without node-pty, so such an install is broken.
+ *
+ * It replaces an unconditional `npm rebuild node-pty --build-from-source`,
+ * which deletes node-pty's prebuilds and then fails without a toolchain.
+ * In every other case — including a failure of this script itself — it exits
+ * 0, so it never turns a working install into a failing one.
+ *
+ * @module cli/scripts/ensure-node-pty
+ */
+import { spawnSync } from 'child_process';
+import { createRequire } from 'module';
+import * as path from 'path';
+import { pathToFileURL } from 'url';
+import { detectLinuxLibc, prebuildLibcProblem, toolchainInstallHint } from '../utils/native-toolchain.js';
+import { ensureSpawnHelperExecutable, resolveNodePtyDir, } from '../../../backend/src/services/session/pty/node-pty-install.utils.js';
+/** Upper bound for a from-source compile (node-gyp on a slow VPS). */
+const REBUILD_TIMEOUT_MS = 10 * 60 * 1000;
+/** Upper bound for the load probe. */
+const LOAD_PROBE_TIMEOUT_MS = 30 * 1000;
+/**
+ * Default node-pty locator: resolve from the package root.
+ *
+ * @param packageRoot - Package root
+ * @returns node-pty's package directory or null
+ */
+function defaultFindNodePtyDir(packageRoot) {
+    const req = createRequire(pathToFileURL(path.join(packageRoot, 'package.json')).href);
+    return resolveNodePtyDir((request) => req.resolve(request));
+}
+/**
+ * Pick the thrown message out of a Node stack dump (`Error: ...`), skipping
+ * the echoed source line Node prints above it.
+ *
+ * @param stderr - Child stderr
+ * @returns The message line, or null when there is none
+ */
+export function firstErrorLine(stderr) {
+    const lines = stderr.split('\n').map((line) => line.trim()).filter(Boolean);
+    return lines.find((line) => /^[A-Za-z]*Error(\s\[[A-Z_]+\])?:/.test(line))
+        ?? lines.find((line) => /error/i.test(line))
+        ?? null;
+}
+/**
+ * Default load probe: `node -e "require('node-pty')"` in a child process.
+ *
+ * @param packageRoot - Package root (cwd for the resolver)
+ * @returns Whether it loaded
+ */
+function defaultProbeLoad(packageRoot) {
+    const res = spawnSync(process.execPath, ['-e', "require('node-pty')"], {
+        cwd: packageRoot,
+        encoding: 'utf8',
+        timeout: LOAD_PROBE_TIMEOUT_MS,
+    });
+    if (res.status === 0)
+        return { ok: true };
+    return { ok: false, error: firstErrorLine(res.stderr || res.error?.message || '') ?? `exit ${res.status}` };
+}
+/**
+ * Default from-source rebuild. Runs npm in project mode against the package
+ * root — inside a global install's lifecycle `npm_config_global=true` would
+ * otherwise point `npm rebuild` at the global prefix, where node-pty is not.
+ *
+ * @param packageRoot - Package root
+ * @returns true when npm exited 0
+ */
+function defaultRebuildFromSource(packageRoot) {
+    const env = { ...process.env };
+    for (const key of Object.keys(env)) {
+        if (/^npm_config_(global|location|prefix)$/i.test(key))
+            delete env[key];
+    }
+    const npmCli = process.env.npm_execpath;
+    const args = ['rebuild', 'node-pty', '--build-from-source', '--global=false', '--prefix', packageRoot];
+    const res = npmCli && /\.c?js$/.test(npmCli)
+        ? spawnSync(process.execPath, [npmCli, ...args], { cwd: packageRoot, env, stdio: 'inherit', timeout: REBUILD_TIMEOUT_MS })
+        : spawnSync(process.platform === 'win32' ? 'npm.cmd' : 'npm', args, {
+            cwd: packageRoot,
+            env,
+            stdio: 'inherit',
+            timeout: REBUILD_TIMEOUT_MS,
+            shell: process.platform === 'win32',
+        });
+    return res.status === 0;
+}
+/**
+ * Make node-pty usable, compiling only when the prebuilt binary does not load.
+ *
+ * @param deps - Injection points
+ * @returns Final status
+ */
+export function ensureNodePty(deps) {
+    const platform = deps.platform ?? process.platform;
+    const arch = deps.arch ?? process.arch;
+    const log = deps.log ?? ((m) => console.error(m));
+    const findDir = deps.findNodePtyDir ?? defaultFindNodePtyDir;
+    const probeLoad = deps.probeLoad ?? defaultProbeLoad;
+    const rebuild = deps.rebuildFromSource ?? defaultRebuildFromSource;
+    const dir = findDir(deps.packageRoot);
+    if (!dir) {
+        log('[crewly] node-pty is not installed — agent terminals will not work. Reinstall with: npm i -g crewly');
+        return 'missing';
+    }
+    const fixHelpers = () => {
+        const { fixed, failed } = ensureSpawnHelperExecutable(dir, platform, arch);
+        for (const helper of fixed)
+            log(`[crewly] Made node-pty's spawn-helper executable: ${helper}`);
+        for (const f of failed)
+            log(`[crewly] node-pty's spawn-helper is not executable (${f.error}). Run: chmod +x ${f.path}`);
+    };
+    fixHelpers();
+    const first = probeLoad(deps.packageRoot);
+    if (first.ok)
+        return 'ok';
+    // node-pty's loader reports the LAST path it tried, which hides e.g. a
+    // musl dlopen failure — name the libc reason ourselves when we know it.
+    const problem = deps.prebuildProblem === undefined
+        ? prebuildLibcProblem(platform, detectLinuxLibc(platform))
+        : deps.prebuildProblem;
+    log(`[crewly] node-pty's prebuilt binary does not load on ${platform}-${arch}: ${problem ?? first.error ?? 'unknown error'}.`);
+    log('[crewly] Compiling node-pty from source (needs a C++ compiler, make and python3)...');
+    const rebuilt = rebuild(deps.packageRoot);
+    fixHelpers();
+    const second = probeLoad(deps.packageRoot);
+    if (second.ok) {
+        log('[crewly] node-pty compiled from source and loads.');
+        return 'rebuilt';
+    }
+    // The install is about to fail and npm rolls it back, so point at a
+    // re-install rather than at a package directory that will not exist.
+    log([
+        `[crewly] node-pty still cannot load${rebuilt ? '' : ' (the compile failed)'}: ${second.error ?? 'unknown error'}`,
+        '[crewly] Crewly cannot start agent terminals without it. Install the build tools, then re-run the install:',
+        `[crewly]   ${deps.installHint ?? toolchainInstallHint()}`,
+        '[crewly]   npm i -g crewly',
+    ].join('\n'));
+    return 'failed';
+}
+/* c8 ignore start — lifecycle entry, exercised by npm not by unit tests */
+const invokedDirectly = process.argv[1] !== undefined && process.argv[1].endsWith('ensure-node-pty.js');
+if (invokedDirectly) {
+    try {
+        if (ensureNodePty({ packageRoot: path.resolve(process.cwd()) }) === 'failed') {
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        // Never fail an install because the check itself broke.
+        console.error(`[crewly] node-pty install check skipped: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/* c8 ignore stop */
+//# sourceMappingURL=ensure-node-pty.js.map

package/dist/cli/cli/src/scripts/ensure-node-pty.js.map

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

package/dist/cli/cli/src/utils/backend-status.d.ts

@@ -0,0 +1,175 @@
+/**
+ * What is actually running: the Crewly backend on a port and its agents.
+ *
+ * Agents run in node-pty sessions owned by the backend (or in-process, with
+ * no PTY), not in tmux. `crewly status` and `crewly stop` used to look only
+ * for `crewly_*` tmux sessions, so status listed nothing and stop reported
+ * success after examining nothing (#776). The source of truth is the backend
+ * API (sessions, teams, restart readiness) plus the process table for the
+ * listener pid and its children.
+ *
+ * @module cli/utils/backend-status
+ */
+import { type RestartReadiness } from './safe-shutdown.js';
+/** HTTP GET returning the parsed JSON body; throws when the request fails. */
+export type HttpGet = (url: string, timeoutMs: number) => Promise<unknown>;
+/** Runs a shell command and returns stdout; throws on a non-zero exit. */
+export type RunCommand = (command: string) => Promise<string>;
+/** Subset of the backend's `/health` body the CLI shows. */
+export interface BackendHealth {
+    status: string;
+    version: string | null;
+    uptimeSeconds: number | null;
+    mode: string | null;
+    /** Orchestrator liveness (`ok` / `degraded`) and why */
+    orchestratorStatus: string | null;
+    orchestratorReason: string | null;
+    /** Team health watchdog status */
+    teamHealthStatus: string | null;
+}
+/** One running agent session. */
+export interface RunningAgent {
+    sessionName: string;
+    /** PTY child pid (absent for in-process agents) */
+    pid?: number;
+    cwd?: string;
+    /** True for in-process (AI SDK) agents, which have no PTY */
+    inProcess: boolean;
+    /** Mid-turn right now, per restart readiness */
+    busy: boolean;
+    /** When the current turn started (busy agents only) */
+    busySince?: string;
+    /** Preview of the message being worked on (busy agents only) */
+    busyMessage?: string;
+    /** Team member name, when the session belongs to a team member */
+    memberName?: string;
+    teamName?: string;
+    runtimeType?: string;
+}
+/** Everything the backend reports about itself, each part fail-soft. */
+export interface BackendSnapshot {
+    url: string;
+    /** Null when `/health` does not answer (backend not running or wedged) */
+    health: BackendHealth | null;
+    /** Null when the session list could not be read */
+    agents: RunningAgent[] | null;
+    /** Why `agents` is null */
+    agentsError?: string;
+    /** Null when readiness is unavailable (older backend) — busy flags are then unknown */
+    readiness: RestartReadiness | null;
+}
+/** One row of the process table. */
+export interface ProcessRow {
+    pid: number;
+    ppid: number;
+    command: string;
+}
+/**
+ * Backend base URL for a port. Uses `localhost`, which the API treats as
+ * loopback, so no API token is needed.
+ *
+ * @param port - Backend web port
+ * @returns Base URL without a trailing slash
+ */
+export declare function backendUrl(port: number | string): string;
+/**
+ * Parse the backend's `/health` body.
+ *
+ * @param body - Parsed JSON
+ * @returns Health summary
+ */
+export declare function parseHealth(body: unknown): BackendHealth;
+/** Team-member identity keyed by session name. */
+interface MemberInfo {
+    memberName: string;
+    teamName: string;
+    runtimeType?: string;
+}
+/**
+ * Map session names to team members from a `GET /api/teams` body.
+ *
+ * @param body - Parsed JSON (`{ success, data: Team[] }`)
+ * @returns Session name → member info
+ */
+export declare function parseTeamMembers(body: unknown): Map<string, MemberInfo>;
+/**
+ * Build the running-agent list from the session endpoints.
+ *
+ * @param sessionsBody - `GET /api/sessions` body (`{ sessions: [{ sessionName, pid, cwd }] }`)
+ * @param terminalBody - `GET /api/terminal/sessions` body, or null (adds in-process agents)
+ * @param readiness - Restart readiness, or null (busy flags then stay false)
+ * @param members - Session name → member info
+ * @returns Agents sorted by name
+ */
+export declare function buildAgentList(sessionsBody: unknown, terminalBody: unknown, readiness: RestartReadiness | null, members: Map<string, MemberInfo>): RunningAgent[];
+/**
+ * Ask the backend on `port` what is running. Never throws: each part is
+ * null when its endpoint does not answer.
+ *
+ * @param port - Backend web port
+ * @param httpGet - HTTP GET (injectable for tests)
+ * @returns Snapshot
+ */
+export declare function fetchBackendSnapshot(port: number | string, httpGet?: HttpGet): Promise<BackendSnapshot>;
+/**
+ * Parse pid lines (one per line, as printed by `lsof -t`).
+ *
+ * @param stdout - Command output
+ * @param excludePid - A pid to leave out (this CLI process)
+ * @returns Unique positive pids
+ */
+export declare function parsePidLines(stdout: string, excludePid?: number): number[];
+/**
+ * Pids LISTENING on a TCP port (never clients connected to it).
+ *
+ * @param port - TCP port
+ * @param run - Shell runner
+ * @returns Listener pids (empty when none, or when lsof is unavailable)
+ */
+export declare function findListenerPids(port: number | string, run: RunCommand): Promise<number[]>;
+/**
+ * Parse `ps -A -o pid=,ppid=,command=` output.
+ *
+ * @param stdout - Command output
+ * @returns Rows
+ */
+export declare function parseProcessTable(stdout: string): ProcessRow[];
+/**
+ * Read the process table.
+ *
+ * @param run - Shell runner
+ * @returns Rows (empty when `ps` fails)
+ */
+export declare function readProcessTable(run: RunCommand): Promise<ProcessRow[]>;
+/**
+ * Every descendant of `rootPid` (children, grandchildren, ...), e.g. the
+ * agent runtimes node-pty spawned under the backend.
+ *
+ * @param rows - Process table
+ * @param rootPid - Ancestor pid
+ * @returns Descendant rows, parents before children
+ */
+export declare function collectDescendants(rows: readonly ProcessRow[], rootPid: number): ProcessRow[];
+/**
+ * Whether a command line is a Crewly backend entrypoint.
+ *
+ * @param command - Full command line
+ * @returns True for `backend/src/index.(js|ts)`
+ */
+export declare function isCrewlyBackendCommand(command: string): boolean;
+/**
+ * Human-readable duration, e.g. `3h 2m`, `45s`.
+ *
+ * @param seconds - Duration in seconds
+ * @returns Short string
+ */
+export declare function formatUptime(seconds: number): string;
+/**
+ * Label for an agent: `session (Member, Team, runtime)`.
+ *
+ * @param agent - Agent
+ * @returns Label
+ */
+export declare function describeAgent(agent: RunningAgent): string;
+export {};
+//# sourceMappingURL=backend-status.d.ts.map

package/dist/cli/cli/src/utils/backend-status.d.ts.map

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