Memory

memory.search · Search memory

Searches brand memory: facts and decisions people accepted, plus episodes that summarise shared conversations and completed works (for an episode, validFrom and validUntil are the period it covers). Keyword search; every hit carries its source.

Input

{
  query: string  // ≤ 300
  kinds?: Array<"fact" | "decision" | "episode">
  asOf?: string  // ISO date: return what was valid on that day.
  limit?: integer  // 1–20 · default 8
}

Output

{
  items: Array<{
    id: string  // uuid
    kind: "fact" | "decision" | "episode"
    text: string
    section: string | null
    validFrom: string | null
    validUntil: string | null
    source: {
      conversationId?: string  // uuid
      messageSequence?: integer  // -9007199254740991–9007199254740991
      taskId?: string  // uuid
      assetId?: string  // uuid
      url?: string  // uri
      workId?: string  // uuid
    }
    score: number
  }>
}

memory.propose · Propose a memory

Proposes to remember an explicit decision or fact stated by a person, citing the message. It stays pending until someone accepts it in Genome. At most 3 per run; never from internal or private threads.

Input

{
  kind: "fact" | "decision"
  section: string  // ≤ 40
  text: string  // ≤ 1000
  validFrom?: string
  validUntil?: string
  citation: {
    conversationId?: string  // uuid
    messageSequence?: integer  // -9007199254740991–9007199254740991
    taskId?: string  // uuid
    assetId?: string  // uuid
    url?: string  // uri
  }
}

Output

{
  ok: true
  id?: string
  revision?: integer  // -9007199254740991–9007199254740991
}

memory.assertions.review · Review a memory

Accepts, rejects or corrects one proposed fact in the brand memory at its current revision. A correction needs the new value; what is accepted joins the semantic index.

Input

{
  assertionId: string  // uuid
  expectedRevision: integer  // –9007199254740991
  action: "accept" | "reject" | "correct"
  value?: string  // ≤ 8000
}

Output

{
  id: string  // uuid
}