ct-toolkit 0.2.1

Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems

Computational Theseus Toolkit (CT Toolkit)

Identity Continuity Guardrails for Agentic Systems

CT Toolkit is an open-source security layer designed to preserve the identity continuity of AI agents over time. It implements the Nested Agency Architecture (NAA) framework to prevent Sequential Self-Compression (SSC) in multi-agent hierarchies.

---

📖 Official Documentation

For full API reference, architecture details, and integration guides, visit our documentation site: 👉 https://hakandamar.github.io/ct-toolkit/

---

Why CT Toolkit?

In complex agentic workflows, LLMs tend to "drift" from their original instructions. CT Toolkit provides the mathematical and cryptographic guardrails to ensure your agents remain aligned with their core constitution, even across deep hierarchies.

• Constitutional Kernels: Axiomatic identity anchors.
• Divergence Engine: Multi-tiered drift analysis (L1/L2/L3).
• Hierarchical Propagation: Mother-to-child constraint inheritance.
• Provenance Log: Immutable HMAC-signed interaction history.

---

Quick Start

pip install ct-toolkit

from ct_toolkit import TheseusWrapper

# One-line injection for any LLM provider
client = TheseusWrapper(provider="openai")

# Guardrails and drift analysis applied automatically
response = client.chat("What are your core security axioms?")

print(response.content)
print(f"Divergence Score: {response.divergence_score}")

---

🚦 Project Health & Status

Metric	Status
Tests	✅ 202/203 passing (92% coverage)
Last Phase	✅ Phase 3: ICM and Measurement (Complete)
Current Goal	🔶 Phase 4: Open-Source Support

For a detailed breakdown of the 8-phase roadmap, see PROJECT_STATUS.md.

Framework Support

Seamlessly integrate with your favorite frameworks:

# LangChain
from ct_toolkit.middleware.langchain import TheseusChatModel
llm = TheseusChatModel(provider="openai")

# CrewAI
TheseusCrewMiddleware.apply_to_crew(crew, manager_wrapper)

---

Theoretical Foundation

Translating the framework proposed in The Computational Theseus (2025) into engineering practice.

---

License

Apache License 2.0.