@glideco/explainer

npm install @glideco/explainer

interface ExplainerInput {
  toolCall: {
    id: string;
    toolName: string;
    agentDisplayName: string;
    timestampISO: string;
    amountUsdCents: number | null;
    counterpartyLabel: string | null;
    riskVerdict: 'pass' | 'flag' | 'block' | null;
  };
  envelope: {
    perTxCapUsdCents: number | null;
    dailyCapUsdCents: number | null;
    stepUpAmountUsdCents: number | null;
  };
  recentHistory: Array<{ /* ... */ }>;
  policyVersion: number;
}

interface ExplainerOutput {
  summary: string;
  detail?: string;
  observations: Array<{
    kind:
      | 'within-caps' | 'near-per-tx-cap' | 'near-daily-cap'
      | 'over-step-up' | 'novel-counterparty' | 'velocity-spike'
      | 'risk-flag' | 'risk-block';
    detail: string;
  }>;
  confidence: number;
}

import Anthropic from '@anthropic-ai/sdk';
import {
  buildPrompt,
  ExplainerInputSchema,
  ExplainerOutputSchema,
} from '@glideco/explainer';

const claude = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

async function explain(input) {
  const validated = ExplainerInputSchema.parse(input);
  const { system, user } = buildPrompt(validated);
  const res = await claude.messages.create({
    model: 'claude-sonnet-4-5',
    max_tokens: 1024,
    system,
    messages: [{ role: 'user', content: user }],
  });
  const text = res.content
    .filter((b) => b.type === 'text')
    .map((b) => b.text)
    .join('\n');
  return ExplainerOutputSchema.parse(JSON.parse(text));
}