@phnx-labs/agents-cli 1.22.117 → 1.22.118

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

@@ -1,28 +0,0 @@
-import type { BrowserType } from './types.js';
-interface ChromiumNativeProfile {
-    browser: BrowserType;
-    /** The agents-cli profile name: `<browser>-<display-name-slug>`. */
-    name: string;
-    /** The browser's user-data dir (its own, never a cache dir). */
-    userDataDir: string;
-    /** Profile directory basename inside the user-data dir. Authoritative id. */
-    profileDirectory: string;
-    /** Display-only name from Local State. */
-    displayName: string;
-}
-type ChromiumDiscoveryResult = {
-    ok: true;
-    profiles: ChromiumNativeProfile[];
-    userDataDir: string;
-} | {
-    ok: false;
-    kind: 'unsupported' | 'not-installed' | 'invalid';
-    reason: string;
-};
-/** The browser's own user-data dir on this platform, or undefined where it does not ship. */
-export declare function chromiumUserDataDir(browser: BrowserType): string | undefined;
-export declare function discoverChromiumProfilesAt(browser: BrowserType, userDataDir: string): ChromiumDiscoveryResult;
-export declare function discoverChromiumProfiles(browser: BrowserType): ChromiumDiscoveryResult;
-/** Every browser whose native profiles agents-cli discovers on this platform. */
-export declare function discoverableChromiumBrowsers(): BrowserType[];
-export {};

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

