agentbridge-cli 0.1.11__py3-none-any.whl

agentbridge/templates/dashboard/pool.html

@@ -0,0 +1,9 @@
+{% set capacity_available = size - in_use %}
+{% set at_capacity = size > 0 and capacity_available <= 0 %}
+<div class="pool-status">
+    <span class="pool-health{% if at_capacity %} error{% endif %}">
+        <span class="pool-dot {% if at_capacity %}empty{% else %}available{% endif %}"></span>
+        {% if at_capacity %}Busy{% else %}Healthy{% endif %}
+    </span>
+    <span class="pool-count">{{ [capacity_available, 0]|max }}/{{ size }} capacity</span>
+</div>

agentbridge/templates/dashboard/requests.html

@@ -0,0 +1,67 @@
+<h3 class="request-list-title">Requests</h3>
+{% if requests %}
+{% set active_requests = requests|selectattr("is_active")|list %}
+{% set failed_requests = requests|rejectattr("is_active")|selectattr("error")|list %}
+{% set completed_requests = requests|rejectattr("is_active")|rejectattr("error")|list %}
+
+{% macro request_row(req) -%}
+<div class="request-row{% if req.is_active %} request-row-active{% endif %}" data-request-id="{{ req.request_id }}" hx-get="/dashboard/request/{{ req.request_id }}" hx-target="#detail" hx-swap="innerHTML">
+    <div class="request-main">
+        <div class="request-title">
+            <span class="status-dot {% if req.is_active %}streaming{% elif req.error %}error{% else %}idle{% endif %}"></span>
+            <span class="request-id">{{ req.request_id }}</span>
+            {% if req.is_active %}
+            <span class="badge badge-active">streaming</span>
+            {% elif req.error %}
+            <span class="badge badge-err">error</span>
+            {% else %}
+            <span class="badge badge-ok">ok</span>
+            {% endif %}
+        </div>
+        <div class="request-model">{{ req.model }}</div>
+    </div>
+    <div class="request-metrics">
+        <div>{% if req.is_active %}{{ req.elapsed_s }}s{% else %}{{ req.duration_ms }}ms{% endif %}</div>
+        <div>{% if not req.is_active and (req.input_tokens is not none or req.output_tokens is not none) %}{{ (req.input_tokens or 0) + (req.output_tokens or 0) }}t{% else %}-{% endif %}</div>
+    </div>
+</div>
+{%- endmacro %}
+
+{% if active_requests %}
+<section class="request-group">
+    <h4 class="request-group-title">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"></path></svg>
+        Active ({{ active_requests|length }})
+    </h4>
+    {% for req in active_requests %}
+    {{ request_row(req) }}
+    {% endfor %}
+</section>
+{% endif %}
+
+{% if completed_requests %}
+<section class="request-group">
+    <h4 class="request-group-title">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"></path></svg>
+        Completed ({{ completed_requests|length }})
+    </h4>
+    {% for req in completed_requests %}
+    {{ request_row(req) }}
+    {% endfor %}
+</section>
+{% endif %}
+
+{% if failed_requests %}
+<section class="request-group">
+    <h4 class="request-group-title">
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"></path></svg>
+        Failed ({{ failed_requests|length }})
+    </h4>
+    {% for req in failed_requests %}
+    {{ request_row(req) }}
+    {% endfor %}
+</section>
+{% endif %}
+{% else %}
+<p class="empty-state">No requests</p>
+{% endif %}

agentbridge_cli-0.1.11.dist-info/METADATA

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: agentbridge-cli
+Version: 0.1.11
+Summary: Bridge OpenAI tools to Claude Code SDK, Codex CLI, and OpenRouter
+Project-URL: Homepage, https://github.com/tsilva/agentbridge
+Project-URL: Repository, https://github.com/tsilva/agentbridge
+Project-URL: Issues, https://github.com/tsilva/agentbridge/issues
+Author: tsilva
+License: MIT
+License-File: LICENSE
+Keywords: anthropic,api,bridge,claude,claude-code,codex,fastapi,llm,openai,streaming
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Requires-Dist: claude-agent-sdk>=0.1.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: openrouter==0.9.1
+Requires-Dist: pillow>=11.2
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="./logo.png" alt="agentbridge" width="512" />
+
+  **🌉 Bridge OpenAI tools to Claude Code SDK, Codex CLI, or OpenRouter — use your subscriptions anywhere 🔌**
+</div>
+
+agentbridge is a local API bridge for developers who want to connect OpenAI-compatible apps to Claude Code, Codex, or OpenRouter. Run one server, choose a backend with a namespaced model ID, and point existing Chat Completions clients at `http://localhost:8082/api/v1`.
+
+It supports streaming and non-streaming responses, image and PDF inputs where the backend accepts them, native Codex image editing, strict JSON Schema output, OpenAI-style tool calls, a live dashboard, and local JSON session logs.
+
+> **Legal notice:** agentbridge can use Claude Code SDK and Codex CLI access through your local subscriptions, and can forward requests to OpenRouter when configured. You are responsible for determining whether your use complies with each service's terms. Use it conservatively and at your own risk.
+
+## Install
+
+```bash
+uv tool install agentbridge-cli
+agentbridge
+```
+
+If you installed an earlier release under the previous PyPI distribution name,
+migrate once with:
+
+```bash
+uv tool uninstall agentbridge-py
+uv tool install agentbridge-cli
+```
+
+The Python import and executable remain `agentbridge`.
+
+Open the [dashboard](http://localhost:8082/dashboard), try the built-in [chat](http://localhost:8082/dashboard/chat), or use `http://localhost:8082/api/v1` as an OpenAI-compatible base URL.
+
+Authenticate at least one backend before sending requests:
+
+```bash
+claude login    # for claudecode/* models
+codex login     # for codex/* models
+```
+
+For OpenRouter, start agentbridge once and add `OPENROUTER_API_KEY` to `~/.config/agentbridge/.env`.
+
+To work on the repository itself:
+
+```bash
+git clone https://github.com/tsilva/agentbridge.git
+cd agentbridge
+uv sync --extra test
+uv run agentbridge
+```
+
+## Usage
+
+```bash
+curl http://localhost:8082/api/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model":"claudecode/sonnet","messages":[{"role":"user","content":"Hello!"}]}'
+```
+
+Every request requires one of these model namespaces:
+
+- `claudecode/<model>` — `opus`, `sonnet`, `haiku`, or a namespaced Claude slug containing one of those names.
+- `codex/<model>` — passed directly to Codex CLI. `gpt-5.6-sol` and `gpt-5.5` default to high reasoning effort unless the request overrides it.
+- `openrouter/<provider>/<model>` — passed to the official OpenRouter Python SDK.
+
+OpenAI SDKs may use any placeholder API key:
+
+```python
+from openai import OpenAI
+
+client = OpenAI(base_url="http://localhost:8082/api/v1", api_key="not-needed")
+response = client.chat.completions.create(
+    model="codex/gpt-5.6-sol",
+    reasoning_effort="high",
+    messages=[{"role": "user", "content": "Hello from Codex!"}],
+)
+print(response.choices[0].message.content)
+```
+
+Codex can also edit one bounded PNG, JPEG, or WebP reference through the
+purpose-built image route. The request is non-persistent and returns one base64
+raster:
+
+```bash
+curl http://localhost:8082/api/v1/images \
+  -H "Content-Type: application/json" \
+  -d "{\"model\":\"codex/gpt-5.6-sol\",\"prompt\":\"Make this look like a scanner capture without changing any content.\",\"input_references\":[{\"type\":\"image_url\",\"image_url\":{\"url\":\"data:image/png;base64,$PAGE_DATA\"}}],\"n\":1,\"store\":false}"
+```
+
+`GET /api/v1/capabilities` reports whether the local Codex CLI is available,
+authenticated, and supports the strict image and JSON-schema profiles.
+
+## Commands
+
+```bash
+agentbridge                                           # start on 127.0.0.1:8082
+agentbridge --port 8083                               # choose another port
+agentbridge --workers 3                               # set Claude pool and Codex concurrency to 3
+agentbridge --version                                 # print package and git version
+uv run --frozen --extra test pytest -q                # run tests
+uv run --frozen --extra test ruff check agentbridge tests  # lint Python
+uv lock --check                                       # verify the lockfile
+uv build                                              # build wheel and source distribution
+```
+
+## Notes
+
+- Python 3.12+ and at least one authenticated backend are required.
+- Public routes include `POST /api/v1/chat/completions`, `POST /api/v1/images`, `GET /api/v1/models`, `GET /api/v1/capabilities`, `GET /health`, `/dashboard`, and `/dashboard/chat`.
+- `PORT`, `POOL_SIZE`, `CLAUDE_TIMEOUT`, `CODEX_TIMEOUT`, `CODEX_IMAGE_TIMEOUT`, and `OPENROUTER_TIMEOUT` control the server port, pool size, and provider timeouts. `--workers` overrides `POOL_SIZE`; Codex chat and native image generation default to 600-second timeouts, while Claude and OpenRouter default to 120 seconds.
+- `MAX_IMAGE_INPUT_BYTES`, `MAX_IMAGE_OUTPUT_BYTES`, and `MAX_IMAGE_PIXELS` bound native image requests. Defaults are 64 MiB input, 32 MiB output, and 40 million pixels.
+- `AGENTBRIDGE_CONFIG_DIR` moves the user configuration directory. `LOG_DIR` moves session logs, and `MAX_LOG_FILES` limits retained JSON logs.
+- `OPENROUTER_API_KEY`, `OPENROUTER_SITE_URL`, and `OPENROUTER_APP_NAME` configure OpenRouter requests. Process environment variables take precedence over the user `.env` file.
+- Claude clients are created lazily, reused by model, and capped by the worker count. Claude sessions do not load filesystem settings and run with built-in tools disabled.
+- Codex runs one ephemeral `codex exec` process per request in a temporary directory with read-only sandboxing, no approvals, and project rules ignored. Multimodal structured-output calls also ignore user config and disable execution and image-generation tools. Native image calls use the same strict profile, keep execution disabled, and enable the image-generation capability needed for the edit.
+- Claude and Codex function calls are represented through prompted JSON; OpenRouter tool calls pass through its SDK. Session logs and extracted image or PDF attachments are saved under `~/.config/agentbridge/logs/sessions` by default.
+- Set `store: false` on chat requests to suppress session-log artifacts. The native image route requires `store: false`, accepts data URLs only, validates both rasters, locates the result from the structured Codex thread ID, and removes that thread's generated-image directory after the request.
+
+## Publishing
+
+Releases use the `Release` GitHub Actions workflow and PyPI Trusted Publishing for the `agentbridge-cli` project. The publisher is scoped to owner `tsilva`, repository `agentbridge`, workflow `release.yml`, and environment `pypi`; no PyPI API token is required. Releases through `0.1.10` remain available under the previous `agentbridge-py` distribution name.
+
+## Architecture
+
+![agentbridge architecture diagram](./architecture.png)
+
+## License
+
+[MIT](LICENSE)

agentbridge_cli-0.1.11.dist-info/RECORD

@@ -0,0 +1,18 @@
+agentbridge/__init__.py,sha256=n9GlIClgTwfovU-dZJTI7wHhPT7VrYHgBnnoM42grg8,253
+agentbridge/config.py,sha256=9hwXPbXb34Gf4ESyY__VzbfmXlIgC3N2bzpCLQYFULA,2711
+agentbridge/dashboard.py,sha256=lNqRydgiX8nnOrslBX48-JAvg4QioKtOlFGTLjpHD8Y,17483
+agentbridge/models.py,sha256=17_hohGps1uYoIwfeeSHC5bvwSxuYrTi3hgJ_ZvghNE,9215
+agentbridge/pool.py,sha256=KtZ--b1RlT5zm1brP1kgFjpSV3d-Ay85CV38m1vJXHo,12602
+agentbridge/server.py,sha256=6p-t1nVbm3CNVdS5w-JEGCWHPOpUgnMH5lmIB6iqUCw,106493
+agentbridge/templates/dashboard/base.html,sha256=mDmBa7XsYRFRv6otvoethxitTe89qdNYF-k2EbIb2aw,5005
+agentbridge/templates/dashboard/chat.html,sha256=xmgK3y2FD6c3WCWbDLYP6uTdO6G7ZvypHoe4C5JisX0,48224
+agentbridge/templates/dashboard/detail.html,sha256=n2c86asWtuluP9ecncDLbZbDgRr_G35sGJwV10VZE-s,7310
+agentbridge/templates/dashboard/page.html,sha256=KMQtjycFki_6C4g-2s_5FhNDIBX3418tJvw8SrtKBkA,27426
+agentbridge/templates/dashboard/pool.html,sha256=Cj82bQvM-sllWPE8LfzCtUwT8m3De08in9MqcPlTLz4,465
+agentbridge/templates/dashboard/requests.html,sha256=VYNPSb_Vdqkn_7l1zjg_mWAyxhI_W63OK1GQEWeDNII,3038
+agentbridge/_build_info.py,sha256=u78KhLyvgyWjUoCs30k7OxpPsuL-xdvmXoUoRn3hk4Q,21
+agentbridge_cli-0.1.11.dist-info/METADATA,sha256=RSnmYPclW1cUjDTzobWXaz4Om1ULu9j5ooR7YfDfWIA,8076
+agentbridge_cli-0.1.11.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+agentbridge_cli-0.1.11.dist-info/entry_points.txt,sha256=S1bW9OBjg8rfmiOw6i45uGs_dZnHoKxG4YkB5wb106c,56
+agentbridge_cli-0.1.11.dist-info/licenses/LICENSE,sha256=bep-KRGnKqbtPrVpJlAfWnx2eMzwCcTHxNcT8f2QYGo,1063
+agentbridge_cli-0.1.11.dist-info/RECORD,,

agentbridge_cli-0.1.11.dist-info/WHEEL

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

agentbridge_cli-0.1.11.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentbridge = agentbridge.server:main

agentbridge_cli-0.1.11.dist-info/licenses/LICENSE

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