zettcode 0.1.0__tar.gz → 0.1.2__tar.gz

zettcode-0.1.2/.gitignore

@@ -0,0 +1,21 @@
+**/.venv/
+**/__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.coverage
+**/.pytest_cache/
+**/.ruff_cache/
+.zett-tool-output/
+.env
+.DS_Store
+
+# viztracer writes its trace here by default.
+/result.json
+
+# The docs site: dependencies, build output, and VitePress' cache.
+node_modules/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+docs/.vitepress/.temp/

zettcode-0.1.2/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.5
+Name: zettcode
+Version: 0.1.2
+Summary: A focused terminal coding agent powered by zett-agent
+Project-URL: Repository, https://github.com/Chang-LeHung/zettcode
+Project-URL: Issues, https://github.com/Chang-LeHung/zettcode/issues
+Author: Chang-LeHung
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,coding-agent,llm,terminal,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: exceptiongroup<2,>=1.2; python_version < '3.11'
+Requires-Dist: pyperclip<2,>=1.9
+Requires-Dist: tomli<3,>=2; python_version < '3.11'
+Requires-Dist: wcwidth<1,>=0.2
+Requires-Dist: zett-agent==0.1.10
+Description-Content-Type: text/markdown
+
+# ZettCode
+
+**English** · [简体中文](README.zh-CN.md)
+
+A focused coding agent for your terminal. Point it at a workspace, describe the
+change you want, and watch the work happen — files read, commands approved,
+edits made, tests run — as a conversation you can scroll, select, and copy.
+
+The terminal interface is this repository; the model loop is
+[`zett-agent`](https://github.com/Chang-LeHung/zett-agent), published separately.
+
+## Install
+
+ZettCode needs Python 3.10 or newer. It is published on PyPI as `zettcode`:
+
+```bash
+uv tool install zettcode
+# or
+pip install zettcode
+```
+
+## Configure
+
+Everything except the workspace lives in `~/.zettcode/config.toml`. At least one
+model, and the first one is active at startup:
+
+```toml
+[[models]]
+model = "gpt-4o"
+token = "sk-..."                       # or set OPENAI_API_KEY
+base_url = "http://localhost:8787/v1"  # any OpenAI-compatible endpoint
+context_window = 200000                # tokens this model can carry
+multimodal = true                      # accepts images as well as text
+```
+
+Project `AGENTS.md` files, [skills](https://chang-lehung.github.io/zettcode/guide/skills-and-mcp),
+MCP servers, plugins, the palette, and the rest are all in the same file. The
+full key list is in the [configuration reference](https://chang-lehung.github.io/zettcode/guide/config).
+
+## Run
+
+```bash
+cd ~/projects/api
+zettcode                                    # workspace defaults to the cwd
+zettcode -w /path/to/project                # work somewhere else
+zettcode --resume <session-id>              # reopen a stored session
+zettcode --dry-run                          # time the startup and exit
+```
+
+Type a task and press **Enter**. `/` opens the command menu, `@` references a
+skill, `Ctrl-C` stops a request, `Ctrl-D` on an empty composer exits — and
+leaving prints the command that brings the session back.
+
+## What it does
+
+- **Streams a conversation, not a payload.** Reasoning, answers, and tool calls
+  arrive as rows in order; tool output reads like a log — `Read src/app.py`,
+  `Ran pytest -q` — never raw JSON.
+- **Asks before it acts.** Every shell command is confirmed first, with
+  `a` to allow the rest of the run and `p` to remember one command.
+- **Keeps the context honest.** The status line shows tokens, cache hit rate,
+  and how full the window is; `/context` breaks the request down, and compaction
+  summarizes before the window overflows.
+- **Remembers the project.** `AGENTS.md` files from the workspace upward become
+  project instructions; skills and MCP servers extend what the model can do.
+- **Respects the terminal.** Mouse selection and scrolling, panels for choices,
+  image paste, `Ctrl-L`, and a palette that follows your terminal's background —
+  or your own `theme.toml`.
+
+## Documentation
+
+The user guide is published at
+**<https://chang-lehung.github.io/zettcode/>** (English, with
+[中文](https://chang-lehung.github.io/zettcode/zh/) alongside it):
+
+| | |
+| --- | --- |
+| [Getting started](https://chang-lehung.github.io/zettcode/guide/getting-started) | Install, first task, first approvals. |
+| [The interface](https://chang-lehung.github.io/zettcode/guide/interface) | What each row of the screen tells you. |
+| [Keys and mouse](https://chang-lehung.github.io/zettcode/guide/keys) | The full reference. |
+| [Commands](https://chang-lehung.github.io/zettcode/guide/commands) | Every `/command` and `@resource`. |
+| [Sessions](https://chang-lehung.github.io/zettcode/guide/sessions) | Resume, title, export. |
+| [Configuration](https://chang-lehung.github.io/zettcode/guide/config) | One file, every key. |
+| [Models and context](https://chang-lehung.github.io/zettcode/guide/models) | Effort, compaction, cache, images. |
+| [Project instructions](https://chang-lehung.github.io/zettcode/guide/instructions) | Writing a good `AGENTS.md`. |
+| [Skills and MCP](https://chang-lehung.github.io/zettcode/guide/skills-and-mcp) | Teaching it your own tools. |
+| [Plugins](https://chang-lehung.github.io/zettcode/guide/plugins) | Adding commands and rows in Python. |
+| [Problems and questions](https://chang-lehung.github.io/zettcode/guide/faq) | When something does not work. |
+
+## Development
+
+```bash
+uv sync                       # install the environment
+make check                    # ruff, mypy, and pytest
+make hooks                    # run mypy before every commit
+make demo                     # browse the widgets interactively
+uv run zettcode -w .          # run the checkout against a workspace
+```
+
+Notes for working inside the repository — layering, the invariant list, the
+platform seam — are in [`AGENTS.md`](AGENTS.md) and
+[`docs/internal/`](docs/internal/). The docs site itself lives in
+`docs/` and builds with `npm ci --prefix docs && npm run docs:build --prefix docs`.
+
+## License
+
+MIT — see [`LICENSE`](LICENSE).

zettcode-0.1.2/README.md

@@ -0,0 +1,107 @@
+# ZettCode
+
+**English** · [简体中文](README.zh-CN.md)
+
+A focused coding agent for your terminal. Point it at a workspace, describe the
+change you want, and watch the work happen — files read, commands approved,
+edits made, tests run — as a conversation you can scroll, select, and copy.
+
+The terminal interface is this repository; the model loop is
+[`zett-agent`](https://github.com/Chang-LeHung/zett-agent), published separately.
+
+## Install
+
+ZettCode needs Python 3.10 or newer. It is published on PyPI as `zettcode`:
+
+```bash
+uv tool install zettcode
+# or
+pip install zettcode
+```
+
+## Configure
+
+Everything except the workspace lives in `~/.zettcode/config.toml`. At least one
+model, and the first one is active at startup:
+
+```toml
+[[models]]
+model = "gpt-4o"
+token = "sk-..."                       # or set OPENAI_API_KEY
+base_url = "http://localhost:8787/v1"  # any OpenAI-compatible endpoint
+context_window = 200000                # tokens this model can carry
+multimodal = true                      # accepts images as well as text
+```
+
+Project `AGENTS.md` files, [skills](https://chang-lehung.github.io/zettcode/guide/skills-and-mcp),
+MCP servers, plugins, the palette, and the rest are all in the same file. The
+full key list is in the [configuration reference](https://chang-lehung.github.io/zettcode/guide/config).
+
+## Run
+
+```bash
+cd ~/projects/api
+zettcode                                    # workspace defaults to the cwd
+zettcode -w /path/to/project                # work somewhere else
+zettcode --resume <session-id>              # reopen a stored session
+zettcode --dry-run                          # time the startup and exit
+```
+
+Type a task and press **Enter**. `/` opens the command menu, `@` references a
+skill, `Ctrl-C` stops a request, `Ctrl-D` on an empty composer exits — and
+leaving prints the command that brings the session back.
+
+## What it does
+
+- **Streams a conversation, not a payload.** Reasoning, answers, and tool calls
+  arrive as rows in order; tool output reads like a log — `Read src/app.py`,
+  `Ran pytest -q` — never raw JSON.
+- **Asks before it acts.** Every shell command is confirmed first, with
+  `a` to allow the rest of the run and `p` to remember one command.
+- **Keeps the context honest.** The status line shows tokens, cache hit rate,
+  and how full the window is; `/context` breaks the request down, and compaction
+  summarizes before the window overflows.
+- **Remembers the project.** `AGENTS.md` files from the workspace upward become
+  project instructions; skills and MCP servers extend what the model can do.
+- **Respects the terminal.** Mouse selection and scrolling, panels for choices,
+  image paste, `Ctrl-L`, and a palette that follows your terminal's background —
+  or your own `theme.toml`.
+
+## Documentation
+
+The user guide is published at
+**<https://chang-lehung.github.io/zettcode/>** (English, with
+[中文](https://chang-lehung.github.io/zettcode/zh/) alongside it):
+
+| | |
+| --- | --- |
+| [Getting started](https://chang-lehung.github.io/zettcode/guide/getting-started) | Install, first task, first approvals. |
+| [The interface](https://chang-lehung.github.io/zettcode/guide/interface) | What each row of the screen tells you. |
+| [Keys and mouse](https://chang-lehung.github.io/zettcode/guide/keys) | The full reference. |
+| [Commands](https://chang-lehung.github.io/zettcode/guide/commands) | Every `/command` and `@resource`. |
+| [Sessions](https://chang-lehung.github.io/zettcode/guide/sessions) | Resume, title, export. |
+| [Configuration](https://chang-lehung.github.io/zettcode/guide/config) | One file, every key. |
+| [Models and context](https://chang-lehung.github.io/zettcode/guide/models) | Effort, compaction, cache, images. |
+| [Project instructions](https://chang-lehung.github.io/zettcode/guide/instructions) | Writing a good `AGENTS.md`. |
+| [Skills and MCP](https://chang-lehung.github.io/zettcode/guide/skills-and-mcp) | Teaching it your own tools. |
+| [Plugins](https://chang-lehung.github.io/zettcode/guide/plugins) | Adding commands and rows in Python. |
+| [Problems and questions](https://chang-lehung.github.io/zettcode/guide/faq) | When something does not work. |
+
+## Development
+
+```bash
+uv sync                       # install the environment
+make check                    # ruff, mypy, and pytest
+make hooks                    # run mypy before every commit
+make demo                     # browse the widgets interactively
+uv run zettcode -w .          # run the checkout against a workspace
+```
+
+Notes for working inside the repository — layering, the invariant list, the
+platform seam — are in [`AGENTS.md`](AGENTS.md) and
+[`docs/internal/`](docs/internal/). The docs site itself lives in
+`docs/` and builds with `npm ci --prefix docs && npm run docs:build --prefix docs`.
+
+## License
+
+MIT — see [`LICENSE`](LICENSE).

zettcode-0.1.2/README.zh-CN.md

@@ -0,0 +1,98 @@
+# ZettCode
+
+[English](README.md) · **简体中文**
+
+一个专注的终端编码智能体。指向一个工作区，说清楚要改什么，然后看着它把活干出来 —— 读文件、
+等你批准命令、改代码、跑测试 —— 整个过程是一段可以滚动、选中、复制的对话。
+
+终端界面就是本仓库；模型循环在
+[`zett-agent`](https://github.com/Chang-LeHung/zett-agent)，单独发布。
+
+## 安装
+
+需要 Python 3.10 或更新版本，PyPI 包名是 `zettcode`：
+
+```bash
+uv tool install zettcode
+# 或者
+pip install zettcode
+```
+
+## 配置
+
+除了工作区，其他设置都在 `~/.zettcode/config.toml`。至少要有一个模型，第一张表在启动时生效：
+
+```toml
+[[models]]
+model = "gpt-4o"
+token = "sk-..."                       # 也可以设置 OPENAI_API_KEY
+base_url = "http://localhost:8787/v1"  # 任何 OpenAI 兼容的接入点
+context_window = 200000                # 这个模型能装多少 token
+multimodal = true                      # 除文本外还接受图片
+```
+
+项目里的 `AGENTS.md`、[skills](https://chang-lehung.github.io/zettcode/zh/guide/skills-and-mcp)、
+MCP 服务器、插件、配色等等都在同一个文件里，完整的键见
+[配置文件](https://chang-lehung.github.io/zettcode/zh/guide/config)。
+
+## 运行
+
+```bash
+cd ~/projects/api
+zettcode                                    # 工作区默认是当前目录
+zettcode -w /path/to/project                # 在别处工作
+zettcode --resume <session-id>              # 重新打开一个已保存的会话
+zettcode --dry-run                          # 只测启动耗时后退出
+```
+
+输入任务并按 **Enter**。`/` 打开命令菜单，`@` 引用 skill，`Ctrl-C` 停止请求，输入框为空时
+`Ctrl-D` 退出 —— 退出时会打印把会话找回来的命令。
+
+## 它能做什么
+
+- **流式地呈现对话，而不是丢一堆数据。** 思考、回答、工具调用按顺序各占一行；工具输出读起来像
+  日志 —— `Read src/app.py`、`Ran pytest -q` —— 永远不会甩出原始 JSON。
+- **动手之前先问你。** 每条 shell 命令都要先确认，`a` 放行本轮剩余命令，`p` 记住某一条。
+- **把上下文讲清楚。** 状态行显示 token、缓存命中率和窗口占用；`/context` 拆开当前请求，
+  压缩会在窗口溢出之前完成。
+- **记住项目。** 从工作区逐级向上的 `AGENTS.md` 会变成项目指令；skills 和 MCP 服务器扩展模型
+  能做的事。
+- **尊重终端。** 鼠标选中与滚动、用面板做选择、粘贴图片、`Ctrl-L`，以及跟随终端背景的配色 ——
+  也可以用你自己的 `theme.toml`。
+
+## 文档
+
+用户指南发布在 **<https://chang-lehung.github.io/zettcode/zh/>**（
+[English](https://chang-lehung.github.io/zettcode/) 与之并列）：
+
+| | |
+| --- | --- |
+| [快速开始](https://chang-lehung.github.io/zettcode/zh/guide/getting-started) | 安装、第一个任务、第一次审批。 |
+| [界面](https://chang-lehung.github.io/zettcode/zh/guide/interface) | 屏幕上每一行在说什么。 |
+| [快捷键与鼠标](https://chang-lehung.github.io/zettcode/zh/guide/keys) | 完整对照表。 |
+| [命令](https://chang-lehung.github.io/zettcode/zh/guide/commands) | 所有 `/命令` 与 `@资源`。 |
+| [会话](https://chang-lehung.github.io/zettcode/zh/guide/sessions) | 恢复、命名、导出。 |
+| [配置文件](https://chang-lehung.github.io/zettcode/zh/guide/config) | 一个文件，所有键。 |
+| [模型与上下文](https://chang-lehung.github.io/zettcode/zh/guide/models) | 推理档位、压缩、缓存、图片。 |
+| [项目指令](https://chang-lehung.github.io/zettcode/zh/guide/instructions) | 怎么写出好用的 `AGENTS.md`。 |
+| [Skills 与 MCP](https://chang-lehung.github.io/zettcode/zh/guide/skills-and-mcp) | 接入你自己的工具。 |
+| [插件](https://chang-lehung.github.io/zettcode/zh/guide/plugins) | 用 Python 添加命令和界面行。 |
+| [常见问题](https://chang-lehung.github.io/zettcode/zh/guide/faq) | 出问题的时候。 |
+
+## 开发
+
+```bash
+uv sync                       # 安装环境
+make check                    # ruff、mypy、pytest
+make hooks                    # 每次提交前跑 mypy
+make demo                     # 交互式浏览所有组件
+uv run zettcode -w .          # 用源码运行
+```
+
+仓库内部的约定 —— 分层、不变量清单、平台适配 —— 见 [`AGENTS.md`](AGENTS.md) 和
+[`docs/internal/`](docs/internal/)。文档站在 `docs/`，构建命令是
+`npm ci --prefix docs && npm run docs:build --prefix docs`。
+
+## 许可证
+
+MIT，见 [`LICENSE`](LICENSE)。

zettcode-0.1.2/pyproject.toml

@@ -0,0 +1,101 @@
+[project]
+name = "zettcode"
+description = "A focused terminal coding agent powered by zett-agent"
+readme = "README.md"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Chang-LeHung"}]
+keywords = ["agent", "llm", "tui", "terminal", "coding-agent"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows :: Windows 10",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = [
+  # The stdlib gained both of these in 3.11; older runtimes take the backports.
+  "exceptiongroup>=1.2,<2; python_version < '3.11'",
+  "pyperclip>=1.9,<2",
+  "tomli>=2,<3; python_version < '3.11'",
+  "wcwidth>=0.2,<1",
+  "zett-agent==0.1.10",
+]
+
+[project.scripts]
+zettcode = "zettcode.cli:main"
+
+[project.urls]
+Repository = "https://github.com/Chang-LeHung/zettcode"
+Issues = "https://github.com/Chang-LeHung/zettcode/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+# Single source of truth: the version is written once, in the package.
+path = "src/zettcode/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/zettcode"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/README.zh-CN.md", "/LICENSE", "/pyproject.toml"]
+
+[dependency-groups]
+dev = [
+  # Unlike the conditional runtime deps, these are installed on every
+  # interpreter so mypy can check the 3.10 branch of ``_compat`` for real.
+  "exceptiongroup>=1.2,<2",
+  "mypy>=1.14,<2",
+  "pytest>=8,<9",
+  "pytest-asyncio>=0.26,<2",
+  "pytest-cov>=7.1.0",
+  "ruff>=0.11,<1",
+  "tomli>=2,<3",
+  "viztracer>=1.1.1",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src", "perf"]
+# Check the pydantic storage models as models, not as plain classes.
+plugins = ["pydantic.mypy"]
+warn_unused_ignores = true
+warn_redundant_casts = true
+no_implicit_optional = true
+
+[[tool.mypy.overrides]]
+# Ships no stubs; the runner only calls the two documented functions.
+module = ["pyperclip"]
+ignore_missing_imports = true
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+src = ["src", "tests", "perf"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["zettcode"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"

zettcode-0.1.2/src/zettcode/__init__.py

@@ -0,0 +1,47 @@
+"""Terminal coding agent built on zett-agent."""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+#: The one place the version is written. ``pyproject.toml`` reads it from here
+#: and the release workflow checks the tag against it, so a bump is one edit.
+__version__ = "0.1.2"
+
+#: Where each public name lives; read by :func:`__getattr__` on first use.
+_EXPORTS = {
+    "ModelConfig": ".config",
+    "ZettCodeAgent": ".app.agent.agent",
+    "ZettCodeConfig": ".config",
+    "ZettCodeRuntime": ".app.agent.runtime",
+}
+
+
+if TYPE_CHECKING:  # pragma: no cover - for type checkers, not the runtime
+    from .app.agent.agent import ZettCodeAgent
+    from .app.agent.runtime import ZettCodeRuntime
+    from .config import ModelConfig, ZettCodeConfig
+
+
+def __getattr__(name: str) -> object:
+    """Import the module a public name lives in, the first time it is asked for.
+
+    This package is a facade over several subpackages, and a caller that wants
+    one name should not pay for the rest of them — the TUI alone holds the
+    widget library, the Markdown parser, the diff viewer, and the syntax
+    scanners. ``__all__`` is still the public surface.
+    """
+    try:
+        module = _EXPORTS[name]
+    except KeyError:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+    return getattr(importlib.import_module(module, __name__), name)
+
+
+def __dir__() -> list[str]:
+    """Return the names this package publishes."""
+    return sorted(__all__)
+
+
+__all__ = ["ModelConfig", "ZettCodeAgent", "ZettCodeConfig", "ZettCodeRuntime"]

zettcode-0.1.2/src/zettcode/_compat.py

@@ -0,0 +1,35 @@
+"""Small shims for the language versions this project supports.
+
+ZettCode runs on Python 3.10 through 3.14, so the few things the standard
+library grew in between live here instead of behind version checks at each use.
+"""
+
+from __future__ import annotations
+
+import sys
+from enum import Enum
+
+if sys.version_info >= (3, 11):
+    from builtins import BaseExceptionGroup, ExceptionGroup
+
+    import tomllib
+else:  # pragma: no cover - the branch only the 3.10 runtime takes
+    import tomli as tomllib
+    from exceptiongroup import BaseExceptionGroup, ExceptionGroup
+
+
+__all__ = ["BaseExceptionGroup", "ExceptionGroup", "StrEnum", "tomllib"]
+
+
+class StrEnum(str, Enum):
+    """A string-valued enum, for the versions before ``enum.StrEnum``.
+
+    The standard library's version formats as its value, so ``f"{member}"`` is
+    ``"ready"`` rather than ``"Activity.READY"``; the status line and the stored
+    metadata rely on that, so every interpreter uses this class instead of the
+    standard one and the wording cannot drift with the version.
+    """
+
+    def __str__(self) -> str:
+        """Return the member's value, as ``enum.StrEnum`` does."""
+        return str(self.value)

zettcode-0.1.2/src/zettcode/app/__init__.py

@@ -0,0 +1,63 @@
+"""ZettCode's application layer, split into its interface and its agent glue.
+
+``ui`` holds what the user sees and drives: the transcript and the application
+shell. ``agent`` holds the adapter that turns agent events into transcript
+entries. This module is the facade over both, so ``from zettcode.app import
+ZettCodeApp`` keeps working for callers that do not care where it lives.
+"""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+#: Where each public name lives; read by :func:`__getattr__` on first use.
+_EXPORTS = {
+    "Entry": ".agent",
+    "Transcript": ".agent",
+    "TranscriptProjector": ".agent",
+    "TranscriptSource": ".ui",
+    "TranscriptView": ".ui",
+    "ZettCodeAgent": ".agent",
+    "ZettCodeApp": ".ui",
+    "ZettCodeRoot": ".ui",
+    "ZettCodeRuntime": ".agent",
+}
+
+
+if TYPE_CHECKING:  # pragma: no cover - for type checkers, not the runtime
+    from .agent import Entry, Transcript, TranscriptProjector, ZettCodeAgent, ZettCodeRuntime
+    from .ui import TranscriptSource, TranscriptView, ZettCodeApp, ZettCodeRoot
+
+
+def __getattr__(name: str) -> object:
+    """Import the module a public name lives in, the first time it is asked for.
+
+    This package is a facade over several subpackages, and a caller that wants
+    one name should not pay for the rest of them — the TUI alone holds the
+    widget library, the Markdown parser, the diff viewer, and the syntax
+    scanners. ``__all__`` is still the public surface.
+    """
+    try:
+        module = _EXPORTS[name]
+    except KeyError:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+    return getattr(importlib.import_module(module, __name__), name)
+
+
+def __dir__() -> list[str]:
+    """Return the names this package publishes."""
+    return sorted(__all__)
+
+
+__all__ = [
+    "Entry",
+    "Transcript",
+    "TranscriptProjector",
+    "TranscriptSource",
+    "TranscriptView",
+    "ZettCodeApp",
+    "ZettCodeAgent",
+    "ZettCodeRoot",
+    "ZettCodeRuntime",
+]

zettcode-0.1.2/src/zettcode/app/agent/__init__.py

@@ -0,0 +1,45 @@
+"""Agent-facing glue: the conversation model and the events that fill it."""
+
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+#: Where each public name lives; read by :func:`__getattr__` on first use.
+_EXPORTS = {
+    "Entry": ".transcript",
+    "Transcript": ".transcript",
+    "TranscriptProjector": ".projection",
+    "ZettCodeAgent": ".agent",
+    "ZettCodeRuntime": ".runtime",
+}
+
+
+if TYPE_CHECKING:  # pragma: no cover - for type checkers, not the runtime
+    from .agent import ZettCodeAgent
+    from .projection import TranscriptProjector
+    from .runtime import ZettCodeRuntime
+    from .transcript import Entry, Transcript
+
+
+def __getattr__(name: str) -> object:
+    """Import the module a public name lives in, the first time it is asked for.
+
+    This package is a facade over several subpackages, and a caller that wants
+    one name should not pay for the rest of them — the TUI alone holds the
+    widget library, the Markdown parser, the diff viewer, and the syntax
+    scanners. ``__all__`` is still the public surface.
+    """
+    try:
+        module = _EXPORTS[name]
+    except KeyError:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+    return getattr(importlib.import_module(module, __name__), name)
+
+
+def __dir__() -> list[str]:
+    """Return the names this package publishes."""
+    return sorted(__all__)
+
+
+__all__ = ["Entry", "Transcript", "TranscriptProjector", "ZettCodeAgent", "ZettCodeRuntime"]