Skip to main content

Correctover-CCS v4.1.0

Agent Runtime Verification Protocol — 同步拦截,结构级 Fail-Closed 保证

Version Python License DOI


What is CCS?

CCS (Correctover Conformance Standard) is the Agent Runtime Verification Protocol — a protocol-level validation framework that provides structural fail-closed guarantee for LLM agent systems.

Unlike observer-pattern hooks that fail-open when the governance layer crashes, CCS ensures that if verification fails, the action is NEVER executed. This eliminates CWE-636 (failure to use fail-safe defaults) at the protocol level.

Core Properties

  • Structural Fail-Closed: Governance failure → action blocked (never executed)
  • Synchronous Interception: Validation happens BEFORE the tool call, not after
  • Sub-10μs Overhead: P50<10μs, P99<25μs (Python)
  • Semantic-Aware Verification: Intent-level code analysis, not keyword matching
  • Multi-Framework: CrewAI, LangChain, AutoGen, Ibex, Patronus

The Problem CCS Solves

AI Agent frameworks rely on observer-pattern governance hooks that are structurally fail-open. When the governance layer crashes, tool calls proceed unchecked — exposing systems to command injection, SSRF, and data exfiltration. CCS formalizes runtime conformance as Required(τ) ⊆ Supported(τ) — a simple, empirically-grounded criterion that guarantees fail-closed enforcement.


Quick Start

Python

pip install correctover-ccs
from ccs import govern

# Wrap any function with CCS governance
@govern(policy="default")
def search_web(query: str) -> str:
    return fetch_api(query)

search_web("test")  # ✅ Governed — validated before execution

TypeScript

npm install @correctover/ccs
import { govern } from "@correctover/ccs";

const governedSearch = govern(searchWeb, { policy: "default" });
governedSearch("test"); // ✅ Fail-closed guaranteed

4-Line Integration

from ccs import ConformantCrewAgent

agent = ConformantCrewAgent(my_crewai_agent)
result = agent.execute_task("Your task")
print(result.conformant)  # True / False

Architecture

┌─────────────────────────────────────────────────┐
│                   Agent Layer                    │
│   CrewAI / LangChain / AutoGen / Ibex / Patronus │
├─────────────────────────────────────────────────┤
│              CCS Runtime (v4.1.0)               │
│  ┌──────────┬──────────┬──────────┬──────────┐  │
│  │ Structure│  Schema  │  Latency │   Cost   │  │
│  │ Verifier │ Validator│  Monitor │  Monitor │  │
│  ├──────────┼──────────┼──────────┼──────────┤  │
│  │ Identity │ Integrity│  Policy  │ Failover │  │
│  │ Tracker  │  Checker │  Engine  │  Engine  │  │
│  ──────────┴──────────┴────────────────────┘  │
├─────────────────────────────────────────────────┤
│                 Tool / Action                    │
│  (Blocked if ANY dimension fails → Fail-Closed) │
└─────────────────────────────────────────────────┘

6-Dimension Verification

Dimension Verifies Failure Mode
Structure Action has valid structure (agent_id, action_type, required fields) Malformed action rejected
Schema Output matches expected schema Invalid output rejected
Latency Response time within bounds Timeout → Fail-Closed
Cost Token usage within limits Budget exceeded → blocked
Identity Action is traceable (unique ID) Untraceable → rejected
Integrity Output is complete (non-empty, valid hash) Corrupted → rejected

API Reference

Core

Interface Description
govern(fn, options?) Wrap function with CCS governance
getRuntime(config?) Get global CCS runtime singleton
ConformantCrewAgent(agent) CrewAI integration wrapper
ConformantLangChainAgent(agent) LangChain integration wrapper
ConformantAutoGenAgent(agent) AutoGen integration wrapper

Runtime

Method Returns Description
evaluate(toolName, toolInput, policy?) {result, latencyUs} Evaluate governance
registerPolicy(name, policy) void Register custom policy
getStats() RuntimeStats Performance statistics
getHealth() HealthStatus System health check

