@reticlehq/test 2.0.0

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Reticle Labs
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/dist/boot.d.ts

@@ -0,0 +1,25 @@
+import type { RunningServer, ToolDeps, ToolInvoker } from '@reticlehq/server';
+export interface BootedRun {
+    invoke: ToolInvoker;
+    close: () => Promise<void>;
+}
+export interface BootOptions {
+    /** URL the headless real-input browser navigates to (sets inputMode:'real' for pointer acts). */
+    driveUrl: string;
+    /** Launch headless (default true). */
+    headless?: boolean;
+    port?: number;
+    /** Absolute .reticle root. Defaults to cwd()/.reticle. Injectable for tests. */
+    reticleRoot?: string;
+    /** Injected clock; defaults to Date.now. */
+    now?: () => number;
+    /** Injectable ToolDeps builder so tests can wire a fake server without real IO. */
+    buildDeps?: (server: RunningServer) => ToolDeps;
+}
+/**
+ * Production wiring: launch a headless real-input browser against `driveUrl`, then expose a
+ * programmatic ToolInvoker over it (no MCP/stdio). Tests inject a fake invoker into runSpecs
+ * directly and never reach this path.
+ */
+export declare function bootSession(opts: BootOptions): Promise<BootedRun>;
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,QAAQ,CAAC;CACjD;AAwBD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAUvE"}

package/dist/boot.js

@@ -0,0 +1,41 @@
+import { join } from 'node:path';
+import { ReticleDir } from '@reticlehq/core';
+import { AnnotationStore, BaselineStore, FlowStore, ProjectStore, RecordingStore, createNodeFileSystem, createToolInvoker, start, } from '@reticlehq/server';
+/**
+ * Build ToolDeps from a started server (Option b: zero further server changes). The only place
+ * in @reticlehq/test that touches real IO — and it does so only by delegating to @reticlehq/server's start.
+ */
+function defaultBuildDeps(server, opts) {
+    const fs = createNodeFileSystem();
+    const reticleRoot = opts.reticleRoot ?? join(process.cwd(), ReticleDir.ROOT);
+    const now = opts.now ?? (() => Date.now());
+    const base = {
+        sessions: server.bridge.sessions,
+        baselines: new BaselineStore(),
+        recordings: new RecordingStore(),
+        flows: new FlowStore(fs, reticleRoot, { now }),
+        project: new ProjectStore(fs, reticleRoot, { now }),
+        annotations: new AnnotationStore(),
+        fs,
+        reticleRoot,
+        now,
+    };
+    return server.realInput !== undefined ? { ...base, realInput: server.realInput } : base;
+}
+/**
+ * Production wiring: launch a headless real-input browser against `driveUrl`, then expose a
+ * programmatic ToolInvoker over it (no MCP/stdio). Tests inject a fake invoker into runSpecs
+ * directly and never reach this path.
+ */
+export async function bootSession(opts) {
+    const startOptions = {
+        mcp: false,
+        driveUrl: opts.driveUrl,
+        headless: opts.headless ?? true,
+        ...(opts.port !== undefined ? { port: opts.port } : {}),
+    };
+    const server = await start(startOptions);
+    const deps = (opts.buildDeps ?? ((s) => defaultBuildDeps(s, opts)))(server);
+    return { invoke: createToolInvoker(deps), close: server.close };
+}
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,GACN,MAAM,mBAAmB,CAAC;AAsB3B;;;GAGG;AACH,SAAS,gBAAgB,CAAC,MAAqB,EAAE,IAAiB;IAChE,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG;QACX,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChC,SAAS,EAAE,IAAI,aAAa,EAAE;QAC9B,UAAU,EAAE,IAAI,cAAc,EAAE;QAChC,KAAK,EAAE,IAAI,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC;QACnD,WAAW,EAAE,IAAI,eAAe,EAAE;QAClC,EAAE;QACF,WAAW;QACX,GAAG;KACJ,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,MAAM,YAAY,GAAG;QACnB,GAAG,EAAE,KAAc;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5E,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAClE,CAAC"}

package/dist/clock.d.ts

@@ -0,0 +1,10 @@
+import { type ToolInvoker } from '@reticlehq/server';
+/** The deterministic-time facade exposed as `t.clock`. Each call maps to one reticle_clock knob. */
+export interface TestClock {
+    freeze(): Promise<void>;
+    advance(ms: number): Promise<void>;
+    reset(): Promise<void>;
+}
+/** Build a TestClock bound to one invoker + session. Each method calls reticle_clock with one knob. */
+export declare function buildClock(invoke: ToolInvoker, sessionId?: string): TestClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElE,oGAAoG;AACpG,MAAM,WAAW,SAAS;IACxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAY7E"}

