@vforsh/argus 0.1.11 → 0.1.13

package/dist/commands/netInspect.js

@@ -0,0 +1,205 @@
+import { createOutput } from '../output/io.js';
+import { formatNetworkRequestInspect, renderNetworkBodyText } from '../output/net.js';
+import { resolveWatcherOrExit, writeErrorResponse } from '../watchers/requestWatcher.js';
+import { appendNetCommandParams } from './netShared.js';
+import { captureNetWindow, parseNetCaptureOptions } from './netCapture.js';
+import { fetchNetRequestBody, fetchNetRequestDetail, fetchNetRequestSummaries } from './netRequestClient.js';
+/**
+ * Happy-path network inspection:
+ * capture a fresh request window, pick the newest URL match, then fetch detail + bodies in one go.
+ */
+export const runNetInspect = async (id, pattern, options) => {
+    const output = createOutput(options);
+    const normalizedPattern = pattern.trim();
+    if (!normalizedPattern) {
+        writeInspectError(output, 'invalid_request', 'pattern is required', 2);
+        return;
+    }
+    const resolved = await resolveWatcherOrExit({ id }, output);
+    if (!resolved) {
+        return;
+    }
+    const captureOptions = parseNetCaptureOptions({
+        ...options,
+        grep: normalizedPattern,
+        reload: options.reload ?? true,
+    }, { defaultClear: true });
+    if (captureOptions.error || !captureOptions.value) {
+        writeInspectError(output, 'invalid_request', captureOptions.error ?? 'Invalid net inspect options.', 2);
+        return;
+    }
+    const captureStartedAt = Date.now();
+    const captured = await captureNetWindow(resolved.watcher, buildInspectSettleFilters(options), captureOptions.value).catch((error) => {
+        output.writeWarn(`${resolved.watcher.id}: failed to inspect network (${error instanceof Error ? error.message : String(error)})`);
+        process.exitCode = 1;
+        return null;
+    });
+    if (!captured) {
+        return;
+    }
+    const matchedRequests = await fetchInspectedRequests(resolved.watcher, options, normalizedPattern, captureStartedAt, output);
+    if (!matchedRequests) {
+        return;
+    }
+    const selected = matchedRequests[matchedRequests.length - 1];
+    if (!selected) {
+        writeInspectNoMatch(output, normalizedPattern, captureOptions.value.settleMs, captured.timedOut);
+        return;
+    }
+    const query = createNetRequestIdQuery(selected.id);
+    const detail = await fetchNetRequestDetail(resolved.watcher, query, output);
+    if (!detail) {
+        return;
+    }
+    const parts = resolveInspectBodyParts(options);
+    const requestBody = parts.includes('request')
+        ? await fetchInspectableBody(resolved.watcher, query, detail, 'request', output)
+        : { body: null, abort: false };
+    if (requestBody.abort) {
+        return;
+    }
+    const responseBody = parts.includes('response')
+        ? await fetchInspectableBody(resolved.watcher, query, detail, 'response', output)
+        : { body: null, abort: false };
+    if (responseBody.abort) {
+        return;
+    }
+    const result = {
+        ok: true,
+        pattern: normalizedPattern,
+        cleared: captured.cleared,
+        reloaded: captureOptions.value.shouldReload,
+        settleMs: captureOptions.value.settleMs,
+        timedOut: captured.timedOut,
+        matchedCount: matchedRequests.length,
+        request: detail,
+        requestBody: requestBody.body,
+        responseBody: responseBody.body,
+    };
+    if (options.json) {
+        output.writeJson(result);
+        return;
+    }
+    for (const line of formatNetworkRequestInspect(detail, { matchedCount: matchedRequests.length, pattern: normalizedPattern })) {
+        output.writeHuman(line);
+    }
+    if (parts.includes('request')) {
+        writeBodySection(output, 'Request body', requestBody.body, detail.body.request);
+    }
+    if (parts.includes('response')) {
+        writeBodySection(output, 'Response body', responseBody.body, detail.body.response);
+    }
+};
+const fetchInspectableBody = async (watcher, query, detail, part, output) => {
+    if (!detail.body[part]) {
+        return { body: null, abort: false };
+    }
+    const response = await fetchNetRequestBody(watcher, query, part, output, { writeApiErrors: false });
+    if (!response) {
+        return { body: null, abort: true };
+    }
+    if (!response.ok) {
+        if (response.error.code === 'body_not_available') {
+            return { body: null, abort: false };
+        }
+        writeErrorResponse(response, output);
+        return { body: null, abort: true };
+    }
+    return { body: response, abort: false };
+};
+const resolveInspectBodyParts = (options) => {
+    const parts = [];
+    if (options.request) {
+        parts.push('request');
+    }
+    if (options.response) {
+        parts.push('response');
+    }
+    return parts.length > 0 ? parts : ['request', 'response'];
+};
+const buildInspectFilters = (options, pattern) => ({
+    grep: pattern,
+    host: options.host,
+    method: options.method,
+    status: options.status,
+    resourceType: options.resourceType,
+    mime: options.mime,
+    scope: options.scope,
+    frame: options.frame,
+    firstParty: options.firstParty,
+    thirdParty: options.thirdParty,
+    failedOnly: options.failedOnly,
+    slowOver: options.slowOver,
+    largeOver: options.largeOver,
+    ignoreHost: options.ignoreHost,
+    ignorePattern: options.ignorePattern,
+});
+const createNetRequestIdQuery = (id) => new URLSearchParams({ id: String(id) });
+/**
+ * `net inspect` waits for the page to go quiet, not just for matching requests to stop.
+ * That keeps late boot requests observable even when the app spends its first few seconds
+ * on unrelated assets or setup calls before hitting the endpoint we care about.
+ */
+const buildInspectSettleFilters = (options) => ({
+    scope: options.scope,
+    frame: options.frame,
+    firstParty: options.firstParty,
+    thirdParty: options.thirdParty,
+    ignoreHost: options.ignoreHost,
+    ignorePattern: options.ignorePattern,
+});
+const fetchInspectedRequests = async (watcher, options, pattern, captureStartedAt, output) => {
+    const query = new URLSearchParams();
+    const appended = appendNetCommandParams(query, {
+        ...buildInspectFilters(options, pattern),
+        limit: '5000',
+    }, { includeAfter: false });
+    if (appended.error) {
+        writeInspectError(output, 'invalid_request', appended.error, 2);
+        return null;
+    }
+    query.set('sinceTs', String(captureStartedAt));
+    return await fetchNetRequestSummaries(watcher, query, output);
+};
+const writeBodySection = (output, title, body, available) => {
+    output.writeHuman('');
+    if (!available || !body) {
+        output.writeHuman(`${title}: not available`);
+        return;
+    }
+    output.writeHuman(`${title}${body.mimeType ? ` (${body.mimeType})` : ''}:`);
+    const rendered = renderNetworkBodyText(body);
+    if (rendered == null) {
+        output.writeHuman('[base64-encoded binary data; re-run with --json for the raw payload]');
+        return;
+    }
+    process.stdout.write(prettifyJsonLikeBody(rendered));
+};
+const prettifyJsonLikeBody = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+        return value.endsWith('\n') ? value : `${value}\n`;
+    }
+    try {
+        return `${JSON.stringify(JSON.parse(trimmed), null, 2)}\n`;
+    }
+    catch {
+        return value.endsWith('\n') ? value : `${value}\n`;
+    }
+};
+const writeInspectError = (output, code, message, exitCode) => {
+    if (output.json) {
+        output.writeJson({ ok: false, error: { code, message } });
+    }
+    else {
+        output.writeWarn(message);
+    }
+    process.exitCode = exitCode;
+};
+const writeInspectNoMatch = (output, pattern, settleMs, timedOut) => {
+    const message = timedOut
+        ? `No requests matched "${pattern}" before the max timeout expired (quiet window ${settleMs}ms).`
+        : `No requests matched "${pattern}" after the ${settleMs}ms quiet window.`;
+    writeInspectError(output, 'not_found', message, 1);
+};
+//# sourceMappingURL=netInspect.js.map

