Skip to main content

​
Framework Integrations

ID Wispera provides first-class integration providers for popular AI agent frameworks. Each integration wraps the vault with framework-specific credential retrieval, caching, and audit logging.

​
Architecture

Every integration provider extends a shared base credential provider: 
WisperaCredentialProvider (base)
├── WisperaOpenAIAgentProvider    — OpenAI Agents SDK
├── WisperaA2AProvider            — Google A2A Protocol
├── WisperaSlackProvider          — Slack
└── WisperaLangChainProvider      — LangChain (TS) / WisperaCredentialProvider (Python)
The base provider gives every integration:
  • Credential retrieval — get(passportName) and getValue(passportName) to fetch credentials by passport name
  • Platform shortcuts — getOpenAIKey(), getAnthropicKey(), getAzureKey() for common platforms
  • Auto-detect LLM config — getLLMConfig(passportName, model?) reads the passport’s platforms and returns api_key + model + provider
  • Listing — listAvailable(platform?) to enumerate credentials, optionally filtered
  • Caching — Optional in-memory cache (thread-safe via sync.RWMutex in Go)
  • Audit logging — Every access is logged with actor, platform, and purpose

​
SDK Parity Matrix

IntegrationTypeScriptPythonGo
Base ProviderWisperaCredentialProviderWisperaBaseProviderCredentialProvider
OpenAI Agents SDKYesYesYes
Google A2A ProtocolYesYesYes
SlackYesYesYes
LangChainYes (new)Yes (existing)N/A
CrewAIN/AYes (existing)N/A

​
Base Provider

The base provider is the foundation all integrations share. You can also use it directly when you don’t need a framework-specific wrapper. 
import { WisperaCredentialProvider } from '@id-wispera/core';

const provider = new WisperaCredentialProvider({ vaultPath: '~/.id-wispera' });

// Retrieve a credential by passport name
const cred = await provider.get('openai-prod');
const value = await provider.getValue('openai-prod');

// Platform shortcuts
const openaiKey = await provider.getOpenAIKey('openai-prod');
const anthropicKey = await provider.getAnthropicKey('claude-key');
const azureKey = await provider.getAzureKey('azure-ai');

// Auto-detect provider from passport platforms
const config = await provider.getLLMConfig('openai-prod', 'gpt-4');
// → { api_key: 'sk-...', model: 'gpt-4', provider: 'openai' }

// List available credentials
const all = await provider.listAvailable();
const openaiOnly = await provider.listAvailable('openai');

// Clear the credential cache
provider.clearCache();

​
Integration Guides

OpenAI Agents SDK

Agent keys, tool auth headers, and multi-agent handoff credentials.

Google A2A Protocol

Agent cards, token validation, and task-scoped credentials for agent-to-agent communication.

Slack

Bot tokens, app tokens, user tokens, webhooks, and Socket Mode support.

MCP

Connect to AI agents via the Model Context Protocol.

​
Next Steps

SDK usage

Core SDK operations across TypeScript, Python, and Go.

Provisioning

Programmatically create API keys at vendor APIs.

Audit log

Review credential access history from all integrations.