@kya-brasil/agent-tools 0.5.1 → 0.5.3

package/README.md

@@ -105,7 +105,7 @@ import { createKyaClient, signChallengeWithEvmKey, signWithECnpj } from "@kya-br
 import { readFileSync } from "node:fs";
 
 const kya = createKyaClient({ privateKey: payerPk });
-const reg = await kya.register({                                           // $0.50
+const reg = await kya.register({                                           // $0.25
   agent: { kind: "evm", id: agentAddress },
   cnpj: "11.222.333/0001-81",
   mandate: {
@@ -141,7 +141,7 @@ Renew every 90 days (`kya.renew` then `kya.renewProve`), revoke at once (`kya.re
 | verify, verifyByKey, prove, renewProve, revoke, revocations, companyAgents, setCompanyWebhook | free |
 | verified (signed receipt, no limit), allowed (signed verdict) | 0.01 |
 | renew | 0.10 |
-| register | 0.50 |
+| register | 0.25 |
 
 Schemas and keys: `/.well-known/kya-mandate.schema.json`, `/.well-known/kya.json`, `/openapi.json`, `/llms.txt`.
 Legal entities only: no CPF is stored; the e-CNPJ signer is recorded by certificate hash.

package/dist/index.d.ts

@@ -56,7 +56,7 @@ export interface Credential {
         signed_at: string;
     };
     mandate: Mandate;
-    /** Informative; null when the issuer has no KYB source. */
+    /** Kept for /v1 compatibility; always null from this issuer since D-23. */
     kyb_snapshot: Record<string, unknown> | null;
     status: CredentialStatus;
     issued_at: string;
@@ -177,7 +177,7 @@ export interface KyaClient {
     }>;
     /** $0.01: signed verdict, is this action inside the mandate and is the credential active? */
     allowed(credentialId: string, q: ActionQuery): Promise<Verdict>;
-    /** $0.50: register an agent for a company; returns the challenge both parties sign. */
+    /** $0.25: register an agent for a company; returns the challenge both parties sign. */
     register(input: {
         agent: AgentKey;
         cnpj: string;
@@ -185,7 +185,7 @@ export interface KyaClient {
     }): Promise<Registration>;
     /** Free: send both signatures; the credential is issued if the e-CNPJ is valid and not revoked, the CNPJ matches and the company is ATIVA. */
     prove(credentialId: string, proof: Proof): Promise<{
-        credential: Credential;
+        credential: Credential; /** /v1 compatibility, always empty. */
         kyb_warnings: string[];
     }>;
     /** $0.10: renewal challenge (then renewProve). */
@@ -198,7 +198,7 @@ export interface KyaClient {
         };
     }>;
     renewProve(credentialId: string, proof: Proof): Promise<{
-        credential: Credential;
+        credential: Credential; /** /v1 compatibility, always empty. */
         kyb_warnings: string[];
     }>;
     /** Free: the company revokes at once. signed_text must be "KYA Brasil: revoke <id>\n<nonce>", signed with the e-CNPJ. */

package/dist/index.js

@@ -10,7 +10,7 @@
  *     tools for your agent framework: toOpenAI(kya), toVercelAI(kya, { tool, jsonSchema }), toLangChain(kya, tool), toAnthropic(kya)
  *
  *   Company (you give your own agent a credential):
- *     const reg = await kya.register({ agent: { kind: "evm", id: address }, cnpj, mandate });   // $0.50, returns a challenge
+ *     const reg = await kya.register({ agent: { kind: "evm", id: address }, cnpj, mandate });   // $0.25, returns a challenge
  *     const agent_signature = await signChallengeWithEvmKey(agentPrivateKey, reg.challenge.text);
  *     const ecnpj_signature = await signWithECnpj({ certificatePem, privateKeyPem, chainPem }, reg.challenge.text);
  *     const issued = await kya.prove(reg.credential_id, { challenge_id: reg.challenge.id, agent_signature, ecnpj_signature });
@@ -75,7 +75,7 @@ export function createKyaClient(opts = {}) {
         verifyByKey: (agent) => call("GET", `/v1/agents/by-key${q({ kind: agent.kind, id: agent.id })}`),
         verified: (id) => call("GET", `/v1/agents/${encodeURIComponent(id)}/verified`, undefined, true, 0.01),
         allowed: (id, a) => call("GET", `/v1/agents/${encodeURIComponent(id)}/allowed${q(a)}`, undefined, true, 0.01),
-        register: (input) => call("POST", "/v1/agents", input, true, 0.5),
+        register: (input) => call("POST", "/v1/agents", input, true, 0.25),
         prove: (id, proof) => call("POST", `/v1/agents/${encodeURIComponent(id)}/prove`, proof),
         renew: (id) => call("POST", `/v1/agents/${encodeURIComponent(id)}/renew`, {}, true, 0.1),
         renewProve: (id, proof) => call("POST", `/v1/agents/${encodeURIComponent(id)}/renew/prove`, proof),
@@ -95,7 +95,7 @@ export function createKyaClient(opts = {}) {
     client.tools = [
         {
             name: "kya_verify", priceUsd: 0,
-            description: "Free. Is this AI agent credentialed by a Brazilian company? Returns the credential (company CNPJ and name, mandate, KYB snapshot), its live status (active, suspended, revoked, expired) and history. Give credential_id, or the agent key (kind + id) to look it up.",
+            description: "Free. Is this AI agent credentialed by a Brazilian company? Returns the credential (company CNPJ and name, mandate), its live status (active, suspended, revoked, expired) and history. Give credential_id, or the agent key (kind + id) to look it up.",
             parameters: { type: "object", properties: { credential_id: ID, kind: { type: "string", enum: ["evm", "web-bot-auth", "erc8004"] }, id: { type: "string", description: "0x address, base64url Ed25519 key, or eip155:<chainId>:<registry>:<agentId>" } }, additionalProperties: false },
             execute: async (a) => (a.credential_id ? client.verify(String(a.credential_id)) : client.verifyByKey({ kind: a.kind, id: String(a.id) }))
         },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kya-brasil/agent-tools",
-  "version": "0.5.1",
-  "description": "KYA Brasil for AI agents: verify that an agent acts for a Brazilian company (e-CNPJ-signed credential, revocation and company registration checked daily), check an action against its mandate, or give your own agent a credential. Sign in with KYA middleware (Hono, Express, Workers) and request signing. x402 payments (USDC on Base) handled for you. Adapters for Vercel AI SDK, LangChain, OpenAI and Anthropic.",
+  "version": "0.5.3",
+  "description": "KYA Brasil for AI agents: verify that an agent acts for a Brazilian company (e-CNPJ-signed credential, revocation and company registration checked daily against the Receita's open data, no third-party service), check an action against its mandate, or give your own agent a credential. Sign in with KYA middleware (Hono, Express, Workers) and request signing. x402 payments (USDC on Base) handled for you. Adapters for Vercel AI SDK, LangChain, OpenAI and Anthropic.",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",