package/dist/commands/netInspect.js.map

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

package/dist/commands/netRequestClient.d.ts

@@ -0,0 +1,17 @@
+import type { ErrorResponse, NetRequestBodyPart, NetRequestBodyResponse, NetworkRequestSummary, NetworkRequestDetail, WatcherRecord } from '@vforsh/argus-core';
+import type { Output } from '../output/io.js';
+/**
+ * Fetch one buffered network request detail record from a resolved watcher.
+ * API errors are written to output and normalized to `null` so commands stay linear.
+ */
+export declare const fetchNetRequestDetail: (watcher: Pick<WatcherRecord, "id" | "host" | "port">, query: URLSearchParams, output: Output) => Promise<NetworkRequestDetail | null>;
+/** Fetch buffered request summaries for follow-up selection after a reload capture settles. */
+export declare const fetchNetRequestSummaries: (watcher: Pick<WatcherRecord, "id" | "host" | "port">, query: URLSearchParams, output: Output) => Promise<NetworkRequestSummary[] | null>;
+/**
+ * Fetch one lazy request/response body from a resolved watcher.
+ * Returns `null` for fatal output-handled failures and the raw error payload for recoverable callers.
+ */
+export declare const fetchNetRequestBody: (watcher: Pick<WatcherRecord, "id" | "host" | "port">, query: URLSearchParams, part: NetRequestBodyPart, output: Output, config?: {
+    writeApiErrors?: boolean;
+}) => Promise<NetRequestBodyResponse | ErrorResponse | null>;
+//# sourceMappingURL=netRequestClient.d.ts.map

