PyPI - tau-coding-agent - Versions diffs - 0.1.0__py3-none-any.whl - Mend

tau-coding-agent 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (283) hide show

tau/__init__.py +0 -0
tau/agent/__init__.py +11 -0
tau/agent/prompt/__init__.py +10 -0
tau/agent/prompt/builder.py +302 -0
tau/agent/prompt/types.py +33 -0
tau/agent/service.py +369 -0
tau/agent/types.py +61 -0
tau/auth/manager.py +247 -0
tau/auth/storage.py +82 -0
tau/auth/types.py +41 -0
tau/builtins/__init__.py +4 -0
tau/builtins/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/__pycache__/__init__.cpython-314.pyc +0 -0
tau/builtins/commands/__init__.py +41 -0
tau/builtins/commands/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/commands/__pycache__/__init__.cpython-314.pyc +0 -0
tau/builtins/commands/__pycache__/clear.cpython-313.pyc +0 -0
tau/builtins/commands/__pycache__/clear.cpython-314.pyc +0 -0
tau/builtins/commands/__pycache__/compact.cpython-313.pyc +0 -0
tau/builtins/commands/__pycache__/compact.cpython-314.pyc +0 -0
tau/builtins/commands/__pycache__/reload.cpython-313.pyc +0 -0
tau/builtins/commands/__pycache__/reload.cpython-314.pyc +0 -0
tau/builtins/commands/__pycache__/session.cpython-313.pyc +0 -0
tau/builtins/commands/__pycache__/session.cpython-314.pyc +0 -0
tau/builtins/commands/clear.py +16 -0
tau/builtins/commands/compact.py +28 -0
tau/builtins/commands/reload.py +27 -0
tau/builtins/commands/session.py +19 -0
tau/builtins/extensions/footer/__init__.py +76 -0
tau/builtins/extensions/footer/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/extensions/footer/__pycache__/git.cpython-313.pyc +0 -0
tau/builtins/extensions/footer/__pycache__/model.cpython-313.pyc +0 -0
tau/builtins/extensions/footer/__pycache__/utils.cpython-313.pyc +0 -0
tau/builtins/extensions/footer/git.py +26 -0
tau/builtins/extensions/footer/model.py +69 -0
tau/builtins/extensions/footer/utils.py +44 -0
tau/builtins/extensions/header/__init__.py +18 -0
tau/builtins/extensions/header/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/models/__init__.py +0 -0
tau/builtins/models/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/models/__pycache__/text.cpython-313.pyc +0 -0
tau/builtins/models/audio.py +43 -0
tau/builtins/models/image.py +43 -0
tau/builtins/models/text.py +482 -0
tau/builtins/models/video.py +40 -0
tau/builtins/prompts/commit.md +7 -0
tau/builtins/prompts/docs.md +7 -0
tau/builtins/prompts/explain.md +7 -0
tau/builtins/prompts/fix.md +7 -0
tau/builtins/prompts/refactor.md +7 -0
tau/builtins/prompts/review.md +7 -0
tau/builtins/prompts/test.md +7 -0
tau/builtins/providers/__init__.py +0 -0
tau/builtins/providers/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/providers/__pycache__/text.cpython-313.pyc +0 -0
tau/builtins/providers/audio.py +10 -0
tau/builtins/providers/image.py +9 -0
tau/builtins/providers/text.py +33 -0
tau/builtins/providers/video.py +6 -0
tau/builtins/skills/code-review/SKILL.md +4 -0
tau/builtins/skills/debug/SKILL.md +4 -0
tau/builtins/skills/git-commit/SKILL.md +4 -0
tau/builtins/themes/dark.yaml +1 -0
tau/builtins/themes/light.yaml +46 -0
tau/builtins/tools/__init__.py +73 -0
tau/builtins/tools/__pycache__/__init__.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/__init__.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/bash.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/bash.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/edit.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/edit.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/glob.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/glob.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/grep.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/grep.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/ls.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/ls.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/read.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/read.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/terminal.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/terminal.cpython-314.pyc +0 -0
tau/builtins/tools/__pycache__/write.cpython-313.pyc +0 -0
tau/builtins/tools/__pycache__/write.cpython-314.pyc +0 -0
tau/builtins/tools/edit.py +215 -0
tau/builtins/tools/glob.py +112 -0
tau/builtins/tools/grep.py +146 -0
tau/builtins/tools/ls.py +135 -0
tau/builtins/tools/read.py +122 -0
tau/builtins/tools/terminal.py +150 -0
tau/builtins/tools/write.py +105 -0
tau/commands/__init__.py +10 -0
tau/commands/registry.py +71 -0
tau/commands/types.py +33 -0
tau/console/__init__.py +0 -0
tau/console/cli.py +266 -0
tau/console/commands/__init__.py +0 -0
tau/console/commands/auth.py +193 -0
tau/console/commands/packages.py +104 -0
tau/console/commands/update.py +76 -0
tau/core/__init__.py +0 -0
tau/core/registry.py +102 -0
tau/engine/__init__.py +47 -0
tau/engine/service.py +768 -0
tau/engine/types.py +163 -0
tau/extensions/__init__.py +28 -0
tau/extensions/api.py +928 -0
tau/extensions/context.py +462 -0
tau/extensions/events.py +70 -0
tau/extensions/loader.py +386 -0
tau/extensions/runtime.py +184 -0
tau/extensions/settings.py +137 -0
tau/hooks/__init__.py +112 -0
tau/hooks/engine.py +237 -0
tau/hooks/inference.py +21 -0
tau/hooks/runtime.py +126 -0
tau/hooks/service.py +121 -0
tau/hooks/session.py +117 -0
tau/hooks/tui.py +61 -0
tau/hooks/types.py +72 -0
tau/inference/__init__.py +180 -0
tau/inference/api/__init__.py +0 -0
tau/inference/api/audio/__init__.py +0 -0
tau/inference/api/audio/base.py +29 -0
tau/inference/api/audio/builtins.py +15 -0
tau/inference/api/audio/elevenlabs_audio.py +183 -0
tau/inference/api/audio/gemini_audio.py +95 -0
tau/inference/api/audio/openai_audio.py +159 -0
tau/inference/api/audio/registry.py +15 -0
tau/inference/api/audio/sarvam_audio.py +163 -0
tau/inference/api/audio/service.py +103 -0
tau/inference/api/audio/utils.py +47 -0
tau/inference/api/image/__init__.py +0 -0
tau/inference/api/image/base.py +17 -0
tau/inference/api/image/builtins.py +8 -0
tau/inference/api/image/gemini_image.py +77 -0
tau/inference/api/image/openai_image.py +103 -0
tau/inference/api/image/openrouter.py +144 -0
tau/inference/api/image/registry.py +15 -0
tau/inference/api/image/service.py +71 -0
tau/inference/api/registry.py +82 -0
tau/inference/api/text/__init__.py +0 -0
tau/inference/api/text/anthropic_claude_code.py +222 -0
tau/inference/api/text/anthropic_messages.py +196 -0
tau/inference/api/text/base.py +40 -0
tau/inference/api/text/builtins.py +19 -0
tau/inference/api/text/gemini_generate.py +234 -0
tau/inference/api/text/github_copilot_chat.py +172 -0
tau/inference/api/text/google_antigravity.py +522 -0
tau/inference/api/text/mistral_chat.py +284 -0
tau/inference/api/text/ollama_chat.py +200 -0
tau/inference/api/text/openai_codex_responses.py +497 -0
tau/inference/api/text/openai_completions.py +227 -0
tau/inference/api/text/openai_responses.py +235 -0
tau/inference/api/text/registry.py +50 -0
tau/inference/api/text/service.py +297 -0
tau/inference/api/text/types.py +7 -0
tau/inference/api/text/utils.py +228 -0
tau/inference/api/video/__init__.py +0 -0
tau/inference/api/video/base.py +26 -0
tau/inference/api/video/builtins.py +7 -0
tau/inference/api/video/fal_video.py +119 -0
tau/inference/api/video/openrouter_video.py +142 -0
tau/inference/api/video/registry.py +15 -0
tau/inference/api/video/service.py +72 -0
tau/inference/model/__init__.py +0 -0
tau/inference/model/registry.py +102 -0
tau/inference/model/types.py +65 -0
tau/inference/provider/__init__.py +0 -0
tau/inference/provider/oauth/__init__.py +35 -0
tau/inference/provider/oauth/anthropic_claude_code.py +286 -0
tau/inference/provider/oauth/github_copilot.py +333 -0
tau/inference/provider/oauth/google_antigravity.py +258 -0
tau/inference/provider/oauth/openai_codex.py +309 -0
tau/inference/provider/oauth/pkce.py +14 -0
tau/inference/provider/oauth/types.py +46 -0
tau/inference/provider/oauth/utils.py +154 -0
tau/inference/provider/registry.py +141 -0
tau/inference/provider/types.py +114 -0
tau/inference/types.py +549 -0
tau/inference/utils.py +219 -0
tau/message/__init__.py +0 -0
tau/message/types.py +482 -0
tau/message/utils.py +178 -0
tau/packages/__init__.py +11 -0
tau/packages/manager.py +190 -0
tau/packages/types.py +20 -0
tau/packages/utils.py +67 -0
tau/prompts/expand.py +58 -0
tau/prompts/loader.py +69 -0
tau/prompts/registry.py +45 -0
tau/prompts/types.py +24 -0
tau/rpc/__init__.py +8 -0
tau/rpc/mode.py +783 -0
tau/rpc/types.py +252 -0
tau/runtime/service.py +759 -0
tau/runtime/types.py +303 -0
tau/session/branch_summarization.py +312 -0
tau/session/compaction.py +646 -0
tau/session/manager.py +652 -0
tau/session/types.py +188 -0
tau/session/utils.py +233 -0
tau/settings/manager.py +1077 -0
tau/settings/paths.py +150 -0
tau/settings/storage.py +63 -0
tau/settings/types.py +173 -0
tau/settings/utils.py +25 -0
tau/skills/loader.py +91 -0
tau/skills/registry.py +70 -0
tau/skills/types.py +25 -0
tau/themes/loader.py +238 -0
tau/themes/registry.py +108 -0
tau/themes/types.py +19 -0
tau/tool/__init__.py +3 -0
tau/tool/registry.py +117 -0
tau/tool/render.py +21 -0
tau/tool/types.py +244 -0
tau/trust/__init__.py +13 -0
tau/trust/manager.py +80 -0
tau/trust/types.py +14 -0
tau/trust/utils.py +72 -0
tau/tui/__init__.py +54 -0
tau/tui/agent_hooks.py +346 -0
tau/tui/ansi.py +330 -0
tau/tui/app.py +540 -0
tau/tui/autocomplete.py +33 -0
tau/tui/capabilities.py +119 -0
tau/tui/commands/__init__.py +3 -0
tau/tui/commands/appearance.py +498 -0
tau/tui/commands/auth.py +232 -0
tau/tui/commands/context.py +38 -0
tau/tui/commands/misc.py +82 -0
tau/tui/commands/model.py +118 -0
tau/tui/commands/session.py +464 -0
tau/tui/component.py +268 -0
tau/tui/components/__init__.py +0 -0
tau/tui/components/autocomplete_manager.py +267 -0
tau/tui/components/autocomplete_picker.py +143 -0
tau/tui/components/box.py +90 -0
tau/tui/components/command_palette.py +144 -0
tau/tui/components/dynamic_border.py +19 -0
tau/tui/components/file_picker.py +233 -0
tau/tui/components/image.py +181 -0
tau/tui/components/inline_selector.py +71 -0
tau/tui/components/layout.py +1194 -0
tau/tui/components/message_list.py +692 -0
tau/tui/components/modal.py +97 -0
tau/tui/components/model_palette.py +204 -0
tau/tui/components/picker_overlay.py +174 -0
tau/tui/components/prompt_overlay.py +236 -0
tau/tui/components/resume_modal.py +372 -0
tau/tui/components/select_list.py +222 -0
tau/tui/components/settings_modal.py +274 -0
tau/tui/components/settings_schema.py +203 -0
tau/tui/components/spinner.py +119 -0
tau/tui/components/text_input.py +396 -0
tau/tui/components/text_prompt.py +82 -0
tau/tui/components/tree_select_list.py +580 -0
tau/tui/components/trust_screen.py +97 -0
tau/tui/diff.py +114 -0
tau/tui/fuzzy.py +99 -0
tau/tui/input.py +496 -0
tau/tui/input_handler.py +716 -0
tau/tui/keybindings.py +87 -0
tau/tui/markdown.py +286 -0
tau/tui/message_renderers.py +31 -0
tau/tui/overlay.py +326 -0
tau/tui/renderer.py +378 -0
tau/tui/terminal.py +499 -0
tau/tui/theme.py +148 -0
tau/tui/tui.py +544 -0
tau/tui/ui_context.py +768 -0
tau/tui/utils.py +20 -0
tau/utils/__init__.py +0 -0
tau/utils/http_proxy.py +221 -0
tau/utils/image_processing.py +172 -0
tau/utils/secrets.py +59 -0
tau/utils/version_check.py +60 -0
tau_coding_agent-0.1.0.dist-info/METADATA +177 -0
tau_coding_agent-0.1.0.dist-info/RECORD +283 -0
tau_coding_agent-0.1.0.dist-info/WHEEL +5 -0
tau_coding_agent-0.1.0.dist-info/entry_points.txt +2 -0
tau_coding_agent-0.1.0.dist-info/licenses/LICENSE +21 -0
tau_coding_agent-0.1.0.dist-info/top_level.txt +1 -0

