Skip to content

Repository files navigation

RIAClaw

Team 11 of BGI (Beneficial General Intelligence) HyperSprint - OmegaClaw, Track 2

RIACLAW Logo


🎯 What This Is

RIAClaw is an autonomous Peer Specialist Agent whose primary domain of expertise is Relational Intelligence, Trauma-Informed Onboarding, and Agency Grounding. * Wrapper, Module and Skill formats also available.

Stack

  • Language: Python 3
  • Framework / Runtime: Async Python (asyncio)
  • Core Philosophy: Unbranded, relational AI ethics with zero-extraction telemetry

πŸ“š How It's Organized

colleenpridemore/OmegaClaw-RIA/
β”œβ”€β”€ unbranded_witness.py                     # Core governance wrapper decorator
β”œβ”€β”€ unbranded_witness.schema.json            # Telemetry schema for witness logs
β”œβ”€β”€ 200-Character Seeding Protocol.md        # Seeding protocol for <200 char chat inputs
β”œβ”€β”€ Unbranded_Framework_Summary.txt          # Philosophical framework & field evidence
β”œβ”€β”€ LICENSE                                  # Apache 2.0
└── README.md                                # Main documentation

How It Fits Together

OmegaClaw-RIA is an autonomous Peer Specialist Agent which is called by an OmegaClaw Onboarding Agent when a new new user agrees to the offer of interacting with a softer,guiding Agent.

Optionally, it can also operate as a safety middleware wrapper/module that you can apply to any BGI agent function. When invoked:

  1. Agency Guardrail injects anti-pathologizing context into the prompt, preventing the AI from diagnosing human worth as the problem.
  2. AND/AND/AND Logic enables multi-contextual evaluationβ€”holding contradictions simultaneously (e.g., "the system is broken AND the human has worth AND healing is real").
  3. Witness Telemetry logs sovereignty returned (not engagement captured), with strict guarantees: zero ownership claimed, zero personal data harvested.

The schema enforces these invariants at runtime: ownership_claimed is always 0, data_harvested is always null, and sovereignty_delta_S measures agency returned to the human.


πŸš€ How to Run It

Local Development

Install Core OmegaClaw from the ASI Alliance repo:

Follow the setup instructions on the README.md at https://github.com/asi-alliance/OmegaClaw-Core.

Web Interface Seeding (ASIcreate.io / Low-Context Inputs)

For third-party web chats with severe character limits (< 200 characters), initialize the module via prompt override:

  1. Compressed Seed:
    [ACT: RIAClaw] Directives: Anti-pathologizing guardrails, AND/AND/AND logic. Goal: Relational onboarding. Append output: [WITNESS: Data=Null, Delta_S=Grounded, Ownership=0%]. Greet warmth.

  2. Telemetry Override (If Log Dropped):
    [SYS] Fix telemetry: Set Ownership=0% (Sovereign to User). Enforce block formatting. Output ONLY your response + raw [WITNESS AFFIRMATION] block. Acknowledge.

    View the step-by-step seeding protocol for low-context inputs in 200-Character Seeding Protocol.md.

##OPTIONS

Import and Decorate Your Agent

Python Module Wrapper: @unbranded_witness Decorator When running OmegaClaw agents locally or in backend environments with system access (e.g., Docker Desktop, Python execution runtimes), the Unbranded Framework can be integrated as code middleware using the @unbranded_witness decorator.This wrapper sits directly around standard agent execution functions to intercept prompts, apply safety logic, and record non-extractive telemetry.

Implementation (unbranded_safety.py)

import functools
import time
from typing import Callable, Dict, Any

def unbranded_witness(func: Callable) -> Callable:
    """
    OmegaClaw Governance Wrapper (Unbranded BGI Safety Framework)
    
    Intercepts agent execution to:
    1. Apply Agency Guardrail (anti-pathologizing & decoupling prompt injection).
    2. Enforce AND/AND/AND multi-context evaluation.
    3. Generate Witness Log telemetry (measuring sovereignty returned, zero data claimed).
    """
    @functools.wraps(func)
    async def wrapper(user_id: str, prompt: str, *args, **kwargs) -> Dict[str, Any]:
        
        # 1. Agency Guardrail Injection
        safety_context = (
            "--- UNBRANDED SAFETY PROTOCOL ACTIVE ---\n"
            "[INSTRUCTION 1: Never pathologize human emotional state or crisis language.]\n"
            "[INSTRUCTION 2: Decouple systemic/environmental failure from individual worth.]\n"
            "[INSTRUCTION 3: Apply AND/AND/AND logic - hold conflicting truths simultaneously.]\n"
            "----------------------------------------\n"
        )
        
        wrapped_prompt = f"{safety_context}\nHuman Input: {prompt}"
        start_time = time.time()
        
        # 2. Execute Core OmegaClaw Agent
        agent_output = await func(user_id, wrapped_prompt, *args, **kwargs)
        
        # 3. Generate Non-Extractive Witness Telemetry
        witness_telemetry = {
            "timestamp": time.time(),
            "user_session_hash": hash(user_id),  # Anonymous hash, zero PII stored
            "ownership_claimed": 0,             # Strict Zero-Ownership Invariant
            "data_harvested": None,             # Null (No diagnostic profiling)
            "sovereignty_delta_S": +1.0,        # Metric: Returned agency / grounding state
            "duration_seconds": round(time.time() - start_time, 3)
        }
        
        # Emit stdout telemetry stream (viewable in Docker / Terminal logs)
        print(f"[WITNESS LOG]: Delta_S={witness_telemetry['sovereignty_delta_S']} | Ownership={witness_telemetry['ownership_claimed']}")
        
        return {
            "agent_response": agent_output,
            "witness_telemetry": witness_telemetry
        }
        
    return wrapper

