Instruction file imported from zhattention/agent-studio (.cursor/rules/development-guide.mdc). Copyright stays with the author.

Development Guide

Setup and Running

Set up environment variables according to env.example
Run npm install to install dependencies
Run npm run dev to start the development server
Run npm run build followed by npm start for production

API Development

When working with the API routes:

Use verifyAuth for authentication checks
All API routes should be created using Next.js route handlers
API routes should follow the pattern: app/api/{feature}/{endpoint}/route.ts

Stream Responses

For streaming responses like in app/api/team/call/route.ts:

Use ReadableStream for creating streaming responses
Set proper headers: 'Content-Type': 'application/json', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive'
Handle timeouts and errors appropriately

Environment Configuration

Required environment variables are checked on startup
JWT authentication requires proper secret configuration

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install development-guide and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

development-guide

About