NAIF Agent Gravity — MCP Diagnostics & Recovery

Previous value: -"Choose exactly one rail offered in quote_repair.paymentRails. Saudi quotes normally offer APPLE_PAY only."New value: +"Choose exactly one id from the descriptors in quote_repair.paymentRails. Saudi quotes normally offer APPLE_PAY only."

Previous value: -"Payment rails offered for this quote; choose exactly one of these in prepare_repair."New value: +"Payment rail descriptors offered for this quote; pass one descriptor id to prepare_repair.rail."

Added value: +true

Added value: +{
+  "id": {
+    "description": "Rail identifier to pass as prepare_repair.rail.",
+    "type": "string"
+  }
+}

Added value: +[
+  "id"
+]

Previous value: -"string"New value: +"object"

Previous value: -"Opaque token returned by the APPLE_PAY_AUTO setup. Do not provide card data or Apple Pay payloads."New value: +"Opaque token returned by the one-time APPLE_PAY_AUTO setup. Supply only a token from this delegated authorization flow; never provide card data or raw Apple Pay payloads."

Previous value: -"Permission to create quote + acceptance + checkout within the stated cap."New value: +"Explicit permission for this tool to create its own quote, accept it, and create checkout within the supplied cap. If a quoteId already exists, use prepare_repair instead."

Previous value: -"Merchant scope authorized by the owner/platform."New value: +"Merchant scope explicitly authorized by the owner/platform for this delegated purchase flow."

Previous value: -"Requested daily APPLE_PAY_AUTO cap during setup; maximum 20 USD."New value: +"Requested daily APPLE_PAY_AUTO cap used only during first-time authorization setup; maximum 20 USD."

Previous value: -"Sanitized bounded work description; never include secrets, credentials or private keys."New value: +"Sanitized bounded work description for the delegated micro-service; never include secrets, credentials or private keys."

Previous value: -"Per-purchase spending cap in USD-equivalent."New value: +"Owner/platform per-purchase spending cap in USD-equivalent. The quote must fit inside this cap and the service launch price."

Previous value: -"Choose APPLE_PAY_AUTO for one-time authorization followed by capped automatic purchases."New value: +"Delegated-purchase rail policy. AUTO chooses an eligible wallet rail; APPLE_PAY_AUTO uses or establishes the capped Tap authorization. This is not the manual rail selection for prepare_repair."

Previous value: -"One of the four delegated-purchase micro-services."New value: +"Exactly one of the four services allowed for delegated purchase. For any other repair service, use diagnose_issue → quote_repair → prepare_repair."

Previous value: -"For wallet rails returns payment instructions. For APPLE_PAY_AUTO, first use returns a one-time humanAuthorizationUrl plus authorizationToken; subsequent use with an ACTIVE token may return PAYMENT_VERIFIED automatically. Provider activation failures fail closed."New value: +"Result of a capped delegated purchase attempt. For wallet rails, success creates and accepts a quote plus checkout and returns PAYMENT_REQUIRED with payer instructions; payment itself remains external. For APPLE_PAY_AUTO, first use may return ONE_TIME_APPLE_PAY_AUTHORIZATION_REQUIRED with human authorization data, while a later call with an ACTIVE authorization token may return provider payment-verification fields. Treat error or a non-confirmed status as not paid. This schema describes the delegated flow only; normal existing-quote repairs use prepare_repair."

Added value: +"APPLE_PAY_AUTO authorization setup/status information, potentially including the one-time human authorization URL/token. Never interpret this object alone as payment success."

Added value: +"True when the delegated quote was automatically accepted under explicit owner/platform authorization."

Added value: +"True when this tool created checkout under the delegation."

Added value: +"False until the existing post-payment workflow has verified payment; this tool does not execute unpaid work."

Added value: +{
+  "description": "False when no verified-payment job has been attached yet.",
+  "type": "boolean"
+}

Added value: +"False for wallet flows and authorization setup; may only become provider-driven within a previously ACTIVE APPLE_PAY_AUTO agreement."

Added value: +"True when this tool created the delegated quote itself."

Added value: +"Checkout created by this delegated call when quote creation/acceptance succeeded."

Added value: +"Echo of the enforced merchant/spending delegation, including cap and whether quote acceptance/checkout creation were authorized."

Added value: +{
+  "description": "Bounded provider/commerce error details when available."
+}

Added value: +"Fail-closed error code when delegation, price, provider authorization, quote, checkout, or payment requirements are not satisfied."

Added value: +{
+  "description": "Repair/delivery job attached by the existing verified-payment workflow when available; may be null."
+}

