Memories

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

Memory`memory`

An autobiographical memory in the user's own words. The same operations add and remove the present-day reflections attached to a memory (type 'reflection').

memories_findFindthrough vritto_find

Read AI-visible Memories: search by text, place, person, tag, form, provenance or when it happened (occurredFrom/occurredTo), one memory by id, view 'related' with id for connected memories, or view 'themes' for recurring themes. Summary rows unless detail is 'full'.

Field	Type	Description
id	string	Return just this memory.
memoryId	string	Older name for id.
view	one of related, themes	'related' with id: memories sharing people, place, time, subject or tags (reasons are deterministic); 'themes': recurring themes with their evidence (frequency is not importance).
query	string	Text to match in titles, recollections, places and tags.
status	one of active, archived, trashed, deleted
form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
lifeEventType	one of first, last, turning_point, achievement, work, education, relationship, family, home, health, travel, birthday, wedding, memorial, personal, other
basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
visibility	one of private, ai
sensitivity	one of general, personal, intimate, grief, trauma_sensitive
personId	string	Only memories with this person.
placeKey	string	Only memories at this Places key.
tag	string
sourceModuleId	string	Only memories linked to a record of this module.
occurredFrom	string	Earliest time it happened (a year or a date). ALWAYS pass occurredFrom/occurredTo when the question concerns a period.
occurredTo	string	Latest time it happened.
undatedOnly	boolean
favoriteOnly	boolean
pinnedOnly	boolean
includeArchived	boolean
includeTrashed	boolean
detail	one of summary, full	'summary' (default) compact rows; 'full' complete recollections.
limit	integer	Max rows; keep it narrow.
cursor	string

Example input

{
  "query": "Goa"
}

memories_addCreatethrough vritto_create

Preserve a Memory from the user's own account (record: a title, recollection, transcript or asset; fuzzy dates, provenance, certainty and sensitivity kept; private unless told). type 'reflection' attaches a present-day reflection to a memory (memoryId, body); a draftId makes the Memory from that AI-visible draft after approval.

Field	Type	Description
type	one of memory, reflection, draft	'memory' (default); 'reflection' a later perspective on a memory; 'draft' a recoverable draft, not yet a Memory (the draft's fields at the top level).
record	object	The memory.
record.title	string
record.recollection	string
record.rawTranscript	string
record.form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
record.lifeEventType	one of first, last, turning_point, achievement, work, education, relationship, family, home, health, travel, birthday, wedding, memorial, personal, other
record.primaryAssetId	string
record.assetIds	list of string
record.occurred	object
record.ended	object
record.recognizedAt	object
record.temporalNote	string
record.basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
record.certainty	one of certain, likely, uncertain, conflicted
record.perspective	one of first_person, observer, mixed, unclear
record.peopleIds	list of string
record.unresolvedPeople	list of string
record.place	object
record.subjectFacets	list of string
record.narrativeDynamics	list of string
record.sensoryCues	list of object
record.tags	list of string
record.emotionsThen	list of string
record.emotionsNow	list of string
record.whyItMatters	string
record.identityThemes	list of string
record.openQuestions	list of string
record.catalogRefs	list of object
record.visibility	one of private, ai
record.rediscovery	one of inherit, allow, muted
record.sensitivity	one of general, personal, intimate, grief, trauma_sensitive
record.pinned	boolean
record.favorite	boolean
record.idempotencyKey	string
memory	object	Older form of record (memories_createMemory); with draftId, the fields to set on the Memory made from the draft.
memory.title	string
memoryId	string	Type 'reflection': the memory it reflects on.
body	string	Type 'reflection': the reflection in the user's words.
reflectedOn	string	Type 'reflection': when, YYYY-MM-DD.
meaningChanged	boolean	Type 'reflection': true when the memory's meaning changed for the user.
visibility	one of private, ai	Type 'reflection' or 'draft': defaults to private.
draftId	string	Make the Memory from this AI-visible draft (after the user approves).
captureMode	one of text, voice, media, source, import	Type 'draft': how it was captured.
idempotencyKey	string

Example input

{
  "record": {
    "title": "First snow in Chicago",
    "recollection": "We ran outside at midnight in slippers.",
    "form": "episode",
    "visibility": "ai"
  }
}

memories_changeUpdatethrough vritto_update

Change one Memory by record.id: add detail, correct context, or update its meaning; omitted fields keep their values. archived true archives it (reversible). Do not change AI visibility without explicit consent.

Field	Type	Description
record	object	The memory's id plus the fields to change.
record.title	string
record.recollection	string
record.rawTranscript	string
record.form	one of episode, repeated, period, fragment, received_story, shared, collective, composite
record.occurred	object
record.ended	object
record.recognizedAt	object
record.temporalNote	string
record.basis	one of firsthand, co_remembered, told_to_me, media_anchored, document_anchored, inferred, mixed, unspecified
record.certainty	one of certain, likely, uncertain, conflicted
record.perspective	one of first_person, observer, mixed, unclear
record.peopleIds	list of string
record.unresolvedPeople	list of string
record.subjectFacets	list of string
record.narrativeDynamics	list of string
record.tags	list of string
record.emotionsThen	list of string
record.emotionsNow	list of string
record.whyItMatters	string
record.identityThemes	list of string
record.openQuestions	list of string
record.visibility	one of private, ai
record.rediscovery	one of inherit, allow, muted
record.sensitivity	one of general, personal, intimate, grief, trauma_sensitive
record.pinned	boolean
record.favorite	boolean
record.id*	string	Memory ID from memories_find, never invented.
record.archived	boolean	true archives the memory (reversible); false restores it.
expectedRevision	integer
memoryId	string	Older name for record.id, with patch or archived.
patch	object	Older form (memories_patchMemory), with memoryId: the fields to change.
patch.visibility	one of private, ai
archived	boolean	Older form (memories_setMemoryArchived), with memoryId.

Example input

{
  "record": {
    "id": "mem_first_snow",
    "favorite": true
  }
}

memories_removeDeletethrough vritto_delete

Move a Memory to Trash, or (type 'reflection', with its memoryId) delete one reflection. Only when the user explicitly asks to remove it.

Note: type 'reflection' with the memoryId deletes one reflection instead.

Field	Type	Description
type	one of memory, reflection	'memory' (default) or 'reflection'.
id	string	The memory, or with type 'reflection' the reflection.
memoryId	string	Type 'reflection': its memory. Older name for id otherwise.
reflectionId	string	Older form (memories_deleteMemoryReflection), with memoryId.
expectedRevision	integer

Kept in the Vritto app

memories_analyzeMemoryDraft: Runs Vritto's own AI; the calling assistant is already an AI.
memories_proposeMemoryNarrativePolish: Runs Vritto's own AI; the calling assistant is already an AI.
memories_queryMemorySemanticSearch: Runs Vritto's own AI; the calling assistant is already an AI.

Memories

Memorymemory

Kept in the Vritto app

Memory`memory`