agos-memory

A small, deterministic decision kernel for already-authorized memory values. It performs no I/O and grants no authority.

Host acquisition -> finite authorized values -> pure decisions -> Host effects
                                           admit / retain / select / support

The package owns four decisions:

Storage, authorization, retrieval, embeddings, models, prompts, graphs, and receipts belong to the application integrating the kernel.

Install

With pip:

python -m pip install agos-memory

With uv:

uv add agos-memory

Example

from agos_memory.support import source_digest, support
from agos_memory.types import Current, ReopenedSource, SourceDependency

text = "Debt matures in 2029."
digest = source_digest(text)
expected = SourceDependency(
    owner="document-1",
    revision="version-1",
    fragment="chunk-1",
    kind="raw",
    digest=digest,
)
reopened = ReopenedSource(
    owner="document-1",
    revision="version-1",
    fragment="chunk-1",
    kind="raw",
    digest=digest,
    current_revision="version-1",
)

assert support(expected, reopened) == Current()

Inputs are explicit immutable values. Time, limits, policy, partitions, routes, and reopened source state come from the caller. Labels and scores never create authority.

Develop

uv sync --locked --all-groups
uv run pytest
uv run ruff check .
uv build --no-sources

The wheel and source archive are tested as external packages on Python 3.11, 3.12, and 3.13. Runtime dependencies remain empty.

Research

Reproducible public experiments live in agos-memory-lab. Benchmark dependencies, datasets, model calls, and results stay outside this kernel.

Security

See SECURITY.md. Please report vulnerabilities privately rather than opening a public issue.

License

Copyright 2026 I am Agos, Inc. Licensed under the Apache License, Version 2.0.