tau-coding-agent 0.4.7__tar.gz → 0.5.0__tar.gz

{tau_coding_agent-0.4.7/tau_coding_agent.egg-info → tau_coding_agent-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tau-coding-agent
-Version: 0.4.7
+Version: 0.5.0
 Summary: A self-extensible agent CLI with terminal UI, multi-provider LLM support, session management with branching, and a plugin system for tools and commands
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -29,6 +29,7 @@ Requires-Dist: grapheme==0.6.0
 Requires-Dist: arrow==1.4.0
 Provides-Extra: tools
 Requires-Dist: ripgrep>=14.0.0; extra == "tools"
+Requires-Dist: ast-grep-cli>=0.44.0; extra == "tools"
 Dynamic: license-file
 
 # Tau (τ)
@@ -74,7 +75,7 @@ tau                                           # Interactive mode
 tau --resume                                  # Resume most recent session
 tau --model claude-sonnet-4-6                 # Use specific model
 tau --print "Summarize this repo"             # One-shot mode
-tau -p anthropic --print "Explain this code"  # Print mode with provider
+tau --provider anthropic --print "Explain this code"  # Print mode with provider
 tau --mode rpc                                # RPC mode for IDE extensions
 ```
 
@@ -82,13 +83,13 @@ tau --mode rpc                                # RPC mode for IDE extensions
 
 ## Features
 
-- **Multi-provider LLM support** — Anthropic Claude, OpenAI GPT, Google Gemini, Mistral AI, Ollama, Azure OpenAI
+- **Multi-provider LLM support** — Anthropic, OpenAI, Google Gemini, Mistral AI, Ollama, Groq, xAI, AWS Bedrock, OpenRouter, Z.ai, and more
 - **Terminal UI** — Built-in chat interface with syntax highlighting, markdown rendering, and keyboard navigation
 - **Rich media support** — Work with text files, images, audio files, and video files via file references or clipboard input
 - **Session management** — Persistent sessions with branching, forking, and resuming capabilities
-- **Tool execution** — Built-in tools (terminal, file I/O, web fetch) with sandboxed execution and extensibility
+- **Tool execution** — Built-in tools (terminal, file I/O, search) with full user permissions and extensibility
 - **Plugin system** — Add custom tools, slash commands, hooks, themes, and skills without modifying core code
-- **16 built-in themes** — Dark and light themes including dracula, nord, gruvbox, catppuccin, ayu-dark, tokyo-night, rose-pine, and more
+- **Themes** — Dark and light base themes, customizable and extensible via YAML
 - **Context management** — Automatic context compaction and branch summarization for long conversations
 - **Python API** — Embed Tau in your own applications programmatically
 - **Multiple run modes** — Interactive TUI, print mode (one-shot), JSON event stream, and JSON-RPC for IDE integration
@@ -173,7 +174,7 @@ See [SECURITY.md](SECURITY.md) for detailed practices and vulnerability reportin
 ```bash
 python -m pytest              # Run tests
 pyright tau/                   # Type checking
-python -m tau --mode tui       # Launch from source
+python -m tau                  # Launch from source
 ```
 
 See [Development Setup](docs/development.md) for detailed instructions.

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/README.md

@@ -41,7 +41,7 @@ tau                                           # Interactive mode
 tau --resume                                  # Resume most recent session
 tau --model claude-sonnet-4-6                 # Use specific model
 tau --print "Summarize this repo"             # One-shot mode
-tau -p anthropic --print "Explain this code"  # Print mode with provider
+tau --provider anthropic --print "Explain this code"  # Print mode with provider
 tau --mode rpc                                # RPC mode for IDE extensions
 ```
 
@@ -49,13 +49,13 @@ tau --mode rpc                                # RPC mode for IDE extensions
 
 ## Features
 
-- **Multi-provider LLM support** — Anthropic Claude, OpenAI GPT, Google Gemini, Mistral AI, Ollama, Azure OpenAI
+- **Multi-provider LLM support** — Anthropic, OpenAI, Google Gemini, Mistral AI, Ollama, Groq, xAI, AWS Bedrock, OpenRouter, Z.ai, and more
 - **Terminal UI** — Built-in chat interface with syntax highlighting, markdown rendering, and keyboard navigation
 - **Rich media support** — Work with text files, images, audio files, and video files via file references or clipboard input
 - **Session management** — Persistent sessions with branching, forking, and resuming capabilities
-- **Tool execution** — Built-in tools (terminal, file I/O, web fetch) with sandboxed execution and extensibility
+- **Tool execution** — Built-in tools (terminal, file I/O, search) with full user permissions and extensibility
 - **Plugin system** — Add custom tools, slash commands, hooks, themes, and skills without modifying core code
-- **16 built-in themes** — Dark and light themes including dracula, nord, gruvbox, catppuccin, ayu-dark, tokyo-night, rose-pine, and more
+- **Themes** — Dark and light base themes, customizable and extensible via YAML
 - **Context management** — Automatic context compaction and branch summarization for long conversations
 - **Python API** — Embed Tau in your own applications programmatically
 - **Multiple run modes** — Interactive TUI, print mode (one-shot), JSON event stream, and JSON-RPC for IDE integration
@@ -140,7 +140,7 @@ See [SECURITY.md](SECURITY.md) for detailed practices and vulnerability reportin
 ```bash
 python -m pytest              # Run tests
 pyright tau/                   # Type checking
-python -m tau --mode tui       # Launch from source
+python -m tau                  # Launch from source
 ```
 
 See [Development Setup](docs/development.md) for detailed instructions.

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/architecture.md

@@ -183,8 +183,9 @@ Extensions can react to lifecycle events:
 - `session_start` - Session begins
 - `turn_start` - New inference turn starts
 - `turn_end` - Turn completes (before rendering)
-- `tool_execute` - Tool is about to execute
-- `tool_complete` - Tool execution finished
+- `tool_call` - Tool call can be inspected, rewritten, or blocked
+- `tool_result` - Tool result can be inspected or rewritten
+- `tool_execution_start` / `tool_execution_end` - Tool handler lifecycle
 - `tui_ready` - TUI is ready for input
 - `tui_exit` - TUI is exiting
 - `compaction_start` - Compaction begins
@@ -194,12 +195,13 @@ Hooks allow extensions to inspect state, modify messages, or react to events.
 
 ## Provider Abstraction
 
-All LLM providers (Anthropic, OpenAI, Google, Mistral, Ollama, Azure) implement a common interface:
+Providers describe authentication, endpoints, and the API adapter used for a
+request. Adapters stream normalized `LLMEvent` objects:
 
 ```python
-class Provider:
-    async def call(messages, tools, model) -> Response
-    async def stream(messages, tools, model) -> AsyncIterator[Event]
+class BaseAPI:
+    async def stream(self, context, model, options) -> AsyncIterator[LLMEvent]:
+        ...
 ```
 
 The inference module handles provider-specific details (API keys, endpoints, format conversions).
@@ -217,7 +219,7 @@ Tools are executed in a sandboxed environment:
 6. Result is serialized and added to context
 ```
 
-Built-in tools (bash, read, write, edit, glob, grep, ls) are enabled by default.
+Built-in tools (terminal, read, write, edit, glob, grep, ls) are enabled by default.
 `RuntimeConfig` can allow or exclude tools by name. Custom tools are registered
 via extensions or passed directly to the runtime.
 
@@ -289,9 +291,9 @@ React to lifecycle events:
 
 ```python
 def register(tau):
-    async def on_tool_complete(event):
+    async def on_tool_end(event, ctx):
         print(f"Tool {event.tool_name} finished")
-    tau.on_hook("tool_complete", on_tool_complete)
+    tau.on("tool_execution_end", on_tool_end)
 ```
 
 ### Dialogs

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/auth.md

@@ -6,7 +6,7 @@ Tau stores credentials for LLM providers in `~/.tau/auth.json`. This page explai
 
 For each provider, tau resolves credentials in this order:
 
-1. **Runtime override** — set via `--api-key` on the CLI (not persisted)
+1. **Runtime override** — set programmatically through `AuthManager` (not persisted)
 2. **Stored credential** — read from `~/.tau/auth.json`
 3. **Environment variable** — `{PROVIDER}_API_KEY` (e.g. `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`)
 
@@ -69,13 +69,11 @@ export OPENAI_API_KEY="sk-..."
 
 No file is needed — tau picks these up automatically.
 
-### CLI flag (one-off override)
+### Runtime override
 
-```bash
-tau --api-key sk-ant-...
-```
-
-Not stored. Only applies to the current session.
+Embedding applications may call
+`auth_manager.set_runtime_api_key(provider, key)`. The main Tau CLI does not
+provide an `--api-key` flag.
 
 ### Auth file (direct edit)
 
@@ -91,7 +89,9 @@ Run `/login` from within a session. Tau asks which authentication type to use:
 
 ### `/logout` command
 
-Run `/logout` to open a list of providers that have credentials stored in `~/.tau/auth.json`. Select one to remove it. Environment variables and CLI `--api-key` flags are unaffected.
+Run `/logout` to open a list of providers that have credentials stored in
+`~/.tau/auth.json`. Select one to remove it. Environment variables and
+programmatic runtime overrides are unaffected.
 
 ## Auth File Format
 
@@ -120,7 +120,7 @@ From Python (e.g. in an extension):
 status = auth_manager.get_auth_status("anthropic")
 # status.configured  → True / False
 # status.source      → "stored" | "runtime" | "env" | None
-# status.label       → env var name or "--api-key" if runtime
+# status.label       → env var name or "runtime override"
 ```
 
 ## Security

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/cli-reference.md

@@ -3,7 +3,7 @@
 ## Usage
 
 ```bash
-tau [OPTIONS] [MESSAGE]
+tau [OPTIONS] COMMAND [ARGS]...
 ```
 
 Use `--prompt TEXT` for a non-interactive prompt. Piped stdin can supply or
@@ -13,14 +13,20 @@ augment it.
 
 | Option | Short | Description |
 |--------|-------|-------------|
+| `--version` | `-v` | Print the installed version |
+| `--debug` | `-d` | Enable debug logging |
+| `--cwd PATH` | `-c` | Set the working directory |
 | `--prompt` | `-p` | Run a non-interactive prompt |
+| `--output-format` | `-f` | Non-interactive output: `text` or `json` |
+| `--quiet` | `-q` | Hide the non-interactive spinner |
 | `--provider` | | Provider to use, e.g. `anthropic`, `openai`, `groq` |
 | `--model` | | Model ID, or `provider/model` shorthand (e.g. `groq/llama-3.3-70b-versatile`) |
-| `--theme` | `-t` | UI theme: `default`, `dracula`, `nord`, `gruvbox`, `catppuccin`, `ayu-dark`, `everforest`, `horizon`, `kanagawa`, `material-ocean`, `monokai`, `night-owl`, `one-dark`, `rose-pine`, `solarized-dark`, `tokyo-night`, or a custom name |
+| `--theme` | `-t` | UI theme: `dark`, `light`, or an installed custom theme |
 | `--resume [ID]` | `-r` | Resume the most recent or a specified session |
 | `--fork ID` | | Fork a specified session at startup |
 | `--session-dir PATH` | | Override session storage |
 | `--name NAME` | | Set the session display name at startup |
+| `--system TEXT` | `-s` | Replace the generated system prompt |
 | `--ephemeral` | `-e` | Don't save this session to disk |
 | `--approve` | `-a` | Trust project-local files (extensions, settings, context files) for this run |
 | `--no-approve` | `-na` | Don't trust project-local files for this run |
@@ -66,7 +72,7 @@ that order.
 Emit a JSON event stream on stdout:
 
 ```bash
-tau --mode json "Your prompt"
+tau --mode json --prompt "Your prompt"
 ```
 
 Each line is a JSON object representing a lifecycle event (`agent_start`, `message_end`, etc.).
@@ -200,8 +206,8 @@ Events do **not** have an `id` field. Only responses do.
 
 | Command | Key fields | Description |
 |---------|-----------|-------------|
-| `bash` | `command` (required), `excludeFromContext?` | Run a shell command; output is added to the next LLM context |
-| `abort_bash` | — | Abort a running bash subprocess |
+| `terminal` | `command` (required), `excludeFromContext?` | Run a shell command; output is added to the next LLM context |
+| `abort_terminal` | — | Abort a running terminal subprocess |
 
 ##### Session
 
@@ -345,8 +351,7 @@ An explicit `--provider` always overrides the inferred provider.
 
 ```bash
 tau --resume                                    # continue most recent session
-tau --session abc123                            # resume by session ID
-tau --session ~/.tau/sessions/proj/file.jsonl   # resume by file path
+tau --resume abc123                             # resume by session ID
 tau --ephemeral                                 # temporary session, nothing saved
 ```
 
@@ -360,13 +365,16 @@ Manage provider credentials.
 tau auth --help
 ```
 
+Package management is available through `tau install`, `tau remove`,
+`tau list`, and `tau update`.
+
 ## Environment Variables
 
 | Variable | Effect |
 |----------|--------|
 | `ANTHROPIC_API_KEY` | Anthropic API key |
 | `OPENAI_API_KEY` | OpenAI API key |
-| `GEMINI_API_KEY` | Google Gemini key |
+| `GOOGLE_API_KEY` | Google Gemini key |
 | `<PROVIDER>_API_KEY` | API key for any provider (uppercased provider name) |
 
 Provider and model can also be set permanently in `settings.json` — see [Settings](settings.md).

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/development.md

@@ -4,15 +4,15 @@ This page covers setting up a development environment for tau.
 
 ## Prerequisites
 
-- Python 3.13 or higher
+- Python 3.12 or higher
 - git
 - pip or uv (Python package manager)
 
 ## Clone the Repository
 
 ```bash
-git clone https://github.com/yourusername/tau.git
-cd tau
+git clone https://github.com/Jeomon/Tau.git
+cd Tau
 ```
 
 ## Install Dependencies
@@ -63,7 +63,7 @@ tau --theme dark
 ### Run with Debug Logging
 
 ```bash
-TAU_LOG_LEVEL=DEBUG tau
+tau --debug
 ```
 
 ### Run Tests
@@ -128,40 +128,30 @@ ruff format tau/
 4. Test manually:
    ```bash
    tau -p "test prompt"
-   tau --list-models
    ```
 
 ## Testing
 
 ### Test Structure
 
-Tests are organized by module:
+Tests are organized by module, with granular filenames per submodule:
 
 ```text
 tests/
-├── test_agent.py
-├── test_inference.py
-├── test_engine.py
-└── test_tui.py
+├── test_agent_compaction.py
+├── test_agent_prompt.py
+├── test_agent_types.py
+├── test_inference_dialect.py
+├── test_inference_types.py
+├── test_engine_execution.py
+├── test_engine_steering.py
+├── test_tui_renderer.py
+└── ...
 ```
 
 ### Writing Tests
 
-Use pytest:
-
-```python
-import pytest
-from tau.agent import Agent
-
-def test_agent_creation():
-    agent = Agent(client=MockClient())
-    assert agent is not None
-
-def test_agent_run():
-    agent = Agent(client=MockClient())
-    result = agent.run("test prompt")
-    assert "result" in result.lower()
-```
+Use pytest, following the existing patterns in `tests/`.
 
 ### Running Tests
 
@@ -172,11 +162,8 @@ python -m pytest
 # Run with verbose output
 python -m pytest -v
 
-# Run with coverage
-python -m pytest --cov=tau
-
-# Run specific test file
-python -m pytest tests/test_agent.py
+# Run a specific module's tests
+python -m pytest tests/test_agent_compaction.py
 ```
 
 ## Debugging
@@ -215,7 +202,7 @@ logger.error("Error message")
 Enable debug logging:
 
 ```bash
-TAU_LOG_LEVEL=DEBUG tau
+tau --debug
 ```
 
 ## IDE Setup

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/docs.json

@@ -61,6 +61,10 @@
           "title": "Extensions",
           "path": "extensions.md"
         },
