router-maestro 0.1.6__py3-none-any.whl → 0.1.8__py3-none-any.whl

router_maestro/server/schemas/responses.py

@@ -0,0 +1,214 @@
+"""OpenAI Responses API schemas for Codex models."""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+# ============================================================================
+# Input Types
+# ============================================================================
+
+
+class ResponsesInputTextContent(BaseModel):
+    """Text content block in input message."""
+
+    type: str = "input_text"
+    text: str
+
+
+class ResponsesInputMessage(BaseModel):
+    """An input message for the Responses API.
+
+    Supports both simple string content and array of content blocks.
+    """
+
+    type: str = "message"
+    role: str
+    content: str | list[ResponsesInputTextContent | dict[str, Any]]
+
+
+class ResponsesFunctionCallInput(BaseModel):
+    """A function call from a previous assistant response."""
+
+    type: str = "function_call"
+    id: str | None = None
+    call_id: str
+    name: str
+    arguments: str
+    status: str = "completed"
+
+
+class ResponsesFunctionCallOutput(BaseModel):
+    """Output/result from a function call execution."""
+
+    type: str = "function_call_output"
+    call_id: str
+    output: str
+
+
+# ============================================================================
+# Tool Definitions
+# ============================================================================
+
+
+class ResponsesFunctionParameters(BaseModel):
+    """JSON Schema for function parameters."""
+
+    type: str = "object"
+    properties: dict[str, Any] = Field(default_factory=dict)
+    required: list[str] = Field(default_factory=list)
+
+
+class ResponsesFunctionTool(BaseModel):
+    """A function tool definition."""
+
+    type: str = "function"
+    name: str
+    description: str | None = None
+    parameters: dict[str, Any] | None = None
+    strict: bool | None = None
+
+
+class ResponsesToolChoiceFunction(BaseModel):
+    """Specific function tool choice."""
+
+    type: str = "function"
+    name: str
+
+
+# ============================================================================
+# Request
+# ============================================================================
+
+
+class ResponsesRequest(BaseModel):
+    """Request for the Responses API (used by Codex models).
+
+    The input can be:
+    - A simple string prompt
+    - A list of message objects with role and content
+    - A list including function_call and function_call_output items
+    """
+
+    model: str
+    input: (
+        str
+        | list[
+            ResponsesInputMessage
+            | ResponsesFunctionCallInput
+            | ResponsesFunctionCallOutput
+            | dict[str, Any]
+        ]
+    )
+    stream: bool = False
+    instructions: str | None = None
+    temperature: float = Field(default=1.0, ge=0, le=2)
+    max_output_tokens: int | None = None
+    # Tool support
+    tools: list[ResponsesFunctionTool | dict[str, Any]] | None = None
+    tool_choice: str | ResponsesToolChoiceFunction | dict[str, Any] | None = None
+    parallel_tool_calls: bool | None = None
+
+
+# ============================================================================
+# Output Types
+# ============================================================================
+
+
+class ResponsesOutputText(BaseModel):
+    """Text content in the response output."""
+
+    type: str = "output_text"
+    text: str
+    annotations: list[Any] = Field(default_factory=list)
+
+
+class ResponsesMessageOutput(BaseModel):
+    """A message output in the response."""
+
+    type: str = "message"
+    id: str
+    role: str = "assistant"
+    status: str = "completed"
+    content: list[ResponsesOutputText]
+
+
+class ResponsesFunctionCallOutput(BaseModel):
+    """A function call output in the response."""
+
+    type: str = "function_call"
+    id: str
+    call_id: str
+    name: str
+    arguments: str
+    status: str = "completed"
+
+
+class ResponsesReasoningOutput(BaseModel):
+    """A reasoning output in the response."""
+
+    type: str = "reasoning"
+    id: str
+    summary: list[dict[str, Any]] = Field(default_factory=list)
+
+
+class ResponsesUsage(BaseModel):
+    """Token usage information for Responses API."""
+
+    input_tokens: int
+    output_tokens: int
+    total_tokens: int
+    input_tokens_details: dict[str, int] | None = None
+    output_tokens_details: dict[str, int] | None = None
+
+
+# ============================================================================
+# Response
+# ============================================================================
+
+
+class ResponsesResponse(BaseModel):
+    """Response from the Responses API."""
+
+    id: str
+    object: str = "response"
+    model: str
+    status: str = "completed"
+    output: list[
+        ResponsesReasoningOutput
+        | ResponsesMessageOutput
+        | ResponsesFunctionCallOutput
+        | dict[str, Any]
+    ]
+    usage: ResponsesUsage | None = None
+    error: dict[str, Any] | None = None
+    incomplete_details: dict[str, Any] | None = None
+
+
+# ============================================================================
+# Streaming Events
+# ============================================================================
+
+
+class ResponsesStreamEvent(BaseModel):
+    """A streaming event from the Responses API."""
+
+    type: str
+    # Additional fields depend on event type
+
+
+class ResponsesDeltaEvent(BaseModel):
+    """A delta event in streaming response."""
+
+    type: str = "response.output_text.delta"
+    item_id: str
+    output_index: int
+    content_index: int
+    delta: str
+
+
+class ResponsesDoneEvent(BaseModel):
+    """A done event in streaming response."""
+
+    type: str = "response.done"
+    response: ResponsesResponse

{router_maestro-0.1.6.dist-info → router_maestro-0.1.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: router-maestro
-Version: 0.1.6
+Version: 0.1.8
 Summary: Multi-model routing and load balancing system with OpenAI-compatible API
 Author-email: Kanwen Li <likanwen@icloud.com>
 License-Expression: MIT
@@ -26,6 +26,7 @@ Requires-Dist: pydantic>=2.5.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: tomlkit>=0.12.0
 Requires-Dist: typer>=0.12.0
 Requires-Dist: uvicorn>=0.27.0
 Provides-Extra: dev
@@ -118,14 +119,33 @@ router-maestro auth login github-copilot
 #   3. Authorize "GitHub Copilot Chat"
 ```
 
-### 4. Configure Claude Code
+### 4. Configure Your CLI Tool
+
+#### Claude Code
 
 ```bash
 router-maestro config claude-code
 # Follow the wizard to select models
 ```
 
-**Done!** Now run `claude` and your requests will route through Router-Maestro.
+#### OpenAI Codex (CLI, Extension, App)
+
+```bash
+router-maestro config codex
+# Follow the wizard to select models
+```
+
+After configuration, set the API key environment variable:
+
+```bash
+# Get your API key
+router-maestro server show-key
+
+# Set the environment variable (add to your shell profile)
+export ROUTER_MAESTRO_API_KEY="your-api-key-here"
+```
+
+**Done!** Now run `claude` or `codex` and your requests will route through Router-Maestro.
 
 > **For production deployment**, see the [Deployment](#deployment) section.
 
@@ -258,6 +278,7 @@ router-maestro model list
 | Command              | Description                   |
 | -------------------- | ----------------------------- |
 | `config claude-code` | Generate Claude Code settings |
+| `config codex`       | Generate Codex config (CLI/Extension/App) |
 
 ## API Reference
 

{router_maestro-0.1.6.dist-info → router_maestro-0.1.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-router_maestro/__init__.py,sha256=HJQ2eE5cH3zVHfskAha2jYgacsEZHU9FmRfQTzraiAE,92
+router_maestro/__init__.py,sha256=GKAiKIjY7YgU-RUu1wYqMOh8QQzcwBku1sGSfeGIKKw,92
 router_maestro/__main__.py,sha256=cUHr8B7JBiv5HhnN6l2iayDkGSBpI5Kf4I3jv9I_I3o,121
 router_maestro/auth/__init__.py,sha256=0JgD1w2gtGSkj809kgSKQanYYkncg6eF-hHoz-jQPgo,353
 router_maestro/auth/github_oauth.py,sha256=acQlAA2Zh6c8KQYdzXbC4ww0EJ41AgvbI5ixpFuNoRg,5060
@@ -7,7 +7,7 @@ router_maestro/auth/storage.py,sha256=TCLxgQ1lWcWD4xJXJzx5OMpvuAun_LSRItK0zhR6H0
 router_maestro/cli/__init__.py,sha256=yIAshaHpLL0WrDFmRpoMRM2EUe75x0wmM5NlGW3C89s,37
 router_maestro/cli/auth.py,sha256=eq5LBUohbMnHS4dZeyvq4OQAjzdrJ-StP2FGuUhkKa0,5940
 router_maestro/cli/client.py,sha256=mRzpsA_Dxn-Xq7W1_t6EiyddMI0a3cvuTL6-2JuV4mE,9383
-router_maestro/cli/config.py,sha256=SGrWdd59eX1F8KzhHMJ_u2AkYfFuYlyLl6Nfz6u_rNk,6100
+router_maestro/cli/config.py,sha256=5r3r8_VH18C0zEYpRDV4ZslbtJ9HfKWUMzKXcwtNU0M,10734
 router_maestro/cli/context.py,sha256=EPbT7fReIW17veU76CSAcv8QjzMsCIPm1QDBlGsV8fQ,4549
 router_maestro/cli/main.py,sha256=5yiK4Q149goSB2KKzgMuF5EpcC8FBzOUCkEt8wY5NAU,1314
 router_maestro/cli/model.py,sha256=2IG3IpQWh8Ejdv5Htcgr90O2v2UAa80TU15oOniPdvk,9054
@@ -19,34 +19,36 @@ router_maestro/config/priorities.py,sha256=wEBs6CmLQiw0ehuA-kh7topyac6APopxaR83C
 router_maestro/config/providers.py,sha256=yMU_DFh4_eQXMT8jGImqwzAPHp0L3fR34gG2r-4Zhnw,1158
 router_maestro/config/server.py,sha256=Mr7Axbo8b1z3OFEe_G8VuO7wvx_pA32-ZBbT4nSRdX0,3049
 router_maestro/config/settings.py,sha256=cEgE0XjdYMbB39wJDQiTurWSbfJwjAjLI8g7ZOiyd1o,2363
-router_maestro/providers/__init__.py,sha256=Cic08fXrcBPbxSLOqLg3edTThop6j--AqdcwI7wJSp8,759
+router_maestro/providers/__init__.py,sha256=ozZMBw5SPoUd8OoTaLWX7ddlxz6hHMlMpsJXf3D9g8g,955
 router_maestro/providers/anthropic.py,sha256=zhBDtPootCVCYfGyrsogdy3j8jC1aMwi01hWkg-uKmA,8077
-router_maestro/providers/base.py,sha256=2WvR-jjkYNkQUy6EBXvuOkv3v7xCvAfgVigvuKukG3o,3111
-router_maestro/providers/copilot.py,sha256=NieOXBecwymSnB1Nm_JKVvzeZyZnO8g6Y1kNaLHy3XE,12974
+router_maestro/providers/base.py,sha256=YeejIPYXPv00fbup5ahuYvL362rXw2yn4RHY5TElCw0,5367
+router_maestro/providers/copilot.py,sha256=Mfvx4qIZUZMHIjHWTaC4JTDC3d62KrnhLHRA4QwFpZA,26662
 router_maestro/providers/openai.py,sha256=Bsq5mzAVf4CawH2Tn80y3-MyLLVeZ3VsPxGDNH1t_Nk,7647
 router_maestro/providers/openai_compat.py,sha256=ef4RttKVZUTBiRed4BEuC2Jg8vr5GM7YqPUtFYeAhZo,6383
 router_maestro/routing/__init__.py,sha256=eCEQVbg1LAfcSVLQZpZtYf8ImbOhFIaR7POUb1pCbXM,169
-router_maestro/routing/router.py,sha256=uPk_sSyxdcmq-b-LJgPwtQOLNXDAvjDjs2A8po7MqQE,20402
+router_maestro/routing/router.py,sha256=gi1Zy7Eo5SasdY4tpkXj5X3bFZ3UR4Efc-RW0Xq_YpA,26617
 router_maestro/server/__init__.py,sha256=YzExJfP0jw6hXx84lo0yPVU0wG17B16SfdyEpjstpxk,128
-router_maestro/server/app.py,sha256=rI2TuCS_STzmzdds5Tq2vzoP9y9bpRFJJwNs5e8uTbU,2707
+router_maestro/server/app.py,sha256=SIYdqlA93QzHDZuicG4-cXwkjelteeeyfe04iZUIkn8,2831
 router_maestro/server/oauth_sessions.py,sha256=r_VM6vAtbo5HAmXjYt6XoECBcWGxqABKGbVmW8HoCz0,4625
 router_maestro/server/translation.py,sha256=TrYfIb5M5MAUC4TD5By8X3RONSZ6cV1YS_JwzIc-bVk,22170
 router_maestro/server/middleware/__init__.py,sha256=PhtP2E04wApnOUBLE76mrOa0sSHp7reHmIl7PaCAylY,187
 router_maestro/server/middleware/auth.py,sha256=Ak3k5cC8m4qPGUIheuOB--QiFvs6GIAcTRJqtCGCjAA,2018
-router_maestro/server/routes/__init__.py,sha256=eGEpNCnSRVQC1pFL7_evDmZfkMrviuI-n1okAS-YnhM,397
+router_maestro/server/routes/__init__.py,sha256=5gOgr_rSX_YtSwAxSW1RfC1kLyHOu9SIaWdkTvLo1MU,518
 router_maestro/server/routes/admin.py,sha256=oub4hDrYaytuorXkJzmz0YZ4Z2rcyNuwKcK_4IGvcDY,8942
-router_maestro/server/routes/anthropic.py,sha256=r9GKXdb5yg0G6BFvbKx2-hIGlCM736NgEIESXbSomgE,10794
-router_maestro/server/routes/chat.py,sha256=vyYX1ILhgAb9HYD87h1U3c5btpplqkTaejA81pWg4Oo,4752
-router_maestro/server/routes/models.py,sha256=PTSXojNFN9j90Bke74ZO6sEsfIc8u_4A69eW1QzFIbc,716
-router_maestro/server/schemas/__init__.py,sha256=VmJZoTMLb-bF33m79urhbejVdLfjDGMqCJP5QvWbHsU,1176
+router_maestro/server/routes/anthropic.py,sha256=vzbgnYNYt5mOCeZgarSZ6jiIr_d9v64BPtIjIquz6Ew,13287
+router_maestro/server/routes/chat.py,sha256=nXeZVXaJl9BsU3OMs1OW6vFV5PRHOjylyOitM2dXpFM,4729
+router_maestro/server/routes/models.py,sha256=SYHwaMCLrz3F-9fIpPAFjmS_wil5DQIPtzqHV_rimfc,704
+router_maestro/server/routes/responses.py,sha256=9_qrJdEAKuo3Mgc3FoieyDAbGOgAbF2woB-ZX8Joa1o,20402
+router_maestro/server/schemas/__init__.py,sha256=VQqkyEhoRuXJxPs87rMT6rrfupxcY_qBSbU-7t6ZdZQ,2102
 router_maestro/server/schemas/admin.py,sha256=DuUojkCcq9n8pDhWG6L0SpzQooh91lmHjCRzgZ4AMwk,2369
 router_maestro/server/schemas/anthropic.py,sha256=S5TFYDd8Iw7Oxjki6ng84DGVB90G0-mOza5D5r3rwOY,6566
 router_maestro/server/schemas/openai.py,sha256=s2487RYIn1h-CIaUpLue9BScDaTsafbVg5yc-kKhfME,2141
+router_maestro/server/schemas/responses.py,sha256=v6AqmgE4OVz8Funu2e-SIP52eIJlRW1naudCqZ0SJIU,5538
 router_maestro/utils/__init__.py,sha256=oSQyV--FueMPggRfjWWVnAKtjkcZWFOm9hCTymu0oZU,409
 router_maestro/utils/logging.py,sha256=gJWoRYibAxCWn4VmTmnrwpBRzQ7Uu5YIEk5zDiF9X_k,2393
 router_maestro/utils/tokens.py,sha256=U5PXJv_6ba5xgMBG0c5qB96Yu6uLscSUjMWYTdNests,1530
-router_maestro-0.1.6.dist-info/METADATA,sha256=5NS_Z6XU27HDauDX1_ZIdPTD_RrXLnFCgTPVTQ-FSAM,12501
-router_maestro-0.1.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-router_maestro-0.1.6.dist-info/entry_points.txt,sha256=zoFUxxvNcFe0nTgpRbIdygIDEOla3KbvW6HbOCOlgv4,63
-router_maestro-0.1.6.dist-info/licenses/LICENSE,sha256=Ea86BSGu7_tpLAuzif_JmM9zjMoKQEf95VVF9sZw3Jo,1084
-router_maestro-0.1.6.dist-info/RECORD,,
+router_maestro-0.1.8.dist-info/METADATA,sha256=ZissyATuGtEmN0BbLn5Pi5x9ponbMLqWfMIh4oodKUQ,12984
+router_maestro-0.1.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+router_maestro-0.1.8.dist-info/entry_points.txt,sha256=zoFUxxvNcFe0nTgpRbIdygIDEOla3KbvW6HbOCOlgv4,63
+router_maestro-0.1.8.dist-info/licenses/LICENSE,sha256=Ea86BSGu7_tpLAuzif_JmM9zjMoKQEf95VVF9sZw3Jo,1084
+router_maestro-0.1.8.dist-info/RECORD,,