@reticlehq/server 2.0.0

package/dist/domain/flow-risk.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Risk-rank flows so an agent tests the riskiest first. Risk combines two signals:
+ *  - run history (.reticle/project.json): a flow whose last run errored/drifted, or passed but with
+ *    console/network errors, is riskier than one that passed clean; a never-run flow is unknown.
+ *  - assertion quality (flow-classify): a flow that asserts no consequence is risky EVEN when it
+ *    "passes" — a green assertion-free flow is false confidence (Fowler/Dodds), so it can't be
+ *    trusted to catch a regression.
+ *
+ * Taking the worse of the two means "passed clean last time" never hides "but it asserts nothing".
+ * Pure: no IO, no clock.
+ */
+import { RunStatus, type RunRecord } from '@reticlehq/core';
+export declare const RiskLevel: {
+    readonly HIGH: "high";
+    readonly MEDIUM: "medium";
+    readonly LOW: "low";
+    readonly UNKNOWN: "unknown";
+};
+export type RiskLevel = (typeof RiskLevel)[keyof typeof RiskLevel];
+export interface FlowRisk {
+    level: RiskLevel;
+    reason: string;
+    lastStatus?: RunStatus;
+}
+/** Most recent run for a flow name (by `at`), or undefined if it has never been recorded. */
+export declare function latestRun(name: string, runs: readonly RunRecord[]): RunRecord | undefined;
+/** The worse of run-history risk and assertion-quality risk. */
+export declare function flowRisk(grade: string, run: RunRecord | undefined): FlowRisk;
+/** Order flow names worst-risk first (HIGH→UNKNOWN), ties broken by name for stable output. */
+export declare function rankByRisk(entries: {
+    name: string;
+    risk: FlowRisk;
+}[]): string[];
+//# sourceMappingURL=flow-risk.d.ts.map

package/dist/domain/flow-risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-risk.d.ts","sourceRoot":"","sources":["../../src/domain/flow-risk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5D,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAWnE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,CAMzF;AA+BD,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAO5E;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAIhF"}

package/dist/domain/flow-risk.js

@@ -0,0 +1,81 @@
+/**
+ * Risk-rank flows so an agent tests the riskiest first. Risk combines two signals:
+ *  - run history (.reticle/project.json): a flow whose last run errored/drifted, or passed but with
+ *    console/network errors, is riskier than one that passed clean; a never-run flow is unknown.
+ *  - assertion quality (flow-classify): a flow that asserts no consequence is risky EVEN when it
+ *    "passes" — a green assertion-free flow is false confidence (Fowler/Dodds), so it can't be
+ *    trusted to catch a regression.
+ *
+ * Taking the worse of the two means "passed clean last time" never hides "but it asserts nothing".
+ * Pure: no IO, no clock.
+ */
+import { RunStatus } from '@reticlehq/core';
+import { FlowAssertionGrade } from '../flows/flow-classify.js';
+export const RiskLevel = {
+    HIGH: 'high',
+    MEDIUM: 'medium',
+    LOW: 'low',
+    UNKNOWN: 'unknown',
+};
+// Test-priority order: a known failure first, then a known weakness, then a NEVER-RUN flow
+// (unvalidated — worth running before a known-clean one), then a clean low-risk flow last.
+const RANK = {
+    [RiskLevel.HIGH]: 3,
+    [RiskLevel.MEDIUM]: 2,
+    [RiskLevel.UNKNOWN]: 1,
+    [RiskLevel.LOW]: 0,
+};
+/** Most recent run for a flow name (by `at`), or undefined if it has never been recorded. */
+export function latestRun(name, runs) {
+    let best;
+    for (const run of runs) {
+        if (run.name === name && (best === undefined || run.at > best.at))
+            best = run;
+    }
+    return best;
+}
+function runRisk(run) {
+    if (run === undefined)
+        return { level: RiskLevel.UNKNOWN, reason: 'never run' };
+    if (run.status === RunStatus.ERROR || run.status === RunStatus.FAIL) {
+        return { level: RiskLevel.HIGH, reason: 'last run failed' };
+    }
+    if (run.status === RunStatus.DRIFT)
+        return { level: RiskLevel.HIGH, reason: 'last run drifted' };
+    const errors = (run.evidence?.consoleErrors ?? 0) + (run.evidence?.networkErrors ?? 0);
+    if (errors > 0) {
+        return {
+            level: RiskLevel.MEDIUM,
+            reason: `last run passed but logged ${String(errors)} error(s)`,
+        };
+    }
+    return { level: RiskLevel.LOW, reason: 'last run passed clean' };
+}
+function gradeRisk(grade) {
+    if (grade === FlowAssertionGrade.ASSERTION_FREE) {
+        return {
+            level: RiskLevel.MEDIUM,
+            reason: 'asserts no consequence — a green run proves little',
+        };
+    }
+    if (grade === FlowAssertionGrade.PRESENCE_ONLY) {
+        return { level: RiskLevel.LOW, reason: 'presence-only assertion' };
+    }
+    return { level: RiskLevel.LOW, reason: 'asserts a consequence' };
+}
+/** The worse of run-history risk and assertion-quality risk. */
+export function flowRisk(grade, run) {
+    const r = runRisk(run);
+    const g = gradeRisk(grade);
+    const top = RANK[r.level] >= RANK[g.level] ? r : g;
+    return run === undefined
+        ? { level: top.level, reason: top.reason }
+        : { level: top.level, reason: top.reason, lastStatus: run.status };
+}
+/** Order flow names worst-risk first (HIGH→UNKNOWN), ties broken by name for stable output. */
+export function rankByRisk(entries) {
+    return [...entries]
+        .sort((a, b) => RANK[b.risk.level] - RANK[a.risk.level] || a.name.localeCompare(b.name))
+        .map((e) => e.name);
+}
+//# sourceMappingURL=flow-risk.js.map

