Files
openhuman/docs
35be5e99e8 feat(agent): architecture improvements — context guard, cost tracking, permissions, events (#151)
* chore(workflows): comment out Windows smoke tests in installer and release workflows

* feat: add usage field to ChatResponse structure

- Introduced a new `usage` field in the `ChatResponse` struct across multiple files to track token usage information.
- Updated various test cases and response handling to accommodate the new field, ensuring consistent behavior in the agent's responses.
- Enhanced the `Provider` trait and related implementations to include the `usage` field in responses, improving observability of token usage during interactions.

* feat: introduce structured error handling and event system for agent loop

- Added a new `AgentError` enum to provide structured error types, allowing differentiation between retryable and permanent failures.
- Implemented an `AgentEvent` enum for a typed event system, enhancing observability during agent loop execution.
- Created a `ContextGuard` to manage context utilization and trigger auto-compaction, preventing infinite retry loops on compaction failures.
- Updated the `mod.rs` file to include the new `UsageInfo` type for improved observability of token usage.
- Added comprehensive tests for the new error handling and event system, ensuring robustness and reliability in agent operations.

* feat: implement token cost tracking and error handling for agent loop

- Introduced a `CostTracker` to monitor cumulative token usage and enforce daily budget limits, enhancing cost management in the agent loop.
- Added structured error types in `AgentError` to differentiate between retryable and permanent failures, improving error handling and recovery strategies.
- Implemented a typed event system with `AgentEvent` for better observability during agent execution, allowing multiple consumers to subscribe to events.
- Developed a `ContextGuard` to manage context utilization and trigger auto-compaction, preventing excessive resource usage during inference calls.

These enhancements improve the robustness and observability of the agent's operations, ensuring better resource management and error handling.

* style: apply cargo fmt formatting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat(agent): enhance error handling and event structure

- Updated `AgentError` conversion to attempt recovery of typed errors wrapped in `anyhow`, improving error handling robustness.
- Expanded `AgentEvent` enum to include `tool_arguments` and `tool_call_ids` for better context in tool calls, and added `output` and `tool_call_id` to `ToolExecutionComplete` for enhanced event detail.
- Improved `EventSender` to clamp channel capacity to avoid panics and added tracing for event emissions, enhancing observability during event handling.

* fix(agent): correct error conversion in AgentError implementation

- Updated the conversion logic in the `From<anyhow::Error>` implementation for `AgentError` to return the `agent_err` directly instead of dereferencing it. This change improves the clarity and correctness of error handling in the agent's error management system.

* refactor(config): simplify default implementations for ReflectionSource and PermissionLevel

- Added `#[derive(Default)]` to `ReflectionSource` and `PermissionLevel` enums, removing custom default implementations for cleaner code.
- Updated error handling in `handle_local_ai_set_ollama_path` to streamline serialization of service status.
- Refactored error mapping in webhook registration and unregistration functions for improved readability.

* refactor(config): clean up LearningConfig and PermissionLevel enums

- Removed unnecessary blank lines in `LearningConfig` and `PermissionLevel` enums for improved code readability.
- Consolidated `#[derive(Default)]` into a single line for `PermissionLevel`, streamlining the code structure.

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-31 21:11:21 -07:00
..
2026-03-29 10:30:18 -07:00