common-qa-mcp 0.1.0

package/dist/vendor/actionSignatures.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Unified action-signature registry (WEB) — shadow registry.
+ *
+ * ONE declaration per action = the single source of truth for its step-description shape
+ * and what it requires (object binding, parameters). Today these facts are re-declared
+ * independently across ~5 consumers (action def, LLM schema, bake, parameterizer, execute
+ * validation) and drift out of sync — the root cause of the verify_value / store /
+ * verify-description bugs. Later phases make each consumer DERIVE from this registry.
+ *
+ * The registry declares the FULL web action catalog — every catalogued web action_type: the
+ * playwright action handlers PLUS the three step-handler web actions (store_run_variable,
+ * store_global_variable, switch_window, declared at the bottom, shadow-only). Two
+ * web-registered action_types are intentionally EXCLUDED: `tap` (a mobile/touch action kept
+ * out of the web catalog) and `verify_element_state` (a backward-compatible ALIAS of
+ * `verify_element_visible` — same handler + template; declaring both would be a pure
+ * duplicate, so only verify_element_visible is here). Both stay registered/executable elsewhere. The registry stays
+ * SHADOW-ONLY at runtime: deriveWebStepSemantics only DERIVES its description from this
+ * registry for the verify family (the sole reader, stepSemantics.ts). Every other entry is
+ * proven faithful to the live bake by the golden-oracle test (actionSignatures.test.ts) for
+ * the actions the recorder emits, and structurally validated for execution-only actions the
+ * recorder never produces (snapshot, tracing, dialogs, …).
+ *
+ * Leaf module by design (no generateTestSteps import chain, and no stepSemantics import —
+ * stepSemantics imports THIS file, so importing back would be circular), so tests can import
+ * the REAL code — the same reason journalPlacement.ts / androidJournalFirst.ts are separate.
+ *
+ * Design: docs/superpowers/specs/2026-07-19-unified-action-signature-registry-design.md
+ */
+export interface ActionParam {
+    /** Test-data column minted for this action's value (e.g. 'expected_value'). When
+     *  `derivedFromObject` is set this is the FALLBACK name used when the element has no
+     *  usable label. */
+    name: string;
+    /** Which template slot the value fills: a content value, or an element state. */
+    slot: 'value' | 'state';
+    /** When true, the param NAME is derived from the captured element label at bake time
+     *  (snake_case), falling back to `name`. Models type/select, whose param is named after
+     *  the field — e.g. "Email Field" → `Enter ${email_field} in Email Field`. The template
+     *  carries this param as its fallback `${name}` token (e.g. `${value}`); fillDescription
+     *  rewrites that token to the object-derived name when an element is present. */
+    derivedFromObject?: boolean;
+    /** The VALUE KIND replay can actually use. Declared only where the WRONG kind misexecutes
+     *  SILENTLY: every `number` param is read with a digit regex at replay and falls back to a
+     *  default when it doesn't match (resize → 1280x720, wait_timeout → 1000ms, tabs → last tab,
+     *  mouse_* → 0,0), so a non-numeric literal runs a DIFFERENT action instead of failing.
+     *  Undeclared = free text, nothing to check. Surfaced to the step editor via the authoring
+     *  contract (actionSyncService.authoringContract). */
+    valueType?: 'number';
+    /** Declared for completeness, but the author does NOT have to supply it — it is absent from
+     *  the catalog template and only applies to some operators (verify_compare's `tolerance` is
+     *  read for `close_to` only). Kept out of the authoring contract's required list. */
+    optional?: true;
+}
+export interface ActionSignature {
+    /** Matches action_type, e.g. 'verify_value'. */
+    actionType: string;
+    /**
+     * The exact step-description shape. `<element>` is the ONLY angle-bracket token — a human
+     * ELEMENT placeholder (present iff `requires.object`): the Manual Steps editor shows it raw
+     * (not a purple parameter), while recording fills it with the captured element name. Values
+     * are always `${...}` PARAM tokens — never angle-bracketed. Substitution at bake time:
+     *   `<element>`     → the captured element label.
+     *   `${inputValue}` → the captured literal value (verify text/value only).
+     *   `${<name>}` of a `derivedFromObject` param → rewritten to the object-derived name
+     *                     (e.g. `${value}` → `${email_field}`) when an element is present.
+     * Every other `${...}` is a fixed PARAM token that survives verbatim (`${expected_state}`,
+     * `${file_path}`, `${key_name}`, `${target}`, `${url}`, …) — declared in `requires.params`.
+     *
+     * Templates model the PRIMARY (object/value-present) form only; the degenerate no-object
+     * / no-value cases stay hand-coded in deriveWebStepSemantics.
+     */
+    descriptionTemplate: string;
+    requires: {
+        /** Needs an element/selector binding — rejected at record time if missing. Mirrors the
+         *  action handler's `needsLocator` for interaction actions; a few verify actions carry a
+         *  recorded object even though their replay handler resolves it without a pinned locator. */
+        object: boolean;
+        params?: ActionParam[];
+    };
+}
+/**
+ * Fill a signature's template with a captured element name + value. `<element>` is replaced
+ * with the captured label (the raw `<element>` only shows in the Manual Steps editor before an
+ * element is linked); `${inputValue}` with the captured literal; and a `derivedFromObject`
+ * param's fallback token (`${value}` / `${option}`) is rewritten to the object-derived name
+ * (`${email_field}`). All other `${param}` tokens survive verbatim.
+ */
+export declare function fillDescription(sig: ActionSignature, slots: {
+    objectName?: string;
+    inputValue?: string;
+}): string;
+/**
+ * Render a signature for the ACTION CATALOG / Manual Steps editor surface (a different surface
+ * from the recording bake). The editor understands `${param}` tokens (extracted, colored, and
+ * auto-created as test data) and shows `<element>` as the raw placeholder the user links an
+ * object to — but it does NOT understand the recording-only fill slot `${inputValue}`. So this
+ * converts `${inputValue}` to its declared `${param}` form, LEAVING `<element>` and every other
+ * `${token}` (incl. a derivedFromObject param's fallback `${value}`/`${option}`) as-is.
+ *
+ *   type            'Enter ${value} in <element>'            → unchanged
+ *   select_option   'Select ${option} from <element>'        → unchanged
+ *   verify_text     'Verify <element> contains "${inputValue}"' → 'Verify <element> contains ${expected_text}'
+ *   click           'Click <element>'                        → unchanged
+ *
+ * The quotes a bake template wraps its value in ("${inputValue}") are dropped here: they belong
+ * to the recorded literal, whereas a bare ${param} is what the editor extracts as test data.
+ */
+export declare function catalogDescription(sig: ActionSignature): string;
+/**
+ * WEB recorded-action signatures — the full web action catalog.
+ *
+ * Grouped to mirror actions/index.ts. Actions the recorder emits carry the SAME description
+ * the live bake produces (golden-oracle enforced); execution-only actions (which the recorder
+ * never records as a step) carry a designed template validated only structurally.
+ */
+export declare const WEB_ACTION_SIGNATURES: Record<string, ActionSignature>;
+//# sourceMappingURL=actionSignatures.d.ts.map

