Agent sessions support implemented

Author: Dariusz Debowczyk

.beads/issues.jsonl

@@ -142,3 +142,7 @@ The boundary between `\Core` and `\Hook` is **whether the behavior is optional**
 - NEVER stop before pushing - that leaves work stranded locally
 - NEVER say "ready to push when you are" - YOU must push
 - If push fails, resolve and retry until it succeeds
+
+## Git Ownership
+
+- Leave all git operations to the human user unless explicitly requested.

AGENTS.md

@@ -102,13 +102,23 @@ groups:
         include:
           - source: root
             path: D02_AgentBuilder
+      - id: agent_templates
+        title: Agent Templates
+        include:
+          - source: root
+            path: D03_AgentTemplates
+      - id: agent_sessions
+        title: Agent Sessions
+        include:
+          - source: root
+            path: D04_AgentSessions
       - id: agent_controllers
         title: Agent Controllers
         include:
           - source: agent-ctrl
             path: '*'
           - source: root
-            path: D03_AgentCtrl
+            path: D10_AgentCtrl
   - id: prompting
     title: Prompting
     subgroups:

config/examples-groups.yaml

@@ -15,7 +15,7 @@ Key concepts:
 - `AgentState`: Immutable state container for messages and metadata
 - `AgentLoop::execute()`: Executes the agent loop until completion
 - `UseGuards`: Adds step/token/time safety limits
-- `AgentConsoleLogger`: Provides visibility into agent execution stages
+- `AgentEventConsoleObserver`: Provides visibility into agent execution stages
 
 
 ## Example
@@ -28,11 +28,11 @@ use Cognesy\Agents\Builder\AgentBuilder;
 use Cognesy\Agents\Capability\Core\UseGuards;
 use Cognesy\Agents\Capability\Core\UseLLMConfig;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Messages\Messages;
 
 // Create a console logger for visibility into agent execution
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,

docs-build/cookbook/agents/agent_builder/agent_basic.mdx

@@ -16,7 +16,7 @@ Key concepts:
 - `UseTools`: Adds extra tools explicitly when needed (`list_dir`, `search_files`)
 - Working directory: Root path for all file operations (security boundary)
 - Available tools: `read_file`, `write_file`, `edit_file`, `list_dir`, `search_files`
-- `AgentConsoleLogger`: Provides visibility into agent execution stages
+- `AgentEventConsoleObserver`: Provides visibility into agent execution stages
 
 ## Example
 
@@ -31,11 +31,11 @@ use Cognesy\Agents\Capability\File\ListDirTool;
 use Cognesy\Agents\Capability\File\SearchFilesTool;
 use Cognesy\Agents\Capability\File\UseFileTools;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Messages\Messages;
 
 // Create console logger for execution visibility
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,

docs-build/cookbook/agents/agent_builder/agent_file_system.mdx

@@ -15,7 +15,7 @@ Key concepts:
 - `HookContext`: Provides access to tool call and agent state
 - `HookTriggers`: Defines when the hook fires (e.g., `beforeToolUse()`)
 - `UseHook`: Registers a hook capability with explicit trigger/priority
-- `AgentConsoleLogger`: Provides visibility into agent execution stages
+- `AgentEventConsoleObserver`: Provides visibility into agent execution stages
 
 ## Example
 
@@ -28,13 +28,13 @@ use Cognesy\Agents\Capability\Bash\UseBash;
 use Cognesy\Agents\Capability\Core\UseGuards;
 use Cognesy\Agents\Capability\Core\UseHook;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Agents\Hook\Collections\HookTriggers;
 use Cognesy\Agents\Hook\Data\HookContext;
 use Cognesy\Agents\Hook\Hooks\CallableHook;
 
 // Create console logger for execution visibility
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,

docs-build/cookbook/agents/agent_builder/agent_hooks.mdx

@@ -20,7 +20,7 @@ Key concepts:
 - `SearchFilesTool`: Search for files by filename/path pattern
 - `ReadFileTool`: Read file contents
 - `UseSubagents`: Spawn specialized subagents for subtasks
