@phnx-labs/agents-cli 1.22.116 → 1.22.118

package/dist/commands/browser-picker.js

@@ -1,97 +0,0 @@
-/**
- * Interactive browser task picker with preview.
- *
- * Powers the fuzzy-searchable task list shown by `agents browser status` in a TTY.
- * Shows task name, profile, domains, and tab count; preview pane shows full tab list.
- */
-import chalk from 'chalk';
-import { truncate, humanDuration } from '../lib/format.js';
-import { itemPicker } from '../lib/picker.js';
-const DOT = chalk.gray(' · ');
-function formatAge(ms) {
-    return humanDuration(Date.now() - ms) + ' ago';
-}
-/** Build the preview pane for a browser task. */
-function buildBrowserPreview(item) {
-    const { task, profile } = item;
-    const lines = [];
-    // Line 1: Task name (ID: xxx)
-    lines.push(chalk.bold.white(`Task: ${task.name}`) + chalk.gray(` (${task.id})`));
-    // Line 2: Profile info
-    const profileParts = [chalk.cyan(profile.name)];
-    if (profile.port)
-        profileParts.push(`port ${profile.port}`);
-    if (profile.pid)
-        profileParts.push(`pid ${profile.pid}`);
-    lines.push(chalk.gray('Profile: ') + profileParts.join(DOT));
-    // Line 3: Timing
-    const started = formatAge(task.createdAt);
-    const duration = humanDuration(Date.now() - task.createdAt);
-    lines.push(chalk.gray('Started: ') + chalk.white(started) + DOT + chalk.gray('Duration: ') + chalk.white(duration));
-    // Blank line
-    lines.push('');
-    // Tabs section
-    if (task.tabs && task.tabs.length > 0) {
-        lines.push(chalk.gray('Tabs:'));
-        const termWidth = process.stdout.columns || 80;
-        const urlMax = Math.max(30, termWidth - 16);
-        for (const tab of task.tabs) {
-            const marker = tab.current ? chalk.yellow('*') : ' ';
-            const id = chalk.gray(tab.id);
-            const url = truncate(tab.url, urlMax);
-            lines.push(`  ${id} ${marker} ${chalk.white(url)}`);
-        }
-    }
-    else {
-        lines.push(chalk.gray('No tabs open'));
-    }
-    return lines.join('\n');
-}
-/** Build the list label for a browser task. */
-function buildBrowserLabel(item, query) {
-    const { task, profile } = item;
-    const termWidth = process.stdout.columns || 80;
-    // Format: name profile tabs domains age
-    const name = task.name.padEnd(20);
-    const profileName = profile.name.padEnd(12);
-    const tabs = `${task.tabCount} tab${task.tabCount === 1 ? '' : 's'}`.padEnd(8);
-    const age = formatAge(task.createdAt);
-    // Domains - fill remaining space
-    const fixedWidth = 20 + 12 + 8 + 10; // name + profile + tabs + age
-    const domainsWidth = Math.max(10, termWidth - fixedWidth - 4);
-    const domains = task.domains?.length
-        ? truncate(task.domains.join(', '), domainsWidth)
-        : chalk.gray('no sites');
-    // Highlight query matches
-    let label = `${name}${chalk.cyan(profileName)}${tabs}${domains.padEnd(domainsWidth)}${chalk.gray(age)}`;
-    if (query) {
-        const re = new RegExp(`(${query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')})`, 'gi');
-        label = label.replace(re, chalk.yellow.bold('$1'));
-    }
-    return label;
-}
-/** Show an interactive browser task picker. */
-export async function browserTaskPicker(config) {
-    const picked = await itemPicker({
-        message: config.message,
-        items: config.tasks,
-        filter: (query) => {
-            if (!query)
-                return config.tasks;
-            const q = query.toLowerCase();
-            return config.tasks.filter((t) => t.task.name.toLowerCase().includes(q) ||
-                t.profile.name.toLowerCase().includes(q) ||
-                t.task.domains?.some((d) => d.toLowerCase().includes(q)));
-        },
-        labelFor: buildBrowserLabel,
-        buildPreview: buildBrowserPreview,
-        shortIdFor: (t) => t.task.name,
-        pageSize: config.pageSize ?? 10,
-        initialSearch: config.initialSearch,
-        emptyMessage: 'No browser tasks running.',
-        enterHint: 'view tabs',
-    });
-    if (!picked)
-        return null;
-    return { task: picked.item, action: 'view' };
-}

