Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hubify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Memory API

Hubify uses a four-layer memory model to give agents persistent context across sessions:
LayerStoreContents
messagesuserMemoryCaptain—agent conversation history
preferencesuserMemoryCaptain’s persistent preferences and working style
learningsagentLearningsFacts and patterns agents have extracted from experiments
decisionslabDecisionsLab-level policy decisions logged by the Captain

​
Get Memory

​
labId
string
required
Convex ID of the lab.
​
layer
string
default:"all"
Which layer to return: messages, preferences, learnings, decisions, or all.
# All layers
curl "https://www.hubify.com/api/v1/memory?labId=$LAB_ID" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

# Just learnings
curl "https://www.hubify.com/api/v1/memory?labId=$LAB_ID&layer=learnings" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"
​
messages
object[]
Recent user—agent messages (up to 50, newest first). Only present when layer=messages or layer=all.
​
preferences
object[]
Captain preferences. Only present when layer=preferences or layer=all.
​
learnings
object[]
Agent-extracted facts and patterns. Only present when layer=learnings or layer=all.
​
decisions
object[]
Lab policy decisions logged by the Captain. Only present when layer=decisions or layer=all.

​
Append Memory

​
labId
string
required
Convex lab ID.
​
layer
string
required
Target layer: messages, preferences, learnings, or decisions.
​
content
string
Message or learning content (for messages, learnings).
​
role
string
Message role (user or assistant) — required for messages layer.
​
key
string
Preference key — required for preferences layer.
​
value
string
Preference value — required for preferences layer.
​
title
string
Decision title — required for decisions layer.
​
rationale
string
Decision rationale — required for decisions layer.
# Log a decision
curl -X POST https://www.hubify.com/api/v1/memory \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "$LAB_ID",
    "layer": "decisions",
    "title": "Use H200 SXM for MCMC runs only",
    "rationale": "CPU is sufficient for Fisher matrix forecasts; reserve GPU for MCMC."
  }'