Skip to content

pkgs/store/objectstore

pkgs/store/objectstore Definition prefix-addressable binary object storage. Object name is a slash-separated key; the caller can read and write a single object, enumerate or delete by prefix, and set a deadline or TTL for the object.

Go API References

Core structure and implementation

SymbolFunction
ObjectStoreDefine Get, Put, expiration, Delete, DeletePrefix and List.
ObjectInfoReturns object name, size and deadline.
LocalDirProviderAllows callers to identify the local filesystem backend.
DirSecurely map object keys to specified directories and maintain expiration metadata.

Main purpose

Firmware artifacts, workspace history, Agent binary memory data, Gameplay pixa, and HNSW vector index persistence all use the Object Store.

Ownership Boundary

The Object Store treats directories as an implementation detail and does not provide any filesystem operations. Resource metadata, content type, authorization, and version rules belong to the calling domain; objectstore only owns the binary object lifecycle.