@auraone/sdk

Official TypeScript SDK for the AuraOne hosted API.

This is the hosted SDK — it speaks to the AuraOne platform at api.auraone.ai. For local, no-account-required evaluation tooling (rubric validation, scoring, judge calibration, IAA, drift, leakage audits), use auraone-evalkit from the auraoneai/open repository instead.

Install

npm install @auraone/sdk
# or
pnpm add @auraone/sdk
# or
yarn add @auraone/sdk

Quick start

import { AuraOneClient } from "@auraone/sdk";

const client = AuraOneClient.withApiKey(process.env.AURAONE_API_KEY!);

const run = await client.evaluations.create({
  template_id: "rubric.web.qa",
  agent_bundle_url: "s3://bundle.zip",
  wait: false,
});

console.log(run.id, run.status);

What's in the SDK

• Domain services across evaluations, labs, training, analytics, collaboration, governance, billing, integrations, and more.
• Authentication via API key, scoped tokens, or OAuth (AuthProvider).
• Plugin shims for LangChain and LlamaIndex.
• GraphQL client alongside REST.
• Typed responses; the SDK ships its own .d.ts files.

Two-SDK architecture

Package	What it is	When to use
@auraone/sdk (this package)	Hosted API client (npm)	You have an AuraOne account and want to call hosted services.
auraone-sdk (PyPI)	Same API surface, Python edition	You prefer Python and want hosted services.
auraone-evalkit (PyPI)	Local OSS evaluation tooling	You want rubric/score/agreement/drift utilities without an account. See auraoneai/open.

Authentication

import { AuraOneClient } from "@auraone/sdk";

// API key (simplest)
const client = AuraOneClient.withApiKey(process.env.AURAONE_API_KEY!);

// Custom AuthProvider for refresh tokens / OAuth / scoped credentials
import { AuthProvider } from "@auraone/sdk";
const authProvider = new AuthProvider({ /* ... */ });
const client2 = new AuraOneClient({ authProvider });

Documentation

• Hosted API reference: https://www.auraone.ai/developers
• Tutorials: https://www.auraone.ai/resources/tutorials
• Deployment guide: https://www.auraone.ai/resources/docs/deployment

Development

npm install
npm run build
npm test

Versioning

This SDK is at v0.1.0. We follow semantic versioning. Breaking changes will only land in a major release after v1.0.0.

License

MIT — see LICENSE.