What is agent memory?

Agent memory is a persistent context layer for AI agents. When your agent queries business health, detects changes, or searches events, each query returns a proof envelope with metadata. Over time, the agent learns which questions are most valuable and can reference past queries to avoid redundant work.

How does this reduce false positives?

When agents query HeadlessAnalytics, they get proof envelopes showing exactly what data was used and when. This creates an audit trail. If an agent makes a bad recommendation, you can trace it back to the specific query, the data it returned, and the time period it covered. The agent learns from these patterns.

Do I need a dashboard?

No. Agents query via MCP, SDK, or CLI. Operators can use dashboards if they want, but the core value is the API-first approach. Your agent can get business health, detect changes, and search events without you ever opening a browser.

What's a proof envelope?

Every query returns metadata: queryId, workspaceId, businessId, period covered, when it was generated, and the schema version. This lets agents (and humans) verify the data is current and trace exactly where insights came from.

API-FIRST EVENT & PROOF LAYER

Every Agent Action
Needs a Proof Envelope.

HeadlessAnalytics captures canonical events from apps, agents, and trackables. Query live business health. Detect what changed. Get a verifiable proof envelope on every request.

Get API Keys Read The Docs

Agents query headlessly. Operators use dashboards. Both get proof envelopes.

Start here

Verifiable memory for agents.

Every query your agent makes returns a proof envelope — queryId, workspaceId, period covered, schema version. Your agent learns which questions matter. You get an audit trail.

Then expand

The event & proof platform.

Same API captures events from QR codes, RFID, sensors, robots, CRMs, ad platforms, and enterprise tools. Governance, exports, and proof trails come built in.

terminal - headless operations

$ export HA_API_KEY=ha_live_xxx

✓ Workspace ready for headless operation

$ ha create-trackable qr_code "Ethiopia Single-Origin Bag"

Generated tracked QR identifier ethiopia-bag-001

$ ha agent-context recommend_next_actions '{"limit":250}'

Returned proof gaps, top sources, and governed next actions

$ ha graphql 'query Ops { businessHealth { healthScore revenue } metrics { totalEvents } }'

Queried live operating context without opening a dashboard

[14:02:44] qr.bottle_scanned - sku: olive-oil-500ml, campaign: spring-launch

[14:02:45] order.created - source: qr, revenue: 149.00

[14:02:47] campaign.scale_recommended - requires Hypervisor enforcement

[14:02:49] proof.trail_exported - destination: SovereignProof-compatible JSON

Memory That Compounds

Every query your agent makes gets a proof envelope. Over time, your agent gets smarter about what to ask and what to ignore.

Business Health Queries

Agents query live business health with revenue, event counts, leads, orders, and health scores. Proof envelope shows exactly when and how the query was answered.

Proof envelope on every query
Schema version tracking

Change Detection

Agents ask "what changed?" between two periods. Get revenue deltas, event diffs, new/disappeared event types, and the exact data points that shifted.

Period-over-period diffs
Event type drift detection

Event Search

Free-text search across your event history. Agents find relevant past events, understand patterns, and avoid repeating mistakes they've already made.

Full-text event search
Pattern recognition over time

Sample proof envelope

Every query returns verifiable metadata.

{
  "queryId": "q_8f3a2b1c",
  "workspaceId": "ws_roast-origin",
  "businessId": "default",
  "period": { "from": "2026-06-01", "to": "2026-06-17" },
  "generatedAt": "2026-06-17T14:02:44Z",
  "schemaVersion": "2026-06-01",
  "data": {
    "healthScore": 87,
    "revenue": 14920.00,
    "totalEvents": 3847,
    "topEvent": "qr.bottle_scanned"
  }
}

Agents verify freshness. Operators audit lineage. Same envelope.

Your Agent's Memory Bank

Every query returns a proof envelope. Over time, your agent learns which questions matter and which ones it can skip.

MCP

OPENAI

LANGCHAIN

ANTHROPIC

Questions About HeadlessAnalytics

Everything you need to know about the event & proof layer.

Give Your Agent a Memory.

Start with API keys. Your agent queries business health, detects changes, and builds context over time. Proof envelopes on every query.

Free tier available. No credit card required.

Every Agent ActionNeeds a Proof Envelope.