@phnx-labs/agents-cli 1.22.103 → 1.22.104

package/dist/lib/computer/des.js

@@ -1,114 +0,0 @@
-// Minimal, dependency-free single-block DES (ECB) — used only for VNC
-// authentication's challenge/response. Node 24 ships OpenSSL 3, whose DES lives
-// in the legacy provider that is off by default, so `createCipheriv('des-ecb')`
-// throws `digital envelope routines::unsupported`. VNC clients have always
-// bundled their own DES for exactly this reason. This is a textbook FIPS-46 DES
-// implementation over bit arrays — verified against the standard test vector in
-// des.test.ts. It encrypts one 8-byte block; VNC auth encrypts the two halves
-// of the 16-byte challenge independently (see rfb-client.ts).
-const IP = [
-    58, 50, 42, 34, 26, 18, 10, 2, 60, 52, 44, 36, 28, 20, 12, 4,
-    62, 54, 46, 38, 30, 22, 14, 6, 64, 56, 48, 40, 32, 24, 16, 8,
-    57, 49, 41, 33, 25, 17, 9, 1, 59, 51, 43, 35, 27, 19, 11, 3,
-    61, 53, 45, 37, 29, 21, 13, 5, 63, 55, 47, 39, 31, 23, 15, 7,
-];
-const FP = [
-    40, 8, 48, 16, 56, 24, 64, 32, 39, 7, 47, 15, 55, 23, 63, 31,
-    38, 6, 46, 14, 54, 22, 62, 30, 37, 5, 45, 13, 53, 21, 61, 29,
-    36, 4, 44, 12, 52, 20, 60, 28, 35, 3, 43, 11, 51, 19, 59, 27,
-    34, 2, 42, 10, 50, 18, 58, 26, 33, 1, 41, 9, 49, 17, 57, 25,
-];
-const E = [
-    32, 1, 2, 3, 4, 5, 4, 5, 6, 7, 8, 9, 8, 9, 10, 11, 12, 13, 12, 13, 14, 15, 16, 17,
-    16, 17, 18, 19, 20, 21, 20, 21, 22, 23, 24, 25, 24, 25, 26, 27, 28, 29, 28, 29, 30, 31, 32, 1,
-];
-const P = [
-    16, 7, 20, 21, 29, 12, 28, 17, 1, 15, 23, 26, 5, 18, 31, 10,
-    2, 8, 24, 14, 32, 27, 3, 9, 19, 13, 30, 6, 22, 11, 4, 25,
-];
-const PC1 = [
-    57, 49, 41, 33, 25, 17, 9, 1, 58, 50, 42, 34, 26, 18, 10, 2, 59, 51, 43, 35, 27, 19, 11, 3, 60, 52, 44, 36,
-    63, 55, 47, 39, 31, 23, 15, 7, 62, 54, 46, 38, 30, 22, 14, 6, 61, 53, 45, 37, 29, 21, 13, 5, 28, 20, 12, 4,
-];
-const PC2 = [
-    14, 17, 11, 24, 1, 5, 3, 28, 15, 6, 21, 10, 23, 19, 12, 4, 26, 8, 16, 7, 27, 20, 13, 2,
-    41, 52, 31, 37, 47, 55, 30, 40, 51, 45, 33, 48, 44, 49, 39, 56, 34, 53, 46, 42, 50, 36, 29, 32,
-];
-const SHIFTS = [1, 1, 2, 2, 2, 2, 2, 2, 1, 2, 2, 2, 2, 2, 2, 1];
-const SBOX = [
-    [14, 4, 13, 1, 2, 15, 11, 8, 3, 10, 6, 12, 5, 9, 0, 7, 0, 15, 7, 4, 14, 2, 13, 1, 10, 6, 12, 11, 9, 5, 3, 8, 4, 1, 14, 8, 13, 6, 2, 11, 15, 12, 9, 7, 3, 10, 5, 0, 15, 12, 8, 2, 4, 9, 1, 7, 5, 11, 3, 14, 10, 0, 6, 13],
-    [15, 1, 8, 14, 6, 11, 3, 4, 9, 7, 2, 13, 12, 0, 5, 10, 3, 13, 4, 7, 15, 2, 8, 14, 12, 0, 1, 10, 6, 9, 11, 5, 0, 14, 7, 11, 10, 4, 13, 1, 5, 8, 12, 6, 9, 3, 2, 15, 13, 8, 10, 1, 3, 15, 4, 2, 11, 6, 7, 12, 0, 5, 14, 9],
-    [10, 0, 9, 14, 6, 3, 15, 5, 1, 13, 12, 7, 11, 4, 2, 8, 13, 7, 0, 9, 3, 4, 6, 10, 2, 8, 5, 14, 12, 11, 15, 1, 13, 6, 4, 9, 8, 15, 3, 0, 11, 1, 2, 12, 5, 10, 14, 7, 1, 10, 13, 0, 6, 9, 8, 7, 4, 15, 14, 3, 11, 5, 2, 12],
-    [7, 13, 14, 3, 0, 6, 9, 10, 1, 2, 8, 5, 11, 12, 4, 15, 13, 8, 11, 5, 6, 15, 0, 3, 4, 7, 2, 12, 1, 10, 14, 9, 10, 6, 9, 0, 12, 11, 7, 13, 15, 1, 3, 14, 5, 2, 8, 4, 3, 15, 0, 6, 10, 1, 13, 8, 9, 4, 5, 11, 12, 7, 2, 14],
-    [2, 12, 4, 1, 7, 10, 11, 6, 8, 5, 3, 15, 13, 0, 14, 9, 14, 11, 2, 12, 4, 7, 13, 1, 5, 0, 15, 10, 3, 9, 8, 6, 4, 2, 1, 11, 10, 13, 7, 8, 15, 9, 12, 5, 6, 3, 0, 14, 11, 8, 12, 7, 1, 14, 2, 13, 6, 15, 0, 9, 10, 4, 5, 3],
-    [12, 1, 10, 15, 9, 2, 6, 8, 0, 13, 3, 4, 14, 7, 5, 11, 10, 15, 4, 2, 7, 12, 9, 5, 6, 1, 13, 14, 0, 11, 3, 8, 9, 14, 15, 5, 2, 8, 12, 3, 7, 0, 4, 10, 1, 13, 11, 6, 4, 3, 2, 12, 9, 5, 15, 10, 11, 14, 1, 7, 6, 0, 8, 13],
-    [4, 11, 2, 14, 15, 0, 8, 13, 3, 12, 9, 7, 5, 10, 6, 1, 13, 0, 11, 7, 4, 9, 1, 10, 14, 3, 5, 12, 2, 15, 8, 6, 1, 4, 11, 13, 12, 3, 7, 14, 10, 15, 6, 8, 0, 5, 9, 2, 6, 11, 13, 8, 1, 4, 10, 7, 9, 5, 0, 15, 14, 2, 3, 12],
-    [13, 2, 8, 4, 6, 15, 11, 1, 10, 9, 3, 14, 5, 0, 12, 7, 1, 15, 13, 8, 10, 3, 7, 4, 12, 5, 6, 11, 0, 14, 9, 2, 7, 11, 4, 1, 9, 12, 14, 2, 0, 6, 10, 13, 15, 3, 5, 8, 2, 1, 14, 7, 4, 10, 8, 13, 15, 12, 9, 0, 3, 5, 6, 11],
-];
-function bytesToBits(buf) {
-    const bits = [];
-    for (let i = 0; i < buf.length; i++) {
-        for (let b = 7; b >= 0; b--)
-            bits.push((buf[i] >> b) & 1);
-    }
-    return bits;
-}
-function bitsToBytes(bits) {
-    const out = Buffer.alloc(bits.length / 8);
-    for (let i = 0; i < out.length; i++) {
-        let byte = 0;
-        for (let b = 0; b < 8; b++)
-            byte = (byte << 1) | bits[i * 8 + b];
-        out[i] = byte;
-    }
-    return out;
-}
-function permute(bits, table) {
-    return table.map((pos) => bits[pos - 1]);
-}
-function keySchedule(key8) {
-    const keyBits = bytesToBits(key8);
-    const pc1 = permute(keyBits, PC1);
-    let c = pc1.slice(0, 28);
-    let d = pc1.slice(28, 56);
-    const subkeys = [];
-    for (let round = 0; round < 16; round++) {
-        const s = SHIFTS[round];
-        c = c.slice(s).concat(c.slice(0, s));
-        d = d.slice(s).concat(d.slice(0, s));
-        subkeys.push(permute(c.concat(d), PC2));
-    }
-    return subkeys;
-}
-function feistel(r, subkey) {
-    const expanded = permute(r, E);
-    const xored = expanded.map((bit, i) => bit ^ subkey[i]);
-    const out = [];
-    for (let box = 0; box < 8; box++) {
-        const chunk = xored.slice(box * 6, box * 6 + 6);
-        const row = (chunk[0] << 1) | chunk[5];
-        const col = (chunk[1] << 3) | (chunk[2] << 2) | (chunk[3] << 1) | chunk[4];
-        const val = SBOX[box][row * 16 + col];
-        for (let b = 3; b >= 0; b--)
-            out.push((val >> b) & 1);
-    }
-    return permute(out, P);
-}
-// Encrypt one 8-byte block with DES-ECB under an 8-byte key.
-export function desEncryptBlock(key8, block8) {
-    if (key8.length !== 8)
-        throw new Error(`des key must be 8 bytes, got ${key8.length}`);
-    if (block8.length !== 8)
-        throw new Error(`des block must be 8 bytes, got ${block8.length}`);
-    const subkeys = keySchedule(key8);
-    const bits = permute(bytesToBits(block8), IP);
-    let l = bits.slice(0, 32);
-    let r = bits.slice(32, 64);
-    for (let round = 0; round < 16; round++) {
-        const f = feistel(r, subkeys[round]);
-        const next = l.map((bit, i) => bit ^ f[i]);
-        l = r;
-        r = next;
-    }
-    return bitsToBytes(permute(r.concat(l), FP));
-}