package/dist/commands/netRequestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netRequestClient.d.ts","sourceRoot":"","sources":["../../src/commands/netRequestClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EAEb,kBAAkB,EAClB,sBAAsB,EAEtB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAM7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GACjC,SAAS,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EACpD,OAAO,eAAe,EACtB,QAAQ,MAAM,KACZ,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAOrC,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,GACpC,SAAS,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EACpD,OAAO,eAAe,EACtB,QAAQ,MAAM,KACZ,OAAO,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAOxC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC/B,SAAS,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,EACpD,OAAO,eAAe,EACtB,MAAM,kBAAkB,EACxB,QAAQ,MAAM,EACd,SAAQ;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,KACvC,OAAO,CAAC,sBAAsB,GAAG,aAAa,GAAG,IAAI,CAIvD,CAAA"}

package/dist/commands/netRequestClient.js

@@ -0,0 +1,54 @@
+import { fetchWatcherJson, formatWatcherTransportError, writeErrorResponse } from '../watchers/requestWatcher.js';
+const NET_REQUEST_TIMEOUT_MS = 5_000;
+const NET_REQUEST_BODY_TIMEOUT_MS = 10_000;
+/**
+ * Fetch one buffered network request detail record from a resolved watcher.
+ * API errors are written to output and normalized to `null` so commands stay linear.
+ */
+export const fetchNetRequestDetail = async (watcher, query, output) => {
+    const response = await fetchNetRequestRoute(watcher, '/net/request', query, NET_REQUEST_TIMEOUT_MS, output);
+    if (!response || !response.ok) {
+        return null;
+    }
+    return response.request;
+};
+/** Fetch buffered request summaries for follow-up selection after a reload capture settles. */
+export const fetchNetRequestSummaries = async (watcher, query, output) => {
+    const response = await fetchNetRequestRoute(watcher, '/net', query, NET_REQUEST_TIMEOUT_MS, output);
+    if (!response || !response.ok) {
+        return null;
+    }
+    return response.requests;
+};
+/**
+ * Fetch one lazy request/response body from a resolved watcher.
+ * Returns `null` for fatal output-handled failures and the raw error payload for recoverable callers.
+ */
+export const fetchNetRequestBody = async (watcher, query, part, output, config = {}) => {
+    const bodyQuery = new URLSearchParams(query);
+    bodyQuery.set('part', part);
+    return await fetchNetRequestRoute(watcher, '/net/request/body', bodyQuery, NET_REQUEST_BODY_TIMEOUT_MS, output, config);
+};
+const fetchNetRequestRoute = async (watcher, path, query, timeoutMs, output, config = {}) => {
+    try {
+        const response = await fetchWatcherJson(watcher, {
+            path,
+            query,
+            timeoutMs,
+            returnErrorResponse: true,
+        });
+        if (!response.ok) {
+            if (config.writeApiErrors !== false) {
+                writeErrorResponse(response, output);
+            }
+            return response;
+        }
+        return response;
+    }
+    catch (error) {
+        output.writeWarn(formatWatcherTransportError(watcher, error));
+        process.exitCode = 1;
+        return null;
+    }
+};
+//# sourceMappingURL=netRequestClient.js.map

