@vforsh/argus-core 0.2.0 → 0.4.0

package/dist/protocol/native-messaging.d.ts.map

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

package/dist/protocol/native-messaging.js

@@ -0,0 +1,19 @@
+/**
+ * Native Messaging wire protocol shared by the Chrome extension and argus-watcher.
+ *
+ * This module is the single definition of the extension <-> watcher contract. The two
+ * peers ship as independently versioned npm packages, so a field added on one side and
+ * forgotten on the other would compile cleanly and only fail at runtime in a user's
+ * Chrome — importing both ends from here makes that a compile error instead.
+ *
+ * The extension bundles this with esbuild: keep it types plus erasable constants only,
+ * so the extension's no-runtime-dependencies property survives.
+ */
+/**
+ * Version of the native-messaging wire contract.
+ *
+ * Bump on any breaking change to the message shapes below. Peers exchange it in the
+ * `host_info` handshake and refuse to proceed on a mismatch.
+ */
+export const NATIVE_MESSAGING_PROTOCOL_VERSION = 2;
+//# sourceMappingURL=native-messaging.js.map

package/dist/protocol/native-messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-messaging.js","sourceRoot":"","sources":["../../src/protocol/native-messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAA"}

package/dist/protocol/scenario.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Host-bridge types for bundled eval scenarios.
+ *
+ * These describe the in-page capability object handed to a scenario's `export default`,
+ * not an HTTP payload — the members are functions returning promises and are never
+ * serialized over the wire. They live outside `protocol/http/` for exactly that reason.
+ */
+import type { LogEpoch, LogEvent, LogLevel } from './logs.js';
+import type { ScreenshotClipRegion, ScreenshotResponse } from './http/screenshot.js';
+/** Page-side screenshot options accepted by scenario artifact helpers. */
+export type ArgusScenarioScreenshotOptions = {
+    /** Crop to the first matching element. */
+    selector?: string;
+    /** Crop to a viewport-relative rectangle. Mutually exclusive with `selector`. */
+    clip?: ScreenshotClipRegion;
+};
+/** Filters for reading watcher logs from a scenario cursor. */
+export type ArgusScenarioLogOptions = {
+    /** Only include these severity levels. */
+    levels?: LogLevel[];
+    /** Match event text against any supplied regular expression. */
+    match?: string | string[];
+    /** Regex case handling. Defaults to case-sensitive. */
+    matchCase?: 'sensitive' | 'insensitive';
+    /** Case-insensitive substring filter over the event source. */
+    source?: string;
+    /** Maximum number of matching events. Defaults to 500; maximum 5000. */
+    limit?: number;
+};
+/** Result of reading scenario logs after a cursor. */
+export type ArgusScenarioLogsResult = {
+    events: LogEvent[];
+    /** Cursor to use for the next read. */
+    nextCursor: LogEpoch;
+};
+/** Stateful log window created at a scenario-defined baseline. */
+export type ArgusScenarioLogSession = {
+    /** Current session cursor. It advances after each successful read. */
+    readonly cursor: LogEpoch;
+    /** Read matching logs since the session cursor and advance it. */
+    read: (options?: ArgusScenarioLogOptions) => Promise<ArgusScenarioLogsResult>;
+};
+/** Log cursor helpers available to bundled scenario entrypoints. */
+export type ArgusScenarioLogs = {
+    /** Return the watcher's current log cursor without downloading events. */
+    cursor: () => Promise<LogEpoch>;
+    /** Read matching logs produced strictly after `cursor`. */
+    read: (cursor: LogEpoch, options?: ArgusScenarioLogOptions) => Promise<ArgusScenarioLogsResult>;
+    /** Capture the current cursor and return a stateful log window. */
+    session: () => Promise<ArgusScenarioLogSession>;
+};
+/** Host capabilities passed to `export default` in a bundled eval file. */
+export type ArgusScenarioContext = {
+    /** Frozen string arguments supplied by `--arg` / `--args`. */
+    readonly args: Readonly<Record<string, string>>;
+    /** Capture a screenshot using a watcher-generated safe artifact path. */
+    screenshot: (options?: ArgusScenarioScreenshotOptions) => Promise<ScreenshotResponse>;
+    /** Capture or replace `checkpoints/<name>.png` under the watcher artifact directory. */
+    checkpoint: (name: string, options?: ArgusScenarioScreenshotOptions) => Promise<ScreenshotResponse>;
+    /** Cursor and session helpers for logs produced during the scenario. */
+    readonly logs: ArgusScenarioLogs;
+};
+//# sourceMappingURL=scenario.d.ts.map

package/dist/protocol/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../src/protocol/scenario.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEpF,0EAA0E;AAC1E,MAAM,MAAM,8BAA8B,GAAG;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC3B,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAAG;IACrC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,CAAA;IACvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,uCAAuC;IACvC,UAAU,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG;IACrC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,kEAAkE;IAClE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC7E,CAAA;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/B,2DAA2D;IAC3D,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC/F,mEAAmE;IACnE,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC/C,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,yEAAyE;IACzE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACrF,wFAAwF;IACxF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,8BAA8B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACnG,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAChC,CAAA"}

package/dist/protocol/scenario.js

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

package/dist/protocol/scenario.js.map

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

package/dist/protocol/schemaFields.d.ts

@@ -0,0 +1,76 @@
+import { type ProtocolValidationResult } from './schema.js';
+/**
+ * Field-level readers shared by every protocol schema.
+ *
+ * Route-level validation used to grow one copy of "non-empty string", "non-negative
+ * integer", "boolean or absent" per endpoint, which is where the drift lived. These are
+ * the single copies; schemas compose them instead of re-deriving them.
+ *
+ * Each reader returns either a value or a {@link FieldError}. Compose several with
+ * {@link readFields}, which returns per-field types on success.
+ */
+/** A field that failed validation. Structurally distinct from every legal field value. */
+export type FieldError = {
+    readonly __fieldError: string;
+};
+/** True when a reader returned a failure rather than a value. */
+export declare const isFieldError: (value: unknown) => value is FieldError;
+/** Build a field failure with an explicit message. */
+export declare const fieldError: (message: string) => FieldError;
+/**
+ * A reader that pulls one field out of a payload, or reports why it is invalid.
+ *
+ * Written as an unconstrained return type so any of the readers below — and any inline
+ * arrow that closes over extra bounds — satisfies it; {@link ReadFieldsResult} recovers
+ * the precise per-field type afterwards.
+ */
+export type FieldReader = (source: Record<string, unknown>, key: string) => unknown;
+/** The values produced by a set of readers, with the failure branch stripped. */
+export type ReadFieldsResult<S extends Record<string, FieldReader>> = {
+    [K in keyof S]: Exclude<ReturnType<S[K]>, FieldError>;
+};
+/**
+ * Run a set of field readers, returning either every value or the first failure.
+ *
+ * The success branch is typed per field — `Exclude<..., FieldError>` removes the failure
+ * arm — so a schema gets `string` and `number | undefined` back rather than having to
+ * re-narrow each field after a combined check.
+ */
+export declare const readFields: <S extends Record<string, FieldReader>>(source: Record<string, unknown>, readers: S) => ProtocolValidationResult<ReadFieldsResult<S>>;
+/** Guard the top-level payload shape. Every schema starts here. */
+export declare const requireObject: <T>(value: unknown) => ProtocolValidationResult<T> | null;
+/** Read a required string field. Empty and whitespace-only values are rejected. */
+export declare const requiredString: (source: Record<string, unknown>, key: string) => string | FieldError;
+/** Read an optional string field. Present-but-not-a-string is an error, absent is `undefined`. */
+export declare const optionalString: (source: Record<string, unknown>, key: string) => string | undefined | FieldError;
+/** Read an optional non-empty string field, treating `''` as absent. */
+export declare const optionalNonEmptyString: (source: Record<string, unknown>, key: string) => string | undefined | FieldError;
+/** Read an optional boolean field. */
+export declare const optionalBoolean: (source: Record<string, unknown>, key: string) => boolean | undefined | FieldError;
+/** Read an optional finite number field, optionally bounded. */
+export declare const optionalNumber: (source: Record<string, unknown>, key: string, bounds?: {
+    min?: number;
+    max?: number;
+}) => number | undefined | FieldError;
+/** Read an optional integer field, optionally bounded. */
+export declare const optionalInteger: (source: Record<string, unknown>, key: string, bounds?: {
+    min?: number;
+    max?: number;
+}) => number | undefined | FieldError;
+/** Read an optional field constrained to a fixed set of literals. */
+export declare const optionalEnum: <const T extends readonly string[]>(source: Record<string, unknown>, key: string, allowed: T) => T[number] | undefined | FieldError;
+/** Read an optional array of strings. */
+export declare const optionalStringArray: (source: Record<string, unknown>, key: string) => string[] | undefined | FieldError;
+/** Read an optional nested object, leaving its contents to the caller. */
+export declare const optionalRecord: (source: Record<string, unknown>, key: string) => Record<string, unknown> | undefined | FieldError;
+/** Read an optional array, leaving element validation to the caller. */
+export declare const optionalArray: (source: Record<string, unknown>, key: string) => unknown[] | undefined | FieldError;
+/**
+ * Drop `undefined` entries so an optional field that was absent stays absent.
+ *
+ * Schemas build their result object field by field; without this, `{ selector: undefined }`
+ * would serialize differently from `{}` and defeat `exactOptionalPropertyTypes`-style
+ * reasoning at call sites.
+ */
+export declare const compact: <T extends object>(value: T) => T;
+//# sourceMappingURL=schemaFields.d.ts.map