+        {
+          "title": "Extension Settings",
+          "path": "extension-settings.md"
+        },
         {
           "title": "Themes",
           "path": "themes.md"
@@ -80,6 +84,10 @@
         {
           "title": "Authentication",
           "path": "auth.md"
+        },
+        {
+          "title": "HTTP Proxy",
+          "path": "http-proxy.md"
         }
       ]
     },

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/extension-settings.md

@@ -445,7 +445,7 @@ Use the explicit `group` type when you want the sub-panel to have a header label
 #### Basic example
 
 ```python
-from tau.tui.components.settings_modal import SettingItem
+from tau.modes.interactive.components.settings_selector import SettingItem
 
 def register(tau):
     def on_change(key, value):

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/extensions.md

@@ -656,6 +656,19 @@ def register(tau):
 
 ## Keyboard shortcuts
 
+`register_shortcut` takes a literal key combination. Tau compares extension
+shortcuts with the effective `KeyMap`.
+Safety-critical editor and application bindings are reserved and cannot be
+replaced by extensions. An extension may replace a non-reserved global
+application binding, with a warning. If multiple extensions register the same
+key, the last loaded extension wins and Tau reports a warning.
+
+Some low-level editor operations that are not exposed as `KeyMap` actions,
+such as cursor movement, are still consumed directly by the focused editor.
+Registering an extension shortcut does not replace those operations. See
+[Customising keybindings](keybindings.md#customising-keybindings) for the
+available actions.
+
 ```python
 def register(tau):
     @tau.register_shortcut("ctrl+g", "Open greeter")
@@ -844,7 +857,7 @@ def register(tau):
 | `tau.register_tool(tool)` | Add a tool the agent can call |
 | `tau.register_command(name, desc, handler, aliases=[], get_argument_completions=None, argument_hint=None, requires_idle=True)` | Add a `/name` slash command; set `requires_idle=False` only for UI-only or read-only handlers safe during an active turn |
 | `tau.on(event, handler)` / `@tau.on(event)` | Subscribe to a lifecycle event |
-| `tau.register_shortcut(key, desc, handler)` | Bind a keyboard shortcut |
+| `tau.register_shortcut(key, desc, handler)` | Bind a literal keyboard shortcut |
 | `tau.append_prompt(text)` | Append text to the system prompt |
 | `tau.register_theme(name, theme)` | Add a named theme to the picker |
 | `tau.register_message_renderer(type, fn)` | Render custom message types in the TUI |
@@ -1315,7 +1328,7 @@ ctx.ui.paste_to_editor("@file.py ")      # insert at cursor position
 
 ```python
 names = ctx.ui.get_all_themes()          # list[str] of theme names
-ok = ctx.ui.set_theme("dracula")         # True on success, False if unknown
+ok = ctx.ui.set_theme("dark")            # True on success, False if unknown
 theme = ctx.ui.theme                     # LayoutTheme — current active theme
 ```
 

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/http-proxy.md