package/dist/domain/flow-risk.js.map

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

package/dist/ee/audit-log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Example enterprise feature (Reticle Enterprise License — see ./LICENSE). Demonstrates the pattern every
+ * ee feature follows: call assertEnterprise(...) first, then do the privileged work. The body here is a
+ * stub — the real audit sink is the hosted control plane. It exists now to prove the gate.
+ */
+import { type GateContext } from '../license/license.js';
+interface AuditEvent {
+    actor: string;
+    action: string;
+    at: number;
+}
+/** Record an audit event — gated. Throws EnterpriseLicenseError in production without a valid license. */
+export declare function recordAuditEvent(event: AuditEvent, ctx: GateContext): AuditEvent;
+export {};
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/ee/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../src/ee/audit-log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE3E,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,0GAA0G;AAC1G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,UAAU,CAGhF"}

package/dist/ee/audit-log.js

@@ -0,0 +1,12 @@
+/**
+ * Example enterprise feature (Reticle Enterprise License — see ./LICENSE). Demonstrates the pattern every
+ * ee feature follows: call assertEnterprise(...) first, then do the privileged work. The body here is a
+ * stub — the real audit sink is the hosted control plane. It exists now to prove the gate.
+ */
+import { assertEnterprise } from '../license/license.js';
+/** Record an audit event — gated. Throws EnterpriseLicenseError in production without a valid license. */
+export function recordAuditEvent(event, ctx) {
+    assertEnterprise('audit-log', ctx);
+    return event; // stub: a real implementation persists to the enterprise audit store
+}
+//# sourceMappingURL=audit-log.js.map

package/dist/ee/audit-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../src/ee/audit-log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAQ3E,0GAA0G;AAC1G,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,GAAgB;IAClE,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,CAAC,qEAAqE;AACrF,CAAC"}

package/dist/events/event-filters.d.ts

@@ -0,0 +1,65 @@
+import { type ReticleEvent } from '@reticlehq/core';
+/** Match a net.request event against optional method/url/status filters (reticle_network). */
+export declare function matchNet(e: ReticleEvent, method: string | undefined, urlContains: string | undefined, status: number | undefined): boolean;
+/**
+ * Reconcile network events into completed calls + still-in-flight calls. A NET_PENDING whose
+ * `id` never gets a matching NET_REQUEST is an unresolved/hung request — the case
+ * completion-only logging is blind to. Pending events are annotated `{ status: 'pending',
+ * pending: true }` so a numeric `status` filter excludes them but `urlContains`/`method` match.
+ */
+export declare function reconcileNet(events: ReticleEvent[]): ReticleEvent[];
+/** Compact network-call summary for reticle_network output — drops event plumbing (t, type,
+ * sessionId, ref, id, initiator, ok) the agent never needs, keeping only method/url/status/ms.
+ * This is the bulk of the token cost: raw ReticleEvent objects are ~5x larger than this. */
+interface NetCallView {
+    method: string;
+    url: string;
+    status?: number | string;
+    ms?: number;
+}
+export declare function projectNetCall(e: ReticleEvent): NetCallView;
+/** Compact console-log summary for reticle_console output — { level, text } only. */
+interface ConsoleLogView {
+    level: string;
+    text: string;
+}
+export declare function projectConsoleLog(e: ReticleEvent): ConsoleLogView;
+/** True for any console.* / uncaught-error event (the reticle_console universe). */
+export declare function isConsoleEvent(e: ReticleEvent): boolean;
+/** Match a console/error event against an optional level filter (reticle_console). */
+export declare function matchConsole(e: ReticleEvent, level: string | undefined): boolean;
+/** One present network call summarized for a zero-match hint. */
+interface NetCallSummary {
+    method: string;
+    url: string;
+    status?: number;
+}
+/**
+ * Near-miss for reticle_network: when a filter matched zero calls, describe what DID fire so the
+ * agent self-corrects ("POST /x 200 matched nothing, but these 3 requests happened") instead of
+ * reading a bare []. `allNet` is every net.request in the window (pre-filter).
+ */
+interface NetEmptyHint {
+    totalInWindow: number;
+    /** Up to HINT_SAMPLE_MAX present calls (most-recent first). */
+    present: NetCallSummary[];
+}
+export declare function netEmptyHint(allNet: ReticleEvent[]): NetEmptyHint;
+/** Per-level console counts in the window — the body of a zero-match console hint. */
+interface ConsoleLevelCounts {
+    log: number;
+    warn: number;
+    error: number;
+}
+/**
+ * Near-miss for reticle_console: when a level filter matched zero logs, report what levels ARE
+ * present so the agent knows the page isn't silent ("0 errors, but 3 warns + 5 logs"). `allConsole`
+ * is every console/error event in the window (pre-filter).
+ */
+interface ConsoleEmptyHint {
+    totalInWindow: number;
+    byLevel: ConsoleLevelCounts;
+}
+export declare function consoleEmptyHint(allConsole: ReticleEvent[]): ConsoleEmptyHint;
+export {};
+//# sourceMappingURL=event-filters.d.ts.map

