@personaai/runtime 0.11.0

Framework-agnostic runtime engine. Adapters (@personaai/adapters/express, nextjs/server, nestjs) are thin translators over this.

Server-side only. Holds PERSONA_CREDENTIAL — never bundle.

Install

npm install @personaai/runtime

If you use Express/Next/Nest, install @personaai/adapters instead — it wraps this.

The sacred contract: resolveUser

Persona never authenticates users. You tell the runtime who the request is from:

import { createRuntime } from '@personaai/runtime';
const runtime = createRuntime({  baseUrl: process.env.PERSONA_BASE_URL!,  credential: process.env.PERSONA_CREDENTIAL!,  resolveUser: async (request) => {    return getUserIdFromSession(request.headers['cookie']); // your auth  },});

resolveUser returns string | null — null/throw → runtime responds 401. See Guide: resolve-user.

Quickstart (raw Node)

import { createServer } from 'node:http';import { createRuntime } from '@personaai/runtime';import { toNodeHandler } from './node-handler.js'; // copy from sdk/runtime/examples/node-handler.ts
const runtime = createRuntime({  baseUrl: process.env.PERSONA_BASE_URL!,  credential: process.env.PERSONA_CREDENTIAL!,  resolveUser: (req) => req.headers['x-demo-user-id'] ?? null,});
createServer(toNodeHandler(runtime)).listen(3210);

For framework installs, see Adapters quickstart.

Capabilities (opt-in, default off)

Disabled capabilities' routes are absent (404/405), not 403. See Guide: capabilities.

Routes

Core always-on routes: see Routes: Core. Capability-gated routes: see Routes: Capabilities.