Plan Objective
chaoscore_planProduce an ordered, executable plan using only available capabilities. Returns a plan ID for chaoscore_execute to run; planning does not execute or authorize actions.
Instructions
Produce an ordered, executable plan for an objective, using ONLY capabilities currently in the capability registry (capability discovery). Uses the active AI provider to select capabilities and construct step inputs. This is the Planner stage of the Cognitive Core loop.
The returned plan.id must be passed to chaoscore_execute to run it, and is scoped to your MCP session. Planning does NOT execute anything and is NOT authorization to act — policy checks happen at execution time, per step.
Args:
objective (string): The goal to produce a plan for
context (array): Background info as [{source, content}, ...]. Include prior chaoscore_reason output here if you called it first.
reasoning_effort (optional): Override the active provider's default reasoning effort
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format: { "id": string, // pass this to chaoscore_execute "objective": string, "steps": [ { "id": string, "description": string, "capability": string, "input": object, "rationale": string } ], "createdAt": string, "model": string, "providerId": string }
Examples:
Use when: "Draft a summary of these release notes" -> plan with a step using capability "cognition.generate_text"
Don't use when: You want to actually run the plan -> follow up with chaoscore_execute(plan_id=...)
Error Handling:
Returns "Error: OPENAI_API_KEY is not set" (or the active provider's equivalent) if the provider isn't configured
If the model references an unregistered capability name, chaoscore_execute reports that step as failed with an "Unknown capability" error — call chaoscore_inspect(target="capabilities") to see what's available
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | Relevant background information to ground the reasoning/plan. Empty array if none. | |
| objective | Yes | The goal to produce an executable plan for | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |
| reasoning_effort | No | Override the active provider's default reasoning effort for this call |