SP1.2: Add Koog dependency and AIAgent/AgentService skeleton for Goal 10 dispatcher runtime

[Copilot]

Establishes the agent framework foundation for Goal 10 LLM-driven traffic control. Adds Koog 0.3.0 dependency and implements a lightweight skeleton (no Spring Boot) that will be extended in SP1.3+ with perception/actuator tool bindings and SP1.6 with LLM decision logic.

Changes

Dependency Management

• Added koogVersion=0.3.0 to gradle.properties
• Updated dispatcher-agent/build.gradle.kts to declare Koog implementation dependency

Agent Framework Core

• DomainTool interface: Domain tool abstraction for Koog tool registration (suspend execute method with args Map)
• AgentService factory interface + KoogDispatchAgent runtime interface: Separates agent creation from runtime behavior
• DefaultAgentService: Factory producing KoogDispatchAgentImpl instances with configurable tools/model/prompt
• KoogDispatchAgentImpl: Skeleton returning empty decision list; ready for SP1.6 LLM integration

DI Wiring

• Updated DispatcherAgentModule to provide AgentService as singleton
• Added comments indicating SP1.3+ extensions for per-context agent binding and tool adapters

Testing & Documentation

• 7 new unit tests (all passing): agent creation, initialization, empty decision skeleton behavior, Koin singleton verification
• docs/SP1_2_AGENT_SKELETON.md: Complete architecture, SP1 phasing roadmap, design rationale

Example Usage (SP1.2 skeleton)

// Inject at module level (singleton)
val agentService: AgentService by inject()

// Create agent with tools and model config (no-op decisions now)
val agent = agentService.createDispatchAgent(
    modelName = "mistral",
    tools = listOf(signalTool, blockTool),  // Tool adapters added in SP1.4
    systemPrompt = "You are a railway dispatcher"
)

// SP1.6 will populate these decisions; currently returns empty list
val decisions = agent.decideAsync(observation)

Notes for Reviewers

• No Spring Boot: Uses lightweight Koin DI only, aligning with project philosophy
• Skeleton-first: Minimal working code now; LLM integration deferred to SP1.6 per design plan
• Interfaces separate factory from runtime for clean testing and extensibility
• All 2194 core tests passing; no regressions

[bedaHovorka]

@copilot

Read *.md documentation and description in supertasks etc. more carefuly