@agenttrust-sdk/mcp 0.1.0

package/dist/tools/read/get-killswitch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `agenttrust_get_killswitch` — fetch the per-agent KillSwitchState plus
+ * the PolicyAuthority (multisig members + threshold) that gates pause
+ * mutations.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    agent_asset: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    agent_asset: string;
+}, {
+    agent_asset: string;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface Output {
+    killSwitchPda: string;
+    killSwitchExplorer: string;
+    killSwitchExists: boolean;
+    killSwitch?: {
+        paused: boolean;
+        scopeKind: number;
+        scopeKeyHex: string;
+        pausedAtSlot: string;
+        unpausedAtSlot: string;
+        pausedBy: string | null;
+    };
+    authorityPda: string;
+    authorityExplorer: string;
+    authorityExists: boolean;
+    authority?: {
+        threshold: number;
+        memberCount: number;
+        members: (string | null)[];
+    };
+}
+export declare const getKillswitchTool: Tool<Input, Output>;
+export {};

package/dist/tools/read/get-killswitch.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * `agenttrust_get_killswitch` — fetch the per-agent KillSwitchState plus
+ * the PolicyAuthority (multisig members + threshold) that gates pause
+ * mutations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKillswitchTool = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const zod_1 = require("zod");
+const chain_1 = require("../../chain");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const InputSchema = zod_1.z.object({
+    agent_asset: common_1.PubkeySchema.describe("Quantu agent asset"),
+});
+const POLICY_AUTHORITY_PREFIX = Buffer.from("policy_authority");
+exports.getKillswitchTool = {
+    name: "agenttrust_get_killswitch",
+    description: "Read the per-agent KillSwitchState (paused / unpaused, slot timestamps, " +
+        "who pressed it) and the PolicyAuthority that controls the multisig " +
+        "(members + threshold). Both PDAs are derived from the agent_asset.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const agent = (0, common_1.parsePubkey)(input.agent_asset, "agent_asset");
+        const policy = await ctx.chain.policyVault();
+        const ksPda = (0, chain_1.deriveKillSwitchPda)(ctx.chain.cfg.programs.policyVault, agent);
+        const authPda = web3_js_1.PublicKey.findProgramAddressSync([POLICY_AUTHORITY_PREFIX, agent.toBuffer()], ctx.chain.cfg.programs.policyVault)[0];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ks = await policy.account.killSwitchState.fetchNullable(ksPda);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const auth = await policy.account.policyAuthority.fetchNullable(authPda);
+        const out = {
+            killSwitchPda: ksPda.toBase58(),
+            killSwitchExplorer: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", ksPda.toBase58()),
+            killSwitchExists: !!ks,
+            authorityPda: authPda.toBase58(),
+            authorityExplorer: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", authPda.toBase58()),
+            authorityExists: !!auth,
+        };
+        if (ks) {
+            out.killSwitch = {
+                paused: !!ks.paused,
+                scopeKind: Number(ks.scopeKind ?? 0),
+                scopeKeyHex: (0, common_1.bytesToHex)(ks.scopeKey ?? []),
+                pausedAtSlot: (0, common_1.toDecString)(ks.pausedAtSlot),
+                unpausedAtSlot: (0, common_1.toDecString)(ks.unpausedAtSlot),
+                pausedBy: (0, common_1.pubkeyOrNull)(ks.pausedBy),
+            };
+        }
+        if (auth) {
+            const members = (auth.members ?? []).map(common_1.pubkeyOrNull);
+            const memberCount = Number(auth.memberCount ?? 0);
+            out.authority = {
+                threshold: Number(auth.threshold ?? 0),
+                memberCount,
+                members: members.slice(0, memberCount),
+            };
+        }
+        return out;
+    },
+};
+//# sourceMappingURL=get-killswitch.js.map

package/dist/tools/read/get-killswitch.js.map

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

package/dist/tools/read/get-policy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `agenttrust_get_policy` — fetch a single PolicyAccount and return its
+ * decoded fields (counters + bitmasks + tier thresholds).
+ *
+ * Reads the PolicyAccount PDA derived from `(agent_asset, policy_id)`.
+ * Returns `{ exists: false, pda }` if the account is not initialized,
+ * which is the common case for an agent that hasn't called `init_policy`.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    agent_asset: z.ZodEffects<z.ZodString, string, string>;
+    policy_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    policy_id: number;
+    agent_asset: string;
+}, {
+    policy_id: number;
+    agent_asset: string;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface DecodedPolicy {
+    pda: string;
+    explorerUrl: string;
+    exists: boolean;
+    fields?: {
+        payerAgentAsset: string;
+        policyId: number;
+        enabledKindsBitmask: number;
+        gateMode: number;
+        spendingPerTxMax: string;
+        spendingDailyMax: string;
+        spendingWeeklyMax: string;
+        spendingTodayUsed: string;
+        spendingWeekUsed: string;
+        spendingTodayAnchor: string;
+        spendingWeekAnchor: string;
+        velocityWindowSecs: string;
+        velocityMaxInWindow: string;
+        velocityTier0DecayFactor: string;
+        minCounterpartyTier: number;
+        maxRiskScore: number;
+        minConfidence: number;
+        defaultUnratedTreatment: number;
+        requiredCapabilityHashHex: string;
+        acceptedAttestors: (string | null)[];
+        scopeKind: number;
+    };
+}
+export declare const getPolicyTool: Tool<Input, DecodedPolicy>;
+export {};

package/dist/tools/read/get-policy.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * `agenttrust_get_policy` — fetch a single PolicyAccount and return its
+ * decoded fields (counters + bitmasks + tier thresholds).
+ *
+ * Reads the PolicyAccount PDA derived from `(agent_asset, policy_id)`.
+ * Returns `{ exists: false, pda }` if the account is not initialized,
+ * which is the common case for an agent that hasn't called `init_policy`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPolicyTool = void 0;
+const zod_1 = require("zod");
+const chain_1 = require("../../chain");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const InputSchema = zod_1.z.object({
+    agent_asset: common_1.PubkeySchema.describe("Quantu agent asset pubkey (base58)"),
+    policy_id: zod_1.z.number().int().min(0).max(0xffffffff).describe("u32 per-agent policy ID"),
+});
+exports.getPolicyTool = {
+    name: "agenttrust_get_policy",
+    description: "Fetch the PolicyAccount on-chain for (agent_asset, policy_id). Returns " +
+        "decoded fields: spending caps, velocity window, counterparty-tier " +
+        "thresholds, RequireValidation capability hash, accepted attestors, and " +
+        "live counters (today/week spend used). exists=false when the policy has " +
+        "never been initialized.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const agent = (0, common_1.parsePubkey)(input.agent_asset, "agent_asset");
+        const pda = (0, chain_1.derivePolicyPda)(ctx.chain.cfg.programs.policyVault, agent, input.policy_id);
+        const policy = await ctx.chain.policyVault();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const data = await policy.account.policyAccount.fetchNullable(pda);
+        if (!data) {
+            return {
+                pda: pda.toBase58(),
+                explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", pda.toBase58()),
+                exists: false,
+            };
+        }
+        return {
+            pda: pda.toBase58(),
+            explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", pda.toBase58()),
+            exists: true,
+            fields: {
+                payerAgentAsset: (0, common_1.pubkeyOrNull)(data.payerAgentAsset) ?? "",
+                policyId: Number(data.policyId),
+                enabledKindsBitmask: Number(data.enabledKindsBitmask),
+                gateMode: Number(data.gateMode),
+                spendingPerTxMax: (0, common_1.toDecString)(data.spendingPerTxMax),
+                spendingDailyMax: (0, common_1.toDecString)(data.spendingDailyMax),
+                spendingWeeklyMax: (0, common_1.toDecString)(data.spendingWeeklyMax),
+                spendingTodayUsed: (0, common_1.toDecString)(data.spendingTodayUsed),
+                spendingWeekUsed: (0, common_1.toDecString)(data.spendingWeekUsed),
+                spendingTodayAnchor: (0, common_1.toDecString)(data.spendingTodayAnchor),
+                spendingWeekAnchor: (0, common_1.toDecString)(data.spendingWeekAnchor),
+                velocityWindowSecs: (0, common_1.toDecString)(data.velocityWindowSecs),
+                velocityMaxInWindow: (0, common_1.toDecString)(data.velocityMaxInWindow),
+                velocityTier0DecayFactor: (0, common_1.toDecString)(data.velocityTier0DecayFactor),
+                minCounterpartyTier: Number(data.minCounterpartyTier),
+                maxRiskScore: Number(data.maxRiskScore),
+                minConfidence: Number(data.minConfidence),
+                defaultUnratedTreatment: Number(data.defaultUnratedTreatment),
+                requiredCapabilityHashHex: (0, common_1.bytesToHex)(data.requiredCapabilityHash ?? []),
+                acceptedAttestors: (data.acceptedAttestors ?? []).map(common_1.pubkeyOrNull),
+                scopeKind: Number(data.scopeKind ?? 0),
+            },
+        };
+    },
+};
+//# sourceMappingURL=get-policy.js.map

