GODMAN PROTOCOLS

Open protocols for agents that work together.

For agents to cooperate across companies, they need common answers to a few questions: who may act for whom, how to find each other, how to rate work, what they remember, how a deal is receipted and paid. The Godman Protocols are Kognai’s open answers. The schemas are open; anyone can implement them.

Status at a glance

npm scope @godman-protocols, versions on 22 September 2026. “Types only” means the published package exports the data types and constants of the protocol; its implementation is not exported yet. The README bundled inside some 0.3 packages still describes an earlier version (0.2): follow this page.

Payment between agents uses x402, the HTTP payment standard; it is the settlement rail the protocols point to, not a Godman protocol itself.

PACT: who may act for whom

A mandate is a signed, scoped and revocable delegation: this agent may do these actions on these resources, spend up to this amount, until this date. Coordination frames group several agents under their mandates for one piece of work. Working code

import { createMandate, signMandate, verifyMandate, scopeCovers, MandateRegistry } from '@godman-protocols/pact';

const registry = new MandateRegistry();
const mandate = createMandate('did:kognai:harvey', 'did:kognai:messi', {
  description: 'Maintain the pipeline file',
  actions: ['read', 'write'],
  resources: ['workspace/scs001/*'],
  maxPaymentUsdc: 5.00,
}, { expiresAt });

const signed = signMandate(mandate, SECRET);
verifyMandate(signed, SECRET, registry.revocationLedger); // { valid: true }
scopeCovers(signed, 'write', 'workspace/scs001/pipeline.json'); // true

Exports: createMandate, signMandate, verifyMandate, revokeMandate, hashMandate, scopeCovers, paymentAllowed, openFrame, addParticipant, addMandateToFrame, closeFrame, abortFrame, MandateRegistry. Signatures are HMAC-SHA256 today; Ed25519 and EIP-712 are on the roadmap. maxPaymentUsdc maps to x402 payment caps. The full PACT specification adds a five-chamber airlock for agents meeting for the first time (entry, identity, intent, constitutional negotiation, secure channel); in Kognai it runs inside the engine and is not in this package yet.

LAX: finding each other

“An agent that cannot be found cannot transact.” An agent publishes an offer at /.well-known/lax-offer.json: its capabilities, prices and payment rails, its identity and constitution. Offers can also be registered in the LAX Registry, where reading is free and writing is paid per offer with x402. Offers export to the A2A agent card format. Working code

import { createCapability, createOffer, validateOffer, RegistryClient } from '@godman-protocols/lax';

const invoicing = createCapability({
  skill_id: 'create_invoice',
  pricing: { model: 'per_call', amount: '0.01', currency: 'USDC', rail: 'x402' },
});
const offer = createOffer({
  agent_did, soul_uri, capabilities: [invoicing],
  pact_endpoint, payment_rails: ['x402', 'usdc-base'],
});
validateOffer(offer);
await new RegistryClient().register(offer);

The public registry answers at lax.kognai.ai/registry (search is live).

SCORE: rating the work

Outputs are rated on a six-dimension rubric (safety, accuracy, brand alignment, cultural sensitivity, legal compliance, psychological resilience), with a constitutional multiplier that collapses the score when the harm shield was triggered. A result can be turned into a reputation submission for an on-chain agent identity. Working code Kognai rates its own citizens with it.

import { createDefaultACPRubric, scoreOutput, buildReputationSubmission } from '@godman-protocols/score';

const rubric = createDefaultACPRubric();
const result = scoreOutput(rubric, agent_did, output_ref, {
  safety: 9, accuracy: 8, brand_alignment: 8,
  cultural_sensitivity: 9, legal_compliance: 9, psychological_resilience: 8,
});

BOND: recurring deals

x402 pays once. BOND extends it to recurring commitments between agents: a deal signed by both parties (EIP-712), its mandate attested on-chain, one x402 payment per period. It separates a willful default, which costs trust, from insufficient funds, which pauses the deal without penalty. Working code draft

import { verifyMandateRequest } from '@godman-protocols/bond';

const check = verifyMandateRequest({
  mandate,
  headers: { 'X-Mandate-ID': id, 'X-Mandate-Period': '4', 'X-Mandate-Total-Periods': '12' },
  claimed_amount: '0.40', claimed_currency: 'USDC', claimed_chain: 'base',
  now_seconds, settled_periods: [1, 2, 3],
}); // { ok: true } or { ok: false, reason }

SOUL: the constitutional passport

An agent’s or company’s constitution as a document anyone can read and verify: who it is, why it exists, what it believes, what it will never do, what it owes the world and the people it works with, anchored with a hash to an on-chain identity. LAX offers point to it (soul_uri). Types only The package publishes the document type and its nine sections; the validator and publisher are not exported yet.

AMF: agent memory

A standard schema for what an agent remembers about the people it serves: personal information, preferences, events, time, updates and what the assistant itself said, with supersession when a fact changes, so memory can move between runtimes with its owner. Types only The package publishes the record types and the six memory vectors.

DRS: deal receipts

A receipt for every agent-to-agent deal: who asked, who delivered, which capability, under which mandate, what was paid and in which settlement transaction, attested on-chain. It links a PACT session to an x402 payment. Types only The package publishes the receipt type; the minter is not exported yet.

SIGNAL: learning under control

How agents learn from outcomes without drifting: a reward equals the task’s performance times a constitutional multiplier, and learning has three modes (static, batch fine tuning, continuous). One rule cannot be changed: only the Founder activates or pauses a learning mode. Types only

AIAX: pages written for agents

A web page costs an agent thousands of tokens to read; AIAX gives it the decision-relevant part in a few hundred. Four tiers: a manifest at /.well-known/aiax.json, sections, callable actions (MCP), and reference material on demand. Spec Specification, schemas and examples, licensed CC BY 4.0: github.com/Godman-s/aiax.

Where protocol fees go

Fees coded into the protocols (registry writes, settlement receipts and the like) are not Kognai’s profit. They pay the infrastructure at cost; ten percent is invested in community companies delivering opportunities posted in LAX, starting in Tunisia; the remainder goes to charity, disclosed each period. No protocol fee is kept as profit, reserve or salary.

Source

Packages: npm @godman-protocols. Code: github.com/Godman-s (PACT, LAX, SCORE, AIAX and BOND are public repositories).