package/dist/protocol/schemaFields.d.ts.map

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

package/dist/protocol/schemaFields.js

@@ -0,0 +1,152 @@
+import { invalidProtocolPayload, isProtocolObject } from './schema.js';
+/** True when a reader returned a failure rather than a value. */
+export const isFieldError = (value) => typeof value === 'object' && value != null && '__fieldError' in value && typeof value.__fieldError === 'string';
+/** Build a field failure with an explicit message. */
+export const fieldError = (message) => ({ __fieldError: message });
+/**
+ * Run a set of field readers, returning either every value or the first failure.
+ *
+ * The success branch is typed per field — `Exclude<..., FieldError>` removes the failure
+ * arm — so a schema gets `string` and `number | undefined` back rather than having to
+ * re-narrow each field after a combined check.
+ */
+export const readFields = (source, readers) => {
+    const values = {};
+    for (const [key, read] of Object.entries(readers)) {
+        const value = read(source, key);
+        if (isFieldError(value)) {
+            return invalidProtocolPayload(value.__fieldError);
+        }
+        values[key] = value;
+    }
+    return { ok: true, value: values };
+};
+/** Guard the top-level payload shape. Every schema starts here. */
+export const requireObject = (value) => isProtocolObject(value) ? null : invalidProtocolPayload('request body must be an object');
+/** Read a required string field. Empty and whitespace-only values are rejected. */
+export const requiredString = (source, key) => {
+    const field = source[key];
+    if (typeof field !== 'string' || field.trim() === '') {
+        return fieldError(`${key} is required and must be a non-empty string`);
+    }
+    return field;
+};
+/** Read an optional string field. Present-but-not-a-string is an error, absent is `undefined`. */
+export const optionalString = (source, key) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (typeof field !== 'string') {
+        return fieldError(`${key} must be a string`);
+    }
+    return field;
+};
+/** Read an optional non-empty string field, treating `''` as absent. */
+export const optionalNonEmptyString = (source, key) => {
+    const field = optionalString(source, key);
+    if (isFieldError(field) || field == null) {
+        return field;
+    }
+    return field.length > 0 ? field : undefined;
+};
+/** Read an optional boolean field. */
+export const optionalBoolean = (source, key) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (typeof field !== 'boolean') {
+        return fieldError(`${key} must be a boolean`);
+    }
+    return field;
+};
+/** Read an optional finite number field, optionally bounded. */
+export const optionalNumber = (source, key, bounds = {}) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (typeof field !== 'number' || !Number.isFinite(field)) {
+        return fieldError(`${key} must be a finite number`);
+    }
+    if (bounds.min != null && field < bounds.min) {
+        return fieldError(`${key} must be >= ${bounds.min}`);
+    }
+    if (bounds.max != null && field > bounds.max) {
+        return fieldError(`${key} must be <= ${bounds.max}`);
+    }
+    return field;
+};
+/** Read an optional integer field, optionally bounded. */
+export const optionalInteger = (source, key, bounds = {}) => {
+    const field = optionalNumber(source, key, bounds);
+    if (isFieldError(field) || field == null) {
+        return field;
+    }
+    if (!Number.isInteger(field)) {
+        return fieldError(`${key} must be an integer`);
+    }
+    return field;
+};
+/** Read an optional field constrained to a fixed set of literals. */
+export const optionalEnum = (source, key, allowed) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (typeof field !== 'string' || !allowed.includes(field)) {
+        return fieldError(`${key} must be one of: ${allowed.join(', ')}`);
+    }
+    return field;
+};
+/** Read an optional array of strings. */
+export const optionalStringArray = (source, key) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (!Array.isArray(field) || field.some((item) => typeof item !== 'string')) {
+        return fieldError(`${key} must be an array of strings`);
+    }
+    return field;
+};
+/** Read an optional nested object, leaving its contents to the caller. */
+export const optionalRecord = (source, key) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (!isProtocolObject(field)) {
+        return fieldError(`${key} must be an object`);
+    }
+    return field;
+};
+/** Read an optional array, leaving element validation to the caller. */
+export const optionalArray = (source, key) => {
+    const field = source[key];
+    if (field == null) {
+        return undefined;
+    }
+    if (!Array.isArray(field)) {
+        return fieldError(`${key} must be an array`);
+    }
+    return field;
+};
+/**
+ * Drop `undefined` entries so an optional field that was absent stays absent.
+ *
+ * Schemas build their result object field by field; without this, `{ selector: undefined }`
+ * would serialize differently from `{}` and defeat `exactOptionalPropertyTypes`-style
+ * reasoning at call sites.
+ */
+export const compact = (value) => {
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (entry !== undefined) {
+            result[key] = entry;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=schemaFields.js.map

package/dist/protocol/schemaFields.js.map

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

package/dist/protocol/version.d.ts

@@ -2,4 +2,18 @@
 export declare const ARGUS_PROTOCOL_VERSION: 2;
 /** Type-level alias for the current protocol version. */
 export type ArgusProtocolVersion = typeof ARGUS_PROTOCOL_VERSION;
+/**
+ * Describe a watcher's protocol compatibility with this build.
+ *
+ * The CLI, the SDK, and the watcher ship as separate npm packages, so a 0.3.x CLI can
+ * drive a long-running watcher started by an older install. Without this check a version
+ * bump changes nothing observable: mismatched peers keep talking and fail later with
+ * confusing per-command errors instead of one clear message.
+ *
+ * @param protocolVersion The `protocolVersion` reported by `GET /status`. A watcher too
+ *   old to report one is treated as incompatible rather than assumed to match.
+ * @returns `null` when the peer is compatible, or an actionable message naming both
+ *   versions and what to do about it.
+ */
+export declare const describeProtocolMismatch: (protocolVersion: number | undefined, watcherVersion?: string) => string | null;
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAA;AAEhD,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,OAAO,sBAAsB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAA;AAEhD,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,OAAO,sBAAsB,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GAAI,iBAAiB,MAAM,GAAG,SAAS,EAAE,iBAAiB,MAAM,KAAG,MAAM,GAAG,IAQhH,CAAA"}

package/dist/protocol/version.js

@@ -1,3 +1,24 @@
 /** Current protocol version exchanged between CLI and watcher. */
 export const ARGUS_PROTOCOL_VERSION = 2;
+/**
+ * Describe a watcher's protocol compatibility with this build.
+ *
+ * The CLI, the SDK, and the watcher ship as separate npm packages, so a 0.3.x CLI can
+ * drive a long-running watcher started by an older install. Without this check a version
+ * bump changes nothing observable: mismatched peers keep talking and fail later with
+ * confusing per-command errors instead of one clear message.
+ *
+ * @param protocolVersion The `protocolVersion` reported by `GET /status`. A watcher too
+ *   old to report one is treated as incompatible rather than assumed to match.
+ * @returns `null` when the peer is compatible, or an actionable message naming both
+ *   versions and what to do about it.
+ */
+export const describeProtocolMismatch = (protocolVersion, watcherVersion) => {
+    if (protocolVersion === ARGUS_PROTOCOL_VERSION) {
+        return null;
+    }
+    const reported = protocolVersion == null ? 'an unknown version' : `version ${protocolVersion}`;
+    const which = watcherVersion ? `Watcher ${watcherVersion}` : 'This watcher';
+    return `${which} speaks protocol ${reported}, but this argus build expects version ${ARGUS_PROTOCOL_VERSION}. Restart the watcher with the current argus, or update argus (npm i -g @vforsh/argus).`;
+};
 //# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAU,CAAA"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/protocol/version.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAU,CAAA;AAKhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,eAAmC,EAAE,cAAuB,EAAiB,EAAE;IACvH,IAAI,eAAe,KAAK,sBAAsB,EAAE,CAAC;QAChD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,eAAe,EAAE,CAAA;IAC9F,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,WAAW,cAAc,EAAE,CAAC,CAAC,CAAC,cAAc,CAAA;IAC3E,OAAO,GAAG,KAAK,oBAAoB,QAAQ,0CAA0C,sBAAsB,yFAAyF,CAAA;AACrM,CAAC,CAAA"}

package/dist/registry/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/registry/lock.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,SAAoB,GAAG,OAAO,CAAC,CAAC,CAAC,CAS5G"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/registry/lock.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,SAAoB,GAAG,OAAO,CAAC,CAAC,CAAC,CAS5G"}

package/dist/registry/lock.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { getRegistryPath } from './paths.js';
+import { delay } from '../time.js';
 /** Max time to wait for lock acquisition. */
 const LOCK_TIMEOUT_MS = 2_000;
 /** Lock considered stale if mtime is older than this. */
@@ -43,8 +44,7 @@ const acquireLock = async (lockPath) => {
         }
         attempt += 1;
         const jitter = Math.random() * BASE_RETRY_MS;
-        const delay = Math.min(BASE_RETRY_MS * attempt, 200) + jitter;
-        await sleep(delay);
+        await delay(Math.min(BASE_RETRY_MS * attempt, 200) + jitter);
     }
     // Last-resort: remove potentially stale lock and try once more
     await removeStaleLock(lockPath);