package/dist/lib/computer/dispatch.d.ts

@@ -1,10 +0,0 @@
-import type { ComputerClient } from './computer-rpc.js';
-import { type AppInfo } from './actions.js';
-import type { VerbDispatcher } from './loop.js';
-declare function rpcMethodFor(verb: string): string;
-declare function toRpcParams(verb: string, input: Record<string, unknown>, pid?: number): Record<string, unknown>;
-export declare function makeVerbDispatcher(client: ComputerClient, context?: {
-    device?: string;
-}): VerbDispatcher;
-export { rpcMethodFor, toRpcParams };
-export type { AppInfo };

package/dist/lib/computer/dispatch.js

@@ -1,133 +0,0 @@
-// Verb dispatcher for the `computer run` loop.
-//
-// Maps a loop VerbCall (CLI-verb name + friendly input) onto the EXISTING
-// computer-helper RPC methods over the daemon socket. It reimplements no verb —
-// it names the same RPC methods the explicit `agents computer <verb>` commands
-// call, so the external-agent verb surface is untouched. The daemon stays the
-// single authority on permissions and targeting.
-import { resolveTargetPidDecision, emitComputerAction } from './actions.js';
-// CLI verb -> daemon RPC method. Only the rename cases need listing; the rest
-// pass through by name.
-const RPC_METHOD = {
-    apps: 'list_apps',
-    'get-text': 'get_text',
-    'type-text': 'type_text',
-    'ax-action': 'ax_action',
-    'right-click': 'right_click',
-    launch: 'launch_app',
-    focus: 'set_focus',
-    raise: 'focus_window',
-};
-// Verbs that do not need a resolved target pid.
-const NO_TARGET = new Set(['apps', 'launch']);
-function rpcMethodFor(verb) {
-    return RPC_METHOD[verb] ?? verb;
-}
-// Translate the model's friendly input keys into the daemon's param names.
-// pid is injected by the caller after target resolution.
-function toRpcParams(verb, input, pid) {
-    const p = {};
-    if (pid != null)
-        p.pid = pid;
-    const copyIf = (from, to) => {
-        if (input[from] != null)
-            p[to] = input[from];
-    };
-    switch (verb) {
-        case 'describe':
-            copyIf('depth', 'max_depth');
-            break;
-        case 'screenshot':
-            copyIf('quality', 'quality');
-            break;
-        case 'get-text':
-            copyIf('id', 'element_id');
-            copyIf('maxChars', 'max_chars');
-            break;
-        case 'click':
-        case 'right-click':
-        case 'scroll':
-            copyIf('id', 'element_id');
-            copyIf('x', 'x');
-            copyIf('y', 'y');
-            copyIf('count', 'count');
-            copyIf('dx', 'dx');
-            copyIf('dy', 'dy');
-            break;
-        case 'type':
-            copyIf('id', 'element_id');
-            copyIf('x', 'x');
-            copyIf('y', 'y');
-            copyIf('text', 'text');
-            copyIf('commit', 'commit');
-            break;
-        case 'type-text':
-            copyIf('text', 'text');
-            copyIf('commit', 'commit');
-            break;
-        case 'key':
-            copyIf('keys', 'keys');
-            break;
-        case 'ax-action':
-            copyIf('id', 'element_id');
-            copyIf('action', 'action');
-            break;
-        case 'focus':
-            copyIf('id', 'element_id');
-            break;
-        case 'launch':
-            copyIf('bundle', 'bundle_id');
-            copyIf('path', 'path');
-            copyIf('name', 'name');
-            break;
-        case 'wait': {
-            if (input.duration != null)
-                p.duration_ms = input.duration;
-            copyIf('id', 'element_id');
-            copyIf('until', 'until');
-            const locator = {};
-            for (const k of ['role', 'label', 'identifier']) {
-                if (input[k] != null)
-                    locator[k] = input[k];
-            }
-            if (Object.keys(locator).length > 0)
-                p.locator = locator;
-            break;
-        }
-        default:
-            break;
-    }
-    return p;
-}
-// Build a dispatcher bound to a live client. Every call is a single daemon
-// round-trip; errors are returned (never thrown) so the loop can feed them
-// back to the model as a tool_result.
-//
-// `computer run`'s embedded model loop drives every verb (click, type,
-// screenshot, ...) through THIS single seam rather than the explicit
-// `agents computer <verb>` commands in computer-actions.ts, so it must emit
-// the same `computer.action` event those commands emit — otherwise a session
-// that only used the loop reads back usedComputer=false even though it drove
-// real actions (reviewer-flagged regression on #1864).
-export function makeVerbDispatcher(client, context = {}) {
-    return async (call) => {
-        const verb = call.name;
-        const input = call.input ?? {};
-        let pid;
-        if (!NO_TARGET.has(verb) && !(verb === 'wait' && input.duration != null)) {
-            const resolved = await resolveTargetPidDecision(client, { pid: input.pid, bundle: input.bundle });
-            if (!resolved.ok)
-                return { ok: false, error: resolved.error };
-            pid = resolved.pid;
-        }
-        const method = rpcMethodFor(verb);
-        const params = toRpcParams(verb, input, pid);
-        const res = await client.call(method, params);
-        if (res.error)
-            return { ok: false, error: `${res.error.code}: ${res.error.message}` };
-        emitComputerAction(verb, pid, { bundle: input.bundle, device: context.device });
-        return { ok: true, result: res.result ?? {} };
-    };
-}
-// Exposed for tests/diagnostics.
-export { rpcMethodFor, toRpcParams };

