PAMbaseDocs
Reference

Glossary.

One-line definitions of the terms used across these docs. PAMbase is “OAuth for AI memory”: each user has one memory store, and apps connect to it with scoped consent. Follow the links for the full treatment.

TermDefinition
memory storeThe single, auto-provisioned home for one user's memory — exactly one per user, shared across every connected app.
memoryA durable, natural-language fact about the user (a fact, preference, goal, etc.) — distinct from the raw event that produced it.
rememberWriting a natural-language memory via remember() (POST /v1/memories) — a content string plus a kind and scope. Any app can write; no LLM needed.
recallReading the memories most relevant to a query via recall(). Returns natural language for your LLM to interpret and act on.
signalAn ephemeral notification one app emits (emitSignal()) that fans out to subscribers — never stored as memory.
kindAn advisory structural hint on a memory (fact, preference, event, …). Free-form and not enforced — unlike scope, which is validated.
scopeA permission string like memory:read:fitness that gates what a connection may read or write — and the domain a memory lives in.
wildcardA * qualifier (e.g. health.* or *) that grants a whole namespace at once — see the Catalog.
intentA named reason for reading context (e.g. coach) that GET /v1/context tailors its bundle to, gated by context:read:<intent>.
context bundleThe assembled payload for an intent: light identity, relevant memories, relationships, and adaptation suggestions.
briefA prompt-ready one-paragraph summary of the user's assistant, cached 5 minutes, from GET /v1/identity/brief.
toneThe optional one-line personality note (personality.description) exposed under identity:read — the only personality data PAMbase surfaces.
connection tokenThe long-lived bearer credential your app gets after OAuth; sent as Authorization: Bearer … on every app request.
client_id / client_secretYour app's public identifier and private key, used at POST /v1/oauth/token to exchange a code for a connection token. Never expose the secret.
gatewayPAMbase's hosted-inference path (POST /v1/gateway/chat) that runs a model with the user's memory injected.
hosted vs BYOKHosted = let the gateway run the model and meter tokens; BYOK (bring your own key/model) = you fetch context and call your own LLM.
proactive layerOutbound delivery: PAMbase POSTs webhook events to apps that hold a subscription, so they can react without polling.
webhook / subscriptionA webhook is the signed POST PAMbase sends; a subscription is the registered endpoint + signing secret that receives it.
scheduled triggerA future-dated job created with POST /v1/schedule that delivers a schedule.fired webhook when it fires.
catalogThe shared vocabulary of standard scopes, event types, intents, and memory kinds that lets apps interoperate.
standard vs customStandard names are in the catalog and recognized ecosystem-wide; custom names work identically but are only discoverable via the ecosystem view.
importance / confidence / pinnedPer-memory signals: importance and confidence are 0–100; pinned forces a memory to always be considered.
idempotency (X-PAMbase-Delivery)The per-delivery id on every webhook; dedupe on it so retried deliveries are processed once. See Data model.