Class: Assistant::PlanToolBuilder

Inherits:
Object
  • Object
show all
Defined in:
app/services/assistant/plan_tool_builder.rb

Overview

Builds RubyLLM::Tool subclasses for plan orchestration.
Provides declare_plan and mark_step_complete tools.

Usage (via ChatToolBuilder):
tools = Assistant::PlanToolBuilder.tools(conversation_id: conv.id)

Constant Summary collapse

AUTOFORK_FIRST_TURN_PLAN_BLOCK_LENGTH =

When a conversation is auto-forked (because the parent ran out of context
or hit the tool budget), the new conversation inherits a parent summary
via Assistant::PromptComposer#parent_context_prompt. The model can then
mistake a short clarification ("yes, all 3" / "Lyn's email is just a
quick overview") for a planning request and synthesize a 5-step plan
from the parent summary alone.

Regression: conversation 1525 — a 65-char user message triggered a
5-step "Finalize the three-part email series" plan that then ran for
45 minutes. Source: parent_conversation_summary from conversation 1233.

Threshold tuned to allow intentional planning prompts ("please write all
3 webinar emails using the brand voice rules…") through while catching
short clarifications. ~200 chars ≈ 30-40 words, well below any genuine
multi-step task description.

200

Class Method Summary collapse

Class Method Details

.tools(conversation_id:) ⇒ Object 



29
30
31
32
33
34
 
# File 'app/services/assistant/plan_tool_builder.rb', line 29

def tools(conversation_id:)
  [
    build_declare_plan_tool(conversation_id: conversation_id),
    build_mark_step_complete_tool(conversation_id: conversation_id)
  ]
end