ffwf-tau-coding-agent 0.9.2__py3-none-any.whl

ffwf_tau_coding_agent-0.9.2.dist-info/METADATA

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: ffwf-tau-coding-agent
+Version: 0.9.2
+Summary: τ-coding-agent: Interactive TUI (Textual) + CLI
+Author: Fight Fire with Fire Robotics, LLC
+License-Expression: MIT
+Project-URL: Homepage, https://ffwfrobotics.github.io/tau/
+Project-URL: Documentation, https://ffwfrobotics.github.io/tau/
+Project-URL: Repository, https://github.com/jmccardle/tau
+Project-URL: Issues, https://github.com/jmccardle/tau/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ffwf-tau-agent-core==0.9.2
+Provides-Extra: tui
+Requires-Dist: textual>=0.47; extra == "tui"
+Requires-Dist: rich; extra == "tui"
+Provides-Extra: jmfts
+Requires-Dist: ffwf-tau-jmfts==0.9.2; extra == "jmfts"
+Provides-Extra: dev
+Requires-Dist: ffwf-tau-coding-agent[jmfts,tui]==0.9.2; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy==2.1.*; extra == "dev"
+Requires-Dist: textual-dev; extra == "dev"
+Requires-Dist: pytest-textual-snapshot; extra == "dev"
+Requires-Dist: cairosvg; extra == "dev"
+Dynamic: license-file
+
+# ffwf-tau-coding-agent
+
+The interface of **Tau**, a programmable coding agent harness: the `tau`
+command, its Textual terminal UI, and the headless run paths behind `tau -p` and
+`tau --mode rpc`.
+
+Tau began as a Python port of the TypeScript project
+[pi-mono](https://github.com/badlogic/pi-mono), which is still read as the
+reference implementation when porting or debugging; it now diverges from pi
+deliberately in several places.
+
+## Install
+
+```bash
+pip install ffwf-tau-coding-agent            # headless: the CLI, `tau -p`, `--mode rpc`
+pip install 'ffwf-tau-coding-agent[tui]'     # add the interactive TUI
+```
+
+Python 3.11 or newer. Pulls in `ffwf-tau-agent-core`, and through it
+`ffwf-tau-llm`. Note the `ffwf-` prefix: `tau-llm` and `tau-ai` on PyPI are
+unrelated projects.
+
+| Extra | Adds | Needed for |
+|---|---|---|
+| `ffwf-tau-coding-agent[tui]` | `textual`, `rich` | the interactive TUI. `tau -p` runs a full turn without it |
+| `ffwf-tau-coding-agent[jmfts]` | `ffwf-tau-jmfts` | `--store jmfts` session storage |
+
+**The interface is an extra, not a base dependency.** A headless install is 15
+packages and 13 MB; adding `[tui]` makes it 27 packages and 31 MB. Both extras
+report their own absence — asking for the TUI or for `--store jmfts` without the
+matching extra fails with the install command you need, not a traceback.
+
+### Two names for one command
+
+The install puts **both `tau` and `ffwf-tau`** on your PATH. They are the same
+entry point, not a link: each is a wrapper pip owns and removes on uninstall.
+
+Type `tau`. PyPI reserves distribution names but not command names, and at least
+one unrelated project ships its own `tau`; in an environment holding both,
+whichever installed last owns the name and neither pip nor uv says a word.
+`ffwf-tau` cannot be taken, which makes it the right name inside scripts,
+systemd units, and Dockerfiles. If `tau --version` does not report τ,
+`ffwf-tau --version` will.
+
+## Run
+
+```bash
+tau                                 # interactive TUI
+tau -p "list the files here"        # headless: print a transcript, exit
+tau -p --mode json "..."            # headless: JSONL lifecycle events instead of text
+tau --mode rpc                      # drive τ as a subprocess over stdio (JSON-RPC 2.0)
+tau -e permission_gate.py           # load an extension from a path
+tau --help                          # the exact contract; treat this page as the stale one
+```
+
+`tau -p` and `tau --mode rpc` both write and resume real sessions under
+`~/.tau/sessions/`, so a headless run appears in the TUI's sidebar and can be
+picked up interactively later. `--no-session` means nothing is persisted.
+
+Flags worth knowing: `-m/--model`, `-t/--tools` and `-nt/--no-tools`,
+`-e/--extension PATH`, `--thinking {off,minimal,low,medium,high,xhigh}`,
+`-c/--continue`, `--session REF`, `--fork REF`, `--store {file,jmfts}`.
+
+## Configure
+
+On first run τ writes `~/.tau/config.json` from a default shipped inside the
+package. It holds the `models` map that `--model` resolves names against, plus
+per-extension config and the `session_store` block. A model entry names the
+provider, the base URL, and the context window, so pointing τ at a local
+OpenAI-compatible server (vLLM, llama.cpp, Ollama) is a config edit rather than
+a code change.
+
+## The TUI
+
+Built on [Textual](https://textual.textualize.io/). Streamed text renders at
+30 Hz; tool calls and their results appear as their own blocks.
+
+| Key | Action |
+|---|---|
+| `Ctrl+Enter` | send the message |
+| `Ctrl+B` | toggle the session sidebar |
+| `Ctrl+N` | new chat |
+| `Ctrl+G` | browse the conversation tree |
+| `Ctrl+Z` | roll back the last turn |
+| `Ctrl+R` / `Ctrl+T` | show or hide reasoning / tool blocks |
+| `Ctrl+E` | extensions |
+| `Ctrl+P` | command palette |
+| `Escape` | cancel the current generation |
+
+**The sidebar and the tree browser are two different things.** The sidebar picks
+*which session to open* — a flat list grouped by date. `Ctrl+G` opens a browser
+over the branch structure *inside the current conversation*, where you navigate
+to an earlier node, summarise a branch, or elide a span. Typed commands cover
+the rest: `/compact`, `/tree`, `/fork`, `/extensions`.
+
+## Why it is a separate package
+
+Everything here is presentation and process management. The agent lives in
+`ffwf-tau-agent-core`, which has no Textual dependency and never imports this
+package. `ffwf-tau-jmfts` is a peer rather than a dependency: `--store jmfts`
+imports it lazily and fails at startup if it is absent, never falling back to
+files without saying so.
+
+If you want the agent rather than the interface, use the runtime directly:
+
+```python
+import asyncio
+from tau_agent_core import create_agent_session
+
+
+async def main():
+    session = create_agent_session(model="gpt-4o", tools=["read", "bash"])
+    print(await session.prompt("What is in this directory?"))
+
+
+asyncio.run(main())
+```
+
+## Docs
+
+- `docs/tau-coding-agent.md` — design notes for this package.
+- `docs/CLI-PLAN.md` — the flag set and its status.
+- `docs/REMOTE-CONTROL.md`, `docs/RPC-PROTOCOL.md` — `--mode rpc`.
+- `docs/EXTENSIONS-WALKTHROUGH.md` — writing an extension to load with `-e`.
+
+Repository: <https://github.com/jmccardle/tau>
+
+## The rest of Tau
+
+| Distribution | Imports as | What it is |
+|---|---|---|
+| `ffwf-tau-llm` | `tau_llm` | the provider and streaming layer |
+| `ffwf-tau-agent-core` | `tau_agent_core` | the agent loop, tools, sessions, extensions |
+| `ffwf-tau-jmfts` | `tau_jmfts` | a JMFTS-backed session store |
+
+MIT © Fight Fire with Fire Robotics, LLC

ffwf_tau_coding_agent-0.9.2.dist-info/RECORD

@@ -0,0 +1,24 @@
+ffwf_tau_coding_agent-0.9.2.dist-info/licenses/LICENSE,sha256=sP7VRq7RIYzX1msY2Bg961He7KvN0iRhcMGFrE2wRVc,1091
+tau_coding_agent/__init__.py,sha256=mKx9P7iNsWDPTFe8I0KyzY_dTJ8k_FQ6cjc0j_2rFHw,971
+tau_coding_agent/app.py,sha256=VeWiR7WtgGSYM54zWt37Kwl45d6HmogVbp9i7pPAWnc,247625
+tau_coding_agent/backends.py,sha256=INPk-lfUSUZyYX-YSHoSRwP8syPpgmUhWzUSfWo7oEc,94128
+tau_coding_agent/chat_widgets.py,sha256=B5QewyNzz2xa240rXaD3McjOWGJ8j3pr2lLqr4Fy4vs,22730
+tau_coding_agent/cli.py,sha256=ZbAVhy5fIopOC6UgccLvCXvV4D5WOjA39EzfMRrVdWA,32305
+tau_coding_agent/config.py,sha256=MzuH4ZOQlJxtnCeygHCv4mDNp1BL_6N37_gqZeS56s8,4731
+tau_coding_agent/devshot.py,sha256=rAUbm20s51dYJa7Xe1feanIdRkjlIFOcvAv7Efat2QU,3621
+tau_coding_agent/headless.py,sha256=4X-qVUkbIqmPAdTpBc8DfK8pd1bg41aMCEasExsgxo8,50544
+tau_coding_agent/parley.tcss,sha256=avFVPSu1xjVsvzsuiYWCyGZ4YYcPEHNMsA4qNRA9Hgo,24561
+tau_coding_agent/rpc_mode.py,sha256=6SsasalxjiR_DFpSK_Qy6ph3h_nbtH8MIrzTBnX4n-U,22058
+tau_coding_agent/session_store.py,sha256=cCLxy6l_RDR02YJO1rOWYJC0RlPkeFnYOo6qSmbPyrY,41110
+tau_coding_agent/store_factory.py,sha256=-QCWZt4XlvrVZStrtPJaOnwQZSJxJ8l3wqQAfw4YGiE,13030
+tau_coding_agent/tagline.py,sha256=w90ysJsu56BGfpi4HD2hv7K4lyfbs9MjZP40wxG5CZQ,2819
+tau_coding_agent/tau_default_config.json,sha256=Y8H9UE24rsScX2f7CQ0Gp_8uSNsAEcyMmuz_9Qu_7qI,700
+tau_coding_agent/testing/__init__.py,sha256=8iFUd7msxkxC1Nx3qoLRX-YiPbmXONnfBbWN6N5OTzg,1269
+tau_coding_agent/testing/render.py,sha256=Uj8SxgoOcHQa0DUVT94PsM0QynGZZOR2-4RQJvWGtfE,9666
+tau_coding_agent/testing/sandbox.py,sha256=QePNu8ma1RK7smLAB-jp1BAQeEOS9Jp9p0FWwL96qdk,4191
+tau_coding_agent/testing/scenes.py,sha256=aunUkSsViah5EjvFCqF1BpPJmZrykO0TqE3eXiSV_EI,23077
+ffwf_tau_coding_agent-0.9.2.dist-info/METADATA,sha256=u6WBOaHfC_c1-0iOJKCJPto0fs5jxia1AJQzQ40TkTA,6711
+ffwf_tau_coding_agent-0.9.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ffwf_tau_coding_agent-0.9.2.dist-info/entry_points.txt,sha256=_QgIxAjOBq2pmF507q3ZgJcD3lUJspc0SVp3TYBIvfM,87
+ffwf_tau_coding_agent-0.9.2.dist-info/top_level.txt,sha256=Q5vyx1Q5e8R18rKmqSoIcuEmclaT5g2yKdrYcRU8LKs,17
+ffwf_tau_coding_agent-0.9.2.dist-info/RECORD,,

ffwf_tau_coding_agent-0.9.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ffwf_tau_coding_agent-0.9.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ffwf-tau = tau_coding_agent.cli:main
+tau = tau_coding_agent.cli:main

ffwf_tau_coding_agent-0.9.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fight Fire with Fire Robotics, LLC
+
+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.

ffwf_tau_coding_agent-0.9.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+tau_coding_agent

tau_coding_agent/__init__.py

@@ -0,0 +1,33 @@
+"""τ-coding-agent: Interactive TUI + CLI for τ-agent-core.
+
+Public API:
+- AgentSession: Re-exported from τ-agent-core
+- SessionManager: Re-exported from τ-agent-core
+- AgentEvent: Re-exported from τ-agent-core
+
+Reference: SUBPHASE-0.0.md, "AgentSession Interface" section.
+"""
+
+# This package's release version. The CLI ``--version`` flag, ``package.sh`` and
+# this distribution's own ``pyproject.toml`` (``[tool.setuptools.dynamic]``) all
+# read this literal, so the number a user sees and the number on the wheel cannot
+# disagree. The other three packages carry the same line; tests/test_packaging.py
+# holds all four against each other, because they are released in lockstep.
+__version__ = "0.9.2"
+
+from tau_agent_core import (
+    AgentSession,
+    SessionManager,
+    AgentEvent,
+    ExtensionAPI,
+    ExtensionContext,
+)
+
+__all__ = [
+    "__version__",
+    "AgentSession",
+    "SessionManager",
+    "AgentEvent",
+    "ExtensionAPI",
+    "ExtensionContext",
+]