@possibl/rcrt-api

Typed TypeScript client for the RCRT API gateway. Covers breadcrumbs, sessions, service grants, projects, the agent runtime, and preview tokens.

Install

npm install @possibl/rcrt-api
# or
pnpm add @possibl/rcrt-api

Quick start

import { createClient } from '@possibl/rcrt-api';

const client = createClient({
  apiUrl: 'https://your-rcrt-gateway.run.app',
  // Bearer token: Firebase ID token, tenant API key (tk_*), or preview
  // token (pvw_*). Either pass a static token or a refresh callback.
  getToken: async () => 'eyJhbGciOi...',
  tenantId: 'afec0a4e-a89d-42fb-a37a-328266323abc',
});

const breadcrumbs = await client.queryBreadcrumbs(['interpret:project-config'], 50);

Versioning

@possibl/rcrt-api follows the API gateway's compat surface; minor versions are non-breaking, majors are. Until the surface stabilises the package is at 0.x and minor bumps may include breaking changes — pin exact versions in production.

Source

The canonical source lives in packages/api inside the RCRT monorepo. Workspace consumers import the TypeScript source directly; npm consumers receive a pre-built ESM bundle (see scripts/publish-rcrt-api.mjs for how the published package.json differs from the source one).

License

Apache-2.0.