@descryy/runtime-external-service-observation 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/collector-version.d.ts

@@ -1,10 +1,3 @@
-/**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
- */
+/** `Evidence.collectorVersion` for this package's collectors. Read from `package.json`, not hand-duplicated, so it can't drift from what shipped. */
 export declare const COLLECTOR_VERSION: string;
 //# sourceMappingURL=collector-version.d.ts.map

package/dist/collector-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}
+{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA,qJAAqJ;AAMrJ,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}

package/dist/collector-version.js

@@ -1,11 +1,4 @@
-/**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
- */
+/** `Evidence.collectorVersion` for this package's collectors. Read from `package.json`, not hand-duplicated, so it can't drift from what shipped. */
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 export const COLLECTOR_VERSION = require("../package.json").version;

package/dist/collector-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}
+{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA,qJAAqJ;AAErJ,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}

package/dist/fetch-instrumentation.d.ts

@@ -1,61 +1,36 @@
 /**
  * `--import`-loaded preload: patches `globalThis.fetch` before the target
- * application's own code runs, so every real outbound call the application
- * issues through the bare global `fetch` is observed — proven directly (a
- * probe script, not assumed): Node's global `fetch` is a single, mutable
- * binding on `globalThis`, so a `--import` preload reassigning it here and
- * an application's completely independent, later call to bare `fetch(...)`
- * resolve to the same function. Same singleton-timing argument
- * `sqlite-instrumentation.ts` (`@descryy/runtime-database-observation`,
- * RT-141) already established for `node:sqlite`'s prototype, applied to a
- * different kind of global.
+ * application's code runs, so every outbound call through the bare global
+ * is observed. Node's global `fetch` is a single mutable binding on
+ * `globalThis`, so a preload reassigning it and a later app call resolve to
+ * the same function — same singleton-timing argument as
+ * `sqlite-instrumentation.ts` (RT-141), applied to a different global.
  *
- * **Read, not write.** The wrapper calls the original `fetch` with the
- * exact, untouched arguments it received — nothing about what leaves the
- * process changes. Request/response bodies are never read here: `status`
- * comes off the resolved `Response` before any body access, and describing
- * the outbound request (`method`/`url`/headers) is done via the same
- * `Request`/`Headers` normalisation `fetch` itself would do, on a
- * side channel, not by touching the body stream passed to the real call.
+ * Read, not write: the wrapper calls the original `fetch` with untouched
+ * arguments. Bodies are never read — `status` comes off the resolved
+ * `Response` before any body access.
  *
- * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` and
- * `test-runner`'s own `reporter.ts` — this runs inside the OBSERVED process,
- * loaded by absolute path via `node --import`, never through this package's
- * normal dependency graph. Interpretation (service identity, correlation
- * ids) happens on the collector side, in the observing process, not here —
- * this only captures.
+ * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` —
+ * runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * **The call-site stack is captured here and nowhere else.** It is the one
- * fact only this process can supply: by the time the marker line reaches a
- * collector it is text on a pipe, which is exactly why
- * `ExternalRequestCollector` reported `stackTrace: null` for as long as this
- * preload captured none. `observe_runtime`'s own header records the
- * consequence — a backend-only run "resolves both kinds of node and writes no
- * edge", because an edge needs a caller and an endpoint named by ONE
- * observation and this one named only the endpoint. Capturing the stack at
- * the call site is what makes an outbound call able to name its own caller.
+ * The call-site stack is captured here and nowhere else — it's the one
+ * fact only this process can supply (by the time the marker reaches a
+ * collector it's just text on a pipe). Capturing it here is what makes an
+ * outbound call able to name its own caller. Raw text, deliberately
+ * unparsed — parsing V8's format belongs in the observing process
+ * (`@descryy/runtime-adapter-typescript`).
  *
- * Raw text, deliberately unparsed. Parsing V8's format is
- * `@descryy/runtime-adapter-typescript`'s job and belongs in the observing
- * process, the same read-here/interpret-there split every marker in this
- * repository already uses.
+ * Cost: `new Error()` on every outbound call, in a process that opted into
+ * observation by loading this preload. `Error.stackTraceLimit` is left as
+ * the app set it — raising it would mean writing to the observed process's
+ * own config.
  *
- * The cost, stated rather than discovered: `new Error()` on every outbound
- * call. That is a stack capture per request in a process that has opted into
- * being observed by loading this preload; `Error.stackTraceLimit` is left
- * exactly as the application set it, because raising it would be this file
- * writing to the observed process's own configuration, which the paragraph
- * above forbids.
- *
- * The marker prefix and the captured shape live in `request-marker.ts`, not
- * here: this module has a module-scope effect and nothing that merely needs
- * the vocabulary may be made to import it. See that file for the measurement
- * behind that rule.
- *
- * One line of structured JSON per request, prefixed exactly like
- * `sqlite-instrumentation.ts`'s own `DESCRY_DB_QUERY {json}` convention,
- * itself following the benchmark harness's `BENCH_RESULT {json}` precedent
- * (RT-072): scraping prose measures the prose, so nothing here is prose.
+ * Marker prefix and shape live in `request-marker.ts`, not here, since this
+ * module has a module-scope effect. One line of structured JSON per
+ * request, matching `sqlite-instrumentation.ts`'s `DESCRY_DB_QUERY {json}`
+ * convention (RT-072): scraping prose measures the prose.
  */
 export {};
 //# sourceMappingURL=fetch-instrumentation.d.ts.map