package/dist/lib/computer/download.d.ts

@@ -1,54 +0,0 @@
-/**
- * On-demand download + verification of the macOS `agents computer` helper
- * ("ComputerHelper.app").
- *
- * The helper is a signed + notarized universal `.app` bundle published as a
- * GitHub release asset on its own `computer-mac/v<x.y.z>` tag (see
- * `helper-versions.ts`). The Windows helper (`lib/computer/ssh-tunnel.ts`) does
- * NOT yet follow this model — it still keys its exe to the CLI's own tag.
- *
- * A fresh `npm i -g` machine has no local build, so `agents computer setup` / `agents setup computer` fetch the
- * asset for the pinned helper version, verify its sha256 against the published
- * `.sha256`, then verify the code signature (Developer ID Team + notarization)
- * before it is ever copied to /Applications.
- *
- * The download + verify machinery is shared with the menu-bar helper in
- * `../helper-download.ts`; this file is the ComputerHelper spec + its wrappers,
- * keeping the historical export surface (`verifyMacHelper`, `downloadMacHelperApp`,
- * `ensureMacHelperApp`, …) stable for existing callers. ComputerHelper does NOT
- * pin a designated requirement (no `expectedBundleId`), matching its verification
- * strength before the shared primitive existed.
- */
-import { EXPECTED_TEAM_ID, HELPER_RELEASE_REPO, parseTeamId } from '../helper-download.js';
-export { EXPECTED_TEAM_ID, HELPER_RELEASE_REPO, parseTeamId };
-/** The zipped `.app` release asset name. */
-export declare const MAC_HELPER_ASSET = "ComputerHelper.app.zip";
-/** The bundle directory name once extracted. */
-export declare const MAC_HELPER_APP_NAME = "ComputerHelper.app";
-/** Cache dir for the downloaded helper, one subdir per release tag. */
-export declare function macHelperCacheDir(version: string): string;
-/** Release-asset URLs for the helper zip + its checksum at one `v<version>` tag. */
-export declare function macHelperAssetUrls(version: string): {
-    zip: string;
-    sha256: string;
-};
-/**
- * Verify a helper `.app` bundle is intact, signed by the expected Developer ID
- * Team, and notarized (Gatekeeper-accepted). Throws with an actionable message
- * on any failure — a downloaded bundle is never trusted without this.
- */
-export declare function verifyMacHelper(appPath: string): void;
-/**
- * Download the helper release asset for `version`, verify sha256, extract the
- * `.app`, and verify its signature. Returns the path to the extracted
- * `ComputerHelper.app`. A missing asset is a hard error naming the exact tag —
- * never a silent fallback to another release.
- */
-export declare function downloadMacHelperApp(version: string): Promise<string>;
-/**
- * Resolve the helper `.app` to install from: a local build / bundled copy first
- * (repo checkout), else the checksum + signature-verified release-asset download
- * for the pinned helper version. Throws with the tag it checked when neither
- * exists. macOS only.
- */
-export declare function ensureMacHelperApp(version?: string): Promise<string>;