tau/inference/provider/oauth/utils.py ADDED Viewed

@@ -0,0 +1,154 @@
+"""Shared utilities for PKCE + local-callback OAuth flows."""
+from __future__ import annotations
+import asyncio
+import urllib.parse
+from typing import Optional
+from tau.inference.provider.oauth.types import OAuthLoginCallbacks
+__all__ = [
+    "OAUTH_SUCCESS_HTML",
+    "OAUTH_ERROR_HTML",
+    "parse_authorization_input",
+    "start_oauth_callback_server",
+    "await_oauth_code",
+]
+OAUTH_SUCCESS_HTML = b"""<!DOCTYPE html><html><head><title>Auth complete</title></head><body>
+<h2>Authentication successful!</h2>
+<p>You can close this window and return to the application.</p>
+</body></html>"""
+OAUTH_ERROR_HTML = b"""<!DOCTYPE html><html><head><title>Auth failed</title></head><body>
+<h2>Authentication failed</h2>
+<p>An error occurred. Please try again.</p>
+</body></html>"""
+def parse_authorization_input(value: str) -> tuple[Optional[str], Optional[str]]:
+    """Parse (code, state) from a redirect URL, raw query string, or bare code."""
+    value = value.strip()
+    if not value:
+        return None, None
+    try:
+        parsed = urllib.parse.urlparse(value)
+        if parsed.scheme in ("http", "https"):
+            params = urllib.parse.parse_qs(parsed.query)
+            return params.get("code", [None])[0], params.get("state", [None])[0]
+    except Exception:
+        pass
+    if "#" in value:
+        code, state = value.split("#", 1)
+        return code or None, state or None
+    if "code=" in value:
+        params = urllib.parse.parse_qs(value)
+        return params.get("code", [None])[0], params.get("state", [None])[0]
+    return value, None
+async def start_oauth_callback_server(
+    callback_path: str,
+    expected_state: str,
+    host: Optional[str],
+    port: int,
+) -> tuple[asyncio.Server, asyncio.Future[str]]:
+    """Start a minimal HTTP server that captures the OAuth authorization code."""
+    loop = asyncio.get_running_loop()
+    code_future: asyncio.Future[str] = loop.create_future()
+    async def _handle(reader: asyncio.StreamReader, writer: asyncio.StreamWriter) -> None:
+        try:
+            raw = await reader.read(4096)
+            line = raw.decode(errors="replace").split("\r\n")[0]
+            parts = line.split(" ")
+            if len(parts) < 2:
+                writer.write(b"HTTP/1.1 400 Bad Request\r\n\r\n")
+                await writer.drain()
+                return
+            parsed = urllib.parse.urlparse(parts[1])
+            params = urllib.parse.parse_qs(parsed.query)
+            if parsed.path == callback_path:
+                recv_state = params.get("state", [None])[0]
+                code = params.get("code", [None])[0]
+                error = params.get("error", [None])[0]
+                if error:
+                    writer.write(
+                        b"HTTP/1.1 400 Bad Request\r\nContent-Type: text/html; charset=utf-8\r\n\r\n"
+                        + OAUTH_ERROR_HTML
+                    )
+                elif recv_state == expected_state and code:
+                    writer.write(
+                        b"HTTP/1.1 200 OK\r\nContent-Type: text/html; charset=utf-8\r\n\r\n"
+                        + OAUTH_SUCCESS_HTML
+                    )
+                    if not code_future.done():
+                        code_future.set_result(code)
+                else:
+                    writer.write(
+                        b"HTTP/1.1 400 Bad Request\r\nContent-Type: text/html; charset=utf-8\r\n\r\n"
+                        + OAUTH_ERROR_HTML
+                    )
+            else:
+                writer.write(b"HTTP/1.1 404 Not Found\r\n\r\n")
+            await writer.drain()
+        except Exception:
+            pass
+        finally:
+            writer.close()
+            await writer.wait_closed()
+    server = await asyncio.start_server(_handle, host, port)
+    return server, code_future
+async def await_oauth_code(
+    code_future: asyncio.Future[str],
+    state: str,
+    server: asyncio.Server,
+    callbacks: OAuthLoginCallbacks,
+) -> tuple[Optional[str], Optional[str]]:
+    """Race browser callback vs manual paste; close the server either way.
+    Returns (code, recv_state). recv_state falls back to state when the browser
+    callback wins (the state was already validated by the server handler).
+    """
+    code: Optional[str] = None
+    recv_state: Optional[str] = None
+    try:
+        if callbacks.on_manual_code_input:
+            browser_task = asyncio.ensure_future(code_future)
+            manual_task = asyncio.ensure_future(callbacks.on_manual_code_input())
+            done, pending = await asyncio.wait(
+                [browser_task, manual_task],
+                timeout=300,
+                return_when=asyncio.FIRST_COMPLETED,
+            )
+            for task in pending:
+                task.cancel()
+            await asyncio.gather(*pending, return_exceptions=True)
+            if browser_task in done and not browser_task.cancelled() and browser_task.exception() is None:
+                code = browser_task.result()
+                recv_state = state
+            elif manual_task in done and not manual_task.cancelled() and manual_task.exception() is None:
+                raw = manual_task.result()
+                parsed_code, parsed_state = parse_authorization_input(raw)
+                if parsed_state and parsed_state != state:
+                    raise ValueError("OAuth state mismatch")
+                code = parsed_code
+                recv_state = parsed_state or state
+        else:
+            try:
+                code = await asyncio.wait_for(asyncio.shield(code_future), timeout=300)
+                recv_state = state
+            except asyncio.TimeoutError:
+                pass
+    finally:
+        server.close()
+        await server.wait_closed()
+    return code, recv_state