package/dist/clock.js

@@ -0,0 +1,19 @@
+import { ReticleTool } from '@reticlehq/server';
+function clockArgs(knob, sessionId) {
+    return { ...knob, ...(sessionId !== undefined ? { sessionId } : {}) };
+}
+/** Build a TestClock bound to one invoker + session. Each method calls reticle_clock with one knob. */
+export function buildClock(invoke, sessionId) {
+    return {
+        async freeze() {
+            await invoke(ReticleTool.CLOCK, clockArgs({ freeze: true }, sessionId));
+        },
+        async advance(ms) {
+            await invoke(ReticleTool.CLOCK, clockArgs({ advanceMs: ms }, sessionId));
+        },
+        async reset() {
+            await invoke(ReticleTool.CLOCK, clockArgs({ reset: true }, sessionId));
+        },
+    };
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AASlE,SAAS,SAAS,CAAC,IAA6B,EAAE,SAAkB;IAClE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,UAAU,CAAC,MAAmB,EAAE,SAAkB;IAChE,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,EAAU;YACtB,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,87 @@
+/** Outcome of a single spec. No free strings — every status crosses the result boundary. */
+export declare const TestStatus: {
+    readonly PASS: "pass";
+    readonly FAIL: "fail";
+    readonly SKIP: "skip";
+};
+export type TestStatus = (typeof TestStatus)[keyof typeof TestStatus];
+/** Per-status glyph the printer prepends to each result line. */
+export declare const STATUS_GLYPH: {
+    readonly pass: "PASS";
+    readonly fail: "FAIL";
+    readonly skip: "SKIP";
+};
+/** The footer prefix on the summary totals line: "reticle test: N passed, M failed, K skipped". */
+export declare const SUMMARY_FOOTER_PREFIX = "reticle test:";
+/** JUnit XML tag + attribute names (no free strings in the emitter). */
+export declare const JUnit: {
+    readonly SUITE: "testsuite";
+    readonly CASE: "testcase";
+    readonly FAILURE: "failure";
+    readonly SKIPPED: "skipped";
+    readonly ATTR_NAME: "name";
+    readonly ATTR_TESTS: "tests";
+    readonly ATTR_FAILURES: "failures";
+    readonly ATTR_SKIPPED: "skipped";
+    readonly ATTR_TIME: "time";
+    readonly ATTR_MESSAGE: "message";
+};
+/** Default JUnit <testsuite name=...> when the caller does not supply one. */
+export declare const DEFAULT_JUNIT_SUITE_NAME = "reticle";
+/**
+ * Skip reason `t.expectInputModeReal()` raises when the active input mode is 'synthetic'.
+ * The runner turns the ReticleSkip carrying this into status:'skip' (never a silent pass).
+ */
+export declare const SKIP_REASON_REAL_INPUT = "real input not active \u2014 run via reticle drive";
+/** Default wait window for assertion matchers (reticle_assert timeout_ms). */
+export declare const DEFAULT_ASSERT_TIMEOUT_MS = 4000;
+/** Predicate `kind` discriminants the matchers build. Mirrors @reticlehq/server's Predicate union. */
+export declare const PredicateKind: {
+    readonly SIGNAL: "signal";
+    readonly NET: "net";
+    readonly ELEMENT: "element";
+    readonly TEXT: "text";
+    readonly CONSOLE: "console";
+};
+export type PredicateKind = (typeof PredicateKind)[keyof typeof PredicateKind];
+/** Console level the expectNoConsoleErrors matcher asserts is absent. */
+export declare const CONSOLE_LEVEL_ERROR = "error";
+/** Prefix of the ReticleQueryEmptyError message when a testid resolves to nothing. */
+export declare const NO_ELEMENT_FOR_TESTID = "no element for testid";
+/**
+ * Default testid the input-mode probe resolves to when no act has run yet. Apps that opt into
+ * `expectInputModeReal()` before any act should tag a stable benign element with this testid;
+ * the probe runs a non-mutating SCROLL_INTO_VIEW against it purely to read the reported inputMode.
+ */
+export declare const PROBE_TESTID = "reticle-root";
+/**
+ * a flow under .reticle/flows becomes a runnable spec. A flow either loads to a
+ * RUNNABLE spec (replay its anchored steps + assert flow.success) or, when the file is
+ * missing/malformed/badly-named, surfaces as an ERROR spec that fails loudly (never a silent skip).
+ */
+export declare const SpecKind: {
+    readonly RUNNABLE: "runnable";
+    readonly ERROR: "error";
+};
+export type SpecKind = (typeof SpecKind)[keyof typeof SpecKind];
+/** FLOW2SPEC: the binary outcome of running one RUNNABLE flow spec. */
+export declare const SpecOutcome: {
+    readonly PASS: "pass";
+    readonly FAIL: "fail";
+};
+export type SpecOutcome = (typeof SpecOutcome)[keyof typeof SpecOutcome];
+/**
+ * FLOW2SPEC: the named failure/diagnostic messages a flow spec can carry — never a free string.
+ * SUCCESS_NOT_MET: replay was clean but flow.success did not hold. STEP_DRIFT: a step anchor
+ * drifted or its expect did not hold (replay stopped). EMPTY_DIR: documentation-only note that an
+ * empty .reticle/flows yields zero specs.
+ */
+export declare const SpecMessage: {
+    readonly SUCCESS_NOT_MET: "flow.success predicate did not hold after replay";
+    readonly STEP_DRIFT: "a step anchor drifted or its expect did not hold";
+    readonly EMPTY_DIR: "no flows under .reticle/flows — zero specs registered";
+};
+export type SpecMessage = (typeof SpecMessage)[keyof typeof SpecMessage];
+/** FLOW2SPEC: prefix of the Error a malformed/missing flow file raises when its spec runs. */
+export declare const FLOW_LOAD_ERROR_PREFIX = "flow could not be loaded";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,eAAO,MAAM,UAAU;;;;CAAwD,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,YAAY;;;;CAIsB,CAAC;AAEhD,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,uDAAkD,CAAC;AAEtF,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,sGAAsG;AACtG,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAoD,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,uEAAuE;AACvE,eAAO,MAAM,WAAW;;;CAA0C,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,6BAA6B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,72 @@
+/** Outcome of a single spec. No free strings — every status crosses the result boundary. */
+export const TestStatus = { PASS: 'pass', FAIL: 'fail', SKIP: 'skip' };
+/** Per-status glyph the printer prepends to each result line. */
+export const STATUS_GLYPH = {
+    pass: 'PASS',
+    fail: 'FAIL',
+    skip: 'SKIP',
+};
+/** The footer prefix on the summary totals line: "reticle test: N passed, M failed, K skipped". */
+export const SUMMARY_FOOTER_PREFIX = 'reticle test:';
+/** JUnit XML tag + attribute names (no free strings in the emitter). */
+export const JUnit = {
+    SUITE: 'testsuite',
+    CASE: 'testcase',
+    FAILURE: 'failure',
+    SKIPPED: 'skipped',
+    ATTR_NAME: 'name',
+    ATTR_TESTS: 'tests',
+    ATTR_FAILURES: 'failures',
+    ATTR_SKIPPED: 'skipped',
+    ATTR_TIME: 'time',
+    ATTR_MESSAGE: 'message',
+};
+/** Default JUnit <testsuite name=...> when the caller does not supply one. */
+export const DEFAULT_JUNIT_SUITE_NAME = 'reticle';
+/**
+ * Skip reason `t.expectInputModeReal()` raises when the active input mode is 'synthetic'.
+ * The runner turns the ReticleSkip carrying this into status:'skip' (never a silent pass).
+ */
+export const SKIP_REASON_REAL_INPUT = 'real input not active — run via reticle drive';
+/** Default wait window for assertion matchers (reticle_assert timeout_ms). */
+export const DEFAULT_ASSERT_TIMEOUT_MS = 4000;
+/** Predicate `kind` discriminants the matchers build. Mirrors @reticlehq/server's Predicate union. */
+export const PredicateKind = {
+    SIGNAL: 'signal',
+    NET: 'net',
+    ELEMENT: 'element',
+    TEXT: 'text',
+    CONSOLE: 'console',
+};
+/** Console level the expectNoConsoleErrors matcher asserts is absent. */
+export const CONSOLE_LEVEL_ERROR = 'error';
+/** Prefix of the ReticleQueryEmptyError message when a testid resolves to nothing. */
+export const NO_ELEMENT_FOR_TESTID = 'no element for testid';
+/**
+ * Default testid the input-mode probe resolves to when no act has run yet. Apps that opt into
+ * `expectInputModeReal()` before any act should tag a stable benign element with this testid;
+ * the probe runs a non-mutating SCROLL_INTO_VIEW against it purely to read the reported inputMode.
+ */
+export const PROBE_TESTID = 'reticle-root';
+/**
+ * a flow under .reticle/flows becomes a runnable spec. A flow either loads to a
+ * RUNNABLE spec (replay its anchored steps + assert flow.success) or, when the file is
+ * missing/malformed/badly-named, surfaces as an ERROR spec that fails loudly (never a silent skip).
+ */
+export const SpecKind = { RUNNABLE: 'runnable', ERROR: 'error' };
+/** FLOW2SPEC: the binary outcome of running one RUNNABLE flow spec. */
+export const SpecOutcome = { PASS: 'pass', FAIL: 'fail' };
+/**
+ * FLOW2SPEC: the named failure/diagnostic messages a flow spec can carry — never a free string.
+ * SUCCESS_NOT_MET: replay was clean but flow.success did not hold. STEP_DRIFT: a step anchor
+ * drifted or its expect did not hold (replay stopped). EMPTY_DIR: documentation-only note that an
+ * empty .reticle/flows yields zero specs.
+ */
+export const SpecMessage = {
+    SUCCESS_NOT_MET: 'flow.success predicate did not hold after replay',
+    STEP_DRIFT: 'a step anchor drifted or its expect did not hold',
+    EMPTY_DIR: 'no flows under .reticle/flows — zero specs registered',
+};
+/** FLOW2SPEC: prefix of the Error a malformed/missing flow file raises when its spec runs. */
+export const FLOW_LOAD_ERROR_PREFIX = 'flow could not be loaded';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACiC,CAAC;AAEhD,mGAAmG;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,UAAU;IACzB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,SAAS;CACf,CAAC;AAEX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAG1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,kDAAkD;IACnE,UAAU,EAAE,kDAAkD;IAC9D,SAAS,EAAE,uDAAuD;CAC1D,CAAC;AAGX,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC"}

package/dist/flow-spec.d.ts

@@ -0,0 +1,53 @@
+import { type FlowErrorCode, type FlowFile, type FlowStepResult } from '@reticlehq/core';
+import { FlowStore } from '@reticlehq/server';
+import type { Clock, EvalResult, FileSystemPort, FlowReplaySession, WaitForSignal } from '@reticlehq/server';
+import { SpecKind, SpecMessage, SpecOutcome } from './constants.js';
+/** FLOW2SPEC — the result of running one RUNNABLE flow spec, evidence-bearing on a FAIL. */
+export interface SpecRunResult {
+    outcome: SpecOutcome;
+    /** Verbatim from replayFlow — carries each step's drift/nearest evidence. */
+    steps: FlowStepResult[];
+    /** From assertSuccess — carries the predicate failureReason + near-miss on a FAIL. */
+    successResult: EvalResult;
+    /** A named SpecMessage explaining a FAIL (never set on a PASS). */
+    message?: SpecMessage;
+}
+/**
+ * FLOW2SPEC — one flow rendered as a runnable spec. Every spec carries `run`. A RUNNABLE spec
+ * replays + asserts success; an ERROR spec (file missing/malformed/badly-named) carries `loadError`
+ * and a `run` whose returned SpecRunResult is FAIL, so a corrupted flow fails loudly in the suite
+ * rather than vanishing. The vitest binding (register.ts) turns the load error into a thrown Error.
+ */
+export interface FlowSpec {
+    name: string;
+    kind: SpecKind;
+    loadError?: {
+        code: FlowErrorCode;
+    };
+    run: (session: FlowReplaySession) => Promise<SpecRunResult>;
+}
+export interface FlowSpecOptions {
+    /** Defaults to waitForPredicate from @reticlehq/server (the real engine). */
+    waitForSignal?: WaitForSignal;
+    /** Defaults to FLOW_SIGNAL_TIMEOUT_MS. Injected so a spec never reads the wall clock. */
+    signalTimeoutMs?: number;
+}
+/**
+ * Build one RUNNABLE FlowSpec from an already-loaded FlowFile. Composition only — replay (anchored
+ * steps + per-step expect + dynamic skip) comes from @reticlehq/server's replayFlow; the sole new
+ * assertion is flow.success via the same predicate engine.
+ */
+export declare function flowToSpec(flow: FlowFile, opts?: FlowSpecOptions): FlowSpec;
+export interface FlowsAsSpecsOptions extends FlowSpecOptions {
+    /** Injected fs port when `source` is a dir string (defaults to the node fs). */
+    fs?: FileSystemPort;
+    /** Injected clock for the FlowStore createdAt (rule 7) when `source` is a dir string. */
+    clock?: Clock;
+}
+/**
+ * FLOW2SPEC — enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
+ * IS the suite. An empty/absent dir yields [] (no throw). A malformed/badly-named file becomes an
+ * ERROR spec; enumeration of its siblings is never aborted.
+ */
+export declare function flowsAsSpecs(source: string | FlowStore, opts?: FlowsAsSpecsOptions): Promise<FlowSpec[]>;
+//# sourceMappingURL=flow-spec.d.ts.map

package/dist/flow-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-spec.d.ts","sourceRoot":"","sources":["../src/flow-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAsD,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGpE,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,sFAAsF;IACtF,aAAa,EAAE,UAAU,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC;IACpC,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CA+B3E;AAkBD,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,gFAAgF;IAChF,EAAE,CAAC,EAAE,cAAc,CAAC;IACpB,yFAAyF;IACzF,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiBrB"}

package/dist/flow-spec.js

@@ -0,0 +1,79 @@
+import { AnchorKind, FLOW_SIGNAL_TIMEOUT_MS, } from '@reticlehq/core';
+import { FlowStore, createNodeFileSystem, replayFlow, waitForPredicate } from '@reticlehq/server';
+import { SpecKind, SpecMessage, SpecOutcome } from './constants.js';
+import { assertSuccess } from './success-assert.js';
+/** Derive the dynamic testid skip-set exactly as replayFlow does (testid anchors only). */
+function toDynamicSet(flow) {
+    return new Set((flow.dynamic ?? [])
+        .filter((a) => a.kind === AnchorKind.TESTID)
+        .map((a) => (a.kind === AnchorKind.TESTID ? a.value : '')));
+}
+/**
+ * Build one RUNNABLE FlowSpec from an already-loaded FlowFile. Composition only — replay (anchored
+ * steps + per-step expect + dynamic skip) comes from @reticlehq/server's replayFlow; the sole new
+ * assertion is flow.success via the same predicate engine.
+ */
+export function flowToSpec(flow, opts) {
+    const waitForSignal = opts?.waitForSignal ?? waitForPredicate;
+    const timeoutMs = opts?.signalTimeoutMs ?? FLOW_SIGNAL_TIMEOUT_MS;
+    return {
+        name: flow.name,
+        kind: SpecKind.RUNNABLE,
+        run: async (session) => {
+            const steps = await replayFlow(session, flow, waitForSignal, timeoutMs);
+            const stepsOk = steps.every((s) => s.ok);
+            const dynamic = toDynamicSet(flow);
+            const successResult = await assertSuccess(session, flow.success, dynamic, waitForSignal, timeoutMs);
+            if (!stepsOk) {
+                return { outcome: SpecOutcome.FAIL, steps, successResult, message: SpecMessage.STEP_DRIFT };
+            }
+            if (!successResult.pass) {
+                return {
+                    outcome: SpecOutcome.FAIL,
+                    steps,
+                    successResult,
+                    message: SpecMessage.SUCCESS_NOT_MET,
+                };
+            }
+            return { outcome: SpecOutcome.PASS, steps, successResult };
+        },
+    };
+}
+/** An ERROR spec for a flow file that failed to load. Its run() returns a FAIL with no steps. */
+function errorSpec(name, code) {
+    const result = {
+        outcome: SpecOutcome.FAIL,
+        steps: [],
+        successResult: { pass: false, failureReason: code },
+        message: SpecMessage.STEP_DRIFT,
+    };
+    return {
+        name,
+        kind: SpecKind.ERROR,
+        loadError: { code },
+        run: () => Promise.resolve(result),
+    };
+}
+/**
+ * FLOW2SPEC — enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
+ * IS the suite. An empty/absent dir yields [] (no throw). A malformed/badly-named file becomes an
+ * ERROR spec; enumeration of its siblings is never aborted.
+ */
+export async function flowsAsSpecs(source, opts) {
+    const store = typeof source === 'string'
+        ? new FlowStore(opts?.fs ?? createNodeFileSystem(), source, opts?.clock ?? { now: () => 0 })
+        : source;
+    const names = await store.list();
+    const specs = [];
+    for (const name of names) {
+        const loaded = await store.load(name);
+        if (loaded.ok) {
+            specs.push(flowToSpec(loaded.value, opts));
+        }
+        else {
+            specs.push(errorSpec(name, loaded.code));
+        }
+    }
+    return specs;
+}
+//# sourceMappingURL=flow-spec.js.map

package/dist/flow-spec.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { reticleTest } from './spec.js';
+export { register, getRegistered, clearRegistry } from './registry.js';
+export { runSpecs, runOne } from './runner.js';
+export { summarize, printSummary } from './summary.js';
+export { toJUnitXml, writeJUnit } from './junit.js';
+export { bootSession } from './boot.js';
+export type { BootedRun, BootOptions } from './boot.js';
+export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip } from './skip.js';
+export type { AssertionDetail } from './skip.js';
+export { createTestContext } from './test-context.js';
+export type { TestContext, TestContextOptions, Predicate } from './test-context.js';
+export type { TestClock } from './clock.js';
+export { resolveTestid } from './resolve.js';
+export { expectInputModeReal, InputModeTracker, readInputMode } from './input-mode.js';
+export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './constants.js';
+export type { SpecContext, SpecFn, ReticleSpec, SpecResult, RunSummary, ContextFactory, RunnerOptions, } from './types.js';
+export { flowToSpec, flowsAsSpecs } from './flow-spec.js';
+export type { FlowSpec, FlowSpecOptions, FlowsAsSpecsOptions, SpecRunResult } from './flow-spec.js';
+export { assertSuccess, successToPredicate } from './success-assert.js';
+export { registerFlowSpecs, reticleFlowsAsSpecs, FlowMalformedError, SpecFailure, } from './register.js';
+export type { RegisterFn, RegisterFlowSpecsOptions } from './register.js';
+export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,KAAK,EACL,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,MAAM,EACN,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export { reticleTest } from './spec.js';
+export { register, getRegistered, clearRegistry } from './registry.js';
+export { runSpecs, runOne } from './runner.js';
+export { summarize, printSummary } from './summary.js';
+export { toJUnitXml, writeJUnit } from './junit.js';
+export { bootSession } from './boot.js';
+export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip } from './skip.js';
+export { createTestContext } from './test-context.js';
+export { resolveTestid } from './resolve.js';
+export { expectInputModeReal, InputModeTracker, readInputMode } from './input-mode.js';
+export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './constants.js';
+// flows under .reticle/flows become the runnable suite.
+export { flowToSpec, flowsAsSpecs } from './flow-spec.js';
+export { assertSuccess, successToPredicate } from './success-assert.js';
+export { registerFlowSpecs, reticleFlowsAsSpecs, FlowMalformedError, SpecFailure, } from './register.js';
+export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EACL,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,KAAK,EACL,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AAWxB,wDAAwD;AACxD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/input-mode.d.ts

