TypeScript SDK

Install

The package is published on the public npm registry. Node 18+, edge, browser, and Deno are all supported via a configurable fetch.

npm install @shelvia/sdk

The tarball ships only the published surface, dist/, README.md, LICENSE, openapi.json, package.json. No source, no examples, no secrets. An OpenAPI 3.1 spec is exported at @shelvia/sdk/openapi.json for generating clients in other languages.

Usage

import { ShelviaClient } from "@shelvia/sdk";

const shelvia = new ShelviaClient({
  apiKey: process.env.SHELVIA_TOKEN!,
});

// Reads
await shelvia.projects.getContext(projectId);
await shelvia.memory.search({ query, project_id, mode: "hybrid" });

// Generation
await shelvia.context.generatePack(projectId, {
  purpose: "Continue the v2 launch",
  target_tool: "claude",
  max_chars: 12000,
});

// Writes, always create review candidates
await shelvia.memory.createCandidate(projectId, {
  type: "decision",
  title: "...",
  content: "...",
});