Node SDK

npm install @prysmai/sdk

import { Prysm } from "@prysmai/sdk";

const client = new Prysm(); // apiKey from $PRYSM_API_KEY, baseURL from $PRYSM_BASE_URL

const resp = await client.chat.completions.create({
  model: "auto",            // let PRYSM pick the best model
  messages: [{ role: "user", content: "Write a TypeScript quicksort" }],
});
console.log(resp.choices[0].message.content);

import { extension } from "@prysmai/sdk";

const ext = extension(resp);
console.log(ext?.routing?.model_display); // "DeepSeek V4 Flash"
console.log(ext?.routing?.reason);        // why this model was chosen
console.log(ext?.cost?.total_usd);        // 0.000042
console.log(ext?.proof?.proof_hash);      // "sha256:a1b2c3d4..."

const client = new Prysm();                          // discovers ./BRAIN.md (walks up from cwd)
const resp = await client.complete("Summarize this contract"); // BRAIN.md applied

new Prysm({ brain: "path/to/BRAIN.md" });
new Prysm({ brain: { max_cost: 0.005, model: "deepseek-v4-flash" } });
new Prysm({ brain: null });                          // ignore BRAIN.md

const r = await client.orchestrate(
  "Compare three database designs for a 40-person team",
  { policy: "depth" },          // "efficiency" | "balanced" | "depth"
);
console.log(r.choices[0].message.content);
console.log(r.prysm.orchestration.models_used); // which models contributed
console.log(r.prysm.orchestration.agreement);   // how strongly they agreed

const r = await client.orchestrate({
  messages: [{ role: "user", content: "Prove that the square root of 2 is irrational" }],
  policy: "depth",
  strategy: "debate",           // single | cascade | ensemble_moa | rank_fuse |
                                // decompose_and_route | self_consistency | debate
  k: 3,                         // ensemble / sample width
  maxCostUsd: 0.05,             // soft budget hint, USD
});

const r = await client.code(
  "Write a thread-safe LRU cache in TypeScript with tests",
  { policy: "depth" },          // "efficiency" | "balanced" | "depth"
);
for (const f of r.files) { console.log(f.path); console.log(f.content); }
console.log(r.passed);                          // did the critic pass?
console.log(r.prysm.code.coder_models);         // who wrote it
console.log(r.prysm.proof.proof_hash);          // verifiable proof

const r = await client.code({
  task: "Implement rate limiting middleware",
  coderModel: "claude-sonnet-4.5",  // who writes the code
  reviewerModel: "deepseek-v4-pro",     // who critiques it
  maxIters: 4,                      // generate + up to 3 repairs
  maxCostUsd: 0.1,                  // soft budget hint, USD
});

const quick = await client.code("Write a hello world", { review: false }); // single shot

const p = await client.compliancePreview("summarize this report", {
  compliance: { jurisdiction: ["EU"], frameworks: ["GDPR"], data_residency: ["EU"] },
});
console.log(p.allowed_models);            // only EU/GDPR providers survive
console.log(p.compliance_cost_premium);   // what compliance costs vs. unrestricted

const r = await client.orchestrate("Explain photosynthesis.", {
  policy: "balanced",
  compliance: { provider_allowlist: ["anthropic"] },  // confine to approved providers
});
console.log(r.prysm.compliance);                 // the exclusion decision
console.log(r.prysm.proof.compliance);           // the attestation

await client.route("debug this function");   // dry-run: which model, est. cost (no call)
await client.usage();                        // your usage stats
await client.savings("gpt-5.2");             // est. $ saved vs. an all-premium baseline
await client.verifyProof(requestId);         // verify a PrysmProof
await client.modelsCatalog();                // 27 models with pricing

import { readFileSync } from "node:fs";

console.log(await client.validateBrain(readFileSync("BRAIN.md", "utf-8")));
// { valid: true, errors: [], warnings: [], normalized: {...} }

import type {
  PrysmOptions,
  RouteResult,
  ModelEntry,
  UsageResult,
  SavingsResult,
  BrainValidateResult,
  PrysmExtension,
  Policy,
  Strategy,
  OrchestrateOptions,
  OrchestrationResult,
  CompliancePreviewOptions,
  CompliancePreviewResult,
} from "@prysmai/sdk";