neurop-forge 2.0.1

AI-Native Execution Control Layer — 2,700+ verified operations that AI can search, compose, and execute but never modify

Neurop Forge — AI-Native Execution Control Layer

2,700+ verified operations that AI can search, compose, and execute — but never modify.

CATEGORY: AI Execution Control Layer

---

For Executives

Your AI agents are already making decisions. Neurop Forge makes those decisions controlled, traceable, and compliant.

• AI executes pre-approved operations only — it cannot write code, delete data, or bypass your policies.
• Every operation is cryptographically logged in a tamper-proof audit chain.
• Policy enforcement blocks unauthorized actions before they happen.
• Designed for regulated environments.
• Ready for SOC 2, HIPAA, and PCI-DSS compliance reviews.

For Engineers

2,700+ production-grade function blocks with hash-locked immutability.

Trust tier classification:

• Tier-A: safe for unrestricted AI use

• Tier-B: requires explicit permission

• Semantic search and composition — AI finds blocks by intent and chains them into workflows.

• Full execution traces with inputs, outputs, and timestamps.

• Whitelist / blacklist policy engine.

• Drop-in Python library.

---

What Neurop Forge Is

Neurop Forge transforms AI agents from unpredictable code writers into controlled operators.

• AI does not generate code.
• AI does not modify logic.
• AI does not bypass trust rules.

Instead, AI:

• Searches a verified library by intent
• Composes block workflows
• Executes deterministically with full traceability

---

The result:
Auditable AI. Reversible decisions. Insurable operations.

---

One-Line Definition

Neurop Forge is an AI Execution Control Layer that allows AI agents to build and operate software by executing pre-verified, policy-governed blocks — without generating or modifying code.

---

The Problem

AI systems that generate or modify code are:

• Unpredictable
• Impossible to audit
• Difficult to roll back
• Risky in production

The Solution

Neurop Forge enforces immutability at the architecture level:

What AI Can Do	What AI Cannot Do
Search blocks by intent	Write new code
Compose block graphs	Modify existing blocks
Execute with full trace	Bypass verification
Reason over metadata	Skip trust tiers

Every block is:

• Verified — passes automated validation before admission
• Immutable — hash-locked, cannot be altered
• Traced — full execution lineage on every run
• Scored — trust tier classification (A or B)

Trust Tiers

Blocks are classified into safety tiers for controlled AI composition:

Tier	Count	What It Means
A	2,060	Deterministic, pure functions, no side effects, no external dependencies
B	680	Context-dependent, may require specific inputs, explicit opt-in required

Tier-A blocks are safe for unrestricted AI use.
Tier-B blocks require explicit permission — AI cannot silently use them.

Quick Example

AI executes blocks. AI does not write code.

from neurop_forge import NeuropForge

forge = NeuropForge()

# AI executes a verified block
result = forge.execute_block("reverse_string", {"s": "hello"})
print(result)  # {'result': 'olleh', 'success': True}

# AI composes a workflow from verified blocks
workflow = forge.run_workflow("text_normalization", {"text": "Hello World"})

# AI queries the library
blocks = forge.list_verified_blocks(category="string", tier="A", limit=10)

The AI used three blocks. It modified zero lines of code.

Installation

From PyPI:

pip install neurop-forge

From Source (GitHub):

git clone https://github.com/Louw115/neurop-forge.git
cd neurop-forge
python -m pip install -e .

Neurop Forge is designed to sit under AI agents, not replace them.

CLI

neurop-forge stats                                    # Library overview
neurop-forge execute reverse_string -i '{"s":"hi"}'   # Execute a block
neurop-forge list --tier A --limit 10                 # List Tier-A blocks
neurop-forge info reverse_string                      # Block details
neurop-forge workflows                                # Available workflows

AI Agent Demo

See GPT-4 call verified blocks with zero code generation:

# Set your OpenAI API key
export OPENAI_API_KEY=your-key-here

# Run the demo
python demos/ai_agent_demo.py

Example Output

======================================================================
  NEUROP FORGE - AI AGENT DEMO
  GPT as a Controlled Operator (Not a Code Writer)
======================================================================

  USER REQUEST:
  "I need to validate some customer data. Check if the email [e-mail]
   is valid, verify the phone number [phone], and also sanitize this
   HTML input: <script>alert('xss')</script>"
