execbro 1.11.1 → 2.1.0

package/build/__tests__/unit/verifyFlow.test.js

@@ -1,45 +0,0 @@
-import { describe, expect, it } from "@jest/globals";
-import { verifyFlow } from "../../pro/flowpoints.js";
-function e(seq, step, overrides = {}) {
-    return { seq, t: 1000 + seq * 10, name: "add-to-cart", step, run: "r1", level: "info", ...overrides };
-}
-const happy = [e(1, "start"), e(2, "cleared"), e(3, "item-added"), e(4, "done")];
-describe("verifyFlow", () => {
-    it("passes when expected steps appear in order (subsequence: extras allowed)", () => {
-        const result = verifyFlow("add-to-cart", "r1", happy, ["start", "item-added", "done"], false);
-        expect(result.pass).toBe(true);
-        expect(result.text).toContain('PASS — flow "add-to-cart" run r1:');
-        expect(result.text).toContain("✓ start (+0ms)");
-        expect(result.text).toContain("✓ done (+30ms)");
-    });
-    it("fails and diffs a missing step", () => {
-        const result = verifyFlow("add-to-cart", "r1", [e(1, "start"), e(2, "cleared")], ["start", "item-added"], false);
-        expect(result.pass).toBe(false);
-        expect(result.text).toContain("✗ item-added — not seen");
-    });
-    it("fails on out-of-order steps", () => {
-        const result = verifyFlow("add-to-cart", "r1", happy, ["done", "start"], false);
-        expect(result.pass).toBe(false);
-    });
-    it("fails on an unexpected error point, with a ! line", () => {
-        const entries = [e(1, "start"), e(2, "failed", { level: "error", meta: { reason: "timeout" } })];
-        const result = verifyFlow("add-to-cart", "r1", entries, ["start"], false);
-        expect(result.pass).toBe(false);
-        expect(result.text).toContain('! failed [error] (+10ms) {"reason":"timeout"} — unexpected error point');
-    });
-    it("allowErrors tolerates unexpected error points", () => {
-        const entries = [e(1, "start"), e(2, "failed", { level: "error" })];
-        expect(verifyFlow("add-to-cart", "r1", entries, ["start"], true).pass).toBe(true);
-    });
-    it("an explicitly expected error step passes", () => {
-        const entries = [e(1, "start"), e(2, "failed", { level: "error" })];
-        const result = verifyFlow("add-to-cart", "r1", entries, ["start", { step: "failed", level: "error" }], false);
-        expect(result.pass).toBe(true);
-    });
-    it("object matchers can constrain meta", () => {
-        const entries = [e(1, "done", { meta: { count: 5 } })];
-        expect(verifyFlow("f", "r1", entries, [{ step: "done", metaIncludes: '"count":5' }], false).pass).toBe(true);
-        expect(verifyFlow("f", "r1", entries, [{ step: "done", metaIncludes: 'count":9' }], false).pass).toBe(false);
-    });
-});
-//# sourceMappingURL=verifyFlow.test.js.map

package/build/__tests__/unit/verifyFlow.test.js.map

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

package/build/core/selectionPoller.d.ts

@@ -1,13 +0,0 @@
-export declare const IDLE_INTERVAL_MS = 2000;
-export declare const ACTIVE_INTERVAL_MS = 500;
-/**
- * One poll cycle. The probe is cheap and runs every tick; the harvest measures
- * host fibers and runs only when the probe reports a change - once per tap.
- * Returns whether an entry was buffered.
- */
-export declare function pollOnce(device: string): Promise<boolean>;
-export declare function isSelectionPollerRunning(device: string): boolean;
-export declare function startSelectionPoller(device: string): void;
-export declare function stopSelectionPoller(device: string): void;
-export declare function stopAllSelectionPollers(): void;
-//# sourceMappingURL=selectionPoller.d.ts.map

package/build/core/selectionPoller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectionPoller.d.ts","sourceRoot":"","sources":["../../src/core/selectionPoller.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAStC;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2D/D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAoBzD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C"}

package/build/core/selectionPoller.js