Custom Policy

from ccs import CCSPolicy, GovernanceResult

class BlockDeletePolicy(CCSPolicy):
    def evaluate(self, tool_name: str, tool_input: dict) -> GovernanceResult:
        if "delete" in tool_name or "rm" in tool_name:
            return GovernanceResult.DENY
        return GovernanceResult.ALLOW

Performance

Benchmarked on 50,000 iterations per scenario (CANON benchmark — see docs/performance_benchmark_20260725.md):

Metric Value
P50 Latency <10μs
P99 Latency <25μs
audit_log impact on P50 None

Test environment: Python 3.12, CANON benchmark


Semantic-Aware Verification

CCS goes beyond keyword matching. The verification engine performs intent-level code analysis:

exec() → isDictKeyConstant? → isSandboxedExec? → isCodeExecutionEngine?
→ isSafeEvalPattern? → none match → CRITICAL

This semantic depth means CCS can distinguish between benign and malicious code patterns that keyword-based scanners conflate — a key differentiator in real-world agent security auditing.


Framework Adapters

Framework Package Status
CrewAI correctover-crewai ✅ v4.1.0
LangChain correctover-ccs ✅ v4.1.0
AutoGen correctover-ccs ✅ v4.1.0
Ibex correctover-ibex ✅ v4.1.0
Patronus correctover-patronus ✅ v4.1.0
VS Code correctover extension ✅ v4.1.0

Deployment

Local

pip install correctover-ccs

Docker

FROM python:3.12-slim
RUN pip install correctover-ccs
COPY . /app
CMD ["python", "app.py"]

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: correctover-ccs
spec:
  template:
    spec:
      containers:
      - name: ccs
        image: correctover/ccs:4.1.0
        env:
        - name: CCS_POLICY
          value: "default"

Standards & Research


License

Commercial Proprietary License — © 2026 Correctover. All rights reserved.

Source code is publicly available for review, but remains proprietary. Commercial licensing inquiries: wangguigui@correctover.com


Enterprise Audit Service

Need a deep-dive security audit of your AI agent stack? Our team runs the same fail-closed methodology on your production tool surfaces — covering the RCE / SSRF / credential-hijack patterns CCS detects at runtime.

→ Book an enterprise audit

Get an audit for your team: correctover.com/audit | wangguigui@correctover.com


Contact


Correctover — Failover ≠ Correctover™

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

correctover_ccs-4.1.0.tar.gz (26.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

correctover_ccs-4.1.0-py3-none-any.whl (22.9 kB view details)

Uploaded Python 3

File details

Details for the file correctover_ccs-4.1.0.tar.gz.

File metadata

  • Download URL: correctover_ccs-4.1.0.tar.gz
  • Upload date:
  • Size: 26.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for correctover_ccs-4.1.0.tar.gz
Algorithm Hash digest
SHA256 045cc8b9137ffc1e485110c3b9512b2ca4ad3a4bdf6f04559ba04f3b4a28cf34
MD5 add7f5a58a930b2a7f830dff4f6a9114
BLAKE2b-256 855e1b6322f0cfaec9009be317c7af5bc4c2dbf15931b9f3d18a5686388b9373

See more details on using hashes here.

File details

Details for the file correctover_ccs-4.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for correctover_ccs-4.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 04c578dd7f9f3aa3d1844a7f84ba6e3238deb1b682cc4669a32303cae150dbf1
MD5 7dd6f87a028d7b6f6a74fd5235d2d4f2
BLAKE2b-256 ba5a9a8d53094f9453f147424a3c029862f4ef2ddd36b1eec13b39f7d00cec21

See more details on using hashes here.

Release history Release notifications | RSS feed

4.1.1

2 files

This release

4.1.0 This release

2 files

4.0.1

2 files

4.0.0

2 files

3.0.0

2 files

1.1.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page