@phnx-labs/agents-cli 1.22.117 → 1.22.118

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;

package/dist/lib/browser/caller-identity.js

@@ -1,175 +0,0 @@
-/**
- * Resolve the agent identity of whoever invoked `agents browser`.
- *
- * The browser daemon is shared and long-lived, so identity must be captured in
- * the CLI process and forwarded over IPC. Order:
- *
- *   1. Env already set by `agents run` (`AGENT_SESSION_ID` / `AGENT_LAUNCH_ID`)
- *   2. Session-tracker state file under `~/.agents/.cache/terminals/sessions/`
- *      (and the deployed fleet path under `state/sessions/`), keyed by
- *      process.ppid and walked up the ancestor chain
- *   3. Process-table anchor — nearest ancestor whose comm maps to a known
- *      harness via `agentKindFromComm` (derived from SESSION_AGENTS)
- *
- * No per-harness env-var table: the state-file reader and the process-table
- * classifier cover every harness by construction.
- */
-import { execFileSync } from 'child_process';
-import { resolveActor } from '../actor.js';
-import { agentKindFromComm } from '../session/active.js';
-import { loadHookSessionIndex, readStateSessionRecord, } from '../session/hook-sessions.js';
-const MAX_ANCESTOR_WALK = 16;
-/**
- * Read pid→ppid→comm for one process. Returns null when the process is gone
- * or `ps` fails.
- */
-function readProc(pid) {
-    if (!pid || pid <= 1)
-        return null;
-    try {
-        const out = execFileSync('ps', ['-p', String(pid), '-o', 'pid=,ppid=,comm='], {
-            encoding: 'utf8',
-            timeout: 1000,
-        }).trim();
-        const m = out.match(/^(\d+)\s+(\d+)\s+(.+)$/);
-        if (!m)
-            return null;
-        return {
-            pid: parseInt(m[1], 10),
-            ppid: parseInt(m[2], 10),
-            comm: m[3].trim(),
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Walk ancestors starting at `startPid` (inclusive). Yields each pid once.
- */
-function* ancestorPids(startPid) {
-    let cur = startPid;
-    const seen = new Set();
-    for (let i = 0; i < MAX_ANCESTOR_WALK && cur > 1 && !seen.has(cur); i++) {
-        seen.add(cur);
-        yield cur;
-        const proc = readProc(cur);
-        if (!proc)
-            return;
-        cur = proc.ppid;
-    }
-}
-/**
- * Look up a session-tracker / deployed-hook state record for `pid`.
- * Prefers the richer terminals/sessions index; falls back to the fleet
- * state/sessions path (RUSH-2007).
- */
-function stateForPid(pid, index) {
-    const fromIndex = index.byPid.get(pid);
-    if (fromIndex?.session_id)
-        return fromIndex;
-    return readStateSessionRecord(pid);
-}
-/**
- * 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 function resolveCallerIdentity(env = process.env) {
-    const actor = resolveActor().id;
-    let sessionId = env.AGENT_SESSION_ID || env.AGENTS_SESSION_ID || undefined;
-    let launchId = env.AGENT_LAUNCH_ID || undefined;
-    let agentPid;
-    if (sessionId && launchId) {
-        return { actor, sessionId, launchId };
-    }
-    // Start at ppid: when an agent runs a Bash tool call, the browser CLI's
-    // parent is that shell (or the agent itself when launched directly).
-    const startPid = typeof process.ppid === 'number' && process.ppid > 0 ? process.ppid : 0;
-    if (startPid > 0) {
-        let index;
-        try {
-            index = loadHookSessionIndex();
-        }
-        catch {
-            index = undefined;
-        }
-        for (const pid of ancestorPids(startPid)) {
-            if (index) {
-                const rec = stateForPid(pid, index);
-                if (rec?.session_id) {
-                    sessionId = sessionId || rec.session_id;
-                    launchId = launchId || rec.launch_id;
-                    agentPid = pid;
-                    break;
-                }
-            }
-            else {
-                const rec = readStateSessionRecord(pid);
-                if (rec?.session_id) {
-                    sessionId = sessionId || rec.session_id;
-                    launchId = launchId || rec.launch_id;
-                    agentPid = pid;
-                    break;
-                }
-            }
-        }
-        // Process-table anchor: nearest ancestor whose comm is a known harness.
-        // Covers harnesses with no SessionStart hook (and sessions the hook missed).
-        //
-        // IMPORTANT: stamp as launchId, NEVER as sessionId. A synthetic
-        // `agent-pid:<n>` is not a real agent session UUID — if it lands in
-        // sessionId, hygiene.taskOwnerIsGone treats it as a dead session (the
-        // process-table session probe rejects non-UUID shapes) and reaps the
-        // task mid-run. launchId-only tasks are never session-reaped
-        // (hygiene.ts: launchId alone is not proof of death).
-        if (!sessionId && !launchId) {
-            for (const pid of ancestorPids(startPid)) {
-                const proc = readProc(pid);
-                if (!proc)
-                    continue;
-                const kind = agentKindFromComm(proc.comm);
-                if (kind) {
-                    launchId = `agent-pid:${pid}`;
-                    agentPid = pid;
-                    break;
-                }
-            }
-        }
-    }
-    return { actor, sessionId, launchId, agentPid };
-}
-/**
- * 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 function callerIdentityEnv(caller) {
-    const env = {};
-    if (caller.sessionId)
-        env.AGENT_SESSION_ID = caller.sessionId;
-    if (caller.launchId)
-        env.AGENT_LAUNCH_ID = caller.launchId;
-    return env;
-}
-/**
- * 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 function taskMatchesCaller(task, caller) {
-    if (caller.sessionId && task.sessionId && caller.sessionId === task.sessionId)
-        return true;
-    if (caller.launchId && task.launchId && caller.launchId === task.launchId)
-        return true;
-    return false;
-}

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

@@ -1,51 +0,0 @@
-import type { Readable, Writable } from 'stream';
-interface CDPPipeTransport {
-    read: Readable;
-    write: Writable;
-}
-type EventHandler = (params: Record<string, unknown>, sessionId?: string) => void;
-export declare function registerPipeTransport(transport: CDPPipeTransport): string;
-export declare class CDPClient {
-    private ws;
-    private pipe;
-    private pipeBuffer;
-    private transport;
-    private messageId;
-    private pending;
-    private eventHandlers;
-    private pipeDataHandler;
-    private pipeErrorHandler;
-    private pipeCloseHandler;
-    connect(endpoint: string): Promise<void>;
-    connectPipe(transport: CDPPipeTransport): void;
-    send<T = unknown>(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<T>;
-    on(event: string, handler: EventHandler): void;
-    off(event: string, handler: EventHandler): void;
-    close(): void;
-    get connected(): boolean;
-    get isOpen(): boolean;
-    private handlePipeData;
-    private handleMessage;
-    private handleClose;
-}
-export interface BrowserDiscovery {
-    wsUrl: string;
-    browser: string;
-}
-export declare class BrowserCdpConnectionError extends Error {
-    readonly port: number;
-    readonly profileName: string;
-    readonly host: string;
-    constructor(port: number, profileName?: string, host?: string);
-}
-export declare function formatBrowserCdpConnectionError(port: number, profileName?: string, host?: string): string;
-export declare function discoverBrowserWsUrl(port: number, host?: string, profileName?: string): Promise<BrowserDiscovery>;
-export declare function normalizeBrowserName(s: string): string;
-export declare function verifyBrowserIdentity(reported: string, expected: string, port: number, host?: string): void;
-export declare function listTargets(port: number, host?: string): Promise<Array<{
-    id: string;
-    type: string;
-    title: string;
-    url: string;
-}>>;
-export {};