@phnx-labs/agents-cli 1.22.116 → 1.22.118

package/dist/lib/browser/stream.d.ts

@@ -1,17 +0,0 @@
-import type { Readable, Writable } from 'stream';
-interface BrowserIPCStreamOptions {
-    input: Readable;
-    output: Writable;
-    task?: string;
-    actor: string;
-    launchId?: string;
-    /** Calling agent session, forwarded onto `start` requests (RUSH-2549). */
-    sessionId?: string;
-    autoStartDaemon?: boolean;
-}
-/**
- * Read browser IPC requests as NDJSON and write one NDJSON response per line.
- * The Node process and daemon connection stay alive until input closes.
- */
-export declare function runBrowserIPCStream(options: BrowserIPCStreamOptions): Promise<void>;
-export {};

package/dist/lib/browser/stream.js

@@ -1,72 +0,0 @@
-import { createInterface } from 'readline';
-import { connectBrowserIPC } from './ipc.js';
-import { assertRemoteControlAllowed } from './remote-control.js';
-function parseRequest(line) {
-    const parsed = JSON.parse(line);
-    if (!parsed ||
-        typeof parsed !== 'object' ||
-        Array.isArray(parsed) ||
-        typeof parsed.action !== 'string') {
-        throw new Error('Each input line must be a JSON object with an action');
-    }
-    return parsed;
-}
-function writeResponse(output, response) {
-    output.write(`${JSON.stringify(response)}\n`);
-}
-function writeErrorResponse(output, error) {
-    writeResponse(output, {
-        ok: false,
-        error: error instanceof Error ? error.message : String(error),
-    });
-}
-/**
- * Read browser IPC requests as NDJSON and write one NDJSON response per line.
- * The Node process and daemon connection stay alive until input closes.
- */
-export async function runBrowserIPCStream(options) {
-    const client = await connectBrowserIPC({ autoStartDaemon: options.autoStartDaemon });
-    const lines = createInterface({ input: options.input, crlfDelay: Infinity });
-    let defaultTask = options.task;
-    try {
-        for await (const line of lines) {
-            if (!line.trim())
-                continue;
-            let request;
-            try {
-                request = parseRequest(line);
-            }
-            catch (error) {
-                writeErrorResponse(options.output, error);
-                continue;
-            }
-            if (request.action === 'start') {
-                try {
-                    assertRemoteControlAllowed();
-                }
-                catch (error) {
-                    writeErrorResponse(options.output, error);
-                    continue;
-                }
-                request = {
-                    ...request,
-                    taskName: request.taskName ?? defaultTask,
-                    actor: request.actor ?? options.actor,
-                    launchId: request.launchId ?? options.launchId,
-                    sessionId: request.sessionId ?? options.sessionId,
-                };
-            }
-            else if (!request.task && defaultTask) {
-                request = { ...request, task: defaultTask };
-            }
-            const response = await client.request(request);
-            if (response.task)
-                defaultTask = response.task;
-            writeResponse(options.output, response);
-        }
-    }
-    finally {
-        lines.close();
-        await client.close();
-    }
-}

package/dist/lib/browser/task-index.d.ts

