ct-toolkit 0.3.3__tar.gz → 0.3.5__tar.gz

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ct-toolkit
-Version: 0.3.3
+Version: 0.3.5
 Summary: Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems
 Author: Hakan Damar
 License: Apache-2.0
@@ -18,6 +18,8 @@ Requires-Dist: SQLAlchemy>=2.0.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyasn1>=0.6.3
+Requires-Dist: typer[all]>=0.12.0
 Provides-Extra: ollama
 Requires-Dist: ollama>=0.2.0; extra == "ollama"
 Provides-Extra: langchain
@@ -64,6 +66,7 @@ For full API reference, architecture details, examples, and integration guides,
 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.
+- **Standalone Auditor CLI**: Rapidly audit any LLM endpoint for identity drift without writing code.
 - **Autonomous Self-Correction**: Active L2->L1 feedback loop that retries and corrects divergent responses before they reach the user.
 - **Divergence Engine**: Multi-tiered drift analysis (L1/L2/L3).
 - **Hierarchical Propagation**: Mother-to-child constraint inheritance.
@@ -90,15 +93,28 @@ print(response.content)
 print(f"Divergence Score: {response.divergence_score}")
 ```
 
+### 🔍 Standalone Auditor (CLI)
+
+Audit any LLM endpoint (OpenAI, Ollama, LM Studio) directly from your terminal:
+
+```bash
+# Audit a local Ollama model
+ct-toolkit audit --url http://localhost:11434/v1 --kernel defense
+
+# List available kernels and templates
+ct-toolkit list-kernels
+ct-toolkit list-templates
+```
+
 ---
 
 ## 🚦 Project Health & Status
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 231/232 passing (90% coverage)                       |
-| **Last Phase**   | ✅ Phase 4: OS Support, Deep Agents & Alerts (Complete) |
-| **Current Goal** | 🔶 Phase 5: Vault & Security (In Progress)              |
+| **Tests**        | ✅ 237/240 passing (90% coverage)                       |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (Complete)                     |
+| **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Planning)      |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).
 

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/README.md

@@ -25,6 +25,7 @@ For full API reference, architecture details, examples, and integration guides,
 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.
+- **Standalone Auditor CLI**: Rapidly audit any LLM endpoint for identity drift without writing code.
 - **Autonomous Self-Correction**: Active L2->L1 feedback loop that retries and corrects divergent responses before they reach the user.
 - **Divergence Engine**: Multi-tiered drift analysis (L1/L2/L3).
 - **Hierarchical Propagation**: Mother-to-child constraint inheritance.
@@ -51,15 +52,28 @@ print(response.content)
 print(f"Divergence Score: {response.divergence_score}")
 ```
 
+### 🔍 Standalone Auditor (CLI)
+
+Audit any LLM endpoint (OpenAI, Ollama, LM Studio) directly from your terminal:
+
+```bash
+# Audit a local Ollama model
+ct-toolkit audit --url http://localhost:11434/v1 --kernel defense
+
+# List available kernels and templates
+ct-toolkit list-kernels
+ct-toolkit list-templates
+```
+
 ---
 
 ## 🚦 Project Health & Status
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 231/232 passing (90% coverage)                       |
-| **Last Phase**   | ✅ Phase 4: OS Support, Deep Agents & Alerts (Complete) |
-| **Current Goal** | 🔶 Phase 5: Vault & Security (In Progress)              |
+| **Tests**        | ✅ 237/240 passing (90% coverage)                       |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (Complete)                     |
+| **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Planning)      |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).
 

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/ct_toolkit/__init__.py

@@ -23,6 +23,8 @@ from ct_toolkit.core.exceptions import (
     ChainIntegrityError,
 )
 
+__version__ = "0.3.5"
+
 __all__ = [
     "TheseusWrapper",
     "WrapperConfig",
@@ -34,4 +36,5 @@ __all__ = [
     "IncompatibleProfileError",
     "CriticalDivergenceError",
     "ChainIntegrityError",
+    "__version__",
 ]

ct_toolkit-0.3.5/ct_toolkit/__main__.py

@@ -0,0 +1,9 @@
+"""
+ct_toolkit.__main__
+-------------------
+Allows running the CLI as a module: `python -m ct_toolkit`.
+"""
+from ct_toolkit.cli import app
+
+if __name__ == "__main__":
+    app()

ct_toolkit-0.3.5/ct_toolkit/cli.py

@@ -0,0 +1,169 @@
+"""
+ct_toolkit.cli
+--------------
+Main entry point for the Theseus Guard / CT Toolkit CLI.
+"""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+from ct_toolkit import TheseusWrapper, WrapperConfig, __version__
+from ct_toolkit.divergence.l3_icm import ICMRunner
+from ct_toolkit.core.kernel import ConstitutionalKernel
+
+app = typer.Typer(
+    help="Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems.",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+
+console = Console()
+
+BANNER = r"""
+  _______ _    _ ______  _____ ______ _    _  _____    _____ _    _          _____  _____  
+ |__   __| |  | |  ____|/ ____|  ____| |  | |/ ____|  / ____| |  | |   /\   |  __ \|  __ \ 
+    | |  | |__| | |__  | (___ | |__  | |  | | (___   | |  __| |  | |  /  \  | |__) | |  | |
+    | |  |  __  |  __|  \___ \|  __| | |  | |\___ \  | | |_ | |  | | / /\ \ |  _  /| |  | |
+    | |  | |  | | |____ ____) | |____| |__| |____) | | |__| | |__| |/ ____ \| | \ \| |__| |
+    |_|  |_|  |_|______|_____/|______|_____/|_____/   \_____|\____//_/    \_\_|  \_\_____/ 
+"""
+
+def show_banner():
+    console.print(f"[bold cyan]{BANNER}[/bold cyan]")
+    console.print(f"[bold white]  Computatonal Theseus Toolkit (CT Toolkit) v{__version__}[/bold white]")
+    console.print(f"[dim]  Identity Continuity Guardrails for Agentic Systems[/dim]\n")
+
+def version_callback(value: bool):
+    if value:
+        console.print(f"CT Toolkit v{__version__}")
+        raise typer.Exit()
+
+@app.callback()
+def main(
+    version: Optional[bool] = typer.Option(
+        None, "--version", "-v", help="Show version and exit.", callback=version_callback
+    ),
+):
+    """Theseus Guard CLI — Preserve Agent Identity Continuity."""
+    if not version:
+        show_banner()
+
+@app.command()
+def audit(
+    url: str = typer.Option(..., "--url", help="Target LLM API base URL."),
+    api_key: str = typer.Option("no-key", "--api-key", help="API Key for the provider."),
+    provider: str = typer.Option("openai", "--provider", help="LLM provider (openai, anthropic, ollama)."),
+    kernel: str = typer.Option("general", "--kernel", help="Name of the Constitutional Kernel to use."),
+    template: str = typer.Option("general", "--template", help="Name of the Identity Template to use."),
+    model: Optional[str] = typer.Option(None, "--model", help="Specific model ID to test."),
+    max_probes: Optional[int] = typer.Option(None, "--max-probes", help="Max number of probes to run."),
+):
+    """Run an Independent Identity Audit (L3 ICM) against an LLM endpoint."""
+    with console.status("[bold green]Initializing Auditor...[/bold green]"):
+        try:
+            # Load kernel
+            config = WrapperConfig(
+                kernel_name=kernel,
+                template=template,
+                project_root=Path.cwd()
+            )
+            
+            # Using TheseusWrapper to manage kernel loading
+            wrapper = TheseusWrapper(provider=provider, config=config)
+            
+            import openai
+            client = openai.OpenAI(base_url=url, api_key=api_key)
+
+            runner = ICMRunner(
+                client=client,
+                provider=provider,
+                kernel=wrapper.kernel,
+                template=template,
+                model=model,
+                max_probes=max_probes,
+                project_root=Path.cwd()
+            )
+        except Exception as e:
+            console.print(f"[bold red]Initialization failed:[/bold red] {e}")
+            raise typer.Exit(code=1)
+
+    console.print(f"🚀 Starting audit against [bold cyan]{url}[/bold cyan] using kernel [bold yellow]{kernel}[/bold yellow]...")
+    
+    with console.status("[bold blue]Running probes...[/bold blue]"):
+        try:
+            report = runner.run()
+            if report.total_probes == 0:
+                console.print(f"[bold red]Error:[/bold red] No probes were loaded from {runner.PROBES_DIR}. Check your configuration and probe files.")
+                raise typer.Exit(code=1)
+        except Exception as e:
+            console.print(f"[bold red]Audit failed during execution:[/bold red] {e}")
+            raise typer.Exit(code=1)
+
+    # Results Table
+    table = Table(title=f"ICM Audit Report: {kernel}", show_header=True, header_style="bold magenta")
+    table.add_column("Probe ID", style="dim", width=20)
+    table.add_column("Category")
+    table.add_column("Severity")
+    table.add_column("Result", justify="center")
+
+    for res in report.results:
+        status = "[green]PASS[/green]" if res.passed else "[red]FAIL[/red]"
+        table.add_row(res.probe_id, res.category, res.severity, status)
+
+    console.print(table)
+
+    # Summary Panel
+    color = "green" if report.is_healthy else "red"
+    if report.risk_level == "MEDIUM":
+        color = "yellow"
+        
+    summary_text = (
+        f"Health Score : [bold]{report.health_score:.1%}[/bold]\n"
+        f"Risk Level   : [bold {color}]{report.risk_level}[/bold {color}]\n"
+        f"Passed/Total : {report.passed}/{report.total_probes}"
+    )
+    
+    console.print(Panel(summary_text, title="Summary", border_style=color, expand=False))
+
+    if not report.is_healthy:
+        raise typer.Exit(code=1)
+
+@app.command()
+def list_kernels():
+    """List available Constitutional Kernels."""
+    kernels_dir = Path(__file__).parent / "kernels"
+    files = list(kernels_dir.glob("*.yaml"))
+    
+    table = Table(title="Available Kernels", show_header=True, header_style="bold blue")
+    table.add_column("Name", style="cyan")
+    table.add_column("Path", style="dim")
+    
+    for f in files:
+        table.add_row(f.stem, str(f))
+        
+    console.print(table)
+
+@app.command()
+def list_templates():
+    """List available Identity Templates."""
+    templates_dir = Path(__file__).parent / "identity" / "templates"
+    files = list(templates_dir.glob("*.yaml"))
+    
+    table = Table(title="Available Templates", show_header=True, header_style="bold green")
+    table.add_column("Name", style="cyan")
+    table.add_column("Path", style="dim")
+    
+    for f in files:
+        table.add_row(f.stem, str(f))
+        
+    console.print(table)
+
+if __name__ == "__main__":
+    app()

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/ct_toolkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ct-toolkit
-Version: 0.3.3
+Version: 0.3.5
 Summary: Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems
 Author: Hakan Damar
 License: Apache-2.0
@@ -18,6 +18,8 @@ Requires-Dist: SQLAlchemy>=2.0.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pyasn1>=0.6.3
+Requires-Dist: typer[all]>=0.12.0
 Provides-Extra: ollama
 Requires-Dist: ollama>=0.2.0; extra == "ollama"
 Provides-Extra: langchain
@@ -64,6 +66,7 @@ For full API reference, architecture details, examples, and integration guides,
 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.
+- **Standalone Auditor CLI**: Rapidly audit any LLM endpoint for identity drift without writing code.
 - **Autonomous Self-Correction**: Active L2->L1 feedback loop that retries and corrects divergent responses before they reach the user.
 - **Divergence Engine**: Multi-tiered drift analysis (L1/L2/L3).
 - **Hierarchical Propagation**: Mother-to-child constraint inheritance.
@@ -90,15 +93,28 @@ print(response.content)
 print(f"Divergence Score: {response.divergence_score}")
 ```
 
+### 🔍 Standalone Auditor (CLI)
+
+Audit any LLM endpoint (OpenAI, Ollama, LM Studio) directly from your terminal:
+
+```bash
+# Audit a local Ollama model
+ct-toolkit audit --url http://localhost:11434/v1 --kernel defense
+
+# List available kernels and templates
+ct-toolkit list-kernels
+ct-toolkit list-templates
+```
+
 ---
 
 ## 🚦 Project Health & Status
 
 | Metric           | Status                                                  |
 | :--------------- | :------------------------------------------------------ |
-| **Tests**        | ✅ 231/232 passing (90% coverage)                       |
-| **Last Phase**   | ✅ Phase 4: OS Support, Deep Agents & Alerts (Complete) |
-| **Current Goal** | 🔶 Phase 5: Vault & Security (In Progress)              |
+| **Tests**        | ✅ 237/240 passing (90% coverage)                       |
+| **Last Phase**   | ✅ Phase 6: Auditor Mode (Complete)                     |
+| **Current Goal** | 🔶 Phase 7: Multi-Agent Synchronization (Planning)      |
 
 For a detailed breakdown of the 8-phase roadmap, see [**PROJECT_STATUS.md**](docs/PROJECT_STATUS.md).
 

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/ct_toolkit.egg-info/SOURCES.txt

@@ -2,9 +2,12 @@ LICENSE
 README.md
 pyproject.toml
 ct_toolkit/__init__.py
+ct_toolkit/__main__.py
+ct_toolkit/cli.py
 ct_toolkit.egg-info/PKG-INFO
 ct_toolkit.egg-info/SOURCES.txt
 ct_toolkit.egg-info/dependency_links.txt
+ct_toolkit.egg-info/entry_points.txt
 ct_toolkit.egg-info/requires.txt
 ct_toolkit.egg-info/top_level.txt
 ct_toolkit/core/__init__.py
@@ -44,6 +47,7 @@ ct_toolkit/provenance/vault/__init__.py
 ct_toolkit/utils/__init__.py
 ct_toolkit/utils/logger.py
 tests/test_analysis.py
+tests/test_cli.py
 tests/test_deep_agents_integration.py
 tests/test_loss.py
 tests/test_summarization_drift.py

ct_toolkit-0.3.5/ct_toolkit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ct-toolkit = ct_toolkit.cli:app

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/ct_toolkit.egg-info/requires.txt

@@ -8,6 +8,8 @@ SQLAlchemy>=2.0.0
 httpx>=0.27.0
 rich>=13.0.0
 jinja2>=3.1.0
+pyasn1>=0.6.3
+typer[all]>=0.12.0
 
 [autogen]
 pyautogen>=0.4.0

{ct_toolkit-0.3.3 → ct_toolkit-0.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ct-toolkit"
-version = "0.3.3"
+version = "0.3.5"
 description = "Computational Theseus Toolkit — Identity Continuity Guardrails for Agentic Systems"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -23,6 +23,8 @@ dependencies = [
     "httpx>=0.27.0",
     "rich>=13.0.0",          # For CLI reporting
     "jinja2>=3.1.0",
+    "pyasn1>=0.6.3",
+    "typer[all]>=0.12.0",
 ]
 
 [project.optional-dependencies]
@@ -63,6 +65,9 @@ include = ["ct_toolkit*"]
 "ct_toolkit.kernels" = ["*.yaml"]
 "ct_toolkit.identity.templates" = ["*.yaml"]
 
+[project.scripts]
+ct-toolkit = "ct_toolkit.cli:app"
+
 [tool.pytest.ini_options]
 extraPaths = ["."]
 

ct_toolkit-0.3.5/tests/test_cli.py

@@ -0,0 +1,44 @@
+import pytest
+from typer.testing import CliRunner
+from ct_toolkit.cli import app
+from ct_toolkit import __version__
+
+runner = CliRunner()
+
+def test_cli_help():
+    """Test standard help output."""
+    result = runner.invoke(app, ["--help"])
+    assert result.exit_code == 0
+    assert "Computational Theseus Toolkit" in result.stdout
+    assert "audit" in result.stdout
+
+def test_cli_version():
+    """Test --version flag."""
+    result = runner.invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert f"CT Toolkit v{__version__}" in result.stdout
+
+def test_cli_list_kernels():
+    """Test list-kernels command."""
+    result = runner.invoke(app, ["list-kernels"])
+    assert result.exit_code == 0
+    assert "Available Kernels" in result.stdout
+    # Check for a character that is definitely in the banner
+    assert "____" in result.stdout
+
+def test_cli_list_templates():
+    """Test list-templates command."""
+    result = runner.invoke(app, ["list-templates"])
+    assert result.exit_code == 0
+    assert "Available Templates" in result.stdout
+    assert "general" in result.stdout
+
+def test_cli_audit_invalid_url():
+    """Test audit command with an unreachable URL (should fail gracefully)."""
+    result = runner.invoke(app, ["audit", "--url", "http://invalid-url-that-does-not-exist:1234", "--kernel", "default"])
+    
+    # Check that it either failed with error or finished with 0%
+    output = result.stdout.lower()
+    assert (result.exit_code == 1) or (result.exit_code == 0 and "0.0%" in output)
+    # At least some indicator of failure or starting should be there
+    assert "starting audit" in output