@sourcey/catalog-verifier 1.1.25 → 1.1.27

package/dist/modules/agent-readiness-engine/src/records.js

@@ -1,3 +1,4 @@
+import { isAgentReadinessGrpcMediaType, } from "../../../contracts/agent-readiness/src/index.js";
 /**
  * What a sealed exchange record and a run record say without any response
  * body: whether an exchange was answered, a header it kept, and whether a run
@@ -16,13 +17,70 @@ export const RESIDUE_FAILURES = new Set([
     "tls_failure",
     "other",
 ]);
-/** A residue transport failure, 429 or 5xx: residue to retry, never the service's answer. */
+/**
+ * The gRPC statuses that are residue, as a 429 or 5xx is (gRPC's own mapping
+ * to HTTP): unknown, deadline exceeded, resource exhausted, internal,
+ * unavailable and data loss. Unimplemented, which that mapping sends to 501,
+ * is a service's answer that it has no such method.
+ */
+const GRPC_RESIDUE = new Set([2, 4, 8, 13, 14, 15]);
+/**
+ * A residue transport failure, 429 or 5xx, or a gRPC call's like: residue to
+ * retry, never the service's answer. A gRPC call's own status decides it,
+ * whatever its HTTP status; one whose status the exchange could not read is
+ * residue too, never a guess.
+ */
 export function unansweredRecord(record) {
     if (record.outcome !== "responded")
         return RESIDUE_FAILURES.has(record.reason);
+    const grpc = grpcStatus(record);
+    if (grpc !== null)
+        return GRPC_RESIDUE.has(grpc);
+    if (grpcStatusUnread(record))
+        return true;
     const { status } = record.response;
     return status === 429 || status >= 500;
 }
+/**
+ * A gRPC call's status (north star §5.4): an answer under a gRPC media type to
+ * a request that carried a gRPC message, read from the `grpc-status` it sent
+ * before any message, as a refusal does, whatever its HTTP status (a proxy may
+ * refuse with a 403). Null for any other exchange, an answer with no status
+ * there, or a `grpc-status` that is not a status. Only a gRPC call's answer is
+ * read so: a gRPC server answers other requests (a metadata read) under its
+ * media type too.
+ */
+export function grpcStatus(record) {
+    if (!grpcCall(record))
+        return null;
+    const sent = responseHeader(record, "grpc-status");
+    if (sent === null || !/^(?:0|[1-9][0-9]{0,2})$/u.test(sent))
+        return null;
+    // A success is a 2xx; a refusal's HTTP status claiming success is read as HTTP.
+    const status = Number(sent);
+    return status === 0 && !served(record) ? null : status;
+}
+/**
+ * A gRPC call served with no status before its body: the status came after
+ * it, in trailers the exchange does not keep, so the answer is unread (north
+ * star §5.4). Whether a message preceded it says nothing of the status that
+ * followed.
+ */
+function grpcStatusUnread(record) {
+    return grpcCall(record) && served(record) && responseHeader(record, "grpc-status") === null;
+}
+/** An answer under a gRPC media type to a request that carried a gRPC message. */
+function grpcCall(record) {
+    if (record.outcome !== "responded")
+        return false;
+    const { request, response } = record;
+    return (request.body !== null &&
+        isAgentReadinessGrpcMediaType(request.body.media_type) &&
+        isAgentReadinessGrpcMediaType(response.body.media_type));
+}
+function served(record) {
+    return record.response.status >= 200 && record.response.status <= 299;
+}
 /** The exchanges that follow an *authority* answer to the agent's client and consent. */
 const AUTHORITY_CHAIN = new Set([
     "probe_resource_metadata",

package/dist/modules/agent-readiness-engine/src/records.js.map

@@ -1 +1 @@
-{"version":3,"file":"records.js","sourceRoot":"","sources":["../../../../modules/agent-readiness-engine/src/records.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,mBAAmB;IACnB,aAAa;IACb,aAAa;IACb,OAAO;CACR,CAAC,CAAC;AAEH,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW;QAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IACnC,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;AACzC,CAAC;AAED,yFAAyF;AACzF,MAAM,eAAe,GACnB,IAAI,GAAG,CAAC;IACN,yBAAyB;IACzB,4BAA4B;IAC5B,2BAA2B;IAC3B,qBAAqB;CACtB,CAAC,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAoE,EACpE,WAAmB;IAEnB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,YAAY,KAAK,WAAW,CAAC,CAAC;IAClF,IACE,CAAC,KAAK;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY;QACtC,KAAK,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY;QACxC,KAAK,CAAC,IAAI,EAAE,OAAO,KAAK,YAAY;QACpC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,YAAY,CAAC,EACvD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,CACvB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,OAAO,KAAK,WAAW,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CACtF,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,IAAY;IACjE,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAClF,CAAC"}
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../../../modules/agent-readiness-engine/src/records.ts"],"names":[],"mappings":"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"}