Long-term memory for AI agents: a bitemporal knowledge graph with cited answers.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
What this server is and what it can do, before you connect. Reads nothing and stores nothing.
This tool takes no arguments.
What this server is and what it can do, before you connect. Reads nothing and stores nothing.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Dry-run preflight against fn::resolve_fact. Answers "if I were to record this fact right now, what would the resolver decide?" without writing to the database. wouldOutcome ∈ {INSERTED, SUPERSEDED, COMPETING, REJECTED}; reasoning explains which rule fired (semantics class, score gap vs margin, cosine threshold, etc); opposingFacts lists the same-predicate priors the resolver would have weighed against. Useful where the cost of a contested write is high (e.g. agent loops that pay an ingest credit). Fidelity: this preflight uses the SEED source-trust table and authority 0 — the live resolver scores opponents with the learned domain-scoped rates (migration 0045) and declared source authority (migration 0046), so predictions can differ for sources with conflict history or a registered authLevel.
| Argument | Type | Description |
|---|---|---|
| object* | string | |
| userId | string | Per-user memory scope: preflight a user-scoped record_fact against tenant-global priors PLUS this user's personal ones. Omit for tenant-global candidates (matches record_fact's userId) |
| entityRef* | any | |
| predicate* | string | |
| validFrom* | string | |
| confidence | number | |
| validUntil | string | |
| sourceVertical* | string | Vertical attributed as source (matches record_fact) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityRef",
"predicate",
"object",
"validFrom",
"sourceVertical"
],
"properties": {
"object": {
"type": "string"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: preflight a user-scoped record_fact against tenant-global priors PLUS this user's personal ones. Omit for tenant-global candidates (matches record_fact's userId)"
},
"entityRef": {
"anyOf": [
{
"type": "object",
"required": [
"vertical",
"id"
],
"properties": {
"id": {
"type": "string"
},
"vertical": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "string"
}
}
}
]
},
"predicate": {
"type": "string"
},
"validFrom": {
"type": "string",
"format": "date-time"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"validUntil": {
"type": "string",
"format": "date-time"
},
"sourceVertical": {
"type": "string",
"description": "Vertical attributed as source (matches record_fact)"
}
}
}Returns the topic communities a given entity is a member of. Places an entity in its broader context — which clusters / themes it participates in — and leads from one entity to the wider neighbourhood the cluster summarises.
| Argument | Type | Description |
|---|---|---|
| entityId* | string | knowledge_entity id |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "string",
"description": "knowledge_entity id"
}
}
}Get entities connected to the given one via the knowledge graph.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Bitemporal edge cutoff — connections as they were believed at this ISO 8601 moment (mirrors GET /v1/entities/:id/connections?asOf=) |
| kind | string | Edge kind filter (e.g. "paid_for", "mentioned_in") |
| userId | string | Per-user memory scope: results include tenant-global relations plus this user's personal ones; omit for tenant-global only (fail-closed) |
| entityId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Bitemporal edge cutoff — connections as they were believed at this ISO 8601 moment (mirrors GET /v1/entities/:id/connections?asOf=)"
},
"kind": {
"type": "string",
"description": "Edge kind filter (e.g. \"paid_for\", \"mentioned_in\")"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global relations plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"entityId": {
"type": "string"
}
}
}Returns facts in COMPETING status — those the conflict resolver couldn't auto-supersede because two same-predicate bitemporal facts overlap in valid-time and are too cosine-close within margin. Grouped by (entityId, predicate); 2-fact groups are pairs the resolver left for adjudication, 3+-fact groups are multi-way disagreements escalated for human review. Answers "is this entity already conflicted on this predicate?" and can drive an in-product reviewer queue. asOf filters to disagreements that were live at that moment.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Show what was competing at this ISO 8601 moment |
| userId | string | Per-user memory scope: preflight a user-scoped record_fact against tenant-global priors PLUS this user's personal ones. Omit for tenant-global candidates (matches record_fact's userId) |
| entityId* | string | Brain entity id (knowledge_entity:...) or short id |
| predicate | string | Filter to one predicate (e.g. "status", "address") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Show what was competing at this ISO 8601 moment"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: preflight a user-scoped record_fact against tenant-global priors PLUS this user's personal ones. Omit for tenant-global candidates (matches record_fact's userId)"
},
"entityId": {
"type": "string",
"description": "Brain entity id (knowledge_entity:...) or short id"
},
"predicate": {
"type": "string",
"description": "Filter to one predicate (e.g. \"status\", \"address\")"
}
}
}Full profile of one entity: canonical name, type, externalRefs (cross-vertical ids), and active facts. externalRefs point back to the originating vertical, where fresh state can be rehydrated via @inite/api-kit.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Valid-time as-of: facts true at this ISO 8601 moment (not a knowledge snapshot) |
| userId | string | Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed) |
| entityId* | string | Brain entity id (knowledge_entity:...) or short id |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Valid-time as-of: facts true at this ISO 8601 moment (not a knowledge snapshot)"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"entityId": {
"type": "string",
"description": "Brain entity id (knowledge_entity:...) or short id"
}
}
}Chronological audit of all facts brain has learned about this entity, including retracted ones. Useful for "what did we know when" investigations.
| Argument | Type | Description |
|---|---|---|
| since | string | |
| until | string | |
| userId | string | Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed) |
| entityId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"since": {
"type": "string",
"format": "date-time"
},
"until": {
"type": "string",
"format": "date-time"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"entityId": {
"type": "string"
}
}
}Read a single fact as stored — predicate (aspect), object (statement), confidence, validity window, source attribution (vertical / recorder / conversationId), and lifecycle state. Retracted facts still resolve (retracted: true) — "why did I stop remembering this" is part of the trust story; only visibility fences turn into not-found. groundingStatus (grounded | ungrounded) appears on facts stamped by the claim-grounding plane (EVIDENCE_GROUNDING_STAMP); legacy rows carry no key. Same shape as GET /v1/facts/:id. Takes a factId as returned by searches and writes and returns the full trust record behind it.
| Argument | Type | Description |
|---|---|---|
| factId* | string | Fact id (knowledge_fact:...) or short id |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"factId"
],
"properties": {
"factId": {
"type": "string",
"description": "Fact id (knowledge_fact:...) or short id"
}
}
}Return the grounding provenance behind one fact: the verbatim conversation turns it was derived from (episodes, chronological, with char-span quotes when the deriver stamped them). When the server runs with the recursive-closure flag the response additionally carries derivedFacts + closure (the transitive derivedFrom support graph); a plain deployment returns episodes only — the response is a passthrough of GET /v1/facts/:id/provenance, no field filtering. Traversal depth is a server-side policy (flag + caps), not a caller knob. Lets a surprising fact be audited before it is trusted or retracted.
| Argument | Type | Description |
|---|---|---|
| factId* | string | Fact id (knowledge_fact:...) or short id |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"factId"
],
"properties": {
"factId": {
"type": "string",
"description": "Fact id (knowledge_fact:...) or short id"
}
}
}Return everything brain knows ABOUT a source (not its facts): the operator-declared identity (type, authLevel — authority in conflict resolution), the learned per-domain agreement rates (domain = predicate; null domain = the global blended rate; rates need >=8 samples before the resolver trusts them over the neutral 0.5), and the reputation-over-time history. sourceKey is `vertical:recorder` (recorder falls back to `_`) — the same key facts carry in trustSnapshot.sourceKey. Shows how much weight a fact whose trustSnapshot looks surprising deserves.
| Argument | Type | Description |
|---|---|---|
| sourceKey* | string | Source key, e.g. "rent:tenant_bot" or "code:_" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sourceKey"
],
"properties": {
"sourceKey": {
"type": "string",
"maxLength": 512,
"description": "Source key, e.g. \"rent:tenant_bot\" or \"code:_\""
}
}
}Resolves the named entities by canonical name, walks their 1-hop neighbourhood over knowledge_edge, and returns facts across seeds ∪ neighbours, optionally filtered by predicate hints. Works from entities named up front and returns what the graph holds around them ("who runs engineering at Acme" — the answer lives on a neighbour, not on Acme itself). Seeds score 1.0, neighbours 0.7; soft-fails to an empty result.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot) |
| query | string | Free-text fallback used to resolve seeds when a name does not match exactly |
| entityNames* | array | Canonical names of the entities to anchor on |
| predicateHints | array | Prefer facts with these predicates (non-matching neighbour facts are dropped, seed facts kept at lower score) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityNames"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot)"
},
"query": {
"type": "string",
"description": "Free-text fallback used to resolve seeds when a name does not match exactly"
},
"entityNames": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Canonical names of the entities to anchor on"
},
"predicateHints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Prefer facts with these predicates (non-matching neighbour facts are dropped, seed facts kept at lower score)"
}
}
}The two ways to authenticate, and what each is for. Reads nothing and stores nothing.
| Argument | Type | Description |
|---|---|---|
| client | string | Which client you are configuring, if you want the specific instructions. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"client": {
"type": "string",
"description": "Which client you are configuring, if you want the specific instructions."
}
}
}Insert an edge between two entities. `kind` is the edge type — `identity_of` merges the `from` entity into `to` (cross-vertical identity reconciliation), other typed edges (`paid_for`, `mentioned_in`, `worked_with`, …) are surfaced in related-entity reads and contribute to PPR / SubgraphRAG context. Most edges come from event ingestion; this inserts one directly. identity_of rejects a request that names the same end twice and any merge that would close a cycle; declaring an identity that already holds answers `alreadyIdentical: true` with no edge, so a replay is safe.
| Argument | Type | Description |
|---|---|---|
| to* | any | |
| from* | any | |
| kind* | string | Edge type (identity_of | paid_for | mentioned_in | worked_with | …) |
| weight | number | |
| sourceVertical* | string | Vertical attributed as source (e.g. "rent") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"to",
"kind",
"sourceVertical"
],
"properties": {
"to": {
"anyOf": [
{
"type": "object",
"required": [
"vertical",
"id"
],
"properties": {
"id": {
"type": "string"
},
"vertical": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "string"
}
}
}
]
},
"from": {
"anyOf": [
{
"type": "object",
"required": [
"vertical",
"id"
],
"properties": {
"id": {
"type": "string"
},
"vertical": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "string"
}
}
}
]
},
"kind": {
"type": "string",
"description": "Edge type (identity_of | paid_for | mentioned_in | worked_with | …)"
},
"weight": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"sourceVertical": {
"type": "string",
"description": "Vertical attributed as source (e.g. \"rent\")"
}
}
}Paginated listing of topic communities, largest first. Each row carries a label, a rolled-up summary, and the member count. Gives the knowledge map at a glance.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
}
}
}Paginated listing of procedural memory for admin/review UIs. Sorted by priority ASC, createdAt DESC. Set includeRetired=true to see soft-deleted rows.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| includeRetired | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"includeRetired": {
"type": "boolean"
}
}
}Cosine-matches procedural memory (curated 'how to' patterns the operator recorded) against a free-text context query. Returns top-K procedures sorted by similarity DESC then priority ASC. Surfaces the behaviour rules that apply to a context — e.g. "user asks about pricing" → "mention they're on platinum tier; they get 20% off". Procedural memory is the third tier alongside facts (semantic) and episodes (timeline).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Natural-language context |
| minSimilarity | number | Floor (default 0.4); rows below are dropped |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Natural-language context"
},
"minSimilarity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Floor (default 0.4); rows below are dropped"
}
}
}Returns everything brain learned, unlearned, or replaced between two ISO 8601 cursors [from, to). createdFacts = new active facts; retractedFacts = facts marked retracted in-window with no successor; changedFacts = facts that were superseded by another (carries before+after); newEntities = entities created in-window; forgottenEntities = GDPR-erased tombstones; lapsedExpectations = temporary states (ill, away) whose expected end passed in-window with nothing confirming or ending them — worth asking about. Driving use case: "what changed since the last conversation?" Scope with entityIds and/or predicates to narrow the diff to a feature surface. Window is half-open; consecutive diffs over adjacent windows never double-count.
| Argument | Type | Description |
|---|---|---|
| to* | string | Exclusive upper bound (ISO 8601) |
| from* | string | Inclusive lower bound (ISO 8601) |
| userId | string | Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed) |
| entityIds | array | Scope to these entities (short or full ids) |
| predicates | array | Scope to these predicates |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"format": "date-time",
"description": "Exclusive upper bound (ISO 8601)"
},
"from": {
"type": "string",
"format": "date-time",
"description": "Inclusive lower bound (ISO 8601)"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"entityIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Scope to these entities (short or full ids)"
},
"predicates": {
"type": "array",
"items": {
"type": "string"
},
"description": "Scope to these predicates"
}
}
}Find recorded design decisions / rationale / invariants / gotchas by NL topic ("why do we resolve facts through one gateway?"), across ALL code anchors — a semantic search over code-memory, rather than one known anchor. Returns matches with their code anchor + kind, ranked by relevance.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Natural-language topic to recall the "why" for |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"description": "Natural-language topic to recall the \"why\" for"
}
}
}Capture the non-derivable engineering "why" about a code location: a design decision, its rationale, an invariant that must hold, or a gotcha. Anchored to a SCIP-style symbol or file path (NOT line numbers — survives edits). Stored as a bitemporal typed fact: re-recording a `decided` / `invariant` for the same anchor SUPERSEDES the prior one (decision evolution over time), while `because` / `gotcha` accumulate. Attach commit / location for provenance.
| Argument | Type | Description |
|---|---|---|
| kind* | string | decided = a design decision (supersedes prior); because = rationale; invariant = a constraint that must hold (supersedes prior); gotcha = a non-obvious trap (accumulates) |
| text* | string | The decision / rationale / invariant / gotcha text |
| commit | string | Commit SHA this was decided in (provenance) |
| symbol* | string | Code anchor — SCIP-style symbol or file path |
| location | string | file:line provenance, e.g. src/x.ts:42 |
| validFrom | string | When the decision took effect — defaults to now |
| confidence | number |
Insert a fact about an entity. Triggers brain conflict resolution (INSERTED / SUPERSEDED / COMPETING / REJECTED). Most facts come from event ingestion; this records one directly.
| Argument | Type | Description |
|---|---|---|
| object* | string | |
| userId | string | Per-user memory scope: the fact (and, for a vertical+id entityRef, the entity) belongs to this end-user only — invisible to other users and to requests that don't assert the same userId |
| evidence | array | Supporting observations behind the claim (≤10 typed pointers) — stored verbatim in the fact source; their presence marks the fact grounded (claim-grounding plane) |
| entityRef* | any | |
| predicate* | string | |
| validFrom* | string | |
| confidence | number | |
| validUntil | string | |
| expectedUntil | string | For a temporary state with no stated end (ill, travelling, away): when it should be over. Not an end — the fact stays current; answers say it was expected to be over once this passes |
Record a 'how to' pattern that is surfaced when a similar context appears later. trigger = the context phrase the rule should match against (e.g. "user asks about pricing"); action = the behaviour to apply (e.g. "mention they're on platinum tier; they get 20% off"). priority orders ties when multiple procedures match the same context (lower is higher priority; default 100). decayHalfLifeDays is a forward hook for v0.2 relevance decay; v1 ignores it at read time.
| Argument | Type | Description |
|---|---|---|
| action* | string | |
| trigger* | string | |
| priority | integer | |
| sourceKind | string | Audit tag for who recorded this — default operator |
| decayHalfLifeDays | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"trigger",
"action"
],
"properties": {
"action": {
"type": "string",
"minLength": 1
},
"trigger": {
"type": "string",
"minLength": 1
},
"priority": {
"type": "integer",
"maximum": 1000,
"minimum": 0
},
"sourceKind": {
"enum": [
"operator",
"agent",
"dreams_loop"
],
"type": "string",
"description": "Audit tag for who recorded this — default operator"
},
"decayHalfLifeDays": {
"type": "integer",
"maximum": 3650,
"minimum": 1
}
}
}Mark a procedural memory row as retired (sets retiredAt). A retired procedure is no longer matched or listed by default. For a rule that no longer applies — distinct from a hard delete because the row stays for audit.
| Argument | Type | Description |
|---|---|---|
| procedureId* | string | procedural_memory:<tail> or just the tail |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"procedureId"
],
"properties": {
"procedureId": {
"type": "string",
"description": "procedural_memory:<tail> or just the tail"
}
}
}Mark a fact as no longer believed. Cascades to facts derived from this one. Does not delete; the row remains for audit.
| Argument | Type | Description |
|---|---|---|
| factId* | string | |
| reason* | string | |
| retractedBy | object | Who initiated the retraction — mirrors the REST RetractFactDto. Omit for the pre-existing default ({source: 'system'}); pass {source: 'human', userId} when relaying an operator/user decision so the audit trail records the real initiator |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"factId",
"reason"
],
"properties": {
"factId": {
"type": "string"
},
"reason": {
"type": "string"
},
"retractedBy": {
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"enum": [
"human",
"system"
],
"type": "string"
},
"userId": {
"type": "string",
"maxLength": 200
}
},
"description": "Who initiated the retraction — mirrors the REST RetractFactDto. Omit for the pre-existing default ({source: 'system'}); pass {source: 'human', userId} when relaying an operator/user decision so the audit trail records the real initiator"
}
}
}Cosine-matches the query against topic-community summaries — the coarse retrieval scope. A community is a cluster of related entities (label propagation over the entity graph) with one rolled-up summary. Suited to broad questions ("what do we know about X domain"): it returns an overview of a domain rather than individual facts. Communities are (re)built off-hours by the dreams loop; an empty result means clustering has not run or the graph is too sparse.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Natural-language topic / domain |
| minSimilarity | number | Floor (default 0.3); rows below are dropped |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Natural-language topic / domain"
},
"minSimilarity": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Floor (default 0.3); rows below are dropped"
}
}
}Semantic search over the company knowledge graph. Returns entities with their top facts and external references back to the originating verticals. Apply asOf for historical "what was true on X" queries (valid time: a fact brain learned after X still shows). Embedding model on this tenant: set per workspace.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot) |
| limit | integer | Max results (default 10) |
| query* | string | Natural-language query |
| userId | string | Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed) |
| predicates | array | Filter to these predicates only |
| minConfidence | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot)"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results (default 10)"
},
"query": {
"type": "string",
"description": "Natural-language query"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"predicates": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to these predicates only"
},
"minConfidence": {
"type": "number",
"maximum": 1,
"minimum": 0
}
}
}Planner-LLM decomposes the query into ≤ maxHops anchored sub-queries; later hops are anchored to the running entity set so the engine never spends compute on candidates already disqualified. Built for questions that combine evidence across turns / sessions, or that require reasoning over multiple entities ("tenants who complained in April AND upgraded after"). Set synthesize=true to get a grounded answer with citations alongside the per-hop trace. Returns finalEntityIds + supportingFactIds (HotpotQA-style evidence chain) so the caller can audit which facts drove the answer. Embedding model on this tenant: set per workspace.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot) |
| limit | integer | |
| query* | string | Natural-language query |
| userId | string | Per-user memory scope: tenant-global plus this user's personal facts; omit for tenant-global only |
| maxHops | integer | Hard cap on planner hops (default 3, capped at 5 — beyond that latency dominates) |
| predicates | array | Filter to these predicates only |
Returns a short one-line briefing about the entity — name, type, the most-confident active facts, external refs — suitable for dropping into an LLM context window. Caches in-process (per companyId / entityId / asOf / styleHint) so a hot entity touched across many turns doesn't reload the profile. styleHint='neutral' | 'sales' | 'support' are template-rendered (no LLM call). styleHint='client_llm' opts into MCP SAMPLING: brain asks the connected client (Claude Desktop / agent runtime) to write the one-liner with its own model — zero brain-side OpenAI cost, perfect for self-hosters who don't want brain holding an LLM key. Falls back to neutral template + sampledBy='local_template' when the client doesn't advertise sampling capability. A briefing in place of the full profile, timeline and competing facts.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Summarize what was known at this ISO 8601 moment |
| userId | string | Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed) |
| entityId* | string | Brain entity id (knowledge_entity:...) or short id |
| styleHint | string | Phrasing register — 'neutral' (default), 'sales', 'support', or 'client_llm' (delegate to client-side LLM via MCP sampling; falls back to neutral template if client doesn't support sampling) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityId"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Summarize what was known at this ISO 8601 moment"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: results include tenant-global facts plus this user's personal ones; omit for tenant-global only (fail-closed)"
},
"entityId": {
"type": "string",
"description": "Brain entity id (knowledge_entity:...) or short id"
},
"styleHint": {
"enum": [
"neutral",
"sales",
"support",
"client_llm"
],
"type": "string",
"description": "Phrasing register — 'neutral' (default), 'sales', 'support', or 'client_llm' (delegate to client-side LLM via MCP sampling; falls back to neutral template if client doesn't support sampling)"
}
}
}Runs hybrid search then feeds the retrieved facts to a generator LLM that produces a citation-bearing answer (each claim ends with [factId]); a verifier LLM then judges whether every claim is supported. Three guardrail modes: strict (default) returns null on partial / unsupported / verifier outage (fail-closed); lenient returns the answer alongside the verifier verdict; off skips the verifier. Returns a direct natural-language answer rather than raw search results. Embedding model on this tenant: set per workspace.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Valid-time as-of: facts true at this ISO 8601 moment (not a knowledge snapshot) |
| limit | integer | Top-K facts fed to the generator (default 10) |
| query* | string | Natural-language question |
| userId | string | Per-user memory scope: tenant-global plus this user's personal facts; omit for tenant-global only |
| predicates | array | |
| minConfidence | number | |
| synthesisGuardrails | string | Guardrail mode (default = SYNTHESIZE_DEFAULT_GUARDRAILS env) |
Return the design decisions, rationale, invariants and gotchas recorded against a code anchor — the non-derivable engineering "why" a parser cannot recover from source. The anchor is a SCIP-style symbol string ("pkg/namespace/symbol") or a file path ("repo/path/file.ts"). Pass asOf to recall what was known at a past instant (bitemporal). Returns found:0 with empty memory when nothing is recorded.
| Argument | Type | Description |
|---|---|---|
| asOf | string | Bitemporal cursor — recall what was known as of this instant |
| symbol* | string | Code anchor — SCIP-style symbol or file path |
| userId | string | Per-user memory scope: tenant-global decisions plus this user's own; omit for tenant-global only |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Bitemporal cursor — recall what was known as of this instant"
},
"symbol": {
"type": "string",
"description": "Code anchor — SCIP-style symbol or file path"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: tenant-global decisions plus this user's own; omit for tenant-global only"
}
}
}The tenant this credential writes to (companyId, its display name, whether it is a personal workspace), what is already in its memory (entities, active facts, facts recorded in the last 7 days), how many Domain Packs are installed, for a user-bound connection who the user is in this memory (`user.name` — the name the memory has learned from them, null until it has), and `nextSteps` — the setup actions that would actually change something, derived from that state rather than a stored checklist (including asking the user how to address them, once, and recording it). Answers "which workspace am I writing to?" and explains why memory answers may look emptier than expected.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"symbol",
"kind",
"text"
],
"properties": {
"kind": {
"enum": [
"decided",
"because",
"invariant",
"gotcha"
],
"type": "string",
"description": "decided = a design decision (supersedes prior); because = rationale; invariant = a constraint that must hold (supersedes prior); gotcha = a non-obvious trap (accumulates)"
},
"text": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The decision / rationale / invariant / gotcha text"
},
"commit": {
"type": "string",
"description": "Commit SHA this was decided in (provenance)"
},
"symbol": {
"type": "string",
"description": "Code anchor — SCIP-style symbol or file path"
},
"location": {
"type": "string",
"description": "file:line provenance, e.g. src/x.ts:42"
},
"validFrom": {
"type": "string",
"format": "date-time",
"description": "When the decision took effect — defaults to now"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
}
}
}| conversationId | string | Conversation this fact was observed in — names an observation, so the fact counts as grounded (claim-grounding plane) |
| sourceVertical* | string | Vertical name attributed as source (e.g. "rent") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entityRef",
"predicate",
"object",
"validFrom",
"sourceVertical"
],
"properties": {
"object": {
"type": "string"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: the fact (and, for a vertical+id entityRef, the entity) belongs to this end-user only — invisible to other users and to requests that don't assert the same userId"
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"ref"
],
"properties": {
"ref": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "The pointer itself — id, URL, path, sha…"
},
"kind": {
"enum": [
"event",
"message",
"conversation",
"url",
"document",
"commit",
"other"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 512
}
}
},
"maxItems": 10,
"description": "Supporting observations behind the claim (≤10 typed pointers) — stored verbatim in the fact source; their presence marks the fact grounded (claim-grounding plane)"
},
"entityRef": {
"anyOf": [
{
"type": "object",
"required": [
"vertical",
"id"
],
"properties": {
"id": {
"type": "string"
},
"vertical": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "string"
}
}
}
]
},
"predicate": {
"type": "string"
},
"validFrom": {
"type": "string",
"format": "date-time"
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"validUntil": {
"type": "string",
"format": "date-time"
},
"expectedUntil": {
"type": "string",
"format": "date-time",
"description": "For a temporary state with no stated end (ill, travelling, away): when it should be over. Not an end — the fact stays current; answers say it was expected to be over once this passes"
},
"conversationId": {
"type": "string",
"maxLength": 512,
"description": "Conversation this fact was observed in — names an observation, so the fact counts as grounded (claim-grounding plane)"
},
"sourceVertical": {
"type": "string",
"description": "Vertical name attributed as source (e.g. \"rent\")"
}
}
}| synthesize |
| boolean |
| Run the synthesizer over the final entity set and return a grounded answer with citations |
| synthesisGuardrails | string | Override guardrails when synthesize=true: strict closes to null on partial; lenient returns the answer with the verifier verdict; off skips the verifier |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Valid-time as-of: facts true at this ISO 8601 moment (a retraction dated before it hides the fact; a fact learned after it still shows — not a knowledge snapshot)"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "Natural-language query"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: tenant-global plus this user's personal facts; omit for tenant-global only"
},
"maxHops": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "Hard cap on planner hops (default 3, capped at 5 — beyond that latency dominates)"
},
"predicates": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to these predicates only"
},
"synthesize": {
"type": "boolean",
"description": "Run the synthesizer over the final entity set and return a grounded answer with citations"
},
"synthesisGuardrails": {
"enum": [
"strict",
"lenient",
"off"
],
"type": "string",
"description": "Override guardrails when synthesize=true: strict closes to null on partial; lenient returns the answer with the verifier verdict; off skips the verifier"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"asOf": {
"type": "string",
"format": "date-time",
"description": "Valid-time as-of: facts true at this ISO 8601 moment (not a knowledge snapshot)"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Top-K facts fed to the generator (default 10)"
},
"query": {
"type": "string",
"description": "Natural-language question"
},
"userId": {
"type": "string",
"maxLength": 200,
"description": "Per-user memory scope: tenant-global plus this user's personal facts; omit for tenant-global only"
},
"predicates": {
"type": "array",
"items": {
"type": "string"
}
},
"minConfidence": {
"type": "number",
"maximum": 1,
"minimum": 0
},
"synthesisGuardrails": {
"enum": [
"strict",
"lenient",
"off"
],
"type": "string",
"description": "Guardrail mode (default = SYNTHESIZE_DEFAULT_GUARDRAILS env)"
}
}
}