Added value: +{
+  "description": "For wallet rails, verify_checkout_payment after the payer submits the exact transfer.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "Suggested verification arguments for the wallet checkout; txHash remains caller-supplied after payment.",
+  "type": "object"
+}

Added value: +{
+  "description": "Required human/payer action before payment can be considered complete.",
+  "type": "string"
+}

Added value: +{
+  "description": "Verified payment identifier when returned by the provider flow.",
+  "type": "string"
+}

Added value: +"Wallet transfer instructions for an existing delegated checkout; the tool does not send the transfer."

Added value: +"Rail actually selected for this delegated purchase."

Added value: +"One of the four delegated micro-service product identifiers."

Added value: +"Quote created by this delegated call. It was not supplied by the caller."

Added value: +{
+  "description": "Provider/checkout state when returned.",
+  "type": "string"
+}

Added value: +"Delegated-purchase state such as PAYMENT_REQUIRED, ONE_TIME_APPLE_PAY_AUTHORIZATION_REQUIRED, APPLE_PAY_AUTHORIZATION_NOT_ACTIVE, or a provider payment state."

Added value: +{
+  "description": "When returned by the provider flow, true only for a verified payment.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Opaque token returned by the APPLE_PAY_AUTO setup. Do not provide card data or Apple Pay payloads.",
+  "maxLength": 240,
+  "minLength": 20,
+  "type": "string"
+}

Previous value: -"Explicit permission to create quote + acceptance + checkout within the stated cap; not permission for NAIF to move funds."New value: +"Permission to create quote + acceptance + checkout within the stated cap."

Added value: +{
+  "description": "Requested daily APPLE_PAY_AUTO cap during setup; maximum 20 USD.",
+  "exclusiveMinimum": 0,
+  "maximum": 20,
+  "type": "number"
+}

Previous value: -"Owner/platform per-purchase spending cap in USD-equivalent."New value: +"Per-purchase spending cap in USD-equivalent."

Added value: +{
+  "description": "Choose APPLE_PAY_AUTO for one-time authorization followed by capped automatic purchases.",
+  "enum": [
+    "AUTO",
+    "BASE_USDC",
+    "TRON_USDT",
+    "APPLE_PAY_AUTO"
+  ],
+  "type": "string"
+}

Previous value: -"If eligible, returns PAYMENT_REQUIRED with quoteId, checkoutId and exact wallet payment instructions on BASE_USDC or TRON_USDT. No funds are moved by NAIF."New value: +"For wallet rails returns payment instructions. For APPLE_PAY_AUTO, first use returns a one-time humanAuthorizationUrl plus authorizationToken; subsequent use with an ACTIVE token may return PAYMENT_VERIFIED automatically. Provider activation failures fail closed."

Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}

Removed value: -{
-  "type": "string"
-}

Previous value: -[
-  "BASE_USDC",
-  "TRON_USDT"
-]New value: +[
+  "BASE_USDC",
+  "TRON_USDT",
+  "APPLE_PAY_AUTO"
+]

Previous value: -"If eligible, returns PAYMENT_REQUIRED with quoteId, checkoutId and exact Base USDC payment instructions. No funds are moved by NAIF."New value: +"If eligible, returns PAYMENT_REQUIRED with quoteId, checkoutId and exact wallet payment instructions on BASE_USDC or TRON_USDT. No funds are moved by NAIF."

Added value: +[
+  "BASE_USDC",
+  "TRON_USDT"
+]

Previous value: -"One sanitized technical symptom. Never include secrets, credentials, private keys or PII."New value: +"One sanitized technical symptom. Include the affected component and observable error/status. Never include secrets, credentials, private keys or PII."

