feat(client): refactor AgentikAgent to manage its own HttpClient

- `AgentikAgent` now accepts `engineFactory` and an optional `token` to create an internal `HttpClient`, handling all configuration (JSON, Bearer).
- Removed `applyAgentikDefaults` and replaced it with `agentikHttpClient` for `HttpClient` creation with consistent settings.
- Updated `Agent` to implement `AutoCloseable`, ensuring proper resource closure with `agent.close()`.
- Adjusted tests, docs, and examples to align with the new `AgentikAgent` API.

client/src/commonMain/kotlin/pw/binom/agentik/client/AgentClient.kt

@@ -7,6 +7,7 @@ import io.ktor.client.request.get
 import io.ktor.client.request.parameter
 import io.ktor.client.request.post
 import io.ktor.client.request.setBody
+import io.ktor.client.statement.HttpResponse
 import io.ktor.http.ContentType
 import io.ktor.http.HttpStatusCode
 import io.ktor.http.contentType
@@ -19,36 +20,20 @@ import pw.binom.agentik.proto.Conversation
 /**
  * HTTP-реализация [Agent]. Ходит в `:server`-фасад, см. `agentikAgent(...)`.
  *
- * Замечание по [createConversation]: интерфейс [Agent] объявлен не-suspend
- * (in-process кейс этого не требует), но HTTP-вариант обязан ждать ответа
- * POST `/conversations`. Используем `runBlocking` — это одноразовая
- * операция (открытие чата), не горячий путь. В UI-контексте вызывающий сам
- * решает, что делать.
+ * HttpClient создаётся внутри из переданного engine и закрывается в [close].
  *
  * **Storage handles** ([journal], [outbox]) — read-only views на серверные
- * хранилища. [outbox] уже реализован ([HttpEventStore]); [journal] —
- * заглушка, потому что соответствующий HTTP endpoint'ы (`/journal/...`)
- * ещё не выставлены на стороне `:server`. После их добавления подменить
- * `error(...)` на `HttpJournalStore(...)`.
+ * хранилища.
  */
 internal class AgentClient(
-    private val httpClient: HttpClient,
-    private val baseUrl: String,
     override val id: String,
+    private val baseUrl: String,
+    private val httpClient: HttpClient,
 ) : Agent {
 
     private val agentUrl: String = baseUrl.trimEnd('/')
 
-    /**
-     * Единый канал событий (lifecycle + per-conversation). Под капотом —
-     * [HttpEventStore]: каждый метод бьёт свой URL (см. KDoc).
-     */
     override val outbox: OutboxStore = HttpEventStore(httpClient = httpClient, baseUrl = agentUrl)
-
-    /**
-     * HTTP-фасад для journal: ходит в `:server`'s `GET /journal/conversations/{id}/messages`.
-     * См. [HttpJournalStore] и [pw.binom.agentik.server.journalRoutes].
-     */
     override val journal: JournalStore = HttpJournalStore(httpClient = httpClient, baseUrl = agentUrl)
 
     override fun createConversation(temp: Boolean): Conversation =
@@ -68,7 +53,7 @@ internal class AgentClient(
     }
 
     override suspend fun deleteConversation(id: String): Boolean {
-        val response = httpClient.delete("$agentUrl/conversations/$id")
+        val response: HttpResponse = httpClient.delete("$agentUrl/conversations/$id")
         return response.status == HttpStatusCode.NoContent
     }
 
@@ -79,4 +64,8 @@ internal class AgentClient(
         }.body<List<ConversationSnapshot>>()
         return snapshots.map { ConversationClient(httpClient, agentUrl, it) }
     }
+
+    override fun close() {
+        httpClient.close()
+    }
 }

client/src/commonMain/kotlin/pw/binom/agentik/client/AgentikAgent.kt

@@ -1,38 +1,43 @@
 package pw.binom.agentik.client
 
-import io.ktor.client.HttpClient
+import io.ktor.client.engine.HttpClientEngineFactory
 import pw.binom.agentik.proto.Agent
 
 /**
- * Создаёт [Agent], который под капотом ходит в HTTP-фасад `agentikAgent`
- * (модуль `:server`).
+ * Создаёт [Agent], который ходит в HTTP-фасад `agentikAgent` (модуль `:server`).
+ *
+ * Принимает [engineFactory] — `HttpClientEngineFactory<*>` (`CIO`, `OkHttp`,
+ * `Darwin`, ...). Внутри сам создаёт `HttpClient`, накатывает JSON-конфиг
+ * [agentikJson] и опциональный Bearer [token]. Никакого `applyAgentikDefaults`
+ * снаружи — всё под капотом.
  *
  * ```
- * val http = HttpClient(engine) {
- *     applyAgentikDefaults(token = "s3cret")
- *     // engine — на выбор потребителя (CIO, OkHttp, Darwin, ...);
- *     // движковые настройки (requestTimeout и пр.) — там же
- * }
- * val client = AgentikAgent(
- *     id = "my-agent",
+ * val agent = AgentikAgent(
+ *     id = "my-client",
  *     baseUrl = "http://localhost:8080/agentik",
- *     httpClient = http,
+ *     engineFactory = CIO,
+ *     token = "s3cret",
  * )
- * val conv = client.createConversation(temp = false)
+ * val conv = agent.createConversation(temp = false)
  * conv.send(listOf(Content.Text("hi")))
- * conv.events(Instant.DISTANT_PAST).collect { ev -> ... }
+ * conv.events(Instant.DISTANT_PAST).collect { ... }
+ * agent.close()  // закрывает HttpClient
  * ```
  *
- * [id] пробрасывается в реализацию [Agent.id] — сервер про идентичность
- * агента не знает, поэтому клиент должен её знать сам (или взять из
- * конфига).
+ * [id] пробрасывается в `Agent.id` — сервер про идентичность агента не знает,
+ * поэтому клиент должен её знать сам (или взять из конфига).
  *
- * `:client` НЕ выбирает движок: [HttpClient] (с уже созданным engine'ом)
- * приходит снаружи. К блоку конфигурации применяется [applyAgentikDefaults]
- * (JSON + опциональный Bearer-токен).
+ * **Lifecycle**: [Agent] — `AutoCloseable`. `agent.close()` закрывает
+ * HttpClient (идемпотентно). После этого `createConversation` /
+ * `getConversation` etc. не определены.
  */
 fun AgentikAgent(
     id: String,
     baseUrl: String,
-    httpClient: HttpClient,
-): Agent = AgentClient(httpClient = httpClient, baseUrl = baseUrl, id = id)
+    engineFactory: HttpClientEngineFactory<*>,
+    token: String? = null,
+): Agent = AgentClient(
+    id = id,
+    baseUrl = baseUrl,
+    httpClient = agentikHttpClient(engineFactory = engineFactory, token = token),
+)

