ConversationalMode

Core Architecture Interactive Topic Aware

The interactive control loop that orchestrates task execution, manages reasoning state, and defines the agent's problem-solving persona for exploratory debugging and "Chat with Code" workflows.

⚙️ OrchestrationConfig.json

User Prompt (Expansion)

"Check logs for errors in @[Production|Staging] environments."

{
  "mode": "ConversationalMode",
  "useExpansionSyntax": true,
  "model_config": {
    "smart": "gpt-4-turbo",
    "fast": "gpt-3.5-turbo"
  }
}

→

🧠 Live Transcript

Production

Staging

[Plan] Choosing ReadLogTask...

Searching Production logs...
Found 0 critical errors.

The Listen-Act-Reply Loop

Unlike autonomous planning modes, ConversationalMode prioritizes immediate feedback and user steering.

Topic Extraction

Automatically identifies named entities (files, classes, servers) in responses and stores them as @Topics.

Parallel Execution

Use alternative syntax to trigger multiple tasks simultaneously, rendered in a tabbed interface.

Context Awareness

Maintains a rolling window of history to ensure task selection is informed by previous interactions.

Expansion Syntax Guide

Syntax	Type	Behavior
`@[A\|B]`	Alternatives	Executes tasks for A and B in parallel.
`@{A -> B}`	Sequence	Executes tasks sequentially (A then B).
`@(1..5)`	Range	Expands to a sequence of numbers (supports `by` step).
`@TopicName`	Topic Ref	Expands to all entities discovered under that topic type.

Recursive Processing

kotlin

private fun processMsgRecursive(
    currentMessage: String, 
    task: SessionTask, 
    parsingChatter: ChatInterface, 
    defaultChatter: ChatInterface
): List<(StringBuilder) -> Unit> {
    // 1. Check for Ranges @(1..10)
    // 2. Check for Sequences @{A -> B}
    // 3. Check for Alternatives @[A|B]
    // 4. Fallback: Execute single task
}

Integration Guide

Configuration

val config = OrchestrationConfig(
    mode = CognitiveMode.ConversationalMode,
    overrides = mapOf(
        "useExpansionSyntax" to true
    )
)

Observability

• Tabbed UI: Parallel expansions are rendered as dynamic tabs.
• Topic Badges: Extracted topics appear as clickable metadata.
• History: Full conversation context is injected into task selection.