SDK Reference
Reference for the Silvanexum SDKs — the same capabilities across TypeScript and Python.
The Silvanexum SDKs give you a typed surface for capturing agents, triggering runs, reading signed traces, managing versions, settling on credits, and capping and attributing agent spend (Agent FinOps). The TypeScript and Python SDKs mirror each other, so concepts transfer directly between languages.
Both SDKs' request/response types are generated from the API's Zod contracts, so they can never drift from the live API.
| TypeScript | Python | |
|---|---|---|
| Package | @silvanexum/sdk (npm) | silvanexum (PyPI) |
| Runtime | Node ≥ 20 | Python ≥ 3.9 |
| Import | import { Silvanexum } from "@silvanexum/sdk" | from silvanexum import Silvanexum |
| Convention | camelCase methods & fields | snake_case methods, model fields as returned |
Resource map
Every resource is reachable from the client (sx.<resource>.<method>):
| Resource | Purpose |
|---|---|
agents | Create, configure, publish, fork agents · agents.versions for signed M01 versions |
runs | Execute agents, read signed/replayable traces, share runs |
templates | 1-click vertical agent templates (M11) |
connectors | Authenticated third-party tools via Nango |
marketplace | Proof-ranked listing search, try, purchase, install |
wallet | Credits, ledger, payouts (M10) |
suites | Regression eval suites — the CI gate (M04) |
keys | BYO provider API keys |
models | Model catalog (static + live, key-scoped) |
team | Org members and projects |
overview | Org dashboard stats |
budgets | Spend caps per org/project/agent; enforcement: "block" rejects over-budget runs server-side (Agent FinOps) |
spending | Cost attribution — summary / trends / meshTrace over real run telemetry (Agent FinOps) |
gateway | Zero-code OpenAI-compatible proxy that meters every call on your BYO key (Agent FinOps) |