sdk v0.9.0

@personaai/sdk 0.9.0

Node.js/TypeScript SDK — raw Developer Platform API client (server-side)

@personaai/sdk 0.9.0

Node.js/TypeScript SDK for the Persona Developer Platform API — Agents, Skills, Knowledge, MCP, Stores, memory, and streaming chat from your own backend.

Server-side only. PersonaClient holds your Project credential — never construct it in a browser bundle or client component. See .

Install

Requires Node 18+.

Quickstart

import { PersonaClient } from '@personaai/sdk';
const persona = new PersonaClient({  baseUrl: 'https://api.persona.hasanraiyan.me',  credential: process.env.PERSONA_CREDENTIAL!,});
// Sanity-checkconst who = await persona.whoami();
// Provision an Agent (control-plane)const agent = await persona.agents.create({  name: 'Career Launchpad',  systemPrompt: 'You help students find internships.',  providerId: '...',  visibility: 'unlisted',});
// Per-request, assert an external userconst userClient = new PersonaClient({  baseUrl: 'https://api.persona.hasanraiyan.me',  credential: process.env.PERSONA_CREDENTIAL!,  externalUserId: currentUser.id,});
for await (const e of userClient.chat.stream(agent._id, {  messages: [{ role: 'user', content: 'Hi' }],})) {  if (e.type === 'TEXT_MESSAGE_CHUNK' && e.delta) process.stdout.write(e.delta);}

import { PersonaClient } from '@personaai/sdk';
const persona = new PersonaClient({  baseUrl: 'https://api.persona.hasanraiyan.me',  credential: process.env.PERSONA_CREDENTIAL!,});
// Sanity-checkconst who = await persona.whoami();
// Provision an Agent (control-plane)const agent = await persona.agents.create({  name: 'Career Launchpad',  systemPrompt: 'You help students find internships.',  providerId: '...',  visibility: 'unlisted',});
// Per-request, assert an external userconst userClient = new PersonaClient({  baseUrl: 'https://api.persona.hasanraiyan.me',  credential: process.env.PERSONA_CREDENTIAL!,  externalUserId: currentUser.id,});
for await (const e of userClient.chat.stream(agent._id, {  messages: [{ role: 'user', content: 'Hi' }],})) {  if (e.type === 'TEXT_MESSAGE_CHUNK' && e.delta) process.stdout.write(e.delta);}

See for the full first-chat walkthrough.

Resources

Client	Wraps
`.agents`	`/api/v1/developer/agents`
`.skills`	`/api/v1/developer/skills`
`.knowledge`	`/api/v1/developer/knowledge`
`.mcps` (+ `.mcps.oauth`)	`/api/v1/developer/mcps`
`.restTools`	`/api/v1/developer/rest-tools`
`.threads`	`/api/v1/developer/threads`
`.memory`	`/api/v1/developer/memory`
`.stores`	`/api/v1/developer/stores`
`.files`	`/api/v1/developer/files`
`.chat`	`/api/v1/developer/agui`
`.architect`	`/api/v1/developer/architect/agui`
`.workflows`	`/api/v1/developer/workflows`
`.voice`	`/api/v1/developer/voice/sessions`

See and .

Generated API reference: is generated from sdk/typescript/src/index.ts via TypeDoc — do not edit. Regenerate with node platform/scripts/typedoc-to-mdx.mjs --sdk sdk --to 0.9.0.

Quickstart — @personaai/sdk