@@ -1,78 +0,0 @@
-interface TaskBinding {
-    device: string;
-    profile?: string;
-    url?: string;
-    sessionId?: string;
-    launchId?: string;
-    createdAt: number;
-}
-type TaskIndex = Record<string, TaskBinding>;
-export declare const REJECT_DEVICE_MESSAGE: string;
-type TaskRoute = {
-    kind: 'proceed';
-    task?: string;
-    device: string;
-} | {
-    kind: 'unknown';
-    task: string;
-    message: string;
-} | {
-    kind: 'ambiguous';
-    message: string;
-} | {
-    kind: 'reject-device';
-    message: string;
-};
-export declare function isTerminalBrowserVerb(verb: string): boolean;
-export declare function readTaskIndex(): TaskIndex;
-export declare function getTaskBinding(name: string): TaskBinding | undefined;
-export declare function listTaskBindings(): Array<{
-    name: string;
-} & TaskBinding>;
-export declare function bindTask(name: string, binding: TaskBinding): void;
-export declare function updateTaskBinding(name: string, patch: Partial<TaskBinding>): void;
-export declare function unbindTask(name: string): void;
-/** Drop every binding recorded under this profile (after `stop --profile` / gc). */
-export declare function unbindTasksForProfile(profile: string): void;
-export declare function tasksForCaller(sessionId?: string, launchId?: string): Array<{
-    name: string;
-} & TaskBinding>;
-export declare function formatOpenTaskList(entries: Array<{
-    name: string;
-} & TaskBinding>, now?: number): string;
-export declare function unknownTaskMessage(name: string, entries?: ({
-    name: string;
-} & TaskBinding)[]): string;
-export declare function ambiguousTasksMessage(entries: Array<{
-    name: string;
-} & TaskBinding>): string;
-/**
- * Decide where a page verb should run.
- *
- * `--device` on a later verb is always rejected (bind it at start).
- * A named task that is not in the local index fails loud with the open-task
- * list. Two or more tasks for this caller, with no `--task`, fail the same way.
- * Zero matches with no `--task` follows the fleet browser hub when the caller
- * passed one (`opts.hub` — the box drives `browser.device` by default), so a
- * cold page verb reaches the logged-in hub browser exactly as a bare
- * `agents browser start` already does; with no hub it proceeds locally and the
- * daemon resolves from caller identity for the first implicit create. The caller
- * (the CLI's task-routing hook) supplies `opts.hub` from `defaultBrowserHub()`,
- * which is already undefined on the hub itself and on a fleet-remote re-exec, so
- * this can never forward to self or loop.
- */
-export declare function resolveTaskRoute(opts: {
-    task?: string;
-    device?: string;
-    sessionId?: string;
-    launchId?: string;
-    self?: string;
-    hub?: string;
-}): TaskRoute;
-/**
- * The daemon sandboxes screenshot writes to the browser runtime dir, so `-o`
- * outside that dir is ignored there. The CLI process honors `-o` by copying
- * the captured file to the requested path. Same path → no copy.
- */
-export declare function honorScreenshotOutput(requested: string | undefined, daemonPath: string): string;
-export {};

package/dist/lib/browser/task-index.js

