Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 03:37 UTC
TypeSafe (Jev) Example
Jev picks a Composio tool from a plain-language request, binds the arguments it can, and tells you how sure it is. This example decides between three Hacker News tools, completes the partial call, and executes it.
Setup
- Install dependencies:
pnpm install
- Configure environment:
cp .env.example .env
Then edit .env and add your API keys:
COMPOSIO_API_KEY: Get it from the Composio DashboardTYPESAFE_API_KEY: Get it from TypeSafe
The example stops with an error that names the missing variable when a key is not set. It needs Node.js 24.17 or newer, the same as @composio/typesafe.
Running the Example
# Decide, complete the partial call, and execute
pnpm start
# Companion flow: shortlist tools for another provider
pnpm start:shortlist
What pnpm start does
composio.tools.get()compiles three Hacker News tools into Jev questions. This step is offline.provider.decide()asks Jev which tool carries out the request and prints the decision.- Jev never writes free text, so the
usernameargument comes back inmissing. The example supplies it as a caller argument. provider.execute()runs the completed call.
The example executes a decision only when its risk is read_only, because your Composio key points at real accounts.
Reading the decision
confidenceis the score of the least certain judgement the call depends on. It is not a calibrated probability that the whole call is correct.- A destructive tool routes at a threshold of 0.9 and needs
confirm: trueinexecute. - State can be
{ request, context }. Routing and the action gate seerequestonly, so text incontextcannot change which tool is picked. Argument questions may seecontext.contextScope: 'all'opts out of that separation. - When you use
confidenceGate, create one gate per agent run and reuse it across that run's retries. Create a fresh gate for each new run.
What pnpm start:shortlist does
shortlistTools ranks every Hacker News tool against the request in one call and keeps the top three. The example then re-fetches those three through OpenAIProvider, which is what you would hand to the LLM.
Related Examples
- Google Example - Shows integration with Google GenAI
- OpenAI Example - Shows integration with OpenAI
- More Examples - Browse all available examples