@phnx-labs/agents-cli 1.22.93 → 1.22.94

package/dist/lib/browser/refs.js

@@ -6,6 +6,7 @@ export function describeRefs(nodeMap) {
         role: n.role,
         name: n.name,
         attrs: n.attrs.slice(),
+        selector: n.selector,
     }));
 }
 /**
@@ -57,7 +58,7 @@ export function healRef(descriptor, freshNodeMap) {
         // Lexicographic key, all "higher is better":
         //   [ DOM-backed, attribute similarity, -distance-to-original-ref ].
         const key = [
-            node.backendNodeId !== undefined ? 1 : 0,
+            node.backendNodeId !== undefined || node.selector !== undefined ? 1 : 0,
             attrScore(node),
             -Math.abs(node.ref - ref),
         ];

package/dist/lib/browser/resolve-target.d.ts

@@ -24,6 +24,8 @@ export interface ResolvedBrowserTarget {
      * surfaces this so the caller knows WHERE the browser actually lives.
      */
     picked?: string;
+    /** Native endpoints cannot be tunnelled; the CLI must re-exec on this device. */
+    commandDispatch?: boolean;
 }
 /** Fork only fungible Electron profiles; identity-bearing ones share one connection. */
 export declare function shouldForkProfile(kind: 'identity' | 'fungible', conn: {

package/dist/lib/browser/resolve-target.js

@@ -35,11 +35,14 @@ export function profileFromDeclaration(name, declaration) {
         targetFilter: config.targetFilter,
         endpoints: config.endpoints,
         defaultEndpoint: config.defaultEndpoint,
+        launchPolicy: config.launchPolicy,
+        userDataDir: config.userDataDir,
         chrome: config.chrome,
         secrets: config.secrets,
         viewport: config.viewport,
         logDir: config.logDir,
         logHost: config.logHost,
+        arc: config.arc,
     };
 }
 /** Runtime key: profile name plus the resolved device. Drops `@endpoint-N`. */
@@ -125,6 +128,10 @@ export function sshEndpointForDeclaration(device, config, endpointName, os) {
     const resolved = resolveEndpoint(profile, endpointName);
     if (resolved.target.startsWith('ssh:'))
         return resolved.target;
+    // Native Arc endpoints (arc-native:) must NOT be rewritten into SSH tunnels
+    // (PHNX-2399). They dispatch the whole command to the owner device instead.
+    if (resolved.target.startsWith('arc-native:'))
+        return resolved.target;
     const parsed = parseEndpointUrl(resolved.target);
     const port = parsed?.port ?? 9222;
     const osQuery = isWindowsOs(os) ? '&os=windows' : '';
@@ -202,6 +209,7 @@ export function resolveBrowserTarget(name, opts = {}) {
                 targetFilter: resolved.targetFilter,
             },
             picked,
+            commandDispatch: resolved.target.startsWith('arc-native:'),
         };
     }
     throw unreachableDeclaringDevicesError(name, devices, failures);

package/dist/lib/browser/runtime-state.js

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { execFileSync } from 'child_process';
-import { getProfileRuntimeDir, getBrowserRuntimeDir, getEndpointPresets, listProfiles, getConfiguredDefaultProfileName, isProfileLaunchableHere, deleteProfile, DEFAULT_BROWSER_PROFILE_NAME, LEGACY_DEFAULT_BROWSER_PROFILE_NAME, } from './profiles.js';
+import { getProfileRuntimeDir, getBrowserRuntimeDir, getEndpointPresets, listProfiles, getConfiguredDefaultProfileName, isProfileLaunchableHere, isProfileDeclaredHere, deleteProfile, DEFAULT_BROWSER_PROFILE_NAME, LEGACY_DEFAULT_BROWSER_PROFILE_NAME, } from './profiles.js';
 import { keyBelongsToProfile } from './types.js';
 import { declaringDevices, profileKind } from './registry.js';
 import { machineId } from '../machine-id.js';
