hrns 0.0.1__tar.gz

hrns-0.0.1/.gitignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.ruff_cache/
+dist/
+build/
+site/
+.cache/
+benchmark-results/
+*.db
+*.db-shm
+*.db-wal
+.env
+.idea
+test.py
+var

hrns-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hrns contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hrns-0.0.1/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.5
+Name: hrns
+Version: 0.0.1
+Summary: Programmable Pydantic AI agents with an interoperable ACP terminal and hosting
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: platformdirs>=4
+Requires-Dist: pydantic-settings<3,>=2.10
+Requires-Dist: pydantic<3,>=2.12
+Requires-Dist: tomli-w<2,>=1.2
+Provides-Extra: all
+Requires-Dist: agent-client-protocol<0.12,>=0.11; extra == 'all'
+Requires-Dist: fastapi<1,>=0.156; extra == 'all'
+Requires-Dist: fastmcp-slim[client]<5,>=3.3; extra == 'all'
+Requires-Dist: httpx<1,>=0.28; extra == 'all'
+Requires-Dist: keyring>=25; extra == 'all'
+Requires-Dist: packaging>=24; extra == 'all'
+Requires-Dist: psycopg[binary]>=3.2; extra == 'all'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'all'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'all'
+Requires-Dist: pydantic-ai-slim[anthropic]==2.57.0; extra == 'all'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'all'
+Requires-Dist: pydantic-ai-slim[openai]==2.57.0; extra == 'all'
+Requires-Dist: pyyaml<7,>=6; extra == 'all'
+Requires-Dist: starlette<2,>=0.47; extra == 'all'
+Requires-Dist: textual<9,>=8.2; extra == 'all'
+Requires-Dist: uvicorn>=0.35; extra == 'all'
+Requires-Dist: websockets<18,>=15; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: keyring>=25; extra == 'anthropic'
+Requires-Dist: packaging>=24; extra == 'anthropic'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'anthropic'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'anthropic'
+Requires-Dist: pydantic-ai-slim[anthropic]==2.57.0; extra == 'anthropic'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'anthropic'
+Requires-Dist: pyyaml<7,>=6; extra == 'anthropic'
+Provides-Extra: client
+Requires-Dist: agent-client-protocol<0.12,>=0.11; extra == 'client'
+Requires-Dist: fastmcp-slim[client]<5,>=3.3; extra == 'client'
+Requires-Dist: httpx<1,>=0.28; extra == 'client'
+Requires-Dist: keyring>=25; extra == 'client'
+Requires-Dist: textual<9,>=8.2; extra == 'client'
+Requires-Dist: websockets<18,>=15; extra == 'client'
+Provides-Extra: openai
+Requires-Dist: keyring>=25; extra == 'openai'
+Requires-Dist: packaging>=24; extra == 'openai'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'openai'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'openai'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'openai'
+Requires-Dist: pydantic-ai-slim[openai]==2.57.0; extra == 'openai'
+Requires-Dist: pyyaml<7,>=6; extra == 'openai'
+Provides-Extra: postgres
+Requires-Dist: keyring>=25; extra == 'postgres'
+Requires-Dist: packaging>=24; extra == 'postgres'
+Requires-Dist: psycopg[binary]>=3.2; extra == 'postgres'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'postgres'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'postgres'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'postgres'
+Requires-Dist: pyyaml<7,>=6; extra == 'postgres'
+Provides-Extra: runtime
+Requires-Dist: keyring>=25; extra == 'runtime'
+Requires-Dist: packaging>=24; extra == 'runtime'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'runtime'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'runtime'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'runtime'
+Requires-Dist: pyyaml<7,>=6; extra == 'runtime'
+Provides-Extra: server
+Requires-Dist: fastapi<1,>=0.156; extra == 'server'
+Requires-Dist: keyring>=25; extra == 'server'
+Requires-Dist: packaging>=24; extra == 'server'
+Requires-Dist: pydantic-ai-harness[acp]==0.57.0; extra == 'server'
+Requires-Dist: pydantic-ai-skills<3,>=2.1; extra == 'server'
+Requires-Dist: pydantic-ai-slim[mcp]==2.57.0; extra == 'server'
+Requires-Dist: pyyaml<7,>=6; extra == 'server'
+Requires-Dist: starlette<2,>=0.47; extra == 'server'
+Requires-Dist: uvicorn>=0.35; extra == 'server'
+Requires-Dist: websockets<18,>=15; extra == 'server'
+Description-Content-Type: text/markdown
+
+# Benchmark results
+
+Three runs per hrns on a benchmark task using **GPT-6-Luna with medium reasoning**.
+
+| hrns | Tests pass | All quality gates pass | Model responses | Tool calls | Total cost | Average/run |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: |
+| Codex | 3/3 | 3/3 | 44 | 56 | $0.03658 | $0.01219 |
+| OpenCode | 3/3 | 2/3 | 43 | 47 | $0.03578 | $0.01193 |
+| **hrns** | **3/3** | **3/3** | **44** | **59** | **$0.03300** | **$0.01100** |
+
+All runs pass **130/130 tests**. Quality gates cover Ruff lint, Ruff formatting,
+and Pyrefly type checking.
+
+Counts and costs are totals across three runs. Model responses include tool-only
+responses and final answers. Tool calls count underlying attempts, including
+failures; Codex's 41 orchestration calls contain 56 underlying attempts.
+Costs are cache-aware **API equivalents in USD** using common Standard model pricing.
+
+Skill loads: **Codex 0/3**, **OpenCode 1/3**, **hrns 3/3**. The loaded skill is
+`incremental-implementation`, with relevant selection and partial adherence.
+
+---
+
+# hrns
+
+**Define an agent once. Run it in Python, open it in a terminal, or host it remotely.**
+
+hrns combines native Pydantic AI capabilities with policy-controlled sessions, an independent ACP terminal, and authenticated remote hosting. Agent behavior stays in ordinary Python; the terminal can also connect to standard ACP agents that do not use this runtime.
+
+## Start developing
+
+Requires **Python 3.11+**, macOS or Linux, [uv](https://docs.astral.sh/uv/),
+and [just](https://just.systems/).
+
+```sh
+just install
+just check
+```
+
+The checked-in lockfile pins the tested upstream versions. `just install` also
+installs the [prek](https://prek.j178.dev/) Git hook, which runs `just check` before
+each commit without applying automatic fixes. To install the hook after a manual
+dependency sync, run `uv run prek install`.
+
+## Use a local agent with your model
+
+The local developer agent is the default connection mode. Install the provider
+extra and set the API key for the provider you use:
+
+```sh
+uv sync --locked --extra client --extra runtime --extra openai
+export DEEPSEEK_API_KEY='your-key'
+uv run hrns
+```
+
+Press **l** to configure a provider and model, type `/models` in a session, or create
+`hrns.local.toml` in the project:
+
+```toml
+provider = "deepseek"
+model = "deepseek-chat"
+api_key_env = "DEEPSEEK_API_KEY"
+```
+
+`uv run hrns` starts a session in the current directory using that model. The bundled
+`hrns.coder` capability gives it file tools, content search, and a shell in that
+directory: reads are automatic, while writes, edits, and commands ask for approval first.
+`hrns.ask_user` lets the model ask structured multiple-choice questions in the terminal;
+disable it with `[capabilities] ask_user = false` for headless runs. `hrns.todo` gives
+the model a session-scoped plan and shows it in the **Todos** tab of the right drawer.
+Configuration uses pydantic-settings. See
+[local setup](docs/LOCAL.md) for OpenAI-compatible endpoints, local inference, other
+Pydantic AI providers, and headless execution.
+
+Useful slash commands include `/connect` (switch or add a target), `/models`
+(configure or select the local model), `/effort` (change reasoning effort live),
+`/plugins` (toggle, configure, or add plugins), `/mcp` (list MCP servers and their
+tools), `/skills` (browse Agent Skills), and `/todo` (open the session's plan).
+Typing `/` shows an inline filtered list. Type `$` in the composer to find a skill and
+insert a `$skill-name` reference, which runs that skill for the message. The older
+`/model` and `/capabilities` names remain aliases.
+
+Any independent ACP agent can still be launched explicitly:
+
+```sh
+uv run hrns connect --stdio -- /path/to/agent --acp
+```
+
+See [client usage](docs/CLIENT_API.md) for headless execution, profiles, approvals
+and the bridge.
+
+## Serve agents in your FastAPI app
+
+```python
+from fastapi import FastAPI
+from hrns.runtime import SQLiteSessionStore
+from hrns.server import AgentServer
+
+app = FastAPI()
+agents = AgentServer(store=SQLiteSessionStore("./sessions.sqlite3"))
+agents.add_agent(definition)
+agents.mount(app)
+```
+
+`add_agent` binds and validates the definition's resource requirements at registration; pass
+`resources=`, or a `definition.bind(...)` result, when a capability needs host values.
+Install the `server` extra, register your `AgentDefinition` objects, and run the app
+with Uvicorn. Connect using `hrns connect --url http://127.0.0.1:8080 --agent AGENT_ID`.
+PostgreSQL and optional FastAPI authentication dependencies use the same API.
+See [server embedding](docs/SERVER.md) and [the runnable example](examples/fastapi_app.py).
+
+## Layout
+
+hrns is one distribution with optional extras. Protocol and local settings
+ship by default; the runtime, terminal, and server dependencies are opt-in.
+
+| Module | Extra | Purpose |
+| --- | --- | --- |
+| `hrns.protocol` | base | Versioned extension schemas and transport contracts |
+| `hrns.config` | base | Shared local settings using pydantic-settings |
+| `hrns.runtime` | `runtime` | Native agent definitions, plugin management, sessions, `hrns-host` and `hrns-local` |
+| `hrns.client` | `client` | Textual terminal, scripted ACP runner and stdio bridge |
+| `hrns.server` | `server` | FastAPI agent registration and in-process WebSocket ACP |
+
+Install only what you need, for example `pip install 'hrns[client]'`,
+`pip install 'hrns[openai]'`, or `pip install 'hrns[all]'`.
+
+The `hrns.client` module does not import Pydantic AI or installed agent
+plugins, and installing `hrns[client]` alone does not install the runtime.
+Local stdio agents run in a separate process. Network agents run inside an existing
+FastAPI application through `AgentServer`, sharing an explicit SQLite or PostgreSQL store.
+
+## Design essentials
+
+- **Upstream ACP execution:** `PydanticAIACPAgent` owns prompts, streaming, approvals, cancellation, history, and transcript replay.
+- **Native composition:** managed bindings contribute their complete Pydantic AI behavior—tools, instructions, hooks and settings—and are selected when a session is composed.
+- **Live model and effort:** both use standard ACP configuration options and apply from the next request.
+- **Host-owned state:** sessions pin their principal/deployment scope, retain history and metadata, and never silently retry an uncertain prompt.
+- **Explicit resources:** workspace and provider bindings belong to the host. A local workspace is a path, not a sandbox.
+- **Standard ACP first:** generic streaming content, tools and approvals work without project-specific extensions.
+
+## Checks and distribution builds
+
+```sh
+just check
+just lint
+just build
+just fix
+```
+
+`just check` runs the checks and builds the package. `just lint` runs formatting,
+lint, and type checks; `just build` builds the package. `just fix` applies automatic
+formatting and lint fixes. CI exercises the same non-mutating checks on
+macOS/Linux and Python 3.11–3.13. A wheel and source distribution are written to `dist/`; optional dependencies are declared as extras.
+
+External provider, sandbox and durability integrations need their upstream extras and credentials. See the coverage matrix for managed, locally verified and deployment-only distinctions.
+
+## Releasing
+
+The version comes from the git tag via hatch-vcs, so there is no version string to
+edit. Publishing runs on release: create a GitHub release and
+`.github/workflows/publish.yml` builds the distribution, runs `just check`, verifies
+the tag, and uploads to PyPI.
+
+```sh
+git tag 0.1.0
+git push origin 0.1.0
+gh release create 0.1.0 --generate-notes
+```
+
+The tag must match the version hatch-vcs derives, so `0.1.0` publishes `0.1.0`. A
+mismatched tag fails the build instead of uploading an unintended version, and a
+version that already exists on PyPI is rejected.
+
+Uploads use PyPI Trusted Publishing, so no API token is stored in the repository.
+Before the first release, configure a publisher on PyPI for the `hrns` project with
+this repository's owner and name, workflow `publish.yml`, and environment `pypi`.
+Because `hrns` does not exist on PyPI yet, use the pending publisher form.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

hrns-0.0.1/README.md

@@ -0,0 +1,182 @@
+# Benchmark results
+
+Three runs per hrns on a benchmark task using **GPT-6-Luna with medium reasoning**.
+
+| hrns | Tests pass | All quality gates pass | Model responses | Tool calls | Total cost | Average/run |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: |
+| Codex | 3/3 | 3/3 | 44 | 56 | $0.03658 | $0.01219 |
+| OpenCode | 3/3 | 2/3 | 43 | 47 | $0.03578 | $0.01193 |
+| **hrns** | **3/3** | **3/3** | **44** | **59** | **$0.03300** | **$0.01100** |
+
+All runs pass **130/130 tests**. Quality gates cover Ruff lint, Ruff formatting,
+and Pyrefly type checking.
+
+Counts and costs are totals across three runs. Model responses include tool-only
+responses and final answers. Tool calls count underlying attempts, including
+failures; Codex's 41 orchestration calls contain 56 underlying attempts.
+Costs are cache-aware **API equivalents in USD** using common Standard model pricing.
+
+Skill loads: **Codex 0/3**, **OpenCode 1/3**, **hrns 3/3**. The loaded skill is
+`incremental-implementation`, with relevant selection and partial adherence.
+
+---
+
+# hrns
+
+**Define an agent once. Run it in Python, open it in a terminal, or host it remotely.**
+
+hrns combines native Pydantic AI capabilities with policy-controlled sessions, an independent ACP terminal, and authenticated remote hosting. Agent behavior stays in ordinary Python; the terminal can also connect to standard ACP agents that do not use this runtime.
+
+## Start developing
+
+Requires **Python 3.11+**, macOS or Linux, [uv](https://docs.astral.sh/uv/),
+and [just](https://just.systems/).
+
+```sh
+just install
+just check
+```
+
+The checked-in lockfile pins the tested upstream versions. `just install` also
+installs the [prek](https://prek.j178.dev/) Git hook, which runs `just check` before
+each commit without applying automatic fixes. To install the hook after a manual
+dependency sync, run `uv run prek install`.
+
+## Use a local agent with your model
+
+The local developer agent is the default connection mode. Install the provider
+extra and set the API key for the provider you use:
+
+```sh
+uv sync --locked --extra client --extra runtime --extra openai
+export DEEPSEEK_API_KEY='your-key'
+uv run hrns
+```
+
+Press **l** to configure a provider and model, type `/models` in a session, or create
+`hrns.local.toml` in the project:
+
+```toml
+provider = "deepseek"
+model = "deepseek-chat"
+api_key_env = "DEEPSEEK_API_KEY"
+```
+
+`uv run hrns` starts a session in the current directory using that model. The bundled
+`hrns.coder` capability gives it file tools, content search, and a shell in that
+directory: reads are automatic, while writes, edits, and commands ask for approval first.
+`hrns.ask_user` lets the model ask structured multiple-choice questions in the terminal;
+disable it with `[capabilities] ask_user = false` for headless runs. `hrns.todo` gives
+the model a session-scoped plan and shows it in the **Todos** tab of the right drawer.
+Configuration uses pydantic-settings. See
+[local setup](docs/LOCAL.md) for OpenAI-compatible endpoints, local inference, other
+Pydantic AI providers, and headless execution.
+
+Useful slash commands include `/connect` (switch or add a target), `/models`
+(configure or select the local model), `/effort` (change reasoning effort live),
+`/plugins` (toggle, configure, or add plugins), `/mcp` (list MCP servers and their
+tools), `/skills` (browse Agent Skills), and `/todo` (open the session's plan).
+Typing `/` shows an inline filtered list. Type `$` in the composer to find a skill and
+insert a `$skill-name` reference, which runs that skill for the message. The older
+`/model` and `/capabilities` names remain aliases.
+
+Any independent ACP agent can still be launched explicitly:
+
+```sh
+uv run hrns connect --stdio -- /path/to/agent --acp
+```
+
+See [client usage](docs/CLIENT_API.md) for headless execution, profiles, approvals
+and the bridge.
+
+## Serve agents in your FastAPI app
+
+```python
+from fastapi import FastAPI
+from hrns.runtime import SQLiteSessionStore
+from hrns.server import AgentServer
+
+app = FastAPI()
+agents = AgentServer(store=SQLiteSessionStore("./sessions.sqlite3"))
+agents.add_agent(definition)
+agents.mount(app)
+```
+
+`add_agent` binds and validates the definition's resource requirements at registration; pass
+`resources=`, or a `definition.bind(...)` result, when a capability needs host values.
+Install the `server` extra, register your `AgentDefinition` objects, and run the app
+with Uvicorn. Connect using `hrns connect --url http://127.0.0.1:8080 --agent AGENT_ID`.
+PostgreSQL and optional FastAPI authentication dependencies use the same API.
+See [server embedding](docs/SERVER.md) and [the runnable example](examples/fastapi_app.py).
+
+## Layout
+
+hrns is one distribution with optional extras. Protocol and local settings
+ship by default; the runtime, terminal, and server dependencies are opt-in.
+
+| Module | Extra | Purpose |
+| --- | --- | --- |
+| `hrns.protocol` | base | Versioned extension schemas and transport contracts |
+| `hrns.config` | base | Shared local settings using pydantic-settings |
+| `hrns.runtime` | `runtime` | Native agent definitions, plugin management, sessions, `hrns-host` and `hrns-local` |
+| `hrns.client` | `client` | Textual terminal, scripted ACP runner and stdio bridge |
+| `hrns.server` | `server` | FastAPI agent registration and in-process WebSocket ACP |
+
+Install only what you need, for example `pip install 'hrns[client]'`,
+`pip install 'hrns[openai]'`, or `pip install 'hrns[all]'`.
+
+The `hrns.client` module does not import Pydantic AI or installed agent
+plugins, and installing `hrns[client]` alone does not install the runtime.
+Local stdio agents run in a separate process. Network agents run inside an existing
+FastAPI application through `AgentServer`, sharing an explicit SQLite or PostgreSQL store.
+
+## Design essentials
+
+- **Upstream ACP execution:** `PydanticAIACPAgent` owns prompts, streaming, approvals, cancellation, history, and transcript replay.
+- **Native composition:** managed bindings contribute their complete Pydantic AI behavior—tools, instructions, hooks and settings—and are selected when a session is composed.
+- **Live model and effort:** both use standard ACP configuration options and apply from the next request.
+- **Host-owned state:** sessions pin their principal/deployment scope, retain history and metadata, and never silently retry an uncertain prompt.
+- **Explicit resources:** workspace and provider bindings belong to the host. A local workspace is a path, not a sandbox.
+- **Standard ACP first:** generic streaming content, tools and approvals work without project-specific extensions.
+
+## Checks and distribution builds
+
+```sh
+just check
+just lint
+just build
+just fix
+```
+
+`just check` runs the checks and builds the package. `just lint` runs formatting,
+lint, and type checks; `just build` builds the package. `just fix` applies automatic
+formatting and lint fixes. CI exercises the same non-mutating checks on
+macOS/Linux and Python 3.11–3.13. A wheel and source distribution are written to `dist/`; optional dependencies are declared as extras.
+
+External provider, sandbox and durability integrations need their upstream extras and credentials. See the coverage matrix for managed, locally verified and deployment-only distinctions.
+
+## Releasing
+
+The version comes from the git tag via hatch-vcs, so there is no version string to
+edit. Publishing runs on release: create a GitHub release and
+`.github/workflows/publish.yml` builds the distribution, runs `just check`, verifies
+the tag, and uploads to PyPI.
+
+```sh
+git tag 0.1.0
+git push origin 0.1.0
+gh release create 0.1.0 --generate-notes
+```
+
+The tag must match the version hatch-vcs derives, so `0.1.0` publishes `0.1.0`. A
+mismatched tag fails the build instead of uploading an unintended version, and a
+version that already exists on PyPI is rejected.
+
+Uploads use PyPI Trusted Publishing, so no API token is stored in the repository.
+Before the first release, configure a publisher on PyPI for the `hrns` project with
+this repository's owner and name, workflow `publish.yml`, and environment `pypi`.
+Because `hrns` does not exist on PyPI yet, use the pending publisher form.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

hrns-0.0.1/pyproject.toml

@@ -0,0 +1,103 @@
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hrns"
+dynamic = ["version"]
+description = "Programmable Pydantic AI agents with an interoperable ACP terminal and hosting"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+dependencies = [
+    "pydantic>=2.12,<3",
+    "pydantic-settings>=2.10,<3",
+    "platformdirs>=4",
+    "tomli-w>=1.2,<2",
+]
+
+[project.optional-dependencies]
+client = [
+    "agent-client-protocol>=0.11,<0.12",
+    "textual>=8.2,<9",
+    "httpx>=0.28,<1",
+    "websockets>=15,<18",
+    "keyring>=25",
+    "fastmcp-slim[client]>=3.3,<5",
+]
+runtime = [
+    "pydantic-ai-slim[mcp]==2.57.0",
+    "pydantic-ai-harness[acp]==0.57.0",
+    "PyYAML>=6,<7",
+    "packaging>=24",
+    "pydantic-ai-skills>=2.1,<3",
+    "keyring>=25",
+]
+server = [
+    "hrns[runtime]",
+    "fastapi>=0.156,<1",
+    "starlette>=0.47,<2",
+    "uvicorn>=0.35",
+    "websockets>=15,<18",
+]
+openai = [
+    "hrns[runtime]",
+    "pydantic-ai-slim[openai]==2.57.0",
+]
+anthropic = [
+    "hrns[runtime]",
+    "pydantic-ai-slim[anthropic]==2.57.0",
+]
+postgres = [
+    "hrns[runtime]",
+    "psycopg[binary]>=3.2",
+]
+all = [
+    "hrns[client,runtime,server,openai,anthropic,postgres]",
+]
+
+[project.scripts]
+hrns = "hrns.client.cli:main"
+hrns-host = "hrns.runtime.cli:main"
+hrns-local = "hrns.runtime.local:main"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.11",
+    "build>=1.2",
+    "httpx>=0.28",
+    "pyrefly>=1.4.0",
+    "types-pyyaml>=6",
+    "prek>=0.5.7",
+]
+docs = [
+    "mkdocstrings-python>=2.0.10",
+    "zensical>=0.0.67,<0.1",
+]
+
+[tool.hatch.version]
+source = "vcs"
+fallback-version = "0.0.1"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hrns"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/LICENSE"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["hrns"]
+
+[tool.pyrefly]
+project-includes = [
+    "**/*.py*",
+    "**/*.ipynb",
+]

hrns-0.0.1/src/hrns/__init__.py

@@ -0,0 +1,13 @@
+"""hrns: programmable Pydantic AI agents with an ACP terminal and hosting.
+
+The distribution exposes independent subpackages:
+
+- ``hrns.protocol``: versioned contracts and transport framing.
+- ``hrns.config``: shared local settings.
+- ``hrns.runtime``: native agent definitions, sessions, and ACP hosting.
+- ``hrns.client``: Textual terminal, headless runner, and stdio bridge.
+- ``hrns.server``: authenticated deployment catalog and worker hosting.
+
+Importing ``hrns`` does not import any subpackage, so the client and server
+keep their independent dependency boundaries.
+"""