@@ -124,7 +124,8 @@ api_base = "https://api.example.com"
 proxies = get_proxies_for_client(api_base, settings_manager)
 headers = get_proxy_headers(settings_manager)
 
-async with httpx.AsyncClient(proxies=proxies, headers=headers) as client:
+mounts = {s: httpx.AsyncHTTPTransport(proxy=u) for s, u in proxies.items()} if proxies else None
+async with httpx.AsyncClient(mounts=mounts, headers=headers) as client:
     response = await client.get(f"{api_base}/v1/models")
 ```
 
@@ -144,7 +145,8 @@ headers = {
     **proxy_headers,  # Include custom proxy headers
 }
 
-async with httpx.AsyncClient(proxies=proxies, headers=headers) as client:
+mounts = {s: httpx.AsyncHTTPTransport(proxy=u) for s, u in proxies.items()} if proxies else None
+async with httpx.AsyncClient(mounts=mounts, headers=headers) as client:
     response = await client.get(f"{api_base}/v1/models")
 ```
 
@@ -159,9 +161,9 @@ proxy_url = get_proxy_url_for_target(api_base)
 
 client_kwargs = {}
 if proxy_url:
-    client_kwargs["proxies"] = {
-        "http://": proxy_url,
-        "https://": proxy_url,
+    client_kwargs["mounts"] = {
+        "http://": httpx.AsyncHTTPTransport(proxy=proxy_url),
+        "https://": httpx.AsyncHTTPTransport(proxy=proxy_url),
     }
 
 async with httpx.AsyncClient(**client_kwargs) as client:
@@ -334,7 +336,8 @@ from tau.utils.http_proxy import get_proxies_for_client
 import httpx
 
 proxies = get_proxies_for_client("https://api.example.com")
-async with httpx.AsyncClient(proxies=proxies) as client:
+mounts = {s: httpx.AsyncHTTPTransport(proxy=u) for s, u in proxies.items()} if proxies else None
+async with httpx.AsyncClient(mounts=mounts) as client:
     response = await client.get("...")
 ```
 
@@ -378,4 +381,4 @@ OAuth login/refresh operations (e.g., GitHub Copilot, OpenAI, Anthropic) also re
 
 - [Settings](settings.md) — Main settings reference
 - [Extensions](extensions.md) — Extensions can also use proxy settings via SettingsManager
-- [Providers](providers.md) — Model provider configuration (some may have custom proxy handling)
+- [Inference Providers](inference-providers.md) — Model provider configuration

{tau_coding_agent-0.4.7 → tau_coding_agent-0.5.0}/docs/index.md

@@ -6,7 +6,7 @@ Tau is a Python CLI framework for building interactive agent applications. It pr
 
 Tau allows you to:
 - Chat with LLMs (Claude, GPT, Gemini, Mistral, Ollama) in a terminal UI
-- Execute tools (terminal commands, read/write files, fetch web content) within conversations
+- Execute tools (terminal commands, file operations, search) within conversations
 - Save and resume sessions with branching and forking
 - Extend Tau with custom tools, commands, themes, and skills
 - Embed Tau in Python applications as a library
@@ -53,14 +53,13 @@ Tau allows you to:
 
 - [Project Structure](project-structure.md) - Codebase organization and module breakdown
 - [Development Setup](development.md) - Local development environment and testing
-- [Implementation Summary](IMPLEMENTATION_SUMMARY.md) - Recent changes and features
 
 ## Reference
 
 - [CLI Reference](cli-reference.md) - All flags, modes (interactive/print/json/rpc)
 - [Settings Reference](settings.md) - Complete settings schema
 - [Session Format](sessions.md) - JSONL file format and structure
-- [Hooks & Events](extensions.md#hooks) - All available hooks and events
+- [Hooks & Events](extensions.md#event-hooks) - All available hooks and events
 
 ---