@vforsh/argus-client 0.3.0 → 0.5.0

package/dist/client/methods/inspect.js.map

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

package/dist/client/queryParams.d.ts

@@ -1,4 +1,6 @@
 import type { LogsOptions, NetOptions } from '../types.js';
+/** Build the query string for the log listing and tail routes. */
 export declare const buildLogsParams: (options: LogsOptions) => URLSearchParams;
+/** Build the query string for the network listing and tail routes. */
 export declare const buildNetParams: (options: NetOptions) => URLSearchParams;
 //# sourceMappingURL=queryParams.d.ts.map

package/dist/client/queryParams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG1D,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,KAAG,eA+CtD,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,KAAG,eA0BpD,CAAA"}
+{"version":3,"file":"queryParams.d.ts","sourceRoot":"","sources":["../../src/client/queryParams.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE1D,kEAAkE;AAClE,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,KAAG,eAiBtD,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,GAAI,SAAS,UAAU,KAAG,eA0BpD,CAAA"}

package/dist/client/queryParams.js

@@ -1,142 +1,107 @@
-import { parseDurationMs } from '../time/parseDurationMs.js';
+import { NET_PARTIES, NET_SCOPES, normalizeMatchPatterns, parseDurationMs, toSearchParams } from '@vforsh/argus-core';
+/** Build the query string for the log listing and tail routes. */
 export const buildLogsParams = (options) => {
-    const params = new URLSearchParams();
-    const after = normalizeQueryValue(options.after);
-    if (after != null) {
-        params.set('after', after);
-    }
-    if (after != null && options.sinceEpoch != null) {
+    if (options.after != null && options.sinceEpoch != null) {
         throw new Error('Use either after or sinceEpoch, not both');
     }
-    const sinceEpoch = normalizeQueryValue(options.sinceEpoch);
-    if (sinceEpoch) {
-        params.set('sinceEpoch', sinceEpoch);
-    }
-    const limit = normalizeNonNegativeNumber('limit', options.limit);
-    if (limit != null) {
-        params.set('limit', String(limit));
-    }
-    const levels = normalizeLevels(options.levels);
-    if (levels) {
-        params.set('levels', levels);
-    }
-    const match = normalizeMatch(options.match);
-    if (match) {
-        for (const pattern of match) {
-            params.append('match', pattern);
-        }
-    }
-    const matchCase = normalizeMatchCase(options.matchCase);
-    if (matchCase) {
-        params.set('matchCase', matchCase);
-    }
-    const source = normalizeQueryValue(options.source);
-    if (source) {
-        params.set('source', source);
-    }
-    const sinceTs = resolveSinceTs(options.since);
-    if (sinceTs != null) {
-        params.set('sinceTs', String(sinceTs));
-    }
-    return params;
+    const query = {
+        after: options.after,
+        sinceEpoch: options.sinceEpoch,
+        limit: requireNonNegative('limit', options.limit),
+        levels: normalizeLevels(options.levels),
+        match: requireMatchPatterns(options.match),
+        matchCase: requireMatchCase(options.matchCase),
+        source: options.source,
+        sinceTs: resolveSinceTs(options.since),
+    };
+    return toSearchParams(query);
 };
+/** Build the query string for the network listing and tail routes. */
 export const buildNetParams = (options) => {
-    const params = new URLSearchParams();
-    const after = normalizeNonNegativeNumber('after', options.after);
-    if (after != null) {
-        params.set('after', String(after));
-    }
-    const limit = normalizeNonNegativeNumber('limit', options.limit);
-    if (limit != null) {
-        params.set('limit', String(limit));
-    }
-    const sinceTs = resolveSinceTs(options.since);
-    if (sinceTs != null) {
-        params.set('sinceTs', String(sinceTs));
-    }
-    const grep = normalizeQueryValue(options.grep);
-    if (grep) {
-        params.set('grep', grep);
-    }
-    appendRepeatedQueryValues(params, 'ignoreHost', options.ignoreHost);
-    appendRepeatedQueryValues(params, 'ignorePattern', options.ignorePattern);
-    return params;
+    if (options.scope != null && options.frame != null) {
+        throw new Error('Cannot combine scope and frame filters. Use one or the other.');
+    }
+    const query = {
+        after: requireNonNegative('after', options.after),
+        limit: requireNonNegative('limit', options.limit),
+        sinceTs: resolveSinceTs(options.since),
+        grep: options.grep,
+        host: requireNonEmptyValues('host', options.host),
+        method: requireNonEmptyValues('method', options.method),
+        status: requireNonEmptyValues('status', options.status),
+        resourceType: requireNonEmptyValues('resourceType', options.resourceType),
+        mime: requireNonEmptyValues('mime', options.mime),
+        scope: requireChoice('scope', options.scope, NET_SCOPES),
+        frame: options.frame,
+        party: requireChoice('party', options.party, NET_PARTIES),
+        failedOnly: options.failedOnly,
+        minDurationMs: requireNonNegative('minDurationMs', options.minDurationMs),
+        minTransferBytes: requireNonNegative('minTransferBytes', options.minTransferBytes),
+        ignoreHost: requireNonEmptyValues('ignoreHost', options.ignoreHost),
+        ignorePattern: requireNonEmptyValues('ignorePattern', options.ignorePattern),
+    };
+    return toSearchParams(query);
 };
 const normalizeLevels = (levels) => {
     if (levels == null) {
         return undefined;
     }
-    if (Array.isArray(levels)) {
-        const normalized = levels.map((level) => level.trim()).filter(Boolean);
-        if (normalized.length === 0) {
-            return undefined;
-        }
-        return normalized.join(',');
+    if (!Array.isArray(levels)) {
+        return levels;
     }
-    const trimmed = levels.trim();
-    return trimmed ? trimmed : undefined;
+    const normalized = levels.map((level) => level.trim()).filter(Boolean);
+    return normalized.length > 0 ? normalized.join(',') : undefined;
 };
-const normalizeMatch = (match) => {
+const requireMatchPatterns = (match) => {
     if (match == null) {
         return undefined;
     }
-    const values = Array.isArray(match) ? match : [match];
-    const normalized = values.map((value) => value.trim());
-    if (normalized.some((value) => value.length === 0)) {
-        throw new Error('Invalid match value: empty pattern.');
+    const result = normalizeMatchPatterns(Array.isArray(match) ? match : [match]);
+    if (result.error) {
+        throw new Error(result.error);
     }
-    return normalized;
-};
-const normalizeMatchCase = (matchCase) => {
-    if (matchCase == null) {
-        return undefined;
-    }
-    if (matchCase !== 'sensitive' && matchCase !== 'insensitive') {
-        throw new Error(`Invalid matchCase value: ${matchCase}`);
-    }
-    return matchCase;
+    return result.patterns;
 };
+const requireMatchCase = (matchCase) => requireChoice('matchCase', matchCase, ['sensitive', 'insensitive']);
 const resolveSinceTs = (value) => {
     if (value == null) {
         return undefined;
     }
-    const durationMs = typeof value === 'number' ? normalizeNonNegativeNumber('since', value) : parseDurationOrThrow(value);
-    if (durationMs == null) {
-        return undefined;
+    const durationMs = typeof value === 'number' ? requireNonNegative('since', value) : parseDurationOrThrow(value);
+    return durationMs == null ? undefined : Date.now() - durationMs;
+};
+const parseDurationOrThrow = (value) => {
+    const duration = parseDurationMs(value);
+    if (duration == null) {
+        throw new Error(`Invalid since value: ${value}`);
     }
-    return Date.now() - durationMs;
+    return duration;
 };
-const normalizeQueryValue = (value) => {
+const requireNonNegative = (label, value) => {
     if (value == null) {
         return undefined;
     }
-    const trimmed = value.trim();
-    return trimmed ? trimmed : undefined;
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid ${label} value: ${value}`);
+    }
+    return value;
 };
-const appendRepeatedQueryValues = (params, key, values) => {
+const requireNonEmptyValues = (label, values) => {
     if (!values || values.length === 0) {
-        return;
+        return undefined;
     }
     for (const value of values) {
-        const normalized = normalizeQueryValue(value);
-        if (!normalized) {
-            throw new Error(`Invalid ${key} value: ${value}`);
+        if (!value.trim()) {
+            throw new Error(`Invalid ${label} value: ${value}`);
         }
-        params.append(key, normalized);
     }
+    return values;
 };
-const parseDurationOrThrow = (value) => {
-    const duration = parseDurationMs(value);
-    if (duration == null) {
-        throw new Error(`Invalid since value: ${value}`);
-    }
-    return duration;
-};
-const normalizeNonNegativeNumber = (label, value) => {
+const requireChoice = (label, value, allowed) => {
     if (value == null) {
         return undefined;
     }
-    if (!Number.isFinite(value) || value < 0) {
+    if (!allowed.includes(value)) {
         throw new Error(`Invalid ${label} value: ${value}`);
     }
     return value;

package/dist/client/queryParams.js.map

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

package/dist/client/watcherRequest.d.ts

@@ -1,4 +1,4 @@
-import type { WatcherRecord } from '@vforsh/argus-core';
+import type { WatcherRecord, ResponseData } from '@vforsh/argus-core';
 import type { HttpOptions } from '../http/fetchJson.js';
 type RegistryContext = {
     registryPath?: string;
@@ -16,5 +16,15 @@ export declare const requestWatcher: <T>(context: RegistryContext, watcherId: st
     watcher: WatcherRecord;
     data: T;
 }>;
+/**
+ * Issue a watcher request and return the response payload without its `ok` discriminant.
+ *
+ * SDK methods throw on failure, so the caller already knows `ok` was `true`; stripping it
+ * here means a method never has to re-list the response fields to drop one of them, and a
+ * new protocol field reaches callers without touching the method.
+ */
+export declare const requestWatcherData: <T extends {
+    ok: true;
+}>(context: RegistryContext, watcherId: string, options: WatcherRequestOptions) => Promise<ResponseData<T>>;
 export {};
 //# sourceMappingURL=watcherRequest.d.ts.map

package/dist/client/watcherRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcherRequest.d.ts","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,KAAK,eAAe,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,SAAS,eAAe,EAAE,WAAW,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQ7I,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,CAAC,EACrC,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAoB3C,CAAA"}
+{"version":3,"file":"watcherRequest.d.ts","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAUrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,KAAK,eAAe,GAAG;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,SAAS,eAAe,EAAE,WAAW,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQ7I,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,CAAC,EACrC,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAuB3C,CAAA;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,EAC9D,SAAS,eAAe,EACxB,WAAW,MAAM,EACjB,SAAS,qBAAqB,KAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAIzB,CAAA"}

package/dist/client/watcherRequest.js

@@ -1,6 +1,5 @@
-import { isHttpResponseError } from '@vforsh/argus-core';
+import { buildWatcherUrl, classifyWatcherFailure, formatError, formatWatcherTransportError, readAndPruneRegistry, removeWatcherAndPersist, shouldEvictWatcherOnFailure, } from '@vforsh/argus-core';
 import { fetchJson } from '../http/fetchJson.js';
-import { readAndPruneRegistry, removeWatcherAndPersist } from '../registry/readAndPruneRegistry.js';
 export const withWatcher = async (context, watcherId, callback) => {
     const registry = await readAndPruneRegistry({ registryPath: context.registryPath, ttlMs: context.ttlMs });
     const watcher = registry.watchers[watcherId];
@@ -19,28 +18,28 @@ export const requestWatcher = async (context, watcherId, options) => withWatcher
         return { watcher, data };
     }
     catch (error) {
-        // The watcher answered and rejected this request, so it is demonstrably alive.
-        // Evicting it here would break every later call in the process over one bad
-        // selector or a page that happens to be mid-navigation.
-        if (isHttpResponseError(error)) {
-            throw new Error(`${watcher.id}: ${error.message}`);
+        // One classifier and one eviction policy, shared with the CLI: the same outage must not
+        // leave the shared registry in a different state depending on which stack observed it.
+        const failure = classifyWatcherFailure(error);
+        if (failure === 'api-rejection') {
+            throw new Error(`${watcher.id}: ${formatError(error)}`);
+        }
+        if (shouldEvictWatcherOnFailure(failure)) {
+            await removeWatcherAndPersist(watcher.id, context.registryPath);
         }
-        await removeWatcherAndPersist(watcher.id, context.registryPath);
         throw new Error(formatWatcherTransportError(watcher, error));
     }
 });
-const buildWatcherUrl = (watcher, path, query) => {
-    const qs = query?.toString();
-    return `http://${watcher.host}:${watcher.port}${path}${qs ? `?${qs}` : ''}`;
-};
-const formatWatcherTransportError = (watcher, error) => `${watcher.id}: failed to reach watcher (${formatUnknownError(error)})`;
-const formatUnknownError = (error) => {
-    if (!error) {
-        return 'unknown error';
-    }
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
+/**
+ * Issue a watcher request and return the response payload without its `ok` discriminant.
+ *
+ * SDK methods throw on failure, so the caller already knows `ok` was `true`; stripping it
+ * here means a method never has to re-list the response fields to drop one of them, and a
+ * new protocol field reaches callers without touching the method.
+ */
+export const requestWatcherData = async (context, watcherId, options) => {
+    const { data } = await requestWatcher(context, watcherId, options);
+    const { ok: _ok, ...rest } = data;
+    return rest;
 };
 //# sourceMappingURL=watcherRequest.js.map

package/dist/client/watcherRequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"watcherRequest.js","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAA;AAenG,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAK,OAAwB,EAAE,SAAiB,EAAE,QAAgD,EAAc,EAAE;IACjJ,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IACzG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAClC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACiB,EAAE,CACjD,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACjD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACtF,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,+EAA+E;QAC/E,4EAA4E;QAC5E,wDAAwD;QACxD,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACnD,CAAC;QAED,MAAM,uBAAuB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAC/D,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7D,CAAC;AACF,CAAC,CAAC,CAAA;AAEH,MAAM,eAAe,GAAG,CAAC,OAA6C,EAAE,IAAY,EAAE,KAAuB,EAAU,EAAE;IACxH,MAAM,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC5B,OAAO,UAAU,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC5E,CAAC,CAAA;AAED,MAAM,2BAA2B,GAAG,CAAC,OAAkC,EAAE,KAAc,EAAU,EAAE,CAClG,GAAG,OAAO,CAAC,EAAE,8BAA8B,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAA;AAExE,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAU,EAAE;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,eAAe,CAAA;IACvB,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAA;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"watcherRequest.js","sourceRoot":"","sources":["../../src/client/watcherRequest.ts"],"names":[],"mappings":"AACA,OAAO,EACN,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,GAC3B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAehD,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAK,OAAwB,EAAE,SAAiB,EAAE,QAAgD,EAAc,EAAE;IACjJ,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IACzG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAClC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACiB,EAAE,CACjD,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IACjD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE;YACtF,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SAClB,CAAC,CAAA;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,wFAAwF;QACxF,uFAAuF;QACvF,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,EAAE,KAAK,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,uBAAuB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAChE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAC7D,CAAC;AACF,CAAC,CAAC,CAAA;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACtC,OAAwB,EACxB,SAAiB,EACjB,OAA8B,EACH,EAAE;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAI,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;IACrE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IACjC,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { ElementRef, LogEvent, LogEpoch, LogLevel, MouseButton, NetworkRequestDetail, NetworkRequestSummary, RecordClipRegion, RecordFormat, ScreenshotClipRegion, StatusResponse, VisibilityLock, WatcherRecord } from '@vforsh/argus-core';
+import type { DomClickRequest, DomClickResponse, EvalRequest, EvalResponse, LogEvent, LogEpoch, LogLevel, NetClearResponse, NetQuery, NetResponse, NetworkRequestDetail, RecordRequest, RecordStartRequest, RecordStartResponse, RecordStopRequest, RecordStopResponse, ReloadRequest, ResponseData, ScreenshotRequest, ScreenshotResponse, StatusResponse, TraceStartRequest, TraceStartResponse, TraceStopRequest, TraceStopResponse, VisibilityRequest, VisibilityResponse, WatcherRecord } from '@vforsh/argus-core';
 /** Options for configuring the Argus client. */
 export type ArgusClientOptions = {
     /** Override registry path instead of using `ARGUS_REGISTRY_PATH` / default. */
@@ -23,6 +23,13 @@ export type ListResult = {
     status?: StatusResponse;
     /** Error message when unreachable. */
     error?: string;
+    /**
+     * Set when the watcher answered but speaks an incompatible protocol version.
+     *
+     * The watcher is still reachable and `status` is still populated, but commands issued
+     * against it may fail in ways this SDK cannot interpret.
+     */
+    protocolMismatch?: string;
 };
 /** Controls how log event args are returned. */
 export type LogsMode = 'preview' | 'full';
@@ -62,195 +69,64 @@ export type LogEpochResult = {
     epoch: LogEpoch;
 };
 /** Options for fetching network request summaries. */
-export type NetOptions = {
-    after?: number;
-    limit?: number;
+export type NetOptions = Omit<NetQuery, 'sinceTs' | 'timeoutMs'> & {
     /**
      * Filter by time window.
      * - If string: parsed like CLI (e.g. "10m", "2h")
      * - If number: treated as durationMs
+     *
+     * Sugar over the wire's absolute `sinceTs`.
      */
     since?: string | number;
-    /** Substring match over redacted URLs. */
-    grep?: string;
-    /** Ignore requests by host name (exact host or subdomain match). */
-    ignoreHost?: string[];
-    /** Ignore requests whose URL contains one of these substrings. */
-    ignorePattern?: string[];
 };
 /** Network request summary results with pagination cursor. */
-export type NetResult = {
-    requests: NetworkRequestSummary[];
-    nextAfter: number;
-};
-/** Options for evaluating a JS expression in the connected page. */
-export type EvalOptions = {
-    /** JS expression to execute. */
-    expression: string;
-    /** String-only values exposed to the expression as `args`. */
-    args?: Record<string, string>;
-    /** Await promises before returning. Defaults to true. */
-    awaitPromise?: boolean;
-    /**
-     * Enable Chrome's REPL mode for console-style evaluation.
-     * Defaults to true and allows native top-level `await`.
-     */
-    replMode?: boolean;
-    /** Command timeout in milliseconds. */
-    timeoutMs?: number;
-    /** Return by value when possible. Defaults to true. */
-    returnByValue?: boolean;
-    /**
-     * Serialize the result inside the page and return that JSON string as `result`,
-     * wrapped as `{"v":<value>}`. Defaults to false.
-     *
-     * Prefer {@link ArgusClient.evalValue}, which sets this and parses the envelope
-     * for you. See {@link EvalValueOptions.jsonValue} for why the mode exists.
-     */
-    jsonValue?: boolean;
-    /** Install the temporary host bridge expected by bundled Argus scenario code. */
-    scenario?: boolean;
-};
+export type NetResult = ResponseData<NetResponse>;
+/**
+ * Options for evaluating a JS expression in the connected page.
+ *
+ * This *is* the POST /eval body — it is sent verbatim — so it aliases the protocol
+ * request type rather than restating it.
+ */
+export type EvalOptions = EvalRequest;
 /** Result of a remote evaluation. */
-export type EvalResult = {
-    result: unknown;
-    type: string | null;
-    exception: {
-        text: string;
-        details?: unknown;
-    } | null;
-};
+export type EvalResult = ResponseData<EvalResponse>;
 /** Options for starting a Chrome trace. */
-export type TraceStartOptions = {
-    outFile?: string;
-    categories?: string;
-    options?: string;
-};
+export type TraceStartOptions = TraceStartRequest;
 /** Trace start result metadata. */
-export type TraceStartResult = {
-    traceId: string;
-    sessionName: string;
-    outFile: string;
-};
+export type TraceStartResult = ResponseData<TraceStartResponse>;
 /** Options for stopping an active trace. */
-export type TraceStopOptions = {
-    traceId?: string;
-    outFile?: string;
-};
+export type TraceStopOptions = TraceStopRequest;
 /** Trace stop result metadata. */
-export type TraceStopResult = {
-    sessionName: string;
-    outFile: string;
-    eventCount: number;
-    durationMs: number;
-};
+export type TraceStopResult = ResponseData<TraceStopResponse>;
 /** Options for capturing a screenshot. */
-export type ScreenshotOptions = {
-    outFile?: string;
-    selector?: string;
-    /** Viewport-relative crop rectangle in CSS pixels. Mutually exclusive with `selector`. */
-    clip?: ScreenshotClipRegion;
-    format?: 'png';
-};
+export type ScreenshotOptions = ScreenshotRequest;
 /** Screenshot result metadata. */
-export type ScreenshotResult = {
-    outFile: string;
-    clipped: boolean;
-};
+export type ScreenshotResult = ResponseData<ScreenshotResponse>;
 /** Options for clicking in the connected page. Mirrors CLI `argus click` semantics. */
-export type DomClickOptions = {
-    /** CSS selector to match element(s). */
-    selector?: string;
-    /** Stable element ref to click. Mutually exclusive with `selector`. */
-    ref?: ElementRef;
-    /** Allow multiple matches. If false and >1 match, the watcher errors. Defaults to false. */
-    all?: boolean;
-    /** Viewport x-coordinate, or x-offset from element top-left when `selector` is set. */
-    x?: number;
-    /** Viewport y-coordinate, or y-offset from element top-left when `selector` is set. */
-    y?: number;
-    /** Mouse button to click. Defaults to 'left'. */
-    button?: MouseButton;
-    /** Filter elements by trimmed textContent. Plain string = exact match, `/regex/flags` = regex test. */
-    text?: string;
-    /** Wait up to this many ms for the selector to appear before clicking. */
-    wait?: number;
-};
+export type DomClickOptions = DomClickRequest;
 /** Result of a click, reporting selector matches separately from actual clicks. */
-export type DomClickResult = {
-    /** Number of elements matched by the selector. */
-    matches: number;
-    /** Number of elements actually clicked. */
-    clicked: number;
-};
+export type DomClickResult = ResponseData<DomClickResponse>;
 /** Result of clearing the watcher's buffered network log. */
-export type NetClearResult = {
-    /** Number of buffered requests removed. */
-    cleared: number;
-};
+export type NetClearResult = ResponseData<NetClearResponse>;
 /** Options for the page visibility lock. */
-export type VisibilityOptions = {
-    /** `show` locks the page shown+focused; `hide` releases the lock. */
-    action: 'show' | 'hide';
-};
+export type VisibilityOptions = VisibilityRequest;
 /**
  * Visibility lock result. The desired lock is sticky across detach/reattach:
  * the watcher remembers it and re-applies on the next attach when `attached` is false.
  */
-export type VisibilityResult = {
-    /** Whether the watcher was attached to a CDP target at response time. */
-    attached: boolean;
-    /** Current desired visibility lock. */
-    state: VisibilityLock;
-};
+export type VisibilityResult = ResponseData<VisibilityResponse>;
 /** Options for reloading the connected page. */
-export type ReloadOptions = {
-    /** Bypass the browser cache. Defaults to false. */
-    ignoreCache?: boolean;
-};
+export type ReloadOptions = ReloadRequest;
 /** Shared options for video recording requests. */
-export type RecordOptions = {
-    /** Destination path on the watcher host. Extension may determine `format`. */
-    outFile?: string;
-    /** Record only the element matched by this CSS selector. Mutually exclusive with `clip`. */
-    selector?: string;
-    /** Viewport-relative crop rectangle in CSS pixels. Mutually exclusive with `selector`. */
-    clip?: RecordClipRegion;
-    /** Output frames per second (1-60). Defaults to 30. */
-    fps?: number;
-    /** Output container. Defaults to mp4 unless inferred from the `outFile` extension. */
-    format?: RecordFormat;
-};
+export type RecordOptions = RecordStartRequest;
 /** Options for a fixed-duration one-shot recording. */
-export type RecordCaptureOptions = RecordOptions & {
-    /** Capture duration in milliseconds. Must be greater than 0. */
-    durationMs: number;
-};
+export type RecordCaptureOptions = RecordRequest;
 /** Metadata returned when a recording starts. */
-export type RecordStartResult = {
-    /** Handle for the active recording, accepted by `recordStop`. */
-    recordId: string;
-    sessionName: string;
-    outFile: string;
-    format: RecordFormat;
-    fps: number;
-    /** Whether a `selector` or `clip` crop was applied. */
-    clipped: boolean;
-};
+export type RecordStartResult = ResponseData<RecordStartResponse>;
 /** Metadata returned when a recording is finalized. */
-export type RecordStopResult = RecordStartResult & {
-    /** Number of frames written to `outFile`. */
-    frameCount: number;
-    /** Wall-clock capture duration in milliseconds. */
-    durationMs: number;
-};
+export type RecordStopResult = ResponseData<RecordStopResponse>;
 /** Options for stopping an active recording. */
-export type RecordStopOptions = {
-    /** Recording to stop. Defaults to the watcher's active recording. */
-    recordId?: string;
-    /** Move the finalized file to this path before returning. */
-    outFile?: string;
-};
+export type RecordStopOptions = RecordStopRequest;
 /**
  * Options for {@link ArgusClient.evalValue}.
  *