@coderifts/sdk

Agent Governance SDK for the CodeRifts API. Validate API changes before tool invocations in AI agent infrastructure (LangChain, AutoGen, Copilot, Claude, Grok, etc.).

Installation

npm install @coderifts/sdk

Quick Start

import { CodeRifts } from '@coderifts/sdk';

const client = new CodeRifts({ apiKey: 'cr_live_...' });

const result = await client.preflightCheck({
  tool_name: 'get_refund_status',
  old_spec: oldYaml,
  new_spec: newYaml,
});

if (!result.safe) {
  console.error('Blocked:', result.decision, result.reflex_triggers);
  process.exit(1);
}

Methods

preflightCheck(options)

Check whether it is safe to proceed with a tool invocation.

const result = await client.preflightCheck({
  tool_name: 'get_refund_status',
  old_spec: '...',
  new_spec: '...',
});
// result.decision: 'BLOCK' | 'REQUIRE_APPROVAL' | 'WARN' | 'ALLOW'
// result.omega_api: number
// result.safe: boolean
// result.reflex_triggers: Array<{ rule: string; decision: string }>
// result.affected_tools: Array<{ tool_name: string; status: string }>

diff(options)

Full analysis of two OpenAPI specs.

const result = await client.diff({
  before: '...',
  after: '...',
});
// result.omega_decision: string
// result.risk_score: number
// result.breaking_changes: BreakingChange[]
// result.should_block: boolean

explainDecision(options)

Human-readable explanation of why a decision was made.

const explanation = await client.explainDecision({
  omega_api: 43.95,
  decision: 'BLOCK',
  reflex_triggers: [...],
});
// explanation.summary: string
// explanation.components: Array<{ name: string; value: number; description: string }>

howToUnblock(options)

Actionable steps to resolve a BLOCK decision.

const steps = await client.howToUnblock({
  decision: 'BLOCK',
  breaking_changes: [...],
  detected_patterns: [...],
});
// steps.actions: Array<{ step: number; description: string; code_example?: string }>

scoreMcp(manifest)

Score an MCP manifest for agent safety.

const score = await client.scoreMcp({
  manifest: { tools: [...] },
});
// score.overall_score: number (0-100)
// score.band: 'STRONG' | 'GOOD' | 'NEEDS_WORK' | 'POOR' | 'CRITICAL'

getLedger(options)

Query compliance ledger entries.

const ledger = await client.getLedger({
  repo: 'owner/repo',
  decision: 'BLOCK',
  limit: 10,
});
// ledger.entries: LedgerEntry[]
// ledger.total: number

simulatePolicy(options)

Test a YAML policy against two OpenAPI specs.

const result = await client.simulatePolicy({
  policy_yaml: '...',
  old_spec: '...',
  new_spec: '...',
});
// result.effective_action: string
// result.matched_rules: MatchedRule[]

Error Handling

All methods throw a typed CodeRiftsError on non-2xx responses:

import { CodeRifts, CodeRiftsError } from '@coderifts/sdk';

try {
  const result = await client.preflightCheck({ ... });
} catch (err) {
  if (err instanceof CodeRiftsError) {
    console.error(err.code, err.message);
  }
}

Documentation

Full API documentation: https://coderifts.com/docs

License

MIT