@pentoshi/clai 4.11.7 → 4.11.8

package/dist/tools/web/capture.js

@@ -13,106 +13,39 @@
 import { createHash } from "node:crypto";
 import { parseSetCookie } from "./readable.js";
 import { MAX_COOKIES_CAPTURED, MAX_REDIRECT_HOPS, } from "./types.js";
-/**
- * Pure builder that records the per-hop observations made by
- * `fetch-core.ts` and assembles them into a {@link CapturedFields}
- * snapshot via {@link Capture.finalize}.
- *
- * The builder is single-use: callers should construct one `Capture` per
- * `web.fetch` invocation and discard it after `finalize`.
- */
 export class Capture {
-    /** Final-hop DNS-resolution time in milliseconds. */
     dnsMs = 0;
-    /** Final-hop TCP-connect time in milliseconds. */
     tcpMs = 0;
-    /** Final-hop TLS-handshake time in milliseconds (https only). */
     tlsMs = undefined;
-    /** Final-hop time-to-first-byte in milliseconds. */
     ttfbMs = 0;
-    /** Final-hop resolved IP, set by {@link markDnsResolved}. */
     resolvedIp = "";
-    /** Final-hop hostname, set by {@link setHopContext}. */
     finalHostname = "";
-    /** Final-hop HTTP status, set by {@link markResponse}. */
     status = 0;
-    /** Final-hop normalised headers, set by {@link markResponse}. */
     headers = {};
-    /** Final-hop TLS info (https only), set by {@link markTlsHandshaked}. */
     tls = undefined;
-    /** Redirect hops, capped at {@link MAX_REDIRECT_HOPS}. */
     redirectChain = [];
-    /** Captured cookies, capped at {@link MAX_COOKIES_CAPTURED}. */
     cookies = [];
-    /**
-     * Whether the current invocation is an `https://` fetch. When `false`,
-     * `tlsMs` is omitted from {@link TimingInfo} and `tls` from
-     * {@link CapturedFields} per Requirements 2.16, 2.24, and 2.25.
-     */
     isHttps;
-    /**
-     * Construct a fresh builder.
-     *
-     * @param opts.isHttps - Whether the request URL used `https://`.
-     *   Controls whether `timing.tlsMs` and `tls` are populated.
-     * @param opts.finalHostname - Optional initial hostname; the transport
-     *   will overwrite this via {@link setHopContext} as redirects are
-     *   followed.
-     */
     constructor(opts) {
         this.isHttps = opts.isHttps;
         if (typeof opts.finalHostname === "string") {
             this.finalHostname = opts.finalHostname;
         }
     }
-    /**
-     * Record the hostname of the hop the transport is about to issue.
-     *
-     * Called once per hop, before {@link markDnsResolved}. The most-recent
-     * value becomes {@link CapturedFields.finalHostname}.
-     */
     setHopContext(hostname) {
         if (typeof hostname === "string" && hostname.length > 0) {
             this.finalHostname = hostname;
         }
     }
-    /**
-     * Record the DNS-resolution outcome for the current hop.
-     *
-     * The most-recent values overwrite any earlier ones so the values
-     * surfaced in {@link TimingInfo.dnsMs} and
-     * {@link CapturedFields.resolvedIp} correspond to the final hop.
-     */
     markDnsResolved(ms, ip) {
         this.dnsMs = sanitiseMs(ms);
         if (typeof ip === "string" && ip.length > 0) {
             this.resolvedIp = ip;
         }
     }
-    /**
-     * Record the TCP-connect time for the current hop. The most-recent
-     * value wins (see class-level docstring for per-hop semantics).
-     */
     markTcpConnected(ms) {
         this.tcpMs = sanitiseMs(ms);
     }
-    /**
-     * Record the TLS handshake time and extract {@link TlsInfo} from the
-     * final-hop `tls.TLSSocket`.
-     *
-     * - `protocol`           ← `socket.getProtocol()` (`""` if null).
-     * - `cipher`             ← `socket.getCipher().name` (`""` if missing).
-     * - `subjectCN/issuerCN` ← `cert.subject.CN` / `cert.issuer.CN`.
-     * - `subjectAltNames`    ← parsed from `cert.subjectaltname`.
-     * - `notBefore/notAfter` ← `cert.valid_from` / `cert.valid_to` parsed
-     *                          to ISO 8601 (falls back to the raw value).
-     * - `fingerprintSha256`  ← lowercase, colon-separated SHA-256 of
-     *                          `cert.raw` via `node:crypto`.
-     *
-     * Calling this method on an http:// fetch is harmless but pointless —
-     * the constructor's `isHttps=false` flag suppresses the field in
-     * {@link finalize} regardless.
-     */
     markTlsHandshaked(ms, socket) {
         this.tlsMs = sanitiseMs(ms);
         this.tls = extractTlsInfo(socket);
@@ -131,15 +64,6 @@ export class Capture {
         this.ttfbMs = sanitiseMs(ttfbMs);
         this.headers = normaliseHeaders(rawHeaders);
     }
-    /**
-     * Append a redirect hop to the chronological chain.
-     *
-     * Hops in excess of {@link MAX_REDIRECT_HOPS} are silently dropped so
-     * the array always satisfies the cap from Requirement 2.26.
-     * `fetch-core.ts` is responsible for surfacing the
-     * `redirect-limit` error when the cap is reached; this builder just
-     * stops accumulating.
-     */
     addRedirectHop(url, status, location) {
         if (this.redirectChain.length >= MAX_REDIRECT_HOPS)
             return;
@@ -154,14 +78,6 @@ export class Capture {
         }
         this.redirectChain.push(hop);
     }
-    /**
-     * Parse one `Set-Cookie` header value via {@link parseSetCookie} and
-     * append the resulting {@link CookieInfo}, bounded at
-     * {@link MAX_COOKIES_CAPTURED}.
-     *
-     * Cookies in excess of the cap are silently dropped, matching
-     * Requirement 2.31.
-     */
     addSetCookieHeader(value) {
         if (this.cookies.length >= MAX_COOKIES_CAPTURED)
             return;
@@ -169,20 +85,6 @@ export class Capture {
             return;
         this.cookies.push(parseSetCookie(value));
     }
-    /**
-     * Produce the {@link CapturedFields} snapshot.
-     *
-     * @param totalMs - Wall-clock duration of the whole invocation, in
-     *   milliseconds. Stored in {@link TimingInfo.totalMs}.
-     *
-     * Optional fields obey the design's "include flags applied at the
-     * adapter, not at the builder" principle: this method always emits
-     * every field it observed, including `tls` (when `isHttps=true` and a
-     * handshake was captured). The fetch handler in `fetch.ts` is
-     * responsible for honouring `includeTls` / `includeTiming` /
-     * `includeRedirectChain` by stripping fields from the assembled
-     * {@link WebFetchMetadata} *after* this snapshot is produced.
-     */
     finalize(totalMs) {
         const timing = {
             dnsMs: this.dnsMs,
@@ -208,14 +110,6 @@ export class Capture {
         return fields;
     }
 }
-// ---------------------------------------------------------------------------
-// Internals
-// ---------------------------------------------------------------------------
-/**
- * Coerce an arbitrary millisecond value into a non-negative finite
- * integer. Used to keep timing arithmetic resilient to clock skew or
- * non-numeric inputs from a stubbed transport.
- */
 function sanitiseMs(ms) {
     if (typeof ms !== "number" || !Number.isFinite(ms))
         return 0;
@@ -245,21 +139,10 @@ function normaliseHeaders(raw) {
     }
     return out;
 }
-/**
- * Pull the TLS session details we surface from the leaf certificate.
- *
- * `getCipher()` returns `null` for sessions that have not completed the
- * handshake — defensive `?? ""` keeps the field present rather than
- * throwing when fed a half-initialised socket from a test stub.
- */
 function extractTlsInfo(socket) {
     const protocol = socket.getProtocol() ?? "";
     const cipherInfo = socket.getCipher();
     const cipher = cipherInfo?.name ?? "";
-    // `getPeerCertificate(true)` returns the detailed certificate object
-    // including the DER `raw` bytes we need for the SHA-256 fingerprint.
-    // Some test stubs return a plain object lacking `raw`; we guard for
-    // that with a typeof check below.
     const cert = socket.getPeerCertificate(true);
     const subjectCN = pickCN(cert?.subject?.CN);
     const issuerCN = pickCN(cert?.issuer?.CN);
@@ -278,11 +161,6 @@ function extractTlsInfo(socket) {
         fingerprintSha256,
     };
 }
-/**
- * `tls.Certificate.CN` is typed as `string | string[] | undefined`.
- * When multiple CN values are present, we take the first to keep the
- * field shape simple; SAN expansion already covers the multi-name case.
- */
 function pickCN(cn) {
     if (typeof cn === "string")
         return cn;
@@ -291,14 +169,6 @@ function pickCN(cn) {
     }
     return "";
 }
-/**
- * Parse `cert.subjectaltname` (the comma-separated string emitted by
- * Node's `getPeerCertificate`, e.g. `"DNS:example.com, IP Address:1.2.3.4"`)
- * into a string array. The type prefix (`DNS:`, `IP Address:`, `URI:`,
- * `email:`) is preserved so callers retain SAN-type information.
- *
- * Empty / undefined input yields an empty array.
- */
 function parseSubjectAltName(san) {
     if (typeof san !== "string" || san.length === 0)
         return [];
@@ -307,12 +177,6 @@ function parseSubjectAltName(san) {
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
-/**
- * Convert a certificate `valid_from`/`valid_to` date string (which uses
- * the OpenSSL `MMM DD HH:mm:ss YYYY GMT` format) into ISO 8601. Falls
- * back to the raw input when parsing fails so the field remains useful
- * for forensic review even if the format is unexpected.
- */
 function isoFromCertDate(value) {
     if (typeof value !== "string" || value.length === 0)
         return "";
@@ -321,15 +185,6 @@ function isoFromCertDate(value) {
         return value;
     return new Date(ms).toISOString();
 }
-/**
- * Compute the SHA-256 digest of the certificate's DER bytes via
- * `node:crypto` and format it as a lowercase, colon-separated hex
- * string (`"ab:cd:ef:..."`), matching the `cert.fingerprint256` shape
- * Node exposes for SHA-1 digests.
- *
- * Returns `""` when `raw` is missing or not a Buffer-like value (e.g. a
- * test stub that omitted the field).
- */
 function computeSha256Fingerprint(raw) {
     if (raw === undefined || raw === null)
         return "";
@@ -344,9 +199,6 @@ function computeSha256Fingerprint(raw) {
         return "";
     }
     const hex = createHash("sha256").update(bytes).digest("hex");
-    // Pair-up the hex string into colon-separated bytes: `abcdef…` →
-    // `ab:cd:ef:…`. The regex match is bounded by the deterministic
-    // 64-char output of SHA-256 so there is no unbounded work here.
     const pairs = hex.match(/.{2}/g) ?? [];
     return pairs.join(":");
 }

package/dist/tools/web/capture.js.map

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

package/dist/tools/web/decode.d.ts

@@ -2,16 +2,8 @@ import { Buffer } from "node:buffer";
 export type CharsetSource = "content-type" | "html-meta" | "default" | "fallback";
 export interface DecodedText {
     text: string;
-    /** Canonical encoding name reported by TextDecoder. */
     charset: string;
     charsetSource: CharsetSource;
-    /** Original unsupported label when UTF-8 fallback was required. */
     unsupportedCharset?: string;
 }
-/**
- * Decode a textual HTTP body without silently corrupting legacy encodings.
- * Content-Type wins; HTML meta declarations are a fallback; UTF-8 is the
- * standards-compatible default. Invalid/unsupported labels fall back to
- * UTF-8 with replacement and are reported to the caller.
- */
 export declare function decodeTextBody(body: Buffer | Uint8Array, contentType?: string): DecodedText;

package/dist/tools/web/decode.js

@@ -3,12 +3,6 @@ const HTML_CONTENT_TYPE_RE = /^(?:text\/html|application\/xhtml\+xml)\b/i;
 const CONTENT_TYPE_CHARSET_RE = /(?:^|;)\s*charset\s*=\s*["']?([^;\s"']+)/i;
 const META_CHARSET_RE = /<meta\b[^>]*\bcharset\s*=\s*["']?([^\s"'/>;]+)/i;
 const META_HTTP_EQUIV_RE = /<meta\b[^>]*\bcontent\s*=\s*["'][^"']*charset\s*=\s*([^\s;"']+)/i;
-/**
- * Decode a textual HTTP body without silently corrupting legacy encodings.
- * Content-Type wins; HTML meta declarations are a fallback; UTF-8 is the
- * standards-compatible default. Invalid/unsupported labels fall back to
- * UTF-8 with replacement and are reported to the caller.
- */
 export function decodeTextBody(body, contentType) {
     const bytes = Buffer.isBuffer(body) ? body : Buffer.from(body);
     const declared = charsetFromContentType(contentType);
@@ -55,9 +49,6 @@ function looksLikeHtml(body, contentType) {
     return /<!doctype\s+html|<html\b|<head\b|<meta\b/i.test(probe);
 }
 function charsetFromHtmlMeta(body) {
-    // Charset declarations are ASCII-compatible and are required near the
-    // document start. latin1 gives a byte-preserving probe without first
-    // assuming the very encoding we are trying to discover.
     const probe = body.subarray(0, 8_192).toString("latin1");
     return probe.match(META_CHARSET_RE)?.[1]?.trim()
         ?? probe.match(META_HTTP_EQUIV_RE)?.[1]?.trim();

package/dist/tools/web/decode.js.map

@@ -1 +1 @@
-{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/tools/web/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC,MAAM,oBAAoB,GAAG,4CAA4C,CAAC;AAC1E,MAAM,uBAAuB,GAAG,2CAA2C,CAAC;AAC5E,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAC1E,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAyB,EACzB,WAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GACZ,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC;QACzD,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAC5B,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,SAAS,GAAG,QAAQ,IAAI,QAAQ,IAAI,OAAO,CAAC;IAClD,MAAM,MAAM,GAAkB,QAAQ;QACpC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,QAAQ;YACR,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM;SACtB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,aAAa,EAAE,UAAU;YACzB,kBAAkB,EAAE,SAAS;SAC9B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,WAA+B;IAC7D,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACzD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,WAA+B;IAClE,IAAI,WAAW,IAAI,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,WAAW,IAAI,CAAC,+CAA+C,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,2CAA2C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,sEAAsE;IACtE,qEAAqE;IACrE,wDAAwD;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;WAC3C,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../../src/tools/web/decode.ts"],"names":[],"mappings":"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"}

package/dist/tools/web/fetch-core.d.ts

@@ -1,41 +1,11 @@
-/**
- * `web.fetch` core orchestration: validate → resolve + pin DNS → SSRF-check
- * → fetch (following redirects) → classify body → assemble metadata.
- * `src/tools/web/fetch.ts` wraps this in a `ToolResult` adapter and
- * audit-log emitter; this module never touches the registry, the safety
- * classifier, or `auditLog`. All transport calls are injectable via
- * {@link WebFetchCoreOptions} so tests can stub the network deterministically.
- */
-import { lookup as defaultDnsLookup } from "node:dns/promises";
-import type { ClientRequest, IncomingMessage, RequestOptions } from "node:http";
 import { type WebFetchArgs, type WebFetchErrorKind, type WebFetchOutcome } from "./types.js";
-/** Signature of `node:dns/promises.lookup`. */
-export type DnsLookupFn = typeof defaultDnsLookup;
-/** Signature of `node:http.request` (the overload accepting URL + options). */
-export type HttpRequestFn = (url: string | URL, options: RequestOptions, callback?: (res: IncomingMessage) => void) => ClientRequest;
-/** Signature of `node:https.request` (same shape as {@link HttpRequestFn}). */
-export type HttpsRequestFn = HttpRequestFn;
-/**
- * Injection points for {@link webFetchCore}. Each defaults to the
- * corresponding `node:` built-in so production code does not need to
- * supply anything; tests stub these to drive the pipeline without
- * touching the network.
- */
+import { DnsLookupFn, HttpRequestFn, HttpsRequestFn } from "./request-loop.js";
+export type { DnsLookupFn, HttpRequestFn, HttpsRequestFn } from "./request-loop.js";
 export interface WebFetchCoreOptions {
-    /** HTTPS transport. Defaults to `https.request`. */
     httpsRequest?: HttpsRequestFn;
-    /** HTTP transport. Defaults to `http.request`. */
     httpRequest?: HttpRequestFn;
-    /** DNS resolver. Defaults to `dns/promises.lookup`. */
     dnsLookup?: DnsLookupFn;
-    /** Wall-clock source for timing fields. Defaults to `Date.now`. */
     now?: () => number;
-    /**
-     * Caller abort (turn cancel / stall watchdog). When aborted, the
-     * in-flight hop is torn down immediately — without this, Esc/Ctrl+C
-     * and the stall watchdog could leave `web.fetch` hung until its own
-     * 30s timer fired (or forever if a socket ignored that timer).
-     */
     signal?: AbortSignal;
 }
 /**