@astrasyncai/verification-gateway 3.2.1 → 3.4.0

package/dist/index.mjs

@@ -126,7 +126,7 @@ function getCapabilities(accessLevel) {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.2.1";
+var SDK_VERSION = "3.3.0";
 
 // src/well-known.ts
 var CACHE_TTL_MS = 60 * 60 * 1e3;
@@ -544,7 +544,9 @@ async function verify(config, request) {
       // linking key (the sessionId-equivalent for anonymous callers).
       correlationId: apiResponse.correlationId,
       recommendation: apiResponse.recommendation,
-      recommendationReasons: apiResponse.recommendationReasons
+      recommendationReasons: apiResponse.recommendationReasons,
+      stepUpApproval: apiResponse.stepUpApproval,
+      settlement: apiResponse.settlement
     };
     return result2;
   }
@@ -596,7 +598,9 @@ async function verify(config, request) {
     tokenGuidance: apiResponse.tokenGuidance,
     recommendation: apiResponse.recommendation,
     recommendationReasons: apiResponse.recommendationReasons,
-    warningHeader: apiResponse.warningHeader
+    warningHeader: apiResponse.warningHeader,
+    stepUpApproval: apiResponse.stepUpApproval,
+    settlement: apiResponse.settlement
   };
   if (result.recommendation === "deny") {
     result.policyAllowed = false;
@@ -676,6 +680,68 @@ async function quickVerify(config, credentials) {
   };
 }
 
+// src/adapters/approval-gate.ts
+var APPROVAL_REASON = "Transaction is above the autonomous limit and requires human approval. The agent owner can approve or deny this transaction in the AstraSync dashboard.";
+function requiresHumanApproval(result) {
+  return result.requiresStepUp === true || result.requiresApproval === true;
+}
+function annotateApprovalRequired(result) {
+  result.failures = [
+    ...result.failures ?? [],
+    { dimension: "commerce.intent.approval_required", message: APPROVAL_REASON }
+  ];
+  result.denialReasons = [APPROVAL_REASON, ...result.denialReasons ?? []];
+}
+
+// src/settlement.ts
+async function authorizeSettlement(config, req) {
+  if (typeof req.value !== "number" || !Number.isFinite(req.value) || req.value <= 0) {
+    return {
+      authorized: false,
+      recommendation: "deny",
+      reason: "No valid transaction value supplied to authorizeSettlement; settlement refused (fail-closed). Pass the merchant-priced cart total as `value`.",
+      failures: [
+        {
+          dimension: "commerce.settlement.value_missing",
+          message: "A positive, authoritative transaction value is required to authorize settlement."
+        }
+      ]
+    };
+  }
+  let result;
+  try {
+    result = await verify(config, {
+      credentials: { astraId: req.agentId },
+      purpose: req.purpose ?? "shopping",
+      action: req.action ?? "shopping.purchase",
+      transactionValue: req.value,
+      currency: req.currency
+    });
+  } catch (err) {
+    return {
+      authorized: false,
+      recommendation: "deny",
+      reason: `Settlement verification failed (${err instanceof Error ? err.message : String(err)}); settlement refused (fail-closed).`,
+      failures: [
+        {
+          dimension: "commerce.settlement.verify_error",
+          message: "verify-access could not be reached or returned an error; settlement is refused."
+        }
+      ]
+    };
+  }
+  const recommendation = result.recommendation;
+  const authorized = result.identityVerified === true && result.policyAllowed === true && !requiresHumanApproval(result) && (recommendation === void 0 || recommendation === "grant");
+  return {
+    authorized,
+    recommendation,
+    reason: authorized ? void 0 : result.denialReasons?.[0] ?? (requiresHumanApproval(result) ? "Transaction is above the autonomous limit and requires human approval; settlement cannot be authorized automatically." : "Settlement not authorized by the agent's PDLSS limits."),
+    failures: result.failures,
+    correlationId: result.correlationId,
+    stepUpApproval: requiresHumanApproval(result) ? result.stepUpApproval : void 0
+  };
+}
+
 // src/adapters/express.ts
 var express_exports = {};
 __export(express_exports, {
@@ -832,19 +898,6 @@ function resolveHttpPdlss(input) {
   return { purpose, action, purposeSource, actionSource };
 }
 
-// src/adapters/approval-gate.ts
-var APPROVAL_REASON = "Transaction is above the autonomous limit and requires human approval, which is not yet available \u2014 it cannot be completed automatically.";
-function requiresHumanApproval(result) {
-  return result.requiresStepUp === true || result.requiresApproval === true;
-}
-function annotateApprovalRequired(result) {
-  result.failures = [
-    ...result.failures ?? [],
-    { dimension: "commerce.intent.approval_required", message: APPROVAL_REASON }
-  ];
-  result.denialReasons = [APPROVAL_REASON, ...result.denialReasons ?? []];
-}
-
 // src/pdlss-pre-check.ts
 function performCounterpartyPreCheck(routeConfig, astraCreds, purpose) {
   const failures = [];
@@ -972,7 +1025,8 @@ function defaultOnDenied(result, _req, res) {
       guidance: result.guidance,
       // Round-10: aggregated per-dimension detail + correlation handle.
       failures: result.failures,
-      correlationId: result.correlationId
+      correlationId: result.correlationId,
+      stepUpApproval: result.stepUpApproval
     }
   });
 }
@@ -1622,7 +1676,8 @@ function createMiddleware2(options) {
               code: !result.identityVerified ? "UNAUTHORIZED" : "POLICY_DENIED",
               message: result.denialReasons?.[0] || "Access denied",
               guidance: result.guidance,
-              failures: result.failures
+              failures: result.failures,
+              stepUpApproval: result.stepUpApproval
             }
           },
           { status: !result.identityVerified ? 401 : 403 }
@@ -4525,7 +4580,8 @@ function defaultMcpDenied(result, req, res) {
         guidance: result.guidance,
         // Round-10: aggregated per-dimension detail + correlation handle.
         failures: result.failures,
-        correlationId: result.correlationId
+        correlationId: result.correlationId,
+        stepUpApproval: result.stepUpApproval
       }
     }
   });
@@ -5453,7 +5509,7 @@ async function recordDecision2(config, params) {
 }
 
 // src/index.ts
-var VERSION = "2.0.0";
+var VERSION = "3.4.0";
 export {
   ACCESS_LEVEL_DESCRIPTIONS,
   ACCESS_LEVEL_HIERARCHY,
@@ -5470,6 +5526,7 @@ export {
   TRUST_LEVEL_RANGES,
   VERSION,
   agent_exports as agent,
+  authorizeSettlement,
   buildGuidance,
   clearCache,
   createMcpMiddleware,