@@ -1,199 +0,0 @@
-/**
- * Local task → device index.
- *
- * `tasks.json` is per-profile and lives in that profile's cache dir on the
- * machine running the browser daemon, so a later verb issued from a different
- * box cannot see where task `post` lives. The machine that STARTS a task
- * records the binding here — a small JSON file in THIS box's browser cache.
- * No fleet state, no sync: the agent that opens a task is the agent that
- * drives it.
- *
- * Kind is not stored. A missing name fails loud and lists the open tasks;
- * it never guesses, never opens a new browser, never falls back to a default
- * profile.
- */
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { getBrowserRuntimeDir } from '../state.js';
-import { machineId } from '../machine-id.js';
-export const REJECT_DEVICE_MESSAGE = '--device is only valid on `agents browser start`.\n' +
-    'The task is bound to a device at start; later verbs resolve it from --task.\n' +
-    'Next: agents browser start --task <name> --device <device>';
-/**
- * Verbs that CLOSE a browsing context. A cold (no bound task) close verb must
- * never follow the fleet hub: with no task it would target a browsing context
- * this session never opened, and on the hub could stop an unrelated task. They
- * stay local unless an explicit `--task` or a local binding routes them. The
- * driving/read verbs (navigate, screenshot, click, …) are safe to forward cold
- * because the hub creates the caller's OWN task, keyed to the identity the
- * dispatch now forwards.
- */
-const TERMINAL_BROWSER_VERBS = new Set(['done', 'stop']);
-export function isTerminalBrowserVerb(verb) {
-    return TERMINAL_BROWSER_VERBS.has(verb);
-}
-function taskIndexPath() {
-    return path.join(getBrowserRuntimeDir(), 'task-index.json');
-}
-export function readTaskIndex() {
-    const file = taskIndexPath();
-    if (!fs.existsSync(file))
-        return {};
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
-    }
-    catch (error) {
-        throw new Error(`Cannot read browser task index at ${file}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error(`Cannot read browser task index at ${file}: document root must be a map.`);
-    }
-    return parsed;
-}
-function writeTaskIndex(index) {
-    const file = taskIndexPath();
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    const tmp = `${file}.${process.pid}.tmp`;
-    fs.writeFileSync(tmp, `${JSON.stringify(index, null, 2)}\n`);
-    fs.renameSync(tmp, file);
-}
-export function getTaskBinding(name) {
-    return readTaskIndex()[name];
-}
-export function listTaskBindings() {
-    return Object.entries(readTaskIndex())
-        .map(([name, binding]) => ({ name, ...binding }))
-        .sort((a, b) => a.createdAt - b.createdAt);
-}
-export function bindTask(name, binding) {
-    if (!name) {
-        throw new Error('Cannot bind a browser task with an empty name.');
-    }
-    if (!binding.device) {
-        throw new Error(`Cannot bind browser task "${name}" without a device.`);
-    }
-    const index = readTaskIndex();
-    index[name] = { ...binding };
-    writeTaskIndex(index);
-}
-export function updateTaskBinding(name, patch) {
-    const index = readTaskIndex();
-    const existing = index[name];
-    if (!existing)
-        return;
-    index[name] = { ...existing, ...patch };
-    writeTaskIndex(index);
-}
-export function unbindTask(name) {
-    const index = readTaskIndex();
-    if (!(name in index))
-        return;
-    delete index[name];
-    writeTaskIndex(index);
-}
-/** Drop every binding recorded under this profile (after `stop --profile` / gc). */
-export function unbindTasksForProfile(profile) {
-    const index = readTaskIndex();
-    let changed = false;
-    for (const [name, binding] of Object.entries(index)) {
-        if (binding.profile === profile) {
-            delete index[name];
-            changed = true;
-        }
-    }
-    if (changed)
-        writeTaskIndex(index);
-}
-export function tasksForCaller(sessionId, launchId) {
-    return listTaskBindings().filter((entry) => {
-        if (sessionId && entry.sessionId === sessionId)
-            return true;
-        if (launchId && entry.launchId === launchId)
-            return true;
-        return false;
-    });
-}
-function formatAge(createdAt, now = Date.now()) {
-    const ageMs = Math.max(0, now - createdAt);
-    if (ageMs < 60_000)
-        return `${Math.round(ageMs / 1000)}s`;
-    return `${Math.round(ageMs / 60_000)}m`;
-}
-export function formatOpenTaskList(entries, now = Date.now()) {
-    if (entries.length === 0)
-        return '  (no open tasks)';
-    return entries
-        .map((entry) => {
-        const url = entry.url && entry.url.length > 0 ? entry.url : '-';
-        return `  ${entry.name}  url=${url}  device=${entry.device}  age=${formatAge(entry.createdAt, now)}`;
-    })
-        .join('\n');
-}
-export function unknownTaskMessage(name, entries = listTaskBindings()) {
-    return [
-        `Unknown browser task "${name}".`,
-        'Open tasks:',
-        formatOpenTaskList(entries),
-        'Next: agents browser start --task <name> [--device <device>]',
-    ].join('\n');
-}
-export function ambiguousTasksMessage(entries) {
-    return [
-        'Multiple browser tasks for this session — pass --task <name>:',
-        formatOpenTaskList(entries),
-        'Next: agents browser status',
-    ].join('\n');
-}
-/**
- * Decide where a page verb should run.
- *
- * `--device` on a later verb is always rejected (bind it at start).
- * A named task that is not in the local index fails loud with the open-task
- * list. Two or more tasks for this caller, with no `--task`, fail the same way.
- * Zero matches with no `--task` follows the fleet browser hub when the caller
- * passed one (`opts.hub` — the box drives `browser.device` by default), so a
- * cold page verb reaches the logged-in hub browser exactly as a bare
- * `agents browser start` already does; with no hub it proceeds locally and the
- * daemon resolves from caller identity for the first implicit create. The caller
- * (the CLI's task-routing hook) supplies `opts.hub` from `defaultBrowserHub()`,
- * which is already undefined on the hub itself and on a fleet-remote re-exec, so
- * this can never forward to self or loop.
- */
-export function resolveTaskRoute(opts) {
-    if (opts.device) {
-        return { kind: 'reject-device', message: REJECT_DEVICE_MESSAGE };
-    }
-    const self = opts.self ?? machineId();
-    if (opts.task) {
-        const binding = getTaskBinding(opts.task);
-        if (!binding) {
-            return { kind: 'unknown', task: opts.task, message: unknownTaskMessage(opts.task) };
-        }
-        return { kind: 'proceed', task: opts.task, device: binding.device };
-    }
-    const matches = tasksForCaller(opts.sessionId, opts.launchId);
-    if (matches.length > 1) {
-        return { kind: 'ambiguous', message: ambiguousTasksMessage(matches) };
-    }
-    if (matches.length === 1) {
-        const only = matches[0];
-        return { kind: 'proceed', task: only.name, device: only.device };
-    }
-    return { kind: 'proceed', device: opts.hub ?? self };
-}
-/**
- * The daemon sandboxes screenshot writes to the browser runtime dir, so `-o`
- * outside that dir is ignored there. The CLI process honors `-o` by copying
- * the captured file to the requested path. Same path → no copy.
- */
-export function honorScreenshotOutput(requested, daemonPath) {
-    if (!requested)
-        return daemonPath;
-    const dest = path.resolve(requested);
-    if (path.resolve(daemonPath) === dest)
-        return dest;
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(daemonPath, dest);
-    return dest;
-}