Agentra LabsAgentra Labs DocsPublic Documentation

AgenticPlanning

Command Surface

Cross-reference matrix showing which operations are available via MCP tools, CLI commands, FFI functions, and Rust API.

Cross-reference matrix showing which operations are available via MCP tools, CLI commands, FFI functions, and Rust API.

Compact Facade Tools

AgenticPlanning uses operation-based routing for compact MCP tools. Each compact facade takes an operation plus optional params.

  • planning_goal
  • planning_decision
  • planning_commitment
  • planning_progress
  • planning_singularity
  • planning_dream
  • planning_counterfactual
  • planning_chain
  • planning_consensus
  • planning_federate
  • planning_metamorphosis
  • planning_workspace
  • planning_context_log

Compact list mode: use MCP_TOOL_SURFACE=compact.

Goal Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Create goalplanning_goal op=creategoal createaplan_goal_createengine.create_goal()
List goalsplanning_goal op=listgoal listaplan_goal_listengine.list_goals()
Show goalplanning_goal op=showgoal showaplan_goal_getengine.get_goal()
Activate goalplanning_goal op=activategoal activate—engine.activate_goal()
Update progressplanning_goal op=progressgoal progress—engine.update_progress()
Complete goalplanning_goal op=completegoal completeaplan_goal_completeengine.complete_goal()
Abandon goalplanning_goal op=abandongoal abandonaplan_goal_abandonengine.abandon_goal()
Pause goalplanning_goal op=pausegoal pauseaplan_goal_pauseengine.pause_goal()
Resume goalplanning_goal op=resumegoal resumeaplan_goal_resumeengine.resume_goal()
Block goalplanning_goal op=blockgoal block—engine.block_goal()
Unblock goalplanning_goal op=unblockgoal unblock—engine.unblock_goal()
Decomposeplanning_goal op=decomposegoal decompose—engine.decompose_goal()
Link goalsplanning_goal op=linkgoal link—engine.link_goals()
Goal treeplanning_goal op=treegoal tree—engine.goal_tree()
Goal feelingsplanning_goal op=feelingsgoal feelings—engine.goal_feelings()
Goal physicsplanning_goal op=physicsgoal physics—engine.goal_physics()
Goal dreamplanning_goal op=dreamgoal dreamaplan_dream_createengine.dream_goal()
Reincarnateplanning_goal op=reincarnategoal reincarnate—engine.reincarnate_goal()

Decision Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Createplanning_decision op=createdecision createaplan_decision_createengine.create_decision()
Add optionplanning_decision op=optiondecision option—engine.add_option()
Crystallizeplanning_decision op=crystallizedecision crystallizeaplan_decision_crystallizeengine.crystallize()
Showplanning_decision op=showdecision showaplan_decision_getengine.get_decision()
Shadowsplanning_decision op=shadowsdecision shadows—engine.decision_shadows()
Chainplanning_decision op=chaindecision chain—engine.decision_chain()
Archaeologyplanning_decision op=archaeologydecision archaeology—engine.decision_archaeology()
Prophecyplanning_decision op=prophecydecision prophecy—engine.decision_prophecy()
Regretplanning_decision op=regretdecision regret—engine.decision_regret()
Recrystallizeplanning_decision op=recrystallizedecision recrystallize—engine.recrystallize()
List——aplan_decision_listengine.list_decisions()

Commitment Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Createplanning_commitment op=createcommitment createaplan_commitment_createengine.create_commitment()
Listplanning_commitment op=listcommitment listaplan_commitment_listengine.list_commitments()
Showplanning_commitment op=showcommitment showaplan_commitment_getengine.get_commitment()
Fulfillplanning_commitment op=fulfillcommitment fulfillaplan_commitment_fulfillengine.fulfill_commitment()
Breakplanning_commitment op=breakcommitment breakaplan_commitment_breakengine.break_commitment()
Renegotiateplanning_commitment op=renegotiatecommitment renegotiate—engine.renegotiate()
Entangleplanning_commitment op=entanglecommitment entangle—engine.entangle()
Inventoryplanning_commitment op=inventorycommitment inventory—engine.commitment_inventory()
Due soonplanning_commitment op=due_sooncommitment due-soon—engine.commitments_due_soon()
At riskplanning_commitment op=at_riskcommitment at-risk—engine.commitments_at_risk()

Progress & Query Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Momentumplanning_progress op=momentumprogress momentum—engine.momentum()
Gravityplanning_progress op=gravityprogress gravity—engine.gravity()
Blockersplanning_progress op=blockersprogress blockersaplan_blockers_scanengine.predict_blockers()
Echoesplanning_progress op=echoesprogress echoesaplan_echoes_listenengine.listen_echoes()
Forecastplanning_progress op=forecastprogress forecast—engine.forecast()
Velocityplanning_progress op=velocityprogress velocity—engine.velocity()
Trendplanning_progress op=trendprogress trend—engine.trend()

Singularity Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Collapseplanning_singularity op=collapsesingularity collapseaplan_singularity_getengine.collapse_singularity()
Positionplanning_singularity op=positionsingularity position—engine.position_goal()
Pathplanning_singularity op=pathsingularity path—engine.golden_path()
Tensionsplanning_singularity op=tensionssingularity tensions—engine.tensions()
Themesplanning_singularity op=themessingularity themes—engine.themes()
Centerplanning_singularity op=centersingularity center—engine.intention_center()
Visionplanning_singularity op=visionsingularity vision—engine.unified_vision()

Advanced Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Dream goalplanning_dreamdream goalaplan_dream_createengine.dream_goal()
Dream list—dream historyaplan_dream_listengine.list_dreams()
Dream get——aplan_dream_getengine.get_dream()
Counterfactualplanning_counterfactualcounterfactual *—engine.counterfactual_*()
Chain analysisplanning_chainchain *—engine.chain_*()
Consensusplanning_consensusconsensus *—engine.consensus_*()
Federateplanning_federatefederation *—engine.federation_*()
Metamorphosisplanning_metamorphosismetamorphosis *—engine.metamorphosis_*()
Workspaceplanning_workspaceworkspace *—engine.workspace_*()
Context logplanning_context_logcontext-log——

Utility Operations

OperationMCP ToolCLI CommandFFI FunctionRust API
Statusresource planning://statusstatus——
Version—versionaplan_version—
Last error——aplan_last_error—
Save state——aplan_engine_saveengine.save()
Load state——aplan_engine_loadengine.load()
Free string——aplan_string_free—
Free engine——aplan_engine_free(drop)
Serve (MCP)—serve——
Daemon—daemon *——