Skip to content

memory.md

Latest commit

 

History

History
68 lines (49 loc) · 2.21 KB

memory.md

File metadata and controls

68 lines (49 loc) · 2.21 KB
Raw

state/memory.go — InMemoryStore

Package: dappco.re/go/inference/model/state File: go/model/state/memory.go

What this is

The in-process reference implementation of the read and write interfaces in state/store.go. Maps chunk_id → text|bytes plus an optional uri → chunk_id index. Zero file I/O, zero network, zero codec — useful for tests, fixtures, and spiking the wake/sleep loop before wiring a durable store.

Capabilities implemented

*InMemoryStore satisfies:

  • Store (Get)
  • Resolver (Resolve)
  • BinaryResolver (ResolveBytes)
  • URIResolver (ResolveURI)
  • Writer (Put)
  • BinaryWriter (PutBytes)

Not implemented:

  • RefBinaryResolver (falls back to ResolveBytes(chunk_id))
  • BinaryStreamWriter (in-memory has no streaming win)

Constructors

state.NewInMemoryStore(map[int]string{1: "hello"})
state.NewInMemoryStoreWithManifest(chunks, refs)  // pre-seed ChunkRef metadata

The "WithManifest" form is for round-tripping fixtures — you write some chunks via Put, capture the returned refs, then in a later test recreate the same store with both the text and the refs so chunk-id

  • codec match.

Codec stamp

Every ref written by this store carries Codec: state.CodecMemory and HasFrameOffset: true with FrameOffset == ChunkID. The frame-offset mirror makes test fixtures behave the same as State bundles for code that branches on frame addressing — the test path doesn't need a separate "I'm in fixture mode" flag.

When NOT to use

This store is not safe across goroutines without external locking. A production session uses State video (file-backed, immutable) or filestore (append-only on disk) for durability. Use InMemoryStore for:

  • Unit tests against Resolve / ResolveURI / Put
  • Fixture seeding in example tests
  • Dev workflow where the wake/sleep loop runs in-process

Consumed by

  • model/state/state_test.go — round-trip + URI-resolution tests
  • model/state/session/ tests — runtime smoke tests against a known in-memory store before reaching for State video
  • agent/ai/book_state_demo_test.go — bookstate fixtures point at in-memory chunks via entry-uri memory://...