@agent-relay/factory 0.1.50 → 0.1.51

package/dist/node/preview-process.js

@@ -0,0 +1,431 @@
+import { createHash } from 'node:crypto';
+import { execFile, spawn } from 'node:child_process';
+import { readdir, readFile, readlink } from 'node:fs/promises';
+import { promisify } from 'node:util';
+import { findAgentProcessByName, readProcessIdentity, } from '../orchestrator/process-identity.js';
+import { terminatePids, } from '../orchestrator/reaper.js';
+const DEFAULT_IDENTITY_TIMEOUT_MS = 5_000;
+const DEFAULT_IDENTITY_POLL_INTERVAL_MS = 25;
+const PREVIEW_CWD_ARGUMENT = '--factory-preview-cwd';
+const PREVIEW_COMMAND_ARGUMENT = '--factory-preview-command';
+const execFileAsync = promisify(execFile);
+const PREVIEW_ENVIRONMENT_KEYS = new Set([
+    'HOME',
+    'LANG',
+    'LOGNAME',
+    'PATH',
+    'SHELL',
+    'TEMP',
+    'TERM',
+    'TMP',
+    'TMPDIR',
+    'USER',
+]);
+// Keep the wrapper process alive while its configured command runs so the
+// stable, Factory-owned marker remains visible in the wrapper's command line.
+// The command itself runs in a child shell and receives termination through the
+// ordinary process-tree teardown as well as this forwarding trap.
+const PREVIEW_PROCESS_WRAPPER = [
+    'child=',
+    'forward_signal() {',
+    '  if [ -n "$child" ]; then',
+    '    kill -TERM "$child" 2>/dev/null || true',
+    '  fi',
+    '}',
+    'trap forward_signal TERM INT HUP',
+    '/bin/sh -c "$6" &',
+    'child=$!',
+    'wait "$child"',
+    'status=$?',
+    'exit "$status"',
+].join('\n');
+/**
+ * Owns repository preview commands independently of an agent PTY or Factory
+ * process. The persisted identity is exact enough to refuse recycled PIDs, and
+ * its deterministic marker lets startup recovery find the wrapper after a
+ * spawn/persist crash gap.
+ */
+export class PreviewProcessSupervisor {
+    #shell;
+    #spawn;
+    #findProcess;
+    #readProcessIdentity;
+    #terminatePids;
+    #terminateOptions;
+    #sleep;
+    #identityTimeoutMs;
+    #identityPollIntervalMs;
+    #env;
+    #resolveListenerPids;
+    #readParentPid;
+    constructor(options = {}) {
+        this.#shell = options.shell ?? '/bin/sh';
+        this.#spawn = options.spawn ?? ((file, args, spawnOptions) => spawn(file, args, spawnOptions));
+        this.#readProcessIdentity = options.readProcessIdentity ?? readProcessIdentity;
+        this.#findProcess = options.findProcess ?? ((marker, findOptions) => findAgentProcessByName(marker, {
+            ...findOptions,
+            readProcessIdentity: this.#readProcessIdentity,
+        }));
+        this.#terminatePids = options.terminatePids ?? terminatePids;
+        this.#terminateOptions = options.terminateOptions ?? {};
+        this.#sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+        this.#identityTimeoutMs = options.identityTimeoutMs ?? DEFAULT_IDENTITY_TIMEOUT_MS;
+        this.#identityPollIntervalMs = options.identityPollIntervalMs ?? DEFAULT_IDENTITY_POLL_INTERVAL_MS;
+        this.#env = options.env ?? process.env;
+        const platform = options.platform ?? process.platform;
+        const procRoot = options.procRoot ?? '/proc';
+        const runListenerCommand = options.runListenerCommand ?? runCommand;
+        this.#resolveListenerPids = options.resolveListenerPids ?? (async (port) => await resolveListeningPids(port, platform, procRoot, runListenerCommand));
+        this.#readParentPid = options.readParentPid ?? (async (pid) => await readParentPid(pid, platform, procRoot, runListenerCommand));
+    }
+    async start(input) {
+        validateStartInput(input);
+        const marker = previewProcessMarker(input.id);
+        const cwdToken = encodeArgument(input.cwd);
+        const commandToken = digest(input.command);
+        const existing = await this.find(input.id);
+        if (existing) {
+            if (existing.cwd !== input.cwd ||
+                !commandTokenMatches(existing.cmdline, commandToken)) {
+                throw new Error(`Preview process marker ${marker} is already owned by a different command or checkout`);
+            }
+            return existing;
+        }
+        const child = this.#spawn(this.#shell, [
+            '-c',
+            PREVIEW_PROCESS_WRAPPER,
+            '--agent-name',
+            marker,
+            PREVIEW_CWD_ARGUMENT,
+            cwdToken,
+            PREVIEW_COMMAND_ARGUMENT,
+            commandToken,
+            input.command,
+        ], {
+            cwd: input.cwd,
+            detached: true,
+            env: previewEnvironment(this.#env, input.port),
+            stdio: 'ignore',
+        });
+        const pid = child.pid;
+        if (!Number.isInteger(pid) || (pid ?? 0) <= 0) {
+            throw new Error(`Unable to start preview process ${marker}: detached shell returned no PID`);
+        }
+        child.unref();
+        const identity = await this.#awaitIdentity(pid, marker, input.cwd, commandToken);
+        if (!identity) {
+            try {
+                // The PID came directly from this spawn call. Do not leave that known
+                // detached process behind merely because the platform identity lookup
+                // did not become observable before the deadline.
+                const report = await this.#terminatePids([pid], this.#terminateOptions);
+                const cleanupConfirmed = report.terminated.some((entry) => entry.pid === pid) ||
+                    report.skipped.some((entry) => entry.pid === pid && entry.reason === 'pid not running');
+                if (!cleanupConfirmed) {
+                    throw new Error(report.skipped.find((entry) => entry.pid === pid)?.reason ?? 'termination was not confirmed');
+                }
+            }
+            catch (cleanupError) {
+                throw new Error(`Preview process ${marker} started as PID ${pid} but its exact identity was not observable and the spawned process could not be terminated`, { cause: cleanupError });
+            }
+            throw new Error(`Preview process ${marker} started as PID ${pid} but its exact identity was not observable and was terminated`);
+        }
+        return identity;
+    }
+    async isRunning(identity) {
+        if (!validPersistedIdentity(identity))
+            return false;
+        const current = await this.#readProcessIdentity(identity.pid);
+        return Boolean(current && processIdentityMatches(identity, current));
+    }
+    async listenerOwnership(identity, port) {
+        // This is deliberately a point-in-time guard. Arbitrary development
+        // servers cannot inherit a reserved Factory socket, so eliminating the
+        // final check/use race would require socket activation or an intermediary
+        // proxy. Callers repeat this check during active reconciliation.
+        if (!validPersistedIdentity(identity) || !validPort(port) || !await this.isRunning(identity)) {
+            return 'indeterminate';
+        }
+        let listenerPids;
+        try {
+            listenerPids = await this.#resolveListenerPids(port);
+        }
+        catch {
+            return 'indeterminate';
+        }
+        if (!listenerPids || listenerPids.length === 0)
+            return 'indeterminate';
+        let indeterminate = false;
+        for (const pid of new Set(listenerPids)) {
+            const belongs = await this.#belongsToProcessTree(pid, identity.pid);
+            if (belongs === false)
+                return 'unrelated';
+            if (belongs === undefined)
+                indeterminate = true;
+        }
+        return indeterminate ? 'indeterminate' : 'owned';
+    }
+    async find(id) {
+        const marker = previewProcessMarker(id);
+        const resolution = await this.#findProcess(marker);
+        if (resolution.status === 'missing')
+            return undefined;
+        if (resolution.status === 'ambiguous') {
+            throw new Error(`Preview process marker ${marker} matched multiple process trees`);
+        }
+        const cwd = cwdFromCommandLine(resolution.identity.cmdline);
+        if (!cwd || !markerMatches(resolution.identity.cmdline, marker)) {
+            throw new Error(`Preview process marker ${marker} resolved to an invalid wrapper identity`);
+        }
+        return {
+            ...resolution.identity,
+            cwd,
+            marker,
+        };
+    }
+    async stop(identity) {
+        if (!validPersistedIdentity(identity))
+            return false;
+        const current = await this.#readProcessIdentity(identity.pid);
+        // Already absent is an idempotent success. A live but changed identity is
+        // a recycled PID and must never be signalled.
+        if (!current)
+            return true;
+        if (!processIdentityMatches(identity, current)) {
+            return false;
+        }
+        const report = await this.#terminatePids([identity.pid], this.#terminateOptions);
+        if (report.terminated.some((entry) => entry.pid === identity.pid)) {
+            return true;
+        }
+        // The wrapper can exit naturally between the identity check and the tree
+        // terminator's liveness probe. Count only confirmed absence as success; a
+        // recycled or changed identity remains a fail-closed false result.
+        return (await this.#readProcessIdentity(identity.pid)) === undefined;
+    }
+    async #awaitIdentity(pid, marker, cwd, commandToken) {
+        const interval = Math.max(1, this.#identityPollIntervalMs);
+        const attempts = Math.max(1, Math.ceil(Math.max(0, this.#identityTimeoutMs) / interval) + 1);
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            const current = await this.#readProcessIdentity(pid);
+            if (current &&
+                markerMatches(current.cmdline, marker) &&
+                cwdFromCommandLine(current.cmdline) === cwd &&
+                commandTokenMatches(current.cmdline, commandToken)) {
+                return { ...current, cwd, marker };
+            }
+            if (attempt + 1 < attempts)
+                await this.#sleep(interval);
+        }
+        return undefined;
+    }
+    async #belongsToProcessTree(pid, rootPid) {
+        let current = pid;
+        const seen = new Set();
+        for (let depth = 0; depth < 256; depth += 1) {
+            if (current === rootPid)
+                return true;
+            if (!Number.isInteger(current) || current <= 1 || seen.has(current))
+                return false;
+            seen.add(current);
+            try {
+                const parent = await this.#readParentPid(current);
+                if (parent === undefined)
+                    return undefined;
+                current = parent;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+}
+export function previewProcessMarker(id) {
+    const normalized = id.trim();
+    if (!normalized)
+        throw new Error('Preview process id must be non-empty');
+    return `factory-preview-${digest(normalized).slice(0, 32)}`;
+}
+function validateStartInput(input) {
+    previewProcessMarker(input.id);
+    if (!input.command.trim())
+        throw new Error('Preview process command must be non-empty');
+    if (!input.cwd.trim())
+        throw new Error('Preview process cwd must be non-empty');
+    if (!validPort(input.port)) {
+        throw new Error('Preview process port must be an integer between 1 and 65535');
+    }
+}
+const validPort = (port) => Number.isInteger(port) && port >= 1 && port <= 65_535;
+function previewEnvironment(source, port) {
+    const environment = { PORT: String(port) };
+    for (const [key, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        if (PREVIEW_ENVIRONMENT_KEYS.has(key) || key.startsWith('LC_')) {
+            environment[key] = value;
+        }
+    }
+    return environment;
+}
+function validPersistedIdentity(identity) {
+    return Number.isInteger(identity.pid) &&
+        identity.pid > 0 &&
+        Boolean(identity.startTime) &&
+        Boolean(identity.cmdline) &&
+        Boolean(identity.cwd) &&
+        /^factory-preview-[a-f0-9]{32}$/u.test(identity.marker) &&
+        markerMatches(identity.cmdline, identity.marker) &&
+        cwdFromCommandLine(identity.cmdline) === identity.cwd;
+}
+function processIdentityMatches(expected, current) {
+    return current.pid === expected.pid &&
+        current.startTime === expected.startTime &&
+        current.cmdline === expected.cmdline &&
+        markerMatches(current.cmdline, expected.marker) &&
+        cwdFromCommandLine(current.cmdline) === expected.cwd;
+}
+function markerMatches(cmdline, marker) {
+    const escaped = escapeRegExp(marker);
+    return new RegExp(`(^|\\s)--agent-name(\\s+|=)${escaped}(\\s|$)`, 'u').test(cmdline);
+}
+function commandTokenMatches(cmdline, token) {
+    return commandLineArgument(cmdline, PREVIEW_COMMAND_ARGUMENT) === token;
+}
+function cwdFromCommandLine(cmdline) {
+    const encoded = commandLineArgument(cmdline, PREVIEW_CWD_ARGUMENT);
+    if (!encoded)
+        return undefined;
+    try {
+        return Buffer.from(encoded, 'base64url').toString('utf8') || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function commandLineArgument(cmdline, name) {
+    const escaped = escapeRegExp(name);
+    return new RegExp(`(?:^|\\s)${escaped}(?:\\s+|=)([^\\s]+)(?:\\s|$)`, 'u').exec(cmdline)?.[1];
+}
+function encodeArgument(value) {
+    return Buffer.from(value, 'utf8').toString('base64url');
+}
+function digest(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+}
+async function resolveListeningPids(port, platform, procRoot, run) {
+    if (!validPort(port))
+        return undefined;
+    if (platform === 'linux')
+        return await resolveLinuxListeningPids(port, procRoot);
+    if (platform === 'darwin')
+        return await resolveDarwinListeningPids(port, run);
+    return undefined;
+}
+async function resolveLinuxListeningPids(port, procRoot) {
+    const tables = await Promise.allSettled([
+        readFile(`${procRoot}/net/tcp`, 'utf8'),
+        readFile(`${procRoot}/net/tcp6`, 'utf8'),
+    ]);
+    const readableTables = tables.flatMap((result) => result.status === 'fulfilled' ? [result.value] : []);
+    if (readableTables.length === 0)
+        return undefined;
+    const socketInodes = new Set(readableTables.flatMap((table) => listeningSocketInodes(table, port)));
+    if (socketInodes.size === 0)
+        return [];
+    let processEntries;
+    try {
+        processEntries = await readdir(procRoot);
+    }
+    catch {
+        return undefined;
+    }
+    const owners = new Set();
+    await Promise.all(processEntries.filter((entry) => /^\d+$/u.test(entry)).map(async (entry) => {
+        let descriptors;
+        try {
+            descriptors = await readdir(`${procRoot}/${entry}/fd`);
+        }
+        catch {
+            return;
+        }
+        for (const descriptor of descriptors) {
+            try {
+                const target = await readlink(`${procRoot}/${entry}/fd/${descriptor}`);
+                const inode = /^socket:\[(\d+)\]$/u.exec(target)?.[1];
+                if (inode && socketInodes.has(inode)) {
+                    owners.add(Number(entry));
+                    return;
+                }
+            }
+            catch {
+                // Processes and descriptors can disappear during the scan.
+            }
+        }
+    }));
+    return [...owners];
+}
+function listeningSocketInodes(table, port) {
+    const expectedPort = port.toString(16).toUpperCase().padStart(4, '0');
+    const inodes = [];
+    for (const line of table.split(/\r?\n/u).slice(1)) {
+        const fields = line.trim().split(/\s+/u);
+        if (fields.length < 10)
+            continue;
+        const localPort = fields[1]?.split(':').at(-1)?.toUpperCase();
+        const state = fields[3]?.toUpperCase();
+        const inode = fields[9];
+        if (localPort === expectedPort && state === '0A' && /^\d+$/u.test(inode ?? '')) {
+            inodes.push(inode);
+        }
+    }
+    return inodes;
+}
+async function resolveDarwinListeningPids(port, run) {
+    try {
+        const output = await run('/usr/sbin/lsof', [
+            '-nP',
+            '-a',
+            `-iTCP:${port}`,
+            '-sTCP:LISTEN',
+            '-Fp',
+        ]);
+        return [...new Set(output.split(/\r?\n/u)
+                .filter((line) => /^p\d+$/u.test(line))
+                .map((line) => Number(line.slice(1))))];
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readParentPid(pid, platform, procRoot, run) {
+    if (platform === 'linux') {
+        try {
+            const status = await readFile(`${procRoot}/${pid}/status`, 'utf8');
+            const parent = Number(/^PPid:\s+(\d+)$/mu.exec(status)?.[1]);
+            return Number.isInteger(parent) && parent >= 0 ? parent : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (platform === 'darwin') {
+        try {
+            const parent = Number((await run('/bin/ps', ['-o', 'ppid=', '-p', String(pid)])).trim());
+            return Number.isInteger(parent) && parent >= 0 ? parent : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+const runCommand = async (file, args) => {
+    const result = await execFileAsync(file, args, { encoding: 'utf8' });
+    return result.stdout;
+};
+//# sourceMappingURL=preview-process.js.map

package/dist/node/preview-process.js.map

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

package/dist/node/tailscale-preview.d.ts

@@ -0,0 +1,45 @@
+import type { PreviewConfig } from '../config/schema.js';
+import type { PreviewReference, PreviewStartInput, PreviewSweepInput, PreviewSweepResult } from '../ports/fleet.js';
+import { PreviewProcessSupervisor } from './preview-process.js';
+type CommandResult = {
+    stdout: string;
+    stderr: string;
+};
+export type PreviewCommandRunner = (file: string, args: string[]) => Promise<CommandResult>;
+export type PreviewPortProbe = (port: number) => Promise<boolean>;
+export type PreviewReadyProbe = (port: number) => Promise<boolean>;
+export type PreviewPublishedProbe = (url: string) => Promise<boolean>;
+type PreviewProcessController = Pick<PreviewProcessSupervisor, 'start' | 'isRunning' | 'find' | 'stop'> & Partial<Pick<PreviewProcessSupervisor, 'listenerOwnership'>>;
+export interface PreviewManager {
+    start(input: PreviewStartInput): Promise<PreviewReference>;
+    remove(preview: PreviewReference): Promise<boolean>;
+    sweep(input: PreviewSweepInput): Promise<PreviewSweepResult>;
+}
+export interface TailscalePreviewManagerOptions {
+    config: PreviewConfig;
+    run?: PreviewCommandRunner;
+    isPortAvailable?: PreviewPortProbe;
+    isReady?: PreviewReadyProbe;
+    isPublishedReady?: PreviewPublishedProbe;
+    processSupervisor?: PreviewProcessController;
+    sleep?: (ms: number) => Promise<void>;
+    readyTimeoutMs?: number;
+    publishedReadyTimeoutMs?: number;
+    readyPollIntervalMs?: number;
+    now?: () => Date;
+}
+/**
+ * Thin lifecycle adapter around Tailscale Serve. `tailscaled` owns background
+ * proxying, while this registry records the exact routes Factory may remove.
+ * Every destructive operation checks the live Serve target before issuing
+ * `off`, so a stale registry can never turn off a port repurposed by a human.
+ */
+export declare class TailscalePreviewManager implements PreviewManager {
+    #private;
+    constructor(options: TailscalePreviewManagerOptions);
+    start(input: PreviewStartInput): Promise<PreviewReference>;
+    remove(reference: PreviewReference): Promise<boolean>;
+    sweep(input: PreviewSweepInput): Promise<PreviewSweepResult>;
+}
+export {};
+//# sourceMappingURL=tailscale-preview.d.ts.map

package/dist/node/tailscale-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailscale-preview.d.ts","sourceRoot":"","sources":["../../src/node/tailscale-preview.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,wBAAwB,EAEzB,MAAM,mBAAmB,CAAA;AAwB1B,KAAK,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AACvD,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;AAC3F,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AACrE,KAAK,wBAAwB,GAC3B,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC,GACvE,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAE9D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1D,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACnD,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,CAAC,EAAE,oBAAoB,CAAA;IAC1B,eAAe,CAAC,EAAE,gBAAgB,CAAA;IAClC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;IACxC,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IAC5C,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,cAAc;;gBAchD,OAAO,EAAE,8BAA8B;IAoB7C,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4L1D,MAAM,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiDrD,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAmTnE"}