milo-cli 0.3.1__tar.gz → 0.4.0__tar.gz

{milo_cli-0.3.1 → milo_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: milo-cli
-Version: 0.3.1
+Version: 0.4.0
 Summary: Template-driven CLI applications for free-threaded Python
 License-Expression: MIT
 Project-URL: Homepage, https://lbliii.github.io/milo-cli/
@@ -33,33 +33,43 @@ Requires-Dist: watchfiles>=1.0; extra == "watch"
 [![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://pypi.org/project/milo-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-**Build CLIs that humans and AI agents both use natively**
+**One typed Python function becomes a human CLI command, an MCP tool, and an
+agent-readable discovery entry.**
 
-```python
-from milo import CLI
+<!--
+Launch video: replace this comment with the final 60–90 second recording.
+The verified shot list and clean-machine commands live in docs/launch-demo-script.md.
+-->
 
-cli = CLI(name="deployer", description="Deploy services to environments")
+## Prove It in 60 Seconds
 
-@cli.command("deploy", description="Deploy a service", annotations={"destructiveHint": True})
-def deploy(environment: str, service: str, version: str = "latest") -> dict:
-    """Deploy a service to the specified environment."""
-    return {"status": "deployed", "environment": environment, "service": service, "version": version}
+With [`uv`](https://docs.astral.sh/uv/) installed, paste this into a clean
+directory. `uv` downloads Python 3.14 and Milo when they are not already
+available:
 
-cli.run()
+```bash milo-docs:skip reason=downloads-package-and-creates-project
+uvx --python 3.14 --from milo-cli milo new hello_milo
+uv run --python 3.14 --with milo-cli python hello_milo/app.py greet --name World
+uv run --python 3.14 --with milo-cli milo verify hello_milo/app.py
 ```
 
-Three protocols from one decorator:
+The second command prints `Hello, World!`. The verifier then exercises import,
+schema generation, MCP discovery, MCP Apps tool/resource/gateway conformance,
+and a real subprocess JSON-RPC handshake with resource reads. Do not register a
+new tool until it reports zero failures.
 
-```bash
-# Human CLI
-deployer deploy --environment production --service api
+Now give Claude Code the same file as a local stdio MCP server:
+
+```bash milo-docs:skip reason=requires-claude-cli-and-user-registration
+claude mcp add --transport stdio hello_milo -- \
+  uv run --python 3.14 --with milo-cli python "$PWD/hello_milo/app.py" --mcp
+```
 
-# MCP tool (AI agent calls this via JSON-RPC)
-echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy","arguments":{"environment":"staging","service":"api"}}}' \
-  | deployer --mcp
+Ask Claude to “use the `greet` tool to greet Ada,” or call the same function by
+hand:
 
-# AI-readable discovery document
-deployer --llms-txt
+```bash milo-docs:skip reason=requires-prior-scaffold
+uv run --python 3.14 --with milo-cli python hello_milo/app.py greet --name Ada
 ```
 
 ---
@@ -72,7 +82,7 @@ Milo is a Python framework where every CLI is simultaneously a terminal app, a c
 
 - **Every CLI is an MCP server** — `@cli.command` produces an argparse subcommand, MCP tool, and llms.txt entry from one function. AI agents discover and call your tools with zero extra code.
 - **Dual-mode commands** — The same command shows an interactive UI when a human runs it, and returns structured JSON when an AI calls it via MCP.
-- **Annotated schemas** — Type hints + `Annotated` constraints generate rich JSON Schema. Agents validate inputs before calling.
+- **Annotated schemas** — Type hints + `Annotated` constraints generate rich JSON Schema, and Milo enforces it before handlers run.
 - **Streaming progress** — Commands that yield `Progress` objects stream notifications to MCP clients in real time.
 - **Elm Architecture** — Immutable state, pure reducers, declarative views. Every state transition is explicit and testable.
 - **Free-threading ready** — Built for Python 3.14t (PEP 703). Sagas run on `ThreadPoolExecutor` with no GIL contention.
@@ -121,7 +131,12 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | `--llms-txt` | Generate AI discovery doc |
 | `--mcp-install` | Register in gateway |
 | `annotations={...}` | MCP behavioral hints |
+| `ui=MCPAppToolMeta("ui://...")` | Link a tool to an MCP Apps UI resource |
 | `Annotated[str, MinLen(1)]` | Schema constraints |
+| `Annotated[str, Positional("NAME")]` | Positional CLI presentation |
+| `Option(aliases=("-n",))` | Compatible option aliases |
+| `surfaces=("cli",)` | Keep long-running commands out of agent discovery |
+| `terminal_renderer=...` | Human output over structured command results |
 
 ### Interactive Apps
 
@@ -148,7 +163,7 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | **MCP Gateway** | Single gateway aggregates all registered Milo CLIs for unified AI agent access | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
 | **Tool Annotations** | Declare `readOnlyHint`, `destructiveHint`, `idempotentHint` per MCP spec | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
 | **Streaming Progress** | Commands yield `Progress` objects; MCP clients receive real-time notifications | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
-| **Schema Constraints** | `Annotated[str, MinLen(1), MaxLen(100)]` generates rich JSON Schema | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
+| **Schema Constraints** | `Annotated[str, MinLen(1), MaxLen(100)]` generates and enforces rich JSON Schema | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **llms.txt** | Generate AI-readable discovery documents from CLI command definitions | [llms.txt →](https://lbliii.github.io/milo-cli/docs/build-clis/llms/) |
 | **Middleware** | Intercept MCP calls and CLI commands for logging, auth, and transformation | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **Observability** | Built-in request logging with latency stats (`milo://stats` resource) | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
@@ -165,7 +180,7 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | **Snapshot Testing** | `assert_renders`, `assert_state`, `assert_saga` for deterministic test coverage | [Testing →](https://lbliii.github.io/milo-cli/docs/quality/testing/) |
 | **Pipeline** | Declarative multi-phase workflows with dependency graphs, retry policies, and output capture | [Pipeline →](https://lbliii.github.io/milo-cli/docs/quality/pipeline/) |
 | **Help Rendering** | `HelpRenderer` — drop-in `argparse.HelpFormatter` using Kida templates | [Help →](https://lbliii.github.io/milo-cli/docs/build-clis/help/) |
-| **Context** | Execution context with verbosity, output format, global options, and `run_app()` bridge | [Context →](https://lbliii.github.io/milo-cli/docs/build-clis/context/) |
+| **Context** | Injectable output, interaction, approvals, global options, and `run_app()` bridge | [Context →](https://lbliii.github.io/milo-cli/docs/build-clis/context/) |
 | **Configuration** | `Config` with validation, init scaffolding, and profile support | [Config →](https://lbliii.github.io/milo-cli/docs/about/concepts/configuration/) |
 | **Shell Completions** | Generate bash/zsh/fish completions from CLI definitions | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **Doctor Diagnostics** | `run_doctor()` validates environment, dependencies, and config health | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
@@ -182,11 +197,12 @@ Pick the example closest to your use case, copy its `app.py`, and adapt. See [ex
 |---|---|---|
 | The simplest possible CLI | [examples/greet](examples/greet) | `CLI`, `@cli.command` |
 | Dual-mode CLI ↔ MCP server (flagship) | [examples/deploy](examples/deploy) | `Annotated`, `MinLen`, `Context`, `Progress`, `--mcp` |
-| Context injection, logging, progress, confirms | [examples/ctxdemo](examples/ctxdemo) | `Context`, `ctx.info`, `ctx.progress`, `ctx.confirm` |
+| MCP tool with a negotiated interactive UI resource | [examples/mcp_app](examples/mcp_app) | Dependency-free HTML, `ui_resource`, `MCPAppToolMeta`, structured fallback |
+| Context injection, host-owned output, progress, confirms | [examples/ctxdemo](examples/ctxdemo) | `Context`, `OutputSink`, `ctx.progress`, `ctx.confirm` |
 | Nested command groups (`app repo list`) | [examples/groups](examples/groups) | `cli.group()`, `walk_commands` |
 | Fast startup via deferred imports | [examples/lazyapp](examples/lazyapp) | `cli.lazy_command()` |
-| Production CLI with hooks, completions, doctor | [examples/devtool](examples/devtool) | `run_doctor`, `before_run`/`after_run`, did-you-mean, completions |
-| AI-native CLI surfacing tools + resources | [examples/taskman](examples/taskman) | `@command`, `@resource`, `--format`, `--llms-txt`, `--mcp` |
+| Production CLI with hooks, completions, doctor | [examples/devtool](examples/devtool) | `run_doctor`, `before_command`/`after_command`, did-you-mean, completions |
+| AI-native CLI surfacing tools + resources | [examples/taskman](examples/taskman) | `@cli.command`, `@cli.resource`, `--format`, `--llms-txt`, `--mcp` |
 | Advanced terminal reports and diagnostics | [examples/outputgallery](examples/outputgallery) | `Context.render`, Kida templates, character maps, JSON output |
 
 **Configuration, plugins, pipelines**
@@ -267,7 +283,8 @@ Every Milo CLI is automatically an MCP server:
 myapp --mcp
 
 # Register with an AI host directly
-claude mcp add myapp -- uv run python examples/deploy/app.py --mcp
+claude mcp add --transport stdio myapp -- \
+  uv run python "$PWD/examples/deploy/app.py" --mcp
 ```
 
 For multiple CLIs, register them and run a single gateway:
@@ -281,10 +298,13 @@ deployer --mcp-install
 uv run python -m milo.gateway --mcp
 
 # Or register the gateway with your AI host
-claude mcp add milo -- uv run python -m milo.gateway --mcp
+claude mcp add --transport stdio milo -- uv run python -m milo.gateway --mcp
 ```
 
-The gateway namespaces tools automatically: `taskman.add`, `deployer.deploy`, etc. Implements MCP 2025-11-25 with `outputSchema`, `structuredContent`, tool `annotations`, and streaming `Progress` notifications.
+The gateway namespaces tools automatically (`taskman.add`, `deployer.deploy`) and
+rewrites negotiated MCP Apps `ui://` links without collisions. It preserves
+`outputSchema`, `structuredContent`, tool annotations, resource metadata, and
+streaming `Progress` notifications across child CLIs.
 
 Built-in `milo://stats` resource exposes request latency, error counts, and throughput.
 

{milo_cli-0.3.1 → milo_cli-0.4.0}/README.md

@@ -5,33 +5,43 @@
 [![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://pypi.org/project/milo-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-**Build CLIs that humans and AI agents both use natively**
+**One typed Python function becomes a human CLI command, an MCP tool, and an
+agent-readable discovery entry.**
 
-```python
-from milo import CLI
+<!--
+Launch video: replace this comment with the final 60–90 second recording.
+The verified shot list and clean-machine commands live in docs/launch-demo-script.md.
+-->
 
-cli = CLI(name="deployer", description="Deploy services to environments")
+## Prove It in 60 Seconds
 
-@cli.command("deploy", description="Deploy a service", annotations={"destructiveHint": True})
-def deploy(environment: str, service: str, version: str = "latest") -> dict:
-    """Deploy a service to the specified environment."""
-    return {"status": "deployed", "environment": environment, "service": service, "version": version}
+With [`uv`](https://docs.astral.sh/uv/) installed, paste this into a clean
+directory. `uv` downloads Python 3.14 and Milo when they are not already
+available:
 
-cli.run()
+```bash milo-docs:skip reason=downloads-package-and-creates-project
+uvx --python 3.14 --from milo-cli milo new hello_milo
+uv run --python 3.14 --with milo-cli python hello_milo/app.py greet --name World
+uv run --python 3.14 --with milo-cli milo verify hello_milo/app.py
 ```
 
-Three protocols from one decorator:
+The second command prints `Hello, World!`. The verifier then exercises import,
+schema generation, MCP discovery, MCP Apps tool/resource/gateway conformance,
+and a real subprocess JSON-RPC handshake with resource reads. Do not register a
+new tool until it reports zero failures.
 
-```bash
-# Human CLI
-deployer deploy --environment production --service api
+Now give Claude Code the same file as a local stdio MCP server:
+
+```bash milo-docs:skip reason=requires-claude-cli-and-user-registration
+claude mcp add --transport stdio hello_milo -- \
+  uv run --python 3.14 --with milo-cli python "$PWD/hello_milo/app.py" --mcp
+```
 
-# MCP tool (AI agent calls this via JSON-RPC)
-echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy","arguments":{"environment":"staging","service":"api"}}}' \
-  | deployer --mcp
+Ask Claude to “use the `greet` tool to greet Ada,” or call the same function by
+hand:
 
-# AI-readable discovery document
-deployer --llms-txt
+```bash milo-docs:skip reason=requires-prior-scaffold
+uv run --python 3.14 --with milo-cli python hello_milo/app.py greet --name Ada
 ```
 
 ---
@@ -44,7 +54,7 @@ Milo is a Python framework where every CLI is simultaneously a terminal app, a c
 
 - **Every CLI is an MCP server** — `@cli.command` produces an argparse subcommand, MCP tool, and llms.txt entry from one function. AI agents discover and call your tools with zero extra code.
 - **Dual-mode commands** — The same command shows an interactive UI when a human runs it, and returns structured JSON when an AI calls it via MCP.
-- **Annotated schemas** — Type hints + `Annotated` constraints generate rich JSON Schema. Agents validate inputs before calling.
+- **Annotated schemas** — Type hints + `Annotated` constraints generate rich JSON Schema, and Milo enforces it before handlers run.
 - **Streaming progress** — Commands that yield `Progress` objects stream notifications to MCP clients in real time.
 - **Elm Architecture** — Immutable state, pure reducers, declarative views. Every state transition is explicit and testable.
 - **Free-threading ready** — Built for Python 3.14t (PEP 703). Sagas run on `ThreadPoolExecutor` with no GIL contention.
@@ -93,7 +103,12 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | `--llms-txt` | Generate AI discovery doc |
 | `--mcp-install` | Register in gateway |
 | `annotations={...}` | MCP behavioral hints |
+| `ui=MCPAppToolMeta("ui://...")` | Link a tool to an MCP Apps UI resource |
 | `Annotated[str, MinLen(1)]` | Schema constraints |
+| `Annotated[str, Positional("NAME")]` | Positional CLI presentation |
+| `Option(aliases=("-n",))` | Compatible option aliases |
+| `surfaces=("cli",)` | Keep long-running commands out of agent discovery |
+| `terminal_renderer=...` | Human output over structured command results |
 
 ### Interactive Apps
 
@@ -120,7 +135,7 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | **MCP Gateway** | Single gateway aggregates all registered Milo CLIs for unified AI agent access | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
 | **Tool Annotations** | Declare `readOnlyHint`, `destructiveHint`, `idempotentHint` per MCP spec | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
 | **Streaming Progress** | Commands yield `Progress` objects; MCP clients receive real-time notifications | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
-| **Schema Constraints** | `Annotated[str, MinLen(1), MaxLen(100)]` generates rich JSON Schema | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
+| **Schema Constraints** | `Annotated[str, MinLen(1), MaxLen(100)]` generates and enforces rich JSON Schema | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **llms.txt** | Generate AI-readable discovery documents from CLI command definitions | [llms.txt →](https://lbliii.github.io/milo-cli/docs/build-clis/llms/) |
 | **Middleware** | Intercept MCP calls and CLI commands for logging, auth, and transformation | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **Observability** | Built-in request logging with latency stats (`milo://stats` resource) | [MCP →](https://lbliii.github.io/milo-cli/docs/build-clis/mcp/) |
@@ -137,7 +152,7 @@ The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The
 | **Snapshot Testing** | `assert_renders`, `assert_state`, `assert_saga` for deterministic test coverage | [Testing →](https://lbliii.github.io/milo-cli/docs/quality/testing/) |
 | **Pipeline** | Declarative multi-phase workflows with dependency graphs, retry policies, and output capture | [Pipeline →](https://lbliii.github.io/milo-cli/docs/quality/pipeline/) |
 | **Help Rendering** | `HelpRenderer` — drop-in `argparse.HelpFormatter` using Kida templates | [Help →](https://lbliii.github.io/milo-cli/docs/build-clis/help/) |
-| **Context** | Execution context with verbosity, output format, global options, and `run_app()` bridge | [Context →](https://lbliii.github.io/milo-cli/docs/build-clis/context/) |
+| **Context** | Injectable output, interaction, approvals, global options, and `run_app()` bridge | [Context →](https://lbliii.github.io/milo-cli/docs/build-clis/context/) |
 | **Configuration** | `Config` with validation, init scaffolding, and profile support | [Config →](https://lbliii.github.io/milo-cli/docs/about/concepts/configuration/) |
 | **Shell Completions** | Generate bash/zsh/fish completions from CLI definitions | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
 | **Doctor Diagnostics** | `run_doctor()` validates environment, dependencies, and config health | [CLI →](https://lbliii.github.io/milo-cli/docs/build-clis/commands/) |
@@ -154,11 +169,12 @@ Pick the example closest to your use case, copy its `app.py`, and adapt. See [ex
 |---|---|---|
 | The simplest possible CLI | [examples/greet](examples/greet) | `CLI`, `@cli.command` |
 | Dual-mode CLI ↔ MCP server (flagship) | [examples/deploy](examples/deploy) | `Annotated`, `MinLen`, `Context`, `Progress`, `--mcp` |
-| Context injection, logging, progress, confirms | [examples/ctxdemo](examples/ctxdemo) | `Context`, `ctx.info`, `ctx.progress`, `ctx.confirm` |
+| MCP tool with a negotiated interactive UI resource | [examples/mcp_app](examples/mcp_app) | Dependency-free HTML, `ui_resource`, `MCPAppToolMeta`, structured fallback |
+| Context injection, host-owned output, progress, confirms | [examples/ctxdemo](examples/ctxdemo) | `Context`, `OutputSink`, `ctx.progress`, `ctx.confirm` |
 | Nested command groups (`app repo list`) | [examples/groups](examples/groups) | `cli.group()`, `walk_commands` |
 | Fast startup via deferred imports | [examples/lazyapp](examples/lazyapp) | `cli.lazy_command()` |
-| Production CLI with hooks, completions, doctor | [examples/devtool](examples/devtool) | `run_doctor`, `before_run`/`after_run`, did-you-mean, completions |
-| AI-native CLI surfacing tools + resources | [examples/taskman](examples/taskman) | `@command`, `@resource`, `--format`, `--llms-txt`, `--mcp` |
+| Production CLI with hooks, completions, doctor | [examples/devtool](examples/devtool) | `run_doctor`, `before_command`/`after_command`, did-you-mean, completions |
+| AI-native CLI surfacing tools + resources | [examples/taskman](examples/taskman) | `@cli.command`, `@cli.resource`, `--format`, `--llms-txt`, `--mcp` |
 | Advanced terminal reports and diagnostics | [examples/outputgallery](examples/outputgallery) | `Context.render`, Kida templates, character maps, JSON output |
 
 **Configuration, plugins, pipelines**
@@ -239,7 +255,8 @@ Every Milo CLI is automatically an MCP server:
 myapp --mcp
 
 # Register with an AI host directly
-claude mcp add myapp -- uv run python examples/deploy/app.py --mcp
+claude mcp add --transport stdio myapp -- \
+  uv run python "$PWD/examples/deploy/app.py" --mcp
 ```
 
 For multiple CLIs, register them and run a single gateway:
@@ -253,10 +270,13 @@ deployer --mcp-install
 uv run python -m milo.gateway --mcp
 
 # Or register the gateway with your AI host
-claude mcp add milo -- uv run python -m milo.gateway --mcp
+claude mcp add --transport stdio milo -- uv run python -m milo.gateway --mcp
 ```
 
-The gateway namespaces tools automatically: `taskman.add`, `deployer.deploy`, etc. Implements MCP 2025-11-25 with `outputSchema`, `structuredContent`, tool `annotations`, and streaming `Progress` notifications.
+The gateway namespaces tools automatically (`taskman.add`, `deployer.deploy`) and
+rewrites negotiated MCP Apps `ui://` links without collisions. It preserves
+`outputSchema`, `structuredContent`, tool annotations, resource metadata, and
+streaming `Progress` notifications across child CLIs.
 
 Built-in `milo://stats` resource exposes request latency, error counts, and throughput.
 

{milo_cli-0.3.1 → milo_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "milo-cli"
-version = "0.3.1"
+version = "0.4.0"
 description = "Template-driven CLI applications for free-threaded Python"
 readme = "README.md"
 requires-python = ">=3.14"

milo_cli-0.4.0/src/milo/__init__.py

@@ -0,0 +1,320 @@
+"""Milo — Template-driven CLI applications for free-threaded Python."""
+
+from __future__ import annotations
+
+_LAZY_IMPORTS = {
+    # Types
+    "Action": "_types",
+    "Key": "_types",
+    "SpecialKey": "_types",
+    "AppStatus": "_types",
+    "RenderTarget": "_types",
+    "FieldType": "_types",
+    "FieldSpec": "_types",
+    "FieldState": "_types",
+    "FormState": "_types",
+    "Screen": "_types",
+    "Transition": "_types",
+    "ReducerResult": "_types",
+    "Quit": "_types",
+    "Call": "_types",
+    "Put": "_types",
+    "Select": "_types",
+    "Fork": "_types",
+    "Delay": "_types",
+    "Retry": "_types",
+    "Timeout": "_types",
+    "TryCall": "_types",
+    "Race": "_types",
+    "All": "_types",
+    "Take": "_types",
+    "Debounce": "_types",
+    "Cmd": "_types",
+    "Batch": "_types",
+    "Sequence": "_types",
+    "TickCmd": "_types",
+    "ViewState": "_types",
+    "compact_cmds": "_types",
+    "BUILTIN_ACTIONS": "_types",
+    # Errors
+    "MiloError": "_errors",
+    "InputError": "_errors",
+    "StateError": "_errors",
+    "FormError": "_errors",
+    "AppError": "_errors",
+    "FlowError": "_errors",
+    "ConfigError": "_errors",
+    "PipelineError": "_errors",
+    "PluginError": "_errors",
+    "MCPAppError": "_errors",
+    "ErrorCode": "_errors",
+    "format_error": "_errors",
+    "format_render_error": "_errors",
+    # State
+    "Store": "state",
+    "SagaContext": "state",
+    "EffectResult": "state",
+    "combine_reducers": "state",
+    # App
+    "App": "app",
+    "run": "app",
+    "render_html": "app",
+    # Flow
+    "FlowScreen": "flow",
+    "Flow": "flow",
+    "FlowState": "flow",
+    # Form
+    "form": "form",
+    "form_reducer": "form",
+    "form_schema": "form",
+    "make_form_reducer": "form",
+    # Help
+    "HelpRenderer": "help",
+    # Dev
+    "DevServer": "dev",
+    # Commands (AI-native)
+    "CLI": "commands",
+    "CommandDef": "commands",
+    "CommandSurface": "commands",
+    "LazyCommandDef": "commands",
+    "InvokeResult": "commands",
+    # Groups
+    "Group": "groups",
+    "GroupDef": "groups",
+    "GlobalOption": "commands",
+    "RootOptionSpec": "commands",
+    # Context
+    "ConfirmStrategy": "context",
+    "Context": "context",
+    "NullOutputSink": "context",
+    "OutputSink": "context",
+    "get_context": "context",
+    "CLIProgress": "context",
+    # Config
+    "Config": "config",
+    "ConfigSpec": "config",
+    # Pipeline
+    "Pipeline": "pipeline",
+    "Phase": "pipeline",
+    "PhasePolicy": "pipeline",
+    "PhaseLog": "pipeline",
+    "PipelineState": "pipeline",
+    "PhaseStatus": "pipeline",
+    "PipelineViewState": "pipeline",
+    "make_detail_reducer": "pipeline",
+    "pipeline_to_timeline": "pipeline",
+    "set_active_pipeline": "pipeline",
+    "get_active_pipeline": "pipeline",
+    "CycleError": "pipeline",
+    # Plugins
+    "HookRegistry": "plugins",
+    "function_to_schema": "schema",
+    "validate_arguments": "schema",
+    "MinLen": "schema",
+    "MaxLen": "schema",
+    "Gt": "schema",
+    "Lt": "schema",
+    "Ge": "schema",
+    "Le": "schema",
+    "Pattern": "schema",
+    "Description": "schema",
+    "Positional": "schema",
+    "Option": "schema",
+    # Theme
+    "ThemeStyle": "theme",
+    "ThemeProxy": "theme",
+    "DEFAULT_THEME": "theme",
+    "make_style_filter": "theme",
+    "format_output": "output",
+    "write_output": "output",
+    "generate_llms_txt": "llms",
+    # Commands v2 (resources, prompts)
+    "ResourceDef": "commands",
+    "PromptDef": "commands",
+    # MCP Apps
+    "MCP_APPS_EXTENSION_ID": "mcp_apps",
+    "MCP_APPS_MIME_TYPE": "mcp_apps",
+    "MCPAppCSP": "mcp_apps",
+    "MCPAppPermissions": "mcp_apps",
+    "MCPAppResourceDef": "mcp_apps",
+    "MCPAppResourceMeta": "mcp_apps",
+    "MCPAppToolMeta": "mcp_apps",
+    "MCPAppVisibility": "mcp_apps",
+    # Middleware
+    "MCPCall": "middleware",
+    "MiddlewareStack": "middleware",
+    # Streaming
+    "Progress": "streaming",
+    # Observability
+    "RequestLog": "observability",
+    "RequestLogger": "observability",
+    # Completions
+    "install_completions": "completions",
+    # Doctor
+    "Check": "doctor",
+    "DoctorReport": "doctor",
+    "run_doctor": "doctor",
+    "format_doctor_report": "doctor",
+    # Reducer combinators
+    "quit_on": "reducers",
+    "with_cursor": "reducers",
+    "with_confirm": "reducers",
+    # Version check
+    "VersionInfo": "version_check",
+    "check_version": "version_check",
+}
+
+
+def __getattr__(name: str):
+    """Lazy imports for public API."""
+    if name in _LAZY_IMPORTS:
+        import importlib
+
+        module = importlib.import_module(f"milo.{_LAZY_IMPORTS[name]}")
+        return getattr(module, name)
+    raise AttributeError(f"module 'milo' has no attribute {name!r}")
+
+
+# Free-threaded Python marker (PEP 703)
+def _Py_mod_gil() -> int:  # noqa: N802
+    return 0
+
+
+__version__ = "0.4.0"
+__all__ = [
+    "BUILTIN_ACTIONS",
+    "CLI",
+    "DEFAULT_THEME",
+    "MCP_APPS_EXTENSION_ID",
+    "MCP_APPS_MIME_TYPE",
+    "Action",
+    "All",
+    "App",
+    "AppError",
+    "AppStatus",
+    "Batch",
+    "CLIProgress",
+    "Call",
+    "Check",
+    "Cmd",
+    "CommandDef",
+    "CommandSurface",
+    "Config",
+    "ConfigError",
+    "ConfigSpec",
+    "ConfirmStrategy",
+    "Context",
+    "CycleError",
+    "Debounce",
+    "Delay",
+    "Description",
+    "DevServer",
+    "DoctorReport",
+    "EffectResult",
+    "ErrorCode",
+    "FieldSpec",
+    "FieldState",
+    "FieldType",
+    "Flow",
+    "FlowError",
+    "FlowScreen",
+    "FlowState",
+    "Fork",
+    "FormError",
+    "FormState",
+    "Ge",
+    "GlobalOption",
+    "Group",
+    "GroupDef",
+    "Gt",
+    "HelpRenderer",
+    "HookRegistry",
+    "InputError",
+    "InvokeResult",
+    "Key",
+    "LazyCommandDef",
+    "Le",
+    "Lt",
+    "MCPAppCSP",
+    "MCPAppError",
+    "MCPAppPermissions",
+    "MCPAppResourceDef",
+    "MCPAppResourceMeta",
+    "MCPAppToolMeta",
+    "MCPAppVisibility",
+    "MCPCall",
+    "MaxLen",
+    "MiddlewareStack",
+    "MiloError",
+    "MinLen",
+    "NullOutputSink",
+    "Option",
+    "OutputSink",
+    "Pattern",
+    "Phase",
+    "PhaseLog",
+    "PhasePolicy",
+    "PhaseStatus",
+    "Pipeline",
+    "PipelineError",
+    "PipelineState",
+    "PipelineViewState",
+    "PluginError",
+    "Positional",
+    "Progress",
+    "PromptDef",
+    "Put",
+    "Quit",
+    "Race",
+    "ReducerResult",
+    "RenderTarget",
+    "RequestLog",
+    "RequestLogger",
+    "ResourceDef",
+    "Retry",
+    "RootOptionSpec",
+    "SagaContext",
+    "Screen",
+    "Select",
+    "Sequence",
+    "SpecialKey",
+    "StateError",
+    "Store",
+    "Take",
+    "ThemeProxy",
+    "ThemeStyle",
+    "TickCmd",
+    "Timeout",
+    "Transition",
+    "TryCall",
+    "VersionInfo",
+    "ViewState",
+    "check_version",
+    "combine_reducers",
+    "compact_cmds",
+    "form",
+    "form_reducer",
+    "form_schema",
+    "format_doctor_report",
+    "format_error",
+    "format_output",
+    "format_render_error",
+    "function_to_schema",
+    "generate_llms_txt",
+    "get_active_pipeline",
+    "get_context",
+    "install_completions",
+    "make_detail_reducer",
+    "make_form_reducer",
+    "make_style_filter",
+    "pipeline_to_timeline",
+    "quit_on",
+    "render_html",
+    "run",
+    "run_doctor",
+    "set_active_pipeline",
+    "validate_arguments",
+    "with_confirm",
+    "with_cursor",
+    "write_output",
+]

{milo_cli-0.3.1 → milo_cli-0.4.0}/src/milo/_cells.py

@@ -35,6 +35,11 @@ def cell_width(value: object) -> int:
     return width
 
 
+def max_cell_width(value: object) -> int:
+    """Return the widest display-cell width among the text's lines."""
+    return max((cell_width(line) for line in str(value).splitlines()), default=0)
+
+
 def cell_ljust(value: object, width: int, fill: str = " ") -> str:
     """Left-justify *value* to display-cell *width*."""
     text = str(value)