feat(llm): add Poolside Laguna models

[brynary]

Summary

• add Poolside as a built-in OpenAI-compatible provider with Laguna S 2.1 and Laguna XS 2.1
• add both Laguna models to the opt-in OpenRouter catalog with current capabilities, limits, and rates
• register Poolside credentials for standalone and vault-backed use, plus API-key redaction
• avoid sending unsupported low, medium, or high reasoning effort to reasoning models that only expose on or off behavior
• add catalog, routing, credential, redaction, live integration, and documentation coverage

Validation

• cargo +nightly-2026-04-14 fmt --check --all
• cargo +nightly-2026-04-14 clippy --workspace --all-targets -- -D warnings
• cargo build --workspace
• cargo nextest run --workspace: 7004 passed
• focused fabro-model, fabro-static, fabro-redact, and fabro-llm suites: 823 passed
• direct Poolside Laguna XS deep tool-use test against the live API
• staged Gitleaks scan: no leaks found

The OpenRouter Laguna live test is included for credentialed E2E runs; this local validation used the direct Poolside credential only.

[Copilot]

Pull request overview

Adds Poolside Laguna models as a first-class built-in OpenAI-compatible provider and exposes the same models via the opt-in OpenRouter catalog, including credential + redaction support and integration/documentation coverage.

Changes:

• Introduces the built-in poolside provider with Laguna S 2.1 / Laguna XS 2.1 and wires them into catalog routing + install/provider discovery.
• Adds Poolside Laguna models to the OpenRouter catalog (vendor-namespaced IDs) and ensures reasoning-effort controls are omitted where unsupported.
• Registers POOLSIDE_API_KEY across env/vault secret registries, example env config, redaction rules, docs, and adds live integration tests.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
lib/crates/fabro-static/src/secret_registry.rs	Adds POOLSIDE_API_KEY to the optional vault secret registry (and tests).
lib/crates/fabro-static/src/env_vars.rs	Defines EnvVars::POOLSIDE_API_KEY and includes it in env var enumeration tests.
lib/crates/fabro-redact/src/gitleaks.rs	Adds a unit test ensuring Poolside API keys are detected for redaction.
lib/crates/fabro-redact/data/gitleaks.toml	Adds a new gitleaks rule for Poolside API key detection.
lib/crates/fabro-model/src/catalog/providers/poolside.toml	Adds a new built-in Poolside provider definition and Laguna model rows.
lib/crates/fabro-model/src/catalog/providers/openrouter.toml	Adds OpenRouter catalog entries for Poolside Laguna models with current limits/costs.
lib/crates/fabro-model/src/catalog.rs	Adds catalog tests validating Poolside provider routing and OpenRouter inclusion when enabled.
lib/crates/fabro-llm/tests/integration.rs	Adds live E2E coverage for direct Poolside Laguna XS and OpenRouter Laguna XS.
lib/crates/fabro-llm/src/model_test.rs	Avoids sending reasoning-effort to models that don’t support effort controls; adds unit tests.
lib/crates/fabro-llm/src/adapter_registry.rs	Extends the route-equivalence table to include Laguna S / XS built-in routes.
lib/crates/fabro-cli/src/commands/install.rs	Ensures install-time provider discovery includes the new poolside provider.
docs/public/reference/sdk.mdx	Documents POOLSIDE_API_KEY (and OpenRouter env key behavior) for SDK env-backed credentials.
docs/public/integrations/poolside.mdx	Adds new Poolside integration documentation (direct + via OpenRouter).
docs/public/integrations/openrouter.mdx	Lists Poolside Laguna models as part of the curated OpenRouter built-in catalog.
docs/public/docs.json	Adds the Poolside integration page to docs navigation.
docs/public/core-concepts/models.mdx	Documents Poolside models in the catalog overview and default-provider table.
docs/public/administration/server-configuration.mdx	Documents POOLSIDE_API_KEY and OPENROUTER_API_KEY in server configuration guidance.
.env.example	Adds OPENROUTER_API_KEY and POOLSIDE_API_KEY to example environment configuration.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.