@petukhovart/agent-view 0.16.1 → 0.17.1

package/dist/server/act-replay.js

@@ -0,0 +1,143 @@
+import { isDeadSocket } from '../cdp/transport.js';
+import { extractControls } from '../inspectors/controls/index.js';
+import { findByLocator, locatorFromArgs, testIdAttributes, testIdLocator } from './locator.js';
+import { edgePoint, readScript, viewportBox } from './act-script.js';
+const POLL_MS = 50;
+const STEP_TIMEOUT_MS = 10_000;
+const UNTIL_TIMEOUT_MS = 15_000;
+const EXIT_DONE = 0;
+const EXIT_FAIL = 1;
+const EXIT_STALE = 3;
+/**
+ * A saved `act` run, executed with no model and no settle: each step waits only until
+ * its own target is on screen, enabled and uncovered, then acts. First line of the
+ * result: `DONE` (until met), `FAIL` (the app did not answer: until never came, or a
+ * control stayed disabled or covered — a bug) or `STALE` (a step's control is gone —
+ * the script no longer fits the app).
+ */
+export async function replay({ name, secret, testIdAttribute }, deps) {
+    const script = await readScript(name);
+    if (!script)
+        return { ok: false, error: `No saved script "${name}" — record one with act start … --save ${name}` };
+    if (script.steps.some(s => 'isPassword' in s && s.isPassword) && !secret) {
+        return { ok: false, error: `"${name}" types a password — set AGENT_VIEW_SECRET` };
+    }
+    const until = locatorFromArgs({ ...script.until, testIdAttribute });
+    if (!until)
+        return { ok: false, error: `"${name}" has no done condition — re-record it with act start --until-testid …` };
+    const attributes = testIdAttributes(testIdAttribute);
+    const t0 = Date.now();
+    const elapsed = () => `${((Date.now() - t0) / 1000).toFixed(1)}s`;
+    const verdict = (exitCode, line) => ({ ok: true, data: `${line} · ${elapsed()}`, exitCode });
+    /** Polls until `probe` yields a value or time runs out; rides over the window reloading. */
+    const poll = async (probe, timeoutMs) => {
+        const end = Date.now() + timeoutMs;
+        for (;;) {
+            try {
+                const value = await probe(deps.conn);
+                if (value !== undefined)
+                    return value;
+            }
+            catch (err) {
+                if (!isDeadSocket(err))
+                    throw err;
+                // Between documents the window is not there yet; the next poll tries again.
+                deps.conn = await deps.reconnect().catch(() => deps.conn);
+            }
+            if (Date.now() > end)
+                return undefined;
+            await new Promise(r => setTimeout(r, POLL_MS));
+        }
+    };
+    /** The control, or why it is not usable yet: absent, or present but disabled / covered. */
+    const find = async (target, { isEnabledRequired }) => {
+        let seen;
+        const control = await poll(async (c) => {
+            deps.invalidateAxCache();
+            const [ax, layout] = await Promise.all([c.getAccessibilityTree(), c.getLayoutSnapshot()]);
+            const hit = extractControls(ax, layout, attributes).find(ctl => target.testid ? ctl.testid === target.testid : ctl.role === target.role && ctl.name === target.name);
+            seen = undefined;
+            if (!hit)
+                return undefined;
+            if (isEnabledRequired && hit.states.includes('disabled')) {
+                seen = 'disabled';
+                return undefined;
+            }
+            let covering;
+            try {
+                covering = await c.hitTest(hit.backendDOMNodeId, attributes);
+            }
+            catch (err) {
+                if (isDeadSocket(err))
+                    throw err;
+                return undefined; // detached between the snapshot and the hit test: look again
+            }
+            if (covering)
+                seen = `covered by ${covering}`;
+            return covering ? undefined : hit;
+        }, STEP_TIMEOUT_MS);
+        return { control, seen };
+    };
+    const findTestId = (testid) => poll(async (c) => {
+        const found = await findByLocator(c, testIdLocator(testid, testIdAttribute));
+        return 'error' in found ? undefined : found;
+    }, STEP_TIMEOUT_MS);
+    const describe = (t) => (t.name ? `${t.role} "${t.name}"` : t.role) + (t.testid ? ` testid=${t.testid}` : '');
+    for (const [i, step] of script.steps.entries()) {
+        const at = `step ${i + 1}/${script.steps.length}`;
+        if (step.op === 'scroll') {
+            await poll(async (c) => { await c.scrollViewport(step.direction); return true; }, STEP_TIMEOUT_MS);
+            continue;
+        }
+        const { control, seen } = await find(step.target, { isEnabledRequired: step.op !== 'drag' });
+        if (!control) {
+            // Present but unusable is the app misbehaving; absent is the script out of date.
+            return seen
+                ? verdict(EXIT_FAIL, `FAIL: ${at} ${step.op} ${describe(step.target)} — still ${seen} after ${STEP_TIMEOUT_MS / 1000}s`)
+                : verdict(EXIT_STALE, `STALE: ${at} ${step.op} ${describe(step.target)} — not on screen within ${STEP_TIMEOUT_MS / 1000}s`);
+        }
+        try {
+            if (step.op !== 'drag') {
+                if (step.op === 'click') {
+                    await deps.conn.clickByNodeId(control.backendDOMNodeId);
+                }
+                else if (step.op === 'type') {
+                    await deps.conn.fillByNodeId(control.backendDOMNodeId, step.isPassword ? secret : step.value ?? '');
+                }
+                else {
+                    const outcome = await deps.conn.selectOption(control.backendDOMNodeId, step.value ?? '');
+                    const reason = outcome === 'no-option' ? `no option "${step.value}"` : 'not a native select';
+                    if (outcome !== 'ok')
+                        return verdict(EXIT_STALE, `STALE: ${at} select ${describe(step.target)} — ${reason}`);
+                }
+            }
+            else {
+                const to = step.to;
+                const dest = !to ? undefined : 'role' in to ? (await find(to, { isEnabledRequired: false })).control : await findTestId(to.testid);
+                if (to && !dest) {
+                    const label = 'role' in to ? describe(to) : `testid=${to.testid}`;
+                    return verdict(EXIT_STALE, `STALE: ${at} drag target ${label} not found`);
+                }
+                const from = await deps.conn.getBoxCenter(control.backendDOMNodeId);
+                const box = dest ? await deps.conn.getBoxRect(dest.backendDOMNodeId, { scrollIntoView: false }) : await viewportBox(deps.conn);
+                await deps.conn.dragBetweenPositions(from, edgePoint(box, step.edge), { mode: 'pointer' });
+            }
+        }
+        catch (err) {
+            // The window reloaded under the action (login, logout): it went out; the next poll reconnects.
+            // Any other failure means the control vanished between finding and acting (a panel
+            // that toggled shut): the app is not in the state the script was recorded in.
+            if (!isDeadSocket(err)) {
+                const reason = err instanceof Error ? err.message : String(err);
+                return verdict(EXIT_STALE, `STALE: ${at} ${step.op} ${describe(step.target)} — ${reason}`);
+            }
+        }
+    }
+    // Split the total: our steps vs the app answering them (auth, reload) — only the first is ours to speed up.
+    const stepsTime = elapsed();
+    const isMet = await poll(async (c) => ('error' in await findByLocator(c, until) ? undefined : true), UNTIL_TIMEOUT_MS);
+    return isMet
+        ? verdict(EXIT_DONE, `DONE: replay ${name} · ${script.steps.length} steps in ${stepsTime}, then ${until.label}`)
+        : verdict(EXIT_FAIL, `FAIL: replay ${name} — steps ran, ${until.label} not visible after ${UNTIL_TIMEOUT_MS / 1000}s`);
+}
+//# sourceMappingURL=act-replay.js.map

