Skip to content

Autonomous research system for measurable, computer-executable research.

Python

feat(providers): add Cloudflare, Groq, Mistral, OrcaRouter and xAI providers (#200)

Glen-SP34e6de7e7dfa
diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
index b51da47..c9e3600 100644
--- a/docs/getting-started/quickstart.md
+++ b/docs/getting-started/quickstart.md
@@ -112,7 +112,7 @@ profiles neither require nor inspect this login.
For sustained, cost-sensitive research, prefer an
[open-source model API](../guides/open-source-model-apis.md) whose cache reuse,
quality, and throughput have been checked on a representative workload. The
-selector includes maintained DeepSeek API, OpenRouter API, and Anthropic API
+selector includes maintained DeepSeek API, OpenRouter API, OrcaRouter API, and Anthropic API
profiles. Enter the selected provider's key at the local masked prompt when
requested.
diff --git a/docs/guides/agent-runtimes.md b/docs/guides/agent-runtimes.md
index 2d8d820..d83c58a 100644
--- a/docs/guides/agent-runtimes.md
+++ b/docs/guides/agent-runtimes.md
@@ -130,6 +130,11 @@ The Codex app-server consumes the Responses protocol. API provider routing is:
| OpenAI / `model_provider:openai_compatible` | Direct SDK/app-server connection |
| `model_provider:deepseek_alias` | Private run-scoped `codex-relay` to DeepSeek Chat Completions |
| `model_provider:openrouter` | Private run-scoped `codex-relay` to OpenRouter Chat Completions |
+| `model_provider:orcarouter` | Private run-scoped `codex-relay` to OrcaRouter Chat Completions |
+| `model_provider:cloudflare` | Private run-scoped `codex-relay` to Cloudflare Workers AI Chat Completions |
+| `model_provider:groq_alias` | Private run-scoped `codex-relay` to Groq Chat Completions |
+| `model_provider:mistral_alias` | Private run-scoped `codex-relay` to Mistral Chat Completions |
+| `model_provider:xai_alias` | Private run-scoped `codex-relay` to xAI Chat Completions |
Praxist starts and stops the relay; operators must not launch a relay per peer.
The relay listens only on an ephemeral local port and receives only the selected
@@ -142,7 +147,7 @@ reasoning overrides are added only when the task selects an explicit policy;
Lossless context-efficiency controls are documented in
[Cost Optimization](cost-optimization.md). The automatic policy applies to
-Codex-native mode and OpenRouter routes; direct DeepSeek is explicitly
+Codex-native mode and OpenRouter/OrcaRouter routes; direct DeepSeek is explicitly
excluded.
## Reasoning Policy
@@ -172,8 +177,8 @@ private run-scoped relay injects the same policy into Chat Completions requests
and retains the API provider's reasoning state across tool-call subrequests.
Praxist does not summarize or reconstruct that state. Native Codex models,
including Codex-native `gpt-5.6-luna`, receive the closest supported SDK effort
-(`max` maps to `xhigh`). OpenRouter's relay route uses its unified
-`reasoning.effort` object.
+(`max` maps to `xhigh`). OpenRouter and OrcaRouter relay routes use their
+unified `reasoning.effort` object.
Models whose API provider contract requires reasoning may reject `off`; Praxist
surfaces that API provider error and leaves the user's policy unchanged.
diff --git a/docs/guides/credentials.md b/docs/guides/credentials.md
index 5595d02..84bd222 100644
--- a/docs/guides/credentials.md
+++ b/docs/guides/credentials.md
@@ -77,9 +77,18 @@ Other API providers remain supported when the operator explicitly chooses them:
```bash
export OPENROUTER_API_KEY=...
+export ORCAROUTER_API_KEY=...
export ANTHROPIC_API_KEY=...
+export CLOUDFLARE_API_KEY=...
+export CLOUDFLARE_ACCOUNT_ID=...
+export GROQ_API_KEY=...
+export MISTRAL_API_KEY=...
+export XAI_API_KEY=...
```
+Cloudflare Workers AI needs both its API token and account ID; alternatively,
+set `CLOUDFLARE_BASE_URL` to the complete account-scoped OpenAI-compatible URL.
+
Praxist reads `${XDG_CONFIG_HOME:-$HOME/.config}/praxist/env` by default. Use
`PRAXIST_CONFIG_FILE=/path/to/env` or command-local `--config-file
/path/to/env` for another configuration. The command-local flag takes precedence;
diff --git a/docs/guides/model-providers.md b/docs/guides/model-providers.md
index bc9ff29..9a55b3a 100644
--- a/docs/guides/model-providers.md
+++ b/docs/guides/model-providers.md
@@ -7,9 +7,30 @@ Agent runtime plugins execute the agent loops.
## Built-In API Provider Shapes
- `model_provider:openrouter` for OpenRouter-routed model names.
+- `model_provider:orcarouter` for OrcaRouter-routed model names.
- `model_provider:openai_compatible` for OpenAI-compatible endpoints.
- `model_provider:anthropic_messages` for native Anthropic Messages style.
- `model_provider:deepseek_alias` for DeepSeek-compatible aliases.
+- `model_provider:cloudflare` for Cloudflare Workers AI.
+- `model_provider:groq_alias` for Groq OpenAI-compatible aliases.
+- `model_provider:mistral_alias` for Mistral OpenAI-compatible aliases.
+- `model_provider:xai_alias` for xAI OpenAI-compatible aliases.
+
+### Cloudflare Workers AI
+
+Workers AI is OpenAI-compatible only; it publishes no Anthropic Messages
+route, so it is compatible with `agent_runtime:codex_sdk` and not with
+`agent_runtime:claude_sdk`. Its endpoint base is account-scoped rather than
+fixed: `https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1`,
+interpolated from `CLOUDFLARE_ACCOUNT_ID`. Set `CLOUDFLARE_BASE_URL` to
+override the whole base URL, and `CLOUDFLARE_API_KEY` for the bearer
+credential.
+
+The manifest declares the `cloudflare_workers_ai` API format rather than
+`openai_compatible` for one reason: Workers AI model ids are full
+`@cf/vendor/model` paths, and the generic OpenAI-compatible normalization
+strips everything before the first `/`. The wire protocol is otherwise
+plain OpenAI chat-completions.
API provider names represent API format and routing. A task or operator may
override the `ModelProfile` used by a stage.
diff --git a/docs/guides/open-source-model-apis.md b/docs/guides/open-source-model-apis.md
index 3c581c7..ff87e08 100644
--- a/docs/guides/open-source-model-apis.md
+++ b/docs/guides/open-source-model-apis.md
@@ -12,7 +12,8 @@ profile during setup.
|---|---|---|
| 1 | **DeepSeek V4 Pro** | Praxist provides a maintained direct API profile. Evaluate it first where the service is available and appropriate for the project. |
| 2 | **Open-source models through OpenRouter** | Use the OpenRouter profile when routing flexibility matters. Select the exact model explicitly and verify that its route reports useful cache reuse. |
-| 3 | **Operator-managed open-source model endpoints** | Add or select a compatible provider plugin when deployment policy requires a private or self-hosted endpoint. Validate the plugin contract before a long run. |
+| 3 | **Open-source models through OrcaRouter** | Use the OrcaRouter profile when adaptive routing and zero-markup inference matter. The `orcarouter/auto` model picks a live route per request. |
+| 4 | **Operator-managed open-source model endpoints** | Add or select a compatible provider plugin when deployment policy requires a private or self-hosted endpoint. Validate the plugin contract before a long run. |
The order is a practical starting point, not a claim that one model is best for
every task. Availability, pricing, model behavior, and provider-side caching can
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 7fb3e00..9604a38 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -268,7 +268,7 @@ Pip-first Praxist host setup. Run this after installing the package and runtime
usage: praxist setup [-h] [--agent-system {claude_sdk,codex_sdk}] [--provider PROVIDER]
[--model MODEL] [--api-key-stdin | --api-key-env API_KEY_ENV | --no-api-key]
[--interactive]
- [--profile {codex-native,deepseek-api,openrouter-api,anthropic-api}]
+ [--profile {codex-native,deepseek-api,openrouter-api,orcarouter-api,anthropic-api}]
[--list-profiles] [--agent-managed] [--install-skills {codex,claude,none}]
[--config-file CONFIG_FILE] [--json] [--dry-run] [--skip-doctor]
```
@@ -283,7 +283,7 @@ usage: praxist setup [-h] [--agent-system {claude_sdk,codex_sdk}] [--provider PR
| `--api-key-env` | no | Read the provider API key from this environment variable. |
| `--no-api-key` | no | Configure a supported no-key authentication route. |
| `--interactive` | no | Review the License and User Agreement, choose optional privacy, and select a coherent runtime profile in a local TTY wizard. |
-| `--profile` | no | Apply one complete profile; a missing API key is requested in the local terminal. Choices: `codex-native`, `deepseek-api`, `openrouter-api`, `anthropic-api`. |
+| `--profile` | no | Apply one complete profile; a missing API key is requested in the local terminal. Choices: `codex-native`, `deepseek-api`, `openrouter-api`, `orcarouter-api`, `anthropic-api`. |
| `--list-profiles` | no | List supported setup profiles as JSON and exit without changes. |
| `--agent-managed`, `--codex-managed` | no | Report the read-only agent-managed first-use decision state and next required action as JSON. --codex-managed remains a compatibility alias. |
| `--install-skills` | no | Install bundled skills for an agent host (interactive default: codex). Choices: `codex`, `claude`, `none`. |
diff --git a/docs/reference/plugins.md b/docs/reference/plugins.md
index eae40ac..2328201 100644
--- a/docs/reference/plugins.md
+++ b/docs/reference/plugins.md
@@ -12,12 +12,22 @@ This page documents executable generic plugin boundaries.
::: praxist.plugins.model_providers.openrouter.adapter
+::: praxist.plugins.model_providers.orcarouter.adapter
+
::: praxist.plugins.model_providers.anthropic_messages.adapter
::: praxist.plugins.model_providers.openai_compatible.adapter
::: praxist.plugins.model_providers.deepseek_alias.adapter
+::: praxist.plugins.model_providers.cloudflare.adapter
+
+::: praxist.plugins.model_providers.groq_alias.adapter
+
+::: praxist.plugins.model_providers.mistral_alias.adapter
+
+::: praxist.plugins.model_providers.xai_alias.adapter
+
## Workflow Stage
::: praxist.plugins.workflow_stages.research_loop.startup
diff --git a/praxist/cli/_env.py b/praxist/cli/_env.py
index fddc430..8af8328 100644
--- a/praxist/cli/_env.py
+++ b/praxist/cli/_env.py
@@ -9,6 +9,13 @@ from __future__ import annotations
import os
+from praxist.core.cloudflare import (
+ CLOUDFLARE_KEY_VAR,
+ CLOUDFLARE_PROVIDER,
+ CLOUDFLARE_PROVIDER_REF,
+ workers_ai_base_url,
+)
+
AGENT_SYSTEM_VALUES: tuple[str, ...] = (
"claude_sdk",
"codex_sdk",
@@ -37,6 +44,8 @@ PROVIDER_KEY_MAP: dict[str, str] = {
"groq": "GROQ_API_KEY",
"xai": "XAI_API_KEY",
"openrouter": "OPENROUTER_API_KEY",
+ "orcarouter": "ORCAROUTER_API_KEY",
+ CLOUDFLARE_PROVIDER: CLOUDFLARE_KEY_VAR,
"brave": "BRAVE_API_KEY",
}
"""Known provider/tool credentials accepted by Praxist operator configuration."""
@@ -45,7 +54,12 @@ PROVIDER_REF_FOR_SHORT_NAME: dict[str, str] = {
"anthropic": "model_provider:anthropic_messages",
"openai": "model_provider:openai_compatible",
"openrouter": "model_provider:openrouter",
+ "orcarouter": "model_provider:orcarouter",
"deepseek": "model_provider:deepseek_alias",
+ CLOUDFLARE_PROVIDER: CLOUDFLARE_PROVIDER_REF,
+ "groq": "model_provider:groq_alias",
+ "mistral": "model_provider:mistral_alias",
+ "xai": "model_provider:xai_alias",
}
"""Canonical plugin ref for every built-in model provider."""
@@ -59,6 +73,7 @@ PROVIDER_BASE_URL: dict[str, str] = {
"groq": "https://api.groq.com/openai/v1",
"xai": "https://api.x.ai/v1",
"openrouter": "https://openrouter.ai/api/v1",
+ "orcarouter": "https://api.orcarouter.ai/v1",
}
@@ -83,3 +98,15 @@ def agent_system_for_runtime_ref(runtime_ref: str) -> str | None:
if normalized == candidate:
return agent_system
return None
+
+
+def provider_base_url(provider: str) -> str:
+ """Return the OpenAI-compatible base URL for a built-in provider.
+
+ Cloudflare Workers AI is account-scoped, so its URL is resolved at call
+ time from the environment instead of being a static table entry.
+ """
+ normalized = provider.strip().lower()
+ if normalized == CLOUDFLARE_PROVIDER:
+ return workers_ai_base_url()
+ return PROVIDER_BASE_URL.get(normalized, "")
diff --git a/praxist/cli/_setup_common.py b/praxist/cli/_setup_common.py
index 6335804..1b83568 100644
--- a/praxist/cli/_setup_common.py
+++ b/praxist/cli/_setup_common.py
@@ -121,6 +121,9 @@ def provider_key_var(provider: str) -> str:
"anthropic_messages": "anthropic",
"openai_compatible": "openai",
"deepseek_alias": "deepseek",
+ "groq_alias": "groq",
+ "mistral_alias": "mistral",
+ "xai_alias": "xai",
"dashscope": "qwen",
}.get(normalized, normalized)
try:
@@ -136,6 +139,9 @@ def provider_short_name(provider: str) -> str:
"anthropic_messages": "anthropic",
"openai_compatible": "openai",
"deepseek_alias": "deepseek",
+ "groq_alias": "groq",
+ "mistral_alias": "mistral",
+ "xai_alias": "xai",
"dashscope": "qwen",
}.get(normalized, normalized)
@@ -148,6 +154,9 @@ def provider_plugin_ref(provider: str) -> str:
"anthropic_messages": "anthropic",
"openai_compatible": "openai",
"deepseek_alias": "deepseek",
+ "groq_alias": "groq",
+ "mistral_alias": "mistral",
+ "xai_alias": "xai",
}.get(normalized, normalized)
if built_in in PROVIDER_REF_FOR_SHORT_NAME:
return PROVIDER_REF_FOR_SHORT_NAME[built_in]
diff --git a/praxist/cli/setup.py b/praxist/cli/setup.py
index 3aeadd5..158b825 100644
--- a/praxist/cli/setup.py
+++ b/praxist/cli/setup.py
@@ -116,6 +116,17 @@ SETUP_PROFILES: tuple[SetupProfile, ...] = (
"provider_api_key",
"requires an OpenRouter API key entered only through the local masked prompt",
),
+ SetupProfile(
+ "orcarouter-api",
+ "OrcaRouter API",
+ "OrcaRouter model routing through claude_sdk",
+ "orcarouter",
+ "claude_sdk",
+ "orcarouter/auto",
+ True,
+ "provider_api_key",
+ "requires an OrcaRouter API key entered only through the local masked prompt",
+ ),
SetupProfile(
"anthropic-api",
"Anthropic API",
diff --git a/praxist/cli/start.py b/praxist/cli/start.py
index 918cdd2..4af607b 100644
--- a/praxist/cli/start.py
+++ b/praxist/cli/start.py
@@ -97,6 +97,8 @@ from praxist.cli.registry import (
write_entry,
)
from praxist.cli.status import pid_is_alive, read_ps_table, registry_command_matches
+from praxist.core.cloudflare import CLOUDFLARE_DEFAULT_MODEL as CLOUDFLARE_MODEL
+from praxist.core.cloudflare import CLOUDFLARE_PROVIDER
from praxist.task_spec import load_task_spec
if TYPE_CHECKING: # pragma: no cover - import only for static type checkers
@@ -126,13 +128,17 @@ runtime and the production default per AGENTS.md §7.
"""
OPENROUTER_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME["openrouter"]
+ORCAROUTER_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME["orcarouter"]
ANTHROPIC_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME["anthropic"]
OPENAI_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME["openai"]
DEEPSEEK_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME["deepseek"]
+CLOUDFLARE_PROVIDER_REF = PROVIDER_REF_FOR_SHORT_NAME[CLOUDFLARE_PROVIDER]
OPENROUTER_DEFAULT_MODEL = "anthropic/claude-opus-4.7"
+ORCAROUTER_DEFAULT_MODEL = "orcarouter/auto"
ANTHROPIC_DEFAULT_MODEL = "claude-opus-4-7"
DEEPSEEK_DEFAULT_MODEL = "deepseek-v4-pro[1m]"
+CLOUDFLARE_DEFAULT_MODEL = CLOUDFLARE_MODEL
# Back-compat alias retained so callers that imported the old constant
# from previous PRs keep working until they migrate to
@@ -852,6 +858,8 @@ def _resolve_provider_ref(raw: str | None, agent_system: str) -> str:
return PROVIDER_REF_FOR_SHORT_NAME["deepseek"]
if getenv("OPENROUTER_API_KEY", ""):
return OPENROUTER_PROVIDER_REF
+ if getenv("ORCAROUTER_API_KEY", ""):
+ return ORCAROUTER_PROVIDER_REF
if agent_system == "codex_sdk":
default_short = default_provider_for_agent_system(agent_system)
return PROVIDER_REF_FOR_SHORT_NAME.get(default_short, OPENAI_PROVIDER_REF)
@@ -871,8 +879,12 @@ def _resolve_model(raw: str | None, provider_ref: str, agent_system: str) -> str
return from_env
if provider_ref == OPENROUTER_PROVIDER_REF:
return OPENROUTER_DEFAULT_MODEL
+ if provider_ref == ORCAROUTER_PROVIDER_REF:
+ return ORCAROUTER_DEFAULT_MODEL
if provider_ref == DEEPSEEK_PROVIDER_REF:
return DEEPSEEK_DEFAULT_MODEL
+ if provider_ref == CLOUDFLARE_PROVIDER_REF:
+ return CLOUDFLARE_DEFAULT_MODEL
if provider_ref == ANTHROPIC_PROVIDER_REF:
return ANTHROPIC_DEFAULT_MODEL
return ""
diff --git a/praxist/core/cloudflare.py b/praxist/core/cloudflare.py
new file mode 100644
index 0000000..1eafd40
--- /dev/null
+++ b/praxist/core/cloudflare.py
@@ -0,0 +1,83 @@
+"""Cloudflare Workers AI endpoint helpers.
+
+Workers AI exposes one OpenAI-compatible surface at
+``/client/v4/accounts/{account_id}/ai/v1`` and no Anthropic Messages route,
+so every Praxist path that talks to it reuses the OpenAI-compatible client
+and only varies the base URL and bearer credential.
+
+The account id is part of the URL rather than the credential, so it is
+resolved here once and shared by the CLI registry and the Codex relay.
+"""
+
+from __future__ import annotations
+
+import os
+from collections.abc import Mapping
+
+CLOUDFLARE_PROVIDER = "cloudflare"
+"""Short provider name persisted as ``PRAXIST_LLM_PROVIDER``."""
+
+CLOUDFLARE_PROVIDER_REF = "model_provider:cloudflare"
+"""Canonical model-provider plugin ref for Workers AI."""
+
+CLOUDFLARE_API_FORMAT = "cloudflare_workers_ai"
+"""OpenAI-compatible wire format that keeps full ``@cf/vendor/model`` ids."""
+
+CLOUDFLARE_KEY_VAR = "CLOUDFLARE_API_KEY"
+"""Bearer credential variable for the Workers AI REST endpoint."""
+
+CLOUDFLARE_ACCOUNT_VAR = "CLOUDFLARE_ACCOUNT_ID"
+"""Account id variable interpolated into the Workers AI base URL."""
+
+CLOUDFLARE_BASE_URL_VAR = "CLOUDFLARE_BASE_URL"
+"""Explicit base-URL override that wins over account-id interpolation."""
+
+CLOUDFLARE_BASE_URL_TEMPLATE = "https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1"
+"""OpenAI-compatible Workers AI base URL; ``/chat/completions`` hangs off it."""
+
+CLOUDFLARE_DEFAULT_MODEL = "@cf/deepseek-ai/deepseek-v4-flash-0731"
+"""Cheap/fast DeepSeek tier served by Workers AI."""
+
+CLOUDFLARE_STRONG_MODEL = "@cf/deepseek-ai/deepseek-v4-pro-0813"
+"""Strong-reasoner DeepSeek tier served by Workers AI."""
+
+
+def workers_ai_base_url(
+ env: Mapping[str, str] | None = None,
+ *,
+ account_id: str | None = None,
+) -> str:
+ """Return the Workers AI OpenAI-compatible base URL for this host.
+
+ Resolution order: an explicit ``account_id`` argument, then
+ ``CLOUDFLARE_BASE_URL`` as a whole-URL override, then
+ ``CLOUDFLARE_ACCOUNT_ID`` from the environment.
+ """
+ source = os.environ if env is None else env
+ explicit = (account_id or "").strip()
+ if explicit:
+ return CLOUDFLARE_BASE_URL_TEMPLATE.format(account_id=explicit)
+ override = str(source.get(CLOUDFLARE_BASE_URL_VAR, "")).strip().rstrip("/")
+ if override:
+ return override
+ resolved = str(source.get(CLOUDFLARE_ACCOUNT_VAR, "")).strip()
+ if not resolved:
+ raise ValueError(
+ f"{CLOUDFLARE_ACCOUNT_VAR} is not set; Workers AI base URLs are account-scoped. "
+ f"Export {CLOUDFLARE_ACCOUNT_VAR} or set {CLOUDFLARE_BASE_URL_VAR} to a full base URL."
+ )
+ return CLOUDFLARE_BASE_URL_TEMPLATE.format(account_id=resolved)
+
+
+__all__ = [
+ "CLOUDFLARE_ACCOUNT_VAR",
+ "CLOUDFLARE_API_FORMAT",
+ "CLOUDFLARE_BASE_URL_TEMPLATE",
+ "CLOUDFLARE_BASE_URL_VAR",
+ "CLOUDFLARE_DEFAULT_MODEL",
+ "CLOUDFLARE_KEY_VAR",
+ "CLOUDFLARE_PROVIDER",
+ "CLOUDFLARE_PROVIDER_REF",
+ "CLOUDFLARE_STRONG_MODEL",
+ "workers_ai_base_url",
+]
diff --git a/praxist/core/credentials.py b/praxist/core/credentials.py
index 17c1861..df987e6 100644
--- a/praxist/core/credentials.py
+++ b/praxist/core/credentials.py
@@ -48,6 +48,7 @@ class CredentialResolver:
"model_provider:anthropic_messages",
),
("OPENROUTER_API_KEY", "model_provider", "openrouter", "model_provider:openrouter"),
+ ("ORCAROUTER_API_KEY", "model_provider", "orcarouter", "model_provider:orcarouter"),
(
"OPENAI_API_KEY",
"model_provider",
@@ -55,6 +56,10 @@ class CredentialResolver:
"model_provider:openai_compatible",
),
("DEEPSEEK_API_KEY", "model_provider", "deepseek_alias", "model_provider:deepseek_alias"),
+ ("CLOUDFLARE_API_KEY", "model_provider", "cloudflare", "model_provider:cloudflare"),
+ ("GROQ_API_KEY", "model_provider", "groq_alias", "model_provider:groq_alias"),
+ ("MISTRAL_API_KEY", "model_provider", "mistral_alias", "model_provider:mistral_alias"),
+ ("XAI_API_KEY", "model_provider", "xai_alias", "model_provider:xai_alias"),
(
"SEMANTIC_SCHOLAR_API_KEY",
"tool_server",
diff --git a/praxist/core/modeling.py b/praxist/core/modeling.py
index dedbb1e..7d9b7eb 100644
--- a/praxist/core/modeling.py
+++ b/praxist/core/modeling.py
@@ -8,6 +8,7 @@ from typing import Any
import yaml
+from praxist.core.cloudflare import CLOUDFLARE_API_FORMAT
from praxist.core.credentials import CredentialRef
from praxist.core.protocol import ModelCallSpec, ModelProfile, ModelResult
from praxist.core.registry import (
@@ -44,13 +45,14 @@ def normalize_model_for_provider(
) -> str:
"""Reshape a model name into the format the provider's api_format expects.
- Openrouter uses ``vendor/model``; the other api_formats we ship
- (``openai_compatible``, ``anthropic_messages``, ``fake``) consume
- bare ``model`` names. Operator configs and env vars often carry the
- ``vendor/`` prefix as a leftover from the era when openrouter was
- the only supported access path; this helper strips that prefix when
- the resolved provider is not openrouter so the same configuration
- works against either an aggregator or a direct provider endpoint.
+ OpenRouter and OrcaRouter use ``vendor/model``; the other api_formats
+ we ship (``openai_compatible``, ``anthropic_messages``, ``fake``)
+ consume bare ``model`` names. Operator configs and env vars often
+ carry the ``vendor/`` prefix as a leftover from the era when
+ openrouter was the only supported access path; this helper strips
+ that prefix when the resolved provider is not openrouter or orcarouter
+ so the same configuration works against either an aggregator or a
+ direct provider endpoint.
"""
if not model:
return model
@@ -60,8 +62,21 @@ def normalize_model_for_provider(
def _normalize_model_for_api_format(model: str, api_format: str) -> str:
- """Strip a ``vendor/`` prefix when the api_format does not use one."""
- if not model or api_format == "openrouter":
+ """Strip a ``vendor/`` prefix when the api_format does not use one.
+
+ ``cloudflare_workers_ai`` keeps the whole name: Workers AI model ids are
+ full ``@cf/vendor/model`` paths, so splitting on the first ``/`` would
+ corrupt them. ``groq`` is the same case -- Groq publishes ids such as
+ ``openai/gpt-oss-20b`` and ``groq/compound``, and the vendor segment is
+ part of the id rather than an aggregator prefix. OpenRouter and OrcaRouter
+ likewise retain ``vendor/model``.
+ """
+ if not model or api_format in {
+ "openrouter",
+ "orcarouter",
+ "groq",
+ CLOUDFLARE_API_FORMAT,
+ }:
return model
if "/" in model:
return model.split("/", 1)[1]
@@ -244,7 +259,7 @@ def _capability_tags(api_format: str) -> list[str]:
return ["offline_fixture", "deterministic"]
if api_format == "anthropic_messages":
return ["long_context", "prompt_cache", "tool_use"]
- if api_format == "openrouter":
+ if api_format in {"openrouter", "orcarouter"}:
return ["routing", "openai_compatible", "tool_use"]
return ["openai_compatible", "tool_use"]
diff --git a/praxist/core/redaction.py b/praxist/core/redaction.py
index f8994ef..05c180c 100644
--- a/praxist/core/redaction.py
+++ b/praxist/core/redaction.py
@@ -13,6 +13,7 @@ JSONValue = str | int | float | bool | None | list["JSONValue"] | dict[str, "JSO
_SECRET_PATTERNS: tuple[tuple[str, re.Pattern[str]], ...] = (
("bearer_token", re.compile(r"Bearer\s+[A-Za-z0-9._~+/=-]{8,}")),
("openrouter_key", re.compile(r"\bsk-or-v1-[A-Za-z0-9]{16,}\b")),
+ ("orcarouter_key", re.compile(r"\bsk-orca-[A-Za-z0-9]{16,}\b")),
("openai_style_key", re.compile(r"(?<![A-Za-z0-9])sk-[A-Za-z0-9][A-Za-z0-9._-]{7,}\b")),
("github_token", re.compile(r"\bghp_[A-Za-z0-9_]{12,}\b")),
(
diff --git a/praxist/plugins/agent_runtimes/claude_sdk/plugin.yaml b/praxist/plugins/agent_runtimes/claude_sdk/plugin.yaml
index a35c284..aa97784 100644
--- a/praxist/plugins/agent_runtimes/claude_sdk/plugin.yaml
+++ b/praxist/plugins/agent_runtimes/claude_sdk/plugin.yaml
@@ -21,6 +21,7 @@ runtime:
compatible_model_providers:
- model_provider:anthropic_messages
- model_provider:openrouter
+ - model_provider:orcarouter
- model_provider:deepseek_alias
cache_strategy: runtime_auto_cache
event_schema: praxist.agent_event.v1
diff --git a/praxist/plugins/agent_runtimes/codex_sdk/_relay.py b/praxist/plugins/agent_runtimes/codex_sdk/_relay.py
index 6807f21..d0aa925 100644
--- a/praxist/plugins/agent_runtimes/codex_sdk/_relay.py
+++ b/praxist/plugins/agent_runtimes/codex_sdk/_relay.py
@@ -14,26 +14,37 @@ from collections.abc import Mapping, Sequence
from dataclasses import dataclass
from pathlib import Path
+from praxist.core.cloudflare import (
+ CLOUDFLARE_KEY_VAR,
+ CLOUDFLARE_PROVIDER,
+ workers_ai_base_url,
+)
+
_PROVIDER_UPSTREAMS = {
"deepseek": "https://api.deepseek.com/v1",
"openrouter": "https://openrouter.ai/api/v1",
+ "orcarouter": "https://api.orcarouter.ai/v1",
"kimi": "https://api.moonshot.cn/v1",
"moonshot": "https://api.moonshot.cn/v1",
"qwen": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"mistral": "https://api.mistral.ai/v1",
"groq": "https://api.groq.com/openai/v1",
"xai": "https://api.x.ai/v1",
+ # Cloudflare is account-scoped and resolved at call time by
+ # ``provider_upstream``; it has no static entry here.
}
_PROVIDER_KEY_VARS = {
"deepseek": "DEEPSEEK_API_KEY",
"openrouter": "OPENROUTER_API_KEY",
+ "orcarouter": "ORCAROUTER_API_KEY",
"kimi": "MOONSHOT_API_KEY",
"moonshot": "MOONSHOT_API_KEY",
"qwen": "DASHSCOPE_API_KEY",
"mistral": "MISTRAL_API_KEY",
"groq": "GROQ_API_KEY",
"xai": "XAI_API_KEY",
+ CLOUDFLARE_PROVIDER: CLOUDFLARE_KEY_VAR,
}
@@ -77,6 +88,18 @@ def needs_relay(provider: str) -> bool:
return provider not in {"", "openai"}
+def provider_upstream(provider: str) -> str | None:
+ """Return the OpenAI-compatible upstream base URL for a relay provider.
+
+ Cloudflare Workers AI is account-scoped, so its upstream is interpolated
+ from the environment rather than read from the static table.
+ """
+
+ if provider == CLOUDFLARE_PROVIDER:
+ return workers_ai_base_url()
+ return _PROVIDER_UPSTREAMS.get(provider)
+
+
def provider_key_var(provider: str) -> str:
"""Return the credential environment variable for a provider."""
@@ -99,7 +122,10 @@ def start_relay(
raise RuntimeError(
"codex-relay is required for this model provider; install praxist[codex]"
)
- upstream = _PROVIDER_UPSTREAMS.get(provider)
+ try:
+ upstream = provider_upstream(provider)
+ except ValueError as exc:
+ raise RuntimeError(f"provider {provider!r} upstream is unavailable: {exc}") from exc
if upstream is None:
raise RuntimeError(f"Codex SDK relay does not support provider {provider!r}")
if not api_key:
@@ -187,6 +213,7 @@ def _wait_for_listener(
__all__ = [
"RelayHandle",
"needs_relay",
+ "provider_upstream",
"provider_key_var",
"provider_name",
"start_relay",
diff --git a/praxist/plugins/agent_runtimes/codex_sdk/adapter.py b/praxist/plugins/agent_runtimes/codex_sdk/adapter.py
index 4c40d77..286197f 100644
--- a/praxist/plugins/agent_runtimes/codex_sdk/adapter.py
+++ b/praxist/plugins/agent_runtimes/codex_sdk/adapter.py
@@ -106,6 +106,7 @@ _MODEL_CREDENTIAL_ENV_KEYS = frozenset(
{
"ANTHROPIC_API_KEY",
"ANTHROPIC_AUTH_TOKEN",
+ "CLOUDFLARE_API_KEY",
"DASHSCOPE_API_KEY",
"DEEPSEEK_API_KEY",
"GROQ_API_KEY",
@@ -113,6 +114,7 @@ _MODEL_CREDENTIAL_ENV_KEYS = frozenset(
"MOONSHOT_API_KEY",
"OPENAI_API_KEY",
"OPENROUTER_API_KEY",
+ "ORCAROUTER_API_KEY",
"XAI_API_KEY",
}
)
@@ -929,7 +931,7 @@ def _client_key(request: AgentRunRequest, env: Mapping[str, str]) -> _ClientKey:
digest = hashlib.sha256(identity.encode()).hexdigest()[:16] if identity else "none"
reasoning_policy = (
effective_reasoning_effort(request.runtime_options)
- if provider in {"deepseek", "openrouter"}
+ if provider in {"deepseek", "openrouter", "orcarouter"}
else "default"
)
return _ClientKey(
@@ -1027,12 +1029,12 @@ def _relay_reasoning_options(
"""Return provider-native reasoning overrides owned by the private relay."""
provider = provider_name(request.model_call.provider_ref)
- if provider not in {"deepseek", "openrouter"}:
+ if provider not in {"deepseek", "openrouter", "orcarouter"}:
return None, ()
policy = effective_reasoning_effort(request.runtime_options)
if policy == "auto":
return None, ()
- if provider == "openrouter":
+ if provider in {"openrouter", "orcarouter"}:
effort = "none" if policy == "off" else policy
return {"reasoning": {"effort": effort}}, ()
if policy == "off":
diff --git a/praxist/plugins/agent_runtimes/codex_sdk/plugin.yaml b/praxist/plugins/agent_runtimes/codex_sdk/plugin.yaml
index 9d61277..c28296a 100644
--- a/praxist/plugins/agent_runtimes/codex_sdk/plugin.yaml
+++ b/praxist/plugins/agent_runtimes/codex_sdk/plugin.yaml
@@ -23,7 +23,15 @@ runtime:
compatible_model_providers:
- model_provider:openai_compatible
- model_provider:openrouter
+ - model_provider:orcarouter
- model_provider:deepseek_alias
+ # Cloudflare Workers AI is OpenAI-compatible and reaches this runtime
+ # through the codex relay; it has no Anthropic route, so it is
+ # deliberately absent from claude_sdk's allowlist.
+ - model_provider:cloudflare
+ - model_provider:groq_alias
+ - model_provider:mistral_alias
+ - model_provider:xai_alias
cache_strategy: runtime_auto_cache
event_schema: praxist.agent_event.v1
usage_reporting: usage_or_usage_unknown
diff --git a/praxist/plugins/model_providers/cloudflare/__init__.py b/praxist/plugins/model_providers/cloudflare/__init__.py
new file mode 100644
index 0000000..28e8eb9
--- /dev/null
+++ b/praxist/plugins/model_providers/cloudflare/__init__.py
@@ -0,0 +1 @@
+"""Cloudflare Workers AI model provider plugin."""
diff --git a/praxist/plugins/model_providers/cloudflare/adapter.py b/praxist/plugins/model_providers/cloudflare/adapter.py
new file mode 100644
index 0000000..0c877a0
--- /dev/null
+++ b/praxist/plugins/model_providers/cloudflare/adapter.py
@@ -0,0 +1,11 @@
+"""Executable Cloudflare Workers AI model provider plugin."""
+
+from __future__ import annotations
+
+from praxist.core.cloudflare import CLOUDFLARE_API_FORMAT
+from praxist.core.modeling import ModelProviderAdapter
+
+
+def create_provider() -> ModelProviderAdapter:
+ """Manifest entrypoint for the Cloudflare Workers AI provider."""
+ return ModelProviderAdapter("model_provider:cloudflare", api_format=CLOUDFLARE_API_FORMAT)
diff --git a/praxist/plugins/model_providers/cloudflare/plugin.yaml b/praxist/plugins/model_providers/cloudflare/plugin.yaml
new file mode 100644
index 0000000..39a6317
--- /dev/null
+++ b/praxist/plugins/model_providers/cloudflare/plugin.yaml
@@ -0,0 +1,40 @@
+schema_version: 1
+name: cloudflare
+kind: model_provider
+version: 0.1.0
+protocol_version: 1
+stability: experimental
+description: Cloudflare Workers AI OpenAI-compatible provider serving DeepSeek models.
+compatibility:
+ praxist_core: ">=0.1.0,<1.0"
+ python: ">=3.11"
+dependencies: []
+capabilities:
+ - provider.openai_compatible
+ - provider.cloudflare
+provider:
+ # Workers AI speaks OpenAI chat-completions at
+ # ``/client/v4/accounts/{account_id}/ai/v1`` and publishes no Anthropic
+ # Messages route, so this provider rides the OpenAI-compatible client and
+ # only swaps base URL + bearer token. The account id is part of the URL,
+ # not the credential, and is interpolated from CLOUDFLARE_ACCOUNT_ID by
+ # ``praxist.core.cloudflare.workers_ai_base_url``.
+ #
+ # ``cloudflare_workers_ai`` is a distinct api_format purely so model-name
+ # normalization keeps the full ``@cf/vendor/model`` id; the generic
+ # openai_compatible format strips everything before the first ``/`` and
+ # would turn ``@cf/deepseek-ai/deepseek-v4-flash-0731`` into
+ # ``deepseek-ai/deepseek-v4-flash-0731``, which Workers AI rejects.
+ api_format: cloudflare_workers_ai
+ default_model: "@cf/deepseek-ai/deepseek-v4-flash-0731"
+ cache_strategy: provider_default
+ usage_reporting: usage_or_usage_unknown
+ model_profiles:
+ cheap_peer: "@cf/deepseek-ai/deepseek-v4-flash-0731"
+ strong_reasoner: "@cf/deepseek-ai/deepseek-v4-pro-0813"
+ compatible_model_patterns:
+ - "@cf/*"
+entrypoint: adapter:create_provider
+code:
+ - adapter.py
+assets: []
diff --git a/praxist/plugins/model_providers/groq_alias/__init__.py b/praxist/plugins/model_providers/groq_alias/__init__.py
new file mode 100644
index 0000000..14140ea
--- /dev/null
+++ b/praxist/plugins/model_providers/groq_alias/__init__.py
@@ -0,0 +1 @@
+"""Groq OpenAI-compatible model provider plugin."""
diff --git a/praxist/plugins/model_providers/groq_alias/adapter.py b/praxist/plugins/model_providers/groq_alias/adapter.py
new file mode 100644
index 0000000..5014511
--- /dev/null
+++ b/praxist/plugins/model_providers/groq_alias/adapter.py
@@ -0,0 +1,10 @@
+"""Executable Groq OpenAI-compatible model provider plugin."""
+
+from __future__ import annotations
+
+from praxist.core.modeling import ModelProviderAdapter
+
+
+def create_provider() -> ModelProviderAdapter:
+ """Manifest entrypoint for the Groq OpenAI-compatible provider alias."""
+ return ModelProviderAdapter("model_provider:groq_alias", api_format="openai_compatible")
diff --git a/praxist/plugins/model_providers/groq_alias/plugin.yaml b/praxist/plugins/model_providers/groq_alias/plugin.yaml
new file mode 100644
index 0000000..6883e77
--- /dev/null
+++ b/praxist/plugins/model_providers/groq_alias/plugin.yaml
@@ -0,0 +1,36 @@
+schema_version: 1
+name: groq_alias
+kind: model_provider
+version: 0.1.0
+protocol_version: 1
+stability: experimental
+description: Groq alias on the OpenAI-compatible adapter path.
+compatibility:
+ praxist_core: ">=0.1.0,<1.0"
+ python: ">=3.11"
+dependencies: []
+capabilities:
+ - provider.openai_compatible
+ - provider.groq
+provider:
+ api_format: groq
+ default_model: openai/gpt-oss-20b
+ cache_strategy: provider_default
+ usage_reporting: usage_or_usage_unknown
+ model_profiles:
+ cheap_peer: openai/gpt-oss-20b
+ strong_reasoner: openai/gpt-oss-120b
+ compatible_model_patterns:
+ - "openai/*"
+ - "qwen/*"
+ - "meta-llama/*"
+ - "groq/*"
+ - "groq*"
+ - "allam-*"
+ - "llama*"
+ - "mixtral*"
+ - "gemma*"
+entrypoint: adapter:create_provider
+code:
+ - adapter.py
+assets: []
diff --git a/praxist/plugins/model_providers/mistral_alias/__init__.py b/praxist/plugins/model_providers/mistral_alias/__init__.py
new file mode 100644
index 0000000..00eadef
--- /dev/null
+++ b/praxist/plugins/model_providers/mistral_alias/__init__.py
@@ -0,0 +1 @@
+"""Mistral OpenAI-compatible model provider plugin."""
diff --git a/praxist/plugins/model_providers/mistral_alias/adapter.py b/praxist/plugins/model_providers/mistral_alias/adapter.py
new file mode 100644
index 0000000..e04c4f2
--- /dev/null
+++ b/praxist/plugins/model_providers/mistral_alias/adapter.py
@@ -0,0 +1,10 @@
+"""Executable Mistral OpenAI-compatible model provider plugin."""
+
+from __future__ import annotations
+
+from praxist.core.modeling import ModelProviderAdapter
+
+
+def create_provider() -> ModelProviderAdapter:
+ """Manifest entrypoint for the Mistral OpenAI-compatible provider alias."""
+ return ModelProviderAdapter("model_provider:mistral_alias", api_format="openai_compatible")
diff --git a/praxist/plugins/model_providers/mistral_alias/plugin.yaml b/praxist/plugins/model_providers/mistral_alias/plugin.yaml
new file mode 100644
index 0000000..d1bf73f
--- /dev/null
+++ b/praxist/plugins/model_providers/mistral_alias/plugin.yaml
@@ -0,0 +1,32 @@
+schema_version: 1
+name: mistral_alias
+kind: model_provider
+version: 0.1.0
+protocol_version: 1
+stability: experimental
+description: Mistral alias on the OpenAI-compatible adapter path.
+compatibility:
+ praxist_core: ">=0.1.0,<1.0"
+ python: ">=3.11"
+dependencies: []
+capabilities:
+ - provider.openai_compatible
+ - provider.mistral
+provider:
+ api_format: openai_compatible
+ default_model: mistral-large-latest
+ cache_strategy: provider_default
+ usage_reporting: usage_or_usage_unknown
+ model_profiles:
+ cheap_peer: mistral-small-latest
+ strong_reasoner: mistral-large-latest
+ compatible_model_patterns:
+ - "mistral*"
+ - "codestral*"
+ - "ministral*"
+ - "open-mistral*"
+ - "pixtral*"
+entrypoint: adapter:create_provider
+code:
+ - adapter.py
+assets: []
diff --git a/praxist/plugins/model_providers/orcarouter/__init__.py b/praxist/plugins/model_providers/orcarouter/__init__.py
new file mode 100644
index 0000000..1cddec3
--- /dev/null
+++ b/praxist/plugins/model_providers/orcarouter/__init__.py
@@ -0,0 +1 @@
+"""OrcaRouter model provider plugin."""
diff --git a/praxist/plugins/model_providers/orcarouter/adapter.py b/praxist/plugins/model_providers/orcarouter/adapter.py
new file mode 100644
index 0000000..193d1e4
--- /dev/null
+++ b/praxist/plugins/model_providers/orcarouter/adapter.py
@@ -0,0 +1,10 @@
+"""Executable OrcaRouter model provider plugin."""
+
+from __future__ import annotations
+
+from praxist.core.modeling import ModelProviderAdapter
+
+
+def create_provider() -> ModelProviderAdapter:
+ """Manifest entrypoint for the OrcaRouter model-provider adapter."""
+ return ModelProviderAdapter("model_provider:orcarouter", api_format="orcarouter")
diff --git a/praxist/plugins/model_providers/orcarouter/plugin.yaml b/praxist/plugins/model_providers/orcarouter/plugin.yaml
new file mode 100644
index 0000000..2246122
--- /dev/null
+++ b/praxist/plugins/model_providers/orcarouter/plugin.yaml
@@ -0,0 +1,29 @@
+schema_version: 1
+name: orcarouter
+kind: model_provider
+version: 0.1.0
+protocol_version: 1
+stability: experimental
+description: OrcaRouter provider adapter spec.
+compatibility:
+ praxist_core: ">=0.1.0,<1.0"
+ python: ">=3.11"
+dependencies: []
+capabilities:
+ - provider.orcarouter
+ - provider.routing
+provider:
+ api_format: orcarouter
+ default_model: orcarouter/auto
+ cache_strategy: provider_default
+ usage_reporting: usage_or_usage_unknown
+ model_profiles:
+ cheap_peer: orcarouter/auto
+ strong_reasoner: orcarouter/auto
+ compatible_model_patterns:
+ - "orcarouter/*"
+ - "*/*"
+entrypoint: adapter:create_provider
+code:
+ - adapter.py
+assets: []
diff --git a/praxist/plugins/model_providers/xai_alias/__init__.py b/praxist/plugins/model_providers/xai_alias/__init__.py
new file mode 100644
index 0000000..1f5f0c2
--- /dev/null
+++ b/praxist/plugins/model_providers/xai_alias/__init__.py
@@ -0,0 +1 @@
+"""xAI OpenAI-compatible model provider plugin."""
diff --git a/praxist/plugins/model_providers/xai_alias/adapter.py b/praxist/plugins/model_providers/xai_alias/adapter.py
new file mode 100644
index 0000000..ddbfcd4
--- /dev/null
+++ b/praxist/plugins/model_providers/xai_alias/adapter.py
@@ -0,0 +1,10 @@
+"""Executable xAI OpenAI-compatible model provider plugin."""
+
+from __future__ import annotations
+
+from praxist.core.modeling import ModelProviderAdapter
+
+
+def create_provider() -> ModelProviderAdapter:
+ """Manifest entrypoint for the xAI OpenAI-compatible provider alias."""
+ return ModelProviderAdapter("model_provider:xai_alias", api_format="openai_compatible")
diff --git a/praxist/plugins/model_providers/xai_alias/plugin.yaml b/praxist/plugins/model_providers/xai_alias/plugin.yaml
new file mode 100644
index 0000000..f1e8122
--- /dev/null
+++ b/praxist/plugins/model_providers/xai_alias/plugin.yaml
@@ -0,0 +1,28 @@
+schema_version: 1
+name: xai_alias
+kind: model_provider
+version: 0.1.0
+protocol_version: 1
+stability: experimental
+description: xAI alias on the OpenAI-compatible adapter path.
+compatibility:
+ praxist_core: ">=0.1.0,<1.0"
+ python: ">=3.11"
+dependencies: []
+capabilities:
+ - provider.openai_compatible
+ - provider.xai
+provider:
+ api_format: openai_compatible
+ default_model: grok-4.6
+ cache_strategy: provider_default
+ usage_reporting: usage_or_usage_unknown
+ model_profiles:
+ cheap_peer: grok-4.20-0309-non-reasoning
+ strong_reasoner: grok-4.6
+ compatible_model_patterns:
+ - "grok*"
+entrypoint: adapter:create_provider
+code:
+ - adapter.py
+assets: []
diff --git a/praxist/plugins/workflow_stages/research_loop/backend/agent.py b/praxist/plugins/workflow_stages/research_loop/backend/agent.py
index 135cec9..67b0272 100644
--- a/praxist/plugins/workflow_stages/research_loop/backend/agent.py
+++ b/praxist/plugins/workflow_stages/research_loop/backend/agent.py
@@ -26,6 +26,12 @@ from praxist.config import (
S3_RESULTS_PREFIX as _S3_RESULTS_PREFIX_DEFAULT,
)
from praxist.core.cache import build_cache_policy
+from praxist.core.cloudflare import (
+ CLOUDFLARE_ACCOUNT_VAR,
+ CLOUDFLARE_BASE_URL_VAR,
+ CLOUDFLARE_KEY_VAR,
+ CLOUDFLARE_PROVIDER_REF,
+)
from praxist.core.credentials import CredentialRef, provider_name_from_ref
from praxist.core.modeling import default_model_profile
from praxist.core.prompt_layout import (
@@ -87,6 +93,7 @@ from praxist.plugins.workflow_stages.research_loop.provider_env import (
DEEPSEEK_CLAUDE_DEFAULT_MODEL,
DEEPSEEK_CLAUDE_SDK_BASE_URL,
normalize_openrouter_base_url,
+ normalize_orcarouter_base_url,
)
logger = logging.getLogger(__name__)
@@ -121,6 +128,11 @@ _CONTEXT_EFFICIENCY_MODES = frozenset({"auto", "lossless", "off"})
_CHATGPT_CREDENTIAL_PREFIX = "openai_compatible:codex_sdk:chatgpt:"
_LOSSLESS_MAX_SHARED_FINDINGS = 48
_LOSSLESS_MAX_MEMORY_PROMPT_CHARS = 24_000
+_OPENAI_COMPAT_PROVIDER_KEY_VARS = {
+ "model_provider:groq_alias": "GROQ_API_KEY",
+ "model_provider:mistral_alias": "MISTRAL_API_KEY",
+ "model_provider:xai_alias": "XAI_API_KEY",
+}
_LOSSLESS_CONTINUATION_DIRECTIVE = """# Lossless Continuation Navigation
This is a continuation session. The complete task contract remains above and
@@ -626,10 +638,14 @@ def _scoped_legacy_provider_env() -> dict[str, str]:
provider_ref = os.environ.get("PRAXIST_MODEL_PROVIDER_REF", "")
if provider_ref == "model_provider:openrouter":
allowed = ("ANTHROPIC_BASE_URL", "ANTHROPIC_AUTH_TOKEN", "OPENROUTER_API_KEY")
+ elif provider_ref == "model_provider:orcarouter":
+ allowed = ("ANTHROPIC_BASE_URL", "ANTHROPIC_AUTH_TOKEN", "ORCAROUTER_API_KEY")
elif provider_ref == "model_provider:anthropic_messages":
allowed = ("ANTHROPIC_API_KEY",)
elif provider_ref == "model_provider:openai_compatible":
allowed = ("OPENAI_API_KEY",)
+ elif provider_ref in _OPENAI_COMPAT_PROVIDER_KEY_VARS:
+ allowed = (_OPENAI_COMPAT_PROVIDER_KEY_VARS[provider_ref],)
elif provider_ref == "model_provider:deepseek_alias":
allowed = (
"ANTHROPIC_BASE_URL",
@@ -642,6 +658,16 @@ def _scoped_legacy_provider_env() -> dict[str, str]:
"CLAUDE_CODE_EFFORT_LEVEL",
"DEEPSEEK_API_KEY",
)
+ elif provider_ref == CLOUDFLARE_PROVIDER_REF:
+ # Workers AI reaches the Codex runtime through the relay, which reads
+ # the bearer from CLOUDFLARE_API_KEY/OPENAI_API_KEY and interpolates
+ # the account-scoped upstream from CLOUDFLARE_ACCOUNT_ID.
+ allowed = (
+ CLOUDFLARE_KEY_VAR,
+ "OPENAI_API_KEY",
+ CLOUDFLARE_ACCOUNT_VAR,
+ CLOUDFLARE_BASE_URL_VAR,
+ )
elif provider_ref == "model_provider:fake_provider":
allowed = ()
else:
@@ -674,7 +700,14 @@ def _scoped_legacy_provider_env() -> dict[str, str]:
if val:
if provider_ref == "model_provider:openrouter" and var == "ANTHROPIC_BASE_URL":
val = normalize_openrouter_base_url(val)
+ if provider_ref == "model_provider:orcarouter" and var == "ANTHROPIC_BASE_URL":
+ val = normalize_orcarouter_base_url(val)
env[var] = val
+ if provider_ref == CLOUDFLARE_PROVIDER_REF:
+ cloudflare_key = os.environ.get(CLOUDFLARE_KEY_VAR, "")
+ if cloudflare_key:
+ env[CLOUDFLARE_KEY_VAR] = cloudflare_key
+ env["OPENAI_API_KEY"] = cloudflare_key
if provider_ref == "model_provider:deepseek_alias":
deepseek_key = os.environ.get("DEEPSEEK_API_KEY", "")
if deepseek_key:
@@ -956,7 +989,7 @@ def _lossless_context_efficiency_enabled() -> bool:
return False
if mode == "lossless":
return True
- if provider_ref == "model_provider:openrouter":
+ if provider_ref in {"model_provider:openrouter", "model_provider:orcarouter"}:
return True
return bool(
os.environ.get("PRAXIST_AGENT_RUNTIME_REF", "").strip() == "agent_runtime:codex_sdk"
diff --git a/praxist/plugins/workflow_stages/research_loop/backend/experiment_scheduler_client.py b/praxist/plugins/workflow_stages/research_loop/backend/experiment_scheduler_client.py
index bab8786..67c58b6 100644
--- a/praxist/plugins/workflow_stages/research_loop/backend/experiment_scheduler_client.py
+++ b/praxist/plugins/workflow_stages/research_loop/backend/experiment_scheduler_client.py
@@ -46,6 +46,7 @@ def is_sensitive_environment_name(name: str) -> bool:
"ANTHROPIC_API_KEY",
"OPENAI_API_KEY",
"OPENROUTER_API_KEY",
+ "ORCAROUTER_API_KEY",
"DEEPSEEK_API_KEY",
"API_KEY",
"PASSWORD",
diff --git a/praxist/plugins/workflow_stages/research_loop/provider_env.py b/praxist/plugins/workflow_stages/research_loop/provider_env.py
index 91b4122..6f7d880 100644
--- a/praxist/plugins/workflow_stages/research_loop/provider_env.py
+++ b/praxist/plugins/workflow_stages/research_loop/provider_env.py
@@ -4,8 +4,16 @@ from __future__ import annotations
from collections.abc import Mapping
+from praxist.core.cloudflare import (
+ CLOUDFLARE_KEY_VAR,
+ CLOUDFLARE_PROVIDER_REF,
+ workers_ai_base_url,
+)
+
OPENROUTER_CLAUDE_SDK_BASE_URL = "https://openrouter.ai/api"
OPENROUTER_OPENAI_COMPAT_BASE_URL = "https://openrouter.ai/api/v1"
+ORCAROUTER_CLAUDE_SDK_BASE_URL = "https://api.orcarouter.ai"
+ORCAROUTER_OPENAI_COMPAT_BASE_URL = "https://api.orcarouter.ai/v1"
DEEPSEEK_CLAUDE_SDK_BASE_URL = "https://api.deepseek.com/anthropic"
DEEPSEEK_CLAUDE_DEFAULT_MODEL = "deepseek-v4-pro[1m]"
DEEPSEEK_CLAUDE_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"
@@ -26,6 +34,20 @@ def normalize_openrouter_base_url(base_url: str) -> str:
return cleaned
+def normalize_orcarouter_base_url(base_url: str) -> str:
+ """Return the OrcaRouter base URL expected by Claude SDK transports.
+
+ Mirrors :func:`normalize_openrouter_base_url`: OrcaRouter's
+ OpenAI-compatible endpoint includes ``/v1``, but Claude SDK calls must use
+ the parent endpoint or requests become ``/v1/v1/messages``.
+ """
+
+ cleaned = str(base_url).rstrip("/")
+ if cleaned == ORCAROUTER_OPENAI_COMPAT_BASE_URL:
+ return ORCAROUTER_CLAUDE_SDK_BASE_URL
+ return cleaned
+
+
def freeze_provider_env(model_provider_ref: str, env: Mapping[str, str]) -> dict[str, str | None]:
"""Capture the provider environment surface passed into research-loop runtimes."""
@@ -41,9 +63,26 @@ def freeze_provider_env(model_provider_ref: str, env: Mapping[str, str]) -> dict
"CLAUDE_CODE_SUBAGENT_MODEL": None,
"CLAUDE_CODE_EFFORT_LEVEL": None,
"OPENROUTER_API_KEY": None,
+ "ORCAROUTER_API_KEY": None,
"OPENAI_API_KEY": None,
"DEEPSEEK_API_KEY": None,
+ CLOUDFLARE_KEY_VAR: None,
+ "CLOUDFLARE_BASE_URL": None,
+ "GROQ_API_KEY": None,
+ "MISTRAL_API_KEY": None,
+ "XAI_API_KEY": None,
}
+ if model_provider_ref == CLOUDFLARE_PROVIDER_REF:
+ # Workers AI is OpenAI-compatible only. The Codex relay reads the
+ # key from OPENAI_API_KEY and the base URL from CLOUDFLARE_BASE_URL,
+ # so both are frozen here and the Anthropic surface stays unset.
+ auth_token = env.get(CLOUDFLARE_KEY_VAR)
+ return {
+ **base,
+ CLOUDFLARE_KEY_VAR: auth_token,
+ "OPENAI_API_KEY": auth_token,
+ "CLOUDFLARE_BASE_URL": workers_ai_base_url(env),
+ }
if model_provider_ref == "model_provider:openrouter":
base_url = normalize_openrouter_base_url(
env.get("ANTHROPIC_BASE_URL")
@@ -57,6 +96,19 @@ def freeze_provider_env(model_provider_ref: str, env: Mapping[str, str]) -> dict
"ANTHROPIC_AUTH_TOKEN": auth_token,
"OPENROUTER_API_KEY": auth_token,
}
+ if model_provider_ref == "model_provider:orcarouter":
+ base_url = normalize_orcarouter_base_url(
+ env.get("ANTHROPIC_BASE_URL")
+ or env.get("ORCAROUTER_BASE_URL")
+ or ORCAROUTER_CLAUDE_SDK_BASE_URL
+ )
+ auth_token = env.get("ANTHROPIC_AUTH_TOKEN") or env.get("ORCAROUTER_API_KEY")
+ return {
+ **base,
+ "ANTHROPIC_BASE_URL": base_url,
+ "ANTHROPIC_AUTH_TOKEN": auth_token,
+ "ORCAROUTER_API_KEY": auth_token,
+ }
if model_provider_ref == "model_provider:anthropic_messages":
return {
**base,
@@ -64,6 +116,12 @@ def freeze_provider_env(model_provider_ref: str, env: Mapping[str, str]) -> dict
}
if model_provider_ref == "model_provider:openai_compatible":
return {**base, "OPENAI_API_KEY": env.get("OPENAI_API_KEY")}
+ if model_provider_ref == "model_provider:groq_alias":
+ return {**base, "GROQ_API_KEY": env.get("GROQ_API_KEY")}
+ if model_provider_ref == "model_provider:mistral_alias":
+ return {**base, "MISTRAL_API_KEY": env.get("MISTRAL_API_KEY")}
+ if model_provider_ref == "model_provider:xai_alias":
+ return {**base, "XAI_API_KEY": env.get("XAI_API_KEY")}
if model_provider_ref == "model_provider:deepseek_alias":
auth_token = env.get("DEEPSEEK_API_KEY") or env.get("ANTHROPIC_AUTH_TOKEN")
return {
diff --git a/praxist/plugins/workflow_stages/research_loop/stage.py b/praxist/plugins/workflow_stages/research_loop/stage.py
index 4a8dc49..ef8965b 100644
--- a/praxist/plugins/workflow_stages/research_loop/stage.py
+++ b/praxist/plugins/workflow_stages/research_loop/stage.py
@@ -11,6 +11,11 @@ from pathlib import Path
from typing import Any
from praxist.core.budget import INFORMATIONAL_USAGE_UNITS
+from praxist.core.cloudflare import (
+ CLOUDFLARE_KEY_VAR,
+ CLOUDFLARE_PROVIDER_REF,
+ workers_ai_base_url,
+)
from praxist.core.ledgers import BudgetLedger
from praxist.core.role_skills import RoleSkill, load_role_skill
from praxist.core.runtimes import close_runtime_for_ref, collect_runtime_usage
@@ -24,7 +29,9 @@ from praxist.plugins.workflow_stages.research_loop.provider_env import (
DEEPSEEK_CLAUDE_DEFAULT_MODEL,
DEEPSEEK_CLAUDE_SDK_BASE_URL,
OPENROUTER_CLAUDE_SDK_BASE_URL,
+ ORCAROUTER_CLAUDE_SDK_BASE_URL,
normalize_openrouter_base_url,
+ normalize_orcarouter_base_url,
)
logger = logging.getLogger(__name__)
@@ -478,8 +485,14 @@ def _provider_env(model_provider_ref: str) -> dict[str, str | None]:
"ANTHROPIC_BASE_URL": None,
"ANTHROPIC_AUTH_TOKEN": None,
"OPENROUTER_API_KEY": None,
+ "ORCAROUTER_API_KEY": None,
"OPENAI_API_KEY": None,
"DEEPSEEK_API_KEY": None,
+ CLOUDFLARE_KEY_VAR: None,
+ "CLOUDFLARE_BASE_URL": None,
+ "GROQ_API_KEY": None,
+ "MISTRAL_API_KEY": None,
+ "XAI_API_KEY": None,
"ANTHROPIC_MODEL": None,
"ANTHROPIC_DEFAULT_OPUS_MODEL": None,
"ANTHROPIC_DEFAULT_SONNET_MODEL": None,
@@ -487,6 +500,15 @@ def _provider_env(model_provider_ref: str) -> dict[str, str | None]:
"CLAUDE_CODE_SUBAGENT_MODEL": None,
"CLAUDE_CODE_EFFORT_LEVEL": None,
}
+ if model_provider_ref == CLOUDFLARE_PROVIDER_REF:
+ # Workers AI is OpenAI-compatible only; see provider_env.freeze_provider_env.
+ auth_token = os.environ.get(CLOUDFLARE_KEY_VAR)
+ return {
+ **base,
+ CLOUDFLARE_KEY_VAR: auth_token,
+ "OPENAI_API_KEY": auth_token,
+ "CLOUDFLARE_BASE_URL": workers_ai_base_url(os.environ),
+ }
if model_provider_ref == "model_provider:openrouter":
auth_token = os.environ.get("ANTHROPIC_AUTH_TOKEN") or os.environ.get("OPENROUTER_API_KEY")
base_url = normalize_openrouter_base_url(
@@ -505,6 +527,24 @@ def _provider_env(model_provider_ref: str) -> dict[str, str | None]:
updates["ANTHROPIC_AUTH_TOKEN"] = None
updates["OPENROUTER_API_KEY"] = None
return updates
+ if model_provider_ref == "model_provider:orcarouter":
+ auth_token = os.environ.get("ANTHROPIC_AUTH_TOKEN") or os.environ.get("ORCAROUTER_API_KEY")
+ base_url = normalize_orcarouter_base_url(
+ os.environ.get("ANTHROPIC_BASE_URL")
+ or os.environ.get("ORCAROUTER_BASE_URL")
+ or ORCAROUTER_CLAUDE_SDK_BASE_URL
+ )
+ updates: dict[str, str | None] = {
+ **base,
+ "ANTHROPIC_BASE_URL": base_url,
+ }
+ if auth_token:
+ updates["ANTHROPIC_AUTH_TOKEN"] = auth_token
+ updates["ORCAROUTER_API_KEY"] = auth_token
+ else:
+ updates["ANTHROPIC_AUTH_TOKEN"] = None
+ updates["ORCAROUTER_API_KEY"] = None
+ return updates
if model_provider_ref == "model_provider:anthropic_messages":
return {
**base,
@@ -512,6 +552,12 @@ def _provider_env(model_provider_ref: str) -> dict[str, str | None]:
}
if model_provider_ref == "model_provider:openai_compatible":
return {**base, "OPENAI_API_KEY": os.environ.get("OPENAI_API_KEY")}
+ if model_provider_ref == "model_provider:groq_alias":
+ return {**base, "GROQ_API_KEY": os.environ.get("GROQ_API_KEY")}
+ if model_provider_ref == "model_provider:mistral_alias":
+ return {**base, "MISTRAL_API_KEY": os.environ.get("MISTRAL_API_KEY")}
+ if model_provider_ref == "model_provider:xai_alias":
+ return {**base, "XAI_API_KEY": os.environ.get("XAI_API_KEY")}
if model_provider_ref == "model_provider:deepseek_alias":
auth_token = os.environ.get("DEEPSEEK_API_KEY") or os.environ.get("ANTHROPIC_AUTH_TOKEN")
return {
diff --git a/praxist/plugins/workflow_stages/research_loop/startup.py b/praxist/plugins/workflow_stages/research_loop/startup.py
index 4356a76..341c24e 100644
--- a/praxist/plugins/workflow_stages/research_loop/startup.py
+++ b/praxist/plugins/workflow_stages/research_loop/startup.py
@@ -171,6 +171,8 @@ def default_model_provider_for_task(task_ref: str, model_provider_ref: str | Non
return "model_provider:deepseek_alias"
if os.environ.get("OPENROUTER_API_KEY"):
return "model_provider:openrouter"
+ if os.environ.get("ORCAROUTER_API_KEY"):
+ return "model_provider:orcarouter"
if os.environ.get("ANTHROPIC_API_KEY"):
return "model_provider:anthropic_messages"
return "model_provider:openrouter"
diff --git a/skills/praxist-control/SKILL.md b/skills/praxist-control/SKILL.md
index 8ff645f..4f17155 100644
--- a/skills/praxist-control/SKILL.md
+++ b/skills/praxist-control/SKILL.md
@@ -391,8 +391,10 @@ Before `start`, verify runtime readiness without printing secrets:
- Inspect `task.yaml.runtime_environment` for `venv`, `python`, `cwd`,
`path_prepend`, and non-secret env requirements.
- Check provider key presence by name only. Common keys are
- `DEEPSEEK_API_KEY`, `OPENROUTER_API_KEY`, `ANTHROPIC_API_KEY`, and
- `OPENAI_API_KEY`.
+ `DEEPSEEK_API_KEY`, `OPENROUTER_API_KEY`, `ORCAROUTER_API_KEY`,
+ `CLOUDFLARE_API_KEY`, `ANTHROPIC_API_KEY`, and `OPENAI_API_KEY`. Cloudflare
+ Workers AI also requires `CLOUDFLARE_ACCOUNT_ID` or a complete
+ `CLOUDFLARE_BASE_URL`.
- If the selected runtime is `agent_runtime:codex_sdk`, verify the Praxist
environment can import `openai_codex` and `mcp`, and verify distribution
versions `openai-codex==0.147.0` and `claude-agent-sdk==0.2.136`. For
diff --git a/skills/praxist-onboarding/SKILL.md b/skills/praxist-onboarding/SKILL.md
index 17679d7..5cdaf7e 100644
--- a/skills/praxist-onboarding/SKILL.md
+++ b/skills/praxist-onboarding/SKILL.md
@@ -59,7 +59,7 @@ Check these surfaces:
reinstalling or copying again.
4. **Environment variables and keys**
- - Report provider keys by presence only: `DEEPSEEK_API_KEY`, `OPENROUTER_API_KEY`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `MOONSHOT_API_KEY`, `DASHSCOPE_API_KEY`, `GOOGLE_API_KEY`, `MISTRAL_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`.
+ - Report provider keys by presence only: `DEEPSEEK_API_KEY`, `OPENROUTER_API_KEY`, `ORCAROUTER_API_KEY`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `MOONSHOT_API_KEY`, `DASHSCOPE_API_KEY`, `GOOGLE_API_KEY`, `MISTRAL_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`.
- Report non-secret Praxist configuration values when relevant: `PRAXIST_AGENT_SYSTEM`, `PRAXIST_LLM_PROVIDER`, `PRAXIST_STATE_DIR`, `PRAXIST_TASK_PROJECT_PATH`, `PRAXIST_MODEL`, `PRAXIST_MODEL_PROVIDER_REF`.
- Never print raw values for variables containing `KEY`, `TOKEN`, `SECRET`, `PASSWORD`, or `CREDENTIAL`.
- Only when Codex-native mode is explicitly selected, report saved-auth
@@ -516,8 +516,13 @@ Common provider/key context:
- Anthropic native: `ANTHROPIC_API_KEY`
- OpenRouter: `OPENROUTER_API_KEY`
+- OrcaRouter: `ORCAROUTER_API_KEY`
+- Cloudflare Workers AI: `CLOUDFLARE_API_KEY` plus `CLOUDFLARE_ACCOUNT_ID`
- DeepSeek direct: `DEEPSEEK_API_KEY`
- OpenAI-compatible: `OPENAI_API_KEY`
+- Groq: `GROQ_API_KEY`
+- Mistral: `MISTRAL_API_KEY`
+- xAI: `XAI_API_KEY`
- Agent system selector: `PRAXIST_AGENT_SYSTEM` or `--agent-system`
- Provider selector: `PRAXIST_LLM_PROVIDER` or `--model-provider`
- Config profile: command-local `--config-file`, then
diff --git a/skills/praxist-runtime-install/SKILL.md b/skills/praxist-runtime-install/SKILL.md
index fac5d1d..613d715 100644
--- a/skills/praxist-runtime-install/SKILL.md
+++ b/skills/praxist-runtime-install/SKILL.md
@@ -215,8 +215,10 @@ Provider names map to these env vars:
|---|---|
| `anthropic` | `ANTHROPIC_API_KEY` |
| `openrouter` | `OPENROUTER_API_KEY` |
+| `orcarouter` | `ORCAROUTER_API_KEY` |
| `deepseek` | `DEEPSEEK_API_KEY` |
| `openai` | `OPENAI_API_KEY` |
+| `cloudflare` | `CLOUDFLARE_API_KEY` (also requires `CLOUDFLARE_ACCOUNT_ID`) |
| `moonshot` / `kimi` | `MOONSHOT_API_KEY` |
| `qwen` | `DASHSCOPE_API_KEY` |
| `google` | `GOOGLE_API_KEY` |
diff --git a/skills/praxist-runtime-install/scripts/install_runtime_deps.sh b/skills/praxist-runtime-install/scripts/install_runtime_deps.sh
index 59428c0..5594680 100755
--- a/skills/praxist-runtime-install/scripts/install_runtime_deps.sh
+++ b/skills/praxist-runtime-install/scripts/install_runtime_deps.sh
@@ -252,6 +252,9 @@ provider_key_var() {
openrouter)
printf '%s\n' "OPENROUTER_API_KEY"
;;
+ orcarouter)
+ printf '%s\n' "ORCAROUTER_API_KEY"
+ ;;
deepseek|deepseek_alias)
printf '%s\n' "DEEPSEEK_API_KEY"
;;
diff --git a/tests/conformance/test_core_plugin_contracts.py b/tests/conformance/test_core_plugin_contracts.py
index ab20e61..3df29bb 100644
--- a/tests/conformance/test_core_plugin_contracts.py
+++ b/tests/conformance/test_core_plugin_contracts.py
@@ -125,7 +125,12 @@ class CorePluginContractsTest(unittest.TestCase):
"model_provider:anthropic_messages",
"model_provider:openai_compatible",
"model_provider:openrouter",
+ "model_provider:orcarouter",
+ "model_provider:cloudflare",
"model_provider:deepseek_alias",
+ "model_provider:groq_alias",
+ "model_provider:mistral_alias",
+ "model_provider:xai_alias",
):
profile = default_model_profile(provider_ref)
call = provider_for_ref(provider_ref).build_call(profile, credential_ref=None)
@@ -136,6 +141,10 @@ class CorePluginContractsTest(unittest.TestCase):
provider_for_ref("model_provider:openrouter").classify_error({"status": 429}),
"rate_limited",
)
+ self.assertEqual(
+ provider_for_ref("model_provider:orcarouter").classify_error({"status": 429}),
+ "rate_limited",
+ )
self.assertEqual(
provider_for_ref("model_provider:deepseek_alias").classify_error(
{"message": "quota exhausted"}
diff --git a/tests/conformance/test_plugin_executable_closure.py b/tests/conformance/test_plugin_executable_closure.py
index 0cb8024..90497af 100644
--- a/tests/conformance/test_plugin_executable_closure.py
+++ b/tests/conformance/test_plugin_executable_closure.py
@@ -107,6 +107,8 @@ class PluginExecutableClosureTest(unittest.TestCase):
"workflow_stage:research_loop",
"budget_policy:default_basic",
"model_provider:openrouter",
+ "model_provider:orcarouter",
+ "model_provider:cloudflare",
"tool_server:evaluation_tools",
"tool_server:frontier_tools",
"tool_server:finding_graph_query",
@@ -125,6 +127,8 @@ class PluginExecutableClosureTest(unittest.TestCase):
self.assertTrue(hasattr(registry.require("workflow_stage", "research_loop"), "execute"))
self.assertTrue(hasattr(registry.require("budget_policy", "default_basic"), "decide"))
self.assertTrue(hasattr(registry.require("model_provider", "openrouter"), "build_call"))
+ self.assertTrue(hasattr(registry.require("model_provider", "orcarouter"), "build_call"))
+ self.assertTrue(hasattr(registry.require("model_provider", "cloudflare"), "build_call"))
self.assertEqual(
registry.require("tool_server", "memory_tools")["factory"],
"praxist.plugins.tools.memory_tools.adapter:create_memory_tools_server",
@@ -175,6 +179,27 @@ class PluginExecutableClosureTest(unittest.TestCase):
manifest["provider"]["model_profiles"]["cheap_peer"], "anthropic/claude-sonnet-4.5"
)
+ def test_orcarouter_manifest_records_model_contract(self) -> None:
+ manifest = yaml.safe_load(
+ Path.cwd()
+ .joinpath("praxist", "plugins", "model_providers", "orcarouter", "plugin.yaml")
+ .read_text(encoding="utf-8")
+ )
+ self.assertEqual(manifest["provider"]["api_format"], "orcarouter")
+ self.assertEqual(manifest["provider"]["default_model"], "orcarouter/auto")
+
+ def test_cloudflare_manifest_records_model_contract(self) -> None:
+ manifest = yaml.safe_load(
+ Path.cwd()
+ .joinpath("praxist", "plugins", "model_providers", "cloudflare", "plugin.yaml")
+ .read_text(encoding="utf-8")
+ )
+ self.assertEqual(manifest["provider"]["api_format"], "cloudflare_workers_ai")
+ self.assertEqual(
+ manifest["provider"]["default_model"],
+ "@cf/deepseek-ai/deepseek-v4-flash-0731",
+ )
+
def test_project_agent_runtime_can_execute_through_entrypoint(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
diff --git a/tests/hardening/env_read_allowlist.txt b/tests/hardening/env_read_allowlist.txt
index f4ab174..cf83d7b 100644
--- a/tests/hardening/env_read_allowlist.txt
+++ b/tests/hardening/env_read_allowlist.txt
@@ -186,11 +186,17 @@ praxist/plugins/workflow_stages/research_loop/stage.py::CLAUDE_CODE_EFFORT_LEVEL
praxist/plugins/workflow_stages/research_loop/stage.py::CLAUDE_CODE_SUBAGENT_MODEL
praxist/plugins/workflow_stages/research_loop/stage.py::DEEPSEEK_ANTHROPIC_BASE_URL
praxist/plugins/workflow_stages/research_loop/stage.py::DEEPSEEK_API_KEY
+praxist/plugins/workflow_stages/research_loop/stage.py::GROQ_API_KEY
+praxist/plugins/workflow_stages/research_loop/stage.py::MISTRAL_API_KEY
praxist/plugins/workflow_stages/research_loop/stage.py::OPENAI_API_KEY
praxist/plugins/workflow_stages/research_loop/stage.py::OPENROUTER_API_KEY
praxist/plugins/workflow_stages/research_loop/stage.py::OPENROUTER_BASE_URL
+praxist/plugins/workflow_stages/research_loop/stage.py::ORCAROUTER_API_KEY
+praxist/plugins/workflow_stages/research_loop/stage.py::ORCAROUTER_BASE_URL
+praxist/plugins/workflow_stages/research_loop/stage.py::XAI_API_KEY
# startup.py reads PATH for subprocess env construction.
praxist/plugins/workflow_stages/research_loop/startup.py::ANTHROPIC_API_KEY
praxist/plugins/workflow_stages/research_loop/startup.py::DEEPSEEK_API_KEY
praxist/plugins/workflow_stages/research_loop/startup.py::OPENROUTER_API_KEY
+praxist/plugins/workflow_stages/research_loop/startup.py::ORCAROUTER_API_KEY
praxist/plugins/workflow_stages/research_loop/startup.py::PATH
diff --git a/tests/hardening/test_refactor_hardening.py b/tests/hardening/test_refactor_hardening.py
index 274be7c..9b9e057 100644
--- a/tests/hardening/test_refactor_hardening.py
+++ b/tests/hardening/test_refactor_hardening.py
@@ -2941,6 +2941,24 @@ assets: []
self.assertIsNotNone(credential)
self.assertEqual(credential.provider, "deepseek_alias")
+ def test_new_provider_aliases_env_keys_select_respective_providers(self) -> None:
+ cases = (
+ ("CLOUDFLARE_API_KEY", "cloudflare", "model_provider:cloudflare"),
+ ("GROQ_API_KEY", "groq_alias", "model_provider:groq_alias"),
+ ("MISTRAL_API_KEY", "mistral_alias", "model_provider:mistral_alias"),
+ ("XAI_API_KEY", "xai_alias", "model_provider:xai_alias"),
+ )
+ for env_key, provider, target_ref in cases:
+ credential_set = CredentialResolver({env_key: "sk-test-redaction-000000"}).discover()
+ manager = CredentialFailoverManager(credential_set)
+ credential = manager.select(
+ scope="model_provider",
+ provider=provider,
+ target_ref=target_ref,
+ )
+ self.assertIsNotNone(credential, f"failed for {provider}")
+ self.assertEqual(credential.provider, provider)
+
def test_plugin_code_and_asset_paths_are_confined_to_plugin_root(self) -> None:
with tempfile.TemporaryDirectory() as tmp:
root = Path(tmp)
diff --git a/tests/unit/test_cli_resolve.py b/tests/unit/test_cli_resolve.py
index 0b2b1dc..ab0c053 100644
--- a/tests/unit/test_cli_resolve.py
+++ b/tests/unit/test_cli_resolve.py
@@ -55,6 +55,7 @@ class ResolveCliEndToEndTest(unittest.TestCase):
"MODEL": "",
"DEEPSEEK_API_KEY": "",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
},
clear=False,
),
diff --git a/tests/unit/test_cli_setup_commands.py b/tests/unit/test_cli_setup_commands.py
index a066bad..8dc05f8 100644
--- a/tests/unit/test_cli_setup_commands.py
+++ b/tests/unit/test_cli_setup_commands.py
@@ -240,6 +240,38 @@ class ConfigureLLMTest(CliRunnerMixin, unittest.TestCase):
self.assertIn("export PRAXIST_MODEL=deepseek/demo", text)
self.assertIn("export OPENROUTER_API_KEY=sk-project-secret", text)
+ def test_configure_llm_supports_openai_compatible_provider_plugins(self) -> None:
+ for short_name, key_name, provider_ref in (
+ ("groq", "GROQ_API_KEY", "model_provider:groq_alias"),
+ ("mistral", "MISTRAL_API_KEY", "model_provider:mistral_alias"),
+ ("xai", "XAI_API_KEY", "model_provider:xai_alias"),
+ ("cloudflare", "CLOUDFLARE_API_KEY", "model_provider:cloudflare"),
+ ):
+ with tempfile.TemporaryDirectory() as tmp:
+ config_file = Path(tmp) / "config" / "env"
+ secret = f"sk-{short_name}-secret"
+ code, out, err = self._run(
+ [
+ "configure-llm",
+ "--provider",
+ short_name,
+ "--agent-system",
+ "codex_sdk",
+ "--api-key-stdin",
+ "--config-file",
+ str(config_file),
+ ],
+ stdin=f"{secret}\n",
+ )
+ self.assertEqual(code, 0, msg=out + err)
+ text = config_file.read_text(encoding="utf-8")
+ self.assertIn(f"export PRAXIST_LLM_PROVIDER={short_name}", text)
+ self.assertIn(
+ f"export PRAXIST_MODEL_PROVIDER_REF={provider_ref}",
+ text,
+ )
+ self.assertIn(f"export {key_name}={secret}", text)
+
def test_configure_llm_replaces_stale_canonical_runtime_and_provider_refs(self) -> None:
from praxist.cli import start
from praxist.cli._setup_common import load_env_file
@@ -2715,6 +2747,8 @@ class DoctorAndSetupTest(CliRunnerMixin, unittest.TestCase):
self.assertFalse(profiles["codex-native"]["requires_api_key"])
self.assertEqual(profiles["deepseek-api"]["agent_system"], "claude_sdk")
self.assertTrue(profiles["deepseek-api"]["requires_api_key"])
+ self.assertEqual(profiles["orcarouter-api"]["agent_system"], "claude_sdk")
+ self.assertTrue(profiles["orcarouter-api"]["requires_api_key"])
self.assertEqual(profiles["codex-native"]["authentication"], "saved_chatgpt_login")
def test_codex_managed_status_does_not_treat_defaults_as_a_profile_choice(self) -> None:
diff --git a/tests/unit/test_cli_start.py b/tests/unit/test_cli_start.py
index a21d66b..b0619ed 100644
--- a/tests/unit/test_cli_start.py
+++ b/tests/unit/test_cli_start.py
@@ -116,6 +116,7 @@ class LaunchRunTest(unittest.TestCase):
"PRAXIST_STATE_DIR": self.state.name,
"ANTHROPIC_API_KEY": "test-anthropic-key",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
"OPENAI_API_KEY": "",
"DEEPSEEK_API_KEY": "",
"PRAXIST_MODEL_PROVIDER_REF": "",
@@ -198,6 +199,29 @@ class LaunchRunTest(unittest.TestCase):
self.assertEqual(entry.model_provider_ref, start.OPENROUTER_PROVIDER_REF)
self.assertEqual(entry.model, start.OPENROUTER_DEFAULT_MODEL)
+ def test_orcarouter_provider_picked_when_only_orcarouter_key_set(self) -> None:
+ from praxist.cli import start
+
+ task = _make_task_dir(Path(self.workspace.name), name="orcarouter")
+ with patch.dict(
+ os.environ,
+ {"ANTHROPIC_API_KEY": "", "OPENROUTER_API_KEY": "", "ORCAROUTER_API_KEY": "orca-key"},
+ clear=False,
+ ):
+ entry = start.launch_run(
+ task_path=str(task),
+ run_dir=None,
+ model=None,
+ model_provider_ref=None,
+ frontier_strategy="auto",
+ cohort=None,
+ generations=None,
+ server=False,
+ spawn=MagicMock(return_value=_FakeProc()),
+ )
+ self.assertEqual(entry.model_provider_ref, start.ORCAROUTER_PROVIDER_REF)
+ self.assertEqual(entry.model, start.ORCAROUTER_DEFAULT_MODEL)
+
def test_deepseek_provider_picked_when_only_deepseek_key_set(self) -> None:
from praxist.cli import start
@@ -909,6 +933,7 @@ class CodexSdkAgentSystemTest(unittest.TestCase):
"PRAXIST_STATE_DIR": self.state.name,
"ANTHROPIC_API_KEY": "",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
"OPENAI_API_KEY": "sk-openai-test",
"DEEPSEEK_API_KEY": "",
"PRAXIST_MODEL_PROVIDER_REF": "",
@@ -1204,6 +1229,19 @@ class CodexSdkAgentSystemTest(unittest.TestCase):
resolved = start._resolve_model(None, "model_provider:custom", "claude_sdk")
self.assertEqual(resolved, "")
+ def test_resolve_model_uses_cloudflare_provider_default(self) -> None:
+ from praxist.cli import _env, start
+
+ with patch.dict(os.environ, {"MODEL": "", "PRAXIST_MODEL": ""}, clear=False):
+ resolved = start._resolve_model(None, start.CLOUDFLARE_PROVIDER_REF, "codex_sdk")
+ self.assertEqual(resolved, start.CLOUDFLARE_DEFAULT_MODEL)
+ self.assertEqual(_env.provider_base_url("groq"), "https://api.groq.com/openai/v1")
+ with patch.dict(os.environ, {"CLOUDFLARE_ACCOUNT_ID": "account-id"}, clear=True):
+ self.assertEqual(
+ _env.provider_base_url(" Cloudflare "),
+ "https://api.cloudflare.com/client/v4/accounts/account-id/ai/v1",
+ )
+
def test_praxist_agent_system_env_var_picks_codex_sdk(self) -> None:
from praxist.cli import start
@@ -1397,6 +1435,7 @@ class StartCliEndToEndTest(unittest.TestCase):
"PRAXIST_CONFIG_FILE": str(config_file),
"ANTHROPIC_API_KEY": "test-anthropic-key",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
"OPENAI_API_KEY": "",
"DEEPSEEK_API_KEY": "",
"PRAXIST_MODEL_PROVIDER_REF": "",
@@ -1541,6 +1580,7 @@ class DaemonizeFlagTest(unittest.TestCase):
"PRAXIST_STATE_DIR": self.state.name,
"ANTHROPIC_API_KEY": "test-anthropic-key",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
"OPENAI_API_KEY": "",
"DEEPSEEK_API_KEY": "",
"PRAXIST_MODEL_PROVIDER_REF": "",
diff --git a/tests/unit/test_codex_sdk_relay.py b/tests/unit/test_codex_sdk_relay.py
index 863b076..6514c8b 100644
--- a/tests/unit/test_codex_sdk_relay.py
+++ b/tests/unit/test_codex_sdk_relay.py
@@ -11,6 +11,7 @@ from pathlib import Path
from typing import Any
from unittest.mock import patch
+from praxist.core.cloudflare import workers_ai_base_url
from praxist.plugins.agent_runtimes.codex_sdk._relay import (
RelayHandle,
_available_port,
@@ -19,6 +20,7 @@ from praxist.plugins.agent_runtimes.codex_sdk._relay import (
needs_relay,
provider_key_var,
provider_name,
+ provider_upstream,
start_relay,
)
@@ -56,19 +58,69 @@ class ProviderRoutingTest(unittest.TestCase):
self.assertEqual(provider_name("model_provider:deepseek_alias"), "deepseek")
self.assertEqual(provider_name("model_provider:openai_compatible"), "openai")
self.assertEqual(provider_name("model_provider:openai"), "openai")
+ self.assertEqual(provider_name("model_provider:groq_alias"), "groq")
+ self.assertEqual(provider_name("model_provider:mistral_alias"), "mistral")
+ self.assertEqual(provider_name("model_provider:xai_alias"), "xai")
+ self.assertEqual(provider_name("model_provider:cloudflare"), "cloudflare")
def test_only_openai_uses_direct_responses_transport(self) -> None:
self.assertFalse(needs_relay("openai"))
self.assertFalse(needs_relay(""))
self.assertTrue(needs_relay("deepseek"))
+ self.assertTrue(needs_relay("groq"))
+ self.assertTrue(needs_relay("mistral"))
+ self.assertTrue(needs_relay("xai"))
+ self.assertTrue(needs_relay("cloudflare"))
def test_provider_key_variables_are_explicit(self) -> None:
self.assertEqual(provider_key_var("deepseek"), "DEEPSEEK_API_KEY")
self.assertEqual(provider_key_var("openrouter"), "OPENROUTER_API_KEY")
+ self.assertEqual(provider_key_var("groq"), "GROQ_API_KEY")
+ self.assertEqual(provider_key_var("mistral"), "MISTRAL_API_KEY")
+ self.assertEqual(provider_key_var("xai"), "XAI_API_KEY")
+ self.assertEqual(provider_key_var("cloudflare"), "CLOUDFLARE_API_KEY")
self.assertEqual(provider_key_var("unknown"), "OPENAI_API_KEY")
+ def test_cloudflare_upstream_is_account_scoped_or_explicit(self) -> None:
+ self.assertEqual(
+ workers_ai_base_url({}, account_id="explicit-account"),
+ "https://api.cloudflare.com/client/v4/accounts/explicit-account/ai/v1",
+ )
+ with patch.dict(os.environ, {"CLOUDFLARE_ACCOUNT_ID": "account-id"}, clear=True):
+ self.assertEqual(
+ provider_upstream("cloudflare"),
+ "https://api.cloudflare.com/client/v4/accounts/account-id/ai/v1",
+ )
+ with patch.dict(
+ os.environ,
+ {"CLOUDFLARE_BASE_URL": "https://gateway.example/v1/"},
+ clear=True,
+ ):
+ self.assertEqual(provider_upstream("cloudflare"), "https://gateway.example/v1")
+ with (
+ patch.dict(os.environ, {}, clear=True),
+ self.assertRaisesRegex(ValueError, "CLOUDFLARE_ACCOUNT_ID"),
+ ):
+ provider_upstream("cloudflare")
+
class RelayLifecycleTest(unittest.TestCase):
+ def test_cloudflare_configuration_error_is_normalized(self) -> None:
+ with (
+ tempfile.TemporaryDirectory() as tmp,
+ patch(
+ "praxist.plugins.agent_runtimes.codex_sdk._relay._relay_binary",
+ return_value="/usr/bin/codex-relay",
+ ),
+ patch.dict(os.environ, {}, clear=True),
+ self.assertRaisesRegex(RuntimeError, "CLOUDFLARE_ACCOUNT_ID"),
+ ):
+ start_relay(
+ provider="cloudflare",
+ api_key="cf-key",
+ state_dir=Path(tmp),
+ )
+
def test_available_port_is_ephemeral_and_released(self) -> None:
port = _available_port()
self.assertGreater(port, 0)
diff --git a/tests/unit/test_coverage_95_contracts.py b/tests/unit/test_coverage_95_contracts.py
index 3568811..1bdd42a 100644
--- a/tests/unit/test_coverage_95_contracts.py
+++ b/tests/unit/test_coverage_95_contracts.py
@@ -414,10 +414,16 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
os.environ,
{
"OPENROUTER_API_KEY": "or-key",
+ "ORCAROUTER_API_KEY": "orca-key",
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api/v1",
"ANTHROPIC_API_KEY": "anthropic-key",
"OPENAI_API_KEY": "openai-key",
"DEEPSEEK_API_KEY": "deepseek-key",
+ "CLOUDFLARE_API_KEY": "cloudflare-key",
+ "CLOUDFLARE_ACCOUNT_ID": "account-id",
+ "GROQ_API_KEY": "groq-key",
+ "MISTRAL_API_KEY": "mistral-key",
+ "XAI_API_KEY": "xai-key",
},
clear=True,
):
@@ -429,6 +435,10 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
stage._provider_env("model_provider:openrouter")["OPENROUTER_API_KEY"],
"or-key",
)
+ self.assertEqual(
+ stage._provider_env("model_provider:orcarouter")["ORCAROUTER_API_KEY"],
+ "orca-key",
+ )
self.assertEqual(
stage._provider_env("model_provider:anthropic_messages")["ANTHROPIC_API_KEY"],
"anthropic-key",
@@ -437,6 +447,25 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
stage._provider_env("model_provider:openai_compatible")["OPENAI_API_KEY"],
"openai-key",
)
+ self.assertEqual(
+ stage._provider_env("model_provider:groq_alias")["GROQ_API_KEY"],
+ "groq-key",
+ )
+ self.assertEqual(
+ stage._provider_env("model_provider:mistral_alias")["MISTRAL_API_KEY"],
+ "mistral-key",
+ )
+ self.assertEqual(
+ stage._provider_env("model_provider:xai_alias")["XAI_API_KEY"],
+ "xai-key",
+ )
+ cloudflare_env = stage._provider_env("model_provider:cloudflare")
+ self.assertEqual(cloudflare_env["CLOUDFLARE_API_KEY"], "cloudflare-key")
+ self.assertEqual(cloudflare_env["OPENAI_API_KEY"], "cloudflare-key")
+ self.assertEqual(
+ cloudflare_env["CLOUDFLARE_BASE_URL"],
+ "https://api.cloudflare.com/client/v4/accounts/account-id/ai/v1",
+ )
self.assertEqual(
stage._provider_env("model_provider:deepseek_alias")["DEEPSEEK_API_KEY"],
"deepseek-key",
@@ -452,6 +481,11 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
with self.assertRaises(ValueError):
stage._provider_env("model_provider:unknown")
+ with patch.dict(os.environ, {}, clear=True):
+ orcarouter_env = stage._provider_env("model_provider:orcarouter")
+ self.assertIsNone(orcarouter_env["ANTHROPIC_AUTH_TOKEN"])
+ self.assertIsNone(orcarouter_env["ORCAROUTER_API_KEY"])
+
def test_research_loop_stage_execute_resolve_success_and_unknown_usage(self) -> None:
from praxist.plugins.workflow_stages.research_loop import stage
@@ -610,6 +644,9 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
("model_provider:openrouter", "ANTHROPIC_AUTH_TOKEN"),
("model_provider:anthropic_messages", "ANTHROPIC_API_KEY"),
("model_provider:openai_compatible", "OPENAI_API_KEY"),
+ ("model_provider:groq_alias", "GROQ_API_KEY"),
+ ("model_provider:mistral_alias", "MISTRAL_API_KEY"),
+ ("model_provider:xai_alias", "XAI_API_KEY"),
("model_provider:deepseek_alias", "ANTHROPIC_AUTH_TOKEN"),
("model_provider:fake_provider", None),
):
@@ -621,6 +658,9 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"OPENAI_API_KEY": "openai",
"DEEPSEEK_API_KEY": "deepseek",
+ "GROQ_API_KEY": "groq",
+ "MISTRAL_API_KEY": "mistral",
+ "XAI_API_KEY": "xai",
}
with patch.dict(os.environ, env, clear=True):
scoped = agent._scoped_legacy_provider_env()
@@ -644,6 +684,22 @@ class StageAndAgentCoverage95ContractsTest(unittest.TestCase):
scoped["ANTHROPIC_BASE_URL"], "https://api.deepseek.com/anthropic"
)
+ with patch.dict(
+ os.environ,
+ {
+ "PRAXIST_MODEL_PROVIDER_REF": "model_provider:cloudflare",
+ "CLOUDFLARE_API_KEY": "cloudflare",
+ "CLOUDFLARE_BASE_URL": "https://gateway.example/v1",
+ "GROQ_API_KEY": "unrelated",
+ },
+ clear=True,
+ ):
+ scoped = agent._scoped_legacy_provider_env()
+ self.assertEqual(scoped["CLOUDFLARE_API_KEY"], "cloudflare")
+ self.assertEqual(scoped["OPENAI_API_KEY"], "cloudflare")
+ self.assertEqual(scoped["CLOUDFLARE_BASE_URL"], "https://gateway.example/v1")
+ self.assertNotIn("GROQ_API_KEY", scoped)
+
with patch.dict(
os.environ,
{"PRAXIST_MODEL_PROVIDER_REF": "", "ANTHROPIC_API_KEY": "legacy"},
diff --git a/tests/unit/test_modeling_normalize.py b/tests/unit/test_modeling_normalize.py
index 03a5dea..d2079cc 100644
--- a/tests/unit/test_modeling_normalize.py
+++ b/tests/unit/test_modeling_normalize.py
@@ -26,6 +26,24 @@ class NormalizeModelForApiFormatTest(unittest.TestCase):
"anthropic/claude-opus-4.7",
)
+ def test_orcarouter_keeps_vendor_prefix(self) -> None:
+ self.assertEqual(
+ modeling._normalize_model_for_api_format("anthropic/claude-opus-4.7", "orcarouter"),
+ "anthropic/claude-opus-4.7",
+ )
+ self.assertEqual(
+ modeling._normalize_model_for_api_format("orcarouter/auto", "orcarouter"),
+ "orcarouter/auto",
+ )
+
+ def test_cloudflare_keeps_full_model_id(self) -> None:
+ self.assertEqual(
+ modeling._normalize_model_for_api_format(
+ "@cf/deepseek-ai/deepseek-v4-pro-0813", "cloudflare_workers_ai"
+ ),
+ "@cf/deepseek-ai/deepseek-v4-pro-0813",
+ )
+
def test_openrouter_keeps_bare_name_unchanged(self) -> None:
# Bare name into openrouter is the operator's responsibility;
# we never invent a prefix.
@@ -104,6 +122,16 @@ class NormalizeModelForProviderTest(unittest.TestCase):
"anthropic/claude-opus-4.7",
)
+ def test_groq_api_format_keeps_vendor_prefixed_model_ids(self) -> None:
+ # Groq publishes ids like ``openai/gpt-oss-20b``; the vendor segment is
+ # part of the id, so stripping it would send an unknown model upstream.
+ for model in ("openai/gpt-oss-20b", "openai/gpt-oss-120b", "groq/compound"):
+ with self.subTest(model=model):
+ self.assertEqual(
+ modeling._normalize_model_for_api_format(model, "groq"),
+ model,
+ )
+
def test_normalize_defaults_to_openai_compatible_when_api_format_missing(self) -> None:
with patch.object(modeling, "_provider_contract", return_value={}):
self.assertEqual(
@@ -261,7 +289,11 @@ class ProviderDefaultModelTest(unittest.TestCase):
"model_provider:anthropic_messages": "claude-opus-4-7",
"model_provider:openrouter": "anthropic/claude-opus-4.7",
"model_provider:openai_compatible": "gpt-5.2",
+ "model_provider:cloudflare": "@cf/deepseek-ai/deepseek-v4-flash-0731",
"model_provider:deepseek_alias": "deepseek-v4-pro[1m]",
+ "model_provider:groq_alias": "openai/gpt-oss-20b",
+ "model_provider:mistral_alias": "mistral-large-latest",
+ "model_provider:xai_alias": "grok-4.6",
}
for ref, expected in cases.items():
with self.subTest(provider=ref):
diff --git a/tests/unit/test_startup_helper_contracts.py b/tests/unit/test_startup_helper_contracts.py
index f9aa186..b54b5b3 100644
--- a/tests/unit/test_startup_helper_contracts.py
+++ b/tests/unit/test_startup_helper_contracts.py
@@ -75,6 +75,7 @@ class StartupHelperContractsTest(unittest.TestCase):
{
"DEEPSEEK_API_KEY": "deepseek-key",
"OPENROUTER_API_KEY": "openrouter-key",
+ "ORCAROUTER_API_KEY": "",
"ANTHROPIC_API_KEY": "anthropic-key",
},
clear=False,
@@ -88,6 +89,7 @@ class StartupHelperContractsTest(unittest.TestCase):
{
"DEEPSEEK_API_KEY": "",
"OPENROUTER_API_KEY": "openrouter-key",
+ "ORCAROUTER_API_KEY": "",
"ANTHROPIC_API_KEY": "anthropic-key",
},
clear=False,
@@ -101,6 +103,21 @@ class StartupHelperContractsTest(unittest.TestCase):
{
"DEEPSEEK_API_KEY": "",
"OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "orcarouter-key",
+ "ANTHROPIC_API_KEY": "anthropic-key",
+ },
+ clear=False,
+ ):
+ self.assertEqual(
+ startup.default_model_provider_for_task("task:x"),
+ "model_provider:orcarouter",
+ )
+ with patch.dict(
+ os.environ,
+ {
+ "DEEPSEEK_API_KEY": "",
+ "OPENROUTER_API_KEY": "",
+ "ORCAROUTER_API_KEY": "",
"ANTHROPIC_API_KEY": "anthropic-key",
},
clear=False,
@@ -180,6 +197,22 @@ class StartupHelperContractsTest(unittest.TestCase):
)["ANTHROPIC_BASE_URL"],
"https://openrouter.ai/api/v1/messages",
)
+ self.assertEqual(
+ provider_env.freeze_provider_env(
+ "model_provider:orcarouter",
+ {
+ "ORCAROUTER_BASE_URL": "https://api.orcarouter.ai/v1",
+ "ORCAROUTER_API_KEY": "key",
+ },
+ )["ANTHROPIC_BASE_URL"],
+ "https://api.orcarouter.ai",
+ )
+ self.assertEqual(
+ provider_env.freeze_provider_env(
+ "model_provider:orcarouter", {"ORCAROUTER_API_KEY": "k"}
+ )["ORCAROUTER_API_KEY"],
+ "k",
+ )
self.assertEqual(
provider_env.freeze_provider_env(
"model_provider:anthropic_messages", {"ANTHROPIC_API_KEY": "a"}
@@ -192,6 +225,45 @@ class StartupHelperContractsTest(unittest.TestCase):
)["OPENAI_API_KEY"],
"o",
)
+ groq_env = provider_env.freeze_provider_env(
+ "model_provider:groq_alias", {"GROQ_API_KEY": "g"}
+ )
+ self.assertEqual(groq_env["GROQ_API_KEY"], "g")
+ mistral_env = provider_env.freeze_provider_env(
+ "model_provider:mistral_alias", {"MISTRAL_API_KEY": "m"}
+ )
+ self.assertEqual(mistral_env["MISTRAL_API_KEY"], "m")
+ xai_env = provider_env.freeze_provider_env(
+ "model_provider:xai_alias", {"XAI_API_KEY": "x"}
+ )
+ self.assertEqual(xai_env["XAI_API_KEY"], "x")
+ cloudflare_env = provider_env.freeze_provider_env(
+ "model_provider:cloudflare",
+ {
+ "CLOUDFLARE_API_KEY": "cf",
+ "CLOUDFLARE_ACCOUNT_ID": "account-id",
+ "GROQ_API_KEY": "unrelated",
+ },
+ )
+ self.assertEqual(cloudflare_env["CLOUDFLARE_API_KEY"], "cf")
+ self.assertEqual(cloudflare_env["OPENAI_API_KEY"], "cf")
+ self.assertEqual(
+ cloudflare_env["CLOUDFLARE_BASE_URL"],
+ "https://api.cloudflare.com/client/v4/accounts/account-id/ai/v1",
+ )
+ self.assertIsNone(cloudflare_env["GROQ_API_KEY"])
+ override_env = provider_env.freeze_provider_env(
+ "model_provider:cloudflare",
+ {
+ "CLOUDFLARE_API_KEY": "cf",
+ "CLOUDFLARE_BASE_URL": "https://gateway.example/v1/",
+ },
+ )
+ self.assertEqual(override_env["CLOUDFLARE_BASE_URL"], "https://gateway.example/v1")
+ with self.assertRaisesRegex(ValueError, "CLOUDFLARE_ACCOUNT_ID"):
+ provider_env.freeze_provider_env(
+ "model_provider:cloudflare", {"CLOUDFLARE_API_KEY": "cf"}
+ )
deepseek_env = provider_env.freeze_provider_env(
"model_provider:deepseek_alias", {"DEEPSEEK_API_KEY": "d"}
)