Skip to main content

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.
MethodDescription
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

MethodDescription
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

MethodDescription
getLangChainConfig()LLM config for LangChain.js
getGoogleKey()Google API key for @langchain/google-genai
getAWSCredentials()AWS credentials for Bedrock

Slack — WisperaSlackProvider

MethodDescription
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

MethodDescription
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

The PLATFORM_ENV_MAP constant maps platform + credential type to canonical environment variable names used by idw exec:
PlatformCredential TypeEnv Var
openaiapi-keyOPENAI_API_KEY
anthropicapi-keyANTHROPIC_API_KEY
awsapi-keyAWS_ACCESS_KEY_ID
awssecretAWS_SECRET_ACCESS_KEY
githubapi-keyGITHUB_TOKEN
slackbot-tokenSLACK_BOT_TOKEN
langchainapi-keyLANGCHAIN_API_KEY
google-a2aapi-keyGOOGLE_API_KEY
azure-aiapi-keyAZURE_OPENAI_API_KEY
mcpapi-keyMCP_API_KEY
openclawapi-keyOPENCLAW_API_KEY