Skip to main content

Stop unsafe AI actions before they execute

Project description

Waveframe Guard

Deterministic execution control for AI agents.

Stop unauthorized AI actions—from rogue financial transfers to unapproved budget reallocations—in a single function call.

Prevent costly mistakes before they hit production systems.


The execution boundary

Most AI governance tools act as monitors: they log, flag, and alert after a mistake has already happened.

Waveframe Guard sits directly at the execution boundary. It evaluates every proposed action before it ever reaches your backend or mutates state.

The evaluation is deterministic and the result is binary:

  • Allowed → execution proceeds seamlessly
  • Blocked → execution is stopped before it reaches your system

No warnings. No post-hoc analysis. The action either happens, or it doesn’t.


A drop-in execution gate

Integrate Waveframe Guard into your workflow in minutes.

Initialize the SDK with your compiled governance policy, pass the proposed AI action, and let Guard handle the evaluation.

from waveframe_guard import WaveframeGuard

guard = WaveframeGuard(policy="finance-policy.json")


def execute_transfer(action):
    return {
        "status": "executed",
        "details": action
    }


def process_ai_action(action, actor, context=None):
    decision = guard.execute(
        action=action,
        actor=actor,
        context=context
    )

    if decision["allowed"]:
        return execute_transfer(action)
    else:
        return {
            "status": "blocked",
            "reason": decision["reason"]
        }


result = process_ai_action(
    action={"type": "transfer", "amount": 5000},
    actor="ai-agent",
    context={"approved_by": "human-123"}
)

print(result)

Waveframe Guard does not execute actions.

It decides whether execution is allowed.


Predictable, standardized outputs

Guard returns a strict, predictable response so your application can route logic deterministically.

Authorized attempt:

{
  "allowed": true,
  "reason": "Allowed: execution permitted"
}

Unauthorized attempt (missing approval):

{
  "allowed": false,
  "reason": "Blocked: approval required (no approver provided)"
}

Built for financial-grade governance

Waveframe Guard is designed for high-stakes autonomous systems.

  • Separation of duties The actor proposing an action cannot approve it.

  • Approval requirements Human authorization is required for sensitive actions.

  • Action-level constraints Define exactly what an agent is allowed to do.

  • No state stored Your system remains in full control.


Clear boundaries

Waveframe Guard focuses on one responsibility:

👉 deciding whether an action can execute

It does not:

  • run workflows
  • manage approvals
  • store policies
  • maintain system state

Getting started

Waveframe Guard is in active development, focused on financial governance and autonomous agent control.

Local installation

pip install -e .

(PyPI release coming soon)


Run the example

python examples/finance_usage.py

Policy

Policies represent compiled governance rules.

guard = WaveframeGuard(policy="finance-policy.json")

These rules define:

  • who can approve actions
  • what actions require approval
  • role separation requirements

Proprietary / Commercial License (Pending)
© 2026 Waveframe Labs

Project details


Download files

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

Source Distribution

waveframe_guard-0.1.0.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

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

waveframe_guard-0.1.0-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file waveframe_guard-0.1.0.tar.gz.

File metadata

  • Download URL: waveframe_guard-0.1.0.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for waveframe_guard-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4d2af833ae086ec0d657a5342d9e5223a5741acf4fea4b8205c3cfd5d59b70c8
MD5 7be5dfca4aca4e77481ad79615910b0e
BLAKE2b-256 0f1d29b37160ad476b0cc0c1ded484dcf5240dd213280f81d73f59f35a208eb0

See more details on using hashes here.

File details

Details for the file waveframe_guard-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for waveframe_guard-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 13a4fdf0fa36d6dc83a716b29dc5d84e770d05dfd25a23c2e63d2358e969d944
MD5 fe9f12db8d819d5ff8eaa5818112906e
BLAKE2b-256 736325f8a630378130f54920e102aaf27c239fc9058bc4cb2c645d8fbe0b1341

See more details on using hashes here.

Supported by

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