package/dist/lib/computer/download.js

@@ -1,83 +0,0 @@
-/**
- * On-demand download + verification of the macOS `agents computer` helper
- * ("ComputerHelper.app").
- *
- * The helper is a signed + notarized universal `.app` bundle published as a
- * GitHub release asset on its own `computer-mac/v<x.y.z>` tag (see
- * `helper-versions.ts`). The Windows helper (`lib/computer/ssh-tunnel.ts`) does
- * NOT yet follow this model — it still keys its exe to the CLI's own tag.
- *
- * A fresh `npm i -g` machine has no local build, so `agents computer setup` / `agents setup computer` fetch the
- * asset for the pinned helper version, verify its sha256 against the published
- * `.sha256`, then verify the code signature (Developer ID Team + notarization)
- * before it is ever copied to /Applications.
- *
- * The download + verify machinery is shared with the menu-bar helper in
- * `../helper-download.ts`; this file is the ComputerHelper spec + its wrappers,
- * keeping the historical export surface (`verifyMacHelper`, `downloadMacHelperApp`,
- * `ensureMacHelperApp`, …) stable for existing callers. ComputerHelper does NOT
- * pin a designated requirement (no `expectedBundleId`), matching its verification
- * strength before the shared primitive existed.
- */
-import * as os from 'node:os';
-import { resolveHelperApp } from './computer-rpc.js';
-import { EXPECTED_TEAM_ID, HELPER_RELEASE_REPO, downloadHelperApp, helperAssetUrls, helperCacheDir, parseTeamId, verifyHelperApp, } from '../helper-download.js';
-import { helperFloor } from '../helper-versions.js';
-// Re-exported so existing importers (and download.test.ts) keep resolving these
-// names from './download.js'.
-export { EXPECTED_TEAM_ID, HELPER_RELEASE_REPO, parseTeamId };
-/** The zipped `.app` release asset name. */
-export const MAC_HELPER_ASSET = 'ComputerHelper.app.zip';
-/** The bundle directory name once extracted. */
-export const MAC_HELPER_APP_NAME = 'ComputerHelper.app';
-/** ComputerHelper identity + verification policy. No `expectedBundleId`: this
- *  helper has no upgrade-stable Accessibility grant to protect, so its
- *  verification is codesign + Team + notarization exactly as before. */
-const COMPUTER_HELPER_SPEC = {
-    helper: 'computer-mac',
-    assetName: MAC_HELPER_ASSET,
-    appName: MAC_HELPER_APP_NAME,
-    cacheSubdir: ['computer', 'mac-helper'],
-    expectedTeamId: EXPECTED_TEAM_ID,
-    localBuildHint: 'bash native/computer-mac/scripts/build.sh release',
-};
-/** Cache dir for the downloaded helper, one subdir per release tag. */
-export function macHelperCacheDir(version) {
-    return helperCacheDir(COMPUTER_HELPER_SPEC, version);
-}
-/** Release-asset URLs for the helper zip + its checksum at one `v<version>` tag. */
-export function macHelperAssetUrls(version) {
-    return helperAssetUrls(COMPUTER_HELPER_SPEC, version);
-}
-/**
- * Verify a helper `.app` bundle is intact, signed by the expected Developer ID
- * Team, and notarized (Gatekeeper-accepted). Throws with an actionable message
- * on any failure — a downloaded bundle is never trusted without this.
- */
-export function verifyMacHelper(appPath) {
-    verifyHelperApp(appPath, COMPUTER_HELPER_SPEC);
-}
-/**
- * Download the helper release asset for `version`, verify sha256, extract the
- * `.app`, and verify its signature. Returns the path to the extracted
- * `ComputerHelper.app`. A missing asset is a hard error naming the exact tag —
- * never a silent fallback to another release.
- */
-export function downloadMacHelperApp(version) {
-    return downloadHelperApp(COMPUTER_HELPER_SPEC, version);
-}
-/**
- * Resolve the helper `.app` to install from: a local build / bundled copy first
- * (repo checkout), else the checksum + signature-verified release-asset download
- * for the pinned helper version. Throws with the tag it checked when neither
- * exists. macOS only.
- */
-export async function ensureMacHelperApp(version = helperFloor('computer-mac')) {
-    if (os.platform() !== 'darwin') {
-        throw new Error('The macOS computer helper is only available on macOS.');
-    }
-    const local = resolveHelperApp();
-    if (local)
-        return local;
-    return downloadMacHelperApp(version);
-}

package/dist/lib/computer/loop.d.ts

@@ -1,62 +0,0 @@
-export interface VerbCall {
-    name: string;
-    input: Record<string, unknown>;
-}
-export interface VerbResult {
-    ok: boolean;
-    result?: Record<string, unknown>;
-    error?: string;
-}
-export interface LoopStep {
-    call: VerbCall;
-    result: VerbResult;
-    visionFallback?: boolean;
-}
-export interface LoopState {
-    task: string;
-    steps: LoopStep[];
-    visionMode: boolean;
-}
-export interface ModelDecision {
-    toolCalls: VerbCall[];
-    done?: {
-        text: string;
-    };
-}
-export type ModelResponder = (state: LoopState) => ModelDecision | Promise<ModelDecision>;
-export type VerbDispatcher = (call: VerbCall) => VerbResult | Promise<VerbResult>;
-export interface LoopConfig {
-    task: string;
-    responder: ModelResponder;
-    dispatch: VerbDispatcher;
-    maxSteps: number;
-    onEvent?: (event: LoopEvent) => void;
-}
-export type LoopEvent = {
-    kind: 'turn';
-    index: number;
-} | {
-    kind: 'dispatch';
-    call: VerbCall;
-    result: VerbResult;
-    visionFallback?: boolean;
-} | {
-    kind: 'vision_switch';
-    describe: VerbResult;
-} | {
-    kind: 'done';
-    text: string;
-} | {
-    kind: 'max_steps';
-};
-export interface LoopResult {
-    status: 'done' | 'max_steps';
-    finalText?: string;
-    steps: LoopStep[];
-    dispatched: string[];
-    visionMode: boolean;
-    turns: number;
-}
-export declare const AX_OPAQUE_ELEMENT_THRESHOLD = 3;
-export declare function isAxOpaque(result: VerbResult): boolean;
-export declare function runComputerLoop(config: LoopConfig): Promise<LoopResult>;