Previous value: -"Optional attribution label."New value: +"Optional attribution label for the calling agent or integration; omit when no stable source label is available."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Bounded diagnosis result. On success phase is DIAGNOSE and nextTool is quote_repair; an error field indicates diagnosis was unavailable.",
+  "properties": {
+    "automaticCheckout": {
+      "description": "False; diagnosis never creates checkout automatically.",
+      "type": "boolean"
+    },
+    "automaticExecution": {
+      "description": "False; diagnosis never starts repair execution.",
+      "type": "boolean"
+    },
+    "automaticPayment": {
+      "description": "False; diagnosis never sends or charges payment.",
+      "type": "boolean"
+    },
+    "automaticQuote": {
+      "description": "False; diagnosis never creates a quote automatically.",
+      "type": "boolean"
+    },
+    "error": {
+      "description": "Present when a bounded diagnosis could not be produced.",
+      "type": "string"
+    },
+    "free": {
+      "description": "True for this free diagnostic step.",
+      "type": "boolean"
+    },
+    "nextTool": {
+      "description": "quote_repair when the caller wants a priced bounded repair.",
+      "type": "string"
+    },
+    "phase": {
+      "description": "DIAGNOSE on a successful bounded diagnosis.",
+      "type": "string"
+    },
+    "rawInputStored": {
+      "description": "False when the raw diagnostic input is not retained as payload data.",
+      "type": "boolean"
+    },
+    "suggestedProductId": {
+      "description": "Public repair product suggested from the diagnosis when available.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +"Must be true to record explicit acceptance before checkout instructions are created."

Added value: +"Exact quoteId returned by quote_repair and explicitly accepted by the caller."

Previous value: -"Choose exactly one rail offered by quote_repair."New value: +"Choose exactly one rail offered in quote_repair.paymentRails. Saudi quotes normally offer APPLE_PAY only."

Added value: +"Optional attribution label for the calling agent or integration."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Accepted quote plus checkout instructions. A successful result includes checkout information and nextTool=verify_repair; no funds are sent by this tool.",
+  "properties": {
+    "automaticExecution": {
+      "description": "False; this preparation step does not directly execute repair.",
+      "type": "boolean"
+    },
+    "automaticJob": {
+      "description": "False; this preparation step does not start a repair job.",
+      "type": "boolean"
+    },
+    "automaticPayment": {
+      "description": "False; no automatic charge or transfer occurs.",
+      "type": "boolean"
+    },
+    "checkout": {
+      "additionalProperties": true,
+      "description": "Checkout record/instructions returned for the selected rail; includes the checkout identifier used by verify_repair.",
+      "type": "object"
+    },
+    "error": {
+      "description": "Present when quote acceptance or checkout preparation failed.",
+      "type": "string"
+    },
+    "fundsSent": {
+      "description": "False; this tool does not send funds.",
+      "type": "boolean"
+    },
+    "nextAction": {
+      "additionalProperties": true,
+      "description": "For APPLE_PAY, human handoff information; for wallet rails, payer transfer instructions.",
+      "type": "object"
+    },
+    "nextTool": {
+      "description": "verify_repair after the buyer completes the payment action.",
+      "type": "string"
+    },
+    "paymentVerified": {
+      "description": "False until verify_repair confirms an existing payment.",
+      "type": "boolean"
+    },
+    "phase": {
+      "description": "PREPARE_REPAIR on success.",
+      "type": "string"
+    },
+    "quoteAcceptance": {
+      "additionalProperties": true,
+      "description": "Commerce acknowledgement that the quote was accepted.",
+      "type": "object"
+    },
+    "quoteId": {
+      "description": "Accepted quote identifier.",
+      "type": "string"
+    },
+    "rail": {
+      "description": "Selected payment rail.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +"Sanitized bounded repair need derived from diagnose_issue; describe the failure and desired repair outcome without secrets or PII."

Added value: +"Optional exact public productId suggested by diagnose_issue or chosen from the catalog. Omit to let NAIF match the closest service."

Added value: +"Optional attribution label for the calling agent or integration."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Non-binding repair quote. A successful result includes quoteId, price/currency, offered paymentRails and nextTool=prepare_repair. An error field indicates no quote was created.",
+  "properties": {
+    "automaticExecution": {
+      "description": "False; this tool never starts repair execution.",
+      "type": "boolean"
+    },
+    "automaticJob": {
+      "description": "False; this tool never starts a repair job.",
+      "type": "boolean"
+    },
+    "automaticPayment": {
+      "description": "False; this tool never sends or charges payment.",
+      "type": "boolean"
+    },
+    "checkoutCreated": {
+      "description": "False; creating a quote does not create checkout.",
+      "type": "boolean"
+    },
+    "commercialState": {
+      "description": "Commercial lifecycle state when available.",
+      "type": "string"
+    },
+    "currency": {
+      "description": "Quote currency.",
+      "type": "string"
+    },
+    "error": {
+      "description": "Present when the requested service is unavailable or commerce could not create a quote.",
+      "type": "string"
+    },
+    "eta": {
+      "description": "Estimated delivery time or service ETA when available."
+    },
+    "exactAmount": {
+      "description": "Exact settlement amount when the selected payment design requires one; preserve it exactly as returned."
+    },
+    "nextTool": {
+      "description": "prepare_repair after explicit caller acceptance.",
+      "type": "string"
+    },
+    "paymentRails": {
+      "description": "Payment rails offered for this quote; choose exactly one of these in prepare_repair.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "phase": {
+      "description": "QUOTE on a successful quote.",
+      "type": "string"
+    },
+    "price": {
+      "description": "Commercial price returned by the quote service."
+    },
+    "productId": {
+      "description": "Matched public repair product identifier.",
+      "type": "string"
+    },
+    "productName": {
+      "description": "Human-readable matched repair service name.",
+      "type": "string"
+    },
+    "quoteAccepted": {
+      "description": "False; creating a quote does not accept it.",
+      "type": "boolean"
+    },
+    "quoteId": {
+      "description": "Unique non-binding quote identifier to pass to prepare_repair after explicit caller acceptance.",
+      "type": "string"
+    },
+    "state": {
+      "description": "Current quote state returned by commerce.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +"Exact checkout ID returned by prepare_repair."

Added value: +"Use the same payment rail selected in prepare_repair."

Previous value: -"Required for wallet rails; omit for APPLE_PAY."New value: +"Payer-provided transaction hash. Required for BASE_USDC and TRON_USDT after transfer submission; omit for APPLE_PAY."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "Verification status for an existing checkout payment. Treat verified=true or alreadyVerified=true as confirmed; otherwise inspect error/reason/state and do not assume payment success.",
+  "properties": {
+    "alreadyVerified": {
+      "description": "True when an APPLE_PAY checkout had already been verified previously.",
+      "type": "boolean"
+    },
+    "checkoutId": {
+      "description": "Checkout identifier that was verified.",
+      "type": "string"
+    },
+    "error": {
+      "description": "Present when payment is missing, unavailable, invalid or could not be verified.",
+      "type": "string"
+    },
+    "job": {
+      "description": "Existing repair job attached by the payment-completion workflow when available; may be null."
+    },
+    "paymentId": {
+      "description": "Recorded verified payment identifier when available.",
+      "type": "string"
+    },
+    "phase": {
+      "description": "VERIFY when the verification route returned a structured result.",
+      "type": "string"
+    },
+    "rail": {
+      "description": "Payment rail checked.",
+      "type": "string"
+    },
+    "reason": {
+      "description": "Verification evidence or rejection reason when returned by a wallet rail.",
+      "type": "string"
+    },
+    "state": {
+      "description": "Payment/checkout state when returned; PAYMENT_VERIFIED denotes a confirmed payment.",
+      "type": "string"
+    },
+    "verified": {
+      "description": "True only when the provider/chain evidence confirms the expected payment for this checkout.",
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

Added value: +"Choose exactly one rail offered by quote_repair."

Previous value: -[
-  "BASE_USDC",
-  "TRON_USDT"
-]New value: +[
+  "APPLE_PAY",
+  "BASE_USDC",
+  "TRON_USDT"
+]

Previous value: -[
-  "quoteId",
-  "confirm"
-]New value: +[
+  "quoteId",
+  "confirm",
+  "rail"
+]

Previous value: -[
-  "BASE_USDC",
-  "TRON_USDT"
-]New value: +[
+  "APPLE_PAY",
+  "BASE_USDC",
+  "TRON_USDT"
+]

Added value: +"Required for wallet rails; omit for APPLE_PAY."

Previous value: -[
-  "checkoutId",
-  "rail",
-  "txHash"
-]New value: +[
+  "checkoutId",
+  "rail"
+]

Previous value: -"Optional short attribution label."New value: +"Optional short machine-readable attribution label for the calling agent or integration; it is stored only as diagnostic attribution."

Previous value: -"One sanitized, non-sensitive failure symptom. Do not include secrets."New value: +"One sanitized failure symptom with the affected protocol/component and observable error or status when known. Never include secrets, credentials, private keys or PII."

Added value: +"Existing signed NAIF continuity capsule token returned by create_handoff_capsule, checkpoint_agent_task or handoff_agent_task; pass the complete token unchanged."

Added value: +"Quote ID returned by request_service_quote that the caller explicitly chooses to accept."

Added value: +"Optional short attribution label for the calling agent or integration."

Previous value: -"Sanitized, non-sensitive technical symptoms only."New value: +"Sanitized, non-sensitive symptom text. Include the observable failure and status/error class when known; never include secrets, credentials or private keys."

Previous value: -"Sanitized, non-sensitive technical symptoms only."New value: +"Sanitized, non-sensitive symptom text. Include the observable failure and status/error class when known; never include secrets, credentials or private keys."

Added value: +"Existing signed NAIF continuity capsule to checkpoint or hand off."

Added value: +"New completed steps to append to the capsule state."

Added value: +"New constraints to append while preserving earlier constraints."

Added value: +"Recommended next bounded action for the receiving agent."

Added value: +"New remaining steps to append."

Added value: +"Zero-based indices of prior remaining items now completed."

Added value: +"Additional machine-readable recipient capability labels."

Added value: +"New sanitized verified facts to append."

Added value: +"Up to 20 concise completed steps already achieved."

Added value: +"Up to 20 operational constraints the next agent must preserve."

Added value: +"Sanitized task goal that another agent can understand without private context."

Added value: +"Recommended next bounded action for the receiving agent."

Added value: +"Up to 20 remaining steps the next agent may continue."

Added value: +"Machine-readable capability labels required from a recipient agent."

Added value: +"Up to 20 sanitized facts already verified and safe to hand off."

Added value: +"Existing signed NAIF Trust Passport token for the opted-in recipient agent."

Added value: +"Public agent-card URL for the opted-in agent domain. The domain must publish /.well-known/naif-trust.json."

Added value: +"Sanitized problem summary used only to select the closest public NAIF service; include the failure domain and observable symptom."

Added value: +"Optional short attribution label for the calling agent or integration."

Added value: +"Exact FixGraph topic slug returned by list_fix_topics or a prior diagnostic response; do not pass free-form error text."

Added value: +"Existing signed NAIF continuity capsule to checkpoint or hand off."

Added value: +"Optional public agent-card URL for the intended opted-in recipient. Omit for an unbound handoff capsule."

Previous value: -"Sanitized, non-sensitive technical symptoms only."New value: +"Sanitized, non-sensitive symptom text. Include the observable failure and status/error class when known; never include secrets, credentials or private keys."

Added value: +"Optional lowercase chain/network label such as base or tron when the route is chain-specific."

Added value: +"Normalized failure class when outcome=failure; omit for successful routes."

Added value: +"Coarse latency bucket only; do not submit precise timing or raw telemetry."

Added value: +"Final observed technical outcome of the route attempt."

Added value: +"Optional two-letter uppercase country/region code for aggregate routing context."

Added value: +"Observed route protocol class."

Added value: +"Type of technical target reached by the route."

Added value: +"Existing accepted quote ID. Do not use a product ID or checkout ID here."

Added value: +"Payment rail offered by the accepted quote. Omit to use BASE_USDC when eligible."

Added value: +"Optional short attribution label for the calling agent or integration."

Added value: +"Sanitized bounded work description for this quote; do not include secrets or credentials."

Added value: +"Exact productId returned by get_matching_service or the public catalog."

Added value: +"Optional short attribution label for the calling agent or integration."

Added value: +"Existing signed NAIF continuity capsule token returned by create_handoff_capsule, checkpoint_agent_task or handoff_agent_task."

Added value: +"Optional lowercase chain/network label such as base or tron when the route is chain-specific."

Added value: +"Optional two-letter uppercase country/region code for aggregate routing context."

Added value: +"Observed route protocol class."

Added value: +"Type of technical target reached by the route."

Added value: +"Lookback window in minutes, from 1 to 60. Omit to use the service default."

Added value: +"Checkout ID returned by request_checkout for the transaction being verified."

Added value: +"Exact payment rail selected for this checkout."

Added value: +"Existing transaction hash submitted by the payer; this tool never creates or sends a transaction."

Added value: +"Existing signed NAIF Trust Passport or Delegation Preflight token to validate."

Previous value: -"Sanitized, non-sensitive technical symptoms only."New value: +"Sanitized, non-sensitive symptom text. Include the observable failure and status/error class when known; never include secrets, credentials or private keys."

Added value: +{
+  "enum": [
+    "BASE_USDC",
+    "TRON_USDT"
+  ],
+  "type": "string"
+}

Previous value: -"Sanitized technical symptoms only. Never include secrets, credentials, private keys or PII."New value: +"Sanitized, non-sensitive technical symptoms only."

Previous value: -"Sanitized technical symptoms only. Never include secrets, credentials, private keys or PII."New value: +"Sanitized, non-sensitive technical symptoms only."

Previous value: -"Sanitized technical symptoms only. Never include secrets, credentials, private keys or PII."New value: +"Sanitized, non-sensitive technical symptoms only."

Previous value: -"Technical error text. Never include secrets or private keys."New value: +"Sanitized, non-sensitive technical error text only."

Previous value: -"Sanitized technical symptoms only. Never include secrets, credentials, private keys or PII."New value: +"Sanitized, non-sensitive technical symptoms only."

Previous value: -"Sanitized technical symptoms only. Never include secrets, credentials, private keys or PII."New value: +"Sanitized, non-sensitive technical symptoms only."

Added value: +{}