@orkestrel/agent 0.0.20 → 0.0.22

package/README.md

@@ -1,14 +1,17 @@
 # @orkestrel/agent
 
-A typed **conversation runtime** for the `@orkestrel` line. An agent is a
-conversation with a model and the loop that carries it forward: messages,
-conversations and their compaction, instructions, scopes, prompt assembly, the
-authority gate, durable jobs, and a bounded context → provider → tools → repeat
-turn you can run as a one-shot `generate` or a live `stream`. The model itself
-is the one piece this package does not supply — any backend implementing
-`ProviderInterface` drops in. Callable tools come from `@orkestrel/tool` and
-documents from `@orkestrel/workspace`; the agent advertises the first to the
-model and renders the second into the prompt. Part of the `@orkestrel` line.
+> The conversation runtime for the `@orkestrel` line: the `ProviderInterface` inference
+> boundary with the host-independent HTTP engine and browser relay that implement it, the
+> conversation layer that feeds it — messages, compaction, instructions, scopes, and prompt
+> assembly — and the bounded context → provider → tools → repeat loop that carries a turn to
+> its end.
+
+Build an agent with the `createAgent` function over a `ProviderInterface` implementation,
+seed the conversation through `agent.context.messages`, then run the turn as a one-shot
+`generate` or a live `stream`. Extend the `AgentProvider` class to reach a new wire, or
+compose the `createRelayProvider` and `createRelay` functions to reach a model through your
+own server. Callable tools come from `@orkestrel/tool` and documents from
+`@orkestrel/workspace`. Part of the `@orkestrel` line.
 
 ## Install
 
@@ -50,10 +53,10 @@ const result = await stream.result // { content, usage?, partial }
 ## Guide
 
 [`guides/agent.md`](guides/agent.md) documents the agent-owned surface:
-the provider boundary, conversations, instructions, scopes, authority, durable
-jobs, the loop, and `AgentContext`. The two packages it consumes are mirrored
-alongside it — [`guides/tool.md`](guides/tool.md) for callable tools and
-[`guides/workspace.md`](guides/workspace.md) for files.
+the provider boundary, the `AgentProvider` HTTP engine, the relay, conversations,
+instructions, scopes, authority, durable jobs, the loop, and `AgentContext`. The
+packages it consumes are mirrored alongside it — [`guides/tool.md`](guides/tool.md)
+for callable tools and [`guides/workspace.md`](guides/workspace.md) for files.
 
 ## Package