package/dist/fetch-instrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-instrumentation.d.ts","sourceRoot":"","sources":["../src/fetch-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG"}
+{"version":3,"file":"fetch-instrumentation.d.ts","sourceRoot":"","sources":["../src/fetch-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}

package/dist/fetch-instrumentation.js

@@ -1,75 +1,47 @@
 /**
  * `--import`-loaded preload: patches `globalThis.fetch` before the target
- * application's own code runs, so every real outbound call the application
- * issues through the bare global `fetch` is observed — proven directly (a
- * probe script, not assumed): Node's global `fetch` is a single, mutable
- * binding on `globalThis`, so a `--import` preload reassigning it here and
- * an application's completely independent, later call to bare `fetch(...)`
- * resolve to the same function. Same singleton-timing argument
- * `sqlite-instrumentation.ts` (`@descryy/runtime-database-observation`,
- * RT-141) already established for `node:sqlite`'s prototype, applied to a
- * different kind of global.
+ * application's code runs, so every outbound call through the bare global
+ * is observed. Node's global `fetch` is a single mutable binding on
+ * `globalThis`, so a preload reassigning it and a later app call resolve to
+ * the same function — same singleton-timing argument as
+ * `sqlite-instrumentation.ts` (RT-141), applied to a different global.
  *
- * **Read, not write.** The wrapper calls the original `fetch` with the
- * exact, untouched arguments it received — nothing about what leaves the
- * process changes. Request/response bodies are never read here: `status`
- * comes off the resolved `Response` before any body access, and describing
- * the outbound request (`method`/`url`/headers) is done via the same
- * `Request`/`Headers` normalisation `fetch` itself would do, on a
- * side channel, not by touching the body stream passed to the real call.
+ * Read, not write: the wrapper calls the original `fetch` with untouched
+ * arguments. Bodies are never read — `status` comes off the resolved
+ * `Response` before any body access.
  *
- * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` and
- * `test-runner`'s own `reporter.ts` — this runs inside the OBSERVED process,
- * loaded by absolute path via `node --import`, never through this package's
- * normal dependency graph. Interpretation (service identity, correlation
- * ids) happens on the collector side, in the observing process, not here —
- * this only captures.
+ * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` —
+ * runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * **The call-site stack is captured here and nowhere else.** It is the one
- * fact only this process can supply: by the time the marker line reaches a
- * collector it is text on a pipe, which is exactly why
- * `ExternalRequestCollector` reported `stackTrace: null` for as long as this
- * preload captured none. `observe_runtime`'s own header records the
- * consequence — a backend-only run "resolves both kinds of node and writes no
- * edge", because an edge needs a caller and an endpoint named by ONE
- * observation and this one named only the endpoint. Capturing the stack at
- * the call site is what makes an outbound call able to name its own caller.
+ * The call-site stack is captured here and nowhere else — it's the one
+ * fact only this process can supply (by the time the marker reaches a
+ * collector it's just text on a pipe). Capturing it here is what makes an
+ * outbound call able to name its own caller. Raw text, deliberately
+ * unparsed — parsing V8's format belongs in the observing process
+ * (`@descryy/runtime-adapter-typescript`).
  *
- * Raw text, deliberately unparsed. Parsing V8's format is
- * `@descryy/runtime-adapter-typescript`'s job and belongs in the observing
- * process, the same read-here/interpret-there split every marker in this
- * repository already uses.
+ * Cost: `new Error()` on every outbound call, in a process that opted into
+ * observation by loading this preload. `Error.stackTraceLimit` is left as
+ * the app set it — raising it would mean writing to the observed process's
+ * own config.
  *
- * The cost, stated rather than discovered: `new Error()` on every outbound
- * call. That is a stack capture per request in a process that has opted into
- * being observed by loading this preload; `Error.stackTraceLimit` is left
- * exactly as the application set it, because raising it would be this file
- * writing to the observed process's own configuration, which the paragraph
- * above forbids.
- *
- * The marker prefix and the captured shape live in `request-marker.ts`, not
- * here: this module has a module-scope effect and nothing that merely needs
- * the vocabulary may be made to import it. See that file for the measurement
- * behind that rule.
- *
- * One line of structured JSON per request, prefixed exactly like
- * `sqlite-instrumentation.ts`'s own `DESCRY_DB_QUERY {json}` convention,
- * itself following the benchmark harness's `BENCH_RESULT {json}` precedent
- * (RT-072): scraping prose measures the prose, so nothing here is prose.
+ * Marker prefix and shape live in `request-marker.ts`, not here, since this
+ * module has a module-scope effect. One line of structured JSON per
+ * request, matching `sqlite-instrumentation.ts`'s `DESCRY_DB_QUERY {json}`
+ * convention (RT-072): scraping prose measures the prose.
  */
-import { REQUEST_MARKER } from "./request-marker.js";
-/** This module's own location, in both shapes a V8 frame can print it: an ESM frame stringifies a `file://` URL, a CJS one a plain path. */
+import { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER } from "./request-marker.js";
+/** This module's own location, in both shapes a V8 frame prints it: ESM stringifies a `file://` URL, CJS a plain path. */
 const SELF_URL = import.meta.url;
 const SELF_PATH = SELF_URL.startsWith("file://") ? SELF_URL.slice("file://".length) : SELF_URL;
 /**
- * Frames belonging to this file are dropped **by file, not by count**.
- * `primaryFrameIndex` is 0 for every V8 stack this project parses, so a
- * single surviving wrapper frame would make every downstream resolution
- * point at the instrumentation instead of at the code under observation --
- * a failure that produces confident, well-formed, entirely wrong answers
- * rather than an error. Matching on `import.meta.url` also survives this
- * module being loaded from `.js` (the compiled preload, how it actually
- * runs) or `.ts` (type stripping, how a test may run it).
+ * Frames from this file are dropped **by file, not by count** — a
+ * surviving wrapper frame would make every downstream resolution point at
+ * the instrumentation instead of the observed code (`primaryFrameIndex` is
+ * 0 for every V8 stack this project parses). Matching `import.meta.url`
+ * survives this being loaded as `.js` (real) or `.ts` (test).
  */
 function callSiteStack() {
     const raw = new Error().stack;
@@ -78,8 +50,8 @@ function callSiteStack() {
     const lines = raw.split("\n");
     const header = lines[0] ?? "Error";
     const frames = lines.slice(1).filter((line) => !line.includes(SELF_URL) && !line.includes(SELF_PATH));
-    // Nothing but our own frames: no application call site was captured, which
-    // is `null` rather than a header line pretending to be a stack.
+    // Nothing but our own frames: `null` rather than a header line pretending
+    // to be a stack.
     if (frames.length === 0)
         return null;
     return [header, ...frames].join("\n");
@@ -93,12 +65,7 @@ function headersToObject(headers) {
         out[name] = value;
     return out;
 }
-/**
- * `url`/`method`/`requestHeaders` off the call's own arguments, without
- * touching the body -- a `Request` object already carries these structured;
- * a `(input, init)` pair is normalised the same way `fetch` itself would,
- * via the real `Headers` constructor rather than hand-parsed.
- */
+/** `url`/`method`/`requestHeaders` off the call's own arguments, without touching the body. Normalised via the real `Headers` constructor, not hand-parsed. */
 function describeRequest(input, init) {
     if (input instanceof Request) {
         return { url: input.url, method: input.method, requestHeaders: headersToObject(input.headers) };
@@ -107,31 +74,38 @@ function describeRequest(input, init) {
     const method = (init?.method ?? "GET").toUpperCase();
     return { url, method, requestHeaders: headersToObject(new Headers(init?.headers)) };
 }
-// Guards against double-patching if this module is somehow loaded twice
-// (e.g. both `--import` and a transitive re-import) -- the second pass
-// would otherwise wrap an already-wrapped fetch and double-emit. Same
-// guard shape as sqlite-instrumentation.ts's own PATCHED symbol.
+// Guards against double-patching if loaded twice (double-emit otherwise).
+// Same guard shape as sqlite-instrumentation.ts's PATCHED symbol.
 const PATCHED = Symbol.for("descry.external-service-observation.fetch-patched");
 const target = globalThis;
 if (target[PATCHED] !== true) {
     target[PATCHED] = true;
     const original = globalThis.fetch;
-    globalThis.fetch = async function patchedFetch(input, init) {
-        const described = describeRequest(input, init);
-        // Captured BEFORE the call, not in the handlers below: after `await` the
-        // application's own frames are gone from the stack.
-        const stack = callSiteStack();
-        const start = performance.now();
-        try {
-            const response = await original(input, init);
-            emit({ ...described, status: response.status, durationMs: performance.now() - start, success: true, error: null, stack });
-            return response;
-        }
-        catch (error) {
-            const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-            emit({ ...described, status: null, durationMs: performance.now() - start, success: false, error: detail, stack });
-            throw error;
-        }
-    };
+    // C-F6: previously unchecked — `original` could be `undefined` (old Node,
+    // `--no-experimental-fetch`), and every real call would then throw
+    // "original is not a function", indistinguishable from a real network
+    // error. Disclosed here instead via a distinct marker line; the wrapper
+    // is never installed.
+    if (typeof original !== "function") {
+        process.stdout.write(`${FETCH_BINDING_FAILURE_MARKER} ${JSON.stringify({ reason: `globalThis.fetch was ${typeof original}, not a function -- no real fetch to instrument` })}\n`);
+    }
+    else {
+        globalThis.fetch = async function patchedFetch(input, init) {
+            const described = describeRequest(input, init);
+            // Captured BEFORE the call: after `await` the app's frames are gone.
+            const stack = callSiteStack();
+            const start = performance.now();
+            try {
+                const response = await original(input, init);
+                emit({ ...described, status: response.status, durationMs: performance.now() - start, success: true, error: null, stack });
+                return response;
+            }
+            catch (error) {
+                const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+                emit({ ...described, status: null, durationMs: performance.now() - start, success: false, error: detail, stack });
+                throw error;
+            }
+        };
+    }
 }
 //# sourceMappingURL=fetch-instrumentation.js.map

package/dist/fetch-instrumentation.js.map

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

package/dist/header-correlation.d.ts

@@ -1,18 +1,11 @@
 /**
- * Correlation-id extraction from real HTTP headers — the same mechanism and
- * the same closed set of header names as `extractHeaderCorrelationIds`
- * (`@descryhq-wq/runtime-browser`'s `network-correlation.ts`).
+ * Correlation-id extraction from real HTTP headers — same mechanism and
+ * header names as `@descryy/runtime-browser`'s `network-correlation.ts`.
  *
- * **Duplicated on purpose, not imported.** `browser` depends on Playwright
- * to launch and drive a real browser — a real, heavy dependency this
- * package has no other reason to carry, for a page-automation concern
- * entirely unrelated to instrumenting a backend process's own outbound
- * `fetch`. The function itself is small, pure, and reads a closed,
- * unlikely-to-change set of conventional header names — the case this
- * project's own `symbol.ts` distinguishes from (`toRepoRelative` is
- * *shared* because its two callers must translate identically); these two
- * copies have no such constraint, and importing across a Playwright
- * dependency to avoid ten lines would be the worse coupling.
+ * Duplicated on purpose, not imported: `browser` depends on Playwright, a
+ * heavy dependency this package has no other reason to carry. The function
+ * is small, pure, and reads a closed set of header names — importing across
+ * Playwright to avoid ten lines would be the worse coupling.
  */
 export interface HeaderCorrelationIds {
     readonly traceId: string | null;

package/dist/header-correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header-correlation.d.ts","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}
+{"version":3,"file":"header-correlation.d.ts","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}

package/dist/header-correlation.js

@@ -1,18 +1,11 @@
 /**
- * Correlation-id extraction from real HTTP headers — the same mechanism and
- * the same closed set of header names as `extractHeaderCorrelationIds`
- * (`@descryhq-wq/runtime-browser`'s `network-correlation.ts`).
+ * Correlation-id extraction from real HTTP headers — same mechanism and
+ * header names as `@descryy/runtime-browser`'s `network-correlation.ts`.
  *
- * **Duplicated on purpose, not imported.** `browser` depends on Playwright
- * to launch and drive a real browser — a real, heavy dependency this
- * package has no other reason to carry, for a page-automation concern
- * entirely unrelated to instrumenting a backend process's own outbound
- * `fetch`. The function itself is small, pure, and reads a closed,
- * unlikely-to-change set of conventional header names — the case this
- * project's own `symbol.ts` distinguishes from (`toRepoRelative` is
- * *shared* because its two callers must translate identically); these two
- * copies have no such constraint, and importing across a Playwright
- * dependency to avoid ten lines would be the worse coupling.
+ * Duplicated on purpose, not imported: `browser` depends on Playwright, a
+ * heavy dependency this package has no other reason to carry. The function
+ * is small, pure, and reads a closed set of header names — importing across
+ * Playwright to avoid ten lines would be the worse coupling.
  */
 const TRACEPARENT_PATTERN = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;
 function firstHeader(headers, names) {

package/dist/header-correlation.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-correlation.js","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"header-correlation.js","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { REQUEST_MARKER, type CapturedRequest } from "./request-marker.ts";
-export { parseRequestLine } from "./request-line-parser.ts";
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER, type CapturedRequest } from "./request-marker.ts";
+export { parseRequestLine, parseFetchBindingFailureLine } from "./request-line-parser.ts";
 export { extractServiceIdentity } from "./service-identity.ts";
 export { extractHeaderCorrelationIds, type HeaderCorrelationIds } from "./header-correlation.ts";
 export type { ExternalRequestCollectorOptions } from "./request-collector.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,YAAY,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,YAAY,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,11 +1,9 @@
-// Deliberately NOT from `fetch-instrumentation.ts`: that module replaces
-// `globalThis.fetch` at module scope, and re-exporting a constant out of it
-// put that patch into every consumer of this package -- `query-marker.ts`'s
-// measured defect, which this package still had. The preload is loaded by
-// absolute path via `node --import`, inside the observed process, never
-// through this dependency graph.
-export { REQUEST_MARKER } from "./request-marker.js";
-export { parseRequestLine } from "./request-line-parser.js";
+// Deliberately NOT from `fetch-instrumentation.ts` — that module patches
+// `globalThis.fetch` at module scope; re-exporting from it would leak the
+// patch into every consumer (`query-marker.ts`'s measured defect). The
+// preload loads by absolute path via `node --import`, never through here.
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER } from "./request-marker.js";
+export { parseRequestLine, parseFetchBindingFailureLine } from "./request-line-parser.js";
 export { extractServiceIdentity } from "./service-identity.js";
 export { extractHeaderCorrelationIds } from "./header-correlation.js";
 export { createExternalRequestCollector, FETCH_PRELOAD_MODULE_PATH } from "./request-collector.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAA6B,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAwB,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAA6B,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/request-collector.d.ts

@@ -1,57 +1,34 @@
 /**
- * `ExternalRequestCollector` (plan §18 / checklist §18): translates
- * `fetch-instrumentation.ts`'s captured requests into `EXTERNAL_REQUEST`
- * Evidence. Same shape as `DatabaseQueryCollector`
- * (`@descryy/runtime-database-observation`, RT-141) deliberately — a
- * `ProcessOutputSource` in, `Evidence` out, streaming-first, a collector
- * failure reported as evidence rather than swallowed — but for a different
- * marker on the same stream.
+ * `ExternalRequestCollector`: translates `fetch-instrumentation.ts`'s
+ * captured requests into `EXTERNAL_REQUEST` Evidence. Same shape as
+ * `DatabaseQueryCollector` (RT-141) — `ProcessOutputSource` in, `Evidence`
+ * out, failures reported as evidence — for a different marker on the same
+ * stream.
  *
- * **What this collector does not do, named rather than silently absent:**
- * no request/response body capture (the preload never reads either stream —
- * see `fetch-instrumentation.ts`'s own "read, not write" note), no
- * provider classification beyond a request's own hostname
- * (`service-identity.ts`), and `graphNodeId` is always null — no resolver
- * from a captured hostname to any graph node exists (nothing in the 15
- * canonical node types names an external service). All real §18 rows, left
- * open rather than guessed at, matching `DatabaseQueryCollector`'s own
- * disclosure of the same shape of gap.
+ * Does NOT: capture request/response bodies (preload never reads either
+ * stream), classify providers beyond hostname (`service-identity.ts`), or
+ * set `graphNodeId` (no resolver from a hostname to any of the 15 canonical
+ * node types exists). Disclosed gaps, matching `DatabaseQueryCollector`'s own.
  *
- * ## The call-site stack, and why the parser is injected
- *
- * `stackTrace` used to be hard-null here, and `observe_runtime`'s own header
- * gave the reason: *"it parses a log line the application printed and a
- * printed line carries no stack."* The line is this package's own marker and
- * the preload that writes it runs inside the calling process, so the stack
- * was always available — nobody had captured it. It is captured now
- * (`fetch-instrumentation.ts`), and this collector attaches it.
- *
- * Parsing it is **not** this package's job. V8's `Error.stack` format is one
- * language's, and this collector observes the marker protocol, which is not.
- * So a `StackTraceParser` is an option, supplied by whoever knows which
- * runtime is being observed — `RuntimeAdapter.stackTraceParser` is exactly
- * that value, already on the seam. Omitted, this collector behaves exactly as
- * it did before the capture existed and **says so** in `capabilities()`:
- * `stackCapture: unavailable`, with the reason. A half-wired capability that
- * quietly reports nothing is the failure mode this project's honest-
- * degradation rule exists to prevent.
+ * `stackTrace` is parsed via an injected `StackTraceParser` — parsing V8's
+ * format is not this package's job, so the observed runtime's own parser
+ * (`RuntimeAdapter.stackTraceParser`) is supplied by the caller. Omitted,
+ * `capabilities()` reports `stackCapture: unavailable` with the reason
+ * rather than silently reporting nothing.
  */
 import type { Collector } from "@descryy/runtime-contracts";
 import type { ProcessOutputSource, StackTraceParser } from "@descryy/runtime-backend-observation";
-/** Absolute path to the compiled preload, for a caller building `node --import <this> <app>`. Never imported directly -- loaded by Node itself, in the observed process, before that process's own code runs. */
+/** Absolute path to the compiled preload, for `node --import <this> <app>`. Never imported directly — loaded by Node in the observed process. */
 export declare const FETCH_PRELOAD_MODULE_PATH: string;
 export interface ExternalRequestCollectorOptions {
     readonly source: ProcessOutputSource;
-    /** Which owned system this collector's evidence should be attributed to (plan §16.7). Null when not applicable. */
+    /** Which owned system this evidence should be attributed to. Null when not applicable. */
     readonly service?: string;
     /**
-     * The observed runtime's own stack parser — `RuntimeAdapter.stackTraceParser`.
-     * Supplied by a caller that knows which language it launched; this package
-     * knows no language and must not (the IR boundary rule, one layer down).
-     *
-     * Omitted means captured stacks are not parsed and `stackTrace` stays
-     * `null`, which `capabilities()` reports as `stackCapture: unavailable`
-     * rather than leaving a reader to infer it from an absence.
+     * The observed runtime's own stack parser (`RuntimeAdapter.stackTraceParser`)
+     * — this package knows no language and must not (IR boundary rule).
+     * Omitted means `stackTrace` stays `null`, reported by `capabilities()`
+     * as `stackCapture: unavailable` rather than left to infer.
      */
     readonly stackTraceParser?: StackTraceParser;
 }

package/dist/request-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-collector.d.ts","sourceRoot":"","sources":["../src/request-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAE,SAAS,EAA+F,MAAM,4BAA4B,CAAC;AACzJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAOlG,iNAAiN;AACjN,eAAO,MAAM,yBAAyB,QAAwE,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAmCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CA+GlG"}
+{"version":3,"file":"request-collector.d.ts","sourceRoot":"","sources":["../src/request-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAA+F,MAAM,4BAA4B,CAAC;AACzJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAOlG,iJAAiJ;AACjJ,eAAO,MAAM,yBAAyB,QAAwE,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAgCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAqJlG"}

package/dist/request-collector.js

@@ -1,47 +1,27 @@
 /**
- * `ExternalRequestCollector` (plan §18 / checklist §18): translates
- * `fetch-instrumentation.ts`'s captured requests into `EXTERNAL_REQUEST`
- * Evidence. Same shape as `DatabaseQueryCollector`
- * (`@descryy/runtime-database-observation`, RT-141) deliberately — a
- * `ProcessOutputSource` in, `Evidence` out, streaming-first, a collector
- * failure reported as evidence rather than swallowed — but for a different
- * marker on the same stream.
+ * `ExternalRequestCollector`: translates `fetch-instrumentation.ts`'s
+ * captured requests into `EXTERNAL_REQUEST` Evidence. Same shape as
+ * `DatabaseQueryCollector` (RT-141) — `ProcessOutputSource` in, `Evidence`
+ * out, failures reported as evidence — for a different marker on the same
+ * stream.
  *
- * **What this collector does not do, named rather than silently absent:**
- * no request/response body capture (the preload never reads either stream —
- * see `fetch-instrumentation.ts`'s own "read, not write" note), no
- * provider classification beyond a request's own hostname
- * (`service-identity.ts`), and `graphNodeId` is always null — no resolver
- * from a captured hostname to any graph node exists (nothing in the 15
- * canonical node types names an external service). All real §18 rows, left
- * open rather than guessed at, matching `DatabaseQueryCollector`'s own
- * disclosure of the same shape of gap.
+ * Does NOT: capture request/response bodies (preload never reads either
+ * stream), classify providers beyond hostname (`service-identity.ts`), or
+ * set `graphNodeId` (no resolver from a hostname to any of the 15 canonical
+ * node types exists). Disclosed gaps, matching `DatabaseQueryCollector`'s own.
  *
- * ## The call-site stack, and why the parser is injected
- *
- * `stackTrace` used to be hard-null here, and `observe_runtime`'s own header
- * gave the reason: *"it parses a log line the application printed and a
- * printed line carries no stack."* The line is this package's own marker and
- * the preload that writes it runs inside the calling process, so the stack
- * was always available — nobody had captured it. It is captured now
- * (`fetch-instrumentation.ts`), and this collector attaches it.
- *
- * Parsing it is **not** this package's job. V8's `Error.stack` format is one
- * language's, and this collector observes the marker protocol, which is not.
- * So a `StackTraceParser` is an option, supplied by whoever knows which
- * runtime is being observed — `RuntimeAdapter.stackTraceParser` is exactly
- * that value, already on the seam. Omitted, this collector behaves exactly as
- * it did before the capture existed and **says so** in `capabilities()`:
- * `stackCapture: unavailable`, with the reason. A half-wired capability that
- * quietly reports nothing is the failure mode this project's honest-
- * degradation rule exists to prevent.
+ * `stackTrace` is parsed via an injected `StackTraceParser` — parsing V8's
+ * format is not this package's job, so the observed runtime's own parser
+ * (`RuntimeAdapter.stackTraceParser`) is supplied by the caller. Omitted,
+ * `capabilities()` reports `stackCapture: unavailable` with the reason
+ * rather than silently reporting nothing.
  */
 import { fileURLToPath } from "node:url";
-import { parseRequestLine } from "./request-line-parser.js";
+import { parseRequestLine, parseFetchBindingFailureLine } from "./request-line-parser.js";
 import { extractServiceIdentity } from "./service-identity.js";
 import { extractHeaderCorrelationIds } from "./header-correlation.js";
 import { COLLECTOR_VERSION } from "./collector-version.js";
-/** Absolute path to the compiled preload, for a caller building `node --import <this> <app>`. Never imported directly -- loaded by Node itself, in the observed process, before that process's own code runs. */
+/** Absolute path to the compiled preload, for `node --import <this> <app>`. Never imported directly — loaded by Node in the observed process. */
 export const FETCH_PRELOAD_MODULE_PATH = fileURLToPath(new URL("./fetch-instrumentation.js", import.meta.url));
 const EVENT_TYPE = "EXTERNAL_REQUEST";
 function computeCapabilities(hasStackParser) {
@@ -52,15 +32,12 @@ function computeCapabilities(hasStackParser) {
         consoleObservation: status,
         networkObservation: status,
         backendLogAccess: status,
-        // Real HTTP headers, structurally read (Headers/Request, not text
-        // parsed) -- the same mechanism and the same claim strength
-        // BrowserNetworkCollector already makes for its own captured requests.
+        // Real HTTP headers, structurally read (Headers/Request), same claim
+        // strength BrowserNetworkCollector makes for its own captured requests.
         distributedTrace: { availability: "available", reason: null },
         sourceMapping: status,
-        // Real: the preload captures the application's own stack at the fetch
-        // call site, in the observed process, before the call leaves it. Claimed
-        // only when a parser was actually supplied to turn it into frames --
-        // capturing text nothing can read is not a capability.
+        // Claimed only when a parser was actually supplied — capturing text
+        // nothing can read is not a capability.
         stackCapture: hasStackParser
             ? { availability: "available", reason: null }
             : {
@@ -77,12 +54,11 @@ export function createExternalRequestCollector(options) {
     const capabilities = computeCapabilities(options.stackTraceParser !== undefined);
     let consumeLoopDone;
     let consumptionFailure = null;
-    /**
-     * `null` for every honest reason it can be: nothing captured, no parser
-     * supplied, or a parser that refused the text outright. A parser's `null`
-     * is its own contract ("not recognizable as this parser's format, never a
-     * best-effort guess") and is passed through rather than softened.
-     */
+    // C-F6: set once FETCH_BINDING_FAILURE_MARKER is seen — the preload found
+    // no real `globalThis.fetch`, so no call was ever observed. Before this,
+    // capabilities() kept reporting "available" regardless.
+    let bindingFailure = null;
+    /** `null` for nothing captured, no parser, or a parser that refused the text — passed through rather than softened. */
     async function parseStack(request) {
         if (request.stack === null || options.stackTraceParser === undefined)
             return null;
@@ -94,7 +70,7 @@ export function createExternalRequestCollector(options) {
         context.emit({
             timestamp: new Date().toISOString(),
             source: "backend-process",
-            service: options.service ?? null,
+            service: options.source.serviceName ?? options.service ?? null,
             process: options.source.processId,
             eventType: EVENT_TYPE,
             payload: {
@@ -110,20 +86,47 @@ export function createExternalRequestCollector(options) {
             traceId,
             requestId,
             correlationId: null,
-            // No resolver from a captured hostname to a graph node exists --
-            // none of the 15 canonical node types names an external service.
+            // No resolver from a hostname to a graph node exists — none of the
+            // 15 canonical node types names an external service.
             graphNodeId: null,
             sourceLocation: null,
             stackTrace,
-            // The observation itself (a real captured call, real timing, real
-            // status/failure) is not probabilistic.
-            confidence: 1,
+            confidence: 1, // a real captured call, real timing — not probabilistic
+            redactionStatus: "pending-redaction",
+            collectorVersion: COLLECTOR_VERSION,
+        });
+    }
+    function emitBindingFailure(reason, context) {
+        bindingFailure = reason;
+        context.emit({
+            timestamp: new Date().toISOString(),
+            source: "backend-process",
+            service: options.source.serviceName ?? options.service ?? null,
+            process: options.source.processId,
+            eventType: "COLLECTOR_ERROR",
+            payload: {
+                raw: `external request collector for process "${options.source.processId}": the fetch preload could not bind -- ${reason}. No outbound call in this process can be observed.`,
+                collectorId: `external-request-collector:${options.source.processId}`,
+                error: reason,
+            },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1, // our own failure to bind, not an inference about the app
             redactionStatus: "pending-redaction",
             collectorVersion: COLLECTOR_VERSION,
         });
     }
     async function consume(context) {
         for await (const line of options.source.lines) {
+            const binding = parseFetchBindingFailureLine(line.text);
+            if (binding !== null) {
+                emitBindingFailure(binding.reason, context);
+                continue;
+            }
             const request = parseRequestLine(line.text);
             if (request !== null)
                 await emitCapturedRequest(request, context);
@@ -139,7 +142,7 @@ export function createExternalRequestCollector(options) {
                     context.emit({
                         timestamp: new Date().toISOString(),
                         source: "backend-process",
-                        service: options.service ?? null,
+                        service: options.source.serviceName ?? options.service ?? null,
                         process: options.source.processId,
                         eventType: "COLLECTOR_ERROR",
                         payload: {
@@ -168,6 +171,17 @@ export function createExternalRequestCollector(options) {
             await consumeLoopDone;
         },
         capabilities() {
+            // Binding failure takes priority — externalServiceObservation was
+            // never real for this process, worse than "stopped early" below.
+            if (bindingFailure !== null) {
+                return {
+                    ...capabilities,
+                    externalServiceObservation: {
+                        availability: "unavailable",
+                        reason: `the fetch preload never bound a real globalThis.fetch (${bindingFailure}) -- no outbound call in this process was observed.`,
+                    },
+                };
+            }
             if (consumptionFailure === null)
                 return capabilities;
             return {

package/dist/request-collector.js.map

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

package/dist/request-line-parser.d.ts

@@ -1,22 +1,25 @@
 /**
- * Reads one process-output line for the `REQUEST_MARKER` prefix.
- *
- * The marker comes from `request-marker.ts`, never from
- * `fetch-instrumentation.ts` — importing the emitter to get a string would
- * patch the parsing process's own `globalThis.fetch`. See `request-marker.ts`
- * for the measurement. Everything else — the application's own real
- * stdout/stderr — is not this parser's concern and is left alone; an
- * external-request collector does not also try to be a log collector.
+ * Reads one process-output line for the `REQUEST_MARKER` prefix. The
+ * marker comes from `request-marker.ts`, never `fetch-instrumentation.ts`
+ * — importing the emitter would patch the parsing process's own fetch.
+ * Everything else (the app's real stdout/stderr) is left alone.
  */
-import { REQUEST_MARKER, type CapturedRequest } from "./request-marker.ts";
+import { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER, type CapturedRequest } from "./request-marker.ts";
 /**
- * `null` for a non-matching line (ordinary application output) AND for a
- * line that starts with the marker but fails to parse as one of this
- * package's own captured requests — a malformed marker line is refused,
- * never guessed at, the same distinction `parseQueryLine`
- * (`@descryy/runtime-database-observation`) makes.
+ * `null` for a non-matching line AND for a marker-prefixed line that fails
+ * to parse — malformed is refused, never guessed at, same as
+ * `parseQueryLine` (`@descryy/runtime-database-observation`).
  */
 export declare function parseRequestLine(line: string): CapturedRequest | null;
+/**
+ * C-F6: recognises the preload's disclosure that it found no real
+ * `globalThis.fetch`. `null` for every other line. A malformed line past
+ * the marker prefix still counts as a binding failure (the marker itself is
+ * the fact that matters) with a generic reason substituted.
+ */
+export declare function parseFetchBindingFailureLine(line: string): {
+    readonly reason: string;
+} | null;
 export type { CapturedRequest };
-export { REQUEST_MARKER };
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER };
 //# sourceMappingURL=request-line-parser.d.ts.map

package/dist/request-line-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-line-parser.d.ts","sourceRoot":"","sources":["../src/request-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAsB3E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAcrE;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"request-line-parser.d.ts","sourceRoot":"","sources":["../src/request-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAmBzG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAarE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS7F;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/request-line-parser.js

@@ -1,14 +1,10 @@
 /**
- * Reads one process-output line for the `REQUEST_MARKER` prefix.
- *
- * The marker comes from `request-marker.ts`, never from
- * `fetch-instrumentation.ts` — importing the emitter to get a string would
- * patch the parsing process's own `globalThis.fetch`. See `request-marker.ts`
- * for the measurement. Everything else — the application's own real
- * stdout/stderr — is not this parser's concern and is left alone; an
- * external-request collector does not also try to be a log collector.
+ * Reads one process-output line for the `REQUEST_MARKER` prefix. The
+ * marker comes from `request-marker.ts`, never `fetch-instrumentation.ts`
+ * — importing the emitter would patch the parsing process's own fetch.
+ * Everything else (the app's real stdout/stderr) is left alone.
  */
-import { REQUEST_MARKER } from "./request-marker.js";
+import { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER } from "./request-marker.js";
 function isCapturedRequest(value) {
     if (typeof value !== "object" || value === null)
         return false;
@@ -23,22 +19,17 @@ function isCapturedRequest(value) {
         return false;
     if (typeof v.requestHeaders !== "object" || v.requestHeaders === null)
         return false;
-    // `stack` is the one field allowed to be absent. A marker line written by a
-    // preload from before call-site capture existed is a well-formed line that
-    // genuinely carries no stack -- normalised to `null` below, which is what
-    // "no stack was captured" already means everywhere downstream. Anything
-    // present but not a string is malformed and refused, same as every other
-    // field here.
+    // `stack` is the one field allowed to be absent (a pre-capture marker
+    // line genuinely carries none) — normalised to `null` below. Present but
+    // not a string is malformed and refused like every other field.
     if (v.stack !== undefined && v.stack !== null && typeof v.stack !== "string")
         return false;
     return Object.values(v.requestHeaders).every((value) => typeof value === "string");
 }
 /**
- * `null` for a non-matching line (ordinary application output) AND for a
- * line that starts with the marker but fails to parse as one of this
- * package's own captured requests — a malformed marker line is refused,
- * never guessed at, the same distinction `parseQueryLine`
- * (`@descryy/runtime-database-observation`) makes.
+ * `null` for a non-matching line AND for a marker-prefixed line that fails
+ * to parse — malformed is refused, never guessed at, same as
+ * `parseQueryLine` (`@descryy/runtime-database-observation`).
  */
 export function parseRequestLine(line) {
     if (!line.startsWith(`${REQUEST_MARKER} `))
@@ -53,10 +44,27 @@ export function parseRequestLine(line) {
     }
     if (!isCapturedRequest(parsed))
         return null;
-    // Absent `stack` becomes an explicit `null` so no consumer has to
-    // distinguish "the field was missing" from "nothing was captured" -- they
-    // are the same fact and only one of them is representable downstream.
+    // Absent `stack` becomes explicit `null` — "missing" and "not captured"
+    // are the same fact downstream.
     return { ...parsed, stack: parsed.stack ?? null };
 }
-export { REQUEST_MARKER };
+/**
+ * C-F6: recognises the preload's disclosure that it found no real
+ * `globalThis.fetch`. `null` for every other line. A malformed line past
+ * the marker prefix still counts as a binding failure (the marker itself is
+ * the fact that matters) with a generic reason substituted.
+ */
+export function parseFetchBindingFailureLine(line) {
+    if (!line.startsWith(`${FETCH_BINDING_FAILURE_MARKER} `))
+        return null;
+    const json = line.slice(FETCH_BINDING_FAILURE_MARKER.length + 1);
+    try {
+        const parsed = JSON.parse(json);
+        return { reason: typeof parsed.reason === "string" ? parsed.reason : "no real globalThis.fetch was found to instrument" };
+    }
+    catch {
+        return { reason: "no real globalThis.fetch was found to instrument" };
+    }
+}
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER };
 //# sourceMappingURL=request-line-parser.js.map

package/dist/request-line-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-line-parser.js","sourceRoot":"","sources":["../src/request-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAI3E,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrF,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpF,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,wEAAwE;IACxE,yEAAyE;IACzE,cAAc;IACd,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,cAAyC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAChH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,kEAAkE;IAClE,0EAA0E;IAC1E,sEAAsE;IACtE,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"request-line-parser.js","sourceRoot":"","sources":["../src/request-line-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAwB,MAAM,qBAAqB,CAAC;AAIzG,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrF,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClE,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,cAAc,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpF,sEAAsE;IACtE,yEAAyE;IACzE,gEAAgE;IAChE,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,cAAyC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAChH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,cAAc,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,wEAAwE;IACxE,gCAAgC;IAChC,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,4BAA4B,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;QACxD,OAAO,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,kDAAkD,EAAE,CAAC;IAC5H,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,kDAAkD,EAAE,CAAC;IACxE,CAAC;AACH,CAAC;AAGD,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/request-marker.d.ts

@@ -1,50 +1,37 @@
 /**
- * The wire vocabulary shared by the two halves of external-service
- * observation: the marker prefix and the shape that follows it.
- *
- * This module exists to be **free of side effects**, and that is its entire
- * job. `fetch-instrumentation.ts` — the other holder of these names until now
- * — replaces `globalThis.fetch` at module scope and writes to stdout, which
- * is right for a `--import` preload inside an observed process and wrong
- * everywhere else. `request-line-parser.ts` needed nothing from it but the
- * string `"DESCRY_EXTERNAL_REQUEST"`, and importing a string is still
- * importing a module: the patch and the stdout writer came along, through the
- * package index, into every consumer.
- *
- * **This is `query-marker.ts`'s defect, one package over, and it was still
- * open.** `@descryy/runtime-database-observation` found the identical shape,
- * measured it into `@descryy/mcp`'s JSON-RPC transport — 14,906 marker lines
- * in one `analyze` call — and carved the vocabulary out. Nothing did the same
- * here, and nothing noticed, because nothing outside this repository imports
- * this package yet. `observe_runtime` consuming this collector is precisely
- * the change that would have noticed.
- *
- * So: the emitter imports the vocabulary, the parser imports the vocabulary,
- * and neither imports the other. Anything added here must stay a constant or
- * a type. A function with a module-scope effect would rebuild the same trap
- * one file over.
+ * The wire vocabulary shared by both halves of external-service observation:
+ * marker prefix + shape. Must stay free of side effects — a function with a
+ * module-scope effect (like `fetch-instrumentation.ts`'s fetch patch) would
+ * leak into every consumer that only needs the vocabulary. This is
+ * `query-marker.ts`'s defect (measured: 14,906 marker lines through
+ * `@descryy/mcp`'s JSON-RPC transport in one `analyze` call), carved out
+ * here before anything hit it the same way.
  */
 export declare const REQUEST_MARKER = "DESCRY_EXTERNAL_REQUEST";
+/**
+ * C-F6: written once, by `fetch-instrumentation.ts`, when `globalThis.fetch`
+ * wasn't a real function at preload time — a distinct line from
+ * `REQUEST_MARKER`, since nothing was actually observed. Without this, a
+ * missing real `fetch` would surface as an ordinary failure indistinguishable
+ * from a real network error, and `capabilities()` would claim "available"
+ * when zero calls were ever seen.
+ */
+export declare const FETCH_BINDING_FAILURE_MARKER = "DESCRY_EXTERNAL_REQUEST_FETCH_BINDING_FAILED";
 export interface CapturedRequest {
     readonly url: string;
     readonly method: string;
     readonly requestHeaders: Readonly<Record<string, string>>;
-    /** `null` only when `success` is `false` -- the call never resolved to a response at all. */
+    /** `null` only when `success` is `false` — the call never resolved to a response. */
     readonly status: number | null;
     readonly durationMs: number;
-    /** `true` iff `fetch` resolved rather than threw. An HTTP error status (4xx/5xx) is still `success: true` -- fetch itself does not reject on one. */
+    /** `true` iff `fetch` resolved rather than threw. A 4xx/5xx status is still `success: true` — fetch doesn't reject on one. */
     readonly success: boolean;
     readonly error: string | null;
     /**
-     * The **application's** own stack at the moment it called `fetch`, raw and
-     * unparsed, with the preload's own wrapper frames removed. `null` when the
-     * runtime produced no stack at all, or when nothing but the preload's own
-     * frames was in it.
-     *
-     * Raw text on purpose: parsing V8's format is
-     * `@descryy/runtime-adapter-typescript`'s job and belongs in the observing
-     * process, the same read-here/interpret-there split every marker in this
-     * repository already uses.
+     * The application's own stack at the `fetch` call, raw and unparsed, with
+     * the preload's wrapper frames removed. `null` if the runtime produced no
+     * stack. Raw text on purpose — parsing V8's format belongs in the
+     * observing process (`@descryy/runtime-adapter-typescript`), not here.
      */
     readonly stack: string | null;
 }

package/dist/request-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-marker.d.ts","sourceRoot":"","sources":["../src/request-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,eAAO,MAAM,cAAc,4BAA8C,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qJAAqJ;IACrJ,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}
+{"version":3,"file":"request-marker.d.ts","sourceRoot":"","sources":["../src/request-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,eAAO,MAAM,cAAc,4BAA8C,CAAC;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,iDAAmE,CAAC;AAE7G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8HAA8H;IAC9H,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/request-marker.js

@@ -1,32 +1,23 @@
 /**
- * The wire vocabulary shared by the two halves of external-service
- * observation: the marker prefix and the shape that follows it.
- *
- * This module exists to be **free of side effects**, and that is its entire
- * job. `fetch-instrumentation.ts` — the other holder of these names until now
- * — replaces `globalThis.fetch` at module scope and writes to stdout, which
- * is right for a `--import` preload inside an observed process and wrong
- * everywhere else. `request-line-parser.ts` needed nothing from it but the
- * string `"DESCRY_EXTERNAL_REQUEST"`, and importing a string is still
- * importing a module: the patch and the stdout writer came along, through the
- * package index, into every consumer.
- *
- * **This is `query-marker.ts`'s defect, one package over, and it was still
- * open.** `@descryy/runtime-database-observation` found the identical shape,
- * measured it into `@descryy/mcp`'s JSON-RPC transport — 14,906 marker lines
- * in one `analyze` call — and carved the vocabulary out. Nothing did the same
- * here, and nothing noticed, because nothing outside this repository imports
- * this package yet. `observe_runtime` consuming this collector is precisely
- * the change that would have noticed.
- *
- * So: the emitter imports the vocabulary, the parser imports the vocabulary,
- * and neither imports the other. Anything added here must stay a constant or
- * a type. A function with a module-scope effect would rebuild the same trap
- * one file over.
+ * The wire vocabulary shared by both halves of external-service observation:
+ * marker prefix + shape. Must stay free of side effects — a function with a
+ * module-scope effect (like `fetch-instrumentation.ts`'s fetch patch) would
+ * leak into every consumer that only needs the vocabulary. This is
+ * `query-marker.ts`'s defect (measured: 14,906 marker lines through
+ * `@descryy/mcp`'s JSON-RPC transport in one `analyze` call), carved out
+ * here before anything hit it the same way.
  */
 import { RESERVED_MARKER_PREFIX } from "@descryy/runtime-contracts";
-// Derived, not spelled again: `RESERVED_MARKER_PREFIX` is what the
-// backend log collector skips on, so a marker that did not use it would
-// come back as the application's own log output.
+// Derived from `RESERVED_MARKER_PREFIX`, which the backend log collector
+// skips on — a marker not using it would look like app log output.
 export const REQUEST_MARKER = `${RESERVED_MARKER_PREFIX}EXTERNAL_REQUEST`;
+/**
+ * C-F6: written once, by `fetch-instrumentation.ts`, when `globalThis.fetch`
+ * wasn't a real function at preload time — a distinct line from
+ * `REQUEST_MARKER`, since nothing was actually observed. Without this, a
+ * missing real `fetch` would surface as an ordinary failure indistinguishable
+ * from a real network error, and `capabilities()` would claim "available"
+ * when zero calls were ever seen.
+ */
+export const FETCH_BINDING_FAILURE_MARKER = `${RESERVED_MARKER_PREFIX}EXTERNAL_REQUEST_FETCH_BINDING_FAILED`;
 //# sourceMappingURL=request-marker.js.map

package/dist/request-marker.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-marker.js","sourceRoot":"","sources":["../src/request-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,mEAAmE;AACnE,wEAAwE;AACxE,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,sBAAsB,kBAAkB,CAAC"}
+{"version":3,"file":"request-marker.js","sourceRoot":"","sources":["../src/request-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,yEAAyE;AACzE,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,sBAAsB,kBAAkB,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,sBAAsB,uCAAuC,CAAC"}

package/dist/service-identity.d.ts

@@ -1,21 +1,9 @@
 /**
- * A captured request's "service identity" — the checklist's §18 own
- * `service identity` row — is its URL's hostname, and nothing more.
- *
- * **Declared, never inferred.** This does not attempt to recognise "this
- * hostname is Stripe" or classify a call into `authentication provider` /
- * `payment provider` / etc. (§18's own "Potential integrations" list) —
- * that would be a lookup table of well-known hosts this project has no
- * source of truth for, guessed rather than read off anything the
- * application declared. The hostname is a real, observed fact; a provider
- * label would not be. If a consumer wants a friendlier name for a known
- * host, that is a later, disclosed classification step layered on top of
- * this, not something this function silently does.
- *
- * `null` for a URL that does not parse — refused rather than guessed, the
- * same shape `extractTargetTable`
- * (`@descryy/runtime-database-observation`) refuses a SQL statement it does
- * not recognise.
+ * A captured request's "service identity" is its URL's hostname, nothing
+ * more. Never classified into "Stripe" / "payment provider" etc — no
+ * source of truth for that, and a guessed label isn't an observed fact.
+ * `null` for a URL that doesn't parse — refused rather than guessed, same
+ * as `extractTargetTable` (`@descryy/runtime-database-observation`).
  */
 export declare function extractServiceIdentity(url: string): string | null;
 //# sourceMappingURL=service-identity.d.ts.map

package/dist/service-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-identity.d.ts","sourceRoot":"","sources":["../src/service-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE"}
+{"version":3,"file":"service-identity.d.ts","sourceRoot":"","sources":["../src/service-identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE"}

package/dist/service-identity.js

@@ -1,21 +1,9 @@
 /**
- * A captured request's "service identity" — the checklist's §18 own
- * `service identity` row — is its URL's hostname, and nothing more.
- *
- * **Declared, never inferred.** This does not attempt to recognise "this
- * hostname is Stripe" or classify a call into `authentication provider` /
- * `payment provider` / etc. (§18's own "Potential integrations" list) —
- * that would be a lookup table of well-known hosts this project has no
- * source of truth for, guessed rather than read off anything the
- * application declared. The hostname is a real, observed fact; a provider
- * label would not be. If a consumer wants a friendlier name for a known
- * host, that is a later, disclosed classification step layered on top of
- * this, not something this function silently does.
- *
- * `null` for a URL that does not parse — refused rather than guessed, the
- * same shape `extractTargetTable`
- * (`@descryy/runtime-database-observation`) refuses a SQL statement it does
- * not recognise.
+ * A captured request's "service identity" is its URL's hostname, nothing
+ * more. Never classified into "Stripe" / "payment provider" etc — no
+ * source of truth for that, and a guessed label isn't an observed fact.
+ * `null` for a URL that doesn't parse — refused rather than guessed, same
+ * as `extractTargetTable` (`@descryy/runtime-database-observation`).
  */
 export function extractServiceIdentity(url) {
     try {

package/dist/service-identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-identity.js","sourceRoot":"","sources":["../src/service-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"service-identity.js","sourceRoot":"","sources":["../src/service-identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@descryy/runtime-external-service-observation",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
-  "description": "External service observation (plan §18, checklist §18): real EXTERNAL_REQUEST capture via client instrumentation, never parsed application logs. Client #1 is the global fetch.",
+  "description": "External service observation (plan \u00a718, checklist \u00a718): real EXTERNAL_REQUEST capture via client instrumentation, never parsed application logs. Client #1 is the global fetch.",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descryhq-wq/descry-runtime.git",
+    "directory": "packages/external-service-observation"
+  },
   "engines": {
     "node": ">=22.5"
   },
@@ -24,8 +29,8 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.1.0",
-    "@descryy/runtime-backend-observation": "0.1.0"
+    "@descryy/runtime-contracts": "0.3.0",
+    "@descryy/runtime-backend-observation": "0.3.0"
   },
   "devDependencies": {
     "@descryy/runtime-controller": "*",