@kya-brasil/agent-tools 0.4.0 → 0.4.1

package/README.md

@@ -1,7 +1,7 @@
 # @kya-brasil/agent-tools
 
 **Know-your-agent for Brazil, as code.** Verify that an AI agent really acts for a Brazilian company
-(credential signed by the company's e-CNPJ, company cleared by [KYB Brasil](https://kyb-br-agents.marcelfons.workers.dev)),
+(credential signed by the company's e-CNPJ, checked against its AC's revocation list, company active at the Receita Federal),
 check an action against the agent's mandate, or give your own agent a credential.
 
 Paid per call with [x402](https://x402.org) (USDC on Base, no signup). Free verification works without a wallet
@@ -11,6 +11,9 @@ Paid per call with [x402](https://x402.org) (USDC on Base, no signup). Free veri
 npm i @kya-brasil/agent-tools
 ```
 
+The same build is mirrored to GitHub Packages as `@celfons/kya-agent-tools` (listed on the repository page;
+installing from there needs a GitHub token). npmjs.com is the channel to install from.
+
 Node 18+ (global `fetch`, WebCrypto). ESM.
 
 ## Verifier: you receive an action from someone else's agent

package/dist/index.d.ts

@@ -56,7 +56,8 @@ export interface Credential {
         signed_at: string;
     };
     mandate: Mandate;
-    kyb_snapshot: Record<string, unknown>;
+    /** Informative; null when the issuer has no KYB source. */
+    kyb_snapshot: Record<string, unknown> | null;
     status: CredentialStatus;
     issued_at: string;
     expires_at: string;
@@ -196,7 +197,7 @@ export interface KyaClient {
         cnpj: string;
         mandate: Mandate;
     }): Promise<Registration>;
-    /** Free: send both signatures; the credential is issued if the e-CNPJ, the CNPJ and KYB Brasil all clear. */
+    /** 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;
         kyb_warnings: string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kya-brasil/agent-tools",
-  "version": "0.4.0",
-  "description": "KYA Brasil for AI agents: verify that an agent acts for a Brazilian company (e-CNPJ-signed, KYB-checked credential), 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.4.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.",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",