archivist

package
v0.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 29, 2026 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Package archivist synthesizes agent session transcripts into persistent memory entries and code annotations.

This is a Tier 2 (cold standby) component — started lazily on first Memorize() call and shares the same LLMClient interface as all other tiers.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Annotation

type Annotation struct {
	Node string `json:"node"`
	Note string `json:"note"`
}

Annotation is a synthesized note for a code entity.

type Archivist

type Archivist struct {
	// contains filtered or unexported fields
}

Archivist synthesizes session transcripts into persistent memories.

func New

func New(client llm.LLMClient, timeout time.Duration) *Archivist

New creates an Archivist backed by the given LLM client.

func (*Archivist) Memorize

Memorize synthesizes a session transcript into persistent memory entries and annotations.

type MemorizeRequest

type MemorizeRequest struct {
	SessionEvents  []SessionEvent `json:"session_events"`
	ExistingMemory []string       `json:"existing_memory,omitempty"`
}

MemorizeRequest is the input for session memory synthesis.

type MemorizeResponse

type MemorizeResponse struct {
	NewMemories []Memory     `json:"new_memories"`
	Annotations []Annotation `json:"annotations"`
}

MemorizeResponse contains synthesized memories and annotations.

type Memory

type Memory struct {
	Key      string   `json:"key"`
	Content  string   `json:"content"`
	Entities []string `json:"-"` // populated by custom parsing, not direct unmarshal
}

Memory is a synthesized persistent memory entry.

type SessionEvent

type SessionEvent struct {
	Tool   string `json:"tool"`
	Entity string `json:"entity,omitempty"`
	Result string `json:"result_summary,omitempty"`
}

SessionEvent is a single tool call from an agent session.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL