@rankigi/sdk

Tamper-evident audit trails for AI agents. Non-blocking, zero-overhead governance that never impacts your agent's critical path.

Install

npm install @rankigi/sdk

Quick Start

import { Rankigi } from "@rankigi/sdk";

const rankigi = new Rankigi({
  apiKey: process.env.RANKIGI_API_KEY!,
  agentId: process.env.RANKIGI_AGENT_ID!,
});

// Track a tool call — input/output are SHA-256 hashed before transmission
await rankigi.trackToolCall("web_search", { query: "Q4 revenue" }, results);

// Track with intent reasoning (encrypted with AES-256-GCM)
await rankigi.trackWithIntent(
  "web_search",
  { query: "Q4 revenue" },
  results,
  "User asked about quarterly financials, searching for latest data"
);

// Track agent output
await rankigi.trackAgentOutput("The Q4 revenue was $12M.");

// Track errors
await rankigi.trackError(new Error("API timeout"));

// Track custom events
await rankigi.trackCustomEvent("policy_check", { rule: "pii_filter", passed: true });

LangChain Integration

import { RankigiCallbackHandler } from "@rankigi/sdk/langchain";

const handler = new RankigiCallbackHandler({
  apiKey: process.env.RANKIGI_API_KEY!,
  agentId: process.env.RANKIGI_AGENT_ID!,
});

// Add to any LangChain agent — governance is now automatic
const executor = new AgentExecutor({
  agent,
  tools,
  callbacks: [handler],
});

Features

• Non-blocking — all tracking is async and errors are silently swallowed
• Privacy-first — inputs/outputs are SHA-256 hashed before transmission
• Intent Chain — optional AES-256-GCM encrypted agent reasoning
• Passport signing — Ed25519 event signatures for tamper-evident chains
• LangChain support — drop-in callback handler for automatic governance
• Zero dependencies — uses Node.js built-in crypto module

Configuration

const rankigi = new Rankigi({
  apiKey: "rk_live_...",           // Required: API key from /dashboard/keys
  agentId: "your-agent-uuid",     // Required: Agent ID from /dashboard/agents
  baseUrl: "https://rankigi.com", // Optional: custom deployment URL
  onError: (err) => log(err),     // Optional: error callback
  signingKey: "base64...",         // Optional: Ed25519 private key for passport signing
  passportId: "passport-uuid",    // Optional: passport ID for event signing
  intentKey: "hex-string",        // Optional: AES-256 key for intent chain encryption
});

Documentation

Full documentation at rankigi.com/docs

License

MIT