@nuanu-ai/agentify 0.2.8 → 0.3.0

package/dist/check-card.d.ts

@@ -1,25 +1,28 @@
 /**
  * Is this card enough for an agent to buy from?
  *
- * The check is the contracts schema and nothing beside it. A second opinion
- * written here would be a second definition of a complete card, and the day the
- * two disagreed a merchant would pass one and be refused by the other.
+ * The check is the contracts schema and the contract's price rule, and nothing
+ * beside them. A second opinion written here would be a second definition of a
+ * complete card, and the day the two disagreed a merchant would pass one and be
+ * refused by the other. The price rule is read here for exactly that reason:
+ * it is the gateway's door that applies it rather than the schema, and a check
+ * that skipped it would pass a card priced at zero that publishing refuses.
  *
  * What the check cannot see is worth stating, because a merchant reading a
  * short list of findings would otherwise assume it is the whole list. A card is
  * checked in two stages: first its shape — which fields are there, what they
  * hold, whether any field was invented — and then the rules that compare one
  * field against another, such as a delivery deadline being allowed only on the
- * modes that wait. The second stage is only reached when the first passes. So a
- * card that failed on its shape may still have a finding waiting behind the
- * ones it was given, and the report says so instead of implying a clean second
- * run. A card that passes has passed both stages and there is nothing behind
- * it.
+ * modes that wait, and the price rule. The second stage is only reached when
+ * the first passes. So a card that failed on its shape may still have a finding
+ * waiting behind the ones it was given, and the report says so instead of
+ * implying a clean second run. A card that passes has passed both stages and
+ * there is nothing behind it.
  *
  * What no local check can decide at all: whether the gateway will accept the
- * card. Publishing is the authority — a currency we do not settle in, a
- * merchant key already in use, a policy nobody has written into a schema — and
- * this check makes no claim about any of that.
+ * card. Publishing is the authority — a merchant key already in use, a policy
+ * nobody has written into the contract — and this check makes no claim about
+ * any of that.
  */
 import { type Problem } from "@nuanu-ai/agentify-contracts";
 export interface CardCheck {

package/dist/check-card.js

@@ -1,29 +1,34 @@
 /**
  * Is this card enough for an agent to buy from?
  *
- * The check is the contracts schema and nothing beside it. A second opinion
- * written here would be a second definition of a complete card, and the day the
- * two disagreed a merchant would pass one and be refused by the other.
+ * The check is the contracts schema and the contract's price rule, and nothing
+ * beside them. A second opinion written here would be a second definition of a
+ * complete card, and the day the two disagreed a merchant would pass one and be
+ * refused by the other. The price rule is read here for exactly that reason:
+ * it is the gateway's door that applies it rather than the schema, and a check
+ * that skipped it would pass a card priced at zero that publishing refuses.
  *
  * What the check cannot see is worth stating, because a merchant reading a
  * short list of findings would otherwise assume it is the whole list. A card is
  * checked in two stages: first its shape — which fields are there, what they
  * hold, whether any field was invented — and then the rules that compare one
  * field against another, such as a delivery deadline being allowed only on the
- * modes that wait. The second stage is only reached when the first passes. So a
- * card that failed on its shape may still have a finding waiting behind the
- * ones it was given, and the report says so instead of implying a clean second
- * run. A card that passes has passed both stages and there is nothing behind
- * it.
+ * modes that wait, and the price rule. The second stage is only reached when
+ * the first passes. So a card that failed on its shape may still have a finding
+ * waiting behind the ones it was given, and the report says so instead of
+ * implying a clean second run. A card that passes has passed both stages and
+ * there is nothing behind it.
  *
  * What no local check can decide at all: whether the gateway will accept the
- * card. Publishing is the authority — a currency we do not settle in, a
- * merchant key already in use, a policy nobody has written into a schema — and
- * this check makes no claim about any of that.
+ * card. Publishing is the authority — a merchant key already in use, a policy
+ * nobody has written into the contract — and this check makes no claim about
+ * any of that.
  */
-import { CardSchema } from "@nuanu-ai/agentify-contracts";
+import { CardSchema, priceProblemsOf } from "@nuanu-ai/agentify-contracts";
 import { problemsOf } from "./schema.js";
 export const checkCard = (card) => {
     const result = CardSchema.safeParse(card);
-    return { problems: result.success ? [] : problemsOf(result.error.issues) };
+    return {
+        problems: result.success ? priceProblemsOf(result.data.price) : problemsOf(result.error.issues),
+    };
 };

package/dist/verify.js

@@ -118,19 +118,23 @@ const USAGE = [
  * that route promises is worth repeating exactly, because every part of it is
  * easy to overstate. Whose cards it returns is settled: the merchant whose key
  * the call was made with, and nobody else. A card reaches that list by being accepted at
- * `publish_card`, which parses the same `CardSchema` this package parses, so
- * the cards on it passed this check on the day they went out — which is not
- * the same as passing it now, because the schema can move, nothing parses a
- * stored card again on the way back out, and a command that builds no client
- * can never learn which version of the contract the gateway is speaking. And
- * publishing is more than this check: it can refuse a card for reasons no
- * schema carries, which `checkCard` says in its own words.
+ * `publish_card`, which parses the same `CardSchema` and applies the same
+ * price rule this package does, so the cards on it passed this check on the
+ * day they went out — which is not the same as passing it now. The schema can
+ * move, and the price rule is applied only at publication: a stored card is
+ * parsed again on its way back out against the schema alone, so a card
+ * published before the price rule tightened is read back as it was, and one
+ * that no longer fits a schema that moved fails that read. And a
+ * command that builds no client can never learn which version of the contract
+ * the gateway is speaking. Publishing is more than this check, too: it can
+ * refuse a card for reasons the contract does not carry, which `checkCard`
+ * says in its own words.
  *
  * Taking no key is a choice and not a hole, which is worth saying here because
  * the first line of the message reads like a limitation somebody would set out
- * to remove. A check that read published cards over that route would always
- * pass — they got onto it by passing this very schema — and a green that cannot
- * fail teaches a merchant to stop reading it. What would earn a keyed mode is a
+ * to remove. A check that read published cards over that route would all but
+ * always pass — they got onto it by passing this very check — and a green that
+ * cannot fail teaches a merchant to stop reading it. What would earn a keyed mode is a
  * dry run of publishing, which can refuse for reasons no schema carries; there
  * is no such route (`docs/research/00-open-questions.md`).
  *

package/dist/worker.js

@@ -50,7 +50,7 @@
  * delivered no envelope to anybody. That retry is the backoff in
  * `backoff.ts` and nothing more.
  */
-import { HandlerAnswerSchema, PROTOTYPE_KEY_IS_DROPPED, QuoteResponseSchema, } from "@nuanu-ai/agentify-contracts";
+import { HandlerAnswerSchema, PROTOTYPE_KEY_IS_DROPPED, priceProblemsOf, QuoteResponseSchema, } from "@nuanu-ai/agentify-contracts";
 import { retryDelayMs } from "./backoff.js";
 import { contractVersion, speaksContract } from "./contract.js";
 import { describeProblems, problemsOf } from "./schema.js";
@@ -423,12 +423,20 @@ deadlineMs = POLL_DEADLINE_MS) => {
         // gateway's complaint about a document, which reads as our fault and
         // names the merchant's field only inside a quoted blob.
         const checked = QuoteResponseSchema.safeParse(answer);
-        if (!checked.success) {
+        // The gateway holds the price to the rule a card's price meets, outside the
+        // schema; applied here too, a zero or a missing cent is named as the
+        // merchant's own field rather than coming back as a call that failed.
+        const problems = checked.success
+            ? checked.data.available
+                ? priceProblemsOf(checked.data.price)
+                : []
+            : problemsOf(checked.error.issues);
+        if (!checked.success || problems.length > 0) {
             report({
                 kind: WORKER_PROBLEM_KINDS.HANDLER_ANSWER_REFUSED,
                 fatal: false,
                 subject: question.price_id,
-                message: `the price handler's answer for question ${question.price_id} is not one the contract carries, so no price was sent:\n${describeProblems(problemsOf(checked.error.issues))}`,
+                message: `the price handler's answer for question ${question.price_id} is not one the contract carries, so no price was sent:\n${describeProblems(problems)}`,
             });
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentify",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "type": "module",
   "description": "Sell your existing products to AI agents: publish product cards to an x402 storefront and fill the paid orders from your own service.",
   "keywords": [
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@nuanu-ai/agentify-contracts": "0.5.0"
+    "@nuanu-ai/agentify-contracts": "0.6.0"
   },
   "devDependencies": {
     "vitest": "^4.1.11",