SDK.

pnpm add @pambase/sdk

import { PAMbaseApp } from "@pambase/sdk";

const pam = new PAMbaseApp({
  baseUrl: "https://api.pambase.io", // http://localhost:4000 in dev
  connectionToken: storedToken,      // from exchangeCodeForToken(...)
});

const { brief, ai_name } = await pam.getIdentityBrief();
const systemPrompt = await pam.systemPrompt();   // ready to prepend to your LLM call

// Need the raw profile (display name + tone note)? It's on the connection:
const { ai } = await pam.getConnection();         // ai.name, ai.personality?.description

// Write natural-language memory (any app; pick a scope from the taxonomy).
await pam.remember({ content: "Ran 5k in 28:10.", kind: "event", scope: "fitness.running" });

// Recall the relevant memories; bring your LLM to interpret them.
const { memories } = await pam.recall({ query: "marathon training", scope: "fitness", limit: 5 });

// Emit an ephemeral signal for subscribers (not stored as memory).
await pam.emitSignal({ type: "workout.completed", payload: { activity: "run" } });

const res = await pam.chat({ intent: "coach", userMessage: "How did my week go?" });
console.log(res.reply, res.toneTags);

// Streaming — discriminate on event.type:
for await (const ev of pam.chatStream({ intent: "coach", userMessage: "Recap?" })) {
  if (ev.type === "delta") process.stdout.write(ev.text);
  else if (ev.type === "memory_recorded") console.log("\nrecorded", ev.candidate.scope);
  else if (ev.type === "done") console.log("\n", ev.usage.model, ev.usage.tokensOut);
  else if (ev.type === "error") throw new Error(ev.message);
}

const trg = await pam.schedule({
  fireAt: new Date(Date.now() + 86_400_000), // accepts Date or ISO string
  kind: "morning-checkin",
  payload: { tip: "Easy run today" },
});
await pam.cancelSchedule(trg.id);

import {
  buildConnectUrl,
  exchangeCodeForToken,
  verifyWebhookSignature,
} from "@pambase/sdk";

// 1. Send the user to the Hub to consent:
const url = buildConnectUrl({
  hubBaseUrl: "https://pambase.io",
  appSlug: "my-app",
  redirectUri: "https://my-app.com/callback",
  state: csrfToken,
  scopes: ["identity:read", "memory:read:fitness", "memory:write:fitness"],
});

// 2. On the callback, exchange the code for a token:
const { connection_token, ai_id, scopes } = await exchangeCodeForToken({
  apiBaseUrl: "https://api.pambase.io",
  code,
  clientId: process.env.PAMBASE_CLIENT_ID!,
  clientSecret: process.env.PAMBASE_CLIENT_SECRET!,
});

// 3. Verify inbound webhooks:
const ok = await verifyWebhookSignature({
  payload: rawBody,
  signature: req.headers["x-pambase-signature"],
  secret: process.env.PAMBASE_WEBHOOK_SECRET!,
  toleranceSeconds: 300,
});

import {
  UnauthorizedError, ScopeDeniedError, RateLimitError, classifyError,
} from "@pambase/sdk";

try {
  await pam.remember({ content: "Ran 5k this morning.", kind: "event", scope: "fitness" });
} catch (err) {
  if (err instanceof UnauthorizedError) {
    redirectToConnect(); // token missing/expired/revoked
  } else if (err instanceof ScopeDeniedError) {
    console.warn("Need scope:", err.scope); // request it in your manifest
  } else if (err instanceof RateLimitError) {
    await sleep(err.retryAfterMs); // then retry
  } else {
    throw classifyError(err);
  }
}

import { withRetry, type RetryConfig } from "@pambase/sdk";

const retry: RetryConfig = {
  maxAttempts: 3,      // default
  initialDelayMs: 200, // default
  maxDelayMs: 4000,    // default
  jitter: 0.25,        // default
  shouldRetry: (err) => true, // optional custom predicate
};

const pam = new PAMbaseApp({ baseUrl, connectionToken, retry });

await withRetry(() => pam.getIdentityBrief(), retry);

import { collect } from "@pambase/sdk";

const all = await collect(
  (cursor) => pam.listMemories({ scope: "fitness", cursor }),
  500, // safety cap
);

import {
  STANDARD_SCOPE_NAMESPACES,
  MEMORY_KIND_NAMES,
  STANDARD_INTENT_NAMES,
} from "@pambase/sdk";
import type {
  StandardScopeNamespace, MemoryKindName, StandardIntent,
} from "@pambase/sdk";

import type {
  AIIdentity, Memory, SearchedMemory, ContextBundle,
  IdentityBrief, Connection, ConnectedApp,
  GatewayChatRequest, GatewayChatResponse, ChatStreamEvent,
  PAMbaseCatalog, Paginated,
} from "@pambase/sdk";