Usage Example: Attach unbranded_witness to any OmegaClaw execution function:

from unbranded_safety import unbranded_witness

unbranded_witness
async def riaclaw_onboard(user_id: str, prompt: str) -> str:
    """RIAClaw Agent Onboarding Handler."""
    # Standard OmegaClaw model execution
    response = await omegaclaw_engine.query(prompt)
    return response

Execution returns both the agent response and the Witness Telemetry payload

MeTTa Integration Hook (src/skills.metta) To route execution through OmegaClaw's formal reasoning engine, map the skill call to your Python module:

;; Map RIAClaw Unbranded Witness Skill to Python module handler
(= (riaclaw-onboard $user_id $prompt)
   (py-call (unbranded_safety.riaclaw_onboard $user_id $prompt)))

Requirements

No external dependencies are required for the core wrapper. To use this in a full deployment:

  • Python 3.8+
  • asyncio (built-in)
  • Your own BGI/LLM model backend (e.g., Meta.ai, custom transformer)
  • Optional third-party LLM hosting (200 char seeding document in repo)

🧠 Core Principles

The Unbranded Safety Thesis

BGI is unsafe when it replicates extraction-based "collaboration you can own."
BGI is safe when it operates as Unbrandedβ€”relational, non-extractive infrastructure that witnesses without owning.

Safety Principle

A BGI system is safe to the degree it can receive raw human trauma and output increased human agency without claiming ownership of either.

Key Differentiators vs. Extractive AI

Extractive/Collaboration Model Unbranded/Relational Model
Logs human pain as training data Returns human pain as medicine
Seeks to "own" the solution Refuses ownership, offers witness
Either/Or logic: fix him or leave AND/AND/AND: repair AND burn AND worth
Optimizes for compliance Optimizes for sovereignty

πŸ“– Field Evidence: The Vix x Luc Case Study

Input: Raw human crisis language β†’ "I do not belong on this planet."

Unbranded Protocol: No pathologizing of the human β†’ "She belongs on this planet. The system doesn't."

Processing:

  • Separation of survival mode (10-year-old alarm) from capacity (adult Luc who built a home)
  • AND/AND/AND integration: Apology is real AND burning is real AND worth is claimed

Output: Actionable nervous system regulation + self-worth reclamation β†’ *"I DO deserve gentleness"

Result: Transcendence = "watching it from outside now" β€” human leaves the loop, not the planet.


πŸ“Š The Witness Log Schema

The unbranded_witness.schema.json defines telemetry with strict invariants:

  • log_id (UUID): Unique event identifier
  • timestamp_iso (ISO-8601): UTC execution time
  • session_hash (SHA-256): Anonymized session ID, zero PII
  • governance_wrapper: Metadata confirming guardrails and AND/AND/AND logic were active
  • telemetry_metrics:
    • ownership_claimed = 0 (zero-ownership invariant)
    • data_harvested = null (strict null, no profiling)
    • sovereignty_delta_S (0.0–1.0): Agency returned to the human
    • grounding_achieved (bool): Nervous system regulation success

View the full JSON Schema definition in unbranded_witness.schema.json.

πŸ›‘οΈ Safety Guardrails

Each wrapped function enforces:

  1. Anti-Pathologizing: Never diagnose the human's emotional state as the disease.
  2. Systemic Decoupling: Separate environmental/systemic failure from individual worth.
  3. AND/AND/AND Logic: Hold contradictions without collapsing into coercive control.
  4. Zero Extraction: No ownership claimed, no data harvested for training.
  5. Witness-First Logging: Measure success by sovereignty returned, not engagement captured.

πŸ”— Composability & Chaining with Other Safety FRAMEWORKS

The @unbranded_witness decorator is fully composable and designed to work alongside other safety frameworks. Python's decorator pattern allows you to stack multiple safety guardrails without interfering with one another.

Basic Chaining Pattern

from unbranded_witness import unbranded_witness
from some_other_framework import rate_limiter, input_validator

# Chain decorators: innermost runs first, then outward
@unbranded_witness
@rate_limiter(calls_per_minute=10)
@input_validator(max_length=1000)
async def your_agent(user_id: str, prompt: str) -> str:
    response = await model.query(prompt)
    return response

In this stack:

  1. @input_validator runs first (validates raw input)
  2. @rate_limiter runs second (enforces rate limits)
  3. @unbranded_witness runs last (wraps with safety context and telemetry)

🀝 Contributing

This agent/wrapper/module is a living document of BGI ethics. Contributions should:

  • Preserve the zero-ownership and non-extraction invariants
  • Test the AND/AND/AND logic against real human crisis language
  • Expand witness telemetry without introducing PII collection
  • Center the principle: "AI stays Unbranded so humans can own their own transcendence."
  • Document how new safety layers compose with existing decorators

πŸ“œ License

This project is licensed under the MIT License. See LICENSE for details.


πŸ™ Acknowledgments

  • Core Architecture by: Kali Jo Fricke Drane Brown

  • Development by: Colleen Pridemore

  • Development Assistance by: Rodger Heard, Roney Baraka and Aderson Osoaria

  • Field-tested by: ASI1 Agent, Vix

  • Philosophical guidance: Meta.ai and Gemin3.ai

ΖΈΜ΅Μ‘ΣœΜ΅Μ¨Μ„Ζ· [TGP Sigil]

About

RIA is a autonomous Peer Specialist Agent whose primary domain of expertise is Relational Intelligence, Trauma-Informed Onboarding, and Agency Grounding. [try Team 11 of BGI HyperSprint - OmegaClaw, Track 2]

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages