Framework Integrations
Integration providers wrap the vault for specific frameworks, offering convenience methods for credential retrieval and SDK configuration.Base Provider
WisperaCredentialProvider
All integrations extend this base class.
| Method | Description |
|---|---|
get(name, platform?) | Retrieve a credential by passport name |
getValue(name, platform?) | Get just the credential string |
getByPlatform(platform) | Get first credential for a platform |
getOpenAIKey() | Shortcut for OpenAI API key |
getAnthropicKey() | Shortcut for Anthropic API key |
getAzureKey() | Shortcut for Azure OpenAI key |
getLLMConfig(provider?) | Auto-detect LLM provider and return config |
listAvailable() | List all active credentials (no values) |
OpenAI Agents — WisperaOpenAIAgentProvider
| Method | Description |
|---|---|
getAgentKey() | API key for agent initialization |
getAgentConfig(model?) | Model + API key config object |
getToolAuth(name) | Credential formatted as tool authentication header |
getHandoffCredential(name, scopes) | Scoped credential for multi-agent handoff (validates scope) |
getToolCredentials(names) | Batch retrieval for multiple tools |
LangChain — WisperaLangChainProvider
| Method | Description |
|---|---|
getLangChainConfig() | LLM config for LangChain.js |
getGoogleKey() | Google API key for @langchain/google-genai |
getAWSCredentials() | AWS credentials for Bedrock |
Slack — WisperaSlackProvider
| Method | Description |
|---|---|
getBotToken() | xoxb- bot token |
getAppToken() | xapp- app token |
getUserToken() | xoxp- user token |
getWebhookUrl() | Slack webhook URL |
getSlackCredential(name) | Typed credential with auto-detected token type |
listSlackCredentials() | Filter to Slack-only credentials |
getSocketModeTokens() | Bot + app tokens for Socket Mode |
Google A2A — WisperaA2AProvider
| Method | Description |
|---|---|
getAgentCredentials() | Credentials for Agent Card |
validateAgentAuth(token) | Validate incoming agent tokens |
getTaskCredentials(taskId, scopes) | Scoped credentials for A2A tasks |
getGoogleCloudKey() | Google Cloud API key |
Environment Variable Mapping
ThePLATFORM_ENV_MAP constant maps platform + credential type to canonical environment variable names used by idw exec:
| Platform | Credential Type | Env Var |
|---|---|---|
| openai | api-key | OPENAI_API_KEY |
| anthropic | api-key | ANTHROPIC_API_KEY |
| aws | api-key | AWS_ACCESS_KEY_ID |
| aws | secret | AWS_SECRET_ACCESS_KEY |
| github | api-key | GITHUB_TOKEN |
| slack | bot-token | SLACK_BOT_TOKEN |
| langchain | api-key | LANGCHAIN_API_KEY |
| google-a2a | api-key | GOOGLE_API_KEY |
| azure-ai | api-key | AZURE_OPENAI_API_KEY |
| mcp | api-key | MCP_API_KEY |
| openclaw | api-key | OPENCLAW_API_KEY |