-- `AgentConsoleLogger`: Provides visibility into agent execution stages
+- `AgentEventConsoleObserver`: Provides visibility into agent execution stages
 
 ## Example
 
@@ -37,13 +37,13 @@ use Cognesy\Agents\Capability\File\UseFileTools;
 use Cognesy\Agents\Capability\Subagent\UseSubagents;
 use Cognesy\Agents\Collections\NameList;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Agents\Template\AgentDefinitionRegistry;
 use Cognesy\Agents\Template\Data\AgentDefinition;
 use Cognesy\Messages\Messages;
 
 // Create console logger for execution visibility
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,

docs-build/cookbook/agents/agent_builder/agent_search.mdx

@@ -19,7 +19,7 @@ This significantly improves accuracy by:
 Key concepts:
 - `UseSelfCritique`: Capability that adds self-evaluation after each response
 - `maxIterations`: Maximum number of critique-revision cycles (default: 2)
-- `AgentConsoleLogger`: Provides visibility into continuation decisions showing SelfCritic evaluations
+- `AgentEventConsoleObserver`: Provides visibility into continuation decisions showing SelfCritic evaluations
 
 ## Example
 
@@ -35,11 +35,11 @@ use Cognesy\Agents\Capability\File\SearchFilesTool;
 use Cognesy\Agents\Capability\File\UseFileTools;
 use Cognesy\Agents\Capability\SelfCritique\UseSelfCritique;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Messages\Messages;
 
 // Create console logger - showContinuation reveals self-critique decisions
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,  // Shows SelfCritic criterion in evaluation

docs-build/cookbook/agents/agent_builder/agent_self_critique.mdx

@@ -18,7 +18,7 @@ Key concepts:
 - `UseStructuredOutputs`: Capability for LLM-powered data extraction
 - `SchemaRegistry`: Pre-registered extraction schemas
 - `structured_output`: Tool to extract data into schema
-- `AgentConsoleLogger`: Provides visibility into agent execution stages
+- `AgentEventConsoleObserver`: Provides visibility into agent execution stages
 
 ## Example
 
@@ -35,7 +35,7 @@ use Cognesy\Agents\Capability\StructuredOutput\StructuredOutputPolicy;
 use Cognesy\Agents\Capability\StructuredOutput\UseStructuredOutputs;
 use Cognesy\Agents\Capability\StructuredOutput\SchemaRegistry;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Agents\Tool\Tools\BaseTool;
 use Cognesy\Messages\Messages;
 use Symfony\Component\Validator\Constraints as Assert;
@@ -137,7 +137,7 @@ class CreateLeadTool extends BaseTool
 // =============================================================================
 
 // Create console logger for execution visibility
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,

docs-build/cookbook/agents/agent_builder/agent_structured_output.mdx

@@ -20,7 +20,7 @@ Key concepts:
 - `UseSubagents`: Capability that enables subagent spawning
 - `AgentDefinitionRegistry`: Registry of available subagent definitions
 - `AgentDefinition`: Defines subagent role, tools, and behavior
-- `AgentConsoleLogger`: Shows parent/child agent IDs for tracking orchestration
+- `AgentEventConsoleObserver`: Shows parent/child agent IDs for tracking orchestration
 
 ## Example
 
@@ -34,13 +34,13 @@ use Cognesy\Agents\Capability\File\UseFileTools;
 use Cognesy\Agents\Capability\Subagent\UseSubagents;
 use Cognesy\Agents\Collections\NameList;
 use Cognesy\Agents\Data\AgentState;
-use Cognesy\Agents\Events\Support\AgentConsoleLogger;
+use Cognesy\Agents\Events\Support\AgentEventConsoleObserver;
 use Cognesy\Agents\Template\AgentDefinitionRegistry;
 use Cognesy\Agents\Template\Data\AgentDefinition;
 use Cognesy\Messages\Messages;
 
 // Create console logger - shows agent IDs for parent/child tracking
-$logger = new AgentConsoleLogger(
+$logger = new AgentEventConsoleObserver(
     useColors: true,
     showTimestamps: true,
     showContinuation: true,