Integration Guide

npm install @vienna/sdk
# or
pip install vienna-sdk

import { createLangChainAdapter } from '@vienna/sdk';

const vienna = createLangChainAdapter({
  apiUrl: 'https://api.regulator.ai',
  apiKey: 'vos_your_api_key',
  agentId: 'my-langchain-agent'
});

// Register agent on startup
await vienna.register({
  name: 'My LangChain Agent',
  capabilities: ['deploy_code', 'send_email', 'query_database']
});

// Before executing any action, submit intent to Vienna
const result = await vienna.submitIntent({
  action: 'deploy_code',
  params: { service: 'api-gateway', version: '2.3.1' },
  objective: 'Deploy API v2.3.1 to production'
});

if (result.status === 'approved') {
  // Execute with warrant
  await deployService('api-gateway', '2.3.1');
  
  // Report execution result
  await vienna.reportExecution(result.warrant_id, {
    success: true,
    output: 'Deployed api-gateway v2.3.1'
  });
} else if (result.status === 'pending') {
  // T2/T3 — wait for human approval
  const approved = await vienna.waitForApproval(result.intent_id);
  if (approved.status === 'approved') {
    await deployService('api-gateway', '2.3.1');
    await vienna.reportExecution(approved.warrant_id, { success: true });
  }
}

LangChain / LangGraph

Wrap tool calls with Vienna governance

import { createLangChainAdapter } from '@vienna/sdk';

const vienna = createLangChainAdapter({
  apiUrl: 'https://api.regulator.ai',
  apiKey: process.env.VIENNA_API_KEY,
  agentId: 'langchain-agent-01'
});

// Create a governed tool
function governedTool(toolFn, action) {
  return async (...args) => {
    const result = await vienna.submitIntent({
      action,
      params: { args },
      objective: `Execute ${action}`
    });
    
    if (result.status !== 'approved') {
      throw new Error(`Action ${action} requires approval`);
    }
    
    const output = await toolFn(...args);
    await vienna.reportExecution(result.warrant_id, { 
      success: true, output: JSON.stringify(output) 
    });
    return output;
  };
}

CrewAI

Add governance to crew task execution

from vienna import create_crewai_adapter

vienna = create_crewai_adapter(
    api_url="https://api.regulator.ai",
    api_key=os.environ["VIENNA_API_KEY"],
    agent_id="crewai-research-crew"
)

# Before each task execution
result = vienna.submit_intent(
    action="web_search",
    params={"query": "AI governance market analysis"},
    objective="Research AI governance market for quarterly report"
)

if result["status"] == "approved":
    # Proceed with crew task
    crew.kickoff()
    vienna.report_execution(result["warrant_id"], success=True)

OpenClaw

Native integration via OpenClaw bridge

import { createOpenClawAdapter } from '@vienna/sdk';

const vienna = createOpenClawAdapter({
  apiUrl: 'https://api.regulator.ai',
  apiKey: process.env.VIENNA_API_KEY,
  agentId: 'openclaw-main-agent'
});

// OpenClaw sessions automatically route through Vienna
// when VIENNA_API_URL is set in environment

Microsoft AutoGen

Govern multi-agent conversations

from vienna import FrameworkAdapter

vienna = FrameworkAdapter(
    api_url="https://api.regulator.ai",
    api_key=os.environ["VIENNA_API_KEY"],
    agent_id="autogen-group-chat",
    framework="autogen"
)

# Wrap the GroupChatManager's execution step
# Each agent action goes through Vienna governance
result = vienna.submit_intent(
    action="code_execution",
    params={"language": "python", "sandbox": True},
    objective="Execute generated code in sandbox"
)

Submit an intent for governance evaluation

Report execution result after warrant-authorized action

Register an agent with Vienna OS

Verify a warrant's validity