agentic-kit

Reusable agentic infrastructure for AI decision systems.
Agents need infrastructure, not just prompts.

---

What is agentic-kit?

agentic-kit is the Standard Infrastructure for building reliable AI agent systems. It provides the battle-tested primitives you need to move from "demo" to "production":

• 🧠 Semantic Memory — Embedding-based retrieval with fallback to keywords
• 🚀 Action Dispatchers — Pluggable execution backends (logging, HTTP, dry-run)
• 🔒 Circuit Breakers — Automatic failure handling and rate limiting
• 🔄 Reflection Loops — Post-action self-critique and re-deliberation

---

Heptagon & DMS Integration

agentic-kit powers the ENACT and YIELD phases of the Decision Moment Standard (DMS) lifecycle.

Cycle: FRAME → SPAR → GATE → COMMIT → ENACT → YIELD → GAUGE

Phase	Agentic-Kit Module	Role
ENACT	dispatchers	Safely execute the committed instruction
YIELD	circuit_breaker	Monitor execution health and stop runaway loops
GAUGE	reflection	Critically evaluate the result against the prediction

---

Installation

pip install agentic-kit
# Options: [embeddings], [http], [all]

Quick Start

Semantic Memory

from agentic_kit import SemanticMemoryStore
store = SemanticMemoryStore()
store.add({"id": "1", "text": "Deploy to prod"})
print(store.query("deployment"))

---

Module Reference

Module	Classes	Purpose
memory	SemanticMemoryStore	Context retrieval
dispatchers	LoggingDispatcher	Safe execution
circuit_breaker	CircuitBreaker	Loop safety
reflection	ReflectionLoop	Self-correction

---

🌐 Context7 Integration (Optional)

Fetch versioned library documentation via the Context7 MCP bridge:

from agentic_kit import Context7Client, context7_available

# Check availability
if context7_available():
    async with Context7Client() as client:
        docs = await client.get_library_docs("react", "18")
        print(docs.content[:500])

Features

• Async-first: Built on aiohttp for non-blocking I/O
• Graceful degradation: Falls back to GitHub/npm if Context7 unavailable
• Caching: In-memory library ID cache for repeated lookups
• Retry logic: Exponential backoff with configurable retries

Note: Requires aiohttp. Install with pip install aiohttp.

---

The SYNTHAI Ecosystem

Component	Role
Decision Moment Graph	The Standard for reversible, auditable decisions.
VAULT-KIT	The Protocol for privacy-first coordination.
agentic-kit	The Infrastructure for reliable agent systems.

Built by SYNTHAI — Decision Intelligence for the AI Era.