package/dist/commands/netRequestClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netRequestClient.js","sourceRoot":"","sources":["../../src/commands/netRequestClient.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAEjH,MAAM,sBAAsB,GAAG,KAAK,CAAA;AACpC,MAAM,2BAA2B,GAAG,MAAM,CAAA;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACzC,OAAoD,EACpD,KAAsB,EACtB,MAAc,EACyB,EAAE;IACzC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAqB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAA;IAC/H,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAA;AACxB,CAAC,CAAA;AAED,+FAA+F;AAC/F,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC5C,OAAoD,EACpD,KAAsB,EACtB,MAAc,EAC4B,EAAE;IAC5C,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAc,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAA;IAChH,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAA;AACzB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACvC,OAAoD,EACpD,KAAsB,EACtB,IAAwB,EACxB,MAAc,EACd,SAAuC,EAAE,EACgB,EAAE;IAC3D,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;IAC5C,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC3B,OAAO,MAAM,oBAAoB,CAAyB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAChJ,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,KAAK,EACjC,OAAoD,EACpD,IAAY,EACZ,KAAsB,EACtB,SAAiB,EACjB,MAAc,EACd,SAAuC,EAAE,EACL,EAAE;IACtC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAoB,OAAO,EAAE;YACnE,IAAI;YACJ,KAAK;YACL,SAAS;YACT,mBAAmB,EAAE,IAAI;SACzB,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;gBACrC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YACrC,CAAC;YACD,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,OAAO,QAAQ,CAAA;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,SAAS,CAAC,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC,CAAA"}

package/dist/commands/netRequestTarget.d.ts

@@ -0,0 +1,14 @@
+import type { Output } from '../output/io.js';
+/**
+ * Accept either an Argus numeric buffer id or a raw CDP request id and turn it into watcher query params.
+ */
+export declare const buildNetRequestLookupQuery: (request: string, output: Output) => URLSearchParams | null;
+/** Parse a CLI request selector into watcher query params. */
+export declare const resolveNetRequestLookupQuery: (request: string) => {
+    query: URLSearchParams;
+    error?: never;
+} | {
+    error: string;
+    query?: never;
+};
+//# sourceMappingURL=netRequestTarget.d.ts.map

package/dist/commands/netRequestTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netRequestTarget.d.ts","sourceRoot":"","sources":["../../src/commands/netRequestTarget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,eAAe,GAAG,IAS9F,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,GAAI,SAAS,MAAM,KAAG;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAexI,CAAA"}

package/dist/commands/netRequestTarget.js

@@ -0,0 +1,36 @@
+/**
+ * Accept either an Argus numeric buffer id or a raw CDP request id and turn it into watcher query params.
+ */
+export const buildNetRequestLookupQuery = (request, output) => {
+    const resolved = resolveNetRequestLookupQuery(request);
+    if (resolved.query) {
+        return resolved.query;
+    }
+    output.writeWarn(resolved.error);
+    process.exitCode = 2;
+    return null;
+};
+/** Parse a CLI request selector into watcher query params. */
+export const resolveNetRequestLookupQuery = (request) => {
+    const normalizedRequest = request.trim();
+    if (!normalizedRequest) {
+        return { error: 'request id is required' };
+    }
+    const query = new URLSearchParams();
+    const numericId = parseNetRequestBufferId(normalizedRequest);
+    if (numericId != null) {
+        query.set('id', String(numericId));
+    }
+    else {
+        query.set('requestId', normalizedRequest);
+    }
+    return { query };
+};
+const parseNetRequestBufferId = (value) => {
+    if (!/^\d+$/.test(value)) {
+        return null;
+    }
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+};
+//# sourceMappingURL=netRequestTarget.js.map

package/dist/commands/netRequestTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netRequestTarget.js","sourceRoot":"","sources":["../../src/commands/netRequestTarget.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAe,EAAE,MAAc,EAA0B,EAAE;IACrG,MAAM,QAAQ,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAA;IACtD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,KAAK,CAAA;IACtB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACpB,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,OAAe,EAAgF,EAAE;IAC7I,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IACxC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAA;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAA;IACnC,MAAM,SAAS,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAA;IAC5D,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IACnC,CAAC;SAAM,CAAC;QACP,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAA;AACjB,CAAC,CAAA;AAED,MAAM,uBAAuB,GAAG,CAAC,KAAa,EAAiB,EAAE;IAChE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC5B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AAClE,CAAC,CAAA"}

package/dist/commands/netShared.d.ts

@@ -0,0 +1,40 @@
+export type NetCliFilterOptions = {
+    since?: string;
+    grep?: string;
+    ignoreHost?: string[];
+    ignorePattern?: string[];
+    host?: string[];
+    method?: string[];
+    status?: string[];
+    resourceType?: string[];
+    mime?: string[];
+    scope?: string;
+    frame?: string;
+    firstParty?: boolean;
+    thirdParty?: boolean;
+    failedOnly?: boolean;
+    slowOver?: string;
+    largeOver?: string;
+};
+export type NetCliListOptions = NetCliFilterOptions & {
+    after?: string;
+    limit?: string;
+};
+export declare const validateNetCommandOptions: (options: NetCliFilterOptions) => {
+    error?: string;
+};
+export declare const appendNetCommandParams: (params: URLSearchParams, options: NetCliListOptions, config?: {
+    includeAfter?: boolean;
+    includeLimit?: boolean;
+}) => {
+    error?: string;
+};
+export declare const parseSettleDurationMs: (value: string | undefined, fallback?: string) => {
+    value?: number;
+    error?: string;
+};
+export declare const parseNetDurationMs: (value: string | undefined, flag: string) => {
+    value?: number;
+    error?: string;
+};
+//# sourceMappingURL=netShared.d.ts.map

package/dist/commands/netShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netShared.d.ts","sourceRoot":"","sources":["../../src/commands/netShared.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,mBAAmB,KAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CACY,CAAA;AAErG,eAAO,MAAM,sBAAsB,GAClC,QAAQ,eAAe,EACvB,SAAS,iBAAiB,EAC1B,SAAQ;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,KAC7D;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CA+ClB,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,SAAS,EAAE,iBAAe,KAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAGlH,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAW5G,CAAA"}

package/dist/commands/netShared.js

@@ -0,0 +1,108 @@
+import { parseDurationMs } from '../time.js';
+import { appendAfterLimitParams, appendNetFilterParams, appendNetIgnoreParams, appendSinceParam } from '../watchers/queryParams.js';
+export const validateNetCommandOptions = (options) => appendNetCommandParams(new URLSearchParams(), options, { includeAfter: false, includeLimit: false });
+export const appendNetCommandParams = (params, options, config = {}) => {
+    if (config.includeAfter !== false) {
+        const afterParams = new URLSearchParams();
+        appendAfterLimitParams(afterParams, { after: options.after });
+        for (const [key, value] of afterParams) {
+            params.set(key, value);
+        }
+    }
+    if (config.includeLimit !== false) {
+        const limitParams = new URLSearchParams();
+        appendAfterLimitParams(limitParams, { limit: options.limit });
+        for (const [key, value] of limitParams) {
+            params.set(key, value);
+        }
+    }
+    if (options.scope && options.frame) {
+        return { error: 'Cannot combine --scope and --frame. Use one or the other.' };
+    }
+    const derived = resolveDerivedNetFilters(options);
+    if (derived.error) {
+        return { error: derived.error };
+    }
+    appendNetFilterParams(params, {
+        grep: options.grep,
+        host: options.host,
+        method: options.method,
+        status: options.status,
+        resourceType: options.resourceType,
+        mime: options.mime,
+        scope: options.scope,
+        frame: options.frame,
+        party: derived.party,
+        failedOnly: options.failedOnly,
+        minDurationMs: derived.minDurationMs,
+        minTransferBytes: derived.minTransferBytes,
+    });
+    const ignore = appendNetIgnoreParams(params, options);
+    if (ignore.error) {
+        return ignore;
+    }
+    return appendSinceParam(params, options.since);
+};
+export const parseSettleDurationMs = (value, fallback = '3s') => {
+    const raw = value ?? fallback;
+    return parseNetDurationMs(raw, '--settle');
+};
+export const parseNetDurationMs = (value, flag) => {
+    if (value == null) {
+        return {};
+    }
+    const parsed = parseDurationMs(value);
+    if (parsed == null || parsed < 1) {
+        return { error: `Invalid ${flag} value: ${value}` };
+    }
+    return { value: Math.round(parsed) };
+};
+const parseNetBytes = (value, flag) => {
+    if (value == null) {
+        return {};
+    }
+    const trimmed = value.trim();
+    const match = trimmed.match(/^([0-9]+(?:\.[0-9]+)?)(b|kb|mb|gb)?$/i);
+    if (!match) {
+        return { error: `Invalid ${flag} value: ${value}` };
+    }
+    const amount = Number(match[1]);
+    if (!Number.isFinite(amount) || amount < 0) {
+        return { error: `Invalid ${flag} value: ${value}` };
+    }
+    const unit = (match[2] ?? 'b').toLowerCase();
+    const multiplier = unit === 'b' ? 1 : unit === 'kb' ? 1024 : unit === 'mb' ? 1024 * 1024 : 1024 * 1024 * 1024;
+    return { value: Math.round(amount * multiplier) };
+};
+const resolvePartyFilter = (options) => {
+    if (options.firstParty && options.thirdParty) {
+        return { error: 'Cannot combine --first-party and --third-party.' };
+    }
+    if (options.firstParty) {
+        return { value: 'first' };
+    }
+    if (options.thirdParty) {
+        return { value: 'third' };
+    }
+    return {};
+};
+const resolveDerivedNetFilters = (options) => {
+    const party = resolvePartyFilter(options);
+    if (party.error) {
+        return { error: party.error };
+    }
+    const minDurationMs = parseNetDurationMs(options.slowOver, '--slow-over');
+    if (minDurationMs.error) {
+        return { error: minDurationMs.error };
+    }
+    const minTransferBytes = parseNetBytes(options.largeOver, '--large-over');
+    if (minTransferBytes.error) {
+        return { error: minTransferBytes.error };
+    }
+    return {
+        party: party.value,
+        minDurationMs: minDurationMs.value,
+        minTransferBytes: minTransferBytes.value,
+    };
+};
+//# sourceMappingURL=netShared.js.map

