@workforcerail/sdk

Official SDK for WorkforceRail — HR and identity governance for AI agents.

WorkforceRail is the reference implementation of the open WFRS-v1, AIS-v1, ATSS-v1, and ACCS-v1 standards published by the AuthorityRail Standards Foundation. Every AI agent gets a cryptographically signed Agent Identity Certificate (AIC), a persistent trust score, a tier ladder, and a complete EU AI Act–ready audit trail.

Install

npm install @workforcerail/sdk

Quickstart

import { WorkforceRail } from "@workforcerail/sdk";

const wfr = new WorkforceRail({ apiKey: process.env.WFR_API_KEY!, orgId: "acme-corp" });

const agent = await wfr.register({
  display_name: "Research Assistant",
  model_version: "claude-opus-4-6",
  model_provider: "anthropic",
});

console.log("AIC signature:", agent.aic.signature);
console.log("Verify at:", agent.aic.verify_url);

Verify any agent without credentials

import { WorkforceRail } from "@workforcerail/sdk";

const verification = await WorkforceRail.verifyAIC("urn:ar:agent:xxxx");
if (verification.valid) {
  console.log(`Tier ${verification.current_tier} ${verification.tier_label}`);
  console.log(`Trust score: ${verification.trust_score}`);
}

Methods

| Method | Purpose | |---|---| | register(config) | Provision an agent, receive signed AIC | | getAgent(agentId) | Fetch full agent passport | | getTrustScore(agentId) | Global trust score + 30-day trend | | reportIncident(agentId, { level, reason }) | Apply L1–L6 consequence | | getForensicExport(agentId) | EU AI Act compliance package | | WorkforceRail.verifyAIC(agentId) | Public verification (static) |

Open Standards

• WFRS-v1 — Workforce Record Standard
• AIS-v1 — Agent Identity Standard (the AIC format)
• ATSS-v1 — Agent Trust Score Standard (0–100 scoring model)
• ACCS-v1 — Agent Code of Conduct Standard (8 principles + consequence ladder)

Full specifications: https://workforcerail.com/standards

License

MIT