@@ -1,102 +0,0 @@
-import { executeInApp } from "./jsExecute.js";
-import { buildSelectionProbeExpression, buildDebugStackHarvestExpression, } from "./componentSource.js";
-import { selectionBuffer } from "./selectionBuffer.js";
-export const IDLE_INTERVAL_MS = 2000;
-export const ACTIVE_INTERVAL_MS = 500;
-const timers = new Map();
-let entryCounter = 0;
-function pollingDisabled() {
-    return process.env.EXECBRO_DISABLE_SELECTION_POLL === "1";
-}
-/**
- * One poll cycle. The probe is cheap and runs every tick; the harvest measures
- * host fibers and runs only when the probe reports a change - once per tap.
- * Returns whether an entry was buffered.
- */
-export async function pollOnce(device) {
-    let probe;
-    try {
-        const raw = await executeInApp(buildSelectionProbeExpression(), false, {
-            maxRetries: 0,
-            autoReconnect: false,
-            timeoutMs: 3000,
-            originatingToolName: "selection_poll",
-        }, device);
-        if (!raw.success || !raw.result)
-            return false;
-        probe = JSON.parse(raw.result);
-    }
-    catch {
-        return false;
-    }
-    if (!probe.changed || !probe.selected)
-        return false;
-    let stacks = [];
-    if (probe.frame) {
-        const centreX = probe.frame.left + probe.frame.width / 2;
-        const centreY = probe.frame.top + probe.frame.height / 2;
-        try {
-            const harvest = await executeInApp(buildDebugStackHarvestExpression(centreX, centreY), true, {
-                maxRetries: 0,
-                autoReconnect: false,
-                timeoutMs: 3000,
-                originatingToolName: "selection_poll",
-            }, device);
-            if (harvest.success && harvest.result) {
-                const parsed = JSON.parse(harvest.result);
-                stacks = parsed.stacks ?? [];
-            }
-        }
-        catch {
-            stacks = [];
-        }
-    }
-    entryCounter += 1;
-    return selectionBuffer.add({
-        id: `sel-${Date.now()}-${entryCounter}`,
-        device,
-        timestamp: Date.now(),
-        element: probe.element ?? "Unknown",
-        path: probe.path ?? "",
-        hierarchy: probe.hierarchy ?? [],
-        frame: probe.frame ?? null,
-        style: probe.style ?? null,
-        stacks,
-    });
-}
-export function isSelectionPollerRunning(device) {
-    return timers.has(device);
-}
-export function startSelectionPoller(device) {
-    if (pollingDisabled() || timers.has(device))
-        return;
-    const schedule = (delay) => {
-        const timer = setTimeout(async () => {
-            let active = false;
-            try {
-                active = await pollOnce(device);
-            }
-            catch {
-                active = false;
-            }
-            if (timers.has(device)) {
-                schedule(active ? ACTIVE_INTERVAL_MS : IDLE_INTERVAL_MS);
-            }
-        }, delay);
-        timer.unref?.();
-        timers.set(device, timer);
-    };
-    schedule(IDLE_INTERVAL_MS);
-}
-export function stopSelectionPoller(device) {
-    const timer = timers.get(device);
-    if (timer)
-        clearTimeout(timer);
-    timers.delete(device);
-}
-export function stopAllSelectionPollers() {
-    for (const device of [...timers.keys()]) {
-        stopSelectionPoller(device);
-    }
-}
-//# sourceMappingURL=selectionPoller.js.map

package/build/core/selectionPoller.js.map

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

package/build/pro/flowpointTools.d.ts

@@ -1,4 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function resolveTargetDeviceName(device?: string): string;
-export declare function registerFlowpointTools(server: McpServer): void;
-//# sourceMappingURL=flowpointTools.d.ts.map

package/build/pro/flowpointTools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flowpointTools.d.ts","sourceRoot":"","sources":["../../src/pro/flowpointTools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BzE,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAS/D;AAOD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkR9D"}

package/build/pro/flowpointTools.js

