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.3.0-cp39-abi3-win_amd64.whl (988.5 kB view details)

Uploaded CPython 3.9+Windows x86-64

visiq-0.3.0-cp39-abi3-musllinux_1_2_x86_64.whl (1.5 MB view details)

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

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

Uploaded CPython 3.9+musllinux: musl 1.2+ ARM64

visiq-0.3.0-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.3.0-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.3.0-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.3.0-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: visiq-0.3.0-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 988.5 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.3.0-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 b75ae7c3bdacb630e60e94455fd60ab5f6f46e0218e46acc0215143de36cf206
MD5 43bf342b026b9d267c5ab2c0266aad80
BLAKE2b-256 a6272361dbf07086452279d4ecae4468b5b074d25ab356a65911adf40e302ce8

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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.3.0-cp39-abi3-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: visiq-0.3.0-cp39-abi3-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 1.5 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.3.0-cp39-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 56041e3f5a670e7b9bff792d8fd5114656d6b242530931b7a46cb2b513621da0
MD5 c65807eb1c38c82ec2ffb41a7d51dfd1
BLAKE2b-256 b772bbfb506ddc95fc5b7fd0dae2442c35c0021724a5875002b5d9052d97f99b

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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.3.0-cp39-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for visiq-0.3.0-cp39-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 74d8d067275d9d862f4fbba24f4b057ebf5bda96b05dfb5051acd63624f4dd76
MD5 4e6ae79d7701a31c17db5ca619f1bee3
BLAKE2b-256 aa5ed4c66894c8987a57436ddc73ebcbd36109d51ff97efbddbb80e02bd98932

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for visiq-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 91a547f5fab05de3a602713129ce35492b241f502b52b051b9760706298e570b
MD5 af0f14a2a6976685974db20ac6dc3284
BLAKE2b-256 15548d195f76cbe8c83d4f2070cde77cae172b721c792eaad195cbf6c78d7988

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for visiq-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 c4229841b4d0553751fa898102a1ead8fc59211281e02b7a1537e73bbf964f3e
MD5 f42d8f6f4f5c03c1c5069f7d9e483926
BLAKE2b-256 1c1d92a526785dabc93e6f29a4409d0a32c054dc5f354e64d1e8e2c4d2479c58

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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.3.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl.

File metadata

File hashes

Hashes for visiq-0.3.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm Hash digest
SHA256 6c4866090a84d72e1dfd271481edf0cfe55b44ba0fb6858ba2622ecb225d31c3
MD5 e12920de0a0fbe313dbb9d09d6f17dea
BLAKE2b-256 ab8d187dd1e1cd97b6725aa66120d7016658911f33851a56dec0dc4429f8971f

See more details on using hashes here.

Provenance

The following attestation bundles were made for visiq-0.3.0-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

This release

0.3.0 This release

6 files

0.2.4

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