package/dist/events/event-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-filters.d.ts","sourceRoot":"","sources":["../../src/events/event-filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/D,8FAA8F;AAC9F,wBAAgB,QAAQ,CACtB,CAAC,EAAE,YAAY,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAanE;AAED;;4FAE4F;AAC5F,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AACD,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,WAAW,CAU3D;AAED,qFAAqF;AACrF,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AACD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,cAAc,CAGjE;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAOvD;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMhF;AAKD,iEAAiE;AACjE,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,UAAU,YAAY;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAUjE;AAED,sFAAsF;AACtF,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,UAAU,gBAAgB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAU7E"}

package/dist/events/event-filters.js

@@ -0,0 +1,98 @@
+import { EventType } from '@reticlehq/core';
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function asNumber(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+/** Match a net.request event against optional method/url/status filters (reticle_network). */
+export function matchNet(e, method, urlContains, status) {
+    const d = e.data;
+    if (method !== undefined && asString(d['method'])?.toUpperCase() !== method.toUpperCase()) {
+        return false;
+    }
+    if (urlContains !== undefined && !(asString(d['url']) ?? '').includes(urlContains)) {
+        return false;
+    }
+    if (status !== undefined && asNumber(d['status']) !== status)
+        return false;
+    return true;
+}
+/**
+ * Reconcile network events into completed calls + still-in-flight calls. A NET_PENDING whose
+ * `id` never gets a matching NET_REQUEST is an unresolved/hung request — the case
+ * completion-only logging is blind to. Pending events are annotated `{ status: 'pending',
+ * pending: true }` so a numeric `status` filter excludes them but `urlContains`/`method` match.
+ */
+export function reconcileNet(events) {
+    const completed = events.filter((e) => e.type === EventType.NET_REQUEST);
+    const doneIds = new Set(completed.map((e) => asString(e.data['id'])).filter((id) => id !== undefined));
+    const unresolved = events
+        .filter((e) => {
+        if (e.type !== EventType.NET_PENDING)
+            return false;
+        const id = asString(e.data['id']);
+        return id === undefined || !doneIds.has(id);
+    })
+        .map((e) => ({ ...e, data: { ...e.data, status: 'pending', pending: true } }));
+    return [...completed, ...unresolved].sort((a, b) => a.t - b.t);
+}
+export function projectNetCall(e) {
+    const status = e.data['status'];
+    const ms = asNumber(e.data['durationMs']);
+    const view = {
+        method: asString(e.data['method']) ?? '',
+        url: asString(e.data['url']) ?? '',
+    };
+    if (typeof status === 'number' || typeof status === 'string')
+        view.status = status;
+    if (ms !== undefined)
+        view.ms = ms;
+    return view;
+}
+export function projectConsoleLog(e) {
+    const level = e.type === EventType.ERROR_UNCAUGHT ? 'error' : e.type.replace('console.', '');
+    return { level, text: asString(e.data['message']) ?? '' };
+}
+/** True for any console.* / uncaught-error event (the reticle_console universe). */
+export function isConsoleEvent(e) {
+    return (e.type === EventType.CONSOLE_LOG ||
+        e.type === EventType.CONSOLE_WARN ||
+        e.type === EventType.CONSOLE_ERROR ||
+        e.type === EventType.ERROR_UNCAUGHT);
+}
+/** Match a console/error event against an optional level filter (reticle_console). */
+export function matchConsole(e, level) {
+    if (!isConsoleEvent(e))
+        return false;
+    if (level === undefined)
+        return true;
+    return (e.type === `console.${level}` || (level === 'error' && e.type === EventType.ERROR_UNCAUGHT));
+}
+/** How many present calls/levels a zero-match hint samples before truncating. */
+const HINT_SAMPLE_MAX = 5;
+export function netEmptyHint(allNet) {
+    const present = allNet
+        .slice(-HINT_SAMPLE_MAX)
+        .reverse()
+        .map((e) => {
+        const status = asNumber(e.data['status']);
+        const base = { method: asString(e.data['method']) ?? '', url: asString(e.data['url']) ?? '' };
+        return status === undefined ? base : { ...base, status };
+    });
+    return { totalInWindow: allNet.length, present };
+}
+export function consoleEmptyHint(allConsole) {
+    const byLevel = { log: 0, warn: 0, error: 0 };
+    for (const e of allConsole) {
+        if (e.type === EventType.CONSOLE_LOG)
+            byLevel.log += 1;
+        else if (e.type === EventType.CONSOLE_WARN)
+            byLevel.warn += 1;
+        else if (e.type === EventType.CONSOLE_ERROR || e.type === EventType.ERROR_UNCAUGHT) {
+            byLevel.error += 1;
+        }
+    }
+    return { totalInWindow: allConsole.length, byLevel };
+}
+//# sourceMappingURL=event-filters.js.map

package/dist/events/event-filters.js.map

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

package/dist/events/predicate-eval.d.ts

@@ -0,0 +1,91 @@
+import { ElementState, type ElementQuery, type ReticleEvent } from '@reticlehq/core';
+import { z } from 'zod';
+export type Predicate = {
+    kind: 'element';
+    query: ElementQuery;
+    state?: ElementState;
+    absent?: boolean;
+} | {
+    kind: 'text';
+    contains: string;
+    visible?: boolean;
+    absent?: boolean;
+} | {
+    kind: 'net';
+    method?: string;
+    urlContains?: string;
+    status?: number;
+    since?: number;
+    count?: number;
+} | {
+    kind: 'route';
+    pathname?: string;
+    contains?: string;
+} | {
+    kind: 'console';
+    level?: string;
+    absent?: boolean;
+    since?: number;
+} | {
+    kind: 'animation';
+    name?: string;
+    target?: string;
+    completed?: boolean;
+} | {
+    kind: 'signal';
+    name?: string;
+    dataMatches?: Record<string, unknown>;
+} | {
+    kind: 'state';
+    store?: string;
+    path: string;
+    equals?: unknown;
+} | {
+    kind: 'settled';
+    quietMs?: number;
+} | {
+    kind: 'allOf';
+    predicates: Predicate[];
+} | {
+    kind: 'anyOf';
+    predicates: Predicate[];
+} | {
+    kind: 'not';
+    predicate: Predicate;
+};
+export declare const PredicateSchema: z.ZodType<Predicate>;
+export interface EvalResult {
+    pass: boolean;
+    evidence?: unknown;
+    failureReason?: string;
+}
+/**
+ * Match one value against a pattern. Supports `*` (present), strict equality, and operators:
+ * `{$gte,$lte,$gt,$lt}` (numbers), `{$contains}` (array membership or substring), `{$length}`.
+ */
+export declare function matchValue(got: unknown, want: unknown): boolean;
+export declare function evalNet(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'net';
+}>): EvalResult;
+export declare function evalRoute(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'route';
+}>): EvalResult;
+export declare function evalConsole(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'console';
+}>): EvalResult;
+export declare function evalAnimation(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'animation';
+}>): EvalResult;
+export declare function evalSignal(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'signal';
+}>): EvalResult;
+/**
+ * "The page has gone quiet": no network/DOM/animation activity for at least `quietMs`. Needs the
+ * wall-clock `now` (in the buffer's time base) because "no activity in the last N ms" is relative to
+ * now, not to any buffered event — so `now` is injected (CLAUDE.md rule 7), and the wait loop's
+ * poll interval is what eventually flips this to pass once activity stops.
+ */
+export declare function evalSettled(events: ReticleEvent[], p: Extract<Predicate, {
+    kind: 'settled';
+}>, now: number): EvalResult;
+//# sourceMappingURL=predicate-eval.d.ts.map

package/dist/events/predicate-eval.d.ts.map

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