@reticlehq/test 2.0.0

package/dist/skip.js

@@ -0,0 +1,44 @@
+/**
+ * The skip sentinel. MATCHERS' `t.expectInputModeReal()` throws this when the active input mode
+ * is not 'real', so the runner reports `status:'skip'` (with the reason) instead of a silent pass.
+ */
+export class ReticleSkip extends Error {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.name = 'ReticleSkip';
+        this.reason = reason;
+    }
+}
+/**
+ * A failed matcher (e.g. an `reticle_assert` returning `{ pass:false, failureReason }`). Carries the
+ * reason as its message plus the tool's structured `evidence`/`failureReason`; the runner treats it
+ * as an ordinary fail (the message becomes SpecResult.error).
+ */
+export class ReticleAssertionError extends Error {
+    evidence;
+    failureReason;
+    constructor(message, detail) {
+        super(message);
+        this.name = 'ReticleAssertionError';
+        // exactOptionalPropertyTypes: only assign optional fields when actually provided.
+        if (detail?.evidence !== undefined)
+            this.evidence = detail.evidence;
+        if (detail?.failureReason !== undefined)
+            this.failureReason = detail.failureReason;
+    }
+}
+/**
+ * Raised when a testid resolves to zero elements (the act/fill chokepoint). A subclass so a runner
+ * can special-case "unknown testid" if it wants, but it is still an ordinary fail.
+ */
+export class ReticleQueryEmptyError extends ReticleAssertionError {
+    constructor(message, detail) {
+        super(message, detail);
+        this.name = 'ReticleQueryEmptyError';
+    }
+}
+export function isSkip(error) {
+    return error instanceof ReticleSkip;
+}
+//# sourceMappingURL=skip.js.map

package/dist/skip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip.js","sourceRoot":"","sources":["../src/skip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAUD;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,QAAQ,CAAW;IACnB,aAAa,CAAU;IAEhC,YAAY,OAAe,EAAE,MAAwB;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,kFAAkF;QAClF,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACpE,IAAI,MAAM,EAAE,aAAa,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IACrF,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,qBAAqB;IAC/D,YAAY,OAAe,EAAE,MAAwB;QACnD,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC"}

package/dist/spec.d.ts

@@ -0,0 +1,4 @@
+import type { SpecFn } from './types.js';
+/** Public registration entry: `reticleTest('does X', async (t) => { ... })`. */
+export declare function reticleTest(name: string, fn: SpecFn): void;
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/spec.js

