toolang 0.2.0__tar.gz → 0.2.2__tar.gz

{toolang-0.2.0 → toolang-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: toolang
-Version: 0.2.0
+Version: 0.2.2
 Summary: A programming language and runtime for agents
 Project-URL: Homepage, https://toolang.ai/
 Project-URL: Documentation, https://toolang.ai/docs

{toolang-0.2.0 → toolang-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "toolang"
-version = "0.2.0"
+version = "0.2.2"
 description = "A programming language and runtime for agents"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -54,9 +54,9 @@ Repository = "https://github.com/openhat-ai/toolang"
 Issues = "https://github.com/openhat-ai/toolang/issues"
 
 [project.scripts]
-toolang = "toolang.cli.main:main"
-too = "toolang.cli.main:main"
-caps = "toolang.cli.caps_main:main"
+toolang = "toolang.cli.toolang.app:main"
+too = "toolang.cli.toolang.app:main"
+caps = "toolang.cli.caps.app:main"
 
 [project.entry-points."toolang.tool"]
 agent_chat = "toolang.tools.agent_chat:create_tool_set"

toolang-0.2.2/src/toolang/cli/__main__.py

@@ -0,0 +1,8 @@
+"""Run the default Toolang CLI package."""
+
+from __future__ import annotations
+
+from .toolang.app import main
+
+
+raise SystemExit(main())

toolang-0.2.2/src/toolang/cli/caps/__init__.py

@@ -0,0 +1,5 @@
+"""Caps CLI command package."""
+
+from __future__ import annotations
+
+from .commands import *  # noqa: F403

toolang-0.2.2/src/toolang/cli/caps/__main__.py

@@ -0,0 +1,8 @@
+"""Run the standalone caps CLI package."""
+
+from __future__ import annotations
+
+from .app import main
+
+
+raise SystemExit(main())

toolang-0.2.0/src/toolang/cli/caps_main.py → toolang-0.2.2/src/toolang/cli/caps/app.py

@@ -14,9 +14,9 @@ from typing import Annotated
 import click
 import typer
 
-from ..config.log import configure_logging
-from .caps import CAP_KINDS, register_standalone_caps_commands
-from .utils import _OptionalPrefixAgentGroup, _toolang_root
+from ...config.log import configure_logging
+from .commands import CAP_KINDS, register_standalone_caps_commands
+from ..utils import _OptionalPrefixAgentGroup, _toolang_root
 
 _CLI_PREFIX_AGENT: str | None = None
 CAP_TOP_LEVEL_COMMANDS = frozenset({"list", *CAP_KINDS})

toolang-0.2.0/src/toolang/cli/caps.py → toolang-0.2.2/src/toolang/cli/caps/commands.py

@@ -12,8 +12,8 @@ import click
 import typer
 from typer.core import TyperGroup
 
-from ..base.error import ToolangError
-from .utils import (
+from ...base.error import ToolangError
+from ..utils import (
     _OptionalPrefixAgentCommand,
     _OptionalPrefixAgentGroup,
     _OptionalPrefixAgentListCommand,
@@ -27,12 +27,12 @@ from .utils import (
 )
 
 if TYPE_CHECKING:
-    from .. import caps as cap_store
-    from .. import templates
-    from ..execution.records import UpdateKind
-    from ..components.trigger import watch as watch_feature
-    from ..state.prepared import PreparedEntry, PreparedState
-    from .progress import CliProgress
+    from ... import caps as cap_store
+    from ... import templates
+    from ...execution.records import UpdateKind
+    from ...components.trigger import watch as watch_feature
+    from ...state.prepared import PreparedEntry, PreparedState
+    from ..progress import CliProgress
 
 CapKind = Literal["skill", "psyche", "prompt", "service"]
 EntryKind = Literal["psyche", "skill", "service", "prompt", "task", "chore"]
@@ -462,7 +462,7 @@ def _make_add_cap_command(kind: CapKind, title: str) -> Callable[..., None]:
         ctx: typer.Context,
         ref: str = typer.Argument(..., help=f"{title} ref"),
     ) -> None:
-        from .progress import as_progress_sink
+        from ..progress import as_progress_sink
 
         visibility, agent_name = _target_visibility(ctx)
         selected_agent = _context_agent(ctx)
@@ -691,11 +691,11 @@ def _all_cap_entries(
     prepare: bool,
     kinds: set[EntryKind],
 ) -> tuple[PreparedEntry, ...]:
-    from ..state.durable import scan_durable_state
+    from ...state.durable import scan_durable_state
 
     durable = _wrap_user_error(scan_durable_state, toolang_root, agent_name)
     if prepare and durable.program_source is not None:
-        from .progress import as_progress_sink, make_cli_progress
+        from ..progress import as_progress_sink, make_cli_progress
 
         progress = make_cli_progress(
             prepare_summary_label="Resolved",
@@ -810,7 +810,7 @@ def _append_cap_update(
 
 
 def _make_cap_write_progress() -> CliProgress:
-    from .progress import make_cli_progress
+    from ..progress import make_cli_progress
 
     return make_cli_progress(
         prepare_summary_label="Resolved",
@@ -828,8 +828,8 @@ def _refresh_and_append_cap_update(
     progress_total: int,
     progress: CliProgress | None = None,
 ) -> None:
-    from ..state.durable import scan_durable_state
-    from .progress import as_progress_sink
+    from ...state.durable import scan_durable_state
+    from ..progress import as_progress_sink
 
     durable = _wrap_user_error(scan_durable_state, toolang_root, agent_name)
     _wrap_user_error(

{toolang-0.2.0 → toolang-0.2.2}/src/toolang/cli/progress.py

@@ -83,6 +83,7 @@ class CliProgress:
                 for line in self._lines():
                     print(line, file=self._stream)
             self._print_summary()
+            self._reset_terminal_style()
 
     def interrupt(self) -> None:
         with self._lock:
@@ -290,6 +291,12 @@ class CliProgress:
         for summary in summaries:
             self._console.print(Text(summary, style="dim"))
 
+    def _reset_terminal_style(self) -> None:
+        if not self._console.is_terminal:
+            return
+        self._stream.write("\x1b[0m")
+        self._stream.flush()
+
     def _live_text(self) -> Text:
         text = Text()
         agent_items = [item for item in self._items.values() if item.kind == "agent"]

toolang-0.2.2/src/toolang/cli/toolang/__main__.py

@@ -0,0 +1,8 @@
+"""Run the main Toolang CLI package."""
+
+from __future__ import annotations
+
+from .app import main
+
+
+raise SystemExit(main())

toolang-0.2.0/src/toolang/cli/main.py → toolang-0.2.2/src/toolang/cli/toolang/app.py

@@ -19,10 +19,9 @@ import click
 import typer
 from typer.core import TyperCommand, TyperGroup
 
-from .. import agents
-from ..config.log import LoggingPlan, configure_logging, configure_logging_plan, resolve_agent_logging
-from .caps import CAP_KINDS, register_toolang_caps_commands
-from .utils import (
+from ... import agents
+from ...config.log import LoggingPlan, configure_logging, configure_logging_plan, resolve_agent_logging
+from ..utils import (
     _PrefixAgentWorkGroup,
     _RequiredPrefixAgentCommand,
     _RunAgentCommand,
@@ -39,22 +38,23 @@ from .utils import (
     _required_prefix_agent,
     _required_runtime_agent,
     _runtime_environ_for_agent,
-    _runtime_components,
     _runtime_value,
     _toolang_root,
     _ui_base_url,
     _wait_for_started_status,
     _wrap_user_error,
 )
+from .caps import CAP_KINDS, register_caps_commands
+from .fmt import register_fmt_command
 
 if TYPE_CHECKING:
-    from .. import caps as cap_store
-    from .. import templates
-    from .. import up as agent_up
-    from ..execution.records import UpdateKind
-    from ..state.prepared import PreparedLock, PreparedState
-    from . import invoke as cli_invoke
-    from .progress import CliProgress
+    from ... import caps as cap_store
+    from ... import templates
+    from ... import up as agent_up
+    from ...execution.records import UpdateKind
+    from ...state.prepared import PreparedLock, PreparedState
+    from .. import invoke as cli_invoke
+    from ..progress import CliProgress
 
 
 class _LazyModule:
@@ -105,6 +105,7 @@ TOP_LEVEL_COMMANDS = frozenset(
         "remove",
         "list",
         "info",
+        "fmt",
         "model",
         "tool",
         "channel",
@@ -399,6 +400,7 @@ def info_agent(
         ("Home", str(agents.agent_home(root, agent_name))),
         ("Caps", _info_caps_summary(root, agent_name)),
         ("Jobs", _info_jobs_summary(root, agent_name)),
+        ("Tools", _info_tools_summary(root, agent_name)),
         ("Models", _info_models_summary(root, agent_name, runtime_state=runtime_state, running=status.status != "stopped")),
         ("Status", status_value),
     ]
@@ -408,16 +410,12 @@ def info_agent(
         return
     if status.sandbox:
         rows.append(("Sandbox", status.sandbox))
-    if status.status == "running":
-        loops_text = _runtime_components(runtime_state)
-        if loops_text is not None:
-            rows.append(("Components", loops_text))
     message = _runtime_value(runtime_state.get("message"))
     pid_text = agents.runtime_pid_label(runtime_state)
     if pid_text is not None and status.status != "stopped":
         rows.append(("PID", pid_text))
-    if status.api_url:
-        rows.append(("API", status.api_url))
+    if status.endpoint:
+        rows.append(("API", status.endpoint))
     if status.webui_url:
         rows.append(("WebUI", status.webui_url))
     if status.status == "running" and started_at != "-":
@@ -491,7 +489,7 @@ def run_agent(
         typer.Option("--sandbox-child", hidden=True),
     ] = False,
 ) -> None:
-    from .progress import as_progress_sink, make_cli_progress
+    from ..progress import as_progress_sink, make_cli_progress
 
     selector = _required_runtime_agent(ctx, agent)
     normalized_components = _normalize_component_option(components)
@@ -563,7 +561,7 @@ def _resolve_runtime_startup(
     background: bool,
     progress: CliProgress | None,
 ) -> _RuntimeStartup:
-    from .progress import as_progress_sink
+    from ..progress import as_progress_sink
 
     run_root = target.toolang_root
     agent_name = target.agent_name
@@ -666,7 +664,7 @@ def start_agent(
         typer.Option("--endpoint-host", help="Endpoint host name.", hidden=True),
     ] = None,
 ) -> None:
-    from .progress import as_progress_sink, make_cli_progress
+    from ..progress import as_progress_sink, make_cli_progress
 
     selector = _required_runtime_agent(ctx, agent)
     parsed_selector = _wrap_user_error(agents.parse_agent_selector, selector)
@@ -709,7 +707,7 @@ def start_agent(
     command = [
         sys.executable,
         "-m",
-        "toolang.cli.main",
+        "toolang.cli.toolang",
         *agent_up.build_run_argv(launch.startup),
     ]
     with log_path.open("ab") as stream:
@@ -801,7 +799,7 @@ def _info_caps_summary(toolang_root: Path, agent_name: str) -> str:
 
 
 def _prepared_info_cap_counts(toolang_root: Path, agent_name: str) -> dict[str, int] | None:
-    from ..state.prepared import load_private_lock, load_shared_lock
+    from ...state.prepared import load_private_lock, load_shared_lock
 
     try:
         shared_lock = load_shared_lock(toolang_root)
@@ -834,7 +832,7 @@ def _prepared_lock_info_cap_counts(
 
 
 def _prepare_info_cap_counts(toolang_root: Path, agent_name: str) -> dict[str, int]:
-    from .progress import as_progress_sink, make_cli_progress
+    from ..progress import as_progress_sink, make_cli_progress
 
     progress = make_cli_progress(show_materialize_summary=True)
     try:
@@ -853,7 +851,7 @@ def _prepare_info_cap_counts(toolang_root: Path, agent_name: str) -> dict[str, i
 
 
 def _info_jobs_summary(toolang_root: Path, agent_name: str) -> str:
-    from .. import work
+    from ... import work
 
     chore_count = len(work.list_chores(toolang_root, agent_name))
     task_count = len(work.list_tasks(toolang_root, agent_name))
@@ -873,19 +871,46 @@ def _info_models_summary(
     if running:
         raw_models = runtime_state.get("models")
         if isinstance(raw_models, list):
-            runtime_models = tuple(
+            selectors = tuple(
                 str(item).strip()
                 for item in raw_models
                 if isinstance(item, str) and item.strip()
             )
-            if runtime_models:
-                return ", ".join(runtime_models)
-    configured = agent_up.load_default_models(toolang_root, agent_name)
-    if configured:
-        return ", ".join(configured)
-    from ..models.resolution import DEFAULT_MODEL_SELECTOR
+            if selectors:
+                return _model_count_summary(
+                    toolang_root,
+                    agent_name,
+                    environ=dict(os.environ),
+                    selectors=selectors,
+                )
+    selectors = agent_up.load_default_models(toolang_root, agent_name)
+    return _model_count_summary(
+        toolang_root,
+        agent_name,
+        environ=dict(os.environ),
+        selectors=selectors,
+    )
+
 
-    return DEFAULT_MODEL_SELECTOR
+def _info_tools_summary(toolang_root: Path, agent_name: str) -> str:
+    rows = _tool_rows(toolang_root, dict(os.environ), agent_name=agent_name)
+    set_count = len({namespace for namespace, _tool, _description in rows})
+    return f"{len(rows)} {'tool' if len(rows) == 1 else 'tools'}, {set_count} {'set' if set_count == 1 else 'sets'}"
+
+
+def _model_count_summary(
+    toolang_root: Path,
+    agent_name: str,
+    *,
+    environ: dict[str, str],
+    selectors: Sequence[str] = (),
+) -> str:
+    rows = _model_rows(toolang_root, environ, agent_name=agent_name, model_selectors=selectors)
+    provider_count = len({provider for _model, provider, _details in rows})
+    return (
+        f"{len(rows)} {'model' if len(rows) == 1 else 'models'}, "
+        f"{provider_count} {'provider' if provider_count == 1 else 'providers'}"
+    )
 
 
 model_app = typer.Typer(
@@ -936,8 +961,8 @@ def list_models(
         ),
     ] = None,
 ) -> None:
-    from ..models.errors import NO_AVAILABLE_MODELS_MESSAGE
-    from ..models.resolution import split_model_selectors
+    from ...models.errors import NO_AVAILABLE_MODELS_MESSAGE
+    from ...models.resolution import split_model_selectors
 
     environ = dict(os.environ)
     root = _toolang_root(None)
@@ -970,7 +995,7 @@ def list_model_providers() -> None:
 
 @model_app.command("adapters", help="List available model API adapters.")
 def list_model_adapters() -> None:
-    from ..models.views import available_model_adapters
+    from ...models.views import available_model_adapters
 
     rows = [(name,) for name in available_model_adapters()]
     _echo_table(("ADAPTER",), rows)
@@ -988,7 +1013,7 @@ def list_tools(
         ),
     ] = None,
 ) -> None:
-    from ..tools.registry import split_tool_selectors
+    from ...tools.registry import split_tool_selectors
 
     environ = dict(os.environ)
     root = _toolang_root(None)
@@ -1030,13 +1055,14 @@ def _model_rows(
     root: Path,
     environ: dict[str, str],
     *,
+    agent_name: str = "",
     model_selectors: Sequence[str] = (),
 ) -> list[tuple[str, str, str]]:
-    from ..models.config import load_model_aliases
-    from ..models.views import model_list_rows
+    from ...models.config import load_model_aliases
+    from ...models.views import model_list_rows
 
-    providers = agent_up.load_model_providers(root, "")
-    aliases = load_model_aliases(root, "")
+    providers = agent_up.load_model_providers(root, agent_name)
+    aliases = load_model_aliases(root, agent_name)
     return model_list_rows(
         providers=providers,
         aliases=aliases,
@@ -1046,8 +1072,8 @@ def _model_rows(
 
 
 def _model_provider_rows(root: Path, environ: dict[str, str]) -> list[tuple[str, str, str]]:
-    from ..models.config import load_model_aliases, load_model_provider_configs
-    from ..models.views import model_provider_rows
+    from ...models.config import load_model_aliases, load_model_provider_configs
+    from ...models.views import model_provider_rows
 
     provider_configs = load_model_provider_configs(root, "")
     providers = agent_up.load_model_providers(root, "")
@@ -1064,12 +1090,13 @@ def _tool_rows(
     root: Path,
     environ: dict[str, str],
     *,
+    agent_name: str = "",
     tool_selectors: Sequence[str] = (),
 ) -> list[tuple[str, str, str]]:
-    from ..config.plugins import load_tool_plugin_config
-    from ..tools.views import tool_list_rows
+    from ...config.plugins import load_tool_plugin_config
+    from ...tools.views import tool_list_rows
 
-    config = load_tool_plugin_config(root, "", environ=environ)
+    config = load_tool_plugin_config(root, agent_name, environ=environ)
     tools = agent_up.load_tool_plugins(config=config)
     sources = _plugin_source_by_name("toolang.tool")
     return tool_list_rows(
@@ -1209,7 +1236,7 @@ def _make_work_list_command(kind: WorkKind, title: str) -> Callable[..., None]:
             typer.Option("--all", help="Include archived items."),
         ] = False,
     ) -> None:
-        from .. import work
+        from ... import work
 
         agent_name = _required_prefix_agent(ctx, command_name=kind)
         root = _context_root(ctx)
@@ -1253,7 +1280,7 @@ def _make_new_work_command(kind: WorkKind, title: str) -> Callable[..., None]:
     def new_work(
         ctx: typer.Context,
     ) -> None:
-        from .. import work
+        from ... import work
 
         agent_name = _required_prefix_agent(ctx, command_name=kind)
         text = click.edit(
@@ -1281,7 +1308,7 @@ def _make_edit_work_command(kind: WorkKind, title: str) -> Callable[..., None]:
         ctx: typer.Context,
         id: str = typer.Argument(..., help=f"{title} id", metavar="ID"),
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1316,7 +1343,7 @@ def _make_pause_work_command(kind: WorkKind, title: str) -> Callable[..., None]:
         ctx: typer.Context,
         id: str = typer.Argument(..., help=f"{title} id", metavar="ID"),
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1339,7 +1366,7 @@ def _make_resume_work_command(kind: WorkKind, title: str) -> Callable[..., None]
         ctx: typer.Context,
         id: str = typer.Argument(..., help=f"{title} id", metavar="ID"),
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1362,7 +1389,7 @@ def _make_archive_work_command(kind: WorkKind, title: str) -> Callable[..., None
         ctx: typer.Context,
         id: str = typer.Argument(..., help=f"{title} id", metavar="ID"),
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1389,7 +1416,7 @@ def _make_restore_work_command(kind: WorkKind, title: str) -> Callable[..., None
             typer.Option("--inactive", help="Restore as inactive instead of active."),
         ] = False,
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1414,7 +1441,7 @@ def _make_delete_work_command(kind: WorkKind, title: str) -> Callable[..., None]
         ctx: typer.Context,
         id: str = typer.Argument(..., help=f"{title} id", metavar="ID"),
     ) -> None:
-        from .. import work
+        from ... import work
 
         job_id = id
         agent_name = _required_prefix_agent(ctx, command_name=kind)
@@ -1457,7 +1484,8 @@ app.add_typer(model_app, name="model", no_args_is_help=True, rich_help_panel=RUN
 app.add_typer(tool_app, name="tool", no_args_is_help=True, rich_help_panel=RUNTIME_COMMAND_PANEL)
 app.add_typer(channel_app, name="channel", no_args_is_help=True, rich_help_panel=RUNTIME_COMMAND_PANEL)
 app.add_typer(sandbox_app, name="sandbox", no_args_is_help=True, rich_help_panel=RUNTIME_COMMAND_PANEL)
-register_toolang_caps_commands(app, rich_help_panel=CAPS_COMMAND_PANEL)
+register_fmt_command(app)
+register_caps_commands(app, rich_help_panel=CAPS_COMMAND_PANEL)
 register_work_commands()
 
 

toolang-0.2.2/src/toolang/cli/toolang/caps.py

@@ -0,0 +1,13 @@
+"""Caps commands mounted under the main toolang CLI."""
+
+from __future__ import annotations
+
+import typer
+
+from ..caps.commands import CAP_KINDS, register_toolang_caps_commands as _register_toolang_caps_commands
+
+__all__ = ["CAP_KINDS", "register_caps_commands"]
+
+
+def register_caps_commands(app: typer.Typer, *, rich_help_panel: str | None = None) -> None:
+    _register_toolang_caps_commands(app, rich_help_panel=rich_help_panel)

toolang-0.2.2/src/toolang/cli/toolang/fmt.py

@@ -0,0 +1,129 @@
+"""Hidden formatter command for Toolang source files."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from pathlib import Path
+import sys
+from typing import Annotated
+
+import click
+import typer
+
+
+def register_fmt_command(app: typer.Typer) -> None:
+    app.command("fmt", help="Format .too files.", hidden=True, no_args_is_help=True)(fmt)
+
+
+def fmt(
+    paths: Annotated[
+        list[Path] | None,
+        typer.Argument(help="File or directory paths to format."),
+    ] = None,
+    check: Annotated[
+        bool,
+        typer.Option("--check", help="Exit non-zero if any file is not formatted."),
+    ] = False,
+    tab_size: Annotated[
+        int,
+        typer.Option("--tab-size", help="Number of spaces per indentation level."),
+    ] = 2,
+    stdin_filepath: Annotated[
+        Path | None,
+        typer.Option(
+            "--stdin-filepath",
+            help="Path label for stdin.",
+        ),
+    ] = None,
+) -> None:
+    from ...program_format import ToolangFormatError, format_source
+
+    if tab_size < 1:
+        raise click.ClickException("--tab-size must be at least 1")
+
+    def format_too_source(source: str) -> str:
+        return format_source(source, tab_size=tab_size)
+
+    path_args = paths or []
+    if any(str(path) == "-" for path in path_args) and len(path_args) > 1:
+        raise click.ClickException("'-' cannot be combined with other path arguments")
+
+    stdin_path_arg = _stdin_path_arg(path_args)
+    if stdin_filepath is not None or stdin_path_arg is not None:
+        if path_args and stdin_path_arg is None:
+            raise click.ClickException("--stdin-filepath can only be combined with '-'")
+        if check:
+            raise click.ClickException("--check cannot be combined with stdin formatting")
+        label = stdin_filepath or stdin_path_arg or Path("<stdin>")
+        _format_stdin(label, format_source=format_too_source, error_type=ToolangFormatError)
+        return
+
+    source_paths = _collect_format_paths(path_args)
+    changed: list[Path] = []
+    for source_path in source_paths:
+        try:
+            source = source_path.read_text(encoding="utf-8")
+        except OSError as exc:
+            raise click.ClickException(f"{source_path}: {exc}") from exc
+        try:
+            formatted = format_too_source(source)
+        except ToolangFormatError as exc:
+            raise click.ClickException(f"{source_path}: {exc}") from exc
+        if formatted == source:
+            continue
+        changed.append(source_path)
+        if check:
+            continue
+        try:
+            source_path.write_text(formatted, encoding="utf-8")
+        except OSError as exc:
+            raise click.ClickException(f"{source_path}: {exc}") from exc
+
+    if check and changed:
+        for source_path in changed:
+            typer.echo(f"would reformat {source_path}")
+        raise typer.Exit(1)
+    if changed:
+        for source_path in changed:
+            typer.echo(f"formatted {source_path}")
+
+
+def _format_stdin(
+    stdin_filepath: Path,
+    *,
+    format_source: Callable[[str], str],
+    error_type: type[Exception],
+) -> None:
+    try:
+        formatted = format_source(sys.stdin.read())
+    except error_type as exc:
+        raise click.ClickException(f"{stdin_filepath}: {exc}") from exc
+    sys.stdout.write(formatted)
+
+
+def _stdin_path_arg(paths: list[Path]) -> Path | None:
+    if len(paths) == 1 and str(paths[0]) == "-":
+        return Path("<stdin>")
+    return None
+
+
+def _collect_format_paths(paths: list[Path]) -> list[Path]:
+    collected: list[Path] = []
+    seen: set[Path] = set()
+    for path in paths:
+        candidate = path.expanduser()
+        if candidate.is_dir():
+            candidates = sorted(item for item in candidate.rglob("*.too") if item.is_file())
+        elif candidate.is_file():
+            if candidate.suffix != ".too":
+                raise click.ClickException(f"not a .too file: {candidate}")
+            candidates = [candidate]
+        else:
+            raise click.ClickException(f"path not found: {candidate}")
+        for source_path in candidates:
+            resolved = source_path.resolve()
+            if resolved in seen:
+                continue
+            seen.add(resolved)
+            collected.append(source_path)
+    return collected