meshapi-code 0.1.0__py3-none-any.whl

meshapi/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

meshapi/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

meshapi/cli.py

@@ -0,0 +1,102 @@
+"""meshapi — terminal chat REPL for Mesh API."""
+import argparse
+import sys
+
+import httpx
+from prompt_toolkit import PromptSession
+from prompt_toolkit.history import FileHistory
+from prompt_toolkit.styles import Style
+from rich.panel import Panel
+
+from . import __version__
+from .client import stream_chat
+from .commands import handle_command
+from .config import CONFIG_FILE, HISTORY_FILE, load_config
+from .render import console, fmt_usd, render_stream
+
+
+def parse_args(argv=None) -> argparse.Namespace:
+    p = argparse.ArgumentParser(prog="meshapi", description="Terminal chat for Mesh API")
+    p.add_argument("--version", action="version", version=f"meshapi {__version__}")
+    p.add_argument("--model", help="Override model for this session (e.g. openai/gpt-4o-mini)")
+    p.add_argument("--route", choices=["cheapest", "fastest", "balanced"], help="Routing mode")
+    return p.parse_args(argv)
+
+
+def main() -> None:
+    args = parse_args()
+    cfg = load_config()
+    if args.model:
+        cfg["model"] = args.model
+    if args.route:
+        cfg["route"] = args.route
+
+    if not cfg["api_key"]:
+        console.print(
+            "[red]No API key found. Set MESHAPI_API_KEY env var or edit "
+            f"{CONFIG_FILE}[/red]"
+        )
+        sys.exit(1)
+
+    state = {
+        "cfg": cfg,
+        "messages": [{"role": "system", "content": cfg["system"]}],
+        "session_cost": 0.0,
+    }
+
+    session = PromptSession(history=FileHistory(str(HISTORY_FILE)))
+    console.print(Panel.fit(
+        f"meshapi {__version__}\n"
+        f"model: [bold cyan]{cfg['model']}[/bold cyan]\n"
+        f"route: [cyan]{cfg.get('route') or 'default'}[/cyan]\n"
+        "type /help for commands, /exit to quit",
+        border_style="cyan",
+    ))
+
+    while True:
+        try:
+            user_input = session.prompt(
+                "you > ",
+                style=Style.from_dict({"prompt": "ansicyan bold"}),
+            )
+        except (KeyboardInterrupt, EOFError):
+            console.print("\n[dim]bye[/dim]")
+            break
+
+        if not user_input.strip():
+            continue
+        if user_input.startswith("/"):
+            if not handle_command(user_input, state):
+                break
+            continue
+
+        state["messages"].append({"role": "user", "content": user_input})
+        console.print()
+        try:
+            reply, meta = render_stream(stream_chat(state["messages"], state["cfg"]))
+            state["messages"].append({"role": "assistant", "content": reply})
+
+            cost = meta.get("cost")
+            if cost is not None:
+                try:
+                    state["session_cost"] += float(cost)
+                except (TypeError, ValueError):
+                    pass
+            usage = meta.get("usage") or {}
+            tokens = (
+                f"{usage.get('prompt_tokens', '?')} → {usage.get('completion_tokens', '?')} tok"
+                if usage else ""
+            )
+            cost_line = f"[dim]{tokens}  •  {fmt_usd(cost)}  •  session {fmt_usd(state['session_cost'])}[/dim]"
+            console.print(cost_line)
+        except httpx.HTTPStatusError as e:
+            console.print(f"[red]API error {e.response.status_code}: {e.response.text}[/red]")
+            state["messages"].pop()
+        except Exception as e:
+            console.print(f"[red]Error: {e}[/red]")
+            state["messages"].pop()
+        console.print()
+
+
+if __name__ == "__main__":
+    main()

meshapi/client.py

