Raw schema
{
"type": "object",
"properties": {
"project": {
"type": "string",
"maxLength": 4000,
"description": "What is being built. Volumes written here ('1,200,000 preview images/mo', '20k MAU') are used and echoed as assumptions. Say 'personal' or 'hobby' if it is non-commercial; otherwise plans that forbid commercial use (e.g. Vercel Hobby) are blocked."
},
"needs": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"job"
],
"properties": {
"job": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "A job id from list_stack_jobs (llm_inference, image_generation_api, video_delivery, object_storage, sandbox_compute, browser_automation, job_queue, auth_b2b, email_inbound, identity_verification, marketplace_payouts, database, auth, hosting, email_transactional, …) or plain words ('send email', 'video hosting (HLS)', 'KYC'). Unknown or ambiguous jobs come back in unsupported_jobs, never as an error"
},
"features": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": "Must-haves, e.g. ['Custom domain', 'CAPTCHA solving', 'platform holds funds', 'refunds enabled', 'unbounded sessions', '2 vCPU / 4 GiB', 'gpt-6-sol']. Sizes and counts ('30 GB database') are checked as volumes; a model or plan name pins that model; SSO, SOC 2, audit logs and region needs are listed as unverified requirements"
},
"volume": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"unit"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000000
},
"unit": {
"type": "string",
"enum": [
"seats",
"members",
"mau",
"emails_per_month",
"emails_per_day",
"contacts",
"domains",
"events_per_month",
"pageviews_per_month",
"errors_per_month",
"requests_per_month",
"requests_per_day",
"searches_per_month",
"cpu_ms_per_request",
"db_gb",
"storage_gb",
"bandwidth_gb",
"projects",
"sites",
"videos",
"video_minutes",
"responses_per_month",
"tasks_per_month",
"keywords_tracked",
"credits_per_month",
"history_days",
"apps",
"files",
"event_types",
"monitors",
"tokens_per_month",
"images_per_month",
"audio_minutes_per_month",
"characters_per_month",
"transactions_per_month",
"sandbox_hours_per_month",
"concurrent_sessions",
"session_minutes",
"call_participants",
"meeting_minutes",
"records",
"inboxes",
"tokens_in_per_month",
"tokens_out_per_month",
"cached_tokens_per_month",
"video_minutes_stored",
"video_minutes_delivered_per_month",
"gmv_usd_per_month",
"payouts_per_month",
"active_accounts",
"verifications_per_month",
"browser_hours_per_month",
"proxy_gb_per_month",
"job_executions_per_month",
"sso_connections",
"sso_users",
"inbound_emails_per_month",
"stream_hours_per_month",
"vcpu_hours_per_month",
"credits_usd_per_month",
"disputes_per_month",
"payout_volume_usd_per_month",
"object_writes_per_month",
"object_reads_per_month",
"job_executions_per_day",
"scim_connections",
"searches_per_hour",
"sms_per_month",
"vectors_stored",
"vector_queries_per_month",
"cache_commands_per_month",
"mtu",
"gpu_seconds_per_month",
"revenue_usd_per_month",
"phone_minutes_per_month",
"vector_read_units_per_month",
"vector_write_units_per_month",
"identified_events_per_month",
"boards",
"hosts",
"tickets_per_month",
"MAU",
"tokens",
"tokens_in",
"tokens_out",
"cached_tokens",
"images",
"video_minutes_delivered",
"gb_stored",
"gb_egress",
"transactions",
"gmv_usd",
"sandbox_seconds",
"sandbox_hours",
"vm_hours",
"vcpu_hours",
"browser_hours",
"proxy_gb",
"job_executions",
"verifications",
"inbound_emails",
"emails",
"events",
"errors",
"exceptions",
"requests",
"pageviews",
"searches",
"payouts",
"credits_usd",
"stream_hours",
"audio_minutes",
"characters",
"payout_volume_usd",
"disputes",
"object_writes",
"object_reads",
"sms",
"vectors",
"vector_queries",
"cache_commands",
"gpu_seconds",
"gpu_hours",
"revenue_usd",
"phone_minutes"
],
"description": "A units.json unit, or an alias: tokens_in, tokens_out, images, gb_stored, gb_egress, transactions, gmv_usd, sandbox_seconds, sandbox_hours, vcpu_hours, browser_hours, job_executions, verifications, inbound_emails, video_minutes_delivered, sso_connections, sso_users, emails, events, requests, credits_usd, MAU (= mau). *_per_month units are monthly, *_per_day daily, *_gb and video_minutes_stored are totals.",
"maxLength": 2000
}
}
},
"volumes": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"unit"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000000
},
"unit": {
"type": "string",
"enum": [
"seats",
"members",
"mau",
"emails_per_month",
"emails_per_day",
"contacts",
"domains",
"events_per_month",
"pageviews_per_month",
"errors_per_month",
"requests_per_month",
"requests_per_day",
"searches_per_month",
"cpu_ms_per_request",
"db_gb",
"storage_gb",
"bandwidth_gb",
"projects",
"sites",
"videos",
"video_minutes",
"responses_per_month",
"tasks_per_month",
"keywords_tracked",
"credits_per_month",
"history_days",
"apps",
"files",
"event_types",
"monitors",
"tokens_per_month",
"images_per_month",
"audio_minutes_per_month",
"characters_per_month",
"transactions_per_month",
"sandbox_hours_per_month",
"concurrent_sessions",
"session_minutes",
"call_participants",
"meeting_minutes",
"records",
"inboxes",
"tokens_in_per_month",
"tokens_out_per_month",
"cached_tokens_per_month",
"video_minutes_stored",
"video_minutes_delivered_per_month",
"gmv_usd_per_month",
"payouts_per_month",
"active_accounts",
"verifications_per_month",
"browser_hours_per_month",
"proxy_gb_per_month",
"job_executions_per_month",
"sso_connections",
"sso_users",
"inbound_emails_per_month",
"stream_hours_per_month",
"vcpu_hours_per_month",
"credits_usd_per_month",
"disputes_per_month",
"payout_volume_usd_per_month",
"object_writes_per_month",
"object_reads_per_month",
"job_executions_per_day",
"scim_connections",
"searches_per_hour",
"sms_per_month",
"vectors_stored",
"vector_queries_per_month",
"cache_commands_per_month",
"mtu",
"gpu_seconds_per_month",
"revenue_usd_per_month",
"phone_minutes_per_month",
"vector_read_units_per_month",
"vector_write_units_per_month",
"identified_events_per_month",
"boards",
"hosts",
"tickets_per_month",
"MAU",
"tokens",
"tokens_in",
"tokens_out",
"cached_tokens",
"images",
"video_minutes_delivered",
"gb_stored",
"gb_egress",
"transactions",
"gmv_usd",
"sandbox_seconds",
"sandbox_hours",
"vm_hours",
"vcpu_hours",
"browser_hours",
"proxy_gb",
"job_executions",
"verifications",
"inbound_emails",
"emails",
"events",
"errors",
"exceptions",
"requests",
"pageviews",
"searches",
"payouts",
"credits_usd",
"stream_hours",
"audio_minutes",
"characters",
"payout_volume_usd",
"disputes",
"object_writes",
"object_reads",
"sms",
"vectors",
"vector_queries",
"cache_commands",
"gpu_seconds",
"gpu_hours",
"revenue_usd",
"phone_minutes"
],
"description": "A units.json unit, or an alias: tokens_in, tokens_out, images, gb_stored, gb_egress, transactions, gmv_usd, sandbox_seconds, sandbox_hours, vcpu_hours, browser_hours, job_executions, verifications, inbound_emails, video_minutes_delivered, sso_connections, sso_users, emails, events, requests, credits_usd, MAU (= mau). *_per_month units are monthly, *_per_day daily, *_gb and video_minutes_stored are totals.",
"maxLength": 2000
}
}
},
"description": "Several dimensions at once, e.g. [{amount: 15000000, unit: 'tokens_in'}, {amount: 7500000, unit: 'tokens_out'}]"
},
"per_user": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"unit"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000000
},
"unit": {
"type": "string",
"enum": [
"seats",
"members",
"mau",
"emails_per_month",
"emails_per_day",
"contacts",
"domains",
"events_per_month",
"pageviews_per_month",
"errors_per_month",
"requests_per_month",
"requests_per_day",
"searches_per_month",
"cpu_ms_per_request",
"db_gb",
"storage_gb",
"bandwidth_gb",
"projects",
"sites",
"videos",
"video_minutes",
"responses_per_month",
"tasks_per_month",
"keywords_tracked",
"credits_per_month",
"history_days",
"apps",
"files",
"event_types",
"monitors",
"tokens_per_month",
"images_per_month",
"audio_minutes_per_month",
"characters_per_month",
"transactions_per_month",
"sandbox_hours_per_month",
"concurrent_sessions",
"session_minutes",
"call_participants",
"meeting_minutes",
"records",
"inboxes",
"tokens_in_per_month",
"tokens_out_per_month",
"cached_tokens_per_month",
"video_minutes_stored",
"video_minutes_delivered_per_month",
"gmv_usd_per_month",
"payouts_per_month",
"active_accounts",
"verifications_per_month",
"browser_hours_per_month",
"proxy_gb_per_month",
"job_executions_per_month",
"sso_connections",
"sso_users",
"inbound_emails_per_month",
"stream_hours_per_month",
"vcpu_hours_per_month",
"credits_usd_per_month",
"disputes_per_month",
"payout_volume_usd_per_month",
"object_writes_per_month",
"object_reads_per_month",
"job_executions_per_day",
"scim_connections",
"searches_per_hour",
"sms_per_month",
"vectors_stored",
"vector_queries_per_month",
"cache_commands_per_month",
"mtu",
"gpu_seconds_per_month",
"revenue_usd_per_month",
"phone_minutes_per_month",
"vector_read_units_per_month",
"vector_write_units_per_month",
"identified_events_per_month",
"boards",
"hosts",
"tickets_per_month",
"MAU",
"tokens",
"tokens_in",
"tokens_out",
"cached_tokens",
"images",
"video_minutes_delivered",
"gb_stored",
"gb_egress",
"transactions",
"gmv_usd",
"sandbox_seconds",
"sandbox_hours",
"vm_hours",
"vcpu_hours",
"browser_hours",
"proxy_gb",
"job_executions",
"verifications",
"inbound_emails",
"emails",
"events",
"errors",
"exceptions",
"requests",
"pageviews",
"searches",
"payouts",
"credits_usd",
"stream_hours",
"audio_minutes",
"characters",
"payout_volume_usd",
"disputes",
"object_writes",
"object_reads",
"sms",
"vectors",
"vector_queries",
"cache_commands",
"gpu_seconds",
"gpu_hours",
"revenue_usd",
"phone_minutes"
],
"description": "A units.json unit, or an alias: tokens_in, tokens_out, images, gb_stored, gb_egress, transactions, gmv_usd, sandbox_seconds, sandbox_hours, vcpu_hours, browser_hours, job_executions, verifications, inbound_emails, video_minutes_delivered, sso_connections, sso_users, emails, events, requests, credits_usd, MAU (= mau). *_per_month units are monthly, *_per_day daily, *_gb and video_minutes_stored are totals.",
"maxLength": 2000
}
}
},
"description": "Volumes per monthly active user per month, e.g. [{amount: 6, unit: 'images'}]; multiplied by MAU (from scales, a mau volume or the project text)"
},
"avg_amount_usd": {
"type": "number",
"minimum": 0,
"maximum": 10000000,
"description": "Average payment in USD; with transactions it prices payment fees"
},
"peak_volume": {
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"unit"
],
"description": "Peak or burst requirement (1.6.0), e.g. {amount: 1500, unit: 'emails_per_day'} for a launch day. Checked against a tier's published daily cap where the index has one; otherwise it stays an open check (the index doesn't prove burst or rate limits), so no option is a plain fit",
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"unit": {
"type": "string",
"enum": [
"emails_per_day",
"requests_per_day",
"requests_per_second"
],
"maxLength": 2000
}
}
},
"sandbox_size": {
"type": "object",
"additionalProperties": false,
"description": "Sandbox size for sandbox_compute",
"properties": {
"vcpu": {
"type": "number",
"minimum": 0.1,
"maximum": 512
},
"ram_gib": {
"type": "number",
"minimum": 0.1,
"maximum": 4096
}
}
}
}
}
},
"prefer": {
"type": "string",
"enum": [
"cheapest",
"managed",
"open_source"
],
"default": "cheapest",
"description": "managed leaves out self-hosted options",
"maxLength": 2000
},
"budget_monthly_usd": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"limit_per_job": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 4
},
"scales": {
"type": "array",
"minItems": 1,
"maxItems": 6,
"items": {
"type": "number",
"minimum": 0.001,
"maximum": 1000000000
},
"description": "Price the stack at several scales, e.g. [1000, 20000, 200000] MAU (scale_by mau) or [1, 10, 100] (scale_by multiplier): per-job cost curve, tier changes and break-even points between options"
},
"scale_by": {
"type": "string",
"enum": [
"mau",
"multiplier"
],
"default": "mau",
"description": "mau: scales are monthly active users (per_user volumes × MAU; other monthly volumes and sizes grow in proportion to the MAU they were given at); multiplier: every monthly volume and size is multiplied",
"maxLength": 2000
},
"unit_economics": {
"type": "object",
"additionalProperties": false,
"description": "Revenue model for gross margin per scale: price_usd with conversion_rate, or revenue_per_mau",
"properties": {
"price_usd": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "What a paying user pays"
},
"billing": {
"type": "string",
"enum": [
"monthly",
"one_time"
],
"default": "monthly",
"description": "one_time: price_usd per purchase, conversion_rate = purchases per MAU per month",
"maxLength": 2000
},
"conversion_rate": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Share of MAU who pay, e.g. 0.03"
},
"revenue_per_mau": {
"type": "number",
"minimum": 0,
"maximum": 10000,
"description": "Average monthly revenue per MAU (instead of price_usd × conversion_rate)"
},
"variable_cost_alert_pct": {
"type": "number",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Flag jobs whose monthly cost is above this % of revenue"
}
}
}
},
"required": [
"needs"
],
"additionalProperties": false
}