padwan-cli 0.5.0__tar.gz → 0.6.1__tar.gz

padwan_cli-0.6.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 polarsen-io
+
+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.

padwan_cli-0.6.1/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: padwan-cli
+Version: 0.6.1
+Summary: CLI and TUI for padwan-ai
+Author-email: julien.brayere@polarsen.io
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: padwan-ai[realtime]>=0.11.1
+Requires-Dist: piou[tui]>=0.36.0
+Requires-Dist: tracktolib>=0.74.0
+Requires-Dist: padwan-ai[langfuse]>=0.11.1 ; extra == 'langfuse'
+Requires-Dist: padwan-ai[otel]>=0.11.1 ; extra == 'otel'
+Requires-Dist: opentelemetry-sdk>=1.44 ; extra == 'otel'
+Requires-Dist: opentelemetry-exporter-otlp>=1.44 ; extra == 'otel'
+Requires-Dist: sounddevice>=0.5 ; extra == 'voice'
+Requires-Python: >=3.15
+Project-URL: Homepage, https://polarsen-io.github.io/padwan-cli
+Project-URL: Source, https://github.com/polarsen-io/padwan-cli
+Project-URL: Changelog, https://github.com/polarsen-io/padwan-cli/blob/master/CHANGELOG.md
+Provides-Extra: langfuse
+Provides-Extra: otel
+Provides-Extra: voice
+Description-Content-Type: text/markdown
+
+# Padwan CLI
+
+Interactive CLI/TUI for [`padwan-ai`](https://github.com/polarsen-io/padwan-ai).
+
+> [!NOTE]
+> This is a playground for experimenting with `padwan-ai` features (streaming, agents, MCP, thinking tokens, batch jobs, realtime voice) — not a production-grade tool. Expect rough edges and breaking changes.
+
+<img alt="Chat demo" src="https://github.com/polarsen-io/padwan-cli/raw/master/docs/static/chat.gif" width="800"/>
+
+## Quick start
+
+```bash
+export OPENAI_API_KEY=...
+uvx padwan-cli
+# then /help for commands
+```
+
+
+## Install
+
+```bash
+pip install padwan-cli
+```
+
+## Local Development
+
+```bash
+uv sync --group dev
+uv run padwan-cli
+```
+
+## One-shot Mode
+
+```bash
+uvx padwan-cli "Hello" -m gpt-4o-mini
+
+# attach files (images/audio/text, routed by type)
+uvx padwan-cli "What's in this recording?" -m gpt-4o-audio-preview -f clip.mp3
+```
+
+## Voice Mode
+
+Real-time speech-to-speech chat (needs the PortAudio system lib, e.g. `libportaudio2`):
+
+```bash
+uvx --from "padwan-cli[voice]" padwan-talk
+```
+
+## Tracing
+
+Pass `--trace <backend>` (on the one-shot, `chat send`, and `talk` commands) to instrument all LLM calls with [padwan-ai's OTel GenAI telemetry](https://github.com/polarsen-io/padwan-ai/blob/master/docs/observability.md):
+
+```bash
+# Langfuse, using the standard LANGFUSE_* env vars
+export LANGFUSE_PUBLIC_KEY=... LANGFUSE_SECRET_KEY=... LANGFUSE_BASE_URL=...
+uvx --from "padwan-cli[langfuse]" padwan-cli "Hello" --trace langfuse
+
+# any OTLP collector, using the standard OTEL_EXPORTER_OTLP_* env vars
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 \
+  uvx --from "padwan-cli[otel]" padwan-cli "Hello" --trace otlp
+```
+

padwan_cli-0.6.1/README.md

@@ -0,0 +1,62 @@
+# Padwan CLI
+
+Interactive CLI/TUI for [`padwan-ai`](https://github.com/polarsen-io/padwan-ai).
+
+> [!NOTE]
+> This is a playground for experimenting with `padwan-ai` features (streaming, agents, MCP, thinking tokens, batch jobs, realtime voice) — not a production-grade tool. Expect rough edges and breaking changes.
+
+<img alt="Chat demo" src="https://github.com/polarsen-io/padwan-cli/raw/master/docs/static/chat.gif" width="800"/>
+
+## Quick start
+
+```bash
+export OPENAI_API_KEY=...
+uvx padwan-cli
+# then /help for commands
+```
+
+
+## Install
+
+```bash
+pip install padwan-cli
+```
+
+## Local Development
+
+```bash
+uv sync --group dev
+uv run padwan-cli
+```
+
+## One-shot Mode
+
+```bash
+uvx padwan-cli "Hello" -m gpt-4o-mini
+
+# attach files (images/audio/text, routed by type)
+uvx padwan-cli "What's in this recording?" -m gpt-4o-audio-preview -f clip.mp3
+```
+
+## Voice Mode
+
+Real-time speech-to-speech chat (needs the PortAudio system lib, e.g. `libportaudio2`):
+
+```bash
+uvx --from "padwan-cli[voice]" padwan-talk
+```
+
+## Tracing
+
+Pass `--trace <backend>` (on the one-shot, `chat send`, and `talk` commands) to instrument all LLM calls with [padwan-ai's OTel GenAI telemetry](https://github.com/polarsen-io/padwan-ai/blob/master/docs/observability.md):
+
+```bash
+# Langfuse, using the standard LANGFUSE_* env vars
+export LANGFUSE_PUBLIC_KEY=... LANGFUSE_SECRET_KEY=... LANGFUSE_BASE_URL=...
+uvx --from "padwan-cli[langfuse]" padwan-cli "Hello" --trace langfuse
+
+# any OTLP collector, using the standard OTEL_EXPORTER_OTLP_* env vars
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 \
+  uvx --from "padwan-cli[otel]" padwan-cli "Hello" --trace otlp
+```
+

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/__init__.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from .run import cli, main, main_tui
 
 __all__ = ("cli", "main", "main_tui")

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/batch/__init__.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from .run import batch_group
 
 __all__ = ["batch_group"]

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/batch/format.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import TYPE_CHECKING
 
 from rich.table import Table
@@ -7,7 +5,7 @@ from rich.table import Table
 from ..utils import console
 
 if TYPE_CHECKING:
-    from padwan_llm.gemini import BatchJob
+    from padwan_ai.gemini import BatchJob
 
 
 def format_job(job: BatchJob) -> None:

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/batch/run.py

@@ -1,13 +1,11 @@
-from __future__ import annotations
-
 import asyncio
 from pathlib import Path
 
 from piou import CommandGroup, Option
 from piou.tui import TuiContext, TuiOption
 
-from padwan_llm import GEMINI_MODELS
-from padwan_llm.gemini import BatchRequest, BatchResult, GeminiClient
+from padwan_ai import GEMINI_MODELS
+from padwan_ai.gemini import BatchRequest, BatchResult, GeminiClient
 from ..widgets import BatchProgressWidget, BatchResultWidget
 from .format import console, format_job, format_job_table
 from .utils import load_prompts_from_file, save_results_to_file

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/batch/utils.py

@@ -1,11 +1,9 @@
-from __future__ import annotations
-
 import csv
 import json
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from padwan_llm.gemini import BatchRequest, BatchResult
+from padwan_ai.gemini import BatchRequest, BatchResult
 
 if TYPE_CHECKING:
     from typing import Any

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/chat.py

@@ -4,13 +4,13 @@ import mimetypes
 import time
 from contextlib import contextmanager
 from pathlib import Path
-from typing import Any
+from typing import Any, cast, get_args
 
 from piou import Option, CommandGroup
 from piou.tui import PromptStyle, TuiContext, TuiOption
 from textual.css.query import NoMatches
 
-from padwan_llm import (
+from padwan_ai import (
     AgentSession,
     ContentPart,
     ConversationSnapshot,
@@ -19,17 +19,22 @@ from padwan_llm import (
     McpTool,
     McpTransport,
     ToolCallContext,
+    audio_part,
     image_part,
+    supports_audio,
     supports_vision,
     text_file_part,
     text_part,
 )
-from padwan_llm.gemini import GeminiClient
-from padwan_llm.gemini.models import ThinkingConfig
+from padwan_ai.content import AudioFormat
+from padwan_ai.gemini import GeminiClient
+from padwan_ai.gemini.models import ThinkingConfig
+from .trace import TRACE_BACKENDS, TraceBackend, enable_tracing
 from .utils import ALL_MODELS, console
 from .widgets import (
     Attachment,
     AttachmentBadge,
+    AttachmentKind,
     ErrorMessage,
     StreamingMessage,
     ThoughtMessage,
@@ -47,7 +52,7 @@ DATAGOUV_MCP_URL = "https://mcp.data.gouv.fr/mcp"
 class _InMemoryStore:
     """ConversationStore keeping snapshots in memory across /chat:send calls.
 
-    Implements the `padwan_llm.ConversationStore` protocol so that
+    Implements the `padwan_ai.ConversationStore` protocol so that
     `AgentSession.load` / `AgentSession.save` transparently preserve chat
     history across successive command invocations within the same TUI run.
     """
@@ -95,15 +100,37 @@ def _format_tokens(session: AgentSession, ctx: TuiContext | None = None) -> str:
     return " ".join(parts)
 
 
+_AUDIO_FORMATS: tuple[AudioFormat, ...] = get_args(AudioFormat)
+_KIND_LABELS = {"image": "images", "audio": "audio", "text": "files"}
+
+
+def _audio_fmt(path: Path) -> AudioFormat | None:
+    """Derive the audio format from the file extension, if it is a known one."""
+    fmt = path.suffix.removeprefix(".").lower()
+    return cast(AudioFormat, fmt) if fmt in _AUDIO_FORMATS else None
+
+
+def _unsupported_warning(
+    model: str, attachments: list[Attachment], *, suffix: str
+) -> str | None:
+    """Amber warning line for attachments the model can't consume, or None."""
+    skipped = [a for a in attachments if not a.supported]
+    if not skipped:
+        return None
+    kinds = "/".join(dict.fromkeys(_KIND_LABELS[a.kind] for a in skipped))
+    return f"{model} can't read {kinds} — {len(skipped)} {suffix}"
+
+
 def _build_user_content(
     text: str, attachments: list[Attachment]
 ) -> str | list[ContentPart]:
     """Assemble the user turn from typed text and queued attachments.
 
     Returns the plain string when nothing is attached. Otherwise builds content
-    parts: the text, each text file inlined, and each supported image as a data
-    URL. Unsupported images (text-only model) and unreadable files are dropped
-    from the payload — they still appear in the sent badge.
+    parts: the text, each text file inlined, and each supported image or audio
+    file as a data payload. Unsupported media (model can't see/hear it) and
+    unreadable files are dropped from the payload — they still appear in the
+    sent badge.
     """
     if not attachments:
         return text
@@ -111,9 +138,15 @@ def _build_user_content(
     if text:
         parts.append(text_part(text))
     for a in attachments:
-        if a.is_image:
-            if a.supported:
-                parts.append(image_part(a.path))
+        if not a.supported:
+            continue
+        if a.kind == "image":
+            parts.append(image_part(a.path))
+        elif a.kind == "audio":
+            try:
+                parts.append(audio_part(a.path))
+            except OSError, ValueError:
+                continue
         else:
             try:
                 parts.append(text_file_part(a.path))
@@ -158,6 +191,12 @@ async def chat_send_fn(
         "--mcp",
         help=f"Streamable-HTTP MCP server URL(s) to expose as tools (e.g. {DATAGOUV_MCP_URL})",
     ),
+    trace: TraceBackend | None = Option(
+        None,
+        "--trace",
+        help="Export LLM telemetry to this backend",
+        choices=TRACE_BACKENDS,
+    ),
     ctx: TuiContext = TuiOption(),
 ) -> None:
     """Start a conversation. Use Ctrl+C to exit."""
@@ -214,6 +253,9 @@ async def chat_send_fn(
     if not ok:
         return
 
+    if trace:
+        enable_tracing(trace)
+
     try:
         client = LLMClient(model=model, on_thought=_on_thought, base_url=base_url)
         if isinstance(client, GeminiClient):
@@ -261,24 +303,26 @@ async def chat_send_fn(
                         size = p.stat().st_size
                     except OSError:
                         continue
-                    is_image = (mimetypes.guess_type(p)[0] or "").startswith("image/")
+                    mime = mimetypes.guess_type(p)[0] or ""
+                    kind: AttachmentKind
+                    if mime.startswith("image/"):
+                        kind, supported = "image", supports_vision(model)
+                    elif mime.startswith("audio/"):
+                        kind, supported = "audio", supports_audio(model, _audio_fmt(p))
+                    else:
+                        kind, supported = "text", True
                     pending.append(
                         Attachment(
                             path=p,
                             name=p.name,
                             size=size,
-                            is_image=is_image,
-                            supported=(not is_image) or supports_vision(model),
+                            kind=kind,
+                            supported=supported,
                         )
                     )
-                blind = [a for a in pending if a.is_image and not a.supported]
-                warning = (
-                    f"{model} can't read images — {len(blind)} will be skipped"
-                    if blind
-                    else None
-                )
+                warning = _unsupported_warning(model, pending, suffix="will be skipped")
                 ctx.set_attachments(render_attachments(pending, warning=warning))
-                _set_attach_warning(bool(blind))
+                _set_attach_warning(warning is not None)
                 ctx.set_hint(
                     f"{len(pending)} attached — type a message · Ctrl+U clears"
                 )
@@ -298,13 +342,8 @@ async def chat_send_fn(
                         sent = list(pending)
                         ctx.mount_widget(UserMessage(user_input))
                         if sent:
-                            skipped = [
-                                a for a in sent if a.is_image and not a.supported
-                            ]
-                            badge_warning = (
-                                f"{model} can't read images — {len(skipped)} skipped"
-                                if skipped
-                                else None
+                            badge_warning = _unsupported_warning(
+                                model, sent, suffix="skipped"
                             )
                             ctx.mount_widget(
                                 AttachmentBadge(sent, warning=badge_warning)
@@ -330,7 +369,7 @@ async def chat_send_fn(
                         except Exception as e:
                             # Surface the error inline: the outer handler is
                             # only reached after session teardown, which can
-                            # hang on the MCP listener (see padwan-llm mcp.py).
+                            # hang on the MCP listener (see padwan-ai mcp.py).
                             ctx.mount_widget(ErrorMessage(str(e)))
                             needs_new_text_widget = True
                         ctx.set_silent_queue(False)

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/run.py

@@ -1,7 +1,6 @@
-from __future__ import annotations
-
 import json
 import sys
+from pathlib import Path
 from typing import Any
 
 from piou import Cli, Option
@@ -9,21 +8,25 @@ from piou.tui import get_tui_context
 
 from rich.table import Table
 
-from padwan_llm import (
+from padwan_ai import (
+    ANTHROPIC_MODELS,
     GEMINI_MODELS,
     GROK_MODELS,
     MISTRAL_MODELS,
     OPENAI_MODELS,
+    ContentPart,
     LLMClient,
+    content_parts,
 )
-from padwan_llm._base import OnThought
-from padwan_llm.conversation import Message
-from padwan_llm.errors import Provider
+from padwan_ai._base import OnThought
+from padwan_ai.conversation import Message
+from padwan_ai.errors import Provider
 
 from .utils import console
 from .batch import batch_group
 from .chat import chat_group
 from .talk import talk_command
+from .trace import TRACE_BACKENDS, TraceBackend, enable_tracing
 
 CUSTOM_CSS = """
 Rule.chat-mode {
@@ -64,6 +67,8 @@ def list_models(
         provider_models["Mistral"] = list(MISTRAL_MODELS)
     if not provider or provider == "grok":
         provider_models["Grok"] = list(GROK_MODELS)
+    if not provider or provider == "anthropic":
+        provider_models["Anthropic"] = list(ANTHROPIC_MODELS)
 
     if not provider_models:
         console.print(f"[red]Unknown provider: {provider}[/red]")
@@ -91,9 +96,14 @@ def info() -> None:
     table.add_row("Gemini", str(len(GEMINI_MODELS)))
     table.add_row("Mistral", str(len(MISTRAL_MODELS)))
     table.add_row("Grok", str(len(GROK_MODELS)))
+    table.add_row("Anthropic", str(len(ANTHROPIC_MODELS)))
 
     total = (
-        len(OPENAI_MODELS) + len(GEMINI_MODELS) + len(MISTRAL_MODELS) + len(GROK_MODELS)
+        len(OPENAI_MODELS)
+        + len(GEMINI_MODELS)
+        + len(MISTRAL_MODELS)
+        + len(GROK_MODELS)
+        + len(ANTHROPIC_MODELS)
     )
     table.add_section()
     table.add_row("[bold]Total[/bold]", f"[bold]{total}[/bold]")
@@ -119,6 +129,18 @@ async def oneshot(
         "--stream-thinking",
         help="Stream model reasoning/thinking tokens to stderr (requires --stream)",
     ),
+    files: list[Path] | None = Option(
+        None,
+        "-f",
+        "--file",
+        help="Attach file(s) to the prompt (images/audio/text, routed by type)",
+    ),
+    trace: TraceBackend | None = Option(
+        None,
+        "--trace",
+        help="Export LLM telemetry to this backend",
+        choices=TRACE_BACKENDS,
+    ),
 ) -> None:
     """Send a single prompt and print the response."""
     parsed_extra: dict[str, Any] | None = None
@@ -138,8 +160,19 @@ async def oneshot(
 
     on_thought: OnThought | None = _thought_streamer if stream_thinking else None
 
+    if trace:
+        enable_tracing(trace)
+
+    content: str | list[ContentPart] = prompt
+    if files:
+        try:
+            content = content_parts(prompt, *files)
+        except (OSError, ValueError) as e:
+            console.print(f"[red]--file: {e}[/red]")
+            raise SystemExit(1)
+
     client = LLMClient(model=model, base_url=base_url, on_thought=on_thought)
-    messages: list[Message] = [Message(role="user", content=prompt)]
+    messages: list[Message] = [Message(role="user", content=content)]
     async with client:
         if stream:
             async for chunk in client.stream_chat(messages, extra_params=parsed_extra):

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/talk.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import asyncio
 import contextlib
 import functools
@@ -15,10 +13,11 @@ from piou import Option
 from piou.tui import get_tui_context
 from tracktolib.utils import BytesBuffer
 
-from padwan_llm import RealtimeClient, RealtimeConnection, RealtimeServerEvent
-from padwan_llm.errors import LLMError
-from padwan_llm.openai.realtime import NO_TURN_DETECTION, REALTIME_SAMPLE_RATE
+from padwan_ai import RealtimeClient, RealtimeConnection, RealtimeServerEvent
+from padwan_ai.errors import LLMError
+from padwan_ai.openai.realtime import NO_TURN_DETECTION, REALTIME_SAMPLE_RATE
 
+from .trace import TRACE_BACKENDS, TraceBackend, enable_tracing
 from .utils import console
 
 SR = REALTIME_SAMPLE_RATE  # 24 kHz mono PCM16, as gpt-realtime expects
@@ -317,6 +316,12 @@ async def talk_command(
     check: bool = Option(
         False, "--check", help="List audio devices and key status, then exit"
     ),
+    trace: TraceBackend | None = Option(
+        None,
+        "--trace",
+        help="Export LLM telemetry to this backend",
+        choices=TRACE_BACKENDS,
+    ),
 ) -> None:
     """Talk with a real-time voice assistant (speech-to-speech)."""
     # A live mic/speaker session needs the whole terminal; the Textual TUI owns it,
@@ -343,6 +348,9 @@ async def talk_command(
         console.print(f"model={model}  voice={voice}")
         return
 
+    if trace:
+        enable_tracing(trace)
+
     push_to_talk = not hands_free
     if push_to_talk and not sys.stdin.isatty():
         console.print(

padwan_cli-0.6.1/padwan_cli/trace.py

@@ -0,0 +1,68 @@
+import atexit
+import os
+from typing import Literal, get_args
+
+from .utils import console
+
+__all__ = ("TRACE_BACKENDS", "TraceBackend", "enable_tracing")
+
+TraceBackend = Literal["langfuse", "otlp"]
+# piou only derives choices from a bare Literal, not `Literal | None`.
+TRACE_BACKENDS: list[TraceBackend] = list(get_args(TraceBackend))
+
+
+def _missing_extra(backend: TraceBackend) -> SystemExit:
+    extra = "langfuse" if backend == "langfuse" else "otel"
+    console.print(f"[red]{backend} tracing dependencies not installed.[/red]")
+    console.print(f"[dim]Install the {extra} extra: `uv sync --extra {extra}`.[/dim]")
+    return SystemExit(1)
+
+
+def _enable_langfuse() -> None:
+    from padwan_ai.langfuse import instrument
+
+    integration = instrument()
+    atexit.register(integration.shutdown)
+    console.print("[dim]Tracing enabled (Langfuse)[/dim]")
+
+
+def _enable_otlp() -> None:
+    from opentelemetry.exporter.otlp.proto.http.metric_exporter import (
+        OTLPMetricExporter,
+    )
+    from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+    from opentelemetry.sdk.metrics import MeterProvider
+    from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader
+    from opentelemetry.sdk.resources import Resource
+    from opentelemetry.sdk.trace import TracerProvider
+    from opentelemetry.sdk.trace.export import BatchSpanProcessor
+
+    from padwan_ai import otel
+
+    resource = Resource.create({"service.name": "padwan-cli"})
+    tracer_provider = TracerProvider(resource=resource)
+    tracer_provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
+    meter_provider = MeterProvider(
+        resource=resource,
+        metric_readers=[PeriodicExportingMetricReader(OTLPMetricExporter())],
+    )
+    otel.instrument(tracer_provider=tracer_provider, meter_provider=meter_provider)
+    atexit.register(meter_provider.shutdown)
+    atexit.register(tracer_provider.shutdown)
+    endpoint = os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "http://localhost:4318")
+    console.print(f"[dim]Tracing enabled (OTLP → {endpoint})[/dim]")
+
+
+def enable_tracing(backend: TraceBackend) -> None:
+    """Instrument padwan-ai clients for this process, exporting to `backend`.
+
+    `langfuse` reads the standard `LANGFUSE_*` env vars; `otlp` uses the
+    standard `OTEL_EXPORTER_OTLP_*` env vars. Exporters are flushed at exit.
+    """
+    try:
+        if backend == "langfuse":
+            _enable_langfuse()
+        else:
+            _enable_otlp()
+    except ImportError:
+        raise _missing_extra(backend)

padwan_cli-0.6.1/padwan_cli/utils.py

@@ -0,0 +1,21 @@
+from rich.console import Console
+
+from padwan_ai import (
+    ANTHROPIC_MODELS,
+    GEMINI_MODELS,
+    GROK_MODELS,
+    MISTRAL_MODELS,
+    OPENAI_MODELS,
+)
+
+console = Console()
+
+ALL_MODELS = sorted(
+    [
+        *OPENAI_MODELS,
+        *GEMINI_MODELS,
+        *MISTRAL_MODELS,
+        *GROK_MODELS,
+        *ANTHROPIC_MODELS,
+    ]
+)

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/padwan_cli/widgets.py

@@ -1,9 +1,7 @@
-from __future__ import annotations
-
 import json
 from dataclasses import dataclass
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, cast
+from typing import TYPE_CHECKING, Any, Literal, cast
 
 from rich import box
 from rich.columns import Columns
@@ -15,7 +13,7 @@ from textual.widgets import Static
 from piou.tui import StreamingMessage as _StreamingMessage
 
 if TYPE_CHECKING:
-    from padwan_llm.gemini import BatchJob, BatchResult
+    from padwan_ai.gemini import BatchJob, BatchResult
 
 # Colors for chat messages
 USER_COLOR = "#87ceeb"
@@ -29,6 +27,9 @@ CHIP_BG = "#1f2230"
 CHIP_BORDER = "#3a3f55"
 
 
+AttachmentKind = Literal["image", "audio", "text"]
+
+
 @dataclass
 class Attachment:
     """A file dropped into the chat, queued to send with the next message."""
@@ -36,8 +37,8 @@ class Attachment:
     path: Path
     name: str
     size: int
-    is_image: bool
-    supported: bool  # whether the active model can use it (images need vision)
+    kind: AttachmentKind
+    supported: bool  # whether the active model can use it (images/audio need support)
 
 
 def human_size(num_bytes: int) -> str:

{padwan_cli-0.5.0 → padwan_cli-0.6.1}/pyproject.toml

@@ -1,20 +1,40 @@
 [project]
 name = "padwan-cli"
-version = "0.5.0"
-description = "CLI and TUI for padwan-llm"
+version = "0.6.1"
+description = "CLI and TUI for padwan-ai"
 readme = "README.md"
-requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.15"
+classifiers = [
+    "Environment :: Console",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.15",
+]
 dependencies = [
-    "padwan-llm[realtime]>=0.8.0",
+    "padwan-ai[realtime]>=0.11.1",
     "piou[tui]>=0.36.0",
     "tracktolib>=0.74.0",
 ]
 
 [[project.authors]]
-email = "julien.brayere@polarsen.com"
+email = "julien.brayere@polarsen.io"
+
+[project.urls]
+Homepage = "https://polarsen-io.github.io/padwan-cli"
+Source = "https://github.com/polarsen-io/padwan-cli"
+Changelog = "https://github.com/polarsen-io/padwan-cli/blob/master/CHANGELOG.md"
 
 [project.optional-dependencies]
 voice = ["sounddevice>=0.5"]
+otel = [
+    "padwan-ai[otel]>=0.11.1",
+    "opentelemetry-sdk>=1.44",
+    "opentelemetry-exporter-otlp>=1.44",
+]
+langfuse = ["padwan-ai[langfuse]>=0.11.1"]
 
 [project.scripts]
 padwan-cli = "padwan_cli:main_tui"
@@ -45,6 +65,9 @@ dev = [
     "pytest-asyncio>=1.3.0",
     "pytest-cov>=7.0.0",
     "ruff>=0.11.0",
+    "padwan-ai[langfuse]>=0.11.1",
+    "opentelemetry-sdk>=1.44",
+    "opentelemetry-exporter-otlp>=1.44",
 ]
 docs = ["zensical>=0.0.31"]
 bump = ["commitizen>=4.0.0"]

padwan_cli-0.6.1/pyproject.toml.orig

@@ -0,0 +1,81 @@
+[project]
+name = "padwan-cli"
+version = "0.6.1"
+description = "CLI and TUI for padwan-ai"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { email = "julien.brayere@polarsen.io" }
+]
+requires-python = ">=3.15"
+classifiers = [
+    "Environment :: Console",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.15",
+]
+dependencies = [
+    "padwan-ai[realtime]>=0.11.1",
+    "piou[tui]>=0.36.0",
+    "tracktolib>=0.74.0",
+]
+
+[project.urls]
+Homepage = "https://polarsen-io.github.io/padwan-cli"
+Source = "https://github.com/polarsen-io/padwan-cli"
+Changelog = "https://github.com/polarsen-io/padwan-cli/blob/master/CHANGELOG.md"
+
+[project.optional-dependencies]
+# `talk` command audio I/O; also needs the PortAudio system lib (libportaudio2).
+voice = ["sounddevice>=0.5"]
+# `--trace otlp`: OTel instrumentation with an OTLP exporter.
+otel = [
+    "padwan-ai[otel]>=0.11.1",
+    "opentelemetry-sdk>=1.44",
+    "opentelemetry-exporter-otlp>=1.44",
+]
+# `--trace langfuse`: OTel instrumentation with the Langfuse adapter.
+langfuse = ["padwan-ai[langfuse]>=0.11.1"]
+
+[project.scripts]
+padwan-cli = "padwan_cli:main_tui"
+padwan-talk = "padwan_cli.talk:main"
+
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = ""
+
+[dependency-groups]
+dev = [
+    "piou[tui-reload]>=0.36.0",
+    "pyright>=1.1.408",
+    "pytest>=8.0.0",
+    "pytest-asyncio>=1.3.0",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.11.0",
+    # keep the otel and langfuse extras type-checkable/testable in dev
+    "padwan-ai[langfuse]>=0.11.1",
+    "opentelemetry-sdk>=1.44",
+    "opentelemetry-exporter-otlp>=1.44",
+]
+docs = [
+    "zensical>=0.0.31",
+]
+bump = [
+    "commitizen>=4.0.0",
+]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version_provider = "pep621"
+tag_format = "$version"
+update_changelog_on_bump = true
+bump_message = "chore(release): release $current_version → $new_version [skip ci]"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

padwan_cli-0.5.0/PKG-INFO

@@ -1,49 +0,0 @@
-Metadata-Version: 2.3
-Name: padwan-cli
-Version: 0.5.0
-Summary: CLI and TUI for padwan-llm
-Author-email: julien.brayere@polarsen.com
-Requires-Dist: padwan-llm[realtime]>=0.8.0
-Requires-Dist: piou[tui]>=0.36.0
-Requires-Dist: tracktolib>=0.74.0
-Requires-Dist: sounddevice>=0.5 ; extra == 'voice'
-Requires-Python: >=3.14
-Provides-Extra: voice
-Description-Content-Type: text/markdown
-
-# Padwan CLI
-
-Interactive CLI/TUI for [`padwan-llm`](https://github.com/polarsen-io/padwan-llm).
-
-> [!NOTE]
-> This is a playground for experimenting with `padwan-llm` features (streaming, agents, MCP, thinking tokens, batch jobs) — not a production-grade tool. Expect rough edges and breaking changes.
-
-<img alt="Chat demo" src="https://github.com/polarsen-io/padwan-cli/raw/master/docs/static/chat.gif" width="800"/>
-
-## Quick start
-
-```bash
-export OPENAI_API_KEY=...
-uvx padwan-cli
-# then /help for commands
-```
-
-
-## Install
-
-```bash
-pip install padwan-cli
-```
-
-## Local Development
-
-```bash
-uv sync --group dev
-uv run padwan-cli
-```
-
-## One-shot Mode
-
-```bash
-uvx padwan-cli "Hello" -m gpt-4o-mini
-```

padwan_cli-0.5.0/README.md

@@ -1,36 +0,0 @@
-# Padwan CLI
-
-Interactive CLI/TUI for [`padwan-llm`](https://github.com/polarsen-io/padwan-llm).
-
-> [!NOTE]
-> This is a playground for experimenting with `padwan-llm` features (streaming, agents, MCP, thinking tokens, batch jobs) — not a production-grade tool. Expect rough edges and breaking changes.
-
-<img alt="Chat demo" src="https://github.com/polarsen-io/padwan-cli/raw/master/docs/static/chat.gif" width="800"/>
-
-## Quick start
-
-```bash
-export OPENAI_API_KEY=...
-uvx padwan-cli
-# then /help for commands
-```
-
-
-## Install
-
-```bash
-pip install padwan-cli
-```
-
-## Local Development
-
-```bash
-uv sync --group dev
-uv run padwan-cli
-```
-
-## One-shot Mode
-
-```bash
-uvx padwan-cli "Hello" -m gpt-4o-mini
-```

padwan_cli-0.5.0/padwan_cli/utils.py

@@ -1,7 +0,0 @@
-from rich.console import Console
-
-from padwan_llm import GEMINI_MODELS, GROK_MODELS, MISTRAL_MODELS, OPENAI_MODELS
-
-console = Console()
-
-ALL_MODELS = sorted([*OPENAI_MODELS, *GEMINI_MODELS, *MISTRAL_MODELS, *GROK_MODELS])

padwan_cli-0.5.0/pyproject.toml.orig

@@ -1,55 +0,0 @@
-[project]
-name = "padwan-cli"
-version = "0.5.0"
-description = "CLI and TUI for padwan-llm"
-readme = "README.md"
-authors = [
-    { email = "julien.brayere@polarsen.com" }
-]
-requires-python = ">=3.14"
-dependencies = [
-    "padwan-llm[realtime]>=0.8.0",
-    "piou[tui]>=0.36.0",
-    "tracktolib>=0.74.0",
-]
-
-[project.optional-dependencies]
-# `talk` command audio I/O; also needs the PortAudio system lib (libportaudio2).
-voice = ["sounddevice>=0.5"]
-
-[project.scripts]
-padwan-cli = "padwan_cli:main_tui"
-padwan-talk = "padwan_cli.talk:main"
-
-[build-system]
-requires = ["uv_build>=0.9.28,<0.10.0"]
-build-backend = "uv_build"
-
-[tool.uv.build-backend]
-module-root = ""
-
-[dependency-groups]
-dev = [
-    "piou[tui-reload]>=0.36.0",
-    "pyright>=1.1.408",
-    "pytest>=8.0.0",
-    "pytest-asyncio>=1.3.0",
-    "pytest-cov>=7.0.0",
-    "ruff>=0.11.0",
-]
-docs = [
-    "zensical>=0.0.31",
-]
-bump = [
-    "commitizen>=4.0.0",
-]
-
-[tool.commitizen]
-name = "cz_conventional_commits"
-version_provider = "pep621"
-tag_format = "$version"
-update_changelog_on_bump = true
-bump_message = "chore(release): release $current_version → $new_version [skip ci]"
-
-[tool.pytest.ini_options]
-asyncio_mode = "auto"