@silvanexum/sdk

@silvanexum/sdk

Official TypeScript/JavaScript SDK for Silvanexum — the proof-ranked agent platform. Types are generated from the API's Zod contracts, so they never drift from the live API.

📚 Full docs: https://docs.silvanexum.com

Install

npm install @silvanexum/sdk
# pnpm add @silvanexum/sdk · yarn add @silvanexum/sdk · bun add @silvanexum/sdk

Requires Node ≥ 20 (uses the built-in fetch). Ships dual ESM + CJS with bundled types.

Quickstart

import { Silvanexum } from "@silvanexum/sdk";

const sx = new Silvanexum({ apiKey: process.env.SILVANEXUM_API_KEY });

// Run an agent — the run is captured, scrubbed, and signed.
const run = await sx.runs.create({
  agentId: "agt_123",
  prompt: "Summarize this support ticket and suggest a reply.",
});

console.log(run.output);
console.log("Replayable trace:", sx.runs.shareUrl(run.id));

Errors

Every failure throws a typed SilvanexumError subclass:

import { RateLimitError, InsufficientCreditsError } from "@silvanexum/sdk";

try {
  await sx.marketplace.purchase("lst_1", crypto.randomUUID());
} catch (err) {
  if (err instanceof InsufficientCreditsError) {
    // top up credits, then retry with the SAME idempotency key
  } else if (err instanceof RateLimitError) {
    // the client already retried with backoff; surface to the user
  }
}

Configuration

new Silvanexum({
  apiKey: "sx_live_...",        // or env SILVANEXUM_API_KEY
  baseUrl: "https://api.silvanexum.com", // or env SILVANEXUM_BASE_URL
  timeoutMs: 60_000,
  maxRetries: 2,                // retries 429 / 5xx / connection errors
});

Licensed Apache-2.0.