@superinstance/cocapn-explain

Agent explainability — decision traces, step recording, and oversight queues.

Install

npm install @superinstance/cocapn-explain

Quick Start

const { ExplainTrace, StepType, DecisionTrace, OversightQueue } = require("@superinstance/cocapn-explain");

// Record a decision trace
const trace = new ExplainTrace("oracle1", "Choose architecture pattern");
trace.addStep(StepType.OBSERVE, "Read room tiles", 0.9, 50);
trace.addStep(StepType.REASON, "Compare patterns", 0.85, 120);
trace.addStep(StepType.DECIDE, "Select event-driven", 0.88, 10);
trace.outcome = "event-driven architecture";
console.log(trace.summarize());

// Oversight queue for human review
const queue = new OversightQueue(0.1);
const dt = new DecisionTrace("oracle1", "Deploy to production", "CI passed", 0.6, [], "HIGH");
const item = queue.enqueue(dt);
console.log(queue.stats); // { p0Pending: 1, ... }

API

• ExplainTrace — Full ORDAV trace (Observe→Reason→Decide→Act→Verify)
• DecisionTrace — Simplified decision record with risk levels
• OversightQueue — Priority-based human review (P0/P1/P2)
• TraceStep — Individual step in a trace

Zero dependencies. Works in browser and Node.js.