Frank
206c9acb46
Refs #83 The first vendor-cloud chat row in agent/models.yml. The provider label is the bare word `deepseek` because pi-catalog/src/hosts.ts keys the direct-DeepSeek behaviour set (max_tokens field, thinking extraBody, thinking-disable mode) off that exact name and off api.deepseek.com; the house `<api> (<host>)` pattern would not match and the row would lose the quirks the endpoint answers to. The key is command-backed (`!cat ~/.config/secrets/deepseek_api_key`, 600), so no sk-… value enters the tracked tree, and the row declares the model card's own pair: contextWindow 1048576 / maxTokens 262144, input [text, image], with the October 2026 peak rate card in cost. Docs move to the new omp-docs/core/deepseek-provider.md, indexed and logged in the same commit.
2.2 KiB
2.2 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 isagent/config.yml+agent/models.ymlin 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.jsonrecord (archive): providers, models, packages, subagent overrides. - dankvoice — Voice output is the
dank/dankvoicepackage (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: 0trap), 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.
- DeepSeek Platform Provider — The first vendor-cloud row in
agent/models.yml: why its label is the bare worddeepseek, the key file, and the window/maxTokens/cost values it declares. - OMP Snapcompact — Bitmap-Frame Compaction — What shape frank-archon actually reads, the measured recall/billing table, the
imageCountBudgetknob and the pricing that isn't, and the 85 % trigger law.
Change log: the bundle keeps exactly one, one level up — Bundle Change Log. A directory here never has its own.