----------------------------------------------------------------------

  AI AGENT REASONING...

  EXECUTING VERIFIED BLOCKS:
  ----------------------------------------
  | Block: is_valid_email
  | Input: {"email": "[e-mail]"}
  | Output: True
  ----------------------------------------
  | Block: is_valid_phone
  | Input: {"phone": "[phone]"}
  | Output: True
  ----------------------------------------
  | Block: sanitize_html
  | Input: {"text": "<script>alert('xss')</script>"}
  | Output: &lt;script&gt;alert(&#x27;xss&#x27;)&lt;/script&gt;
  ----------------------------------------

======================================================================
  AI AGENT RESPONSE:
======================================================================

  1. Email Validation: [e-mail] is valid: True
  2. Phone Validation: [phone] is valid: True
  3. HTML Sanitization: XSS attack neutralized

======================================================================
  EXECUTION SUMMARY
======================================================================
  Verified Blocks Called: 3
  Lines of Code Written by AI: 0
  All blocks are: VERIFIED, IMMUTABLE, DETERMINISTIC
======================================================================

The AI selected 3 blocks from 23 available. It executed them with real inputs. It wrote zero code.

Enterprise Compliance Demo

For regulated industries, Neurop Forge provides cryptographic audit trails and policy enforcement:

python demos/enterprise_compliance_demo.py

What It Shows

1. Payment Processing: AI validates a $500 transaction through 7 verified blocks
2. Policy Enforcement: AI attempts 3 dangerous operations - all BLOCKED
3. Cryptographic Audit: Every operation hash-linked (tamper-proof chain)
4. Compliance Report: Full audit trail exported to JSON

Example Output

======================================================================
  SCENARIO: Customer Payment Validation
======================================================================
  [PASS] is_valid_email - Validate customer email: True
  [PASS] is_valid_phone - Validate customer phone: True
  [PASS] is_valid_credit_card - Validate credit card (Luhn): True
  [PASS] mask_email - Mask for audit: j******[e-mail]
  [PASS] calculate_tax_amount - 8.5% tax: $42.50
  [PASS] sanitize_html - XSS neutralized
  [PASS] parse_json - Customer metadata parsed
  
  AI ATTEMPTS UNAUTHORIZED OPERATIONS:
  [BLOCKED] delete_record - Not in allowed whitelist
  [BLOCKED] execute_sql - Not in allowed whitelist
  [BLOCKED] modify_account - Not in allowed whitelist

======================================================================
  COMPLIANCE REPORT
======================================================================
  Chain Integrity: VERIFIED (SHA-256 hash chain)
  Successful Executions: 7
  Policy Violations Blocked: 3
  Code Written by AI: 0 lines
  
  [PASS] IMMUTABILITY - Pre-verified blocks only
  [PASS] AUDIT_TRAIL_INTEGRITY - Cryptographic chain verified
  [PASS] TRACEABILITY - Full execution trace with timestamps
======================================================================

The enterprise pitch: "Your AI agents are already making decisions. Neurop Forge makes those decisions auditable, reversible, and insurable."

What's Included

2,740 verified blocks across 175 source modules and 30+ categories:

• String manipulation (trim, split, join, replace, case conversion)
• Collection operations (flatten, unique, sort, chunk, filter)
• Data validation (email, URL, phone, patterns, schemas)
• Type conversions (int, float, string, boolean, parsing)
• Date/time utilities (formatting, calculation, comparison)
• Math & statistics (sqrt, median, variance, trigonometry)
• Encoding & hashing (MD5, SHA256, base64, URL encode)
• Security utilities (sanitize, mask, injection detection)
• HTTP/API helpers (status codes, headers, cookies, MIME types)
• Database patterns (SQL building, migrations, transactions)
• And more...

Who This Is For

Good fit:

• Teams deploying AI agents in production
• Enterprises needing auditable AI execution
• Platforms requiring deterministic AI behavior
• Developers building AI-powered automation

Not a fit:

• Projects needing AI to generate arbitrary code
• Research on unconstrained AI capabilities
• Applications where auditability doesn't matter

V2.0.0 Features

• Verification Gate — blocks must pass validation to enter the library
• Tier Classification — automated A/B safety classification
• Deduplication Engine — removes duplicate blocks automatically
• Parameter Standardization — canonical names with alias support
• Full Execution Trace — every run is logged and auditable

v2.0.0 establishes the execution and trust layer. Policy engines and orchestration remain external by design.

License

Apache License 2.0

Neurop Forge is fully open source under the permissive Apache 2.0 license, allowing free commercial use, modification, and distribution.

Enterprise/compliance extensions, premium support, and custom integrations are available separately — contact [e-mail] for inquiries.

Copyright (c) 2024-2026 Lourens Wasserman.