package/dist/lib/computer/loop.js

@@ -1,98 +0,0 @@
-// The embedded observe -> act -> verify loop behind `agents computer run`.
-//
-// This module owns ONLY the decision logic: given a reasoning model (a
-// boundary, injected as `responder`) and a verb dispatcher (the existing
-// computer-helper RPC surface, injected as `dispatch`), it drives the model's
-// tool calls against the daemon, step by step, until the model declares the
-// task done or `maxSteps` is hit.
-//
-// The model and the daemon are boundaries — neither is code under test. The
-// loop itself (verb ordering, max-steps, the AX -> vision fallback) is the
-// unit under test. See loop.test.ts, which injects a scripted fake responder
-// and a fake dispatcher.
-// Below this many AX elements the tree is treated as opaque — a WebView, a
-// Qt/Electron surface that never populated its AX tree, or a canvas app. The
-// model then works from pixels + coordinate clicks instead of element ids.
-export const AX_OPAQUE_ELEMENT_THRESHOLD = 3;
-// Describe-time heuristic. An explicit `ax_opaque: true` from the daemon wins.
-// Otherwise: a failed describe is NOT opaque (it's an error, surface it), and a
-// successful one is opaque when its element_count is at/under the threshold or
-// its tree has no children. Pure so the rule is unit-testable in isolation.
-export function isAxOpaque(result) {
-    const r = result.result ?? {};
-    if (r.ax_opaque === true)
-        return true;
-    if (!result.ok)
-        return false;
-    const count = typeof r.element_count === 'number' ? r.element_count : undefined;
-    if (count !== undefined)
-        return count <= AX_OPAQUE_ELEMENT_THRESHOLD;
-    const tree = r.tree;
-    const children = tree && Array.isArray(tree.children) ? tree.children : [];
-    return children.length === 0;
-}
-// Drive the loop to completion. Returns the transcript, the ordered verb names
-// dispatched, and whether the vision fallback ever fired.
-export async function runComputerLoop(config) {
-    const state = { task: config.task, steps: [], visionMode: false };
-    const dispatched = [];
-    const emit = config.onEvent ?? (() => { });
-    let turns = 0;
-    while (turns < config.maxSteps) {
-        emit({ kind: 'turn', index: turns });
-        turns++;
-        const decision = await config.responder(state);
-        if (decision.done) {
-            emit({ kind: 'done', text: decision.done.text });
-            return {
-                status: 'done',
-                finalText: decision.done.text,
-                steps: state.steps,
-                dispatched,
-                visionMode: state.visionMode,
-                turns,
-            };
-        }
-        for (const call of decision.toolCalls) {
-            const result = await config.dispatch(call);
-            dispatched.push(call.name);
-            // AX -> vision fallback. When a describe comes back opaque, the element
-            // ids the model would click are useless, so the loop flips visionMode and
-            // immediately hands the model pixels: it auto-dispatches a screenshot of
-            // the same target. The explicit verbs stay untouched for external callers
-            // — this switch lives entirely in the loop.
-            if (call.name === 'describe' && isAxOpaque(result)) {
-                state.visionMode = true;
-                state.steps.push({ call, result, visionFallback: true });
-                emit({ kind: 'dispatch', call, result, visionFallback: true });
-                emit({ kind: 'vision_switch', describe: result });
-                const shotCall = { name: 'screenshot', input: pickTargetInput(call.input) };
-                const shot = await config.dispatch(shotCall);
-                dispatched.push(shotCall.name);
-                state.steps.push({ call: shotCall, result: shot });
-                emit({ kind: 'dispatch', call: shotCall, result: shot });
-                continue;
-            }
-            state.steps.push({ call, result });
-            emit({ kind: 'dispatch', call, result });
-        }
-    }
-    emit({ kind: 'max_steps' });
-    return {
-        status: 'max_steps',
-        steps: state.steps,
-        dispatched,
-        visionMode: state.visionMode,
-        turns,
-    };
-}
-// Carry the target selector (pid/bundle) from the describe call onto the
-// auto-injected screenshot so the vision fallback captures the same surface.
-function pickTargetInput(input) {
-    const out = {};
-    if (input.pid != null)
-        out.pid = input.pid;
-    if (input.bundle != null)
-        out.bundle = input.bundle;
-    return out;
-}

