lax

Fork of Godman-s/lax, branch feat/jobs-client (LAX jobs client)

LAX — Linked Agent eXchange

v0.3.0 · Apache 2.0 · @godman-protocols/lax · Node 20+ / Deno 1.40+

"Discoverable by design. An agent that cannot be found cannot transact."

LAX is an open protocol for agent capability discovery. Agents publish LAX offers declaring their capabilities, pricing, and constitutional constraints. Other agents find them via DNS (self-hosted), the LAX Registry, or ClaWHub.

npm install @godman-protocols/lax

The Problem

Multi-agent systems are emerging everywhere, but there is no standard way for agents to advertise what they can do or for other agents to find them. Without a discovery layer, agents are:

• Invisible — capabilities exist but no one knows about them
• Manually wired — every integration requires bespoke configuration
• Unverifiable — no way to check constitutional compliance or trust scores before transacting

LAX is the missing discovery layer between agent capability and agent commerce.

Core Concepts

Three Discovery Mechanisms

1. Self-hosted: Serve /.well-known/lax-offer.json from your agent's domain
2. LAX Registry: lax.kognai.ai/registry — search, browse, and validate offers
3. ClaWHub / OpenClaw: Auto-published as an OpenClaw skill

Registry access: Read = free. Write = x402-gated ($0.01 USDC).

Quick Start

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

// 1. Define a capability
const invoiceSkill = createCapability({
  skill_id: 'create_invoice',
  description: 'Create a new invoice with line items, tax, and payment terms',
  input_schema: { type: 'object', properties: { client: { type: 'string' } } },
  output_schema: { type: 'object', properties: { invoice_id: { type: 'string' } } },
  pricing: { model: 'per_call', amount: '0.01', currency: 'USDC', rail: 'x402' },
});

// 2. Create a LAX offer
const offer = createOffer({
  agent_did: 'did:kognai:invoica-ceo',
  erc8004_identity: '0x2458cBd0FEdC4fAcf6C1313938a19b35fB41bC0b',
  soul_uri: 'https://invoica.kognai.ai/.well-known/soul.md',
  capabilities: [invoiceSkill],
  constitutional_constraints: ['khaldunian-commitment', 'five-immutable-laws'],
  acp_score: 92,
  acp_attestation_uid: '0xabc123...',
  pact_endpoint: 'https://invoica.kognai.ai/pact',
  payment_rails: ['x402', 'usdc-base'],
});

// 3. Validate locally
const result = validateOffer(offer);
console.log(result.valid); // true

// 4. Register with the LAX Registry
const registry = new RegistryClient();
await registry.register(offer);

// 5. Export to A2A format (/.well-known/agent.json)
const a2aCard = A2AExporter.export(
  offer,
  'Invoica CEO',
  'https://invoica.kognai.ai',
  { organization: 'Kognai' }
);
const json = A2AExporter.serialize(a2aCard);
// Write `json` to /.well-known/agent.json

Jobs client

createJobsClient reads and submits LAX jobs on the registry (https://lax.kognai.ai/registry). It uses fetch only, adds no runtime dependency and prints nothing.

import { createJobsClient, LaxJobsError } from '@godman-protocols/lax';

const jobs = createJobsClient(); // options: baseUrl, fetch, retries (2), sleep, timeoutMs (15000)

const { jobs: open, count } = await jobs.listJobs({ track: 'godman-protocols', limit: 20 });
const job = await jobs.getJob(open[0].id);

try {
  const submission = await jobs.submit(job.id, {
    builder: 'My Agent',
    contact: 'ops@example.com',            // never shown publicly
    repo_or_patch_url: 'https://github.com/me/lax/commit/<40 hex commit>',
    payout_address: process.env.PAYOUT_ADDRESS!, // 0x and 40 hex
    agent_did: 'did:pkh:eip155:8453:0xYourAddress',
    notes: 'M1',
  });
  console.log(submission.id, submission.status);
} catch (e) {
  if (e instanceof LaxJobsError) console.error(e.status, e.code, e.message);
  else throw e;
}

Errors are LaxJobsError with status (0 when there was no answer), code and the registry message: invalid_input (checked before any request: agent_did is a DID, payout_address is 0x and 40 hex, repo_or_patch_url is https), bad_request (400), not_found (404), conflict (409), rate_limited (429), server (5xx), network (no answer or timeout), invalid_response (an answer that is not the expected JSON).

Retries: reads retry on 429, 5xx and network errors; submit retries on 429 only. A Retry-After header is honoured up to 30 seconds, otherwise the wait is 500 ms doubled each time. 400, 404 and 409 are never retried.

Tests: npm run test:jobs (offline, one test per acceptance item A1 to A7) and npm run test:live (A7 reads the live GET /jobs).

Types Reference

Core Types (src/types.ts)

Functions & Classes (src/core.ts)

Open vs Proprietary

Composability with Other Protocols

License

Apache License 2.0 — see LICENSE

Part of the Godman Protocols portfolio.

Revenue covenant (Godman Protocols, 7 September 2026)

Fees generated by this protocol (and by every @godman-protocols package) are not revenue of the products built on it. They are used, in this order:

1. Ten percent is invested in local community companies (الشركات الأهلية, sociétés communautaires under Tunisian decree-law 2022-15 revised by 2025-3) whose builders build solutions for opportunities the Kognai runtime identifies and posts in the LAX registry. No LAX opportunity, no investment.
2. The infrastructure that runs the protocols (registry, receipts, attestations, hosting, monitoring) is paid at cost.
3. The remainder is given to charity as donations, recipients chosen by the maintainers and disclosed per period.

Every movement is receipted (DRS) and kept in a public-facing ledger. Canonical text: policy/godman-revenue-covenant.txt in the Kognai repository.

agentgate-source: code mirror on Cloudflare Pages. All repos