TypeScript SDK

@strangeworks/aura-sdk embeds Aura in a Node backend — an API, an internal tool, a scheduled job — so your users get an answer from the product they already use.

It wraps the public /api/v1 surface with company API-key auth: one runtime dependency, no CLI baggage.

To administer Aura or try a deployment out by hand, use the CLI. It is built on this package, so anything it does is available here as a library call.

Install

npm install @strangeworks/aura-sdk

Server-side only

An API key carries your whole company’s access. This package is for Node — never ship a key in a browser bundle.

Hello, Aura

Create a project from a deployment, ask Aura to solve it, print the reply:

import { AuraClient } from "@strangeworks/aura-sdk";

const aura = new AuraClient({ apiKey: process.env.AURA_API_KEY! });

const project = await aura.createProject({ name: "vrp demo", fromDeployment: "acme/vrp" });
const reply = await aura.chat(project.id, "Solve this and summarize the result.");

console.log(reply.content);

Where to go next

ConfigurationClient options, pointing at another Aura, bringing your own fetch.

ConventionsHow paging, types and errors behave across every method.

API referenceEvery export, generated from the package's own types and TSDoc.

Chat with a projectThe dispatch-and-poll contract, and how to stop a turn.