package/dist/tools/read/get-policy.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * `agenttrust_get_quantu_reputation` — read the Quantu atom_stats PDA
+ * for an agent and surface the on-chain reputation tier + counts.
+ *
+ * Quantu's atom_stats account isn't in our IDL — we fetch raw account
+ * bytes and decode the byte-offset surface PolicyVault's AtomStats
+ * parser uses (`programs/policy-vault/src/ext/atom_stats.rs`). The
+ * exact offsets are pinned there; this tool mirrors them so what the
+ * gate sees is what the tool reports.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    agent_asset: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    agent_asset: string;
+}, {
+    agent_asset: string;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface Output {
+    pda: string;
+    explorerUrl: string;
+    exists: boolean;
+    /** Owner program — must equal Quantu atom_engine for the policy gate to honour it. */
+    ownerProgram: string | null;
+    ownerExpected: string;
+    ownerMatches: boolean;
+    reputation?: {
+        tier: number;
+        feedbackCount: string;
+        averageScore: number | null;
+        riskScore: number | null;
+        confidence: number | null;
+    };
+    rawByteLen: number;
+}
+export declare const getQuantuReputationTool: Tool<Input, Output>;
+export {};

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

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * `agenttrust_get_quantu_reputation` — read the Quantu atom_stats PDA
+ * for an agent and surface the on-chain reputation tier + counts.
+ *
+ * Quantu's atom_stats account isn't in our IDL — we fetch raw account
+ * bytes and decode the byte-offset surface PolicyVault's AtomStats
+ * parser uses (`programs/policy-vault/src/ext/atom_stats.rs`). The
+ * exact offsets are pinned there; this tool mirrors them so what the
+ * gate sees is what the tool reports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQuantuReputationTool = void 0;
+const zod_1 = require("zod");
+const chain_1 = require("../../chain");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const InputSchema = zod_1.z.object({
+    agent_asset: common_1.PubkeySchema.describe("Quantu agent asset pubkey"),
+});
+// PolicyVault's AtomStats byte-offset surface (mirrors
+// programs/policy-vault/src/ext/atom_stats.rs constants). We re-derive
+// here rather than import to keep the MCP package free of the on-chain
+// crate dep.
+const AS_TIER_OFFSET = 8 + 32; // post-discriminator + asset
+const AS_FEEDBACK_COUNT_OFFSET = AS_TIER_OFFSET + 1;
+const AS_AVERAGE_SCORE_OFFSET = AS_FEEDBACK_COUNT_OFFSET + 8;
+const AS_RISK_SCORE_OFFSET = AS_AVERAGE_SCORE_OFFSET + 1;
+const AS_CONFIDENCE_OFFSET = AS_RISK_SCORE_OFFSET + 1;
+exports.getQuantuReputationTool = {
+    name: "agenttrust_get_quantu_reputation",
+    description: "Read the Quantu atom_stats PDA for an agent and decode tier (0..3), " +
+        "feedback count, average score, risk score, and confidence. The same " +
+        "values PolicyVault's CounterpartyTier policy reads at gate time.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const agent = (0, common_1.parsePubkey)(input.agent_asset, "agent_asset");
+        const atomEngine = ctx.chain.cfg.quantu.atomEngine;
+        const pda = (0, chain_1.deriveAtomStatsPda)(ctx.chain.cfg.quantu, agent);
+        const accountInfo = await ctx.chain.connection.getAccountInfo(pda, "confirmed");
+        const out = {
+            pda: pda.toBase58(),
+            explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", pda.toBase58()),
+            exists: !!accountInfo,
+            ownerProgram: accountInfo?.owner.toBase58() ?? null,
+            ownerExpected: atomEngine.toBase58(),
+            ownerMatches: accountInfo ? accountInfo.owner.equals(atomEngine) : false,
+            rawByteLen: accountInfo?.data.length ?? 0,
+        };
+        if (!accountInfo)
+            return out;
+        const data = accountInfo.data;
+        if (data.length < AS_CONFIDENCE_OFFSET + 2)
+            return out;
+        out.reputation = {
+            tier: data.readUInt8(AS_TIER_OFFSET),
+            feedbackCount: (0, common_1.toDecString)(data.readBigUInt64LE(AS_FEEDBACK_COUNT_OFFSET)),
+            averageScore: data.readUInt8(AS_AVERAGE_SCORE_OFFSET),
+            riskScore: data.readUInt8(AS_RISK_SCORE_OFFSET),
+            confidence: data.readUInt16LE(AS_CONFIDENCE_OFFSET),
+        };
+        return out;
+    },
+};
+//# sourceMappingURL=get-quantu-reputation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-quantu-reputation.js","sourceRoot":"","sources":["../../../src/tools/read/get-quantu-reputation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,6BAAwB;AAExB,uCAAiD;AACjD,yCAA2C;AAC3C,sCAAmE;AAGnE,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAY,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAChE,CAAC,CAAC;AAqBH,uDAAuD;AACvD,uEAAuE;AACvE,uEAAuE;AACvE,aAAa;AACb,MAAM,cAAc,GAAc,CAAC,GAAG,EAAE,CAAC,CAAO,6BAA6B;AAC7E,MAAM,wBAAwB,GAAI,cAAc,GAAG,CAAC,CAAC;AACrD,MAAM,uBAAuB,GAAK,wBAAwB,GAAG,CAAC,CAAC;AAC/D,MAAM,oBAAoB,GAAQ,uBAAuB,GAAG,CAAC,CAAC;AAC9D,MAAM,oBAAoB,GAAQ,oBAAoB,GAAG,CAAC,CAAC;AAE9C,QAAA,uBAAuB,GAAwB;IAC1D,IAAI,EAAS,kCAAkC;IAC/C,WAAW,EACT,sEAAsE;QACtE,sEAAsE;QACtE,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;QAEF,IAAI,CAAC,WAAW;YAAE,OAAO,GAAG,CAAC;QAE7B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAEvD,GAAG,CAAC,UAAU,GAAG;YACf,IAAI,EAAY,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;YAC9C,aAAa,EAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;YAC3E,YAAY,EAAI,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;YACvD,SAAS,EAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;YACpD,UAAU,EAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC;SACxD,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/tools/read/get-validation-attestation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `agenttrust_get_validation_attestation` — query the ValidationRegistry
+ * for an attestation matching `(subject_asset, capability_hash)`.
+ *
+ * ValidationAttestation PDAs are keyed by (subject, capability, attestor),
+ * so a (subject, capability) pair may have 0..N attestations from
+ * different attestors. We list every match via getProgramAccounts +
+ * memcmp filters at offsets 8 and 40 (the layout pinned in
+ * `state/validation_attestation.rs`).
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    subject_asset: z.ZodEffects<z.ZodString, string, string>;
+    capability_hash: z.ZodEffects<z.ZodString, string, string>;
+    attestor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    subject_asset: string;
+    capability_hash: string;
+    attestor?: string | undefined;
+}, {
+    subject_asset: string;
+    capability_hash: string;
+    attestor?: string | undefined;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface AttestationRow {
+    pda: string;
+    explorerUrl: string;
+    attestor: string;
+    expiresAt: string;
+    issuedAt: string;
+    revoked: boolean;
+    revokedAt: string;
+    claimPayloadHashHex: string;
+    claimUriHashHex: string;
+}
+interface Output {
+    subjectAsset: string;
+    capabilityHashHex: string;
+    count: number;
+    attestations: AttestationRow[];
+}
+export declare const getValidationAttestationTool: Tool<Input, Output>;
+export {};

package/dist/tools/read/get-validation-attestation.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * `agenttrust_get_validation_attestation` — query the ValidationRegistry
+ * for an attestation matching `(subject_asset, capability_hash)`.
+ *
+ * ValidationAttestation PDAs are keyed by (subject, capability, attestor),
+ * so a (subject, capability) pair may have 0..N attestations from
+ * different attestors. We list every match via getProgramAccounts +
+ * memcmp filters at offsets 8 and 40 (the layout pinned in
+ * `state/validation_attestation.rs`).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getValidationAttestationTool = void 0;
+const bs58_1 = __importDefault(require("bs58"));
+const zod_1 = require("zod");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const InputSchema = zod_1.z.object({
+    subject_asset: common_1.PubkeySchema.describe("Quantu agent asset whose capability is being attested"),
+    capability_hash: common_1.HexHashSchema.describe("32-byte capability hash (hex)"),
+    attestor: common_1.PubkeySchema.optional()
+        .describe("Optional: filter to this attestor's attestation (returns 0 or 1)"),
+});
+// state/validation_attestation.rs layout — pinned offsets.
+const VA_SUBJECT_OFFSET = 8; // off  8..40
+const VA_CAPABILITY_OFFSET = 40; // off 40..72
+const VA_ATTESTOR_OFFSET = 72; // off 72..104
+exports.getValidationAttestationTool = {
+    name: "agenttrust_get_validation_attestation",
+    description: "Query the ValidationRegistry for ValidationAttestation PDAs matching " +
+        "(subject_asset, capability_hash). Each attestor produces a separate " +
+        "attestation; the optional `attestor` filter narrows to one. Returns " +
+        "expiresAt slot, revoked flag, claim payload hash — exactly the fields " +
+        "PolicyVault's RequireValidation policy reads at gate time.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const subject = (0, common_1.parsePubkey)(input.subject_asset, "subject_asset");
+        const capHash = (0, common_1.hexToBytes)(input.capability_hash);
+        if (capHash.length !== 32)
+            throw new Error("capability_hash must decode to 32 bytes");
+        const program = await ctx.chain.validationRegistry();
+        const filters = [
+            { memcmp: { offset: VA_SUBJECT_OFFSET, bytes: subject.toBase58() } },
+            { memcmp: { offset: VA_CAPABILITY_OFFSET, bytes: bs58_1.default.encode(capHash) } },
+        ];
+        if (input.attestor) {
+            const attestor = (0, common_1.parsePubkey)(input.attestor, "attestor");
+            filters.push({ memcmp: { offset: VA_ATTESTOR_OFFSET, bytes: attestor.toBase58() } });
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const accounts = await program.account.validationAttestation.all(filters);
+        const attestations = accounts.map(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (entry) => ({
+            pda: entry.publicKey.toBase58(),
+            explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", entry.publicKey.toBase58()),
+            attestor: (0, common_1.pubkeyOrNull)(entry.account.attestor) ?? "",
+            expiresAt: (0, common_1.toDecString)(entry.account.expiresAt),
+            issuedAt: (0, common_1.toDecString)(entry.account.issuedAt),
+            revoked: !!entry.account.revoked,
+            revokedAt: (0, common_1.toDecString)(entry.account.revokedAt),
+            claimPayloadHashHex: (0, common_1.bytesToHex)(entry.account.claimPayloadHash ?? []),
+            claimUriHashHex: (0, common_1.bytesToHex)(entry.account.claimUriHash ?? []),
+        }));
+        return {
+            subjectAsset: subject.toBase58(),
+            capabilityHashHex: (0, common_1.bytesToHex)(capHash),
+            count: attestations.length,
+            attestations,
+        };
+    },
+};
+//# sourceMappingURL=get-validation-attestation.js.map

package/dist/tools/read/get-validation-attestation.js.map

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

package/dist/tools/read/get-velocity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `agenttrust_get_velocity` — fetch the VelocityLedger PDA for
+ * (agent, policy_id). Returns the current sliding-window cumulative
+ * spend, last commit slot, and window start slot.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{
+    agent_asset: z.ZodEffects<z.ZodString, string, string>;
+    policy_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    policy_id: number;
+    agent_asset: string;
+}, {
+    policy_id: number;
+    agent_asset: string;
+}>;
+type Input = z.infer<typeof InputSchema>;
+interface Output {
+    pda: string;
+    explorerUrl: string;
+    exists: boolean;
+    ledger?: {
+        cumulativeAmount: string;
+        lastCommitSlot: string;
+        windowStartSlot: string;
+        policyId: number;
+    };
+}
+export declare const getVelocityTool: Tool<Input, Output>;
+export {};

package/dist/tools/read/get-velocity.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * `agenttrust_get_velocity` — fetch the VelocityLedger PDA for
+ * (agent, policy_id). Returns the current sliding-window cumulative
+ * spend, last commit slot, and window start slot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVelocityTool = void 0;
+const zod_1 = require("zod");
+const chain_1 = require("../../chain");
+const config_1 = require("../../config");
+const common_1 = require("../common");
+const InputSchema = zod_1.z.object({
+    agent_asset: common_1.PubkeySchema.describe("Quantu agent asset"),
+    policy_id: zod_1.z.number().int().min(0).max(0xffffffff).describe("u32 policy ID"),
+});
+exports.getVelocityTool = {
+    name: "agenttrust_get_velocity",
+    description: "Fetch the VelocityLedger PDA for (agent, policy_id). Returns the " +
+        "cumulative-spend counter, last commit slot, and the slot the current " +
+        "window opened. Compare against the policy's velocity_max_in_window to " +
+        "see how much budget remains in the window.",
+    inputSchema: InputSchema,
+    async handler(input, ctx) {
+        const agent = (0, common_1.parsePubkey)(input.agent_asset, "agent_asset");
+        const pda = (0, chain_1.deriveVelocityPda)(ctx.chain.cfg.programs.policyVault, agent, input.policy_id);
+        const policy = await ctx.chain.policyVault();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const data = await policy.account.velocityLedger.fetchNullable(pda);
+        if (!data) {
+            return {
+                pda: pda.toBase58(),
+                explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", pda.toBase58()),
+                exists: false,
+            };
+        }
+        return {
+            pda: pda.toBase58(),
+            explorerUrl: (0, config_1.explorerUrl)(ctx.chain.cfg, "address", pda.toBase58()),
+            exists: true,
+            ledger: {
+                cumulativeAmount: (0, common_1.toDecString)(data.cumulativeAmount),
+                lastCommitSlot: (0, common_1.toDecString)(data.lastCommitSlot),
+                windowStartSlot: (0, common_1.toDecString)(data.windowStartSlot),
+                policyId: Number(data.policyId ?? input.policy_id),
+            },
+        };
+    },
+};
+//# sourceMappingURL=get-velocity.js.map

package/dist/tools/read/get-velocity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-velocity.js","sourceRoot":"","sources":["../../../src/tools/read/get-velocity.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6BAAwB;AAExB,uCAAgD;AAChD,yCAA2C;AAC3C,sCAAmE;AAGnE,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAY,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACxD,SAAS,EAAI,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC/E,CAAC,CAAC;AAeU,QAAA,eAAe,GAAwB;IAClD,IAAI,EAAS,yBAAyB;IACtC,WAAW,EACT,mEAAmE;QACnE,uEAAuE;QACvE,wEAAwE;QACxE,4CAA4C;IAC9C,WAAW,EAAE,WAAW;IAExB,KAAK,CAAC,OAAO,CAAC,KAAY,EAAE,GAAgB;QAC1C,MAAM,KAAK,GAAG,IAAA,oBAAW,EAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAK,IAAA,yBAAiB,EAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7C,8DAA8D;QAC9D,MAAM,IAAI,GAAQ,MAAO,MAAM,CAAC,OAAe,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,GAAG,EAAU,GAAG,CAAC,QAAQ,EAAE;gBAC3B,WAAW,EAAE,IAAA,oBAAW,EAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;gBAClE,MAAM,EAAO,KAAK;aACnB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,EAAU,GAAG,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,IAAA,oBAAW,EAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;YAClE,MAAM,EAAO,IAAI;YACjB,MAAM,EAAE;gBACN,gBAAgB,EAAE,IAAA,oBAAW,EAAC,IAAI,CAAC,gBAAgB,CAAC;gBACpD,cAAc,EAAI,IAAA,oBAAW,EAAC,IAAI,CAAC,cAAc,CAAC;gBAClD,eAAe,EAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,eAAe,CAAC;gBACnD,QAAQ,EAAU,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC;aAC3D;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/read/list-facilitators.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `agenttrust_list_facilitators` — return the active facilitator
+ * adapter registry as a static manifest. Mirrors the four adapters
+ * shipped in `trustgate/server/src/facilitators/`: Pay.sh (live),
+ * Dexter / atxp / MCPay.
+ *
+ * Manifest is a static module-local constant. The MCP server doesn't
+ * boot the Express service, so dynamically introspecting a live
+ * `FacilitatorRegistry` would require an extra dependency the SDK
+ * doesn't expose. Per the registry/dispatch shape in
+ * `trustgate/server/src/facilitators/index.ts`, the four adapters and
+ * their protocols/status are pinned values that stay in sync with that
+ * file by review.
+ */
+import { z } from "zod";
+import type { Tool } from "../types";
+declare const InputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+type Input = z.infer<typeof InputSchema>;
+interface FacilitatorEntry {
+    name: string;
+    description: string;
+    protocols: string[];
+    status: "live" | "in-flight" | "roadmap";
+    docsPath: string;
+}
+interface Output {
+    count: number;
+    facilitators: FacilitatorEntry[];
+}
+export declare const listFacilitatorsTool: Tool<Input, Output>;
+export {};