Files
command-center/omp-docs/core/index.md
T
Frank f3360a28f1 feat(models): reach the fleet from off-network through the OpenWebUI door
Every provider in agent/models.yml is a LAN address, so a workstation that
leaves the house has no model at all. Add `openwebui (franksdank.cloud)`:
the already-public OpenWebUI vhost as an OpenAI-compatible provider that
proxies the same engines, with frank-dragoon and frank-zealot rows and the
WAN row as its own compaction target. LAN rows, modelRoles and the speech
runner stay untouched — the door is purely additive.

The key is command-backed (`apiKey: "!cat ~/.config/secrets/openwebui_api_key"`,
mode 600) instead of inline: a literal sk-... in a tracked file is a key in
every agent context on every box that pulls this repo, and the pre-commit
shape gate would block it anyway. Rotate = rewrite the file + restart omp,
because a `!cmd` value is cached for the process lifetime.

Compat blocks copy their LAN twins because the proxy was probed, not assumed
(2026-10-21): streaming SSE carries reasoning_content and tool_calls deltas
plus final usage, image_url content parts reach both vision towers, and
chat_template_kwargs is forwarded — proven on frank-zealot, where
enable_thinking false yields zero reasoning and true a real block.
frank-archon gets no WAN row: OpenWebUI answers 400 "Model not found"
because its picker never published it, so that path is a fleet change.

Verified end-to-end from a scratch HOME whose LAN baseUrls point at a dead
port, so any answer can only have come through the door (text and a real
tool round-trip); `omp models` still lists all four chat providers and the
tts runner, so the file validates. bats 137/137, kb-lint clean.
Docs: omp-docs/core/wan-model-access.md.
2026-10-21 16:48:29 -07:00

1.8 KiB

Core Documentation

These files define the structural conventions that govern the agent system itself. They are the grammar rules — boring until you break them, then devastating.

Archive note (2026-10-18). The settings pages (settings.md, settings.json) capture the retired pi harness configuration (frank-default-* endpoints, RTX 3090-era hardware) and are historical records. The live config is agent/config.yml + agent/models.yml in this repo; current fleet endpoints are on System hosts. The AGENTS.md format pages remain current.

Concept Files

  • AGENTS.md Format Specification — Canonical structure and conventions for the system-level instruction file that governs agent behavior.
  • Pi Settings System — pi-era settings.json record (archive): providers, models, packages, subagent overrides.
  • dankvoice — Voice output is the dank/dankvoice package (pi install git:); this page keeps fleet wiring and the cutover procedure.
  • OMP Status Line Customization — How presets, composer shapes, and segment arrays actually interact; the fleet's tuned bar. (moved from /pi/, 2026-10-19)
  • OMP Subagent Limits & Fan-out Policy — Live caps: concurrency 2, no nested spawns (the maxRecursionDepth: 0 trap), per-endpoint in-flight ceilings, isolation policy. (moved from /pi/, 2026-10-19)
  • WAN Model Access — Driving the fleet's models from outside the home network through the OpenWebUI door: the command, the key file and its rotation law, what the door publishes, and the off-network failure modes.

Change log: the bundle keeps exactly one, one level up — Bundle Change Log. A directory here never has its own.