feat(providers): add Apertis preset

[theQuert]

Summary

• Add Apertis as a canonical API-key provider with the existing OpenAI Chat adapter.
• Discover its key-scoped model catalog at /v1/models and retain same-named custom provider configurations.
• Surface the preset in the GUI catalog and synchronize provider documentation across all locales.

Rebased onto upstream/dev at e1fc0f21c on 2026-08-01. The catalog now has 66 presets: 55 key-based, seven OAuth, three local, and one forward preset.

Canonical-preset evidence

Requirement	Primary source	Verification
OpenAI-compatible Chat Completions endpoint, base URL, and Bearer API-key use	Apertis Chat Completion documentation	Checked 2026-07-31
Authenticated GET /v1/models contract and the key-scoped OpenAI-shaped model list	Apertis Models documentation	Checked 2026-07-31
Terms and operating legal entity	Apertis Terms of Service; the Apertis docs footer identifies STIMA AI LLC	Checked 2026-07-31
Resale or routing authorization	Apertis is an aggregator. Its public product page states that it uses paid multi-provider routes and does not reuse consumer subscription OAuth. The underlying provider-specific contractual evidence is non-public; it must be supplied through a maintainer-designated private channel. This PR makes no claim that the evidence has been verified.	Pending confidential maintainer verification, 2026-08-01
Maintenance owner	@theQuert; report breakage through this repository's issue/PR workflow and tag the owner. The owner will update or demote the preset if its endpoint, auth, or catalog contract changes.	2026-07-31

Contributor affiliation: @theQuert submits this contribution on behalf of Apertis / STIMA AI LLC.

Safety and scope

• Reuses the existing openai-chat adapter; no new auth flow or provider credential is added.
• Live discovery uses existing global safety bounds; fixture-only tests never contact Apertis.
• The fixed API-key preset preserves a same-named custom provider with a different adapter or destination.
• No static model, reasoning, or modality metadata is asserted for Apertis.

Verification

• bun test tests/apertis-provider.test.ts tests/provider-registry-parity.test.ts tests/provider-model-discovery-contract.test.ts — 56 passed
• bun run typecheck
• bun run privacy:scan
• bun run test — passed locally on the rebased head
• cd gui && bun test tests — 463 passed
• cd gui && bunx --bun eslint .
• cd gui && bun run build
• cd docs-site && bun install --frozen-lockfile && bun run build — 146 pages
• git diff --check upstream/dev...HEAD

bun run lint invokes the system Node ESLint launcher here, which cannot load the existing TypeScript config (.eslint/i18n-file-groups.ts); the same rules passed under Bun via bunx --bun eslint ..

Checklist

• Scope stays focused on the provider preset and its documentation.
• Documentation and fixture-based tests cover the new provider contract.
• Security-sensitive behavior was reviewed for secrets and unsafe defaults; explicit maintainer security review and confidential routing/resale-evidence verification remain required before merge.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 589d8d9e-2bd2-497a-8259-42ce24c84bc7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}

[Ingwannu]

The preset itself is potentially valuable and the implementation gets several important details right: fixed Bearer-authenticated /v1/models, openai-chat, liveModels, and preserveCustomDestination all match the intended registry contract. It is not mergeable yet for two concrete reasons:

1. This branch is stale against current dev. The docs change the catalog total to 61, while current dev already has 65 presets (54 key-based); Apertis would make that 66/55. The branch also conflicts in all five provider docs, registry.ts, the icon table, and registry parity because newer presets such as DeepInfra, Hyperbolic, and Volcengine landed after its base. Please rebase onto current dev, preserve every existing entry, and regenerate the counts/parity expectation.
2. A canonical aggregator preset is a credential-destination change. The PR explicitly says provider-specific routing/resale authorization is non-public. The public product-page claim is not enough to independently verify the policy requirement. Please provide the contractual authorization confidentially to the project owner/maintainers and record only the maintainer verification outcome/date in the PR; do not post confidential terms or credentials here. If that evidence cannot be shared, the acceptable fallback is an inert free-directory row rather than a canonical registry entry.

Keep this draft until both points are resolved. After the rebase, rerun the focused provider/parity/discovery suite and the full cross-platform CI.

[theQuert]

Rebased and pushed this PR onto current dev at e1fc0f21c.

• Preserved the current DeepInfra, Hyperbolic, Volcengine, and other registry entries.
• Regenerated the catalog documentation and parity expectation from the registry: 66 presets total, 55 key-based.
• Reran the focused provider/parity/discovery suite (56 passed), full bun run test, typecheck, privacy scan, GUI tests (463 passed), Bun-based GUI ESLint, GUI build, and docs build (146 pages).

This remains a draft. I will not post non-public contractual terms or credentials in the PR, and I have not marked the routing/resale requirement as verified. The underlying authorization needs to be supplied by an Apertis representative through a maintainer-designated private channel; please advise the preferred secure route. Once a maintainer confirms the review, I will record only the verification outcome and date here.

bun run lint is still blocked in this environment because its Node ESLint launcher cannot load the repository's existing .eslint/i18n-file-groups.ts; the same rules pass via bunx --bun eslint ..

[lidge-jun]

Maintainer triage update: the rebase concern is resolved, and the preset shape—including model discovery and localized documentation—looks useful.

The remaining blocker is the provider-preset evidence bar for a credential-destination change under MAINTAINERS.md and the contributing guide. Please ensure the PR body contains citable evidence for:

• the documented OpenAI-compatible endpoints;
• the applicable terms of service and operating legal entity;
• because Apertis acts as a routing/aggregator service, the resale/routing authorization;
• a named maintenance owner; and
• a citable verification date.

Once that evidence is complete, this can proceed to security approval. If any contractual details are confidential, they may be shared privately with the maintainers; the public PR body can record the resulting verification outcome and date without exposing confidential terms.

[theQuert]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a01fafb0d0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Keep Apertis out of the canonical registry until verified

The commit's evidence table explicitly marks the aggregator's resale/routing authorization as pending, but this canonical entry immediately exposes Apertis through CLI/dashboard presets and sends users' API keys and traffic to it. MAINTAINERS.md requires that authorization before merging an aggregator preset and directs incomplete entries to the inert src/providers/free-directory.ts; move Apertis there until a maintainer verifies the confidential evidence and completes the required security review.

AGENTS.md reference: AGENTS.md:L150-L154

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Preserve editing for same-named custom Apertis providers

When an existing configuration already has a custom provider named apertis, preserveCustomDestination correctly keeps its custom transport at runtime, but adding this display-name entry also inserts the ID into CATALOG_PROVIDER_IDS. ProviderSettings.tsx then determines isPreset solely from that name and disables the adapter, base URL, and authentication controls, so the dashboard can no longer edit the custom configuration this change explicitly promises to preserve. Determine canonicality by matching the configured transport to the preset, or expose the server-side transport-match result instead of classifying by ID alone.

AGENTS.md reference: gui/AGENTS.md:L7-L10

Useful? React with 👍 / 👎.