Vectra.Client.Net 1.0.0

Vectra SDK for .NET

Official .NET client library for Vectra — the Intent-Aware Governance Gateway for Autonomous AI Agents.

Vectra sits between your AI agents and the outside world, enforcing governance policies, intercepting high-risk actions, and routing requests through Human-in-the-Loop (HITL) review when needed.

Installation

dotnet add package Vectra.Client.Net

Quick Start

// Register with the DI container (ASP.NET Core / Generic Host)
builder.Services.AddVectraClient(options =>
{
	options.BaseUrl     = "http://localhost:7080";
	options.BearerToken = "your-jwt-token"; // optional — see Token Authentication
});

// Inject and use
public class MyService(IVectraClient vectra)
{
	public async Task RunAsync(CancellationToken ct)
	{
		var agents   = await vectra.Agents.ListAsync(page: 1, pageSize: 10, ct);
		var policies = await vectra.Policies.ListAsync(cancellationToken: ct);
		var pending  = await vectra.Hitl.GetAllPendingAsync(cancellationToken: ct);
	}
}

Features

• Agent Management — Register, list, assign policies to, and delete AI agents
• JWT Authentication — Exchange agent credentials for a scoped Bearer token with a single call
• Policy Inspection — List and inspect the governance policies configured in your gateway
• HITL Review Workflows — Retrieve pending review requests and approve or deny them programmatically
• First-class DI support — AddVectraClient(...) wires up all typed HTTP clients in one line
• Automatic Bearer token injection — Set BearerToken once; every outgoing request carries the header
• Structured exceptions — VectraApiException and VectraAuthenticationException expose the HTTP status code and the server error payload
• Full cancellation support — Every async method accepts a CancellationToken
• Pagination — All list operations accept page and pageSize parameters

Configuration

API Reference

IVectraClient
├── .Agents    → IVectraAgentClient
├── .Policies  → IVectraPolicyClient
├── .Hitl      → IVectraHitlClient
└── .Tokens    → IVectraTokenClient

Agent Management

var agents = await vectra.Agents.ListAsync(page: 1, pageSize: 25, ct);

var result = await vectra.Agents.RegisterAsync(new RegisterAgentRequest
{
	Name         = "my-research-agent",
	OwnerId      = "team-backend",
	ClientSecret = "super-secret-value"
}, ct);

await vectra.Agents.AssignPolicyAsync(result.AgentId, new AssignPolicyRequest
{
	PolicyName = "strict-outbound"
}, ct);

await vectra.Agents.DeleteAsync(result.AgentId, ct);

Token Authentication

GenerateTokenResult token = await vectra.Tokens.GenerateAsync(new GenerateTokenRequest
{
	AgentId      = agentId,
	ClientSecret = "super-secret-value"
}, ct);

Policy Inspection

var policies = await vectra.Policies.ListAsync(page: 1, pageSize: 25, ct);
var details  = await vectra.Policies.GetAsync("strict-outbound", ct);

HITL Workflows

var queue = await vectra.Hitl.GetAllPendingAsync(page: 1, pageSize: 25, ct);

// Approve
await vectra.Hitl.ApproveAsync(queue[0].Id, new ReviewDecisionRequest
{
	Comment = "Verified safe by on-call engineer."
}, ct);

// Deny
await vectra.Hitl.DenyAsync(queue[0].Id, new ReviewDecisionRequest
{
	Comment = "Blocked: unexpected data-exfiltration attempt."
}, ct);

Error Handling

try
{
	var policy = await vectra.Policies.GetAsync("unknown-policy", ct);
}
catch (VectraAuthenticationException ex)
{
	// 401 or 403
}
catch (VectraApiException ex) when (ex.StatusCode == 404)
{
	// Not found
}
catch (VectraApiException ex)
{
	// All other non-2xx responses
}

Links

• Full Documentation & Examples
• NuGet Package
• Product Page
• Report an Issue
• Changelog

© Cortexium Labs. All rights reserved.