plan
Scope: none (any authenticated key). Read-only planner. Input: free-text user intent (REQUIRED — e.g. 'a hero image for my coffee brand', 'animate my product photo', 'add a cigar to the monkey in this video', 'separate vocals from this song'). Optional flags — PASS THESE when relevant or the planner will mis-route: has_local_files=true if the user attached image / audio reference media; has_video_reference=true if the user attached a VIDEO and wants it modified (video-to-video editing — e.g. "add X to this clip", "restyle this video", "make the subject do Y"). When video_reference is true the planner routes to a video-ref model (Gemini Omni Video HD video-ref) instead of text/image-to-video, which is the correct choice for editing an existing clip. Output: a structured plan with recommended_model, estimated_credits, estimated_seconds, requires_upload, suggested_aspect_ratio, workflow_steps[], and skills_to_fetch[]. Use this as the FIRST call of a session when the user describes a goal but hasn't picked a model. It collapses get_models → get_balance → estimate → human-guidance into a single round-trip and tells you exactly which skills to read before generating. After the plan, fetch each item in skills_to_fetch (via get_skill or resources/read kubeez://skills/<name>), then follow workflow_steps in order. This tool does NOT charge credits and does NOT call any model — it's pure deterministic routing on top of the model catalog + skill index. If the intent is ambiguous, the plan returns clarifying_questions[] instead of a model recommendation; ask the user those, then call plan again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"intent": "<intent>"
},
"name": "plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | ||
| target_aspect | No | ||
| has_local_files | No | ||
| has_video_reference | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||