Standardize trust-verification action schemas and fix MCP compatibility

schemas/trust-verification/endorse/schema.v1.json

@@ -0,0 +1,24 @@
+{
+  "clas": "clas.endorse.v1",
+  "action": "endorse",
+  "namespace": "endorseagent.eth",
+  "version": "v1",
+  "family": "trust-verification",
+  "status": "planned",
+  "input": {
+    "type": "object",
+    "additionalProperties": true
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": true
+  },
+  "verification": {
+    "emits_receipt": true,
+    "receipt_schema": "cl.receipt.v1",
+    "verify_with": "verifyagent.eth",
+    "signature_algorithm": "Ed25519",
+    "hash": "SHA-256",
+    "canonicalization": "json.sorted_keys.v1"
+  }
+}

schemas/trust-verification/sign/schema.v1.json

@@ -0,0 +1,24 @@
+{
+  "clas": "clas.sign.v1",
+  "action": "sign",
+  "namespace": "signagent.eth",
+  "version": "v1",
+  "family": "trust-verification",
+  "status": "planned",
+  "input": {
+    "type": "object",
+    "additionalProperties": true
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": true
+  },
+  "verification": {
+    "emits_receipt": true,
+    "receipt_schema": "cl.receipt.v1",
+    "verify_with": "verifyagent.eth",
+    "signature_algorithm": "Ed25519",
+    "hash": "SHA-256",
+    "canonicalization": "json.sorted_keys.v1"
+  }
+}

schemas/trust-verification/signing/schema.v1.json

@@ -1,7 +1,9 @@
 {
-  "clas": "clas.signing.v1",
-  "action": "signing",
-  "namespace": "signingagent.eth",
+  "_deprecated": true,
+  "_note": "This file is superseded by schemas/trust-verification/sign/schema.v1.json. The action canonical name is 'sign', not 'signing'. Retained for backwards-compat discovery only.",
+  "clas": "clas.sign.v1",
+  "action": "sign",
+  "namespace": "signagent.eth",
   "version": "v1",
   "family": "trust-verification",
   "status": "planned",

src/index.js

@@ -22,7 +22,10 @@ const TOOL_DEFS = [
   ['verify_receipt',         { receipt: receiptSchema },            verifyReceipt],
   ['resolve_agent',          { agent: z.string() },                 resolveAgent],
   ['get_protocol_version',   {},                                    getProtocolVersion],
-  ['validate_receipt_schema',{ receipt: z.unknown() },              validateReceiptSchema],
+  // z.record(z.string(), z.unknown()) is the correct MCP-compatible object
+  // schema for validate_receipt_schema: the handler re-parses with receiptSchema
+  // internally. z.unknown() is not permitted as an MCP inputSchema shape.
+  ['validate_receipt_schema',{ receipt: z.record(z.string(), z.unknown()) }, validateReceiptSchema],
 ];
 
 const mcpLimiter = rateLimit({

src/registry/actions.js

@@ -46,11 +46,11 @@ export const TRUST_ACTIONS = [
   },
   {
     agent: 'signagent.eth', action: 'sign', namespace: 'signagent.eth', status: 'planned', family: 'trust-verification', clas: 'clas.sign.v1', mcp_compatible: true, receipts: true,
-    description: TRUST_ACTION_DEFINITIONS.sign, schema_path: 'schemas/trust-verification/signing/schema.v1.json'
+    description: TRUST_ACTION_DEFINITIONS.sign, schema_path: 'schemas/trust-verification/sign/schema.v1.json'
   },
   {
     agent: 'endorseagent.eth', action: 'endorse', namespace: 'endorseagent.eth', status: 'planned', family: 'trust-verification', clas: 'clas.endorse.v1', mcp_compatible: true, receipts: true,
-    description: TRUST_ACTION_DEFINITIONS.endorse, schema_path: 'schemas/trust-verification/endorsing/schema.v1.json'
+    description: TRUST_ACTION_DEFINITIONS.endorse, schema_path: 'schemas/trust-verification/endorse/schema.v1.json'
   }
 ];