@@ -1,266 +0,0 @@
-import { z } from "zod";
-import { registerToolWithTelemetry } from "../core/register.js";
-import { getConnectedAppByDevice, getFirstConnectedApp, executeInApp } from "../core/index.js";
-import { UserInputError } from "../core/errors.js";
-import { allStoredFlowpoints, clearFlowpointStores, drainFlowpoints, filterFlowpoints, formatFlowpoints, formatMeta, getFlowpointStore, matchesPoint, buildClearExpression, verifyFlow, resolveLastRuns, } from "./flowpoints.js";
-const NO_FLOWPOINTS_HINT = "No flowpoints captured. Instrument the flow under test (execbro-sdk required):\n\n" +
-    "  import { flowpoint } from 'execbro-sdk'\n" +
-    "  flowpoint({ name: 'my-flow', step: 'start', begin: true })\n" +
-    "  flowpoint({ name: 'my-flow', step: 'done', meta: { anything: true } })\n\n" +
-    "Then reload the app, drive the flow, and query again. " +
-    'See get_usage_guide(topic="flowpoints").';
-export function resolveTargetDeviceName(device) {
-    if (device) {
-        const app = getConnectedAppByDevice(device);
-        if (!app)
-            throw new UserInputError(`No connected device matches "${device}"`);
-        return app.deviceInfo.deviceName || app.deviceInfo.title || "unknown";
-    }
-    const first = getFirstConnectedApp();
-    if (!first)
-        throw new UserInputError("No connected app. Run scan_metro first.");
-    return first.deviceInfo.deviceName || first.deviceInfo.title || "unknown";
-}
-const deviceParam = z
-    .string()
-    .optional()
-    .describe("Target device name (substring match). Omit for all devices. Run get_apps to see connected devices.");
-export function registerFlowpointTools(server) {
-    registerToolWithTelemetry(server, "get_flowpoints", {
-        description: "Read flowpoint breadcrumbs — structured, timestamped points emitted by flowpoint() calls " +
-            "(execbro-sdk) — grouped by flow and run, with inter-point timing deltas.\n" +
-            "PURPOSE: verify what actually happened inside a flow (steps, order, timing, failures) " +
-            "instead of inferring it from console logs.\n" +
-            "WHEN TO USE: after driving an instrumented flow; or with level: 'error' to ask " +
-            '"did any flow fail?" across all flows at once.\n' +
-            "WORKFLOW: instrument with flowpoint() -> reload -> drive the flow -> " +
-            "wait_for_flowpoint (sync) -> verify_flow (assert) -> get_flowpoints (inspect details).\n" +
-            "LIMITATIONS: requires execbro-sdk init() and flowpoint() instrumentation in app code.\n" +
-            "GOOD: get_flowpoints({ name: 'add-to-cart', run: 'last' }) after a retry.\n" +
-            "BAD: polling get_flowpoints in a loop — use wait_for_flowpoint instead.\n" +
-            'SEE ALSO: call get_usage_guide(topic="flowpoints") for the full playbook.',
-        inputSchema: {
-            name: z.string().optional().describe("Filter to one flow name. Omit for all flows."),
-            step: z.string().optional().describe("Filter to one step label (exact match)."),
-            run: z
-                .string()
-                .optional()
-                .describe("Filter to one run id, or 'last' for the most recent run per flow."),
-            level: z.enum(["info", "warn", "error"]).optional().describe("Filter by severity."),
-            metaIncludes: z
-                .string()
-                .optional()
-                .describe("Case-insensitive substring match against the stringified meta payload."),
-            since: z.number().optional().describe("Epoch-ms lower bound on the point timestamp (exclusive)."),
-            limit: z.number().optional().default(200).describe("Max points returned, newest kept (default 200)."),
-            device: deviceParam,
-        },
-    }, async ({ name, step, run, level, metaIncludes, since, limit, device }) => {
-        const deviceName = resolveTargetDeviceName(device);
-        const drained = await drainFlowpoints(deviceName, device);
-        if (!drained.ok) {
-            return { isError: true, content: [{ type: "text", text: drained.error }] };
-        }
-        const sourceEntries = device ? getFlowpointStore(deviceName).entries : allStoredFlowpoints();
-        const entries = filterFlowpoints(sourceEntries, {
-            name,
-            step,
-            run,
-            level,
-            metaIncludes,
-            since,
-            limit,
-        });
-        if (entries.length === 0) {
-            if (sourceEntries.length === 0) {
-                return { content: [{ type: "text", text: NO_FLOWPOINTS_HINT }] };
-            }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `${sourceEntries.length} flowpoints stored, but 0 matched your filters. ` +
-                            "Loosen or drop filters (name/step/run/level/metaIncludes/since) to see them.",
-                    },
-                ],
-            };
-        }
-        const flows = new Set(entries.map((e) => e.name)).size;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Flowpoints (${entries.length} points, ${flows} flow${flows === 1 ? "" : "s"}):\n\n${formatFlowpoints(entries)}`,
-                },
-            ],
-        };
-    }, (result) => !!result?.content?.[0]?.text?.startsWith("No flowpoints captured"));
-    registerToolWithTelemetry(server, "clear_flowpoints", {
-        description: "Clear stored flowpoints.\n" +
-            "PURPOSE: reset flowpoint history between test sessions.\n" +
-            "WHEN TO USE: rarely — prefer begin: true + run: 'last' filtering between attempts. " +
-            "With name: clears one flow from the server store only (cleared entries never re-drain). " +
-            "Without name: clears everything server-side AND the in-app buffer.",
-        inputSchema: {
-            name: z.string().optional().describe("Clear only this flow (server-side). Omit to clear all."),
-            device: z
-                .string()
-                .optional()
-                .describe("Target device (substring match). Scopes both the server-store clear and the in-app " +
-                "buffer clear. Omit for all devices."),
-        },
-    }, async ({ name, device }) => {
-        const deviceName = device ? resolveTargetDeviceName(device) : undefined;
-        let cleared = clearFlowpointStores(name, deviceName);
-        let caveat = "";
-        if (!name) {
-            const result = await executeInApp(buildClearExpression(), false, { timeoutMs: 3000, originatingToolName: "clear_flowpoints" }, device);
-            if (result.success) {
-                const inApp = parseInt(result.result || "0", 10);
-                if (!isNaN(inApp))
-                    cleared = Math.max(cleared, inApp);
-            }
-            else {
-                caveat = " (in-app buffer clear failed — still-buffered points may re-drain after the next app event)";
-            }
-        }
-        const scope = name ? ` for flow "${name}"` : "";
-        return { content: [{ type: "text", text: `Cleared ${cleared} flowpoints${scope}.${caveat}` }] };
-    });
-    registerToolWithTelemetry(server, "wait_for_flowpoint", {
-        description: "Block until a flowpoint matching the criteria arrives, or timeout.\n" +
-            "PURPOSE: deterministic synchronization for drive-then-verify — act first, then block on the flow's " +
-            "terminal step instead of sleeping and re-polling.\n" +
-            "WHEN TO USE: after tapping/driving an instrumented flow, with the flow's terminal step.\n" +
-            "Points emitted after your action but before this call still match (only points already " +
-            "seen by a previous flowpoint tool call are excluded).\n" +
-            "On timeout, returns whatever points DID arrive for the flow — that partial trail is the " +
-            "diagnostic for what stalled.\n" +
-            'SEE ALSO: get_usage_guide(topic="flowpoints").',
-        inputSchema: {
-            name: z.string().describe("Flow name to watch."),
-            step: z.string().optional().describe("Step label to wait for (exact match). Omit to match any step."),
-            level: z.enum(["info", "warn", "error"]).optional().describe("Only match this severity."),
-            metaIncludes: z
-                .string()
-                .optional()
-                .describe("Case-insensitive substring the stringified meta must contain."),
-            timeoutMs: z.number().optional().default(5000).describe("Max wait in ms (default 5000, cap 30000)."),
-            device: deviceParam,
-        },
-    }, async ({ name, step, level, metaIncludes, timeoutMs, device }) => {
-        const effectiveTimeout = Math.min(timeoutMs, 30000);
-        const deviceName = resolveTargetDeviceName(device);
-        const store = getFlowpointStore(deviceName);
-        const baselineEntry = store.entries.length > 0 ? store.entries[store.entries.length - 1] : null;
-        const start = Date.now();
-        const deadline = start + effectiveTimeout;
-        const freshEntries = () => {
-            const startIdx = baselineEntry ? store.entries.indexOf(baselineEntry) + 1 : 0;
-            return store.entries.slice(startIdx).filter((e) => e.name === name);
-        };
-        for (;;) {
-            const remaining = deadline - Date.now();
-            if (remaining > 0) {
-                const drained = await Promise.race([
-                    drainFlowpoints(deviceName, device),
-                    new Promise((resolve) => setTimeout(() => resolve(null), remaining)),
-                ]);
-                if (drained && !drained.ok) {
-                    return { isError: true, content: [{ type: "text", text: drained.error }] };
-                }
-            }
-            const fresh = freshEntries();
-            const match = fresh.find((e) => matchesPoint(e, { step, level, metaIncludes }));
-            if (match) {
-                const meta = match.meta !== undefined ? `\nmeta: ${formatMeta(match.meta)}` : "";
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Matched after ${Date.now() - start}ms: flow "${match.name}" ` +
-                                `run ${match.run} step "${match.step}" [${match.level}]${meta}`,
-                        },
-                    ],
-                };
-            }
-            if (Date.now() >= deadline) {
-                const trail = fresh.length
-                    ? `Points that DID arrive for "${name}" during the wait:\n\n${formatFlowpoints(fresh)}`
-                    : `No new points arrived for flow "${name}" during the wait.`;
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Timeout after ${effectiveTimeout}ms waiting for flow "${name}"${step ? ` step "${step}"` : ""}.\n${trail}`,
-                        },
-                    ],
-                };
-            }
-            await new Promise((resolve) => setTimeout(resolve, Math.min(250, Math.max(1, deadline - Date.now()))));
-        }
-    });
-    registerToolWithTelemetry(server, "verify_flow", {
-        description: "Assert a flow behaved as expected: compare the actual flowpoint trail of one run " +
-            "against an expected step sequence and get a factual PASS/FAIL diff.\n" +
-            "PURPOSE: factual PASS/FAIL assertion of a flow run against an expected step sequence.\n" +
-            "WHEN TO USE: after wait_for_flowpoint confirms the flow finished; or write the expectation first " +
-            "(runtime TDD) and iterate until PASS.\n" +
-            "Matching is subsequence: expected steps must appear in order; extra points in between " +
-            "are fine. Any unexpected error-level point fails the run unless allowErrors is true or " +
-            "that step is explicitly expected.\n" +
-            "WORKFLOW: write the expected sequence (even before implementing — runtime TDD), drive " +
-            "the flow, wait_for_flowpoint on the terminal step, then verify_flow.\n" +
-            'SEE ALSO: get_usage_guide(topic="flowpoints").',
-        inputSchema: {
-            name: z.string().describe("Flow name to verify."),
-            expect: z
-                .array(z.union([
-                z.string(),
-                z.object({
-                    step: z.string(),
-                    level: z.enum(["info", "warn", "error"]).optional(),
-                    metaIncludes: z.string().optional(),
-                }),
-            ]))
-                .describe("Expected step sequence, in order. Strings are shorthand for { step }."),
-            run: z.string().optional().default("last").describe("Run id to check, or 'last' (default)."),
-            allowErrors: z
-                .boolean()
-                .optional()
-                .default(false)
-                .describe("Tolerate unexpected error-level points (default false)."),
-            device: deviceParam,
-        },
-    }, async ({ name, expect: expected, run, allowErrors, device }) => {
-        const deviceName = resolveTargetDeviceName(device);
-        const drained = await drainFlowpoints(deviceName, device);
-        if (!drained.ok) {
-            return { isError: true, content: [{ type: "text", text: drained.error }] };
-        }
-        const sourceEntries = device ? getFlowpointStore(deviceName).entries : allStoredFlowpoints();
-        const flowEntries = sourceEntries.filter((e) => e.name === name);
-        if (flowEntries.length === 0) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `No flowpoints recorded for flow "${name}".\n\n${NO_FLOWPOINTS_HINT}`,
-                    },
-                ],
-            };
-        }
-        const runId = run === "last" || run === undefined ? resolveLastRuns(flowEntries).get(name) : run;
-        const runEntries = flowEntries.filter((e) => e.run === runId);
-        if (runEntries.length === 0) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `No entries for flow "${name}" run "${runId}".` }],
-            };
-        }
-        const result = verifyFlow(name, runId, runEntries, expected, allowErrors ?? false);
-        // A FAIL verdict is a successful verification, not a tool error — never set isError for it.
-        return { content: [{ type: "text", text: result.text }] };
-    });
-}
-//# sourceMappingURL=flowpointTools.js.map

package/build/pro/flowpointTools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flowpointTools.js","sourceRoot":"","sources":["../../src/pro/flowpointTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACH,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,eAAe,GAClB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,kBAAkB,GACpB,oFAAoF;IACpF,6CAA6C;IAC7C,gEAAgE;IAChE,8EAA8E;IAC9E,wDAAwD;IACxD,0CAA0C,CAAC;AAE/C,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACnD,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,cAAc,CAAC,gCAAgC,MAAM,GAAG,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,SAAS,CAAC;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,cAAc,CAAC,yCAAyC,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,SAAS,CAAC;AAC9E,CAAC;AAED,MAAM,WAAW,GAAG,CAAC;KAChB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,oGAAoG,CAAC,CAAC;AAEpH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACpD,yBAAyB,CACrB,MAAM,EACN,gBAAgB,EAChB;QACI,WAAW,EACP,2FAA2F;YAC3F,4EAA4E;YAC5E,wFAAwF;YACxF,8CAA8C;YAC9C,iFAAiF;YACjF,kDAAkD;YAClD,uEAAuE;YACvE,0FAA0F;YAC1F,yFAAyF;YACzF,6EAA6E;YAC7E,2EAA2E;YAC3E,2EAA2E;QAC/E,WAAW,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACpF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YAC/E,GAAG,EAAE,CAAC;iBACD,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;YAClF,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACnF,YAAY,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wEAAwE,CAAC;YACvF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;YACjG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACrG,MAAM,EAAE,WAAW;SACtB;KACJ,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACrE,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAC7F,MAAM,OAAO,GAAG,gBAAgB,CAAC,aAAa,EAAE;YAC5C,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,KAAK;YACL,YAAY;YACZ,KAAK;YACL,KAAK;SACR,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;YACD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EACA,GAAG,aAAa,CAAC,MAAM,kDAAkD;4BACzE,8EAA8E;qBACrF;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,eAAe,OAAO,CAAC,MAAM,YAAY,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,gBAAgB,CAAC,OAAO,CAAC,EAAE;iBACzH;aACJ;SACJ,CAAC;IACN,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,wBAAwB,CAAC,CACjF,CAAC;IAEF,yBAAyB,CACrB,MAAM,EACN,kBAAkB,EAClB;QACI,WAAW,EACP,4BAA4B;YAC5B,2DAA2D;YAC3D,qFAAqF;YACrF,0FAA0F;YAC1F,oEAAoE;QACxE,WAAW,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YAC9F,MAAM,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACL,qFAAqF;gBACjF,qCAAqC,CAC5C;SACR;KACJ,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,IAAI,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,YAAY,CAC7B,oBAAoB,EAAE,EACtB,KAAK,EACL,EAAE,SAAS,EAAE,IAAI,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,EAC5D,MAAM,CACT,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;oBAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,6FAA6F,CAAC;YAC3G,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,OAAO,cAAc,KAAK,IAAI,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7G,CAAC,CACJ,CAAC;IAEF,yBAAyB,CACrB,MAAM,EACN,oBAAoB,EACpB;QACI,WAAW,EACP,sEAAsE;YACtE,qGAAqG;YACrG,qDAAqD;YACrD,2FAA2F;YAC3F,yFAAyF;YACzF,yDAAyD;YACzD,0FAA0F;YAC1F,gCAAgC;YAChC,gDAAgD;QACpD,WAAW,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;YACrG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACzF,YAAY,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;YAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACpG,MAAM,EAAE,WAAW;SACtB;KACJ,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7D,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,GAAG,gBAAgB,CAAC;QAC1C,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxE,CAAC,CAAC;QACF,SAAS,CAAC;YACN,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAC/B,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC;oBACnC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;iBAC7E,CAAC,CAAC;gBACH,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;oBACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBACxF,CAAC;YACL,CAAC;YACD,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAChF,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAe;4BACrB,IAAI,EACA,iBAAiB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,aAAa,KAAK,CAAC,IAAI,IAAI;gCAC9D,OAAO,KAAK,CAAC,GAAG,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE;yBACtE;qBACJ;iBACJ,CAAC;YACN,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM;oBACtB,CAAC,CAAC,+BAA+B,IAAI,yBAAyB,gBAAgB,CAAC,KAAK,CAAC,EAAE;oBACvF,CAAC,CAAC,mCAAmC,IAAI,oBAAoB,CAAC;gBAClE,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB,gBAAgB,wBAAwB,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,EAAE;yBACpH;qBACJ;iBACJ,CAAC;YACN,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3G,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,yBAAyB,CACrB,MAAM,EACN,aAAa,EACb;QACI,WAAW,EACP,mFAAmF;YACnF,uEAAuE;YACvE,yFAAyF;YACzF,mGAAmG;YACnG,yCAAyC;YACzC,wFAAwF;YACxF,yFAAyF;YACzF,qCAAqC;YACrC,wFAAwF;YACxF,wEAAwE;YACxE,gDAAgD;QACpD,WAAW,EAAE;YACT,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjD,MAAM,EAAE,CAAC;iBACJ,KAAK,CACF,CAAC,CAAC,KAAK,CAAC;gBACJ,CAAC,CAAC,MAAM,EAAE;gBACV,CAAC,CAAC,MAAM,CAAC;oBACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;oBAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;oBACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBACtC,CAAC;aACL,CAAC,CACL;iBACA,QAAQ,CAAC,uEAAuE,CAAC;YACtF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC5F,WAAW,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,yDAAyD,CAAC;YACxE,MAAM,EAAE,WAAW;SACtB;KACJ,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;QAC3D,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAC7F,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,oCAAoC,IAAI,SAAS,kBAAkB,EAAE;qBAC9E;iBACJ;aACJ,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAClG,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;aAC9F,CAAC;QACN,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,IAAI,KAAK,CAAC,CAAC;QACnF,4FAA4F;QAC5F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC,CACJ,CAAC;AACN,CAAC"}

package/build/pro/flowpoints.d.ts

@@ -1,86 +0,0 @@
-export type FlowpointLevel = "info" | "warn" | "error";
-export interface FlowpointEntry {
-    seq: number;
-    t: number;
-    name: string;
-    step: string;
-    run: string;
-    level: FlowpointLevel;
-    meta?: unknown;
-}
-export interface FlowpointSnapshot {
-    contextId: string;
-    entries: FlowpointEntry[];
-}
-export declare const FLOWPOINT_STORE_CAP = 2000;
-export interface FlowpointStoreState {
-    entries: FlowpointEntry[];
-    cursor: number;
-    contextId: string | null;
-}
-export declare function createFlowpointStore(): FlowpointStoreState;
-/** Pure drain reducer: diff a full in-app snapshot against the store. Returns entries appended. */
-export declare function applyDrain(store: FlowpointStoreState, snapshot: FlowpointSnapshot): number;
-export declare function buildDrainExpression(): string;
-export declare function buildClearExpression(): string;
-export type FlowpointMissingReason = "uninitialized" | "outdated";
-export declare function parseDrainResult(raw: string): FlowpointSnapshot | {
-    missing: true;
-    reason: FlowpointMissingReason;
-} | null;
-export interface FlowpointFilters {
-    name?: string;
-    step?: string;
-    run?: string;
-    level?: FlowpointLevel;
-    metaIncludes?: string;
-    since?: number;
-    limit?: number;
-}
-export declare function formatMeta(meta: unknown): string;
-export interface PointMatch {
-    step?: string;
-    level?: FlowpointLevel;
-    metaIncludes?: string;
-}
-export declare function matchesPoint(entry: FlowpointEntry, match: PointMatch): boolean;
-/** Per flow name, the run id of the chronologically last entry. Assumes entries sorted by t. */
-export declare function resolveLastRuns(entries: FlowpointEntry[]): Map<string, string>;
-export declare function filterFlowpoints(entries: FlowpointEntry[], filters: FlowpointFilters): FlowpointEntry[];
-/** Compact grouped text: flow → run → points with inter-point deltas. Assumes entries sorted by t. */
-export declare function formatFlowpoints(entries: FlowpointEntry[]): string;
-export declare function getFlowpointStore(deviceName: string): FlowpointStoreState;
-/** All stored entries across devices, sorted chronologically. */
-export declare function allStoredFlowpoints(): FlowpointEntry[];
-/**
- * Remove entries from the server stores. Cursors/contextIds are kept so cleared
- * entries never re-drain. When deviceName is given, only that device's store is
- * touched; otherwise all stores are.
- */
-export declare function clearFlowpointStores(name?: string, deviceName?: string): number;
-export declare const SDK_FLOWPOINTS_MISSING: string;
-export declare const SDK_FLOWPOINTS_OUTDATED: string;
-export type DrainOutcome = {
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-    sdkMissing?: boolean;
-};
-export declare function drainFlowpoints(deviceName: string, device?: string): Promise<DrainOutcome>;
-export type ExpectStep = string | {
-    step: string;
-    level?: FlowpointLevel;
-    metaIncludes?: string;
-};
-export interface VerifyOutcome {
-    pass: boolean;
-    text: string;
-}
-/**
- * Subsequence assertion: expected steps must appear in order within the run; extra
- * points in between are allowed. Unexpected error-level points fail the verification
- * unless allowErrors is true or the error point matched an expected step.
- */
-export declare function verifyFlow(name: string, runId: string, runEntries: FlowpointEntry[], expect: ExpectStep[], allowErrors: boolean): VerifyOutcome;
-//# sourceMappingURL=flowpoints.d.ts.map

package/build/pro/flowpoints.d.ts.map

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