@agenttrust-sdk/mcp 0.3.1 → 0.3.3

package/dist/tools/read/get-quantu-reputation.d.ts

@@ -33,6 +33,19 @@ declare const InputSchema: z.ZodObject<{
     agent_asset: string;
 }>;
 type Input = z.infer<typeof InputSchema>;
+/**
+ * Stable, machine-parseable error codes the LLM can branch on when the
+ * atom_stats fetch / decode misses. The string `error` field stays for
+ * human readability; new callers should prefer `errorCode`.
+ *
+ *   - "wrong_owner"     — account exists but owner != Quantu atom_engine
+ *                         (e.g., user pointed at a non-Quantu PDA).
+ *   - "size_mismatch"   — account exists but data.len() != ATOM_STATS_SIZE
+ *                         (Quantu schema drift or wrong account).
+ *   - "schema_mismatch" — schema_version byte != expected (1) OR a
+ *                         tier-range canary failed (>ATOM_TIER_MAX).
+ */
+export type QuantuReputationErrorCode = "wrong_owner" | "size_mismatch" | "schema_mismatch";
 interface Output {
     pda: string;
     explorerUrl: string;
@@ -44,6 +57,9 @@ interface Output {
     rawByteLen: number;
     /** Set when the schema-version canary fails or the account is undersized. */
     error?: string;
+    /** Machine-parseable companion to `error` — LLM agents should branch on this
+     *  rather than grep `error`. Only set when `error` is set. */
+    errorCode?: QuantuReputationErrorCode;
     reputation?: {
         /** v1 fast-path tier (0..=4). The CounterpartyTier policy reads
          *  this in v1 demo mode. */
@@ -68,11 +84,15 @@ export declare const ATOM_STATS_CONFIDENCE_OFFSET = 557;
 export declare const ATOM_STATS_SCHEMA_VERSION_OFFSET = 560;
 export declare const ATOM_STATS_SCHEMA_VERSION_EXPECTED = 1;
 export declare const ATOM_TIER_MAX = 4;
-/** Pure-fn bytes → reputation. Returns `{ error }` when the buffer fails any
- *  canary (size, schema_version, tier-range). Mirrors the on-chain parser's
- *  fail-loud semantics — caller surfaces the error. */
+/** Pure-fn bytes → reputation. Returns `{ error, errorCode }` when the buffer
+ *  fails any canary (size, schema_version, tier-range). Mirrors the on-chain
+ *  parser's fail-loud semantics — caller surfaces the error.
+ *
+ *  `errorCode` is machine-parseable: `"size_mismatch"` for length canary,
+ *  `"schema_mismatch"` for schema_version byte or tier-range canary. */
 export declare function decodeAtomStatsBytes(data: Buffer | Uint8Array): NonNullable<Output["reputation"]> | {
     error: string;
+    errorCode: QuantuReputationErrorCode;
 };
 export declare const getQuantuReputationTool: Tool<Input, Output>;
 export {};

package/dist/tools/read/get-quantu-reputation.js

@@ -53,27 +53,42 @@ exports.ATOM_STATS_CONFIDENCE_OFFSET = 557;
 exports.ATOM_STATS_SCHEMA_VERSION_OFFSET = 560;
 exports.ATOM_STATS_SCHEMA_VERSION_EXPECTED = 1;
 exports.ATOM_TIER_MAX = 4;
-/** Pure-fn bytes → reputation. Returns `{ error }` when the buffer fails any
- *  canary (size, schema_version, tier-range). Mirrors the on-chain parser's
- *  fail-loud semantics — caller surfaces the error. */
+/** Pure-fn bytes → reputation. Returns `{ error, errorCode }` when the buffer
+ *  fails any canary (size, schema_version, tier-range). Mirrors the on-chain
+ *  parser's fail-loud semantics — caller surfaces the error.
+ *
+ *  `errorCode` is machine-parseable: `"size_mismatch"` for length canary,
+ *  `"schema_mismatch"` for schema_version byte or tier-range canary. */
 function decodeAtomStatsBytes(data) {
     if (data.length !== exports.ATOM_STATS_SIZE) {
-        return { error: `account size ${data.length} != expected ${exports.ATOM_STATS_SIZE}` };
+        return {
+            error: `account size ${data.length} != expected ${exports.ATOM_STATS_SIZE}`,
+            errorCode: "size_mismatch",
+        };
     }
     const buf = data instanceof Buffer ? data : Buffer.from(data);
     const schemaVersion = buf.readUInt8(exports.ATOM_STATS_SCHEMA_VERSION_OFFSET);
     if (schemaVersion !== exports.ATOM_STATS_SCHEMA_VERSION_EXPECTED) {
-        return { error: `schema_version ${schemaVersion} != expected ${exports.ATOM_STATS_SCHEMA_VERSION_EXPECTED}` };
+        return {
+            error: `schema_version ${schemaVersion} != expected ${exports.ATOM_STATS_SCHEMA_VERSION_EXPECTED}`,
+            errorCode: "schema_mismatch",
+        };
     }
     const tierImmediate = buf.readUInt8(exports.ATOM_STATS_TIER_IMMEDIATE_OFFSET);
     const tierConfirmed = buf.readUInt8(exports.ATOM_STATS_TIER_CONFIRMED_OFFSET);
     const riskScore = buf.readUInt8(exports.ATOM_STATS_RISK_SCORE_OFFSET);
     const confidence = buf.readUInt16LE(exports.ATOM_STATS_CONFIDENCE_OFFSET);
     if (tierImmediate > exports.ATOM_TIER_MAX) {
-        return { error: `tier_immediate ${tierImmediate} > ATOM_TIER_MAX ${exports.ATOM_TIER_MAX}` };
+        return {
+            error: `tier_immediate ${tierImmediate} > ATOM_TIER_MAX ${exports.ATOM_TIER_MAX}`,
+            errorCode: "schema_mismatch",
+        };
     }
     if (tierConfirmed > exports.ATOM_TIER_MAX) {
-        return { error: `tier_confirmed ${tierConfirmed} > ATOM_TIER_MAX ${exports.ATOM_TIER_MAX}` };
+        return {
+            error: `tier_confirmed ${tierConfirmed} > ATOM_TIER_MAX ${exports.ATOM_TIER_MAX}`,
+            errorCode: "schema_mismatch",
+        };
     }
     return { tierImmediate, tierConfirmed, riskScore, confidence, schemaVersion };
 }
@@ -102,9 +117,19 @@ exports.getQuantuReputationTool = {
         };
         if (!accountInfo)
             return out;
+        // Owner check is a separate canary from the decode below — surface
+        // it with its own errorCode so an LLM can branch ("wrong_owner"
+        // typically means the user passed a pubkey that doesn't belong to
+        // Quantu, vs. "schema_mismatch" which means the Quantu IDL drifted).
+        if (!out.ownerMatches) {
+            out.error = `atom_stats decode failed: owner ${out.ownerProgram ?? "(null)"} != expected ${out.ownerExpected}`;
+            out.errorCode = "wrong_owner";
+            return out;
+        }
         const decoded = decodeAtomStatsBytes(accountInfo.data);
         if ("error" in decoded) {
             out.error = `atom_stats decode failed: ${decoded.error}`;
+            out.errorCode = decoded.errorCode;
             return out;
         }
         out.reputation = decoded;

package/dist/tools/read/get-quantu-reputation.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-quantu-reputation.js","sourceRoot":"","sources":["../../../src/tools/read/get-quantu-reputation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-quantu-reputation.js","sourceRoot":"","sources":["../../../src/tools/read/get-quantu-reputation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;AAwFH,oDAkCC;AAxHD,6BAAwB;AAExB,uCAAiD;AACjD,yCAA2C;AAC3C,sCAAsD;AAGtD,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAY,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAChE,CAAC,CAAC;AAmDH,8EAA8E;AAC9E,iFAAiF;AACjF,gDAAgD;AAChD,gDAAgD;AAChD,6DAA6D;AAC7D,gDAAgD;AAChD,0EAA0E;AAC1E,gDAAgD;AAChD,8CAA8C;AAC9C,8CAA8C;AAC9C,8EAA8E;AACjE,QAAA,eAAe,GAAsB,GAAG,CAAC;AACzC,QAAA,4BAA4B,GAAS,GAAG,CAAC;AACzC,QAAA,gCAAgC,GAAK,GAAG,CAAC;AACzC,QAAA,gCAAgC,GAAK,GAAG,CAAC;AACzC,QAAA,4BAA4B,GAAS,GAAG,CAAC;AACzC,QAAA,gCAAgC,GAAK,GAAG,CAAC;AACzC,QAAA,kCAAkC,GAAG,CAAC,CAAC;AACvC,QAAA,aAAa,GAAwB,CAAC,CAAC;AAEpD;;;;;wEAKwE;AACxE,SAAgB,oBAAoB,CAClC,IAAyB;IAEzB,IAAI,IAAI,CAAC,MAAM,KAAK,uBAAe,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAM,gBAAgB,IAAI,CAAC,MAAM,gBAAgB,uBAAe,EAAE;YACvE,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,YAAY,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,wCAAgC,CAAC,CAAC;IACtE,IAAI,aAAa,KAAK,0CAAkC,EAAE,CAAC;QACzD,OAAO;YACL,KAAK,EAAM,kBAAkB,aAAa,gBAAgB,0CAAkC,EAAE;YAC9F,SAAS,EAAE,iBAAiB;SAC7B,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,wCAAgC,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,wCAAgC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAO,GAAG,CAAC,SAAS,CAAC,oCAA4B,CAAC,CAAC;IAClE,MAAM,UAAU,GAAM,GAAG,CAAC,YAAY,CAAC,oCAA4B,CAAC,CAAC;IACrE,IAAI,aAAa,GAAG,qBAAa,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAM,kBAAkB,aAAa,oBAAoB,qBAAa,EAAE;YAC7E,SAAS,EAAE,iBAAiB;SAC7B,CAAC;IACJ,CAAC;IACD,IAAI,aAAa,GAAG,qBAAa,EAAE,CAAC;QAClC,OAAO;YACL,KAAK,EAAM,kBAAkB,aAAa,oBAAoB,qBAAa,EAAE;YAC7E,SAAS,EAAE,iBAAiB;SAC7B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAChF,CAAC;AAEY,QAAA,uBAAuB,GAAwB;IAC1D,IAAI,EAAS,kCAAkC;IAC/C,WAAW,EACT,sEAAsE;QACtE,mEAAmE;QACnE,uEAAuE;QACvE,oEAAoE;QACpE,kEAAkE;QAClE,kEAAkE;IACpE,WAAW,EAAE,WAAW;IAExB,KAAK,CAAC,OAAO,CAAC,KAAY,EAAE,GAAgB;QAC1C,MAAM,KAAK,GAAS,IAAA,oBAAW,EAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAClE,MAAM,UAAU,GAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;QACpD,MAAM,GAAG,GAAW,IAAA,0BAAkB,EAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAEhF,MAAM,GAAG,GAAW;YAClB,GAAG,EAAY,GAAG,CAAC,QAAQ,EAAE;YAC7B,WAAW,EAAI,IAAA,oBAAW,EAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;YACpE,MAAM,EAAS,CAAC,CAAC,WAAW;YAC5B,YAAY,EAAG,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI;YACpD,aAAa,EAAE,UAAU,CAAC,QAAQ,EAAE;YACpC,YAAY,EAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK;YACzE,UAAU,EAAK,WAAW,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;SAC7C,CAAC;QACF,IAAI,CAAC,WAAW;YAAE,OAAO,GAAG,CAAC;QAE7B,mEAAmE;QACnE,gEAAgE;QAChE,kEAAkE;QAClE,qEAAqE;QACrE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACtB,GAAG,CAAC,KAAK,GAAO,mCAAmC,GAAG,CAAC,YAAY,IAAI,QAAQ,gBAAgB,GAAG,CAAC,aAAa,EAAE,CAAC;YACnH,GAAG,CAAC,SAAS,GAAG,aAAa,CAAC;YAC9B,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,GAAO,6BAA6B,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7D,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YAClC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/tools/read/simulate-payment.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simulatePaymentTool = void 0;
 const anchor_1 = require("@coral-xyz/anchor");
+const web3_js_1 = require("@solana/web3.js");
 const zod_1 = require("zod");
 const chain_1 = require("../../chain");
 const common_1 = require("../common");
@@ -30,21 +31,20 @@ exports.simulatePaymentTool = {
     inputSchema: InputSchema,
     async handler(input, ctx) {
         const policyVault = await ctx.chain.policyVault();
-        // Solana's simulate requires the fee-payer to be a real funded
-        // system-program-owned account. We need an explicit funded caller:
-        //   1. explicit input.caller arg (caller's responsibility to fund)
-        //   2. configured KEYPAIR_B58 signer (real funded account)
-        //   else: throw a clear error explaining the requirement.
-        if (!input.caller && !ctx.chain.signerPubkey()) {
-            throw new Error("agenttrust_simulate_payment requires a funded fee-payer on devnet. " +
-                "Either pass `caller` arg as a base58 pubkey of a funded account, or " +
-                "set KEYPAIR_B58 in the MCP environment to a base58-encoded keypair " +
-                "with at least one lamport. Read tools without `simulate_*` work " +
-                "without any signer.");
-        }
+        // F-024: the SDK's simulateGatePayment threads the gate_payment ix
+        // through `simulateTransaction({ replaceRecentBlockhash: true,
+        // sigVerify: false })` — the RPC fills in a fresh blockhash and the
+        // signature check is skipped, so the fee-payer doesn't need to be
+        // funded for simulation to succeed. We pick the caller in priority
+        // order:
+        //   1. explicit input.caller arg (lets the user pin a known funded
+        //      pubkey when they're auditing a specific deployment)
+        //   2. configured KEYPAIR_B58 signer pubkey (matches their identity)
+        //   3. an ephemeral throwaway pubkey — safe because sigVerify=false
+        //      means the fee-payer never has to sign and is never debited.
         const callerPubkey = input.caller
             ? (0, common_1.parsePubkey)(input.caller, "caller")
-            : ctx.chain.signerPubkey();
+            : (ctx.chain.signerPubkey() ?? web3_js_1.Keypair.generate().publicKey);
         const decision = await (0, chain_1.simulateGatePayment)({
             policyVault,
             programIds: ctx.chain.cfg.programs,

package/dist/tools/read/simulate-payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"simulate-payment.js","sourceRoot":"","sources":["../../../src/tools/read/simulate-payment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"simulate-payment.js","sourceRoot":"","sources":["../../../src/tools/read/simulate-payment.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,8CAAuC;AACvC,6CAA0C;AAC1C,6BAAwB;AAExB,uCAAkD;AAClD,sCAAkE;AAGlE,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAY,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC9D,WAAW,EAAE,qBAAY,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAC9D,MAAM,EAAO,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;SAChE,QAAQ,CAAC,6DAA6D,CAAC;IACxF,IAAI,EAAS,qBAAY,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACnE,SAAS,EAAI,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACtF,MAAM,EAAO,qBAAY,CAAC,QAAQ,EAAE;SACnB,QAAQ,CAAC,0FAA0F,CAAC;CACtH,CAAC,CAAC;AAQU,QAAA,mBAAmB,GAAgC;IAC9D,IAAI,EAAS,6BAA6B;IAC1C,WAAW,EACT,sEAAsE;QACtE,qEAAqE;QACrE,yEAAyE;IAC3E,WAAW,EAAE,WAAW;IAExB,KAAK,CAAC,OAAO,CAAC,KAAY,EAAE,GAAgB;QAC1C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAClD,mEAAmE;QACnE,+DAA+D;QAC/D,oEAAoE;QACpE,kEAAkE;QAClE,mEAAmE;QACnE,SAAS;QACT,mEAAmE;QACnE,2DAA2D;QAC3D,qEAAqE;QACrE,oEAAoE;QACpE,mEAAmE;QACnE,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM;YAC/B,CAAC,CAAC,IAAA,oBAAW,EAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;YACrC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,iBAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;QAE/D,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAmB,EAAC;YACzC,WAAW;YACX,UAAU,EAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ;YACvC,MAAM,EAAW,YAAY;YAC7B,eAAe,EAAE,IAAA,oBAAW,EAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC;YAC9D,eAAe,EAAE,IAAA,oBAAW,EAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC;YAC9D,MAAM,EAAW,IAAI,WAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,EAAa,IAAA,oBAAW,EAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;YAChD,QAAQ,EAAS,KAAK,CAAC,SAAS;SACjC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5F,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,IAAA,mBAAU,EAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;IAC/F,CAAC;CACF,CAAC"}

package/dist/tools/write/emit-feedback.d.ts

@@ -18,25 +18,25 @@ declare const InputSchema: z.ZodObject<{
     payee_asset: z.ZodEffects<z.ZodString, string, string>;
     base_collection: z.ZodEffects<z.ZodString, string, string>;
     score: z.ZodNumber;
-    value: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    value_decimals: z.ZodDefault<z.ZodNumber>;
+    value: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    value_decimals: z.ZodOptional<z.ZodNumber>;
     tag1: z.ZodDefault<z.ZodString>;
     tag2: z.ZodDefault<z.ZodString>;
     endpoint: z.ZodDefault<z.ZodString>;
     feedback_uri: z.ZodDefault<z.ZodString>;
     atom_enabled: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    value: string | number;
     payment_id_hash_hex: string;
     payee_asset: string;
     base_collection: string;
     score: number;
-    value_decimals: number;
     tag1: string;
     tag2: string;
     endpoint: string;
     feedback_uri: string;
     atom_enabled: boolean;
+    value?: string | number | undefined;
+    value_decimals?: number | undefined;
 }, {
     payment_id_hash_hex: string;
     payee_asset: string;

package/dist/tools/write/emit-feedback.js

@@ -20,22 +20,47 @@ const zod_1 = require("zod");
 const trustgate_1 = require("@agenttrust-sdk/trustgate");
 const config_1 = require("../../config");
 const common_1 = require("../common");
+// Module-level guard so the warning fires once per process even if the
+// tool is invoked many times (matches the F-051-style warn pattern used
+// elsewhere in the package).
+let warnedDefaults = false;
+function warnDefaultsOnce() {
+    if (warnedDefaults)
+        return;
+    warnedDefaults = true;
+    process.stderr.write("[agenttrust] WARN agenttrust_emit_feedback: value and value_decimals " +
+        "defaulted to USDC (1_000_000 / 6 decimals). For non-USDC mints, pass " +
+        "explicit value and value_decimals. Otherwise Quantu quality_score " +
+        "accrues at the wrong magnitude.\n");
+}
+const DEFAULT_VALUE = "1000000";
+const DEFAULT_VALUE_DECIMALS = 6;
 const InputSchema = zod_1.z.object({
     payment_id_hash_hex: common_1.HexHashSchema.describe("32-byte SHA-256 of the payment_id"),
     payee_asset: common_1.PubkeySchema.describe("Quantu agent asset receiving feedback"),
-    base_collection: common_1.PubkeySchema.describe("Metaplex Core collection that owns the agent assets. For demo runs use " +
-        "agenttrust_demo_state.programs.base_collection. For production " +
-        "integrations, use your Quantu agent registry's collection address — " +
-        "typically the value passed to agent_registry::register_agent when the " +
-        "agent was minted."),
+    base_collection: common_1.PubkeySchema.describe("Metaplex Core collection that owns the agent assets. Discovery paths. " +
+        "(1) demo runs use agenttrust_demo_state.programs.base_collection. " +
+        "(2) production reads the `collection` field on the agent's on-chain " +
+        "agent_account PDA at `[b\"agent\", asset]` under the Quantu " +
+        "agent_registry program (see agenttrust_get_quantu_reputation output " +
+        "for the agent's PDA + ownerProgram), or uses the value passed to " +
+        "agent_registry::register_agent when the agent was minted."),
     score: zod_1.z.number().int().min(0).max(100),
     // `value` + `value_decimals` are forwarded to Quantu's give_feedback so
     // `quality_score` can accrue (otherwise tier_immediate stays pinned at 0).
     // Default of 1_000_000 @ 6 decimals = $1 USDC equivalent, a sensible
     // representative value when the caller doesn't have the real amount handy.
-    value: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).default("1000000").describe("Raw payment amount in base token units (u64). Forwarded to Quantu's " +
-        "give_feedback for quality_score accrual. Defaults to 1_000_000 ($1 USDC)."),
-    value_decimals: zod_1.z.number().int().min(0).max(18).default(6).describe("Decimal exponent of the mint backing `value`. Defaults to 6 (USDC)."),
+    // When the defaults fire (caller omitted both fields) the handler emits a
+    // one-time stderr warning so non-USDC integrations notice the magnitude
+    // mismatch — see warnDefaultsOnce() below.
+    value: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional().describe("Raw payment amount in base token units (u64). Forwarded to Quantu's " +
+        "give_feedback for quality_score accrual. When omitted, defaults to " +
+        "1_000_000 ($1 USDC) AND the tool logs a one-time stderr warning. " +
+        "For non-USDC mints, pass the explicit value to keep quality_score " +
+        "accrual at the right magnitude."),
+    value_decimals: zod_1.z.number().int().min(0).max(18).optional().describe("Decimal exponent of the mint backing `value`. When omitted, defaults " +
+        "to 6 (USDC) AND the tool logs a one-time stderr warning. Pass the " +
+        "real mint decimals for non-USDC integrations."),
     tag1: zod_1.z.string().max(32).default(""),
     tag2: zod_1.z.string().max(32).default(""),
     endpoint: zod_1.z.string().max(64).default(""),
@@ -45,9 +70,13 @@ const InputSchema = zod_1.z.object({
 exports.emitFeedbackTool = {
     name: "agenttrust_emit_feedback",
     description: "Emit ERC-8004 feedback for a confirmed payment. Facilitator-only: " +
-        "KEYPAIR_B58 must equal the facilitator wallet whose TrustGateAuthority " +
+        "requires a signer (KEYPAIR_B58 / KEYPAIR_PATH / Solana CLI default) " +
+        "whose pubkey must equal the facilitator wallet whose TrustGateAuthority " +
         "PDA is being signed. Threads Quantu agent_account/atom_stats accounts " +
-        "through remaining_accounts. Idempotent on payment_id_hash.",
+        "through remaining_accounts. Idempotent on payment_id_hash. When `value` " +
+        "and `value_decimals` are both omitted the tool falls back to USDC " +
+        "defaults (1_000_000 / 6) and logs a one-time stderr warning. Pass " +
+        "explicit values for non-USDC mints.",
     inputSchema: InputSchema,
     async handler(input, ctx) {
         const facilitator = ctx.chain.requireSigner();
@@ -75,9 +104,23 @@ exports.emitFeedbackTool = {
         }
         // Forward `value` + `value_decimals` so Quantu's give_feedback can
         // accrue quality_score (drives tier_immediate promotion).
-        const valueBn = new anchor_1.BN(typeof input.value === "string" ? input.value : input.value.toString());
+        //
+        // When the caller omits BOTH fields we fall back to the USDC default
+        // (1_000_000 @ 6 decimals) AND emit a one-time stderr warning so
+        // non-USDC integrations notice the magnitude mismatch. Keeping the
+        // defaults non-breaking — callers that explicitly pass value or
+        // value_decimals get the literal values they asked for and no warn.
+        const valueOmitted = input.value === undefined;
+        const decimalsOmitted = input.value_decimals === undefined;
+        if (valueOmitted && decimalsOmitted)
+            warnDefaultsOnce();
+        const valueStr = input.value === undefined
+            ? DEFAULT_VALUE
+            : (typeof input.value === "string" ? input.value : input.value.toString());
+        const valueDecimals = input.value_decimals ?? DEFAULT_VALUE_DECIMALS;
+        const valueBn = new anchor_1.BN(valueStr);
         const txSignature = await trustgate.methods
-            .emitFeedback(Array.from(paymentIdHash), facilitator.publicKey, payeeAsset, input.score, valueBn, input.value_decimals, input.tag1, input.tag2, input.endpoint, input.feedback_uri)
+            .emitFeedback(Array.from(paymentIdHash), facilitator.publicKey, payeeAsset, input.score, valueBn, valueDecimals, input.tag1, input.tag2, input.endpoint, input.feedback_uri)
             .accounts({
             payer: facilitator.publicKey,
             authority: authorityPda,

package/dist/tools/write/emit-feedback.js.map

@@ -1 +1 @@
-{"version":3,"file":"emit-feedback.js","sourceRoot":"","sources":["../../../src/tools/write/emit-feedback.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"emit-feedback.js","sourceRoot":"","sources":["../../../src/tools/write/emit-feedback.ts"],"names":[],"mappings":"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"}

package/dist/tools/write/init-authority.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `agenttrust_init_authority` — create the `PolicyAuthority` PDA for an
+ * agent asset. Prerequisite for `init_policy` and `set_killswitch`.
+ *
+ * Defaults are tuned for the zero-friction first-use flow: omit
+ * `members` and `threshold` and the tool initialises a single-member
+ * authority with the signer as the sole member (threshold = 1). Pass
+ * explicit `members` + `threshold` to bootstrap a multisig.
+ *
+ * Idempotent: if the PolicyAuthority PDA already exists this tool
+ * returns the existing on-chain config rather than failing or
+ * overwriting. The existing account is the source of truth — callers
+ * that wanted different membership should burn it down via the
+ * appropriate (future) instruction rather than expect this tool to
+ * silently re-init.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    agent_asset: z.ZodEffects<z.ZodString, string, string>;
+    members: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    agent_asset: string;
+    members?: string[] | undefined;
+    threshold?: number | undefined;
+}, {
+    agent_asset: string;
+    members?: string[] | undefined;
+    threshold?: number | undefined;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface Output {
+    txSignature: string | null;
+    explorerTxUrl: string | null;
+    authorityPda: string;
+    authorityExplorer: string;
+    members: string[];
+    threshold: number;
+    alreadyInitialized: boolean;
+}
+export declare const initAuthorityTool: Tool<Input, Output>;
+export {};

package/dist/tools/write/init-authority.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * `agenttrust_init_authority` — create the `PolicyAuthority` PDA for an
+ * agent asset. Prerequisite for `init_policy` and `set_killswitch`.
+ *
+ * Defaults are tuned for the zero-friction first-use flow: omit
+ * `members` and `threshold` and the tool initialises a single-member
+ * authority with the signer as the sole member (threshold = 1). Pass
+ * explicit `members` + `threshold` to bootstrap a multisig.
+ *
+ * Idempotent: if the PolicyAuthority PDA already exists this tool
+ * returns the existing on-chain config rather than failing or
+ * overwriting. The existing account is the source of truth — callers
+ * that wanted different membership should burn it down via the
+ * appropriate (future) instruction rather than expect this tool to
+ * silently re-init.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initAuthorityTool = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const zod_1 = require("zod");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const POLICY_AUTHORITY_PREFIX = Buffer.from("policy_authority");
+const InputSchema = zod_1.z.object({
+    agent_asset: common_1.PubkeySchema.describe("Quantu agent asset the PolicyAuthority is being created for"),
+    members: zod_1.z.array(common_1.PubkeySchema).min(1).max(7).optional().describe("Authority members (1..=7 base58 pubkeys). Defaults to [<signer>] " +
+        "when omitted. The caller MUST be a member or init_policy is unreachable."),
+    threshold: zod_1.z.number().int().min(1).max(7).optional().describe("Signers required to authorise a multisig action (1..=members.length). " +
+        "Defaults to 1."),
+});
+exports.initAuthorityTool = {
+    name: "agenttrust_init_authority",
+    description: "Create the PolicyAuthority PDA for an agent. Required before " +
+        "init_policy or set_killswitch can succeed. Defaults to a single-member " +
+        "authority with the signer as sole member (threshold 1) for fastest " +
+        "bootstrap. Idempotent: a no-op if the PDA already exists, returning the " +
+        "current on-chain members + threshold.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const signer = ctx.chain.requireSigner();
+        const agent = (0, common_1.parsePubkey)(input.agent_asset, "agent_asset");
+        const policyVault = await ctx.chain.policyVault();
+        const members = (input.members ?? [signer.publicKey.toBase58()]).map((m, i) => (0, common_1.parsePubkey)(m, `members[${i}]`));
+        const threshold = input.threshold ?? 1;
+        if (threshold > members.length) {
+            throw new Error(`threshold (${threshold}) exceeds members.length (${members.length}).`);
+        }
+        if (!members.some((m) => m.equals(signer.publicKey))) {
+            throw new Error(`signer ${signer.publicKey.toBase58()} must be in members[] or ` +
+                `init_policy becomes unreachable for this agent.`);
+        }
+        const authorityPda = web3_js_1.PublicKey.findProgramAddressSync([POLICY_AUTHORITY_PREFIX, agent.toBuffer()], ctx.chain.cfg.programs.policyVault)[0];
+        // Idempotency: if the PDA already exists, return its on-chain state
+        // and skip the init. The existing account is the source of truth.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const existing = await policyVault.account.policyAuthority.fetchNullable(authorityPda);
+        if (existing) {
+            const onChainMembers = existing.members
+                .slice(0, Number(existing.memberCount ?? existing.member_count ?? members.length))
+                .map((m) => m.toBase58());
+            return {
+                txSignature: null,
+                explorerTxUrl: null,
+                authorityPda: authorityPda.toBase58(),
+                authorityExplorer: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", authorityPda.toBase58()),
+                members: onChainMembers,
+                threshold: Number(existing.threshold ?? 0),
+                alreadyInitialized: true,
+            };
+        }
+        const txSignature = await policyVault.methods
+            .initAuthority(agent, members, threshold)
+            .accounts({
+            payer: signer.publicKey,
+            policyAuthority: authorityPda,
+            systemProgram: web3_js_1.SystemProgram.programId,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        })
+            .rpc();
+        return {
+            txSignature,
+            explorerTxUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "tx", txSignature),
+            authorityPda: authorityPda.toBase58(),
+            authorityExplorer: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", authorityPda.toBase58()),
+            members: members.map((m) => m.toBase58()),
+            threshold,
+            alreadyInitialized: false,
+        };
+    },
+};
+//# sourceMappingURL=init-authority.js.map

package/dist/tools/write/init-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-authority.js","sourceRoot":"","sources":["../../../src/tools/write/init-authority.ts"],"names":[],"mappings":"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"}

package/dist/tools/write/init-policy.d.ts

@@ -1,8 +1,19 @@
 /**
  * `agenttrust_init_policy` — initialise a PolicyAccount + VelocityLedger
- * for the caller's `(agent_asset, policy_id)` pair. Requires the
- * PolicyAuthority to already exist with the signer as a member; this
- * tool surfaces a clear error pointing at `init_authority` if not.
+ * for the caller's `(agent_asset, policy_id)` pair.
+ *
+ * Self-healing: if the agent's `PolicyAuthority` PDA does not yet
+ * exist, the tool transparently prepends an `init_authority` instruction
+ * (single-member = signer, threshold = 1) and submits both in a single
+ * atomic transaction. The user never has to learn about Anchor 3012
+ * (AccountNotInitialized) or run a bootstrap script.
+ *
+ * Cap defaults: when the caller specifies ANY spending cap, unspecified
+ * peers default to the MAX of the specified caps rather than 0.
+ * Rationale: v1 policies are immutable post-init, so 0 (literal hard
+ * cap) is hostile — every gated payment fails with
+ * `SpendingPerTxExceeded`. The MAX-of-peers default keeps the explicit
+ * cap binding and leaves the others permissive.
  *
  * The full per-kind config is exposed as JSON; sane defaults zero every
  * field so callers can incrementally enable kinds via the bitmask.
@@ -128,6 +139,15 @@ interface Output {
     policyExplorer: string;
     velocityPda: string;
     velocityExplorer: string;
+    /** Effective spending caps actually written on-chain (after max-of-peers default-fill). */
+    effectiveSpending: {
+        perTxMax: string;
+        dailyMax: string;
+        weeklyMax: string;
+    };
+    /** True when the tool transparently bootstrapped PolicyAuthority in the same tx. */
+    selfHealed: boolean;
+    healedSteps: string[];
 }
 export declare const initPolicyTool: Tool<Input, Output>;
 export {};