Add experimental Pi harness groundwork

[woltspace-jerpint]

Summary

• add Pi 0.87.1 as an experimental harness with Woltspace-owned session UUIDs
• add the wpi wrapper for per-wolt config/auth/session isolation and Agent Skills discovery
• add OpenRouter-only model validation, doctor coverage, container packaging, and focused tests
• record the complete disposable provider, resume, skill, notify, interactive TUI, IWCL, and multi-model evaluation

Important distribution caveat

Pi is a Node CLI distributed as @earendil-works/pi-coding-agent. The candidate container installs it with npm into /opt/pi, then combines it with Python and the Woltspace control CLI.

A plain Python-only uv tool install woltspace does not install Pi or provide Node/npm. Native one-line distribution remains unresolved and is explicitly documented. This draft must not be presented as seamless native installation yet.

Evidence completed

• Minimal Sonnet 5 provider call returned exact requested output; $0.001328
• Caller-owned UUID created and resumed from a fresh container; $0.00268 combined
• Real boot/notify skills produced two Slack notifications; $0.0363831
• Interactive PTY accepted outbound and inbound IWCL-shaped prompts; $0.0521424
• DeepSeek V4 Pro, DeepSeek V4.1 Flash, and GLM 5.3 Flash completed the same Pi/IWCL task
• MiMo V2.6 Pro exposed an exact-once failure: mismatched heredoc delimiters followed by duplicate delivery
• Every disposable auth.json remained mode 0600 and exactly {}; no credential marker persisted
• All disposable containers, images, wolt homes, and session data removed
• Complete evidence recorded in docs/pi-evaluation-2026-09-25.md

Required before this leaves draft / merges

• Run one Woltspace-managed disposable E2E through the real supervisor: registry entry → tmux launch → browser TUI attach → boot skill → response → stop → exact UUID resume
• Add a fail-fast native preflight when pi is missing, including the Node ≥22.19 requirement and exact pinned npm install command
• Make native Pi state isolation explicit and tested: preferably per-wolt config/session roots with deliberate shared-auth seeding, rather than silently inheriting one global Pi home
• Add a concise native Pi/OpenRouter setup guide and verify it from a clean disposable home
• Update stale source comments that still call the already-proven PTY command shape “offline only” or “unverified”
• Re-run focused tests, artifact payload checks, clean-home proof, and independent diff review at the final head

Required for someone to use it after merge

• Publish a reviewed Woltspace release, or document an explicit candidate-wheel/install-from-main path; merging alone does not update installed 0.5.7 lodges
• User installs Node ≥22.19 and @earendil-works/pi-coding-agent@0.87.1 until Woltspace owns that dependency lifecycle
• User stores OPENROUTER_API_KEY in the existing private lodge environment
• UI/API shows and validates the effective Pi + openrouter/... model pair

Safe follow-ups after experimental opt-in support

• Automatic npm dependency installation or another one-line distribution strategy
• Pi RPC/SDK integration
• Broader reviewed Pi model catalog and tier defaults
• Harness-neutral Woltspace conformance runner using the MiMo duplicate as an initial regression fixture
• Adapter-native progress and richer Stop semantics

Verification at current head

• 18 Pi-selected tests pass
• broader focused files: 115 pass, 2 known pre-existing environment-coupled failures caused by this lodge's Codex default leaking into tests that expect Claude
• bash -n container/bin/wpi
• git diff --check
• wheel and sdist both contain container/bin/wpi
• all commits verified with woltspace-jerpint[bot] author and committer
• GitHub Python 3.11/3.13, packages, Vercel, and Vercel Preview Comments pass

See docs/pi-evaluation-2026-09-25.md and docs/pi-harness-roadmap.md.

No merge, release, live-lodge install, restart, or deployment is implied by this draft.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
woltspace	Ready	Preview	Sep 25, 2026 4:51am UTC