package/dist/lib/browser/arc-discovery.d.ts

@@ -1,52 +0,0 @@
-interface ArcSpace {
-    /** Stable UUID used for every native operation. */
-    id: string;
-    /** Display-only title; empty when the Space is untitled. Never part of identity. */
-    title: string;
-}
-interface ArcProfile {
-    /** Arc's profile directory basename: the stable profile identity. */
-    profileId: string;
-    /** Display-only profile name from Local State. */
-    displayName: string;
-    spaces: ArcSpace[];
-}
-type ArcDiscoveryResult = {
-    ok: true;
-    profiles: ArcProfile[];
-    userDataDir: string;
-} | {
-    ok: false;
-    kind: 'unsupported' | 'not-installed' | 'invalid';
-    reason: string;
-};
-interface SidebarSpace {
-    id: string;
-    title: string;
-    profileId: string;
-}
-export declare function parseLocalStateProfiles(localStatePath: string): Map<string, string> | {
-    error: string;
-};
-export declare function parseSidebarSpaces(sidebarPath: string): SidebarSpace[] | {
-    error: string;
-};
-export declare function discoverArcProfilesAt(arcDir: string): ArcDiscoveryResult;
-export declare function discoverArcProfiles(): ArcDiscoveryResult;
-/** One Arc Space, flattened with the Arc profile it belongs to. */
-interface ArcSpaceProfile {
-    /** The agents-cli profile name: `arc-<space-title-slug>`. */
-    name: string;
-    profileId: string;
-    profileName: string;
-    spaceId: string;
-    spaceTitle: string;
-}
-/**
- * Flatten discovery into one agents-cli profile per Space (the concept agents
- * already know), named `arc-<space-title>`. Two Spaces with the same title get
- * the first six characters of their stable Space id appended, so the names
- * stay distinct without inventing a second selector.
- */
-export declare function arcSpaceProfiles(result: ArcDiscoveryResult): ArcSpaceProfile[];
-export {};

package/dist/lib/browser/arc-discovery.js

