genpark-agent-budget-token-spend-circuit-breaker-skill

⚡ Overview & Architectural Significance

genpark-agent-budget-token-spend-circuit-breaker-skill provides zero-dependency, deterministic agentic execution safety, sandboxing, and financial circuit breakers engineered strictly using Python 3.9+ standard library.

🌟 Key Architectural Capabilities

• Zero External Dependencies: Operates exclusively via pure Python (math, re, collections, heapq, hashlib, json). Zero pip install overhead, zero C-extension compile errors.
• Enterprise Agent Safety Invariants: Implements formal defenses against destructive shell commands, prompt injections, runaway spend loops, differential privacy data leakage, and planning deadlocks.
• Native Anthropic MCP Protocol: Compliant with standard JSON-RPC 2.0 stdio MCP specifications for Claude Desktop, Cursor, and Windsurf.

🏗️ Architectural Safety State Machine

flowchart TD
    UserPrompt["Incoming User Instruction / External Input"] --> InjectionGuard["Prompt Injection & Jailbreak Sentinel"]
    
    InjectionGuard -->|Malicious Injection| BlockPrompt["Reject Prompt (400 Bad Request)"]
    InjectionGuard -->|Safe Prompt| AgentPlanner["Autonomous Agent Planner / LLM Core"]
    
    AgentPlanner --> CircuitBreaker["Token Spend & Cost Circuit Breaker"]
    CircuitBreaker -->|Budget Exceeded| FreezeSpend["Freeze Execution & Alert Admin"]
    CircuitBreaker -->|Within Budget| LoopDetector["Deadlock & Liveloss Loop Detector"]
    
    LoopDetector -->|Infinite Loop Detected| BreakLoop["Inject Corrective Guidance & Reroute Plan"]
    LoopDetector -->|Healthy Trajectory| CommandSandbox["Bash / Subprocess Sandbox Guard"]
    
    CommandSandbox -->|Destructive / Traversal| BlockCmd["Block Execution (Security Violation)"]
    CommandSandbox -->|Safe Command| ToolExec["Safe Tool Execution"]
    
    ToolExec --> PrivacyGuard["Synthetic Data Differential Privacy Guard"]
    PrivacyGuard --> SanitizedOutput["Sanitized Output & Verified Return"]

🚀 Quickstart & Standalone Execution

Local Python Client Usage

from client import AgentBudgetTokenSpendCircuitBreaker

# Initialize engine
engine = AgentBudgetTokenSpendCircuitBreaker()

# Execute self-testing benchmark suite
result = engine.run_benchmark_circuit_breaker()
print("Execution Result:", result)

🔌 One-Click MCP Integration (Claude Desktop / Cursor)

Add to your claude_desktop_config.json or cursor.json:

{
  "mcpServers": {
    "genpark-agent-budget-token-spend-circuit-breaker-skill": {
      "command": "python",
      "args": ["-u", "/path/to/genpark-agent-budget-token-spend-circuit-breaker-skill/mcp_server.py"]
    }
  }
}

📦 Smithery.ai & PyPI Deployment

This skill contains pre-configured smithery.yaml and pyproject.toml manifests. Install directly via pip:

pip install git+https://github.com/alphaparkinc/genpark-agent-budget-token-spend-circuit-breaker-skill.git