@@ -405,6 +405,14 @@ export async function buildProfilePrunePlan() {
     for (const profile of profiles) {
         const scope = profile.devices.length > 1 ? 'fungible' : 'identity';
         const misfiled = identityLoopbackMismatch(profile);
+        if (profile.arc && !isProfileDeclaredHere(profile.name)) {
+            peerKept.push({
+                name: profile.name,
+                scope,
+                why: 'read-only native Arc discovery; no agents-cli alias to prune',
+            });
+            continue;
+        }
         if (profile.devices.includes(current)) {
             declaredHere.push({
                 name: profile.name,

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

@@ -4,7 +4,7 @@ import { type ResolvedDomainSkill } from './domain-skills.js';
 import { type Task, type TabInfo, type ProfileStatus, type BrowserType, type HistoricalTask, type ReapResult, type ProfileName, type ConnectionKey } from './types.js';
 import { type ReapOptions } from './hygiene.js';
 import { type RefOpts, type RefNode } from './refs.js';
-import type { TargetFilter, PageOpenResult } from './types.js';
+import type { TargetFilter, PageOpenResult, ArcNativeProfileIdentity } from './types.js';
 export type UploadMode = 'auto' | 'input' | 'drop' | 'chooser';
 export declare function resolveScreenshotOutputPath(outputPath: string | undefined, automaticPath: string): string;
 /**
@@ -46,8 +46,7 @@ export declare function pickWindowTarget<T extends {
 export declare function parseSinceUntil(s: string): Date;
 export declare function readNewestMatchingRemoteFileCommand(dir: string, prefix: string, tailLines: number): string;
 export declare function readNewestMatchingFile(dir: string, prefix: string, tailLines: number): string;
-interface ProfileConnection {
-    cdp: CDPClient;
+interface BaseProfileConnection {
     port: number;
     pid: number;
     electron?: boolean;
@@ -86,6 +85,17 @@ interface ProfileConnection {
      */
     cleanup?: () => void;
 }
+interface CdpProfileConnection extends BaseProfileConnection {
+    /** Omitted only by legacy/in-process callers; absence means the CDP path. */
+    backend?: 'cdp';
+    cdp: CDPClient;
+}
+interface ArcProfileConnection extends BaseProfileConnection {
+    backend: 'arc-native';
+    browserType: 'arc';
+    arcProfile: ArcNativeProfileIdentity;
+}
+type ProfileConnection = CdpProfileConnection | ArcProfileConnection;
 /** Join error lines so callers get a next command, not a dead-end message. */
 export declare function actionable(...lines: string[]): string;
 /**
@@ -178,6 +188,8 @@ export interface StartResult {
      */
     firstOpen?: PageOpenResult;
 }
+export declare function arcCreateMarker(): string;
+export declare function isArcCreateMarker(url: string): boolean;
 export declare class BrowserService {
     private static readonly SOURCE_PREFIX;
     /**
@@ -613,6 +625,7 @@ export declare class BrowserService {
      * a minute, well inside the 30-minute idle window.
      */
     private touchTask;
+    private prepareTask;
     private findTask;
     /**
      * Soft-attach to an already-running browser for a runtime dir.
@@ -680,6 +693,27 @@ export declare class BrowserService {
      * browser started before the key collapse is not abandoned.
      */
     private reuseProfileConnection;
+    /**
+     * Bind a task to the profile's Space in the visible Arc window that holds it.
+     * The Space is the profile (PHNX-2399); only its live window id is looked up.
+     */
+    private resolveArcSpace;
+    private requireArcTask;
+    private reconcileArcCreateIntents;
+    private createArcOwnedTab;
+    private navigateArcNative;
+    /**
+     * Execute JavaScript in a native Arc tab. Sync JS only, isolated world —
+     * async/promise evaluation fails honestly with an AppleScript error.
+     */
+    private evaluateArcNative;
+    private listArcTaskTabs;
+    /**
+     * Close native Arc tabs owned by a task. Only closes tabs the task created
+     * (not borrowed ones). Never kills Arc. Identifies tabs only by stable ids in
+     * the original window and Space.
+     */
+    private closeArcNativeTabs;
     /** Connect a profile at `target`, register it under `key`, and arm downloads. */
     private openConnection;
     /**