client/src/commonMain/kotlin/pw/binom/agentik/client/HttpClientFactory.kt

@@ -1,7 +1,7 @@
 package pw.binom.agentik.client
 
 import io.ktor.client.HttpClient
-import io.ktor.client.HttpClientConfig
+import io.ktor.client.engine.HttpClientEngineFactory
 import io.ktor.client.plugins.DefaultRequest
 import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
 import io.ktor.client.request.header
@@ -9,32 +9,20 @@ import io.ktor.http.HttpHeaders
 import io.ktor.serialization.kotlinx.json.json
 
 /**
- * Общая конфигурация HTTP-клиента agentik — платформо-независимая часть.
+ * Создаёт [HttpClient] поверх [engineFactory] с конфигурацией agentik.
  *
- * `:client` НЕ выбирает движок: его приносит потребитель. Здесь живёт только то,
- * без чего клиент несовместим с `/agentik`:
- * - JSON-конфиг [agentikJson] (обязан совпадать с серверным);
- * - при заданном [token] — `Authorization: Bearer <token>` на ВСЕ запросы
- *   через [DefaultRequest] (накрывает 10 REST-вызовов и оба SSE-потока;
- *   заголовок живёт на клиенте, а не в отдельных запросах).
+ * Внутренний helper для [AgentikAgent]. Потребителю `:client` обычно
+ * не нужен — он передаёт engine в [AgentikAgent] и получает готовый
+ * [pw.binom.agentik.proto.Agent] с уже закрытым HttpClient'ом
+ * на [pw.binom.agentik.proto.Agent.close].
  *
- * `null` — авторизация выключена, заголовок не отправляется.
- *
- * Применяется к уже сконструированному [HttpClient]:
- * ```
- * val engine = HttpClientEngineFactory().create()  // потребитель выбирает движок
- * val http = HttpClient(engine) {
- *     applyAgentikDefaults(token)
- *     // движковые настройки (requestTimeout и пр.) — потребитель знает свой движок
- * }
- * ```
- *
- * Раньше `:client` экспортировал фабрику `agentikHttpClient(engineFactory, ...)`,
- * но она навязывала тип-параметр `HttpClientEngineFactory<T>` и неявно тянула за
- * собой конкретный движок в виде примера в KDoc. Сейчас фабрики нет — потребитель
- * сам создаёт [HttpClient] и накатывает на блок конфигурации [applyAgentikDefaults].
+ * Экспортируется для случаев, когда нужен прямой доступ к `HttpClient`
+ * (например, дополнительные нестандартные запросы в обход `Agent` API).
  */
-fun HttpClientConfig<*>.applyAgentikDefaults(token: String? = null) {
+fun agentikHttpClient(
+    engineFactory: HttpClientEngineFactory<*>,
+    token: String? = null,
+): HttpClient = HttpClient(engineFactory) {
     install(ContentNegotiation) { json(agentikJson) }
     if (token != null) {
         install(DefaultRequest) {

client/src/commonTest/kotlin/pw/binom/agentik/client/BearerHeaderTest.kt

@@ -21,7 +21,7 @@ import kotlin.test.Test
 import kotlin.test.assertEquals
 
 /**
- * Тесты клиентской части: [applyAgentikDefaults] с заданным `token` прикладывает
+ * Тесты клиентской части: [agentikHttpClient] с заданным `token` прикладывает
  * `Authorization: Bearer <token>` ко всем запросам через плагин `DefaultRequest`,
  * без токена — заголовок не отправляется.
  *
@@ -50,7 +50,7 @@ class BearerHeaderTest {
     }
 
     private fun clientWith(token: String?): HttpClient =
-        HttpClient(CIO) { applyAgentikDefaults(token) }
+        agentikHttpClient(engineFactory = CIO, token = token)
 
     private suspend fun startServer(): Pair<EmbeddedServer<*, *>, Int> {
         val server = embeddedServer(ServerCIO, port = 0) {