Documentation Index
Fetch the complete documentation index at: https://docs.scriptonia.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
POST /api/platform
Content-Type: application/json
| Field | Type | Required | Description |
|---|
sessionId | string | Yes | From /api/intent response. |
refinedRequirements | object | No | Fallback if context has no refinedRequirements. |
supabaseIntegration | boolean | yes | When true, Supabase is included in the blueprint where applicable. |
Example
{
"sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"supabaseIntegration": true
}
Success (200)
| Field | Type | Description |
|---|
status | "success" | |
stage | "platform_selection" | |
platform_options | array | Each: platform, description, cost_script, timeline_seconds, agents_required[], fit_score (and optional tech_stack). |
recommended | string | One of: Website, Web Application, Android, iOS. |
next_stage | "payment_processing" | |
Example
{
"status": "success",
"stage": "platform_selection",
"platform_options": [
{
"platform": "Web Application",
"description": "Fits SaaS with auth and real-time; full backend and DB.",
"cost_script": 10000,
"timeline_seconds": 75,
"agents_required": ["ProductManager", "FrontendDev", "BackendDev", "DevOpsEngineer", "ToolManager"],
"fit_score": 95
}
],
"recommended": "Web Application",
"next_stage": "payment_processing"
}
cost_script is always UNIFIED_PRICE_SCRIPT (e.g. 10000); the handler overwrites values from selectPlatform.
Error (4xx / 5xx)
| Field | Description |
|---|
status | "error" |
stage | "platform_selection" |
error | Message. |
Error Codes
| HTTP | Cause |
|---|
| 400 | sessionId missing; workflow not found and no refinedRequirements to rebuild; refinedRequirements still missing after recovery. |
| 405 | Method not POST. |
| 500 | selectPlatform (OpenRouter) failure; DB or schema issues (e.g. supabaseIntegration when migration not run). |
Implementation Notes
- Loads context via
getWorkflowContextDB then getWorkflowContext. If refinedRequirements is missing, uses refinedRequirements from the body when provided.
- Calls
selectPlatform(refinedRequirements, sessionId) from lib/openai.ts (PlatformSelector). Normalizes each option’s cost_script to UNIFIED_PRICE_SCRIPT.
- Persists:
platformOptions (normalized), supabaseIntegration, currentStage: 'platform_selection'. platformOptions may not be stored in DB; in-memory is used as fallback.