@@ -0,0 +1,52 @@
+"""Streaming OpenAI-compatible HTTP client for Mesh API."""
+import json
+from typing import Iterable
+
+import httpx
+
+
+def stream_chat(messages: list, cfg: dict) -> Iterable:
+    """Yield content deltas, then a final {'usage':..., 'cost':...} dict.
+
+    Mesh API is OpenAI-compatible but adds `cost` to the final SSE chunk.
+    """
+    url = f"{cfg['base_url']}/chat/completions"
+    headers = {
+        "Authorization": f"Bearer {cfg['api_key']}",
+        "Content-Type": "application/json",
+    }
+    payload: dict = {
+        "model": cfg["model"],
+        "messages": messages,
+        "stream": True,
+    }
+    if cfg.get("route"):
+        payload["route"] = cfg["route"]
+
+    last_meta: dict = {}
+    with httpx.stream("POST", url, json=payload, headers=headers, timeout=120) as r:
+        r.raise_for_status()
+        for line in r.iter_lines():
+            if not line or not line.startswith("data: "):
+                continue
+            data = line[6:]
+            if data.strip() == "[DONE]":
+                break
+            try:
+                obj = json.loads(data)
+            except json.JSONDecodeError:
+                continue
+
+            choices = obj.get("choices") or []
+            if choices:
+                delta = choices[0].get("delta", {}).get("content")
+                if delta:
+                    yield delta
+
+            usage = obj.get("usage")
+            cost = obj.get("cost")
+            if usage or cost:
+                last_meta = {"usage": usage, "cost": cost}
+
+    if last_meta:
+        yield last_meta

meshapi/commands.py

@@ -0,0 +1,82 @@
+"""Slash command handlers."""
+from pathlib import Path
+
+from rich.panel import Panel
+
+from .config import save_config
+from .render import console, fmt_usd
+
+ROUTES = {"cheapest", "fastest", "balanced"}
+
+
+def handle_command(cmd: str, state: dict) -> bool:
+    """Handle slash commands. Returns True if app should continue."""
+    parts = cmd.strip().split(maxsplit=1)
+    name = parts[0].lower()
+    arg = parts[1] if len(parts) > 1 else ""
+
+    if name in ("/exit", "/quit", "/q"):
+        return False
+
+    if name == "/clear":
+        state["messages"] = [{"role": "system", "content": state["cfg"]["system"]}]
+        state["session_cost"] = 0.0
+        console.print("[dim]Conversation cleared.[/dim]")
+
+    elif name == "/model":
+        if arg:
+            state["cfg"]["model"] = arg
+            save_config(state["cfg"])
+            console.print(f"[dim]Model set to {arg}[/dim]")
+        else:
+            console.print(f"[dim]Current model: {state['cfg']['model']}[/dim]")
+
+    elif name == "/route":
+        if not arg:
+            console.print(f"[dim]Current route: {state['cfg'].get('route') or 'default'}[/dim]")
+        elif arg in ROUTES or arg == "default":
+            state["cfg"]["route"] = None if arg == "default" else arg
+            save_config(state["cfg"])
+            console.print(f"[dim]Routing set to {arg}[/dim]")
+        else:
+            console.print(f"[red]Unknown route. Try: {', '.join(sorted(ROUTES))}, default[/red]")
+
+    elif name == "/file":
+        path = Path(arg).expanduser()
+        if path.exists():
+            content = path.read_text()
+            state["messages"].append({
+                "role": "user",
+                "content": f"File: {path.name}\n\n```\n{content}\n```",
+            })
+            console.print(f"[dim]Added {path.name} ({len(content)} chars) to context[/dim]")
+        else:
+            console.print(f"[red]File not found: {path}[/red]")
+
+    elif name == "/system":
+        if arg:
+            state["cfg"]["system"] = arg
+            state["messages"] = [{"role": "system", "content": arg}]
+            console.print("[dim]System prompt updated and conversation reset.[/dim]")
+        else:
+            console.print(f"[dim]{state['cfg']['system']}[/dim]")
+
+    elif name == "/cost":
+        console.print(f"[dim]Session spend: {fmt_usd(state.get('session_cost', 0))}[/dim]")
+
+    elif name == "/help":
+        console.print(Panel.fit(
+            "/exit             end session\n"
+            "/clear            reset conversation\n"
+            "/model <name>     switch model (e.g. anthropic/claude-sonnet-4.5)\n"
+            "/route <mode>     cheapest|fastest|balanced|default\n"
+            "/file <path>      add file to context\n"
+            "/system <txt>     set system prompt\n"
+            "/cost             show session spend\n"
+            "/help             show this",
+            title="commands",
+            border_style="cyan",
+        ))
+    else:
+        console.print(f"[red]Unknown command: {name}. Type /help[/red]")
+    return True

