Files
stack/agents/researcher

Researcher

Repository-native technical research seat, coordinated by Sage. Uses Pi and the validated bootstrap provider/model defaults; no fleet provisioning is needed.

From /mnt/storage/src/mosaic-stack:

agents/researcher/launch.sh --check
agents/researcher/launch.sh
agents/researcher/launch.sh --fresh

--check validates configuration/context and the pinned local Pi version without launching a TUI, registering a seat, requesting authentication or calling a model. Normal launch registers the repository seat through scripts/mosaic, then uses the existing host-development helper. It resumes validated per-agent conversation state under .pi/state/researcher; --fresh starts another conversation without deleting history. Existing launcher locking prevents duplicate native instances.

This is the same explicit native mode as Darkwing/Dewey/Filbert, not a fallback from a container policy refusal. The retained agent.json describes the separate managed-mode definition; no managed role or capability policy is changed here.

Bootstrap configuration remains authoritative. Missing config, context or pinned dependencies fails closed. No configuration or credentials are copied from a fleet seat. No files under ~/.mosaic are modified by this source setup. Use the existing bootstrap/build workflow documented in the repository, rather than installing an unversioned engine or modifying a home-directory launcher.

No engine was launched to verify this source change. Offline launcher tests use a fake Pi and isolated registration/session directories. Live startup and external provider authentication are separate observations, not implied by passing tests.