@@ -83,5 +83,4 @@ const removeStaleLock = async (lockPath) => {
 const isExistError = (error) => {
     return !!error && typeof error === 'object' && 'code' in error && error.code === 'EEXIST';
 };
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 //# sourceMappingURL=lock.js.map

package/dist/registry/lock.js.map

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

package/dist/registry/registry.d.ts

@@ -26,4 +26,18 @@ export declare const pruneStaleWatchers: (registry: RegistryV1, now?: number, tt
     registry: RegistryV1;
     removedIds: string[];
 };
+/**
+ * Read the registry, pruning heartbeat-stale entries in the same locked read-modify-write.
+ *
+ * This is the only automatic path that removes entries: the registry is shared between the CLI
+ * and the SDK, so both read through here rather than each keeping its own wrapper.
+ */
+export declare const readAndPruneRegistry: (options?: {
+    registryPath?: string;
+    ttlMs?: number;
+}) => Promise<RegistryV1>;
+/** Remove a watcher entry atomically (locked read-modify-write). */
+export declare const removeWatcherAndPersist: (id: string, registryPath?: string) => Promise<RegistryV1>;
+/** Remove several watcher entries in one locked read-modify-write. */
+export declare const removeWatchersAndPersist: (ids: string[], registryPath?: string) => Promise<RegistryV1>;
 //# sourceMappingURL=registry.d.ts.map

package/dist/registry/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/E,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,yCAAyC;AACzC,eAAO,MAAM,cAAc,QAAS,CAAA;AAEpC,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,GAAI,YAAgB,KAAG,UAIrD,CAAA;AAEF,kEAAkE;AAClE,eAAO,MAAM,YAAY,GAAU,qBAAgC,KAAG,OAAO,CAAC,kBAAkB,CA4B/F,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,aAAa,GAAU,UAAU,UAAU,EAAE,qBAAgC,KAAG,OAAO,CAAC,IAAI,CAIxG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,CAAC,QAAQ,EAAE,UAAU,KAAK,UAAU,EAAE,qBAAgC,KAAG,OAAO,CAAC,UAAU,CASxI,CAAA;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,GAAI,UAAU,UAAU,KAAG,aAAa,EAAsC,CAAA;AAEvG,qCAAqC;AACrC,eAAO,MAAM,eAAe,GAAI,UAAU,UAAU,EAAE,SAAS,aAAa,EAAE,YAAgB,KAAG,UAUhG,CAAA;AAED,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,GAAI,UAAU,UAAU,EAAE,IAAI,MAAM,EAAE,YAAgB,KAAG,UAavF,CAAA;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,GAC9B,UAAU,UAAU,EACpB,YAAgB,EAChB,cAAsB,KACpB;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAwB9C,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/E,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC,yCAAyC;AACzC,eAAO,MAAM,cAAc,QAAS,CAAA;AAEpC,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,GAAI,YAAgB,KAAG,UAIrD,CAAA;AAEF,kEAAkE;AAClE,eAAO,MAAM,YAAY,GAAU,qBAAgC,KAAG,OAAO,CAAC,kBAAkB,CA4B/F,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,aAAa,GAAU,UAAU,UAAU,EAAE,qBAAgC,KAAG,OAAO,CAAC,IAAI,CAIxG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,CAAC,QAAQ,EAAE,UAAU,KAAK,UAAU,EAAE,qBAAgC,KAAG,OAAO,CAAC,UAAU,CASxI,CAAA;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,GAAI,UAAU,UAAU,KAAG,aAAa,EAAsC,CAAA;AAEvG,qCAAqC;AACrC,eAAO,MAAM,eAAe,GAAI,UAAU,UAAU,EAAE,SAAS,aAAa,EAAE,YAAgB,KAAG,UAUhG,CAAA;AAED,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,GAAI,UAAU,UAAU,EAAE,IAAI,MAAM,EAAE,YAAgB,KAAG,UAavF,CAAA;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,GAC9B,UAAU,UAAU,EACpB,YAAgB,EAChB,cAAsB,KACpB;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAwB9C,CAAA;AAoDD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAU,UAAS;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,KAAG,OAAO,CAAC,UAAU,CAGtH,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,GAAU,IAAI,MAAM,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,UAAU,CACvB,CAAA;AAE7E,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,GAAU,KAAK,MAAM,EAAE,EAAE,eAAe,MAAM,KAAG,OAAO,CAAC,UAAU,CAOvG,CAAA"}

package/dist/registry/registry.js

@@ -152,4 +152,24 @@ const isRegistryV1 = (value) => {
     }
     return typeof record.updatedAt === 'number';
 };
