@descryy/runtime-external-service-observation 0.2.0 → 0.3.1

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,24 +54,23 @@ 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;
         return await options.stackTraceParser.parse(request.stack);
     }
-    async function emitCapturedRequest(request, context) {
+    async function emitCapturedRequest(request, context, preExisting) {
         const { traceId, requestId } = extractHeaderCorrelationIds(request.requestHeaders);
         const stackTrace = await parseStack(request);
         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,23 +86,54 @@ 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,
+            // RT-N3: this capture came from a line the source itself marked as
+            // pre-existing (e.g. an attach-mode target's log content from before
+            // attach) -- see `ProcessOutputLine.preExisting`.
+            ...(preExisting ? { preExisting: true } : {}),
+        });
+    }
+    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);
+                await emitCapturedRequest(request, context, line.preExisting === true);
         }
     }
     return {
@@ -139,7 +146,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 +175,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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAwB,MAAM,0BAA0B,CAAC;AAChH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,iJAAiJ;AACjJ,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAe/G,MAAM,UAAU,GAAqB,kBAAkB,CAAC;AAExD,SAAS,mBAAmB,CAAC,cAAuB;IAClD,MAAM,MAAM,GAAG,iEAAiE,CAAC;IACjF,MAAM,MAAM,GAAG,EAAE,YAAY,EAAE,aAAsB,EAAE,MAAM,EAAE,CAAC;IAChE,OAAO;QACL,cAAc,EAAE,MAAM;QACtB,kBAAkB,EAAE,MAAM;QAC1B,kBAAkB,EAAE,MAAM;QAC1B,gBAAgB,EAAE,MAAM;QACxB,qEAAqE;QACrE,wEAAwE;QACxE,gBAAgB,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7D,aAAa,EAAE,MAAM;QACrB,oEAAoE;QACpE,wCAAwC;QACxC,YAAY,EAAE,cAAc;YAC1B,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;YAC7C,CAAC,CAAC;gBACE,YAAY,EAAE,aAAa;gBAC3B,MAAM,EACJ,wGAAwG;oBACxG,mHAAmH;aACtH;QACL,gBAAgB,EAAE,MAAM;QACxB,mBAAmB,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,uHAAuH,EAAE;QACrL,0BAA0B,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAwC;IACrF,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC;IACjF,IAAI,eAA0C,CAAC;IAC/C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,0EAA0E;IAC1E,yEAAyE;IACzE,wDAAwD;IACxD,IAAI,cAAc,GAAkB,IAAI,CAAC;IAEzC,uHAAuH;IACvH,KAAK,UAAU,UAAU,CAAC,OAAwB;QAChD,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAClF,OAAO,MAAM,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,UAAU,mBAAmB,CAAC,OAAwB,EAAE,OAAyB,EAAE,WAAoB;QAC1G,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,2BAA2B,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI;YAC9D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACjC,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE;gBACP,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE;gBACvC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC5C,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB;YACD,OAAO;YACP,SAAS;YACT,aAAa,EAAE,IAAI;YACnB,mEAAmE;YACnE,qDAAqD;YACrD,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,IAAI;YACpB,UAAU;YACV,UAAU,EAAE,CAAC,EAAE,wDAAwD;YACvE,eAAe,EAAE,mBAAmB;YACpC,gBAAgB,EAAE,iBAAiB;YACnC,mEAAmE;YACnE,qEAAqE;YACrE,kDAAkD;YAClD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,OAAyB;QACnE,cAAc,GAAG,MAAM,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI;YAC9D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACjC,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE;gBACP,GAAG,EAAE,2CAA2C,OAAO,CAAC,MAAM,CAAC,SAAS,0CAA0C,MAAM,qDAAqD;gBAC7K,WAAW,EAAE,8BAA8B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;gBACrE,KAAK,EAAE,MAAM;aACd;YACD,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC,EAAE,0DAA0D;YACzE,eAAe,EAAE,mBAAmB;YACpC,gBAAgB,EAAE,iBAAiB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,OAAyB;QAC9C,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,8BAA8B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;QAErE,KAAK,CAAC,OAAyB;YAC7B,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC1D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1F,kBAAkB,GAAG,MAAM,CAAC;gBAC5B,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC;wBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,MAAM,EAAE,iBAAiB;wBACzB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI;wBAC9D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;wBACjC,SAAS,EAAE,iBAAiB;wBAC5B,OAAO,EAAE;4BACP,GAAG,EAAE,2CAA2C,OAAO,CAAC,MAAM,CAAC,SAAS,uCAAuC,MAAM,EAAE;4BACvH,WAAW,EAAE,8BAA8B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;4BACrE,KAAK,EAAE,MAAM;yBACd;wBACD,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,IAAI;wBACf,aAAa,EAAE,IAAI;wBACnB,WAAW,EAAE,IAAI;wBACjB,cAAc,EAAE,IAAI;wBACpB,UAAU,EAAE,IAAI;wBAChB,UAAU,EAAE,CAAC;wBACb,eAAe,EAAE,mBAAmB;wBACpC,gBAAgB,EAAE,iBAAiB;qBACpC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,SAAkB,EAAE,CAAC;oBAC5B,OAAO,CAAC,KAAK,CACX,+BAA+B,OAAO,CAAC,MAAM,CAAC,SAAS,yBAAyB,MAAM,2CAA2C,MAAM,CAAC,SAAS,CAAC,EAAE,CACrJ,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,eAAe,CAAC;QACxB,CAAC;QAED,YAAY;YACV,kEAAkE;YAClE,iEAAiE;YACjE,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,OAAO;oBACL,GAAG,YAAY;oBACf,0BAA0B,EAAE;wBAC1B,YAAY,EAAE,aAAa;wBAC3B,MAAM,EAAE,0DAA0D,cAAc,qDAAqD;qBACtI;iBACF,CAAC;YACJ,CAAC;YACD,IAAI,kBAAkB,KAAK,IAAI;gBAAE,OAAO,YAAY,CAAC;YACrD,OAAO;gBACL,GAAG,YAAY;gBACf,gBAAgB,EAAE;oBAChB,YAAY,EAAE,aAAa;oBAC3B,MAAM,EAAE,6CAA6C,kBAAkB,gDAAgD;iBACxH;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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.2.0",
+  "version": "0.3.1",
   "type": "module",
-  "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.",
+  "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.",
   "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.2.0",
-    "@descryy/runtime-backend-observation": "0.2.0"
+    "@descryy/runtime-contracts": "0.3.1",
+    "@descryy/runtime-backend-observation": "0.3.1"
   },
   "devDependencies": {
     "@descryy/runtime-controller": "*",