tau/inference/provider/registry.py ADDED Viewed

@@ -0,0 +1,141 @@
+from __future__ import annotations
+from typing import Generic, TypeVar
+from tau.inference.provider.types import APIProvider, OAuthProvider, ImageProvider, AudioProvider, VideoProvider, AuthType
+TextProvider = APIProvider | OAuthProvider
+_T = TypeVar("_T")
+class _ProviderRegistryBase(Generic[_T]):
+    """Internal shared base for all provider sub-registries."""
+    def __init__(self) -> None:
+        self._providers: dict[str, _T] = {}
+    def _key(self, _provider: _T) -> str:
+        raise NotImplementedError
+    def register(self, provider: _T) -> None:
+        self._providers[self._key(provider)] = provider
+    def unregister(self, key: str) -> None:
+        self._providers.pop(key, None)
+    def list(self) -> list[_T]:
+        return list(self._providers.values())
+    def get(self, key: str) -> _T | None:
+        return self._providers.get(key)
+    def reset(self) -> None:
+        self._providers.clear()
+class TextProviderRegistry(_ProviderRegistryBase[TextProvider]):
+    """Registry mapping provider IDs to text-LLM provider instances."""
+    def _key(self, provider: TextProvider) -> str:
+        return provider.id
+    def is_using_oauth(self, provider: str) -> bool:
+        """Return True if the named provider uses OAuth auth; raise ValueError if unknown."""
+        if p := self.get(provider):
+            return p.auth_type == AuthType.OAuth
+        raise ValueError(f"Provider '{provider}' not found.")
+    def get_oauth_providers(self) -> list[OAuthProvider]:
+        """Return all registered OAuth-authenticated providers."""
+        return [p for p in self._providers.values() if isinstance(p, OAuthProvider)]
+    def get_api_providers(self) -> list[APIProvider]:
+        """Return all registered API-key-authenticated providers."""
+        return [p for p in self._providers.values() if isinstance(p, APIProvider)]
+    def get_oauth_provider(self, provider: str) -> OAuthProvider | None:
+        """Return the named provider only if it is an OAuthProvider."""
+        p = self.get(provider)
+        return p if isinstance(p, OAuthProvider) else None
+    def get_api_provider(self, provider: str) -> APIProvider | None:
+        """Return the named provider only if it is an APIProvider."""
+        p = self.get(provider)
+        return p if isinstance(p, APIProvider) else None
+    @classmethod
+    def from_builtins(cls) -> TextProviderRegistry:
+        from tau.builtins.providers.text import providers
+        instance = cls()
+        for provider in providers:
+            instance.register(provider)
+        return instance
+class ImageProviderRegistry(_ProviderRegistryBase[ImageProvider]):
+    """Registry mapping provider names to image-generation provider instances."""
+    def _key(self, provider: ImageProvider) -> str:
+        return provider.name
+    @classmethod
+    def from_builtins(cls) -> ImageProviderRegistry:
+        from tau.builtins.providers.image import providers
+        instance = cls()
+        for provider in providers:
+            instance.register(provider)
+        return instance
+class AudioProviderRegistry(_ProviderRegistryBase[AudioProvider]):
+    """Registry mapping provider names to audio (STT/TTS) provider instances."""
+    def _key(self, provider: AudioProvider) -> str:
+        return provider.name
+    @classmethod
+    def from_builtins(cls) -> AudioProviderRegistry:
+        from tau.builtins.providers.audio import providers
+        instance = cls()
+        for provider in providers:
+            instance.register(provider)
+        return instance
+class VideoProviderRegistry(_ProviderRegistryBase[VideoProvider]):
+    """Registry mapping provider names to video-generation provider instances."""
+    def _key(self, provider: VideoProvider) -> str:
+        return provider.name
+    @classmethod
+    def from_builtins(cls) -> VideoProviderRegistry:
+        from tau.builtins.providers.video import providers
+        instance = cls()
+        for provider in providers:
+            instance.register(provider)
+        return instance
+class ProviderRegistry:
+    """Unified registry holding all provider types (text, image, audio, video)."""
+    def __init__(
+        self,
+        text: TextProviderRegistry | None = None,
+        image: ImageProviderRegistry | None = None,
+        audio: AudioProviderRegistry | None = None,
+        video: VideoProviderRegistry | None = None,
+    ) -> None:
+        self.text = text or TextProviderRegistry()
+        self.image = image or ImageProviderRegistry()
+        self.audio = audio or AudioProviderRegistry()
+        self.video = video or VideoProviderRegistry()
+    @classmethod
+    def from_builtins(cls) -> ProviderRegistry:
+        return cls(
+            text=TextProviderRegistry.from_builtins(),
+            image=ImageProviderRegistry.from_builtins(),
+            audio=AudioProviderRegistry.from_builtins(),
+            video=VideoProviderRegistry.from_builtins(),
+        )