@@ -1,96 +0,0 @@
-/**
- * Read-only discovery of a Chromium-family browser's OWN profiles (PHNX-4042).
- *
- * Chromium keeps its profiles under one user-data dir: `Local State` lists them
- * in `profile.info_cache` keyed by directory (`Default`, `Profile 1`, ...) with
- * the display name the user sees in the profile menu. Each entry becomes one
- * agents-cli profile (`comet-work`, ...) pinned to that dir and directory, so
- * the owner and agents share ONE window per profile instead of agents spawning
- * a rival instance under a cache dir. Nothing here writes to the browser's
- * files.
- */
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-/** Browsers whose native profiles are discovered, and the env var that points tests at another user-data dir. */
-const NATIVE_CHROMIUM = {
-    comet: { dirName: 'Comet', envOverride: 'AGENTS_COMET_DIR' },
-};
-/** The browser's own user-data dir on this platform, or undefined where it does not ship. */
-export function chromiumUserDataDir(browser) {
-    const entry = NATIVE_CHROMIUM[browser];
-    if (!entry)
-        return undefined;
-    const override = process.env[entry.envOverride];
-    if (override)
-        return path.resolve(override);
-    if (process.platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', entry.dirName);
-    }
-    if (process.platform === 'win32') {
-        const local = process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local');
-        return path.join(local, entry.dirName, 'User Data');
-    }
-    return undefined;
-}
-function isRecord(value) {
-    return !!value && typeof value === 'object' && !Array.isArray(value);
-}
-function slugify(value) {
-    return value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-}
-export function discoverChromiumProfilesAt(browser, userDataDir) {
-    const localState = path.join(userDataDir, 'Local State');
-    if (!fs.existsSync(localState)) {
-        return { ok: false, kind: 'not-installed', reason: `${browser} Local State not found: ${localState}` };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(localState, 'utf8'));
-    }
-    catch (error) {
-        return {
-            ok: false,
-            kind: 'invalid',
-            reason: error instanceof SyntaxError
-                ? `${browser} Local State is not valid JSON`
-                : `Cannot read ${browser} Local State: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-    if (!isRecord(parsed) || !isRecord(parsed.profile) || !isRecord(parsed.profile.info_cache)) {
-        return { ok: false, kind: 'invalid', reason: `${browser} Local State has no profile.info_cache map` };
-    }
-    const rows = [];
-    for (const [profileDirectory, value] of Object.entries(parsed.profile.info_cache)) {
-        if (!isRecord(value) || typeof value.name !== 'string' || value.name.trim() === '') {
-            return { ok: false, kind: 'invalid', reason: `${browser} Local State profile ${JSON.stringify(profileDirectory)} has no non-empty name` };
-        }
-        rows.push({
-            browser,
-            name: `${browser}-${slugify(value.name) || 'profile'}`,
-            userDataDir,
-            profileDirectory,
-            displayName: value.name,
-        });
-    }
-    // Two profiles with the same display name stay distinct by their directory.
-    const counts = new Map();
-    for (const row of rows)
-        counts.set(row.name, (counts.get(row.name) ?? 0) + 1);
-    return {
-        ok: true,
-        userDataDir,
-        profiles: rows.map((row) => (counts.get(row.name) ?? 0) > 1 ? { ...row, name: `${row.name}-${slugify(row.profileDirectory)}` } : row),
-    };
-}
-export function discoverChromiumProfiles(browser) {
-    const userDataDir = chromiumUserDataDir(browser);
-    if (!userDataDir) {
-        return { ok: false, kind: 'unsupported', reason: `${browser} profiles are not discovered on this platform` };
-    }
-    return discoverChromiumProfilesAt(browser, userDataDir);
-}
-/** Every browser whose native profiles agents-cli discovers on this platform. */
-export function discoverableChromiumBrowsers() {
-    return Object.keys(NATIVE_CHROMIUM).filter((browser) => chromiumUserDataDir(browser) !== undefined);
-}

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

@@ -1,34 +0,0 @@
-import type { DeviceDescriptor } from './types.js';
-/**
- * Default viewport for newly-created profiles. Matches Safari's logical
- * resolution on a 14-inch MacBook Pro (M1/M2/M3 Pro/Max) — the most common
- * shape this CLI sees in practice. Shared with the `MacBook Pro` device
- * preset below so both surfaces agree.
- */
-export declare const DEFAULT_VIEWPORT: {
-    readonly width: 1512;
-    readonly height: 982;
-    readonly deviceScaleFactor: 2;
-};
-export declare const DEVICES: Record<string, DeviceDescriptor>;
-export declare function getDevice(name: string): DeviceDescriptor | undefined;
-export declare function listDevices(): string[];
-/**
- * Parse a `--window WxH` value. Returns null when the value is malformed, so
- * callers emit their own actionable error.
- *
- * Shared by `profiles create` and `profiles edit` — one regex, one test, no
- * drift between the two surfaces.
- */
-export declare function parseWindowSize(raw: string): {
-    width: number;
-    height: number;
-} | null;
-/**
- * Parse a `--position X,Y` value. Negative coordinates are valid — a window may
- * sit on a display left of or above the primary one.
- */
-export declare function parseWindowPosition(raw: string): {
-    x: number;
-    y: number;
-} | null;

package/dist/lib/browser/devices.js

@@ -1,61 +0,0 @@
-/**
- * Default viewport for newly-created profiles. Matches Safari's logical
- * resolution on a 14-inch MacBook Pro (M1/M2/M3 Pro/Max) — the most common
- * shape this CLI sees in practice. Shared with the `MacBook Pro` device
- * preset below so both surfaces agree.
- */
-export const DEFAULT_VIEWPORT = {
-    width: 1512,
-    height: 982,
-    deviceScaleFactor: 2,
-};
-export const DEVICES = {
-    'iPhone 14': {
-        width: 390,
-        height: 844,
-        deviceScaleFactor: 3,
-        mobile: true,
-    },
-    'iPad': {
-        width: 768,
-        height: 1024,
-        deviceScaleFactor: 2,
-        mobile: true,
-    },
-    'MacBook Pro': {
-        width: DEFAULT_VIEWPORT.width,
-        height: DEFAULT_VIEWPORT.height,
-        deviceScaleFactor: DEFAULT_VIEWPORT.deviceScaleFactor,
-        mobile: false,
-    },
-};
-export function getDevice(name) {
-    const key = Object.keys(DEVICES).find((k) => k.toLowerCase() === name.toLowerCase());
-    return key ? DEVICES[key] : undefined;
-}
-export function listDevices() {
-    return Object.keys(DEVICES);
-}
-/**
- * Parse a `--window WxH` value. Returns null when the value is malformed, so
- * callers emit their own actionable error.
- *
- * Shared by `profiles create` and `profiles edit` — one regex, one test, no
- * drift between the two surfaces.
- */
-export function parseWindowSize(raw) {
-    const m = String(raw).match(/^(\d+)x(\d+)$/);
-    if (!m)
-        return null;
-    return { width: parseInt(m[1], 10), height: parseInt(m[2], 10) };
-}
-/**
- * Parse a `--position X,Y` value. Negative coordinates are valid — a window may
- * sit on a display left of or above the primary one.
- */
-export function parseWindowPosition(raw) {
-    const m = String(raw).match(/^(-?\d+),(-?\d+)$/);
-    if (!m)
-        return null;
-    return { x: parseInt(m[1], 10), y: parseInt(m[2], 10) };
-}

package/dist/lib/browser/domain-skills.d.ts

@@ -1,71 +0,0 @@
-/**
- * Domain-skill discovery for `agents browser start`.
- *
- * When a browser task opens a URL, look up a site-specific SKILL.md from
- * `skills/browser/domain-skills/<dir>/SKILL.md` in the layered DotAgents
- * repos — project > user > system, first layer with a match wins, the same
- * precedence `resolveResource` in `../resources.ts` applies — and surface its
- * contents so the calling agent gets per-site operating instructions
- * (selectors, gotchas, sign-in quirks) before it starts driving the page.
- *
- * Matching is intentionally simple: derive the hostname's second-level
- * label (e.g. `perplexity` from `perplexity.ai`, `slack` from `app.slack.com`)
- * and look for a directory of the same name. If the user wants a different
- * mapping (e.g. `mail.google.com` -> `gmail/`), they can pin it via a
- * `domains: [...]` array in the SKILL.md frontmatter; that override beats
- * the directory-name match.
- */
-/** Result of resolving a URL to a domain-skill. */
-export interface ResolvedDomainSkill {
-    /** Skill identifier — the directory name under domain-skills/. */
-    name: string;
-    /** Absolute path to the SKILL.md that was matched. */
-    path: string;
-    /** Full SKILL.md contents (frontmatter included). */
-    content: string;
-    /** Hostname the match was made against (post-www strip). */
-    hostname: string;
-}
-/**
- * Where domain-skills live, in precedence order: project > user > system >
- * extra repos — the same layering `resolveResource` applies. A layer whose
- * root does not exist is simply skipped at resolve time.
- *
- * The project layer resolves from `cwd` (default `process.cwd()`). The
- * browser daemon is shared and long-lived, and its IPC request does not yet
- * carry the calling CLI's cwd, so at that call site the project layer follows
- * the daemon's own cwd until the caller's cwd is threaded through
- * (RUSH-2996); user/system/extra-repo layers are cwd-independent.
- *
- * $AGENTS_BROWSER_DOMAIN_SKILLS_DIR overrides the whole list with a single
- * root, for tests.
- */
-export declare function domainSkillsRoots(cwd?: string): string[];
-/**
- * Derive match candidates from a hostname. Order matters — earlier candidates
- * are tried first.
- *
- * Examples:
- *   perplexity.ai      -> ['perplexity.ai', 'perplexity']
- *   app.slack.com      -> ['app.slack.com', 'slack.com', 'slack']
- *   mail.google.com    -> ['mail.google.com', 'google.com', 'google', 'mail']
- *   higgsfield.ai      -> ['higgsfield.ai', 'higgsfield']
- */
-export declare function hostnameMatchCandidates(hostname: string): string[];
-/**
- * Resolve a URL to its matching domain-skill, or null if none.
- *
- * Roots are searched in `domainSkillsRoots` order (project > user > system);
- * the first layer with a match wins outright — an earlier layer's
- * directory-name match beats a later layer's `domains:` pin, mirroring
- * `resolveResource`'s layer precedence. Within one layer, two passes:
- *   1. Index every SKILL.md in the root and read its `domains:` frontmatter.
- *      If any pinned domain matches a candidate, return that skill.
- *   2. Fall back to directory-name match against the candidate list.
- *
- * Errors (missing root, unreadable file, invalid URL) are swallowed and
- * yield null — domain-skill discovery must never break browser start. A miss
- * logs the roots searched at debug level (AGENTS_DEBUG/DEBUG) so a skill
- * sitting in an unsearched layer is diagnosable rather than silent.
- */
-export declare function resolveDomainSkill(url: string, cwd?: string): ResolvedDomainSkill | null;

package/dist/lib/browser/domain-skills.js

@@ -1,195 +0,0 @@
-/**
- * Domain-skill discovery for `agents browser start`.
- *
- * When a browser task opens a URL, look up a site-specific SKILL.md from
- * `skills/browser/domain-skills/<dir>/SKILL.md` in the layered DotAgents
- * repos — project > user > system, first layer with a match wins, the same
- * precedence `resolveResource` in `../resources.ts` applies — and surface its
- * contents so the calling agent gets per-site operating instructions
- * (selectors, gotchas, sign-in quirks) before it starts driving the page.
- *
- * Matching is intentionally simple: derive the hostname's second-level
- * label (e.g. `perplexity` from `perplexity.ai`, `slack` from `app.slack.com`)
- * and look for a directory of the same name. If the user wants a different
- * mapping (e.g. `mail.google.com` -> `gmail/`), they can pin it via a
- * `domains: [...]` array in the SKILL.md frontmatter; that override beats
- * the directory-name match.
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { getEnabledExtraRepos, getProjectAgentsDir, getSystemAgentsDir, getUserAgentsDir, } from '../state.js';
-/**
- * Where domain-skills live, in precedence order: project > user > system >
- * extra repos — the same layering `resolveResource` applies. A layer whose
- * root does not exist is simply skipped at resolve time.
- *
- * The project layer resolves from `cwd` (default `process.cwd()`). The
- * browser daemon is shared and long-lived, and its IPC request does not yet
- * carry the calling CLI's cwd, so at that call site the project layer follows
- * the daemon's own cwd until the caller's cwd is threaded through
- * (RUSH-2996); user/system/extra-repo layers are cwd-independent.
- *
- * $AGENTS_BROWSER_DOMAIN_SKILLS_DIR overrides the whole list with a single
- * root, for tests.
- */
-export function domainSkillsRoots(cwd) {
-    const override = process.env.AGENTS_BROWSER_DOMAIN_SKILLS_DIR;
-    if (override)
-        return [override];
-    const sub = ['skills', 'browser', 'domain-skills'];
-    const roots = [];
-    const projectDir = getProjectAgentsDir(cwd);
-    if (projectDir)
-        roots.push(path.join(projectDir, ...sub));
-    roots.push(path.join(getUserAgentsDir(), ...sub));
-    roots.push(path.join(getSystemAgentsDir(), ...sub));
-    for (const extra of getEnabledExtraRepos()) {
-        roots.push(path.join(extra.dir, ...sub));
-    }
-    return roots;
-}
-/**
- * Derive match candidates from a hostname. Order matters — earlier candidates
- * are tried first.
- *
- * Examples:
- *   perplexity.ai      -> ['perplexity.ai', 'perplexity']
- *   app.slack.com      -> ['app.slack.com', 'slack.com', 'slack']
- *   mail.google.com    -> ['mail.google.com', 'google.com', 'google', 'mail']
- *   higgsfield.ai      -> ['higgsfield.ai', 'higgsfield']
- */
-export function hostnameMatchCandidates(hostname) {
-    const cleaned = hostname.toLowerCase().replace(/^www\./, '');
-    if (!cleaned)
-        return [];
-    const parts = cleaned.split('.').filter(Boolean);
-    const out = new Set();
-    out.add(cleaned);
-    // Progressive label-stripping from the left: app.slack.com -> slack.com.
-    for (let i = 1; i < parts.length; i++) {
-        out.add(parts.slice(i).join('.'));
-    }
-    // Second-level label without TLD: app.slack.com -> slack, perplexity.ai -> perplexity.
-    if (parts.length >= 2) {
-        out.add(parts[parts.length - 2]);
-    }
-    // First label too, so mail.google.com can resolve a `mail` dir if that's how
-    // the user organized their skills. Last so explicit second-level wins.
-    if (parts.length >= 2) {
-        out.add(parts[0]);
-    }
-    return Array.from(out);
-}
-/** Parse a SKILL.md's frontmatter `domains:` list, if any. Best-effort, no schema. */
-function parseDomainsFrontmatter(content) {
-    // Frontmatter must be at file start: ---\n...\n---\n
-    if (!content.startsWith('---'))
-        return [];
-    const end = content.indexOf('\n---', 3);
-    if (end < 0)
-        return [];
-    const fm = content.slice(3, end);
-    // Inline array form: domains: [a, b, c]
-    const inline = fm.match(/^domains:\s*\[([^\]]*)\]/m);
-    if (inline) {
-        return inline[1]
-            .split(',')
-            .map((s) => s.trim().replace(/^["']|["']$/g, '').toLowerCase())
-            .filter(Boolean);
-    }
-    // Block list form:
-    //   domains:
-    //     - a
-    //     - b
-    const block = fm.match(/^domains:\s*\n((?:\s+-\s+\S+\n?)+)/m);
-    if (block) {
-        return block[1]
-            .split('\n')
-            .map((line) => line.replace(/^\s*-\s*/, '').trim().replace(/^["']|["']$/g, '').toLowerCase())
-            .filter(Boolean);
-    }
-    return [];
-}
-/** Stderr debug line, gated on AGENTS_DEBUG/DEBUG — same convention as `../teams/debug.ts`. */
-function debug(message) {
-    if (process.env.AGENTS_DEBUG || process.env.DEBUG)
-        console.error(message);
-}
-/**
- * Resolve a URL to its matching domain-skill, or null if none.
- *
- * Roots are searched in `domainSkillsRoots` order (project > user > system);
- * the first layer with a match wins outright — an earlier layer's
- * directory-name match beats a later layer's `domains:` pin, mirroring
- * `resolveResource`'s layer precedence. Within one layer, two passes:
- *   1. Index every SKILL.md in the root and read its `domains:` frontmatter.
- *      If any pinned domain matches a candidate, return that skill.
- *   2. Fall back to directory-name match against the candidate list.
- *
- * Errors (missing root, unreadable file, invalid URL) are swallowed and
- * yield null — domain-skill discovery must never break browser start. A miss
- * logs the roots searched at debug level (AGENTS_DEBUG/DEBUG) so a skill
- * sitting in an unsearched layer is diagnosable rather than silent.
- */
-export function resolveDomainSkill(url, cwd) {
-    let hostname;
-    try {
-        hostname = new URL(url).hostname;
-    }
-    catch {
-        return null;
-    }
-    if (!hostname)
-        return null;
-    const candidates = hostnameMatchCandidates(hostname);
-    if (candidates.length === 0)
-        return null;
-    const candidateSet = new Set(candidates);
-    const roots = domainSkillsRoots(cwd);
-    for (const root of roots) {
-        let entries;
-        try {
-            entries = fs.readdirSync(root, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        const indexed = [];
-        for (const e of entries) {
-            if (!e.isDirectory())
-                continue;
-            const skillPath = path.join(root, e.name, 'SKILL.md');
-            let content;
-            try {
-                content = fs.readFileSync(skillPath, 'utf-8');
-            }
-            catch {
-                continue;
-            }
-            indexed.push({
-                name: e.name,
-                skillPath,
-                content,
-                pinned: parseDomainsFrontmatter(content),
-            });
-        }
-        // Pass 1: explicit `domains:` overrides.
-        for (const s of indexed) {
-            for (const d of s.pinned) {
-                if (candidateSet.has(d)) {
-                    return { name: s.name, path: s.skillPath, content: s.content, hostname };
-                }
-            }
-        }
-        // Pass 2: directory-name match, walking candidates in priority order.
-        const byName = new Map(indexed.map((s) => [s.name.toLowerCase(), s]));
-        for (const c of candidates) {
-            const hit = byName.get(c);
-            if (hit) {
-                return { name: hit.name, path: hit.skillPath, content: hit.content, hostname };
-            }
-        }
-    }
-    debug(`[browser] no domain-skill for ${hostname}; searched: ${roots.join(', ')}`);
-    return null;
-}

package/dist/lib/browser/drivers/arc.d.ts

@@ -1,40 +0,0 @@
-export interface ArcNativeTabRef {
-    windowId: string;
-    spaceId: string;
-    tabId: string;
-}
-interface ArcNativeTab extends ArcNativeTabRef {
-    url: string;
-    title: string;
-}
-export interface ArcEnumeratedSpace {
-    windowId: string;
-    spaceId: string;
-    spaceTitle: string;
-    activeTabId?: string;
-    tabs: ArcNativeTab[];
-}
-export declare class ArcNativeCapabilityError extends Error {
-    readonly capability: string;
-    constructor(capability: string, message?: string);
-}
-export declare function isArcRunning(): Promise<boolean>;
-export declare function enumerateArcSpaces(): Promise<ArcEnumeratedSpace[]>;
-/** Caller durably records marker intent before calling; never use a real page URL as ownership. */
-export declare function createArcTab(target: Pick<ArcNativeTabRef, 'windowId' | 'spaceId'>, markerUrl: string): Promise<ArcNativeTab>;
-export declare function resolveArcTab(ref: ArcNativeTabRef): Promise<ArcNativeTab | null>;
-export declare function navigateArcTab(ref: ArcNativeTabRef, url: string): Promise<void>;
-/** Arc serializes a returned object once. JSON.stringify at the top level would double-encode. */
-export declare function executeJavaScript(ref: ArcNativeTabRef, expression: string): Promise<unknown>;
-export declare function closeArcTab(ref: ArcNativeTabRef): Promise<'closed' | 'missing'>;
-/** Explicit user-facing focus only. Evaluation and cleanup never invoke this. */
-export declare function selectArcTab(ref: ArcNativeTabRef): Promise<void>;
-/**
- * Select `tabId` wherever it lives in window `windowId` (any Space). Used to put
- * the owner back on their tab after a creation that failed mid-way, when there is
- * no owned tab to check against. Returns false when the tab is gone.
- */
-export declare function selectWindowTab(windowId: string, tabId: string): Promise<boolean>;
-/** Restore only while the task's new tab is still selected; preserve a later human choice. */
-export declare function restoreArcSelection(owned: ArcNativeTabRef, previousTabId: string): Promise<boolean>;
-export {};