CMN-C1-101 — Agent Cross-Session Memory & Interaction History Q&A Agent

Category: Cat 1 (single technical capability, use-case-agnostic) Industry: Common (industry-agnostic)

Overview

Question-answering over a user's own prior interaction history and long-term memory. Given a question such as "what did we decide about the billing database?" together with a user identifier, the agent fetches that user's session history and memory entries from injected stores, merges them deterministically by recency and relevance within a token budget, and asks an LLM to write an answer that cites the sessions it drew on. The output gate rejects any answer that cites a session outside the caller's own scope, requires at least one cited session for a substantive answer, and masks personal data. A request without a user identifier, or one where context was found but no LLM is configured, returns a notice naming the reason rather than an invented answer; with no prior context the agent says so plainly. The default stores are empty and process-local, so every envelope carries memory_scope "this_execution_only" until you inject a persistent session-log store and memory store.

This is an agent template built with the AGENTIC STAR development platform and the AgentCore Framework. It is intended to be taken as a starting point: fork it, adapt it to your own data and policies, and run it inside your own AGENTIC STAR deployment.

Requirements

This template does not run standalone. It requires:

Requirement	Notes
AGENTIC STAR platform	The agent connects to the platform at start-up. Without it, start-up fails immediately (see Behaviour without the platform below). Deployment guides and API documentation: AGENTIC STAR Developers
AgentCore Framework (agenticstar-agentcore)	Installed from PyPI as a dependency.
Python	3.11 or later (requires-python = ">=3.11")

pip install -e .

Behaviour without the platform

The framework is designed to run only on AGENTIC STAR. There is no fallback or degraded mode. If the platform is unreachable or the SDK version does not match, the agent raises PlatformRequired during graph compile / start-up preflight rather than starting in a partially working state. This is intentional — a half-running agent is worse than one that refuses to start.

Quick Start

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
python -m pytest tests/ -v

Tests run without a platform connection. Running the agent itself does not.

Project Structure

src/          agent implementation (nodes, services, schemas)
tests/        unit, integration and boundary tests
config/       agent configuration
docs/         design and operational documentation

See docs/02_design.md for the design and docs/03_test_spec.md for the test specification.

Customising

1. Adjust config/ for your own environment and policies.
2. Replace the knowledge sources and sample data with your own.
3. Review the node implementations under src/nodes/ for domain-specific logic.
4. Re-run the test suite.

License

MIT — see LICENSE.

Status of this repository

This template is published as is, by its individual author, under the MIT license. It carries no warranty and no support commitment, and no organisation stands behind its behaviour or fitness for any purpose. Issues and pull requests may or may not receive a response; that is at the sole discretion of the repository owner.