package/dist/server/act-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-replay.js","sourceRoot":"","sources":["../../src/server/act-replay.ts"],"names":[],"mappings":"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"}

package/dist/server/act-script.d.ts

@@ -0,0 +1,46 @@
+import type { PageSession, Point, Rect } from '../cdp/types.js';
+/** How a replay finds a control again: its test id, else role + name. */
+export type StepTarget = {
+    testid?: string;
+    role: string;
+    name: string;
+};
+/** A drop target: a row, or any element by its test id. */
+export type DropTarget = StepTarget | {
+    testid: string;
+};
+export type RecordedStep = {
+    op: 'click' | 'type' | 'select';
+    target: StepTarget;
+    value?: string;
+    isPassword: boolean;
+} | {
+    op: 'scroll';
+    direction: 'up' | 'down';
+}
+/** `to`: a row, any element by test id, or absent = the viewport. */
+ | {
+    op: 'drag';
+    target: StepTarget;
+    to?: DropTarget;
+    edge: Edge;
+};
+export type UntilArgs = {
+    testid?: string;
+    selector?: string;
+};
+export type ActScript = {
+    until: UntilArgs;
+    steps: RecordedStep[];
+};
+export declare const isScriptName: (name: string | undefined) => name is string;
+/** Steps are stored by what identifies a control across runs, never by row number. Passwords are not stored. */
+export declare function writeScript(name: string, { until, steps }: ActScript): Promise<string>;
+export declare function readScript(name: string): Promise<ActScript | undefined>;
+export declare const EDGES: readonly ["left", "right", "top", "bottom", "center"];
+export type Edge = typeof EDGES[number];
+export declare const isEdge: (value: string) => value is Edge;
+/** Drop point inside `box`, on its midline, inset from `edge` — a centre drop replaces instead of splitting. */
+export declare function edgePoint(box: Rect, edge: Edge): Point;
+export declare function viewportBox(conn: PageSession): Promise<Rect>;
+//# sourceMappingURL=act-script.d.ts.map

package/dist/server/act-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-script.d.ts","sourceRoot":"","sources":["../../src/server/act-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAG/D,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExD,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAC5F;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE;AAC5C,qEAAqE;GACnE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,EAAE,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA;AAEnE,MAAM,MAAM,SAAS,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAAA;AAInE,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,IAAI,IAAI,MAA0C,CAAA;AAG1G,gHAAgH;AAChH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5F;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAM7E;AAED,eAAO,MAAM,KAAK,uDAAwD,CAAA;AAC1E,MAAM,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAA;AAIvC,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,IAAoD,CAAA;AAEpG,gHAAgH;AAChH,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,KAAK,CAUtD;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE"}

package/dist/server/act-script.js

@@ -0,0 +1,46 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { AGENT_VIEW_DIR } from './port.js';
+const SCRIPT_DIR = join(AGENT_VIEW_DIR, 'scratch');
+export const isScriptName = (name) => !!name && /^[\w.-]+$/.test(name);
+const scriptPath = (name) => join(SCRIPT_DIR, `${name}.json`);
+/** Steps are stored by what identifies a control across runs, never by row number. Passwords are not stored. */
+export async function writeScript(name, { until, steps }) {
+    await mkdir(SCRIPT_DIR, { recursive: true });
+    const stored = steps.map(s => ('isPassword' in s && s.isPassword ? { ...s, value: undefined } : s));
+    await writeFile(scriptPath(name), JSON.stringify({ until, steps: stored }, null, 1));
+    return scriptPath(name);
+}
+export async function readScript(name) {
+    try {
+        return JSON.parse(await readFile(scriptPath(name), 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+export const EDGES = ['left', 'right', 'top', 'bottom', 'center'];
+/** Deepest a drop point sits inside an edge; split zones along a widget edge are ~60 px strips. */
+const EDGE_INSET_PX = 20;
+export const isEdge = (value) => EDGES.includes(value);
+/** Drop point inside `box`, on its midline, inset from `edge` — a centre drop replaces instead of splitting. */
+export function edgePoint(box, edge) {
+    const cx = box.x + box.width / 2;
+    const cy = box.y + box.height / 2;
+    const insetX = Math.min(EDGE_INSET_PX, box.width / 4);
+    const insetY = Math.min(EDGE_INSET_PX, box.height / 4);
+    if (edge === 'left')
+        return { x: box.x + insetX, y: cy };
+    if (edge === 'right')
+        return { x: box.x + box.width - insetX, y: cy };
+    if (edge === 'top')
+        return { x: cx, y: box.y + insetY };
+    if (edge === 'bottom')
+        return { x: cx, y: box.y + box.height - insetY };
+    return { x: cx, y: cy };
+}
+export async function viewportBox(conn) {
+    const { viewport } = await conn.getLayoutSnapshot();
+    return { x: 0, y: 0, ...viewport };
+}
+//# sourceMappingURL=act-script.js.map

package/dist/server/act-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-script.js","sourceRoot":"","sources":["../../src/server/act-script.ts"],"names":[],"mappings":"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"}

package/dist/server/act-session.d.ts

@@ -0,0 +1,23 @@
+import type { ServerResponse } from '../types.js';
+import { type Control } from '../inspectors/controls/index.js';
+import { type Locator } from './locator.js';
+import { type RecordedStep, type UntilArgs } from './act-script.js';
+import { type ActDeps } from './act-replay.js';
+/** Step-protocol state for one CDP port. Rows are those of the LAST printed table. */
+export type ActSession = {
+    until: Locator;
+    untilArgs: UntilArgs;
+    maxSteps: number;
+    testIdAttribute?: string;
+    rows: Control[];
+    steps: RecordedStep[];
+    startedAt: number;
+    /** Script name to write on DONE (`act start --save`). */
+    saveAs?: string;
+    /** DONE was printed: the recording is complete and takes no more steps. */
+    isDone: boolean;
+};
+export declare function runAct(holder: {
+    act: ActSession | null;
+}, args: Record<string, unknown>, deps: ActDeps): Promise<ServerResponse>;
+//# sourceMappingURL=act-session.d.ts.map

package/dist/server/act-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-session.d.ts","sourceRoot":"","sources":["../../src/server/act-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAQL,KAAK,OAAO,EACb,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAmE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC5G,OAAO,EAQL,KAAK,YAAY,EAEjB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAetD,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAUD,wBAAsB,MAAM,CAC1B,MAAM,EAAE;IAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,EAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,CAAC,CA+BzB"}

package/dist/server/act-session.js

@@ -0,0 +1,304 @@
+import { isDeadSocket } from '../cdp/transport.js';
+import { PASSWORD_MASK, TEXT_ROLES, describeControl, extractControls, formatControlRow, formatControlTable, resolveRow, } from '../inspectors/controls/index.js';
+import { findByLocator, locatorFromArgs, testIdAttributes, testIdLocator } from './locator.js';
+import { EDGES, edgePoint, isEdge, isScriptName, viewportBox, writeScript, } from './act-script.js';
+import { replay } from './act-replay.js';
+const DEFAULT_MAX_STEPS = 30;
+const SETTLE_POLL_MS = 100;
+const SETTLE_BUDGET_MS = 3_000;
+/** Polls the table must stay unchanged, after it changed, to count as settled. */
+const SETTLE_STABLE_POLLS = 2;
+/** Polls an action that changed nothing waits before giving up on a reaction. */
+const SETTLE_QUIET_POLLS = 4;
+const ROW_OPS = ['click', 'type', 'select'];
+const stepTarget = (c) => ({ testid: c.testid, role: c.role, name: c.name });
+const str = (args, key) => typeof args[key] === 'string' ? args[key] : undefined;
+const num = (value) => (typeof value === 'number' ? value : NaN);
+const isRowOp = (op) => ROW_OPS.includes(op);
+export async function runAct(holder, args, deps) {
+    const op = str(args, 'op') ?? '';
+    if (op === 'replay') {
+        const name = str(args, 'name');
+        if (!isScriptName(name))
+            return { ok: false, error: 'act replay <name>' };
+        return replay({ name, secret: str(args, 'secret'), testIdAttribute: str(args, 'testIdAttribute') }, deps);
+    }
+    if (op === 'start') {
+        // Done is agent-view's call, never the driver's: no run without a done condition.
+        if ((str(args, 'untilTestid') === undefined) === (str(args, 'untilSelector') === undefined)) {
+            return { ok: false, error: 'act start --until-testid <id> | --until-selector <css> — exactly one' };
+        }
+        holder.act = createSession(args);
+        return tableOrDone({ session: holder.act, deps });
+    }
+    const session = holder.act;
+    if (!session)
+        return { ok: false, error: 'run `agent-view act start` first' };
+    const run = { session, deps };
+    if (op === 'table')
+        return tableOrDone(run);
+    if (op === 'save')
+        return save(session, str(args, 'name'));
+    if (op === 'wait')
+        return finishStep(run, { before: tableKey(await snapshot(run)), done: 'wait', quietPolls: Infinity });
+    if (session.isDone)
+        return { ok: false, error: 'this act run is DONE — `agent-view act start` for a new one' };
+    if (session.steps.length >= session.maxSteps) {
+        return { ok: true, data: `BLOCKED: step budget ${session.maxSteps} exhausted\n${await printTable(run)}` };
+    }
+    if (op === 'scroll')
+        return scrollStep(run, str(args, 'direction'));
+    if (op === 'drag')
+        return dragStep(run, { n: num(args.n), to: str(args, 'to'), edge: str(args, 'edge') });
+    if (isRowOp(op))
+        return rowStep(run, { op, n: num(args.n), text: str(args, 'text') ?? '' });
+    if (op === 'do')
+        return batchStep(run, args.steps);
+    return { ok: false, error: `Unknown act op: ${op}` };
+}
+function createSession(args) {
+    const untilArgs = { testid: str(args, 'untilTestid'), selector: str(args, 'untilSelector') };
+    const testIdAttribute = str(args, 'testIdAttribute');
+    const maxSteps = typeof args.maxSteps === 'number' && args.maxSteps > 0 ? args.maxSteps : DEFAULT_MAX_STEPS;
+    return {
+        until: locatorFromArgs({ ...untilArgs, testIdAttribute }),
+        untilArgs,
+        maxSteps,
+        testIdAttribute,
+        rows: [],
+        steps: [],
+        startedAt: Date.now(),
+        saveAs: str(args, 'save'),
+        isDone: false,
+    };
+}
+/** `read` on the live socket; when the window reloaded under it, once more on a fresh one. */
+async function onLiveConn(deps, read) {
+    try {
+        return await read();
+    }
+    catch (err) {
+        if (!isDeadSocket(err))
+            throw err;
+        deps.conn = await deps.reconnect();
+        return read();
+    }
+}
+const unlessDeadSocket = (read, fallback) => read.catch((err) => {
+    if (isDeadSocket(err))
+        return fallback;
+    throw err;
+});
+async function snapshot({ session, deps }) {
+    deps.invalidateAxCache();
+    return onLiveConn(deps, async () => {
+        const [ax, layout] = await Promise.all([deps.conn.getAccessibilityTree(), deps.conn.getLayoutSnapshot()]);
+        return extractControls(ax, layout, testIdAttributes(session.testIdAttribute));
+    });
+}
+/** Prints `controls` (or a fresh snapshot) and makes it the table the next `n` refers to. */
+async function printTable(run, controls) {
+    const { session } = run;
+    session.rows = controls ?? await snapshot(run);
+    return formatControlTable(session.rows, { step: session.steps.length, maxSteps: session.maxSteps, untilLabel: session.until.label });
+}
+async function rowStep(run, { op, n, text }) {
+    const located = await locate(run, n);
+    if (!('target' in located))
+        return located;
+    const { target, fresh } = located;
+    if (op === 'type' && !TEXT_ROLES.has(target.role)) {
+        return { ok: false, error: `[${n}] is a ${target.role}, not a text field — pick a textbox/combobox row` };
+    }
+    const { session, deps } = run;
+    const echo = op === 'click' ? '' : ` ${target.isPassword ? PASSWORD_MASK : JSON.stringify(text)}`;
+    const done = `${op} [${n}] ${describeControl(target)}${echo}`;
+    let isReloaded = false;
+    try {
+        if (op === 'click') {
+            await deps.conn.clickByNodeId(target.backendDOMNodeId);
+        }
+        else if (op === 'type') {
+            await deps.conn.fillByNodeId(target.backendDOMNodeId, text);
+        }
+        else {
+            const outcome = await deps.conn.selectOption(target.backendDOMNodeId, text);
+            if (outcome === 'not-select')
+                return { ok: false, error: 'not a native select — click it' };
+            if (outcome === 'no-option')
+                return { ok: false, error: `No option "${text}" in [${n}]` };
+        }
+    }
+    catch (err) {
+        // The window reloaded under the action (login, logout): the socket died, the action went out.
+        if (!isDeadSocket(err))
+            throw err;
+        isReloaded = true;
+    }
+    deps.invalidateAxCache();
+    session.steps.push({ op, target: stepTarget(target), value: op === 'click' ? undefined : text, isPassword: target.isPassword });
+    return finishStep(run, { before: tableKey(fresh), done: isReloaded ? `${done} · window reloaded` : done });
+}
+/** `type 3 a  b` types `a  b`: the text is the rest of the step, spaces kept. */
+function parseRowStep(step) {
+    const m = /^\s*(\S+)\s+(\d+)(?:\s(.*))?$/s.exec(step);
+    return m && isRowOp(m[1]) ? { op: m[1], n: Number(m[2]), text: m[3] ?? '' } : undefined;
+}
+/**
+ * Several row ops decided from ONE table — a form fill is one decision, not three model
+ * turns. Every n refers to that table: it is re-pinned before each op, so the stale guard
+ * maps it onto whatever the previous op left. Stops at the first error, BLOCKED or DONE.
+ */
+async function batchStep(run, raw) {
+    const steps = Array.isArray(raw) ? raw.map(String) : [];
+    const parsed = steps.map(parseRowStep);
+    if (!parsed.every((p) => p !== undefined)) {
+        const bad = steps[parsed.indexOf(undefined)];
+        return { ok: false, error: `act do: "${bad}" — each step is click|type|select <n> [text]` };
+    }
+    const pinned = run.session.rows;
+    const lines = [];
+    for (const [i, step] of parsed.entries()) {
+        run.session.rows = pinned;
+        const result = await rowStep(run, step);
+        if (!result.ok)
+            return { ok: false, error: [...lines, result.error].join('\n') };
+        const out = String(result.data);
+        if (i === parsed.length - 1 || !out.startsWith('✓'))
+            return { ok: true, data: [...lines, out].join('\n') };
+        lines.push(out.split('\n')[0]);
+    }
+    return { ok: false, error: 'act do "<op> <n> [text]" …' };
+}
+/** Row n of the last table in a fresh snapshot: stale guard, then hit check. */
+async function locate(run, n) {
+    const { session, deps } = run;
+    const last = session.rows[n - 1];
+    if (!last)
+        return { ok: false, error: `No row [${n}] in the last table (1-${session.rows.length})` };
+    const fresh = await snapshot(run);
+    const resolved = resolveRow(last, fresh);
+    if ('gone' in resolved)
+        return blocked(run, `[${n}] ${describeControl(last)} is gone`, fresh);
+    const covering = await deps.conn.hitTest(resolved.control.backendDOMNodeId, testIdAttributes(session.testIdAttribute));
+    if (covering)
+        return blocked(run, `[${n}] covered by ${covering}`, fresh);
+    return { target: resolved.control, fresh };
+}
+/**
+ * Pointer drag of row n onto an edge of: row `to`, any visible element `testid=<id>`
+ * (drop zones are rarely controls), or the viewport.
+ */
+async function dragStep(run, { n, to, edge = 'center' }) {
+    if (!isEdge(edge))
+        return { ok: false, error: `act drag <n> [to] [edge] — edge is one of ${EDGES.join('|')}` };
+    const { session, deps } = run;
+    const located = await locate(run, n);
+    if (!('target' in located))
+        return located;
+    let destId;
+    let toLabel = 'viewport';
+    let toTarget;
+    if (to !== undefined && to !== 'center' && to.startsWith('testid=')) {
+        const testid = to.slice('testid='.length);
+        const found = await findByLocator(deps.conn, testIdLocator(testid, session.testIdAttribute));
+        if ('error' in found)
+            return { ok: false, error: found.error };
+        destId = found.backendDOMNodeId;
+        toLabel = to;
+        toTarget = { testid };
+    }
+    else if (to !== undefined && to !== 'center') {
+        const dest = await locate(run, Number(to));
+        if (!('target' in dest))
+            return dest;
+        destId = dest.target.backendDOMNodeId;
+        toLabel = `[${to}] ${describeControl(dest.target)}`;
+        toTarget = stepTarget(dest.target);
+    }
+    // Source first: scrolling it into view may move the target, so the target is measured after.
+    const from = await deps.conn.getBoxCenter(located.target.backendDOMNodeId);
+    const box = destId === undefined ? await viewportBox(deps.conn) : await deps.conn.getBoxRect(destId, { scrollIntoView: false });
+    await deps.conn.dragBetweenPositions(from, edgePoint(box, edge), { mode: 'pointer' });
+    deps.invalidateAxCache();
+    session.steps.push({ op: 'drag', target: stepTarget(located.target), to: toTarget, edge });
+    const source = `${describeControl(located.target)}${located.target.testid ? ` testid=${located.target.testid}` : ''}`;
+    return finishStep(run, { before: tableKey(located.fresh), done: `drag [${n}] ${source} → ${toLabel} ${edge}` });
+}
+async function scrollStep(run, direction) {
+    if (direction !== 'up' && direction !== 'down')
+        return { ok: false, error: 'act scroll <up|down>' };
+    const before = tableKey(await snapshot(run));
+    await run.deps.conn.scrollViewport(direction);
+    run.deps.invalidateAxCache();
+    run.session.steps.push({ op: 'scroll', direction });
+    return finishStep(run, { before, done: `scroll ${direction}` });
+}
+async function blocked(run, reason, fresh) {
+    return { ok: true, data: `BLOCKED: ${reason}\n${await printTable(run, fresh)}` };
+}
+const tableKey = (controls) => controls.map((c, i) => formatControlRow(c, i)).join('\n');
+/** A table the decider asked for still ends the run when the goal was reached meanwhile. */
+async function tableOrDone(run) {
+    const table = await printTable(run);
+    return { ok: true, data: await isUntilMet(run) ? await doneLine(run.session) : table };
+}
+/** The DONE line; with `start --save`, the recording is written here, sparing the decider a turn. */
+async function doneLine(session) {
+    const line = `DONE: until ${session.until.label} · ${session.steps.length} steps · ${((Date.now() - session.startedAt) / 1000).toFixed(1)}s`;
+    const isFirstDone = !session.isDone;
+    session.isDone = true;
+    if (!session.saveAs || !isFirstDone)
+        return line;
+    const saved = await save(session, session.saveAs);
+    return `${line} · saved ${saved.ok ? saved.data : saved.error}`;
+}
+function isUntilMet({ session, deps }) {
+    return onLiveConn(deps, async () => !('error' in await findByLocator(deps.conn, session.until)));
+}
+/**
+ * Settle, not sleep: poll until the until-condition holds, or the table changed and then
+ * held still for SETTLE_STABLE_POLLS polls, or never changed for `quietPolls`, or the
+ * budget runs out.
+ */
+async function finishStep(run, { before, done, quietPolls = SETTLE_QUIET_POLLS }) {
+    const t0 = Date.now();
+    let previous = before;
+    let hasChanged = false;
+    let stablePolls = 0;
+    let controls = [];
+    let isDone = false;
+    do {
+        await new Promise(r => setTimeout(r, SETTLE_POLL_MS));
+        // A socket that dies again mid-reload is a document between loads: an empty table.
+        controls = await unlessDeadSocket(snapshot(run), []);
+        isDone = await unlessDeadSocket(isUntilMet(run), false);
+        if (isDone)
+            break;
+        const key = tableKey(controls);
+        // An empty table is a document between loads, never a settled screen.
+        if (controls.length === 0 || key !== previous) {
+            hasChanged = true;
+            stablePolls = 0;
+        }
+        else {
+            stablePolls++;
+        }
+        previous = key;
+    } while (stablePolls < (hasChanged ? SETTLE_STABLE_POLLS : quietPolls) && Date.now() - t0 < SETTLE_BUDGET_MS);
+    const elapsed = Date.now() - t0;
+    if (isDone)
+        return { ok: true, data: await doneLine(run.session) };
+    const table = await printTable(run, controls);
+    const { session } = run;
+    if (session.steps.length >= session.maxSteps)
+        return { ok: true, data: `BLOCKED: step budget ${session.maxSteps} exhausted\n${table}` };
+    return { ok: true, data: `✓ ${done} · ${elapsed}ms\n${table}` };
+}
+async function save(session, name) {
+    if (!isScriptName(name))
+        return { ok: false, error: 'act save <name> — letters, digits, . _ - only' };
+    const path = await writeScript(name, { until: session.untilArgs, steps: session.steps });
+    return { ok: true, data: `${path} · replay: agent-view act replay ${name}` };
+}
+//# sourceMappingURL=act-session.js.map

package/dist/server/act-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-session.js","sourceRoot":"","sources":["../../src/server/act-session.ts"],"names":[],"mappings":"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"}