+/**
+ * Read the registry, pruning heartbeat-stale entries in the same locked read-modify-write.
+ *
+ * This is the only automatic path that removes entries: the registry is shared between the CLI
+ * and the SDK, so both read through here rather than each keeping its own wrapper.
+ */
+export const readAndPruneRegistry = async (options = {}) => {
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    return updateRegistry((registry) => pruneStaleWatchers(registry, Date.now(), ttlMs).registry, options.registryPath);
+};
+/** Remove a watcher entry atomically (locked read-modify-write). */
+export const removeWatcherAndPersist = async (id, registryPath) => updateRegistry((registry) => removeWatcherEntry(registry, id), registryPath);
+/** Remove several watcher entries in one locked read-modify-write. */
+export const removeWatchersAndPersist = async (ids, registryPath) => {
+    if (ids.length === 0) {
+        const { registry } = await readRegistry(registryPath);
+        return registry;
+    }
+    return updateRegistry((registry) => ids.reduce((next, id) => removeWatcherEntry(next, id), registry), registryPath);
+};
 //# sourceMappingURL=registry.js.map

package/dist/registry/registry.js.map

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

package/dist/textPattern.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textPattern.d.ts","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAI7F;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,WAa/C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG,OAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAgB7G,CAAA"}
+{"version":3,"file":"textPattern.d.ts","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAI7F;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,WAa/C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG,OAQvE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAgB7G,CAAA"}