@@ -0,0 +1,6 @@
+import { register } from './registry.js';
+/** Public registration entry: `reticleTest('does X', async (t) => { ... })`. */
+export function reticleTest(name, fn) {
+    register({ name, fn });
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,EAAU;IAClD,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/dist/success-assert.d.ts

@@ -0,0 +1,7 @@
+/**
+ * FLOW2SPEC — the flow success-assertion oracle now lives in @reticlehq/server so the live MCP
+ * `reticle_flow_replay` tool and this spec runner share ONE implementation (no divergent oracle).
+ * Re-exported here to keep the spec-runner's import surface stable.
+ */
+export { successToPredicate, assertSuccess } from '@reticlehq/server';
+//# sourceMappingURL=success-assert.d.ts.map

package/dist/success-assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"success-assert.d.ts","sourceRoot":"","sources":["../src/success-assert.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/success-assert.js

@@ -0,0 +1,7 @@
+/**
+ * FLOW2SPEC — the flow success-assertion oracle now lives in @reticlehq/server so the live MCP
+ * `reticle_flow_replay` tool and this spec runner share ONE implementation (no divergent oracle).
+ * Re-exported here to keep the spec-runner's import surface stable.
+ */
+export { successToPredicate, assertSuccess } from '@reticlehq/server';
+//# sourceMappingURL=success-assert.js.map

package/dist/success-assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"success-assert.js","sourceRoot":"","sources":["../src/success-assert.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/summary.d.ts

@@ -0,0 +1,8 @@
+import type { RunSummary, SpecResult } from './types.js';
+export declare function summarize(results: readonly SpecResult[]): RunSummary;
+/**
+ * Write one line per spec plus a totals footer to the injected sink. NEVER references console
+ * (no-console is an error); the CLI wrapper passes a stdout writer, tests pass a buffer collector.
+ */
+export declare function printSummary(summary: RunSummary, results: readonly SpecResult[], print: (line: string) => void): void;
+//# sourceMappingURL=summary.d.ts.map

package/dist/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAUpE;AASD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,IAAI,CAMN"}

package/dist/summary.js

@@ -0,0 +1,34 @@
+import { STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, TestStatus } from './constants.js';
+export function summarize(results) {
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    for (const r of results) {
+        if (r.status === TestStatus.PASS)
+            passed += 1;
+        else if (r.status === TestStatus.FAIL)
+            failed += 1;
+        else
+            skipped += 1;
+    }
+    return { total: results.length, passed, failed, skipped, ok: failed === 0 };
+}
+function resultLine(r) {
+    const head = `${STATUS_GLYPH[r.status]} ${r.name} (${String(r.durationMs)}ms)`;
+    if (r.skipReason !== undefined)
+        return `${head} — ${r.skipReason}`;
+    if (r.error !== undefined)
+        return `${head} — ${r.error}`;
+    return head;
+}
+/**
+ * Write one line per spec plus a totals footer to the injected sink. NEVER references console
+ * (no-console is an error); the CLI wrapper passes a stdout writer, tests pass a buffer collector.
+ */
+export function printSummary(summary, results, print) {
+    for (const r of results)
+        print(resultLine(r));
+    print(`${SUMMARY_FOOTER_PREFIX} ${String(summary.passed)} passed, ` +
+        `${String(summary.failed)} failed, ${String(summary.skipped)} skipped`);
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjF,MAAM,UAAU,SAAS,CAAC,OAA8B;IACtD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,IAAI;YAAE,MAAM,IAAI,CAAC,CAAC;aACzC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,IAAI;YAAE,MAAM,IAAI,CAAC,CAAC;;YAC9C,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,CAAa;IAC/B,MAAM,IAAI,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/E,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,GAAG,IAAI,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;IACnE,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAmB,EACnB,OAA8B,EAC9B,KAA6B;IAE7B,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,CACH,GAAG,qBAAqB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW;QAC3D,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CACzE,CAAC;AACJ,CAAC"}

package/dist/test-context.d.ts

@@ -0,0 +1,34 @@
+import { type ToolInvoker } from '@reticlehq/server';
+import { ActionType, type ElementQuery, type ElementState } from '@reticlehq/core';
+import { type TestClock } from './clock.js';
+/** A declarative predicate (the reticle_assert/until DSL). Kept structural to avoid a server type dep. */
+export type Predicate = Record<string, unknown>;
+export interface TestContextOptions {
+    /** Forwarded into every tool call's args so multi-session runs target the right tab. */
+    sessionId?: string;
+    /** Wait window for assertion matchers (default DEFAULT_ASSERT_TIMEOUT_MS). */
+    defaultTimeoutMs?: number;
+}
+/** The per-spec `t` façade: a typed, thin wrapper over the tool invoker. */
+export interface TestContext {
+    readonly invoke: ToolInvoker;
+    act(testid: string, action: ActionType, args?: Record<string, unknown>): Promise<void>;
+    fill(testid: string, value: string): Promise<void>;
+    actAndWait(testid: string, action: ActionType, until: Predicate): Promise<void>;
+    expectSignal(name: string, dataMatches?: Record<string, unknown>): Promise<void>;
+    expectNet(method: string, urlContains: string, status?: number): Promise<void>;
+    expectElement(query: ElementQuery, state?: ElementState): Promise<void>;
+    expectText(contains: string): Promise<void>;
+    expectAbsent(query: ElementQuery): Promise<void>;
+    expectNoConsoleErrors(): Promise<void>;
+    state(storeOrRef: string): Promise<unknown>;
+    clock: TestClock;
+    expectInputModeReal(): Promise<void>;
+}
+/**
+ * Build the `t` handed to each spec. A pure façade over `invoke`: every method maps to one or two
+ * tool calls and throws structured errors on failure (the runner catches them). No transport, DOM,
+ * or Node FS lives here — the only dependency is the injected invoker.
+ */
+export declare function createTestContext(invoke: ToolInvoker, options?: TestContextOptions): TestContext;
+//# sourceMappingURL=test-context.d.ts.map

package/dist/test-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-context.d.ts","sourceRoot":"","sources":["../src/test-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAcxD,0GAA0G;AAC1G,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,KAAK,EAAE,SAAS,CAAC;IACjB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAkBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAgEb"}

package/dist/test-context.js

@@ -0,0 +1,85 @@
+import { ReticleTool } from '@reticlehq/server';
+import { ActionType } from '@reticlehq/core';
+import { resolveTestid } from './resolve.js';
+import { buildClock } from './clock.js';
+import { InputModeTracker, expectInputModeReal } from './input-mode.js';
+import { failFromVerdict } from './matchers.js';
+import { expectAbsent, expectElement, expectNet, expectNoConsoleErrors, expectSignal, expectText, } from './matchers.js';
+import { DEFAULT_ASSERT_TIMEOUT_MS } from './constants.js';
+function asVerdict(value) {
+    const record = typeof value === 'object' && value !== null ? value : {};
+    const verdict = record['verdict'];
+    if (typeof verdict !== 'object' || verdict === null) {
+        return { pass: false, failureReason: 'act_and_wait returned no verdict' };
+    }
+    const v = verdict;
+    const failureReason = typeof v['failureReason'] === 'string' ? v['failureReason'] : undefined;
+    return {
+        pass: v['pass'] === true,
+        evidence: v['evidence'],
+        ...(failureReason !== undefined ? { failureReason } : {}),
+    };
+}
+/**
+ * Build the `t` handed to each spec. A pure façade over `invoke`: every method maps to one or two
+ * tool calls and throws structured errors on failure (the runner catches them). No transport, DOM,
+ * or Node FS lives here — the only dependency is the injected invoker.
+ */
+export function createTestContext(invoke, options = {}) {
+    const sessionId = options.sessionId;
+    const timeoutMs = options.defaultTimeoutMs ?? DEFAULT_ASSERT_TIMEOUT_MS;
+    const tracker = new InputModeTracker();
+    const deps = {
+        invoke,
+        timeoutMs,
+        ...(sessionId !== undefined ? { sessionId } : {}),
+    };
+    async function runAct(testid, action, args) {
+        const ref = await resolveTestid(invoke, testid, sessionId);
+        const actArgs = {
+            ref,
+            action,
+            ...(args !== undefined ? { args } : {}),
+            ...(sessionId !== undefined ? { sessionId } : {}),
+        };
+        const result = await invoke(ReticleTool.ACT, actArgs);
+        tracker.record(result);
+    }
+    return {
+        invoke,
+        act: (testid, action, args) => runAct(testid, action, args),
+        fill: (testid, value) => runAct(testid, ActionType.FILL, { value }),
+        async actAndWait(testid, action, until) {
+            const ref = await resolveTestid(invoke, testid, sessionId);
+            const waitArgs = {
+                ref,
+                action,
+                until,
+                timeout_ms: timeoutMs,
+                ...(sessionId !== undefined ? { sessionId } : {}),
+            };
+            const raw = await invoke(ReticleTool.ACT_AND_WAIT, waitArgs);
+            const verdict = asVerdict(raw);
+            if (!verdict.pass) {
+                const trace = raw['trace'];
+                failFromVerdict(verdict, trace !== undefined ? { trace } : undefined);
+            }
+        },
+        expectSignal: (name, dataMatches) => expectSignal(deps, name, dataMatches),
+        expectNet: (method, urlContains, status) => expectNet(deps, method, urlContains, status),
+        expectElement: (query, state) => expectElement(deps, query, state),
+        expectText: (contains) => expectText(deps, contains),
+        expectAbsent: (query) => expectAbsent(deps, query),
+        expectNoConsoleErrors: () => expectNoConsoleErrors(deps),
+        async state(storeOrRef) {
+            const args = {
+                store: storeOrRef,
+                ...(sessionId !== undefined ? { sessionId } : {}),
+            };
+            return invoke(ReticleTool.STATE, args);
+        },
+        clock: buildClock(invoke, sessionId),
+        expectInputModeReal: () => expectInputModeReal(invoke, tracker, sessionId),
+    };
+}
+//# sourceMappingURL=test-context.js.map

package/dist/test-context.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+import type { ToolInvoker } from '@reticlehq/server';
+import type { TestStatus } from './constants.js';
+/**
+ * The per-spec `t` handed to a spec body. Defined by the MATCHERS facet (out of scope here);
+ * the RUNNER treats it as opaque except for the skip protocol it raises (see skip.ts).
+ */
+export interface SpecContext {
+    readonly invoke: ToolInvoker;
+}
+export type SpecFn = (t: SpecContext) => void | Promise<void>;
+export interface ReticleSpec {
+    readonly name: string;
+    readonly fn: SpecFn;
+}
+export interface SpecResult {
+    name: string;
+    status: TestStatus;
+    durationMs: number;
+    /** Present only on a fail (exactOptionalPropertyTypes ⇒ conditionally spread, never =undefined). */
+    error?: string;
+    /** Present only on a skip. */
+    skipReason?: string;
+}
+export interface RunSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    ok: boolean;
+}
+/** Builds the per-spec `t` from the invoker — supplied by MATCHERS; the runner only calls it. */
+export type ContextFactory = (invoke: ToolInvoker) => SpecContext;
+export interface RunnerOptions {
+    /** Injected — the ONLY way the runner reaches the browser/tools. */
+    invoke: ToolInvoker;
+    /** Injected — builds the opaque `t`, keeping the runner decoupled from MATCHERS. */
+    buildContext: ContextFactory;
+    /** Injected clock (rule 7) — the durationMs source. */
+    now: () => number;
+    /** Injected sink; when present, the runner prints a summary. The runner never touches console. */
+    print?: (line: string) => void;
+    /** Defaults to a snapshot of the module registry taken at call time. */
+    specs?: readonly ReticleSpec[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,iGAAiG;AACjG,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,MAAM,EAAE,WAAW,CAAC;IACpB,oFAAoF;IACpF,YAAY,EAAE,cAAc,CAAC;IAC7B,uDAAuD;IACvD,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,kGAAkG;IAClG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@reticlehq/test",
+  "version": "2.0.0",
+  "description": "Reticle test runner: reticleTest spec registry + a runner that drives Reticle tools without MCP/stdio.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@reticlehq/core": "2.0.0",
+    "@reticlehq/server": "2.0.0"
+  },
+  "peerDependencies": {
+    "vitest": "^3.2.6"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Reticle contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reticlehq/reticle.git",
+    "directory": "packages/test"
+  },
+  "homepage": "https://github.com/reticlehq/reticle#readme",
+  "bugs": "https://github.com/reticlehq/reticle/issues",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "mcp",
+    "ai-agents",
+    "testing"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "lint": "eslint src",
+    "test:unit": "vitest run src --passWithNoTests"
+  }
+}