@haven_ai/sdk 0.0.0-dev.202609141042.b4fd152 → 0.0.0-dev.202609141609.ad8a780

package/dist/index.cjs

@@ -125,7 +125,23 @@ var AgentPaymentNextAction = {
    * settled to the merchant. The wallet owner should initiate a sweep to
    * return those funds to the originating Safe.
    */
-  SweepStrandedFunds: "sweep_stranded_funds"
+  SweepStrandedFunds: "sweep_stranded_funds",
+  /**
+   * #2970: a `submitted` erc7710 x402 intent whose settlement window has
+   * passed with no on-chain settlement evidence Haven could verify. Distinct
+   * from {@link CheckStatusLater}, which this REPLACES once the window is
+   * past — but it is not futile: Haven's settlement sweep (120s tick) scans
+   * each candidate over its own window plus a 120s clock-skew allowance, so
+   * it can still attribute the settlement for a short while after this value
+   * first appears. Poll {@link CheckStatusLater}'s tool
+   * (`haven_get_payment_status`) once more, roughly two minutes later; if it
+   * still shows no evidence, tell the user the goods were delivered but
+   * Haven holds no verified settlement evidence for this payment. There is
+   * no tool that reports a settlement transaction hash for this scheme —
+   * `haven_report_x402_outcome` takes no hash and refuses a non-`confirmed`
+   * intent.
+   */
+  AwaitingSettlementEvidence: "awaiting_settlement_evidence"
 };
 var AgentPaymentNextActionAccountAlias = {
   /** Account-vocabulary twin of `fund_safe_or_raise_allowance`; same meaning. */
@@ -224,7 +240,8 @@ var AgentPaymentNextActionDescriptions = {
   [AgentPaymentNextAction.PaymentWindowExpired]: "The x402 funding/quote window expired. Re-quote with the same idempotency key before asking the signer to build a merchant payment header again.",
   [AgentPaymentNextAction.FundSafeOrRaiseAllowance]: "Stop and tell the user that the account needs to be funded or the agent budget raised before the payment can succeed.",
   [AgentPaymentNextAction.RetryWithExplicitContext]: "Retry the same tool call, this time passing merchant_url, tool_name, arguments, and mcp_transport explicitly \u2014 the server had no stored context to rehydrate for this payment id.",
-  [AgentPaymentNextAction.SweepStrandedFunds]: "Tell the user that funds may be stranded in the delegate wallet and prompt them to initiate a sweep in Haven to return them to the originating account."
+  [AgentPaymentNextAction.SweepStrandedFunds]: "Tell the user that funds may be stranded in the delegate wallet and prompt them to initiate a sweep in Haven to return them to the originating account.",
+  [AgentPaymentNextAction.AwaitingSettlementEvidence]: "The settlement window passed with no verified on-chain evidence yet. Haven's settlement sweep may still attribute it within about two minutes \u2014 poll getPaymentStatus once more, then tell the user the goods were delivered but unverified if it still shows nothing."
 };
 var AgentPaymentFailureCodeDescriptions = {
   [AgentPaymentFailureCode.PriceExceedsMax]: "The merchant-authoritative x402 amount exceeds the caller's max_amount cap. No funding transfer was created; ask the user before retrying with a larger cap.",
@@ -1116,6 +1133,15 @@ var HavenApiTransport = class {
 };
 
 // src/payment-mappers.ts
+function mapParties(raw) {
+  if (!raw) return void 0;
+  return {
+    treasuryAccount: raw.treasury_account,
+    delegate: raw.delegate,
+    delegateAccount: raw.delegate_account,
+    merchant: raw.merchant
+  };
+}
 function mapPaymentResult(raw, buildExplorerUrl2) {
   return {
     paymentId: raw.payment_id,
@@ -1155,6 +1181,7 @@ function mapPaymentStatusResult(raw) {
     resourceUrl: raw.resource_url,
     merchantAddress: raw.merchant_address,
     payerAddress: raw.payer_address ?? null,
+    parties: mapParties(raw.parties),
     txHash: raw.tx_hash,
     expiresAt: raw.expires_at,
     chainId: raw.chain_id,
@@ -1192,6 +1219,7 @@ function mapPaymentReceipt(raw) {
     resourceUrl: raw.resource_url,
     merchantAddress: raw.merchant_address,
     payerAddress: raw.payer_address,
+    parties: mapParties(raw.parties),
     settlementAddress: raw.settlement_address,
     tokenSymbol: raw.token_symbol,
     tokenAddress: raw.token_address,
@@ -2915,15 +2943,24 @@ var MerchantCompletion = class {
     for (let attempt = 0; ; attempt += 1) {
       try {
         await this.post("/machine-payments/evidence", body);
-        return;
+        return { outcome: "confirmed" };
       } catch (err) {
-        const retryable = err instanceof HavenApiError && err.statusCode === EVIDENCE_RETRYABLE_STATUS;
-        if (!retryable || attempt >= EVIDENCE_RETRY_DELAYS_MS.length) return;
+        const statusCode = err instanceof HavenApiError ? err.statusCode : void 0;
+        const retryable = statusCode === EVIDENCE_RETRYABLE_STATUS;
+        if (!retryable) {
+          return { outcome: "refused", statusCode: statusCode ?? 0 };
+        }
+        if (attempt >= EVIDENCE_RETRY_DELAYS_MS.length) {
+          return { outcome: "retryable", statusCode };
+        }
         await this.sleep(EVIDENCE_RETRY_DELAYS_MS[attempt]);
       }
     }
   }
 };
+function isZeroSettlementTxHash(hash) {
+  return typeof hash === "string" && /^0x0+$/i.test(hash);
+}
 function parseMerchantSettlement(header) {
   if (!header) return {};
   const parsed = parseProtocolReceiptHeader(header);
@@ -3853,6 +3890,7 @@ var HavenClient = class {
     } catch {
       body = text;
     }
+    let evidenceOutcome;
     if (!surfaced.ok) {
       if (!input.noFundingLeg && fundingTxHash) {
         await this.merchantCompletion.recordRetryRejected({
@@ -3872,9 +3910,10 @@ var HavenClient = class {
         });
       }
     } else {
-      const evidenceTxHash = input.noFundingLeg ? settlement.settlementTxHash ?? void 0 : fundingTxHash ?? void 0;
+      const rawEvidenceTxHash = input.noFundingLeg ? settlement.settlementTxHash ?? void 0 : fundingTxHash ?? void 0;
+      const evidenceTxHash = rawEvidenceTxHash && !isZeroSettlementTxHash(rawEvidenceTxHash) ? rawEvidenceTxHash : void 0;
       if (evidenceTxHash) {
-        await this.merchantCompletion.reportEvidence({
+        evidenceOutcome = await this.merchantCompletion.reportEvidence({
           paymentId: evidenceContext.paymentId,
           rail: "x402",
           txHash: evidenceTxHash,
@@ -3892,7 +3931,8 @@ var HavenClient = class {
       status: surfaced.status,
       ok: surfaced.ok,
       body,
-      settlementTxHash: settlement.settlementTxHash ?? void 0
+      settlementTxHash: settlement.settlementTxHash ?? void 0,
+      evidenceOutcome
     };
   }
   /**
@@ -4081,8 +4121,8 @@ var toolDescriptions = {
   // MACHINE-PAYMENT-CHALLENGE was never produced by anything besides the now
   // deleted `/demo/mpp/*` route. Use the x402 fragments above instead.
   getPaymentStatus: {
-    summary: "Fetch structured Haven payment status, including phase and nextAction taxonomy for agent recovery.",
-    behavior: "Accepts a payment intent id and returns the full state taxonomy (phase, nextAction, rail, amount, merchant, resource url, idempotency key, message).",
+    summary: "Fetch structured Haven payment status for agent recovery.",
+    behavior: "State: phase, nextAction, rail, amount, merchant, resource, idempotency, message; parties: treasury/delegate/delegateAccount/merchant. awaiting_settlement_evidence: poll once, else unverified.",
     nextActionGuidance: ""
   },
   getResumeState: {
@@ -4947,6 +4987,7 @@ exports.isErc7710Option = isErc7710Option;
 exports.isFundAccountOrRaiseAllowance = isFundAccountOrRaiseAllowance;
 exports.isSupportedNodeVersion = isSupportedNodeVersion;
 exports.isSweepableChain = isSweepableChain;
+exports.isZeroSettlementTxHash = isZeroSettlementTxHash;
 exports.normalizePaymentRequired = normalizePaymentRequired;
 exports.parsePaymentRequired = parsePaymentRequired;
 exports.parsePaymentRequiredResponse = parsePaymentRequiredResponse;