ea742c9386
Implements the complete scenarios feature for TPMJS: API endpoints: - GET/POST /api/scenarios - list/create scenarios - GET/PATCH/DELETE /api/scenarios/:id - scenario CRUD - POST /api/scenarios/:id/run - execute scenario - GET /api/scenarios/:id/runs - run history - POST /api/scenarios/check-similarity - vector similarity check - GET /api/scenarios/featured - featured scenarios - POST /api/collections/:id/scenarios/generate - AI scenario generation - GET /api/collections/:id/scenarios - list collection scenarios Services: - generate-prompt.ts - AI prompt generation using GPT-4o-mini - similarity.ts - vector embedding and cosine similarity - evaluate.ts - LLM-based success evaluation - execute.ts - scenario execution orchestration CLI commands: - tpm scenario list [collection] - list scenarios - tpm scenario run <collection> - run all scenarios - tpm scenario test <id> - run single scenario - tpm scenario generate <collection> - generate scenarios - tpm scenario info <id> - scenario details Database: - Scenario, ScenarioEmbedding, ScenarioRun, ScenarioQuota models - Streak-based quality scoring - Daily quota management Migration script included for converting existing useCases. |
||
|---|---|---|
| .. | ||
| bin | ||
| src | ||
| oclif.manifest.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| tsup.config.ts | ||
@tpmjs/cli
Command-line interface for TPMJS - the universal tool registry for AI agents.
Installation
npm install -g @tpmjs/cli
Quick Start
# Search for tools
tpm tool search firecrawl
# Get tool info
tpm tool info @tpmjs/official-firecrawl scrapeTool
# Show trending tools
tpm tool trending
# Authenticate
tpm auth login --api-key YOUR_API_KEY
# List your agents
tpm agent list
# List your collections
tpm collection list
# Generate MCP config
tpm mcp config ajax/ajax-collection
Commands
Authentication
tpm auth login # Login with API key or browser OAuth
tpm auth logout # Log out
tpm auth status # Show authentication status
tpm auth whoami # Show current user info
Tools
tpm tool search [query] # Search for tools
tpm tool info <pkg> <tool> # Get tool details
tpm tool trending # Show trending tools
tpm tool validate # Validate local tpmjs config
Agents
tpm agent list # List your agents
tpm agent create # Create a new agent
tpm agent update <id> # Update an agent
tpm agent delete <id> # Delete an agent
tpm agent chat <id> # Chat with an agent
Collections
tpm collection list # List your collections
tpm collection create # Create a collection
tpm collection add # Add tools to a collection
tpm collection remove # Remove tools from a collection
MCP Integration
tpm mcp config <user/collection> # Generate MCP config
tpm mcp serve # Run as local MCP server
Utilities
tpm doctor # Run diagnostic checks
tpm update # Update CLI to latest version
Configuration
Config is stored in ~/.tpmjs/config.json:
{
"apiUrl": "https://tpmjs.com/api",
"defaultOutput": "human",
"verbose": false,
"analytics": false
}
Credentials are stored securely in ~/.tpmjs/credentials.json.
Environment Variables
TPMJS_API_KEY- API key for authenticationTPMJS_API_URL- Custom API URL (default: https://tpmjs.com/api)
Output Formats
All commands support --json flag for machine-readable output:
tpm tool search firecrawl --json | jq '.data[0].name'
Verbose Mode
Use --verbose or -v for detailed output:
tpm doctor --verbose
License
MIT