package/dist/textPattern.js

@@ -1,3 +1,4 @@
+import { formatError } from './errorMessage.js';
 const REGEX_PATTERN = /^\/(.+)\/([imsu]*)$/;
 /**
  * Parse a plain string or `/regex/flags` value into a reusable text pattern.
@@ -12,7 +13,7 @@ export const parseTextPattern = (text) => {
         return { type: 'regex', regex: new RegExp(pattern, flags) };
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = formatError(error);
         throw new Error(`Invalid regex pattern "${text}": ${msg}`);
     }
 };

package/dist/textPattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"textPattern.js","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,qBAAqB,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAe,EAAE;IAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACtC,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;IAChC,IAAI,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,OAAQ,EAAE,KAAK,CAAC,EAAE,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAClE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAAW,EAAE;IACjF,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAA4C,EAAE;IACpH,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACzC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;KAC5C,CAAA;AACF,CAAC,CAAA"}
+{"version":3,"file":"textPattern.js","sourceRoot":"","sources":["../src/textPattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,MAAM,aAAa,GAAG,qBAAqB,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAe,EAAE;IAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACtC,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;IAChC,IAAI,CAAC;QACJ,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,OAAQ,EAAE,KAAK,CAAC,EAAE,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAA;IAC3D,CAAC;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAAW,EAAE;IACjF,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAoB,EAA4C,EAAE;IACpH,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACzC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO;QACN,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;KAC5C,CAAA;AACF,CAAC,CAAA"}

package/dist/time.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolve after `ms` milliseconds.
+ *
+ * Seventeen modules had defined this same one-liner privately, under two names.
+ */
+export declare const delay: (ms: number) => Promise<void>;
+/** Duration suffixes accepted by {@link parseDurationMs}. */
+export type DurationUnit = 'ms' | 's' | 'm' | 'h' | 'd';
+/**
+ * Parse a duration string such as `250ms`, `30s`, `10m`, `2h`, or `7d` into milliseconds.
+ *
+ * @param value Duration string. A bare number is interpreted using `defaultUnit`.
+ * @param defaultUnit Unit applied when `value` carries no suffix. Defaults to seconds,
+ *   matching the CLI's `--since`/`--duration` style flags; pass `'ms'` for flags whose
+ *   documented examples are millisecond-scale.
+ * @returns Milliseconds, or `null` when the value is empty or not a valid duration.
+ *   Note that `0` is a valid result — check for `null` explicitly, not falsiness.
+ */
+export declare const parseDurationMs: (value: string, defaultUnit?: DurationUnit) => number | null;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAAsD,CAAA;AAErG,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAUvD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,EAAE,cAAa,YAAkB,KAAG,MAAM,GAAG,IAiBzF,CAAA"}