package/dist/commands/netShared.js.map

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

package/dist/commands/netShow.d.ts

@@ -0,0 +1,5 @@
+export type NetShowOptions = {
+    json?: boolean;
+};
+export declare const runNetShow: (id: string | undefined, request: string, options: NetShowOptions) => Promise<void>;
+//# sourceMappingURL=netShow.d.ts.map

package/dist/commands/netShow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netShow.d.ts","sourceRoot":"","sources":["../../src/commands/netShow.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,MAAM,EAAE,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAyB/G,CAAA"}

package/dist/commands/netShow.js

@@ -0,0 +1,28 @@
+import { createOutput } from '../output/io.js';
+import { formatNetworkRequestDetail } from '../output/net.js';
+import { resolveWatcherOrExit } from '../watchers/requestWatcher.js';
+import { fetchNetRequestDetail } from './netRequestClient.js';
+import { buildNetRequestLookupQuery } from './netRequestTarget.js';
+export const runNetShow = async (id, request, options) => {
+    const output = createOutput(options);
+    const resolved = await resolveWatcherOrExit({ id }, output);
+    if (!resolved) {
+        return;
+    }
+    const query = buildNetRequestLookupQuery(request, output);
+    if (!query) {
+        return;
+    }
+    const detail = await fetchNetRequestDetail(resolved.watcher, query, output);
+    if (!detail) {
+        return;
+    }
+    if (options.json) {
+        output.writeJson(detail);
+        return;
+    }
+    for (const line of formatNetworkRequestDetail(detail)) {
+        output.writeHuman(line);
+    }
+};
+//# sourceMappingURL=netShow.js.map

package/dist/commands/netShow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netShow.js","sourceRoot":"","sources":["../../src/commands/netShow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAMlE,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,EAAsB,EAAE,OAAe,EAAE,OAAuB,EAAiB,EAAE;IACnH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAM;IACP,CAAC;IAED,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAM;IACP,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAM;IACP,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxB,OAAM;IACP,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;AACF,CAAC,CAAA"}

package/dist/commands/netSummary.d.ts

@@ -0,0 +1,6 @@
+import type { NetCliFilterOptions } from './netShared.js';
+export type NetSummaryOptions = NetCliFilterOptions & {
+    json?: boolean;
+};
+export declare const runNetSummary: (id: string | undefined, options: NetSummaryOptions) => Promise<void>;
+//# sourceMappingURL=netSummary.d.ts.map

package/dist/commands/netSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netSummary.d.ts","sourceRoot":"","sources":["../../src/commands/netSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAQzD,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG;IACrD,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,IAAI,MAAM,GAAG,SAAS,EAAE,SAAS,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAmCpG,CAAA"}