ladym

package

v0.8.0 Latest Latest Go to latest Published: Oct 20, 2026 License: MIT Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ProjAnvil/LadyM

Links

Open Source Insights

Documentation ¶

Overview ¶

Package ladym is the Go SDK facade for LadyM — a brain-inspired, multi-tier memory framework for LLM agents and codebase RAG.

Usage:

eng, err := ladym.NewEngine(ladym.DefaultConfig())
eng.IndexCode("./src", false, "", nil)
resp, _ := eng.Recall("how does auth work", "", 0, nil, nil, 0)

Index ¶

Constants
func DefaultConfig() *config.Config
func IndexCode(root, dbPath, workspace string, force bool) (*code.IndexReport, error)
func NamedOps() []string
func NewEngine(cfg *config.Config) (*engine.Engine, error)
func NewEngineWithModels(cfg *config.Config, models *adapter.ModelRouting) (*engine.Engine, error)
func OpenEngine(cfg *config.Config, dbPath, workspace string, fn func(*engine.Engine) error) error
func Recall(query, dbPath, workspace string, topK int) (*schema.RecallResponse, error)
func RecallOperations(q OperationsQuery, dbPath, workspace string) (*engine.OperationsResponse, error)
func RecordOperation(ev OperationEvent, dbPath, workspace string) (*schema.Memory, error)
func Remember(content, dbPath, workspace string, tags []string, source string) (*schema.Memory, error)
type ActivationWeights
type CodeIndexConfig
type CodeSymbol
type Config
type ConsolidateConfig
type Edge
type Engine
type Layer
type Memory
type MemoryType
type ModelRouting
type OperationEvent
type OperationsQuery
type OperationsResponse
type RecallConfig
type RecallResponse
type RecallResult
type Stats

Constants ¶

View Source

const (
	LayerWorking      = schema.LayerWorking
	LayerEpisodic     = schema.LayerEpisodic
	LayerSemantic     = schema.LayerSemantic
	LayerProcedural   = schema.LayerProcedural
	LayerAssociative  = schema.LayerAssociative
	LayerL5Mental     = schema.LayerL5Mental
	LayerL6Predictive = schema.LayerL6Predictive
)

Layer constants.

View Source

const (
	TypeNote          = schema.TypeNote
	TypeEvent         = schema.TypeEvent
	TypeFact          = schema.TypeFact
	TypeCodeFile      = schema.TypeCodeFile
	TypeCodeSymbol    = schema.TypeCodeSymbol
	TypePlaybook      = schema.TypePlaybook
	TypeSnippet       = schema.TypeSnippet
	TypeMentalModel   = schema.TypeMentalModel
	TypeForwardIntent = schema.TypeForwardIntent
)

MemoryType constants.

View Source

const Version = "0.5.2"

Version is the LadyM version.

Variables ¶

This section is empty.

Functions ¶

func DefaultConfig ¶

func DefaultConfig() *config.Config

DefaultConfig returns a Config with all defaults populated.

func NamedOps ¶

func NamedOps() []string

NAMED_OPS mirrors providers.NAMED_OPS (the cognitive operations that can bind an LLM provider). A copy is returned so callers cannot mutate the registry.

func NewEngine ¶

func NewEngine(cfg *config.Config) (*engine.Engine, error)

NewEngine builds an Engine from cfg (nil → defaults).

func NewEngineWithModels ¶

func NewEngineWithModels(cfg *config.Config, models *adapter.ModelRouting) (*engine.Engine, error)

NewEngineWithModels builds an Engine injecting host-owned models.

func OpenEngine ¶

func OpenEngine(cfg *config.Config, dbPath, workspace string, fn func(*engine.Engine) error) error

OpenEngine runs fn with a short-lived Engine, closing it on return. It is the Go equivalent of Python's `open_engine` context manager.

func Recall ¶

func Recall(query, dbPath, workspace string, topK int) (*schema.RecallResponse, error)

Recall is a one-shot recall. Returns a RecallResponse.

func RecallOperations ¶ added in v0.7.0

func RecallOperations(q OperationsQuery, dbPath, workspace string) (*engine.OperationsResponse, error)

RecallOperations is a one-shot recall_ops pivot query: which operations touched a resource, narrowed by action / time window / outcome. A resource miss degrades to plain recall with Fallback=true.

func RecordOperation ¶ added in v0.7.0

func RecordOperation(ev OperationEvent, dbPath, workspace string) (*schema.Memory, error)

RecordOperation is a one-shot structured L1 write: the action is normalized onto the vocabulary, each resource is resolved to a workspace entity, and an operates_on edge links the episode to every resource.

func Remember ¶

func Remember(content, dbPath, workspace string, tags []string, source string) (*schema.Memory, error)

Remember is a one-shot write of a semantic fact.