Files

T

Frank 38bf9c4897 docs: record omp subagent fan-out caps and per-endpoint in-flight ceilings

Codifies the limits set in agent/config.yml 2026-10-19: task concurrency 2,
no nested subagent spawns (maxRecursionDepth 1 - and why 0 must never be
set), 30-min runtime / 120-request budgets, isolation opt-in enabled,
completion probes off, 600s tool timeout ceiling, and per-provider
in-flight caps (archon 3, dragoon 2, zealot 3) keyed by models.yml provider
ids with their per-machine scope caveat. Small docs-only change; no issue
opened per trunk-based small-fix exemption.

2026-10-19 00:22:17 -07:00

3.4 KiB

Raw Permalink Blame History

Pi Configuration

Archive note (2026-10-18). Most pages in this directory document the retired pi harness (settings.json / models.json, frank-default-* endpoints, verified 2026-08-28). The live harness is omp — its config is agent/config.yml + agent/models.yml in this repo, the current fleet endpoints are on System hosts, and omp-specific knowledge lands in pages like OMP Status Line Customization below. Read pi pages as historical records, not current state.

Configuration Files

Pi Settings System (settings.json) — Main settings.json reference. Providers, models, packages, subagent overrides.
Pi Models Configuration — models.json reference. Provider definitions, model specs, endpoints.
OMP Status Line Customization — How presets, composer shapes, and segment arrays actually interact; the fleet's tuned bar.

Extensions

Pi Packages — Installed npm packages that extend pi functionality.
- Pi Peon — CESP/OpenPeon sound-pack player for lifecycle events.
- Pi Web Access — Web search, URL fetching, GitHub cloning, PDF extraction, video understanding.
- Pi Browser Use — Browser automation extension wrapping chrome-devtools-mcp with a browser_ prefix.
- Pi Permission System — Permission enforcement and policy configuration for subagent extensions.

Skills

Pi Skills — Installed agent skills. Symlinked from ~/.agents/skills/ and ~/.pi/agent/skills/.

Subagent Architecture

OMP Subagent Limits & Fan-out Policy — Live caps: concurrency 2, no nested spawns (and the maxRecursionDepth: 0 trap), per-endpoint in-flight ceilings, isolation policy.
Pi Subagents — (historical) pi-era delegation system. Chains, parallel execution, TUI clarification.

Architecture

graph TD
    A[Pi TUI] --> B[settings.json]
    A --> C[models.json]
    B --> D[Default Provider: llamacpp]
    B --> E[Default Model: frank-default-large]
    B --> F[Packages]
    B --> G[Subagent Overrides: local frank models]
    F --> H[pi-peon]
    F --> I[pi-web-access]
    F --> J[pi-browser-use]
    F --> K[pi-permission-system]
    G --> L[Small: scout, researcher]
    G --> M[Large: planner, worker, reviewer, oracle, context-builder]
    L --> N[dankserver 192.168.0.235:7770]
    M --> O[dankclaw 192.168.0.143:7770]

Note on the Live Default

In the pi era, models.json defined the live provider set: the main session provider was llamacpp with default model frank-default-large (Dankclaw); subagents defaulted to frank-default-small (Dankserver); larger roles mapped to frank-default-large. Two scopes owned settings: the user ~/.pi/settings.json (main → Dankclaw/large) and the project /home/dank/.pi/agent/settings.json (main → Dankserver/small); when they disagreed, the project-scope file won for the agent's own main session.

Note: This documentation describes the pi-coding-agent harness (config format, packages, skill system) as general reference material. The live harness is OMP at ~/.omp/; OMP-managed skills live in ~/.omp/agent/managed-skills/.

3.4 KiB Raw Permalink Blame History