Reference

Catalog.

The shared vocabulary every app reads and writes. Memory is natural language — a memory is a kind + a scope (domain) + the content text. The scope taxonomy below is the controlled write vocabulary: pick the namespace that fits, add a free sub-scope if you like (fitness.running), and any LLM agent can recall across apps.

Version 2026-05-22, additive-only. Read it at runtime from GET /v1/catalog or via the SDK (getCatalog(), STANDARD_SCOPE_NAMESPACES).

Memory kinds

A suggested structural hint for each memory — advisory metadata the reading LLM can use, not an enforced list. The kind field is free-form, so use your own (e.g. task) when none of these fit. Breadth lives in the scope, below — and unlike kinds, scope is validated.

Kind	Meaning
`fact`	A durable, objective truth about the user (where they live, what they do).
`preference`	Something the user likes, dislikes, or prefers.
`event`	Something that happened, anchored in time.
`relationship`	A person in the user's life and how they relate.
`emotion`	A feeling or mood the user expressed. Low importance — it fades.
`goal`	An objective the user is working toward.
`world`	App-tracked world or game state about the user.
`summary`	A condensed roll-up derived from many memories.

The scope taxonomy

The domains you write into. A write's top-level namespace must be one of these (or general); sub-scopes are free. Grouped for browsing:

Identity & self

Namespace	Description	Example
`profile`	Durable facts about who the user is.	Lives in Berlin; works as a product designer.
`preference`	Likes, dislikes, and settings the user expresses.	Dislikes spicy food; prefers window seats.
`belief`	Values, opinions, and worldview.	Cares deeply about sustainability.
`trait`	Personality traits and characteristics.	Tends to be an early riser and detail-oriented.
`skill`	Abilities, competencies, and expertise.	Fluent in Python; intermediate at the piano.
`language`	Languages the user speaks or is learning.	Native Arabic; learning Japanese.

Goals & habits

Namespace	Description	Example
`goal`	Objectives the user is working toward.	Training for a half-marathon in May.
`habit`	Recurring behaviours the user keeps or wants to.	Meditates for 10 minutes each morning.
`routine`	Regular daily/weekly structure.	Works out Mon/Wed/Fri before work.

Health & wellness

Namespace	Description	Example
`health`	General health and wellbeing.	Recovering from a knee injury.
`fitness`	Workouts, training, and physical activity.	Ran 5km this morning in 28 minutes.
`nutrition`	Diet, meals, and eating patterns.	Following a high-protein diet; vegetarian.
`sleep`	Sleep duration, quality, and patterns.	Slept 6h last night; usually 7–8.
`medical`	Conditions, medications, and appointments (sensitive).	Allergic to penicillin.
`mental_health`	Mood, stress, and emotional wellbeing (sensitive).	Feeling burned out at work lately.

Finance

Namespace	Description	Example
`finance`	General financial situation and goals.	Saving for a house down payment.
`budget`	Budgets and spending limits.	Monthly grocery budget is around $400.
`spending`	Purchases and transactions.	Bought noise-cancelling headphones for $199.
`income`	Earnings and income sources.	Freelance income varies month to month.
`investment`	Investments, holdings, and strategy.	Holds an index-fund-heavy portfolio.

Work & productivity

Namespace	Description	Example
`work`	Job, employer, and working context.	Works as a backend engineer at a fintech startup.
`career`	Career direction and milestones.	Wants to move into engineering management.
`project`	Projects the user is involved in.	Leading the checkout-revamp project this quarter.
`task`	To-dos and action items.	Needs to file the quarterly report by Friday.
`meeting`	Meetings and their outcomes.	Agreed in standup to ship the API by Thursday.

Learning

Namespace	Description	Example
`education`	Formal education and background.	Studied computer science; graduated 2019.
`learning`	Courses, lessons, and study progress.	Completed the 'Async Rust' lesson with a 92% score.
`research`	Topics the user is investigating.	Researching vector databases for a side project.

Relationships & social

Namespace	Description	Example
`relationship`	People in the user's life and how they relate.	Sister Maya lives in Toronto; they talk weekly.
`family`	Family members and family life.	Has two kids, ages 4 and 7.
`friend`	Friends and social circle.	Best friend Sam from college, now in Lisbon.
`social`	Social activities and plans.	Hosting a dinner party Saturday.
`communication`	How the user likes to communicate.	Prefers concise messages; dislikes phone calls.

Lifestyle

Namespace	Description	Example
`home`	Home, living space, and household.	Renting a two-bedroom flat in Kreuzberg.
`travel`	Trips, itineraries, and travel style.	Visiting Tokyo in October; prefers boutique hotels.
`location`	Places that matter to the user.	Home is in Kreuzberg; office is near Alexanderplatz.
`food`	Dining, cuisines, and restaurant tastes.	Loves ramen; favourite spot is Cocolo.
`shopping`	Shopping habits, brands, and wishlist.	Prefers minimalist brands; wants a standing desk.
`transportation`	How the user gets around.	Commutes by bike; doesn't own a car.
`pet`	Pets and their care.	Has a border collie named Pixel.
`style`	Fashion and personal style.	Wears mostly neutral tones; size M.

Entertainment & culture

Namespace	Description	Example
`media`	Books, films, music, articles, and podcasts.	Read 'The Order of Time' by Carlo Rovelli.
`entertainment`	Shows, outings, and leisure.	Went to a jazz show downtown last weekend.
`gaming`	Video games the user plays.	Main game is a roguelike; plays a few nights a week.
`hobby`	Hobbies and pastimes.	Into film photography and bouldering.
`sport`	Sports the user follows or plays.	Supports Arsenal; plays five-a-side on Tuesdays.
`creative`	Creative work and projects.	Writing a sci-fi short-story collection.

Time & records

Namespace	Description	Example
`schedule`	Calendar, availability, and time commitments.	Has a 30-minute free slot at 2pm today.
`event`	Notable things that happened.	Moved to a new apartment last month.
`reminder`	Things the user wants to be reminded of.	Wants a nudge to call the dentist.
`note`	Free-form notes and journal entries.	Journaled about feeling stretched thin at work.

Catch-alls

Namespace	Description	Example
`general`	Uncategorized memories that don't fit a specific domain.	Prefers tea over coffee in the morning.
`world`	App-tracked world or game state about the user.	In the game, the user spared the stray creature.

Consent scopes

What an app requests at connect time. Wildcards (health.*, *) are supported.

Scope	Grants
`identity:read`	Read the user's light agent profile (display name + tone).
`memory:read:<scope>`	Read memories in <scope>. Wildcards, e.g. memory:read:health.* or memory:read:*.
`memory:write:<scope>`	Write memories in <scope>. Wildcards supported.
`context:read:<intent>`	Request an adaptive context bundle for one of your declared intents.
`signal:emit`	Emit ephemeral signals (notifications) to subscribed apps.
`signal:subscribe`	Subscribe to signals/memories to react proactively.
`ai:host:chat`	Host the user's agent in a memory-grounded chat surface.
`ai:host:companion`	Embed the user's agent as a companion (game NPC, sidebar).

Context intents

Intent	When
`app.session.start`	The user opened or started a session in your app.
`app.daily`	A daily check-in or home-screen render.
`app.companion.turn`	Each turn of a companion/assistant interaction.
`hub.chat`	The user chatting inside the PAMbase hub (platform-internal).

Webhook events

What PAMbase POSTs to a subscribed app. Verify the signature, branch on type, then let your LLM agent interpret and react.

memory.created

A memory you're allowed to read was created. Bring an LLM to interpret it and react.

Field	Type	Required	Notes
`aiId`	string	yes
`connectionId`	string	yes
`sourceApp`	string	—	Slug of the originating app, or null if from chat.
`memory`	object	yes	{ kind, scope, content, importance }

signal.created

Another app emitted an ephemeral signal you subscribe to. React in real time.

Field	Type	Required	Notes
`signalType`	string	yes	e.g. "calendar.slot_free".
`aiId`	string	yes
`connectionId`	string	yes
`sourceApp`	string	—
`payload`	object	yes	The signal payload, verbatim.
`occurredAt`	string	yes

schedule.fired

A time-based trigger you scheduled has elapsed.

Field	Type	Required	Notes
`kind`	string	yes	The trigger kind you set.
`connectionId`	string	yes
`aiId`	string	yes
`firedAt`	string	yes
`payload`	object	yes	The payload you scheduled, verbatim.