Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.visiqlabs.com/llms.txt

Use this file to discover all available pages before exploring further.

AI agents call tools and retrieve context with no runtime governance. VisIQ fixes that in two lines of code. 
import { visiq } from "@visiq/sdk";

const executor = visiq(new AgentExecutor({ agent, tools }), { agentId: "my-bot" });
That’s the entire integration. Your executor.invoke() calls work unchanged — but every tool call and every retrieved document is now governed.

​
What activates

Action Governance

Controls what agents can do. Every tool call is evaluated against your rules before it executes — permit, deny, or route to a human for approval.

Context Governance

Controls what agents can see. Every retrieved document is filtered against your policy before it reaches the agent’s context window.

Audit Trail

Proves what agents did. Every decision is cryptographically signed and hash-chained into an immutable ledger.
All three activate from the single visiq() call. There is no additional code, configuration, or per-tool wrapping.

​
How it works

1

visiq() detects your framework

The harness inspects the target object. It recognizes LangChain AgentExecutor and LangGraph CompiledGraph.
2

Action governance installs at handleToolStart

Before any tool function executes, the proposed call (tool name + arguments) is evaluated against a locally cached rule bundle. Sub-millisecond on the hot path — no network round-trip.
3

Context governance instruments retrievers in place

The harness walks the tools array, finds retrievers, and monkey-patches them. Every returned document passes through policy evaluation before the agent sees it.
4

Audit trail captures every decision

Each evaluation emits a signed envelope — Ed25519 signature, SHA-256 payload hash, agent ID, decision, and timestamp. Envelopes are hash-chained for tamper evidence.

​
Install

npm install @visiq/sdk
.env
VISIQ_API_KEY=vk_live_...
VISIQ_AGENT_ID=my-bot
The harness reads VISIQ_API_KEY, VISIQ_ENDPOINT, and VISIQ_AGENT_ID from environment variables automatically. Options passed to visiq() take precedence.

​
Next steps

Quickstart

Full working example with tools and a retriever — 5 minutes.

SDK Reference

Complete visiq() API — options, framework detection, error behavior.