package/dist/vendor/actionSignatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionSignatures.d.ts","sourceRoot":"","sources":["../../src/vendor/actionSignatures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,WAAW;IAC1B;;wBAEoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB;;;;qFAIiF;IACjF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;0DAKsD;IACtD,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB;;yFAEqF;IACrF,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAOD,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE;QACR;;qGAE6F;QAC7F,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;CACH;AAWD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,MAAM,CAYR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAY/D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CA+UjE,CAAC"}

package/dist/vendor/actionSignatures.js

@@ -0,0 +1,420 @@
+/**
+ * Unified action-signature registry (WEB) — shadow registry.
+ *
+ * ONE declaration per action = the single source of truth for its step-description shape
+ * and what it requires (object binding, parameters). Today these facts are re-declared
+ * independently across ~5 consumers (action def, LLM schema, bake, parameterizer, execute
+ * validation) and drift out of sync — the root cause of the verify_value / store /
+ * verify-description bugs. Later phases make each consumer DERIVE from this registry.
+ *
+ * The registry declares the FULL web action catalog — every catalogued web action_type: the
+ * playwright action handlers PLUS the three step-handler web actions (store_run_variable,
+ * store_global_variable, switch_window, declared at the bottom, shadow-only). Two
+ * web-registered action_types are intentionally EXCLUDED: `tap` (a mobile/touch action kept
+ * out of the web catalog) and `verify_element_state` (a backward-compatible ALIAS of
+ * `verify_element_visible` — same handler + template; declaring both would be a pure
+ * duplicate, so only verify_element_visible is here). Both stay registered/executable elsewhere. The registry stays
+ * SHADOW-ONLY at runtime: deriveWebStepSemantics only DERIVES its description from this
+ * registry for the verify family (the sole reader, stepSemantics.ts). Every other entry is
+ * proven faithful to the live bake by the golden-oracle test (actionSignatures.test.ts) for
+ * the actions the recorder emits, and structurally validated for execution-only actions the
+ * recorder never produces (snapshot, tracing, dialogs, …).
+ *
+ * Leaf module by design (no generateTestSteps import chain, and no stepSemantics import —
+ * stepSemantics imports THIS file, so importing back would be circular), so tests can import
+ * the REAL code — the same reason journalPlacement.ts / androidJournalFirst.ts are separate.
+ *
+ * Design: docs/superpowers/specs/2026-07-19-unified-action-signature-registry-design.md
+ */
+/** snake_case a captured element label into a parameter name — e.g. "Email Field" →
+ *  "email_field". MIRROR of stepSemantics.paramNameFromObject; kept LOCAL because
+ *  stepSemantics.ts imports THIS module (importing back would be circular). The golden-oracle
+ *  test compares fillDescription against the live bake, so any drift between the two copies
+ *  fails the test. */
+function deriveParamName(objectName) {
+    return objectName ? objectName.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_|_$/g, '') : '';
+}
+/**
+ * Fill a signature's template with a captured element name + value. `<element>` is replaced
+ * with the captured label (the raw `<element>` only shows in the Manual Steps editor before an
+ * element is linked); `${inputValue}` with the captured literal; and a `derivedFromObject`
+ * param's fallback token (`${value}` / `${option}`) is rewritten to the object-derived name
+ * (`${email_field}`). All other `${param}` tokens survive verbatim.
+ */
+export function fillDescription(sig, slots) {
+    let out = sig.descriptionTemplate
+        .replace(/<element>/g, slots.objectName ?? '')
+        .replace(/\$\{inputValue\}/g, slots.inputValue ?? '');
+    const derivedParam = sig.requires.params?.find(p => p.derivedFromObject);
+    if (derivedParam) {
+        const derived = deriveParamName(slots.objectName) || derivedParam.name;
+        // Rewrite the fallback token (${value}) to the object-derived name (${email_field}).
+        // split/join avoids escaping the ${…} for a RegExp.
+        out = out.split('${' + derivedParam.name + '}').join('${' + derived + '}');
+    }
+    return out;
+}
+/**
+ * Render a signature for the ACTION CATALOG / Manual Steps editor surface (a different surface
+ * from the recording bake). The editor understands `${param}` tokens (extracted, colored, and
+ * auto-created as test data) and shows `<element>` as the raw placeholder the user links an
+ * object to — but it does NOT understand the recording-only fill slot `${inputValue}`. So this
+ * converts `${inputValue}` to its declared `${param}` form, LEAVING `<element>` and every other
+ * `${token}` (incl. a derivedFromObject param's fallback `${value}`/`${option}`) as-is.
+ *
+ *   type            'Enter ${value} in <element>'            → unchanged
+ *   select_option   'Select ${option} from <element>'        → unchanged
+ *   verify_text     'Verify <element> contains "${inputValue}"' → 'Verify <element> contains ${expected_text}'
+ *   click           'Click <element>'                        → unchanged
+ *
+ * The quotes a bake template wraps its value in ("${inputValue}") are dropped here: they belong
+ * to the recorded literal, whereas a bare ${param} is what the editor extracts as test data.
+ */
+export function catalogDescription(sig) {
+    let out = sig.descriptionTemplate;
+    // ${inputValue} → the declared value param the captured literal maps to (e.g. expected_text),
+    // so the manual template shows an editable ${param} instead of the internal fill slot.
+    if (out.includes('${inputValue}')) {
+        const valueParam = sig.requires.params?.find(p => p.slot === 'value' && !p.derivedFromObject);
+        const token = valueParam ? '${' + valueParam.name + '}' : '';
+        // Strip the bake's surrounding quotes first, so the catalog reads `contains ${expected_text}`
+        // rather than `contains "${expected_text}"`.
+        out = out.split('"${inputValue}"').join(token).replace(/\$\{inputValue\}/g, token);
+    }
+    return out;
+}
+/**
+ * WEB recorded-action signatures — the full web action catalog.
+ *
+ * Grouped to mirror actions/index.ts. Actions the recorder emits carry the SAME description
+ * the live bake produces (golden-oracle enforced); execution-only actions (which the recorder
+ * never records as a step) carry a designed template validated only structurally.
+ */
+export const WEB_ACTION_SIGNATURES = {
+    // ── Element interaction ────────────────────────────────────────────────────────────────
+    click: {
+        actionType: 'click',
+        descriptionTemplate: 'Click on <element>',
+        requires: { object: true },
+    },
+    type: {
+        actionType: 'type',
+        descriptionTemplate: 'Enter ${value} in <element>',
+        requires: { object: true, params: [{ name: 'value', slot: 'value', derivedFromObject: true }] },
+    },
+    fill_form: {
+        actionType: 'fill_form',
+        descriptionTemplate: 'Enter ${value} in <element>',
+        requires: { object: true, params: [{ name: 'value', slot: 'value', derivedFromObject: true }] },
+    },
+    select_option: {
+        actionType: 'select_option',
+        descriptionTemplate: 'Select ${option} from <element>',
+        requires: { object: true, params: [{ name: 'option', slot: 'value', derivedFromObject: true }] },
+    },
+    hover: {
+        actionType: 'hover',
+        descriptionTemplate: 'Hover over <element>',
+        requires: { object: true },
+    },
+    drag: {
+        actionType: 'drag',
+        descriptionTemplate: 'Drag <element> to ${target}',
+        requires: { object: true, params: [{ name: 'target', slot: 'value' }] },
+    },
+    file_upload: {
+        actionType: 'file_upload',
+        descriptionTemplate: 'Upload ${file_path} to <element>',
+        requires: { object: true, params: [{ name: 'file_path', slot: 'value' }] },
+    },
+    press_key: {
+        actionType: 'press_key',
+        descriptionTemplate: 'Press ${key_name}',
+        requires: { object: false, params: [{ name: 'key_name', slot: 'value' }] },
+    },
+    dblclick: {
+        actionType: 'dblclick',
+        descriptionTemplate: 'Double-click on <element>',
+        requires: { object: true },
+    },
+    focus: {
+        actionType: 'focus',
+        descriptionTemplate: 'Focus on <element>',
+        requires: { object: true },
+    },
+    blur: {
+        actionType: 'blur',
+        descriptionTemplate: 'Blur <element>',
+        requires: { object: true },
+    },
+    clear: {
+        actionType: 'clear',
+        descriptionTemplate: 'Clear <element>',
+        requires: { object: true },
+    },
+    // NOTE: `tap` is intentionally NOT declared here — it is a mobile/touch action kept OUT of
+    // the web catalog (2026-07-18 fix), so it has no web catalog row to template.
+    // ── Mouse (coordinate-based) ───────────────────────────────────────────────────────────
+    mouse_click_xy: {
+        actionType: 'mouse_click_xy',
+        descriptionTemplate: 'Click at (${x}, ${y})',
+        requires: { object: false, params: [{ name: 'x', slot: 'value', valueType: 'number' }, { name: 'y', slot: 'value', valueType: 'number' }] },
+    },
+    mouse_move_xy: {
+        actionType: 'mouse_move_xy',
+        descriptionTemplate: 'Move mouse to (${x}, ${y})',
+        requires: { object: false, params: [{ name: 'x', slot: 'value', valueType: 'number' }, { name: 'y', slot: 'value', valueType: 'number' }] },
+    },
+    mouse_drag_xy: {
+        actionType: 'mouse_drag_xy',
+        descriptionTemplate: 'Drag from (${from_x}, ${from_y}) to (${to_x}, ${to_y})',
+        requires: {
+            object: false,
+            params: [
+                { name: 'from_x', slot: 'value', valueType: 'number' }, { name: 'from_y', slot: 'value', valueType: 'number' },
+                { name: 'to_x', slot: 'value', valueType: 'number' }, { name: 'to_y', slot: 'value', valueType: 'number' },
+            ],
+        },
+    },
+    // ── Navigation & lifecycle ─────────────────────────────────────────────────────────────
+    navigate: {
+        actionType: 'navigate',
+        descriptionTemplate: 'Navigate to ${url}',
+        requires: { object: false, params: [{ name: 'url', slot: 'value' }] },
+    },
+    navigate_back: {
+        actionType: 'navigate_back',
+        // "back" stays adjacent to "Navigate" so the description-inference URL-nav guard
+        // (dispatcher.ts) still excludes it; must match deriveWebStepSemantics's bake exactly.
+        descriptionTemplate: 'Navigate back in browser',
+        requires: { object: false },
+    },
+    reload: {
+        actionType: 'reload',
+        descriptionTemplate: 'Reload Browser Page',
+        requires: { object: false },
+    },
+    go_forward: {
+        actionType: 'go_forward',
+        descriptionTemplate: 'Navigate forward in Browser',
+        requires: { object: false },
+    },
+    close: {
+        actionType: 'close',
+        descriptionTemplate: 'Closes current active tab',
+        requires: { object: false },
+    },
+    tabs: {
+        actionType: 'tabs',
+        descriptionTemplate: 'Switch to tab ${tab_index}',
+        requires: { object: false, params: [{ name: 'tab_index', slot: 'value', valueType: 'number' }] },
+    },
+    open_tab: {
+        actionType: 'open_tab',
+        descriptionTemplate: 'Open new tab',
+        requires: { object: false },
+    },
+    close_tab: {
+        actionType: 'close_tab',
+        descriptionTemplate: 'Close tab ${tab_index}',
+        requires: { object: false, params: [{ name: 'tab_index', slot: 'value', valueType: 'number' }] },
+    },
+    // ── Verification ───────────────────────────────────────────────────────────────────────
+    // The verify family is the ONLY group deriveWebStepSemantics derives from this registry.
+    // verify_element_visible is the catalog/legacy action_type AND the canonical `verify_element_state`
+    // alias both route to the same replay handler with this exact shape. Declared ONCE (under the
+    // catalog action_type verify_element_visible) — no separate `verify_element_state` entry, which
+    // would be a pure duplicate. The alias action_type stays registered/executable in the registry.
+    verify_element_visible: {
+        actionType: 'verify_element_visible',
+        descriptionTemplate: 'Verify <element> is ${expected_state}',
+        requires: { object: true, params: [{ name: 'expected_state', slot: 'state' }] },
+    },
+    // The quotes around ${inputValue} are LOAD-BEARING for the recording bake — the saved step
+    // reads `Verify Email Field contains "vijay@x.com"`. catalogDescription() drops them so the
+    // manual-step template stays the approved `Verify <element> contains ${expected_text}`.
+    verify_text_visible: {
+        actionType: 'verify_text_visible',
+        descriptionTemplate: 'Verify <element> contains "${inputValue}"',
+        requires: { object: true, params: [{ name: 'expected_text', slot: 'value' }] },
+    },
+    verify_value: {
+        actionType: 'verify_value',
+        descriptionTemplate: 'Verify <element> contains "${inputValue}"',
+        requires: { object: true, params: [{ name: 'expected_value', slot: 'value' }] },
+    },
+    // requires.object:true (the recorded step carries the list element) even though the replay
+    // handler's needsLocator is false — reproduces the live bake shape exactly.
+    verify_list_visible: {
+        actionType: 'verify_list_visible',
+        descriptionTemplate: 'Verify <element> contains "${inputValue}"',
+        requires: { object: true, params: [{ name: 'expected_text', slot: 'value' }] },
+    },
+    verify_url_contains: {
+        actionType: 'verify_url_contains',
+        descriptionTemplate: 'Verify URL contains ${inputValue}',
+        requires: { object: false, params: [{ name: 'expected_url', slot: 'value' }] },
+    },
+    verify_navigation: {
+        actionType: 'verify_navigation',
+        descriptionTemplate: 'Verify page navigated to ${inputValue}',
+        requires: { object: false, params: [{ name: 'expected_url', slot: 'value' }] },
+    },
+    // The live wording is operator-driven (verifyCompare.ts OPERATOR_PHRASE): `<element> is
+    // greater than 100`, `<element> contains …`. The operator is resolved at bake and is neither
+    // an element nor a test-data column, so it is left out of the template shape here (kept to
+    // `<element>` + the `${expected_value}` param). `tolerance` applies to close_to. The
+    // manual-step editor seeds verify_compare from its own parseable sentence — picker subtext only.
+    // "equals" — NOT "matches". The frontend seeds the structured compare block by parsing this
+    // sentence (parseCompareFromDescription against OPERATOR_PHRASE), and 'matches' is the REGEX
+    // operator: it would make every freshly-added step regex-compare, so expected "5" would pass
+    // against "15". 'equals' is the phrase for defaultCompareSpec()'s operator. The user picks any
+    // other operator from the editor, which rewrites the sentence.
+    verify_compare: {
+        actionType: 'verify_compare',
+        descriptionTemplate: 'Verify <element> equals ${expected_value}',
+        requires: {
+            object: true,
+            params: [
+                { name: 'expected_value', slot: 'value' },
+                // OPTIONAL: `tolerance` is absent from the template above (verify_compare reads it for the
+                // close_to operator only), so the author is never asked for it — without this flag the
+                // step editor would demand a `${tolerance}` token the picker never inserts.
+                { name: 'tolerance', slot: 'value', valueType: 'number', optional: true },
+            ],
+        },
+    },
+    // Param name is load-bearing: handle-dialog.action.ts reads stepValue(ctx,
+    // 'expected_dialog_message', …) off the step, and recording bakes that exact name
+    // (generateTestSteps ~1260). A manual step must use the SAME name or the value never reaches
+    // the handler.
+    verify_dialog_message: {
+        actionType: 'verify_dialog_message',
+        descriptionTemplate: 'Verify dialog message contains "${inputValue}"',
+        requires: { object: false, params: [{ name: 'expected_dialog_message', slot: 'value' }] },
+    },
+    // ── Wait — element state ───────────────────────────────────────────────────────────────
+    wait_for_visible: {
+        actionType: 'wait_for_visible',
+        descriptionTemplate: 'Wait for <element> to be visible',
+        requires: { object: true },
+    },
+    wait_for_hidden: {
+        actionType: 'wait_for_hidden',
+        descriptionTemplate: 'Wait for <element> to be hidden',
+        requires: { object: true },
+    },
+    wait_for_attached: {
+        actionType: 'wait_for_attached',
+        descriptionTemplate: 'Wait for <element> to be attached',
+        requires: { object: true },
+    },
+    wait_for_detached: {
+        actionType: 'wait_for_detached',
+        descriptionTemplate: 'Wait for <element> to be detached',
+        requires: { object: true },
+    },
+    // ── Wait — page level ──────────────────────────────────────────────────────────────────
+    wait_timeout: {
+        actionType: 'wait_timeout',
+        descriptionTemplate: 'Wait ${timeout} ms',
+        requires: { object: false, params: [{ name: 'timeout', slot: 'value', valueType: 'number' }] },
+    },
+    // ${expected_url} is FUNCTIONAL, not decorative: both wait_for_navigation handlers now wait for
+    // that URL (page.waitForURL) before the load-state wait. Left empty → load-state wait only,
+    // i.e. the previous behaviour.
+    wait_for_navigation: {
+        actionType: 'wait_for_navigation',
+        descriptionTemplate: 'Wait until the ${expected_url} is fully loaded',
+        requires: { object: false, params: [{ name: 'expected_url', slot: 'value' }] },
+    },
+    wait_for_url: {
+        actionType: 'wait_for_url',
+        descriptionTemplate: 'Wait for URL ${inputValue}',
+        requires: { object: false, params: [{ name: 'expected_url', slot: 'value' }] },
+    },
+    // ── Observation ────────────────────────────────────────────────────────────────────────
+    // snapshot / take_screenshot / console_messages / network_requests are BACKEND-ONLY
+    // (no `category` on their handlers → not in the catalog), so they are NOT declared here —
+    // this registry mirrors the WEB CATALOG. Same reason tap / generate_locator / *_tracing
+    // are absent. They stay registered + executable.
+    // ── Advanced ───────────────────────────────────────────────────────────────────────────
+    handle_dialog: {
+        actionType: 'handle_dialog',
+        descriptionTemplate: 'Handle dialog',
+        requires: { object: false },
+    },
+    accept_dialog: {
+        actionType: 'accept_dialog',
+        descriptionTemplate: 'Accept dialog',
+        requires: { object: false },
+    },
+    dismiss_dialog: {
+        actionType: 'dismiss_dialog',
+        descriptionTemplate: 'Dismiss dialog',
+        requires: { object: false },
+    },
+    // Param name is load-bearing — handle-dialog.action.ts reads stepValue(ctx, 'dialog_prompt', …)
+    // and agentOrchestrator bakes that same name when recording a prompt() dialog.
+    send_dialog_text: {
+        actionType: 'send_dialog_text',
+        descriptionTemplate: 'Enter "${inputValue}" in dialog',
+        requires: { object: false, params: [{ name: 'dialog_prompt', slot: 'value' }] },
+    },
+    // evaluate is BACKEND-ONLY (no `category` on its handler → not catalogued), so it is NOT
+    // declared here — this registry mirrors the WEB CATALOG. It stays registered + executable.
+    run_code: {
+        actionType: 'run_code',
+        descriptionTemplate: 'Run code',
+        requires: { object: false },
+    },
+    // generate_locator is BACKEND-ONLY (no `category`) → not declared here (see Observation note).
+    resize: {
+        actionType: 'resize',
+        descriptionTemplate: 'Resize viewport to ${width}x${height}',
+        requires: { object: false, params: [{ name: 'width', slot: 'value', valueType: 'number' }, { name: 'height', slot: 'value', valueType: 'number' }] },
+    },
+    scroll: {
+        actionType: 'scroll',
+        descriptionTemplate: 'Scroll to <element>',
+        requires: { object: true },
+    },
+    // ── PDF ────────────────────────────────────────────────────────────────────────────────
+    pdf_save: {
+        actionType: 'pdf_save',
+        descriptionTemplate: 'Save page as PDF',
+        requires: { object: false },
+    },
+    // start_tracing / stop_tracing are BACKEND-ONLY (no `category`) → not declared here
+    // (see the Observation note above).
+    // ── Step-handler web actions (catalogued, but NOT playwright element actions) ─────────────
+    // SHADOW-ONLY, even more than the rest: their catalog descriptions come from the step-handler
+    // definitions (getActionsPayload overrides only the ACTION-handler rows, not step handlers),
+    // and their value carriers are runtime/global VARIABLES ($[…] / $(…)) or a window name — not
+    // test-data ${params} — so params stay minimal. Declared here purely so the registry covers
+    // the FULL web catalog.
+    store_run_variable: {
+        actionType: 'store_run_variable',
+        descriptionTemplate: 'Store text of the <element> to $[variable_name]',
+        requires: { object: true },
+    },
+    // Wording matches store_run_variable except for the $( target — safe because
+    // dispatcher.inferActionTypeFromDescription now exempts a $(…)-only description from the
+    // "Store text of" → store_run_variable rule (it used to OVERRIDE this step's action_type).
+    store_global_variable: {
+        actionType: 'store_global_variable',
+        descriptionTemplate: 'Store text of the <element> in $(variable_name)',
+        requires: { object: true },
+    },
+    switch_window: {
+        actionType: 'switch_window',
+        descriptionTemplate: 'Switch to ${window_name} window',
+        requires: { object: false, params: [{ name: 'window_name', slot: 'value' }] },
+    },
+    close_browser: {
+        actionType: 'close_browser',
+        descriptionTemplate: 'Close browser window',
+        requires: { object: false },
+    },
+};
+//# sourceMappingURL=actionSignatures.js.map

package/dist/vendor/actionSignatures.js.map

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

package/dist/vendor/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Simple logger utility for Walnut Agent
+ * Logs to console AND to a file for easy review.
+ *
+ * Log file location (in order of priority):
+ *   1. WALNUT_LOG_FILE env var (absolute or relative path)
+ *   2. Default: ./logs/walnut-agent.log (relative to process.cwd())
+ *
+ * The log file is created automatically. Logs are appended on each run.
+ */
+export interface Logger {
+    info: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+}
+/**
+ * Register credential values that should be redacted from all log output.
+ * Call this after extracting credentials from tool calls.
+ */
+export declare function setCredentialValues(values: Set<string>): void;
+export declare function createLogger(namespace: string): Logger;
+/** Returns the path to the current log file (or null if file logging is disabled) */
+export declare function getLogFilePath(): string | null;
+/**
+ * Current byte size of the log file (0 if file logging is off). Snapshot this at
+ * execution start, then pass it to readLogSince() at completion to capture exactly
+ * the verbose lines written during that execution — used to ship cloud-runner
+ * per-execution debug logs to S3 (local desktop already keeps the same file on disk).
+ */
+export declare function currentLogOffset(): number;
+/**
+ * Read the log file from `sinceOffset` to end, capped to the last `maxBytes` (keeps
+ * the tail — the most recent, most relevant lines — if the slice is huge). Returns
+ * '' when file logging is off or on any read error (best-effort — never throws).
+ */
+export declare function readLogSince(sinceOffset: number, maxBytes?: number): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/vendor/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/vendor/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CAClD;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAE7D;AAuDD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiDtD;AAED,qFAAqF;AACrF,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAQzC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,SAAkB,GAAG,MAAM,CAuBpF"}