meshapi/config.py

@@ -0,0 +1,37 @@
+"""Config storage at ~/.meshapi/config.json."""
+import json
+import os
+from pathlib import Path
+
+CONFIG_DIR = Path.home() / ".meshapi"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+HISTORY_FILE = CONFIG_DIR / "history"
+
+DEFAULT_CONFIG = {
+    "base_url": "https://api.meshapi.ai/v1",
+    "api_key": "",
+    "model": "anthropic/claude-sonnet-4.5",
+    "system": "You are a helpful coding assistant. Be concise.",
+    "route": None,
+}
+
+
+def load_config() -> dict:
+    CONFIG_DIR.mkdir(exist_ok=True)
+    if not CONFIG_FILE.exists():
+        CONFIG_FILE.write_text(json.dumps(DEFAULT_CONFIG, indent=2))
+    cfg = {**DEFAULT_CONFIG, **json.loads(CONFIG_FILE.read_text())}
+    # MESH_API_KEY kept as fallback for one release; prefer MESHAPI_API_KEY.
+    cfg["api_key"] = (
+        os.getenv("MESHAPI_API_KEY")
+        or os.getenv("MESH_API_KEY")
+        or cfg.get("api_key", "")
+    )
+    cfg["base_url"] = os.getenv("MESHAPI_BASE_URL", cfg["base_url"])
+    return cfg
+
+
+def save_config(cfg: dict) -> None:
+    CONFIG_DIR.mkdir(exist_ok=True)
+    persisted = {k: v for k, v in cfg.items() if k != "api_key"}
+    CONFIG_FILE.write_text(json.dumps(persisted, indent=2))

meshapi/render.py

@@ -0,0 +1,43 @@
+"""Rich-based markdown live rendering and shared formatters."""
+from typing import Iterable
+
+from rich.console import Console
+from rich.live import Live
+from rich.markdown import Markdown
+
+console = Console()
+
+
+def fmt_usd(value) -> str:
+    """USD formatter matching dashboard `fmtUsd` (routersvc-client/src/lib/utils.ts).
+
+    Always 6 decimals; K/M abbreviations for large values. Never use raw f-string
+    rounding for money — `999.999833` would render `$1000.00`.
+    """
+    try:
+        n = float(value)
+    except (TypeError, ValueError):
+        return "$0.000000"
+    if abs(n) >= 1_000_000:
+        return f"${n / 1_000_000:.2f}M"
+    if abs(n) >= 1_000:
+        return f"${n / 1_000:.2f}K"
+    return f"${n:.6f}"
+
+
+def render_stream(events: Iterable) -> tuple[str, dict]:
+    """Live-render markdown content; return (full_text, metadata).
+
+    Generator yields strings (content deltas) and an optional final dict
+    (usage + cost from Mesh API's last SSE chunk).
+    """
+    buf = ""
+    meta: dict = {}
+    with Live(console=console, refresh_per_second=20) as live:
+        for event in events:
+            if isinstance(event, str):
+                buf += event
+                live.update(Markdown(buf))
+            elif isinstance(event, dict):
+                meta.update(event)
+    return buf, meta

meshapi_code-0.1.0.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: meshapi-code
+Version: 0.1.0
+Summary: Terminal chat for Mesh API — OpenAI-compatible LLM gateway
+Project-URL: Homepage, https://meshapi.ai
+Project-URL: Documentation, https://docs.meshapi.ai
+Project-URL: Repository, https://github.com/aifiesta/meshapi-code
+Author: Mesh API
+License: MIT
+License-File: LICENSE
+Keywords: anthropic,chat,cli,gateway,llm,mesh,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: rich>=13.7
+Description-Content-Type: text/markdown
+
+# meshapi-code
+
+Terminal chat for [Mesh API](https://meshapi.ai) — the OpenAI-compatible LLM gateway. Streaming responses, live markdown, slash commands, real-time cost.
+
+```
+$ meshapi
+╭───────────────────────────────╮
+│ meshapi 0.1.0                 │
+│ model: anthropic/claude-…     │
+│ route: default                │
+╰───────────────────────────────╯
+you > how do I parse SSE in python
+… streamed markdown reply …
+   142 → 318 tok  •  $0.001234  •  session $0.001234
+```
+
+## Install
+
+```bash
+pipx install meshapi-code           # recommended
+uv tool install meshapi-code        # if you use uv
+pip install meshapi-code            # plain pip
+```
+
+The PyPI package is `meshapi-code`; the command on your `$PATH` is `meshapi`.
+
+Then:
+
+```bash
+export MESHAPI_API_KEY=rsk_your_key_here
+meshapi
+```
+
+Get a key at [meshapi.ai](https://meshapi.ai).
+
+## What it does
+
+- **Streaming completions** with live markdown rendering (`rich`)
+- **Real cost per turn** — Mesh API returns `cost` in the SSE tail; we show it
+- **Slash commands** — `/model`, `/route`, `/file`, `/system`, `/cost`, `/clear`
+- **Mid-session model switching** — `/model openai/gpt-4o-mini`
+- **Smart routing** — `/route cheapest` lets the gateway pick (Mesh-specific)
+- **Persistent input history** — up-arrow recalls past prompts
+- **Config + env-var override** — `~/.meshapi/config.json`, `MESHAPI_API_KEY`
+
+## Slash commands
+
+| Command | What it does |
+|---|---|
+| `/help` | List commands |
+| `/model <name>` | Switch model (e.g. `anthropic/claude-sonnet-4.5`) |
+| `/route <mode>` | `cheapest`, `fastest`, `balanced`, or `default` |
+| `/file <path>` | Inject a file into the conversation |
+| `/system <text>` | Replace system prompt and reset chat |
+| `/cost` | Show cumulative session spend |
+| `/clear` | Reset conversation |
+| `/exit` | Quit |
+
+## Config
+
+`~/.meshapi/config.json`:
+
+```json
+{
+  "base_url": "https://api.meshapi.ai/v1",
+  "model": "anthropic/claude-sonnet-4.5",
+  "system": "You are a helpful coding assistant. Be concise.",
+  "route": null
+}
+```
+
+The API key is read from `MESHAPI_API_KEY` (preferred) or stored in the same file.
+
+## Why it exists
+
+Mesh API is OpenAI-compatible, so any generic chat CLI works against it. `meshapi` adds two things a generic CLI can't: (1) the gateway-only `cost` field shown after every turn, and (2) routing controls (`/route cheapest`) that hit Mesh's gateway-side model selection.
+
+## Roadmap
+
+- v0.2 — tool calling, repo-aware mode, diff apply, `npm i -g meshapi-code`
+- v0.3 — Homebrew tap, curl|sh installer at `meshapi.ai/install.sh`
+
+## License
+
+MIT

meshapi_code-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+meshapi/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+meshapi/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+meshapi/cli.py,sha256=ySXoOIv1b4pcY1b92LmA1rgZFlPiucW1BIBbEAGxwiU,3451
+meshapi/client.py,sha256=BKRxbMAtgGSj9Y4pf0yof157DLZ95VorX--2QXiIsFY,1548
+meshapi/commands.py,sha256=0ZiIh9n94f6ix-hH3u4v3gW7N8sLSWsPv9sdDPEUbg0,3040
+meshapi/config.py,sha256=DcqOjZtAufuSDg2vDs0lsBynRjThL_8znLOl_Y2_PN4,1159
+meshapi/render.py,sha256=jEpqYxvlTXm5oNeZYJ8X7nfOiCjiTxMURGUSk__M-f0,1321
+meshapi_code-0.1.0.dist-info/METADATA,sha256=5YQtmiQVoB-_CeYmhQm1_sshCWGiLaUnoPAsLZnDdmU,3765
+meshapi_code-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+meshapi_code-0.1.0.dist-info/entry_points.txt,sha256=ZCXZ_SgrhWIQEHSjAXz0pUlyGbIQKZ68vp_Cg1Y0rME,45
+meshapi_code-0.1.0.dist-info/licenses/LICENSE,sha256=oALrQSPnF5cbhoBcSv6uDDsPUGl7q5Y2AL-dJ--wzt8,1065
+meshapi_code-0.1.0.dist-info/RECORD,,

meshapi_code-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

meshapi_code-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+meshapi = meshapi.cli:main

meshapi_code-0.1.0.dist-info/licenses/LICENSE

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