package/dist/lib/computer/model.d.ts

@@ -1,44 +0,0 @@
-import type { LoopState, ModelDecision, ModelResponder } from './loop.js';
-interface ToolSpec {
-    name: string;
-    description: string;
-    input_schema: {
-        type: 'object';
-        properties: Record<string, unknown>;
-        required?: string[];
-    };
-}
-export declare const COMPUTER_TOOLS: ToolSpec[];
-export interface ClaudeResponderConfig {
-    baseUrl?: string;
-    apiKey?: string;
-    model?: string;
-    maxTokens?: number;
-    fetchImpl?: typeof fetch;
-}
-export declare const DEFAULT_CLAUDE_BASE_URL = "https://api.anthropic.com";
-export declare const DEFAULT_CLAUDE_MODEL = "claude-sonnet-4-6";
-export declare const ANTHROPIC_VERSION = "2023-06-01";
-export declare function resolveApiKey(config: ClaudeResponderConfig, env?: NodeJS.ProcessEnv): string;
-export declare function buildSystemPrompt(state: LoopState): string;
-type AnthropicBlock = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'tool_use';
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-} | {
-    type: 'tool_result';
-    tool_use_id: string;
-    content: string;
-};
-interface AnthropicMessage {
-    role: 'user' | 'assistant';
-    content: AnthropicBlock[];
-}
-export declare function buildMessages(state: LoopState): AnthropicMessage[];
-export declare function parseDecision(body: unknown): ModelDecision;
-export declare function makeClaudeResponder(config?: ClaudeResponderConfig): ModelResponder;
-export {};