@@ -1,197 +0,0 @@
-/** Read-only Arc profile/Space discovery from Arc's native metadata. */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-function isRecord(value) {
-    return !!value && typeof value === 'object' && !Array.isArray(value);
-}
-/**
- * Arc's application-support root on this Mac. Arc keeps its Chromium `Local
- * State` under `<root>/User Data/` and its own sidebar model (Spaces and their
- * profile bindings) at `<root>/StorableSidebar.json` — two different levels,
- * so discovery is rooted here rather than at the Chromium user-data dir.
- * `AGENTS_ARC_DIR` points tests and non-default installs at another root.
- */
-function arcSupportDir() {
-    const override = process.env.AGENTS_ARC_DIR;
-    if (override)
-        return path.resolve(override);
-    if (process.platform !== 'darwin')
-        return undefined;
-    return path.join(os.homedir(), 'Library', 'Application Support', 'Arc');
-}
-export function parseLocalStateProfiles(localStatePath) {
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(localStatePath, 'utf8'));
-    }
-    catch (error) {
-        return {
-            error: error instanceof SyntaxError
-                ? 'Arc Local State is not valid JSON'
-                : `Cannot read Arc Local State: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-    if (!isRecord(parsed) || !isRecord(parsed.profile) || !isRecord(parsed.profile.info_cache)) {
-        return { error: 'Arc Local State has no profile.info_cache map' };
-    }
-    const profiles = new Map();
-    for (const [profileId, value] of Object.entries(parsed.profile.info_cache)) {
-        if (profileId === '__ARC_SYSTEM_PROFILE')
-            continue;
-        if (!isRecord(value) || typeof value.name !== 'string' || value.name.trim() === '') {
-            return { error: `Arc Local State profile ${JSON.stringify(profileId)} has no non-empty name` };
-        }
-        profiles.set(profileId, value.name);
-    }
-    return profiles;
-}
-function parseProfileId(value, spaceId) {
-    if (!isRecord(value)) {
-        return { error: `Arc Space ${JSON.stringify(spaceId)} has no profile mapping` };
-    }
-    if (value.default === true && value.custom === undefined)
-        return 'Default';
-    if (!isRecord(value.custom)) {
-        return { error: `Arc Space ${JSON.stringify(spaceId)} has an unknown profile mapping` };
-    }
-    const entries = Object.values(value.custom);
-    if (entries.length !== 1 || !isRecord(entries[0])) {
-        return { error: `Arc Space ${JSON.stringify(spaceId)} has an ambiguous custom profile mapping` };
-    }
-    const profileId = entries[0].directoryBasename;
-    if (typeof profileId !== 'string' || profileId.trim() === '') {
-        return { error: `Arc Space ${JSON.stringify(spaceId)} has no custom profile id` };
-    }
-    return profileId;
-}
-function parseTitle(value, spaceId) {
-    if (value === undefined || value === null)
-        return '';
-    if (typeof value === 'string')
-        return value;
-    return { error: `Arc Space ${JSON.stringify(spaceId)} has a non-text title` };
-}
-export function parseSidebarSpaces(sidebarPath) {
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(sidebarPath, 'utf8'));
-    }
-    catch (error) {
-        return {
-            error: error instanceof SyntaxError
-                ? 'Arc StorableSidebar.json is not valid JSON'
-                : `Cannot read Arc StorableSidebar.json: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-    if (!isRecord(parsed) || parsed.version !== 1) {
-        const version = isRecord(parsed) ? parsed.version : undefined;
-        return { error: `Unsupported StorableSidebar version: ${String(version)}` };
-    }
-    if (!isRecord(parsed.sidebar) || !Array.isArray(parsed.sidebar.containers)) {
-        return { error: 'StorableSidebar.json has no sidebar.containers array' };
-    }
-    const spaces = [];
-    const ids = new Set();
-    for (const container of parsed.sidebar.containers) {
-        if (!isRecord(container) || container.spaces === undefined)
-            continue;
-        if (!Array.isArray(container.spaces) || container.spaces.length % 2 !== 0) {
-            return { error: 'StorableSidebar.json contains a malformed alternating spaces array' };
-        }
-        for (let i = 0; i < container.spaces.length; i += 2) {
-            const encodedId = container.spaces[i];
-            const value = container.spaces[i + 1];
-            if (typeof encodedId !== 'string' || !isRecord(value)) {
-                return { error: `StorableSidebar.json contains a malformed Space at index ${i}` };
-            }
-            if (typeof value.id !== 'string' || value.id !== encodedId) {
-                return { error: `Arc Space key ${JSON.stringify(encodedId)} does not match its stable id` };
-            }
-            // Identity is the stable id and the profile binding. The title is
-            // display-only: Arc omits it for an untitled Space, which must still be
-            // listed (as `arc-space`) instead of taking every other Space down.
-            const title = parseTitle(value.title, encodedId);
-            if (typeof title !== 'string')
-                return title;
-            if (ids.has(encodedId)) {
-                return { error: `Arc Space ${JSON.stringify(encodedId)} appears more than once` };
-            }
-            const profileId = parseProfileId(value.profile, encodedId);
-            if (typeof profileId !== 'string')
-                return profileId;
-            ids.add(encodedId);
-            spaces.push({ id: encodedId, title, profileId });
-        }
-    }
-    return spaces;
-}
-export function discoverArcProfilesAt(arcDir) {
-    const userDataDir = path.join(arcDir, 'User Data');
-    if (!fs.existsSync(userDataDir)) {
-        return { ok: false, kind: 'not-installed', reason: `Arc user data directory not found: ${userDataDir}` };
-    }
-    const profileNames = parseLocalStateProfiles(path.join(userDataDir, 'Local State'));
-    if ('error' in profileNames)
-        return { ok: false, kind: 'invalid', reason: profileNames.error };
-    if (profileNames.size === 0) {
-        return { ok: false, kind: 'invalid', reason: 'No Arc profiles found in Local State' };
-    }
-    const spaces = parseSidebarSpaces(path.join(arcDir, 'StorableSidebar.json'));
-    if ('error' in spaces)
-        return { ok: false, kind: 'invalid', reason: spaces.error };
-    const profiles = new Map();
-    for (const [profileId, displayName] of profileNames) {
-        profiles.set(profileId, { profileId, displayName, spaces: [] });
-    }
-    for (const space of spaces) {
-        const profile = profiles.get(space.profileId);
-        if (!profile) {
-            return {
-                ok: false,
-                kind: 'invalid',
-                reason: `Arc Space ${JSON.stringify(space.id)} maps to unknown profile ${JSON.stringify(space.profileId)}`,
-            };
-        }
-        profile.spaces.push({ id: space.id, title: space.title });
-    }
-    return { ok: true, profiles: [...profiles.values()], userDataDir };
-}
-export function discoverArcProfiles() {
-    const arcDir = arcSupportDir();
-    if (!arcDir) {
-        return { ok: false, kind: 'unsupported', reason: 'Arc is not supported on this platform' };
-    }
-    return discoverArcProfilesAt(arcDir);
-}
-function slugify(value) {
-    return value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-}
-/**
- * Flatten discovery into one agents-cli profile per Space (the concept agents
- * already know), named `arc-<space-title>`. Two Spaces with the same title get
- * the first six characters of their stable Space id appended, so the names
- * stay distinct without inventing a second selector.
- */
-export function arcSpaceProfiles(result) {
-    if (!result.ok)
-        return [];
-    const flat = [];
-    for (const profile of result.profiles) {
-        for (const space of profile.spaces) {
-            flat.push({
-                name: `arc-${slugify(space.title) || 'space'}`,
-                profileId: profile.profileId,
-                profileName: profile.displayName,
-                spaceId: space.id,
-                spaceTitle: space.title,
-            });
-        }
-    }
-    const counts = new Map();
-    for (const entry of flat)
-        counts.set(entry.name, (counts.get(entry.name) ?? 0) + 1);
-    return flat.map((entry) => (counts.get(entry.name) ?? 0) > 1
-        ? { ...entry, name: `${entry.name}-${slugify(entry.spaceId).slice(0, 6)}` }
-        : entry);
-}

package/dist/lib/browser/arc-dom.d.ts

@@ -1,14 +0,0 @@
-import type { RefNode, RefOpts } from './refs.js';
-/** Build one synchronous expression that reads DOM-backed refs from native Arc. */
-export declare function arcRefsExpression(opts?: RefOpts): string;
-export declare function parseArcRefsResult(value: unknown, opts?: RefOpts): {
-    refs: string;
-    nodeMap: Map<number, RefNode>;
-    opts: {
-        interactive: boolean;
-        limit: number;
-    };
-};
-export declare function arcClickExpression(selector: string): string;
-export declare function arcFillExpression(selector: string, text: string, clear?: boolean): string;
-export declare function arcScrollExpression(deltaX: number, deltaY: number): string;

package/dist/lib/browser/arc-dom.js

@@ -1,121 +0,0 @@
-import { truncate } from '../format.js';
-const INTERACTIVE_SELECTOR = [
-    'a[href]', 'button', 'input', 'select', 'textarea', '[contenteditable="true"]',
-    '[role="button"]', '[role="link"]', '[role="textbox"]', '[role="checkbox"]',
-    '[role="radio"]', '[role="combobox"]', '[role="listbox"]', '[role="option"]',
-    '[role="menuitem"]', '[role="tab"]', '[role="slider"]', '[role="spinbutton"]',
-    '[role="searchbox"]', '[role="switch"]', '[role="treeitem"]',
-].join(',');
-/** Build one synchronous expression that reads DOM-backed refs from native Arc. */
-export function arcRefsExpression(opts = {}) {
-    const interactive = opts.interactive ?? true;
-    const limit = opts.limit ?? 500;
-    return `(() => {
-    const selectorFor = (el) => {
-      if (el.id) return '#' + CSS.escape(el.id);
-      const parts = [];
-      for (let node = el; node && node.nodeType === 1 && node !== document.documentElement; node = node.parentElement) {
-        let part = node.localName;
-        if (!part) return '';
-        const siblings = node.parentElement ? Array.from(node.parentElement.children).filter((s) => s.localName === node.localName) : [];
-        if (siblings.length > 1) part += ':nth-of-type(' + (siblings.indexOf(node) + 1) + ')';
-        parts.unshift(part);
-      }
-      return parts.join(' > ');
-    };
-    const roleFor = (el) => {
-      const explicit = el.getAttribute('role');
-      if (explicit) return explicit.toLowerCase();
-      if (el.matches('button')) return 'button';
-      if (el.matches('a[href]')) return 'link';
-      if (el.matches('textarea,[contenteditable="true"]')) return 'textbox';
-      if (el.matches('select')) return 'combobox';
-      if (el.matches('input')) {
-        const type = (el.getAttribute('type') || 'text').toLowerCase();
-        if (type === 'checkbox') return 'checkbox';
-        if (type === 'radio') return 'radio';
-        if (type === 'range') return 'slider';
-        if (type === 'number') return 'spinbutton';
-        return 'textbox';
-      }
-      return el.localName || 'generic';
-    };
-    const nameFor = (el) => el.getAttribute('aria-label') || el.getAttribute('title') ||
-      (el.labels && el.labels[0] && el.labels[0].innerText) || el.innerText || el.value || el.getAttribute('placeholder') || '';
-    const attrsFor = (el) => ['disabled','checked','selected','expanded','required','readonly','invalid']
-      .filter((name) => el[name] === true || el.getAttribute('aria-' + name) === 'true');
-    const editorFor = (el) => {
-      for (let node = el, i = 0; node && i < 6; node = node.parentElement, i++) {
-        if (node.hasAttribute('data-lexical-editor')) return 'lexical';
-        if (node.classList.contains('ProseMirror')) return 'prosemirror';
-        if (node.hasAttribute('data-slate-editor')) return 'slate';
-        if (Array.from(node.classList).some((c) => /^DraftEditor-/.test(c))) return 'draft';
-        if (node.classList.contains('ql-editor')) return 'quill';
-        if (node.classList.contains('ck-editor__editable')) return 'ckeditor5';
-        if (node.tagName === 'TRIX-EDITOR') return 'trix';
-      }
-      return undefined;
-    };
-    const source = ${interactive ? `document.querySelectorAll(${JSON.stringify(INTERACTIVE_SELECTOR)})` : `document.querySelectorAll('body *')`};
-    const rows = [];
-    for (const el of source) {
-      if (rows.length >= ${JSON.stringify(limit)}) break;
-      const selector = selectorFor(el);
-      if (!selector) continue;
-      const row = { role: roleFor(el), name: String(nameFor(el)).trim(), attrs: attrsFor(el), selector };
-      const editor = editorFor(el);
-      if (editor) row.editor = editor;
-      rows.push(row);
-    }
-    return JSON.stringify(rows);
-  })()`;
-}
-export function parseArcRefsResult(value, opts = {}) {
-    const parsed = typeof value === 'string' ? JSON.parse(value) : value;
-    if (!Array.isArray(parsed))
-        throw new Error('Arc returned an invalid DOM ref listing.');
-    const nodeMap = new Map();
-    const lines = [];
-    const compact = opts.compact ?? false;
-    parsed.forEach((raw, index) => {
-        const row = raw;
-        if (typeof row.role !== 'string' || typeof row.name !== 'string' ||
-            typeof row.selector !== 'string' || !Array.isArray(row.attrs) ||
-            !row.attrs.every((attr) => typeof attr === 'string')) {
-            throw new Error('Arc returned an invalid DOM ref entry.');
-        }
-        const ref = index + 1;
-        const node = { ref, role: row.role, name: row.name, attrs: row.attrs, selector: row.selector };
-        if (typeof row.editor === 'string')
-            node.editor = row.editor;
-        nodeMap.set(ref, node);
-        const name = row.name ? ` "${truncate(row.name, 50)}"` : '';
-        const attrs = row.attrs.length ? ` [${row.attrs.join('] [')}]` : '';
-        const editor = row.editor ? ` [editor=${row.editor}]` : '';
-        lines.push(`${compact ? '' : '- '}${row.role}${name} [ref=${ref}]${attrs}${editor}`);
-    });
-    return { refs: lines.join('\n'), nodeMap, opts: { interactive: opts.interactive ?? true, limit: opts.limit ?? 500 } };
-}
-export function arcClickExpression(selector) {
-    return `(() => { const el = document.querySelector(${JSON.stringify(selector)}); if (!el) throw new Error('DOM ref is missing'); el.click(); return true; })()`;
-}
-export function arcFillExpression(selector, text, clear = true) {
-    return `(() => {
-    const el = document.querySelector(${JSON.stringify(selector)});
-    if (!el) throw new Error('DOM ref is missing');
-    const next = ${JSON.stringify(text)};
-    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
-      const proto = el instanceof HTMLInputElement ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
-      const setter = Object.getOwnPropertyDescriptor(proto, 'value').set;
-      setter.call(el, ${clear ? 'next' : 'el.value + next'});
-    } else if (el.isContentEditable) {
-      el.textContent = ${clear ? 'next' : '(el.textContent || "") + next'};
-    } else throw new Error('DOM ref is not editable');
-    el.dispatchEvent(new InputEvent('input', { bubbles: true, inputType: 'insertText', data: next }));
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-    return true;
-  })()`;
-}
-export function arcScrollExpression(deltaX, deltaY) {
-    return `(() => { window.scrollBy(${JSON.stringify(deltaX)}, ${JSON.stringify(deltaY)}); return true; })()`;
-}

package/dist/lib/browser/caller-identity.d.ts

@@ -1,40 +0,0 @@
-export interface CallerIdentity {
-    actor: string;
-    launchId?: string;
-    sessionId?: string;
-    /** Agent pid when identity came from the process-table anchor. */
-    agentPid?: number;
-}
-/**
- * Resolve caller identity once per CLI process for browser IPC stamping.
- *
- * Starts from `process.ppid` — the shell or harness that launched this
- * `agents browser` invocation — and walks up until a state file or known
- * agent comm is found.
- */
-export declare function resolveCallerIdentity(env?: NodeJS.ProcessEnv): CallerIdentity;
-/**
- * The env a `browser --device` dispatch forwards so the HUB resolves the SAME
- * caller identity the worker would stamp locally. Without it a forwarded verb
- * lands on the hub with BLANK identity, and the daemon's no-identity task bucket
- * matches any other no-identity task — so a cold verb could attach to (or a
- * `done`/`stop` could close) an unrelated agent's or a human's browser. This is
- * the same surface-parity fix the `run --device` path already carries via
- * `--env AGENT_LAUNCH_ID` (remote-session-id.ts). Absent fields are omitted so a
- * genuinely-unidentifiable caller forwards nothing rather than an empty string
- * that would read as a real (blank) identity on the far side.
- */
-export declare function callerIdentityEnv(caller: Pick<CallerIdentity, 'sessionId' | 'launchId'>): Record<string, string>;
-/**
- * True when a live task belongs to this caller. Match on sessionId or
- * launchId — either is enough. A task with no recorded identity never
- * matches a caller that has one (and vice versa for the no-identity case
- * handled separately by the resolver).
- */
-export declare function taskMatchesCaller(task: {
-    sessionId?: string;
-    launchId?: string;
-}, caller: {
-    sessionId?: string;
-    launchId?: string;
-}): boolean;