@@ -0,0 +1,21 @@
+import { type ToolInvoker } from '@reticlehq/server';
+import { InputMode } from '@reticlehq/core';
+/** The act envelope's inputMode field, narrowed from the raw tool result. */
+export declare function readInputMode(actResult: unknown): InputMode | undefined;
+/**
+ * Tracks the most recent act's inputMode across a spec so `expectInputModeReal()` can read it
+ * without re-touching the page. The context records every act through `record`.
+ */
+export declare class InputModeTracker {
+    private last;
+    record(actResult: unknown): void;
+    get(): InputMode | undefined;
+}
+/**
+ * Assert real native input is active. Prefers the last act's reported mode (zero extra page
+ * mutation); if no act has run, issues a non-mutating SCROLL_INTO_VIEW probe and reads its mode.
+ * On 'synthetic' throws ReticleSkip(SKIP_REASON_REAL_INPUT) — the runner turns this into status:'skip'.
+ * It NEVER silently passes on synthetic.
+ */
+export declare function expectInputModeReal(invoke: ToolInvoker, tracker: InputModeTracker, sessionId?: string): Promise<void>;
+//# sourceMappingURL=input-mode.d.ts.map

package/dist/input-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-mode.d.ts","sourceRoot":"","sources":["../src/input-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAKvE;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAwB;IAEpC,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAKhC,GAAG,IAAI,SAAS,GAAG,SAAS;CAG7B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf"}