agent-recall 0.1.0__tar.gz

agent_recall-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,19 @@
+---
+name: Bug report
+about: Report a bug in agent-recall
+labels: bug
+---
+
+**Describe the bug**
+A clear description of what went wrong.
+
+**To reproduce**
+Steps or code to reproduce the behavior.
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- Python version:
+- agent-recall version:
+- OS:

agent_recall-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature request
+about: Suggest a new feature
+labels: enhancement
+---
+
+**Problem**
+What problem does this solve?
+
+**Proposed solution**
+How should it work?
+
+**Alternatives considered**
+Any other approaches you've thought about.

agent_recall-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

agent_recall-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,21 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest --tb=short -q

agent_recall-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+*.db
+*.db-wal
+*.db-shm
+.pytest_cache/
+.coverage
+htmlcov/
+.venv/
+venv/
+.env
+*.log

agent_recall-0.1.0/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [Unreleased]
+
+### Added
+- Per-agent model override via `agents.<slug>.model` in config
+- Per-agent template override via `agents.<slug>.template` (type name or inline text)
+- Agent enabled/disabled toggle via `agents.<slug>.enabled`
+- Adaptive cache invalidation with `.stale` markers
+- Cross-agent triggers — writes to child scope invalidate parent and orchestrator
+- `context_files` — load external files into briefing context
+- `get_agent_status()` — query cache metadata (freshness, size, timestamps)
+- `get_all_statuses()` — batch status for all agents
+- `get_generation_logs()` — read generation history per agent
+- `LLMResult` dataclass for structured LLM responses with token tracking
+- Generation logging with rotation (last 10 entries per agent)
+- ISO 8601 timestamps in status responses (`generated_at_iso`)
+- Comprehensive docstrings on `MemoryStore`, `MCPBridge`, `assemble_context`
+- `py.typed` marker for PEP 561 type checking support
+- Configurable briefing backend: `cli` (default, free) or `api` (Anthropic SDK)
+- `MemoryStore.rollback()` public method for error recovery
+- MCP server instructions — agents proactively save facts without prompting
+- Cold-start message when memory is empty (hooks)
+- Model aliases: `opus`, `sonnet`, `haiku` resolve to full model IDs
+- CHANGELOG.md
+
+### Fixed
+- `build_prompt()` crash on `{` in slug or raw context (both now escaped before `.format()`)
+- Path traversal in vault `_safe_filename()` — uses `Path.name` to strip directory components
+- Git auto-commit race condition — commit now blocks before push starts
+- MCP bridge input validation — missing/malformed fields return errors instead of crashing
+- `merge_entities()` uses public `store.rollback()` instead of private `_conn.rollback()`
+- Unused `MemoryConfig` import removed from MCP server
+- CLI model parameter validated against safe character set
+- `_load_context_files()` skips non-regular files (directories, devices)
+- Fragile dict key access in log assembly (uses `.get()` with defaults)
+- `get_agent_briefing()` now merges `min_cache_age` and `adaptive` per-agent
+- `get_agent_status()` caches `stat()` call (was calling twice)
+- `load_config()` raises `ValueError` on malformed YAML (was unhandled `ParserError`)
+- `get_agent_status()` raises `ValueError` on empty slug
+- Hardcoded `/tmp/` paths replaced with `tempfile.gettempdir()` (symlink attack prevention)
+
+### Changed
+- `mcp` is now an optional dependency: `pip install 'agent-recall[mcp]'`
+- `api` optional dependency added: `pip install 'agent-recall[api]'`
+- MCP server singleton documents single-threaded assumption
+
+### Removed
+- Dead modules: `episodes.py` (episodic memory) and `schema.py` (unused schema definitions)
+
+## [0.1.0] - 2026-02-15
+
+### Added
+- Initial release
+- SQLite memory store with bitemporal slots, observations, relations
+- Scope hierarchy with inheritance and enforcement
+- MCP server (FastMCP) for Claude Code integration
+- AI briefing generation with configurable LLM and prompt templates
+- 6 built-in prompt templates: client, agency, personal, topic, system, orchestrator
+- SessionStart hook with cache-first strategy
+- PostToolUse hook for vault regeneration
+- YAML configuration system
+- CLI: `agent-recall init / set / get / search / generate / status`
+- 249 tests

agent_recall-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing to agent-recall
+
+## Quick start
+
+```bash
+git clone https://github.com/mnardit/agent-recall.git
+cd agent-recall
+pip install -e ".[dev]"
+pytest
+```
+
+## What we're looking for
+
+- Bug fixes (always welcome)
+- New prompt templates for AI briefings
+- Documentation improvements
+- Integration examples (other MCP clients, other LLMs)
+- CLI improvements
+
+## Development
+
+- Python 3.10+
+- All tests must pass: `pytest`
+- Type hints on public API
+- Docstrings for public functions
+
+## Running tests
+
+```bash
+# All tests
+pytest
+
+# Without editable install
+PYTHONPATH=. pytest
+```
+
+## Not accepting (for now)
+
+- Breaking API changes
+- Cloud/hosted features
+- Dependencies on specific LLM providers

agent_recall-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Max Nardit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.