tau/inference/provider/types.py ADDED Viewed

@@ -0,0 +1,114 @@
+from __future__ import annotations
+import time
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from typing import Optional, Type, Union, TYPE_CHECKING
+from tau.inference.types import AuthType, LLMOptions, Transport
+if TYPE_CHECKING:
+    from tau.inference.api.text.base import BaseLLMAPI
+    from tau.inference.provider.oauth.types import OAuthCredential, OAuthLoginCallbacks, AbortSignal
+__all__ = ["AuthType", "APIProvider", "OAuthProvider", "ImageProvider", "AudioProvider", "VideoProvider"]
+@dataclass
+class OAuthProvider(ABC):
+    """Base for providers that authenticate via OAuth rather than a static API key."""
+    id: str
+    name: str
+    auth_type: AuthType = AuthType.OAuth
+    uses_callback_server: bool = False
+    @property
+    @abstractmethod
+    def api(self) -> Type["BaseLLMAPI"]:
+        """Return the LLM API class for this provider."""
+        ...
+    @abstractmethod
+    async def login(self, callbacks: "OAuthLoginCallbacks") -> "OAuthCredential":
+        """Authenticate with the provider and return a credential."""
+        ...
+    @abstractmethod
+    async def refresh_token(self, credential: "OAuthCredential", signal: Optional["AbortSignal"] = None) -> "OAuthCredential":
+        """Refresh an expired credential."""
+        ...
+    @abstractmethod
+    async def logout(self, credential: "OAuthCredential") -> None:
+        """Revoke the credential and clean up."""
+        ...
+    def get_api_key(self, credential: "OAuthCredential") -> str:
+        """Return the access token as the Bearer key for API calls."""
+        return credential.access
+    @abstractmethod
+    async def validate(self, credential: "OAuthCredential", signal: Optional["AbortSignal"] = None) -> bool:
+        """Check if the credential is valid (not necessarily fresh)."""
+        ...
+    def is_expired(self, credential: "OAuthCredential") -> bool:
+        """Return True if the token expires within the next 30 seconds."""
+        # 30-second buffer prevents using a token that expires mid-request
+        return int(time.time() * 1000) + 30_000 >= credential.expires
+    async def ensure_fresh(self, credential: "OAuthCredential", signal: Optional["AbortSignal"] = None) -> "OAuthCredential":
+        """Return a valid credential, transparently refreshing if expired."""
+        if self.is_expired(credential):
+            return await self.refresh_token(credential=credential, signal=signal)
+        return credential
+@dataclass
+class APIProvider:
+    """Provider that authenticates with a static API key stored in LLMOptions."""
+    id: str
+    name: str
+    api: Union[str, Type["BaseLLMAPI"]]
+    options: LLMOptions
+    auth_type: AuthType = AuthType.ApiKey
+    def get_api_key(self) -> Optional[str]:
+        """Return the configured API key, or None if not set."""
+        return self.options.api_key
+    def get_base_url(self) -> Optional[str]:
+        """Return the configured base URL override, or None to use the default."""
+        return self.options.base_url
+@dataclass
+class ImageProvider:
+    """Provider descriptor for image generation APIs."""
+    name: str
+    api: str
+    base_url: str
+    auth_type: AuthType = AuthType.ApiKey
+@dataclass
+class AudioProvider:
+    """Provider descriptor for speech-to-text and text-to-speech APIs."""
+    name: str
+    api: str
+    base_url: Optional[str] = None
+    auth_type: AuthType = AuthType.ApiKey
+@dataclass
+class VideoProvider:
+    """Provider descriptor for video generation APIs."""
+    name: str
+    api: str
+    base_url: Optional[str] = None
+    auth_type: AuthType = AuthType.ApiKey