Skip to main content

visiq — VisIQ agent-governance harness for Python

Action governance, retrieval governance, and audit-trail reporting, from one Governor wrapper. Decisions are made in-process by the compiled VisIQ core that every VisIQ SDK shares — the same engine behind @visiq/harness — exposed through an ergonomic Python API. The engine ships as compiled machine code.

import visiq
d = visiq.gate_action(bundle, tool_name="wire_transfer", args={"amount": 999}, agent_id="a")
if not d["allowed"]:
    ...  # block — the tool never runs

Why it's real (not a prototype)

  • Installable: maturin builds an abi3 wheel (pip install visiq) — ONE binary for py3.9+; the engine is compiled machine code, no source in the artifact (closed / hard-to-RE, better than npm minification).
  • Correct: it reuses the proven rego engine (../rseval/engine, 1316/1316 vs L0) + the unified-runtime layer matched to the real TS UnifiedRuntime.

Structure

  • src/lib.rs — the Path-B core + PyO3 _core.evaluate(event_json, bundle_json).
  • python/visiq/__init__.py — the ergonomic API (decide / gate_action / gate_retrieval).
  • conformance.pyGATE 1: the installable SDK reproduces the event-corpus stamps (== shipped TS SDK decisions) across the full 118-vector corpus.
  • interception_smoke.pyGATE 2: a REAL LlamaIndex FunctionAgent's tool dispatch is governed by the REAL compiled core (denied tool never executes; committed negative control).

Publishing (CTO-gated)

.github/workflows/pypi-publish.ymlworkflow_dispatch-only; builds closed abi3 wheels for every platform, runs both gates (required), then publishes via PyPI OIDC Trusted Publishing behind the production environment (CTO approval). No SDK is claimed "supported" on the integrations page until it is genuinely installable AND passes both gates.

Build + verify

./run.sh

Prereq: Rust toolchain + python3 -m venv .venv && .venv/bin/pip install maturin llama-index-core.

Scope + next

Covers every event→input dimension + verb + the no-coverage posture (action: verb→read/write/delete/admin→approve/deny/ask, a faithful port of the TS resolveNoCoverage; retrieval: always fail-closed). Next: grow the event corpus toward full L0 breadth; then the Ruby/Go/Java/Node bindings over the SAME core, each gated by this same corpus.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

visiq-0.2.4-cp39-abi3-win_amd64.whl (970.2 kB view details)

Uploaded CPython 3.9+Windows x86-64

visiq-0.2.4-cp39-abi3-musllinux_1_2_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.9+musllinux: musl 1.2+ x86-64

visiq-0.2.4-cp39-abi3-musllinux_1_2_aarch64.whl (1.4 MB view details)

Uploaded CPython 3.9+musllinux: musl 1.2+ ARM64

visiq-0.2.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.17+ x86-64

visiq-0.2.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.2 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.17+ ARM64

visiq-0.2.4-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (2.1 MB view details)

Uploaded CPython 3.9+macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

File details

Details for the file visiq-0.2.4-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: visiq-0.2.4-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 970.2 kB
  • Tags: CPython 3.9+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for visiq-0.2.4-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 c79345b4ea26188b07ee0f7566ba89f3ba13d8b108c9f93b3570b9be96f15fea
MD5 4e437c441c4ab5bf290e008e03812031
BLAKE2b-256 89d5440157f88f6e0f9a92b945cb99b43a8e63b4b6722df0f795a3e24342494f

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-win_amd64.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file visiq-0.2.4-cp39-abi3-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: visiq-0.2.4-cp39-abi3-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.9+, musllinux: musl 1.2+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for visiq-0.2.4-cp39-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 389ea1f09a7cc30efe47a6f5b3b009971378f474d7651cfdc2ef9656a7b16aff
MD5 b1047804a86f6d54b653c5d577b17304
BLAKE2b-256 fd226416109ce0062a8644c6b1a4a10545fce8474ab8c8922f7b1bd950618e3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-musllinux_1_2_x86_64.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file visiq-0.2.4-cp39-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for visiq-0.2.4-cp39-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 abddee4cbf6970600a85a98b2a39684c0d8a359ea9d64bcab75382a563bcf6ca
MD5 8fc9eaccabcaa404a9a09fed7cbe90ec
BLAKE2b-256 41ae16cc5132694be64cde53322f2249a179ec2face8156a79d3c6f499111a8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-musllinux_1_2_aarch64.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file visiq-0.2.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for visiq-0.2.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 05a3026e6d64602682ca1198d1f20e34d18e1335ec118e5f5e937e98cb8ea611
MD5 85f0441e21a4865517295055b90335ae
BLAKE2b-256 bc775b7e20c6c04036878c9afb760eec234b32dfbc6b2ed69def5955b62f02ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file visiq-0.2.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for visiq-0.2.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 66422233316b6abefdc2e85b7a2e6ee7cbf2c06ad7e970c9af905f2dae243ae1
MD5 58db92dc981f13e485444ca1a4bdf7b0
BLAKE2b-256 f8b20802969c2da253219b25b08c81d1dcb3c2c857e745b0a38c63d098f62c67

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file visiq-0.2.4-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl.

File metadata

File hashes

Hashes for visiq-0.2.4-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm Hash digest
SHA256 ea744280f1daefe0abde387d885c5e33fedee046722c9a89b36e41284c3ac1ab
MD5 def113aa25c7dbb970463cae7c2064e9
BLAKE2b-256 160a7b54127cec704f22c36f34d05f76e72507766a97ece782feffc9e9217d3e

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.2.4-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl:

Publisher: pypi-publish.yml on VISIQ-LABS/xy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.0

6 files

This release

0.2.4 This release

6 files

0.2.3

6 files

0.2.2

6 files

0.2.1

6 files

0.2.0

6 files

0.1.0

6 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