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.mdindex 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 APIprofiles. Enter the selected provider's key at the local masked prompt whenrequested.diff --git a/docs/guides/agent-runtimes.md b/docs/guides/agent-runtimes.mdindex 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 explicitlyexcluded.## Reasoning Policy@@ -172,8 +177,8 @@ private run-scoped relay injects the same policy into Chat Completions requestsand 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`; Praxistsurfaces that API provider error and leaves the user's policy unchanged.diff --git a/docs/guides/credentials.md b/docs/guides/credentials.mdindex 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:```bashexport 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.mdindex 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 mayoverride the `ModelProfile` used by a stage.diff --git a/docs/guides/open-source-model-apis.md b/docs/guides/open-source-model-apis.mdindex 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 forevery task. Availability, pricing, model behavior, and provider-side caching candiff --git a/docs/reference/cli.md b/docs/reference/cli.mdindex 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 runtimeusage: 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.mdindex 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.startupdiff --git a/praxist/cli/_env.py b/praxist/cli/_env.pyindex fddc430..8af8328 100644--- a/praxist/cli/_env.py+++ b/praxist/cli/_env.py@@ -9,6 +9,13 @@ from __future__ import annotationsimport 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_systemreturn 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.pyindex 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.pyindex 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.pyindex 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_PROVIDERfrom praxist.task_spec import load_task_specif 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_REFif 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) -> strreturn from_envif provider_ref == OPENROUTER_PROVIDER_REF:return OPENROUTER_DEFAULT_MODEL+ if provider_ref == ORCAROUTER_PROVIDER_REF:+ return ORCAROUTER_DEFAULT_MODELif provider_ref == DEEPSEEK_PROVIDER_REF:return DEEPSEEK_DEFAULT_MODEL+ if provider_ref == CLOUDFLARE_PROVIDER_REF:+ return CLOUDFLARE_DEFAULT_MODELif provider_ref == ANTHROPIC_PROVIDER_REF:return ANTHROPIC_DEFAULT_MODELreturn ""diff --git a/praxist/core/cloudflare.py b/praxist/core/cloudflare.pynew file mode 100644index 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.pyindex 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.pyindex dedbb1e..7d9b7eb 100644--- a/praxist/core/modeling.py+++ b/praxist/core/modeling.py@@ -8,6 +8,7 @@ from typing import Anyimport yaml+from praxist.core.cloudflare import CLOUDFLARE_API_FORMATfrom praxist.core.credentials import CredentialReffrom praxist.core.protocol import ModelCallSpec, ModelProfile, ModelResultfrom 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 modelif "/" 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.pyindex 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.yamlindex 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_aliascache_strategy: runtime_auto_cacheevent_schema: praxist.agent_event.v1diff --git a/praxist/plugins/agent_runtimes/codex_sdk/_relay.py b/praxist/plugins/agent_runtimes/codex_sdk/_relay.pyindex 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, Sequencefrom dataclasses import dataclassfrom 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 excif 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.pyindex 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 policyreturn {"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.yamlindex 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_aliascache_strategy: runtime_auto_cacheevent_schema: praxist.agent_event.v1usage_reporting: usage_or_usage_unknowndiff --git a/praxist/plugins/model_providers/cloudflare/__init__.py b/praxist/plugins/model_providers/cloudflare/__init__.pynew file mode 100644index 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.pynew file mode 100644index 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.yamlnew file mode 100644index 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__.pynew file mode 100644index 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.pynew file mode 100644index 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.yamlnew file mode 100644index 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__.pynew file mode 100644index 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.pynew file mode 100644index 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.yamlnew file mode 100644index 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__.pynew file mode 100644index 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.pynew file mode 100644index 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.yamlnew file mode 100644index 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__.pynew file mode 100644index 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.pynew file mode 100644index 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.yamlnew file mode 100644index 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.pyindex 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_reffrom praxist.core.modeling import default_model_profilefrom 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 NavigationThis 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_keyif 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 Falseif mode == "lossless":return True- if provider_ref == "model_provider:openrouter":+ if provider_ref in {"model_provider:openrouter", "model_provider:orcarouter"}:return Truereturn 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.pyindex 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.pyindex 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 annotationsfrom 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.pyindex 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 Pathfrom typing import Anyfrom 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 BudgetLedgerfrom praxist.core.role_skills import RoleSkill, load_role_skillfrom 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"] = Noneupdates["OPENROUTER_API_KEY"] = Nonereturn 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 updatesif 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.pyindex 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 | Nonreturn "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.mdindex 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 Praxistenvironment can import `openai_codex` and `mcp`, and verify distributionversions `openai-codex==0.147.0` and `claude-agent-sdk==0.2.136`. Fordiff --git a/skills/praxist-onboarding/SKILL.md b/skills/praxist-onboarding/SKILL.mdindex 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`, thendiff --git a/skills/praxist-runtime-install/SKILL.md b/skills/praxist-runtime-install/SKILL.mdindex 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.shindex 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.pyindex 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.pyindex 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.txtindex 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_LEVELpraxist/plugins/workflow_stages/research_loop/stage.py::CLAUDE_CODE_SUBAGENT_MODELpraxist/plugins/workflow_stages/research_loop/stage.py::DEEPSEEK_ANTHROPIC_BASE_URLpraxist/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_KEYpraxist/plugins/workflow_stages/research_loop/stage.py::OPENAI_API_KEYpraxist/plugins/workflow_stages/research_loop/stage.py::OPENROUTER_API_KEYpraxist/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_KEYpraxist/plugins/workflow_stages/research_loop/startup.py::DEEPSEEK_API_KEYpraxist/plugins/workflow_stages/research_loop/startup.py::OPENROUTER_API_KEY+praxist/plugins/workflow_stages/research_loop/startup.py::ORCAROUTER_API_KEYpraxist/plugins/workflow_stages/research_loop/startup.py::PATHdiff --git a/tests/hardening/test_refactor_hardening.py b/tests/hardening/test_refactor_hardening.pyindex 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.pyindex 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.pyindex 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 startfrom 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.pyindex 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.pyindex 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 Pathfrom typing import Anyfrom unittest.mock import patch+from praxist.core.cloudflare import workers_ai_base_urlfrom 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.pyindex 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.pyindex 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.pyindex 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"})