Merge pull request #9 from JaimeStill/deconstruction

release: 0.2.0

Author: JaimeStill

ARCHITECTURE.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## [v0.2.0] - 2025-10-29
+
+**Breaking Changes**:
+- Removed `pkg/capabilities` package - protocol handling now integrated directly into `pkg/types`
+- Removed `pkg/models` package - model abstraction replaced by `types.Model` runtime type
+- Removed `pkg/protocols` package - merged into `pkg/types` with protocol-specific request types
+- Removed `pkg/transport` package - renamed to `pkg/client` with enhanced retry logic
+- `Agent.Client()` now returns `client.Client` instead of `transport.Client`
+- `Agent.Model()` now returns `*types.Model` instead of `models.Model`
+- `Agent.ChatStream()` now returns `<-chan *types.StreamingChunk` instead of `<-chan types.StreamingChunk`
+- `Agent.VisionStream()` now returns `<-chan *types.StreamingChunk` instead of `<-chan types.StreamingChunk`
+- Configuration field `AgentConfig.Transport` renamed to `AgentConfig.Client`
+
+**Added**:
+- `pkg/types` package consolidating protocol types, request/response structures, and model runtime type
+  - `Protocol` type with constants: `Chat`, `Vision`, `Tools`, `Embeddings`
+  - Protocol-specific request types: `ChatRequest`, `VisionRequest`, `ToolsRequest`, `EmbeddingsRequest`
+  - `ProtocolRequest` interface for unified request handling
+  - `Model` runtime type with protocol-specific options
+  - `NewModel()` function for creating models
+  - `FromConfig()` function for converting `ModelConfig` to `Model`
+  - `Protocol.SupportsStreaming()` method
+  - `IsValid()` function for protocol validation
+  - `ValidProtocols()` function returning all supported protocols
+  - `ProtocolStrings()` function for display formatting
+  - `ParseResponse()` function for protocol-aware response parsing
+  - `ParseStreamChunk()` function for protocol-aware streaming chunk parsing
+  - `ExtractOption[T]()` generic function for type-safe option extraction
+  - `ToolDefinition` type for provider-agnostic tool definitions
+  - Protocol-specific parsers: `ParseChatResponse()`, `ParseVisionResponse()`, `ParseToolsResponse()`, `ParseEmbeddingsResponse()`
+  - Protocol-specific streaming parsers: `ParseChatStreamChunk()`, `ParseVisionStreamChunk()`, `ParseToolsStreamChunk()`
+- `pkg/client` package for HTTP client orchestration with retry logic
+  - `Client` interface with `ExecuteProtocol()` and `ExecuteProtocolStream()` methods
+  - `New()` function for creating clients from configuration
+  - Exponential backoff retry logic with jitter for transient failures
+  - Health tracking via `IsHealthy()` method
+- `pkg/config` package additions:
+  - `ClientConfig` type replacing `TransportConfig`
+  - `RetryConfig` type for configuring retry behavior
+  - `DefaultClientConfig()` function
+  - `DefaultRetryConfig()` function
+  - `ClientConfig.Merge()` method
+- `pkg/agent` package additions:
+  - `ErrorType` type for categorizing agent errors
+  - `AgentError` type with detailed error context
+  - `NewAgentError()` function
+  - `NewAgentInitError()` helper function
+  - `NewAgentLLMError()` helper function
+  - Error option functions: `WithCode()`, `WithCause()`, `WithName()`, `WithClient()`, `WithID()`
+- `pkg/providers` package additions:
+  - `PrepareStreamRequest()` method for streaming-specific request preparation
+  - `ProcessStreamResponse()` method for streaming response processing
+
+**Changed**:
+- `Provider.GetEndpoint()` now accepts `types.Protocol` instead of `protocols.Protocol`
+- `Provider.PrepareRequest()` now accepts `types.ProtocolRequest` instead of separate protocol and request parameters
+- `Provider.ProcessResponse()` now accepts `types.Protocol` parameter for protocol-aware parsing
+- `Provider.Model()` now returns `*types.Model` instead of `models.Model`
+- Agent protocol methods now accept variadic options: `Chat()`, `ChatStream()`, `Vision()`, `VisionStream()`, `Tools()`, `Embed()`
+- Mock package types updated to use `pkg/types` and `pkg/client` instead of removed packages
+  - `MockAgent` uses `client.Client` instead of `transport.Client`
+  - Mock helper functions use `types.*` response types
+  - `WithClient()` accepts `client.Client`
+
+**Removed**:
+- `Capability` interface and all capability-related types
+- `CapabilityRequest` type (replaced by protocol-specific request types)
+- `CapabilityOption` type
+- `StreamingCapability` interface
+- `StandardCapability` type
+- `StandardStreamingCapability` type
+- Capability registry and format registration system
+- `Model` interface from `pkg/models`
+- `ProtocolHandler` type
+- `TransportConfig` type (replaced by `ClientConfig`)
+- Model option merging and update methods
+- `MockModel` type
+- `MockCapability` type
+
 ## [v0.1.3] - 2025-10-23
 
 **Changed**: