The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Honor experimental flags in Store and fix Devices agent switching (#599)
Deee57ca644d140
diff --git a/desktop/design/desktop-ui-migration.md b/desktop/design/desktop-ui-migration.mdindex dcb352b3b..0cd4624d4 100644--- a/desktop/design/desktop-ui-migration.md+++ b/desktop/design/desktop-ui-migration.md@@ -648,3 +648,20 @@ unmerged.remains unverified. macOS per-process GPU and restricted driver counters display —. Token totalsand breakdowns currently come from Claude, Codex and OpenCode ledgers; other engines show missingmetrics explicitly. See the Harness Monitor README for definitions and research references.++### Experimental Store workspaces, 2026-10-02++- Devices and Companions now appear in Store discovery, categories and search only after the+ current account enables their respective experiments. Live disabling, account changes and+ server availability remove them, including open product pages and stale actions. This+ supersedes the earlier unconditional Store hiding; the public daemon catalog stays unchanged.+- Their Open action reuses the existing workspace without offering package installation,+ updates or removal. Companions reserves the 70/30 viewer/chat layout while its collection or+ conversation is unavailable, then attaches the ordinary terminal in the same slot.+- **201 targeted tests** and changed-file analysis passed. Synthetic real-font renders were+ inspected for [Devices](../../docs/research/2026-10-02-experimental-store/devices-dark.png)+ and [Companions](../../docs/research/2026-10-02-experimental-store/companions-dark.png), plus+ [Devices at 200% text](../../docs/research/2026-10-02-experimental-store/devices-light-large-text.png)+ and [Companions at 200% text](../../docs/research/2026-10-02-experimental-store/companions-light-large-text.png)+ in a narrow light window. These widget renders do not establish native VoiceOver or physical+ IME behavior. The installed desktop app was not replaced.diff --git a/desktop/lib/devices/devices_harness_controller.dart b/desktop/lib/devices/devices_harness_controller.dartindex 2dcbc50a9..f929ff5b3 100644--- a/desktop/lib/devices/devices_harness_controller.dart+++ b/desktop/lib/devices/devices_harness_controller.dart@@ -106,7 +106,8 @@ class DevicesHarnessController extends ChangeNotifier {if (!_current(owner)) return;if (failure != null) {// This package ships with the CLI and is deliberately absent from- // dsh_list/the Store. A missing bundle requires a Harness update,+ // dsh_list. The Store exposes it through the account's experiment.+ // A missing bundle requires a Harness update,// not a Store install or a raw INVALID_DSH message in the dashboard.error = switch (_creation!.refusal) {'INVALID_DSH' || 'UNSUPPORTED' || 'UNSUPPORTED_ON_REMOTE' => 'Update Harness on this computer to use Devices chat, then try again.',diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dartindex a7790584c..b6e5d69ee 100644--- a/desktop/lib/screens/swarm_screen.dart+++ b/desktop/lib/screens/swarm_screen.dart@@ -315,6 +315,7 @@ class _SwarmScreenState extends State<SwarmScreen> {bool get _creatureChoice =>ExperimentalFeature.focusBarCreature.available &&app.viewer == null &&+ _experimentalFeatures.isAvailable(ExperimentalFeature.focusBarCreature) &&_experimentalFeatures.enabled(ExperimentalFeature.focusBarCreature);late final _brain = DaemonBrain(send: _sendDaemonFrame,@@ -3992,7 +3993,7 @@ class _SwarmScreenState extends State<SwarmScreen> {}void _syncCompanionWorkspace() {- final enabled = _creatureEnabled && _zoo.loaded;+ final enabled = _creatureEnabled;app.syncCompanionViewer(enabled: enabled,machineId: app.localMachineState?.machine.machineId,@@ -4001,6 +4002,10 @@ class _SwarmScreenState extends State<SwarmScreen> {_companionAttemptedKey = null;return;}+ if (!_zoo.loaded) {+ unawaited(app.showCompanionTerminal(null, null));+ return;+ }final pair = _zoo.isPreview ? null : _pairHarness;unawaited(app.showCompanionTerminal(pair?.machineId, pair?.agentId));if (!app.activeSwarm.isCompanions) {@@ -4083,29 +4088,53 @@ class _SwarmScreenState extends State<SwarmScreen> {return result;}- Widget _companionViewer(BuildContext context) => CompanionHome(- key: ValueKey('companion-home:${_zoo.scope}'),- face: _face,- brain: _brain,- openMemoryConnection: _zoo.isPreview- ? null- : app.openCodingMemoryConnection,- onHatch: _hatch,- onOpenControls: _openCompanionControls,- terminalStatus:+ Widget _companionViewer(BuildContext context) => !_zoo.loaded+ ? const Center(child: Text('Opening your collection…'))+ : CompanionHome(+ key: ValueKey('companion-home:${_zoo.scope}'),+ face: _face,+ brain: _brain,+ openMemoryConnection: _zoo.isPreview+ ? null+ : app.openCodingMemoryConnection,+ onHatch: _hatch,+ onOpenControls: _openCompanionControls,+ terminalStatus:+ _companionTerminalError ??+ (_companionOpeningKey != null+ ? 'Opening your companion’s terminal…'+ : null),+ onOpenConversation: _companionTerminalError == null+ ? null+ : () {+ _companionAttemptedKey = null;+ _focusCompanionTerminal = true;+ _scheduleCompanionWorkspace();+ },+ dial: app.dial,+ onDeviceSettings: app.setDeviceSettings,+ );++ Widget _companionConversation(+ BuildContext context,+ ) => HarnessConversationPlaceholder(+ key: const ValueKey('companion-conversation-setup'),+ name: 'Companion',+ opening:+ _companionOpeningKey != null ||+ (!_zoo.loaded && _zoo.daemons == DaemonsSwitch.unknown),+ error:_companionTerminalError ??- (_companionOpeningKey != null- ? 'Opening your companion’s terminal…'- : null),- onOpenConversation: _companionTerminalError == null- ? null- : () {- _companionAttemptedKey = null;- _focusCompanionTerminal = true;- _scheduleCompanionWorkspace();- },- dial: app.dial,- onDeviceSettings: app.setDeviceSettings,+ (!_zoo.loaded+ ? 'Your collection could not connect. Try again.'+ : _zoo.paired == null+ ? 'Hatch and pair a companion in your collection to start chatting.'+ : 'Connect Harness on this computer and choose an agent for your companion.'),+ onRetry: () {+ if (!_zoo.loaded) _zoo.refresh();+ _companionAttemptedKey = null;+ _scheduleCompanionWorkspace();+ },);/// `~/.config/harness/pair.jsonc`, written with no rules when it is not@@ -6766,13 +6795,13 @@ class _SwarmScreenState extends State<SwarmScreen> {offstage:app.activeSwarm.isStore ||(app.activeSwarm.isCompanions &&- (!_creatureEnabled || !_zoo.loaded)) ||+ !_creatureEnabled) ||app.activeSwarm.isOrchestrator,child: ExcludeFocus(excluding:app.activeSwarm.isStore ||(app.activeSwarm.isCompanions &&- (!_creatureEnabled || !_zoo.loaded)) ||+ !_creatureEnabled) ||app.activeSwarm.isOrchestrator,child: Padding(padding: app.panes.isEmpty@@ -6815,11 +6844,13 @@ class _SwarmScreenState extends State<SwarmScreen> {app.devicesEnabled? _devicesConversation: null,- companionViewer:- _creatureEnabled &&- _zoo.loaded+ companionViewer: _creatureEnabled? _companionViewer: null,+ companionConversation:+ _creatureEnabled+ ? _companionConversation+ : null,soloFocused: _compact(context),empty:app.panes.isEmpty &&@@ -6935,14 +6966,10 @@ class _SwarmScreenState extends State<SwarmScreen> {recentHarnesses: _navigation.recent,source: 'tab',),- if (app.activeSwarm.isCompanions &&- (!_creatureEnabled || !_zoo.loaded))- Center(+ if (app.activeSwarm.isCompanions && !_creatureEnabled)+ const Center(child: Text(- _creatureEnabled &&- _zoo.daemons == DaemonsSwitch.unknown- ? 'Opening your collection…'- : 'Companions is available in Settings → Experimental.',+ 'Companions is available in Settings → Experimental.',),),if (_hasCommandBar && _commandBarOpen)diff --git a/desktop/lib/settings/experimental_features.dart b/desktop/lib/settings/experimental_features.dartindex b5f79dd1b..51347d853 100644--- a/desktop/lib/settings/experimental_features.dart+++ b/desktop/lib/settings/experimental_features.dart@@ -9,7 +9,7 @@ enum ExperimentalFeature {focusBarCreature('focus_bar_creature','Focus-bar creature',- 'Start with an egg in the focus bar. Your collection and progress are saved to your account.',+ 'Start with an egg in the focus bar and find Companions in Harness Store. Your collection and progress are saved to your account.',),shareButton('share_button',@@ -19,7 +19,7 @@ enum ExperimentalFeature {devicesTab('devices_tab','Devices tab',- 'Manage your Harness devices. Show Devices next to Harness Store. Off by default.',+ 'Manage your Harness devices. Show Devices next to Harness Store and in its catalog. Off by default.',);const ExperimentalFeature(this.id, this.label, this.description);diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dartindex 6ea518a28..44b34915b 100644--- a/desktop/lib/state/app_state.dart+++ b/desktop/lib/state/app_state.dart@@ -1748,6 +1748,16 @@ class AppNotifier extends ChangeNotifier {tab.focusedPaneId ??= viewer.id;changed = true;}+ if (enabled) {+ if (!tab.panes.any((pane) => !pane.isViewer)) {+ tab.panes.add(TerminalPane(id: _nextPaneId++, machineId: ''));+ changed = true;+ }+ tab.paneSizes.putIfAbsent(+ '2:manual',+ () => PaneArrangement.viewerBesideTerminal,+ );+ }}if (changed) notifyListeners();}@@ -1767,6 +1777,7 @@ class AppNotifier extends ChangeNotifier {viewer.ownerAgentId = agentId;viewer.machineId = machineId ?? '';for (final pane in tab.panes.where((p) => !p.isCompanion).toList()) {+ if (pane.agentId == null) continue;if (pane.machineId == machineId && pane.agentId == agentId) continue;tab.remove(pane);if (!allPanes.contains(pane)) {@@ -1774,6 +1785,10 @@ class AppNotifier extends ChangeNotifier {}changed = true;}+ if (!tab.panes.any((pane) => !pane.isViewer)) {+ tab.panes.add(TerminalPane(id: _nextPaneId++, machineId: ''));+ changed = true;+ }if (changed) notifyListeners();if (machineId == null || agentId == null) return;// Keep the product's name and its standard viewer-left/terminal-right split.@@ -1781,7 +1796,10 @@ class AppNotifier extends ChangeNotifier {tab.savePaneSizes('2:manual', PaneArrangement.viewerBesideTerminal);}await assignAgentToPane(- null,+ tab.panes+ .where((pane) => !pane.isViewer && pane.agentId == null)+ .firstOrNull+ ?.id,machineId,agentId,swarmId: tab.id,@@ -11067,10 +11085,15 @@ class AppNotifier extends ChangeNotifier {if (source.dsh == 'autonomous/pair') {return const ['opencode', 'codex', 'claude'];}+ // Devices ships with the portable runtime but is deliberately omitted+ // from dsh_list. Its absence from the public catalog does not restrict+ // an existing Devices conversation to the engine it started with.final supported = source.dsh == null? allEngines.map((engine) => engine.id).toList(): stateOf(machineId)?.dsh[source.dsh!]?.supportedEngines ??- [source.engine ?? ''];+ (source.dsh == 'autonomous/devices'+ ? allEngines.map((engine) => engine.id).toList()+ : [source.engine ?? '']);return [if (supported.contains('opencode')) 'opencode',...supported.where((id) => id != 'opencode'),diff --git a/desktop/lib/state/swarm_search.dart b/desktop/lib/state/swarm_search.dartindex 59728958a..00096195f 100644--- a/desktop/lib/state/swarm_search.dart+++ b/desktop/lib/state/swarm_search.dart@@ -10,6 +10,7 @@ import '../models/api_connections_controller.dart'import '../models/local_model.dart';import '../models/model_search_catalog.dart';import '../core/dsh_catalog.dart';+import '../store/experimental_harnesses.dart';import '../core/machine_resources.dart';import '../core/models.dart'show Agent, ConnectionStatus, GridModels, GridModel;@@ -90,6 +91,7 @@ class SwarmSearchController extends ChangeNotifier {}_refresh();app.addListener(_refresh);+ app.experimentalFeatures.addListener(_refresh);projects?.addListener(_refresh);models?.addListener(_modelsChanged);app.gridPictures.addListener(_modelChoicesChanged);@@ -1502,9 +1504,11 @@ class SwarmSearchController extends ChangeNotifier {bool _refreshStore() {final entries = {- for (final machine in app.machineStates.values)- for (final entry in machine.dsh.byId.values)- if (!entry.isViewerPackage) entry.id: entry,+ for (final entry in storeVisibleHarnesses(+ app.machineStates.values.expand((machine) => machine.dsh.byId.values),+ app.experimentalFeatures,+ ))+ if (!entry.isViewerPackage) entry.id: entry,};if (mapEquals(entries, _storeEntries)) return false;_storeEntries = entries;@@ -2322,6 +2326,7 @@ class SwarmSearchController extends ChangeNotifier {_modelUseTimer?.cancel();if (_modelUseWait?.isCompleted == false) _modelUseWait!.complete();app.removeListener(_refresh);+ app.experimentalFeatures.removeListener(_refresh);projects?.removeListener(_refresh);models?.removeListener(_modelsChanged);app.gridPictures.removeListener(_modelChoicesChanged);diff --git a/desktop/lib/store/experimental_harnesses.dart b/desktop/lib/store/experimental_harnesses.dartnew file mode 100644index 000000000..63b58e45a--- /dev/null+++ b/desktop/lib/store/experimental_harnesses.dart@@ -0,0 +1,58 @@+import '../core/dsh_catalog.dart';+import '../settings/experimental_features.dart';++/// App workspaces are bundled with Harness, not installed from the registry.+/// Their Store presence follows the current account's confirmed experiment.+enum ExperimentalStoreHarness {+ devices(+ ExperimentalFeature.devicesTab,+ DshEntry(+ id: 'autonomous/devices',+ name: 'Devices',+ engine: 'codex',+ author: 'Autonomous',+ category: 'Devices',+ description:+ 'Manage your Harness devices and work with an agent beside them.',+ viewer: true,+ ),+ ),+ companions(+ ExperimentalFeature.focusBarCreature,+ DshEntry(+ id: 'autonomous/pair',+ name: 'Companions',+ engine: 'opencode',+ author: 'Autonomous',+ category: 'Companions',+ description: 'Meet your companions, grow your collection, and talk with your companion.',+ viewer: true,+ ),+ );++ const ExperimentalStoreHarness(this.feature, this.entry);+ final ExperimentalFeature feature;+ final DshEntry entry;++ bool enabled(ExperimentalFeaturesStore features) =>+ feature.available &&+ features.isAvailable(feature) &&+ features.enabled(feature);++ static ExperimentalStoreHarness? forId(String id) =>+ values.where((harness) => harness.entry.id == id).firstOrNull;+}++/// Also filters rows from older/custom daemons: a catalog row cannot bypass+/// an account opt-in, and a generated companion name is not the product name.+Iterable<DshEntry> storeVisibleHarnesses(+ Iterable<DshEntry> entries,+ ExperimentalFeaturesStore features,+) sync* {+ yield* entries.where(+ (entry) => ExperimentalStoreHarness.forId(entry.id) == null,+ );+ for (final harness in ExperimentalStoreHarness.values) {+ if (harness.enabled(features)) yield harness.entry;+ }+}diff --git a/desktop/lib/store/store_screen.dart b/desktop/lib/store/store_screen.dartindex 114eb9191..ada321dad 100644--- a/desktop/lib/store/store_screen.dart+++ b/desktop/lib/store/store_screen.dart@@ -26,6 +26,7 @@ import '../widgets/dsh_install_panel.dart' show describeInstallFailure;import '../widgets/engine_identity.dart';import '../widgets/new_agent_dialog.dart';import '../widgets/open_harness_intent.dart';+import 'experimental_harnesses.dart';import 'store_category.dart';import 'store_collections.dart';import 'store_controller.dart';@@ -273,8 +274,9 @@ class _StoreTabState extends State<StoreTab> {installed: _installedOnMachine(local, identity.id),);}- for (final entry in currentHarnessCatalog(- local?.dsh.entries ?? const <DshEntry>[],+ for (final entry in storeVisibleHarnesses(+ currentHarnessCatalog(local?.dsh.entries ?? const <DshEntry>[]),+ widget.notifier.experimentalFeatures,)) {rows.putIfAbsent(entry.id, () => entry);}@@ -439,7 +441,11 @@ class _StoreTabState extends State<StoreTab> {child: ColoredBox(color: grid.AppPalette.windowBg,child: ListenableBuilder(- listenable: Listenable.merge([widget.notifier, _store]),+ listenable: Listenable.merge([+ widget.notifier,+ widget.notifier.experimentalFeatures,+ _store,+ ]),builder: (context, _) {final catalog = _catalog;final selected = _selected == null@@ -903,7 +909,8 @@ bool _canGetOnMachine(MachineState machine, DshEntry entry) {machine.dsh.runs[id]?.inProgress != true;}-/// Open the workspace's New Harness dock with this product and machine chosen.+/// Open a bundled app workspace, or the New Harness dock with this product and+/// machine chosen./// A successful start opens a new tab; reviewing or cancelling allocates none.////// Public because it is the ONE way a harness is opened from anywhere — the@@ -916,6 +923,22 @@ Future<void> openStoreAgent(String machineId, {String? prompt,}) async {+ final workspace = ExperimentalStoreHarness.forId(harnessId);+ if (workspace != null) {+ // Recheck at activation as the account/flag can change after rendering.+ if (!workspace.enabled(notifier.experimentalFeatures)) return;+ switch (workspace) {+ case ExperimentalStoreHarness.devices:+ notifier.openDevices();+ case ExperimentalStoreHarness.companions:+ notifier.openCompanions();+ notifier.syncCompanionViewer(+ enabled: true,+ machineId: notifier.localMachineState?.machine.machineId,+ );+ }+ return;+ }harnessId = _operationId(notifier.machineStates[machineId], harnessId);final intent = OpenHarnessIntent(harnessId, machineId, task: prompt);if (Actions.maybeFind<OpenHarnessIntent>(context) != null) {@@ -1115,7 +1138,8 @@ class _ProductPageState extends State<_ProductPage> {/// Open from the Store with this product and machine. An example's [prompt]/// becomes the editable task in the same dock before the person presses Start.Future<void> _open(String machineId, {String? prompt}) async {- if (widget.notifier.localMachineState?.machine.machineId != machineId) {+ if (ExperimentalStoreHarness.forId(widget.entry.id) == null &&+ widget.notifier.localMachineState?.machine.machineId != machineId) {return;}await openStoreAgent(@@ -1153,6 +1177,7 @@ class _ProductPageState extends State<_ProductPage> {Widget build(BuildContext context) {grid.AppTheme.watch(context);final entry = widget.entry;+ final workspace = ExperimentalStoreHarness.forId(entry.id);final identity = engineIdentity(entry.id, displayName: entry.name);final author = entry.author ?? identity.creator;final category = entry.category ?? identity.category;@@ -1161,7 +1186,9 @@ class _ProductPageState extends State<_ProductPage> {final local = widget.notifier.localMachineState;final localInstalled = _installedOnMachine(local, entry.id);final operationId = _operationId(local, entry.id);- final hasUpdate = _machineHarness(local, entry.id)?.hasUpdate == true;+ final hasUpdate =+ workspace == null &&+ _machineHarness(local, entry.id)?.hasUpdate == true;final base = entry.engine.isNotEmpty? entry.engine: (knownHarnessBase[entry.id] ?? '');@@ -1173,12 +1200,17 @@ class _ProductPageState extends State<_ProductPage> {// New Harness installs a harness the machine lacks before it creates, so// an example can be tried from here whether or not Get was pressed.final canTry =+ workspace == null &&!entry.isViewerPackage &&local != null &&!busy &&!installing &&(localInstalled || _canGetOnMachine(local, entry));- final showLaunch = !entry.isViewerPackage && !hasUpdate && localInstalled;+ final showLaunch =+ workspace == null &&+ !entry.isViewerPackage &&+ !hasUpdate &&+ localInstalled;// A package that has not published its own examples yet still leads with// prompts — the editorial ones — so every page reads the same way.final examples = entry.examples.isNotEmpty@@ -1194,8 +1226,9 @@ class _ProductPageState extends State<_ProductPage> {// A viewer package is never opened on its own: once it is here there is// nothing more to press, and Remove sits in the line beneath.final showAction =- local != null &&- (hasUpdate || !(entry.isViewerPackage && localInstalled));+ workspace != null ||+ (local != null &&+ (hasUpdate || !(entry.isViewerPackage && localInstalled)));return LayoutBuilder(builder: (context, constraints) {@@ -1259,7 +1292,9 @@ class _ProductPageState extends State<_ProductPage> {[?author,?category,- if (entry.isViewerPackage)+ if (workspace != null)+ 'Included with Harness'+ else if (entry.isViewerPackage)'Viewer package'else if (entry.isEngine)'Coding agent'@@ -1319,11 +1354,13 @@ class _ProductPageState extends State<_ProductPage> {Center(child: FilledButton(key: const ValueKey('store-primary-action'),- onPressed:- busy ||- installing ||- (!localInstalled &&- !_canGetOnMachine(local, entry))+ onPressed: workspace != null+ ? () => _open(local?.machine.machineId ?? '')+ : local == null ||+ busy ||+ installing ||+ (!localInstalled &&+ !_canGetOnMachine(local, entry))? null: () => hasUpdate? _update(local.machine.machineId)@@ -1339,7 +1376,9 @@ class _ProductPageState extends State<_ProductPage> {shape: const StadiumBorder(),),child: Text(- installing || busy+ workspace != null+ ? 'Open'+ : installing || busy? 'Working…': hasUpdate? 'Update'@@ -1374,27 +1413,28 @@ class _ProductPageState extends State<_ProductPage> {),],const SizedBox(height: 14),- Center(- child: local == null- ? Text(- 'Connecting to this computer…',- style: grid.AppType.body(- color: grid.AppPalette.textFaint,- ),- )- : _InstallLine(- key: ValueKey(- 'store-machine:${local.machine.machineId}',- ),- state: local,- entry: entry,- busy: busy,- onRemove: () => _remove(- local.machine.machineId,- local.machine.displayName,+ if (workspace == null)+ Center(+ child: local == null+ ? Text(+ 'Connecting to this computer…',+ style: grid.AppType.body(+ color: grid.AppPalette.textFaint,+ ),+ )+ : _InstallLine(+ key: ValueKey(+ 'store-machine:${local.machine.machineId}',+ ),+ state: local,+ entry: entry,+ busy: busy,+ onRemove: () => _remove(+ local.machine.machineId,+ local.machine.displayName,+ ),),- ),- ),+ ),const SizedBox(height: 24),],),diff --git a/desktop/lib/widgets/pane_grid.dart b/desktop/lib/widgets/pane_grid.dartindex b4a55b312..682887518 100644--- a/desktop/lib/widgets/pane_grid.dart+++ b/desktop/lib/widgets/pane_grid.dart@@ -57,6 +57,7 @@ class PaneGrid extends StatelessWidget {this.onSplitPane,this.soloFocused = false,this.companionViewer,+ this.companionConversation,this.devicesViewer,this.devicesConversation,});@@ -75,6 +76,7 @@ class PaneGrid extends StatelessWidget {/// The built-in companion DSH viewer; its agent uses the ordinary terminal.final WidgetBuilder? companionViewer;+ final WidgetBuilder? companionConversation;final WidgetBuilder? devicesViewer;final WidgetBuilder? devicesConversation;@@ -93,6 +95,7 @@ class PaneGrid extends StatelessWidget {onSplitPane: onSplitPane,soloFocused: soloFocused,companionViewer: companionViewer,+ companionConversation: companionConversation,devicesViewer: devicesViewer,devicesConversation: devicesConversation,);@@ -112,6 +115,7 @@ class PaneGrid extends StatelessWidget {onOpenModels: onOpenModels,onSplitPane: onSplitPane,companionViewer: companionViewer,+ companionConversation: companionConversation,devicesViewer: devicesViewer,devicesConversation: devicesConversation,);@@ -264,6 +268,7 @@ class _SwarmCanvas extends StatefulWidget {this.onSplitPane,this.soloFocused = false,this.companionViewer,+ this.companionConversation,this.devicesViewer,this.devicesConversation,});@@ -275,6 +280,7 @@ class _SwarmCanvas extends StatefulWidget {final void Function(int paneId, PaneResizeAxis axis)? onSplitPane;final bool soloFocused;final WidgetBuilder? companionViewer;+ final WidgetBuilder? companionConversation;final WidgetBuilder? devicesViewer;final WidgetBuilder? devicesConversation;@override@@ -630,6 +636,8 @@ class _SwarmCanvasState extends State<_SwarmCanvas> {onSplitPane: widget.onSplitPane,solo: widget.soloFocused,companionViewer: widget.companionViewer,+ companionConversation:+ widget.companionConversation,devicesViewer: widget.devicesViewer,devicesConversation:widget.devicesConversation,@@ -1234,6 +1242,7 @@ class _PaneCell extends StatelessWidget {this.onSplitPane,this.solo = false,this.companionViewer,+ this.companionConversation,this.devicesViewer,this.devicesConversation,});@@ -1247,6 +1256,7 @@ class _PaneCell extends StatelessWidget {onOpenModels;final void Function(int paneId, PaneResizeAxis axis)? onSplitPane;final WidgetBuilder? companionViewer;+ final WidgetBuilder? companionConversation;final WidgetBuilder? devicesViewer;final WidgetBuilder? devicesConversation;@@ -1395,6 +1405,14 @@ class _PaneCell extends StatelessWidget {tab.isDevices && tab.panes.contains(pane),)? devicesConversation!(context)+ : pane.agentId == null &&+ companionConversation != null &&+ notifier.swarms.any(+ (tab) =>+ tab.isCompanions &&+ tab.panes.contains(pane),+ )+ ? companionConversation!(context): _PaneContent(notifier: notifier,pane: pane,diff --git a/desktop/test/agent_change_test.dart b/desktop/test/agent_change_test.dartindex 1168d4591..7bcc32b67 100644--- a/desktop/test/agent_change_test.dart+++ b/desktop/test/agent_change_test.dart@@ -10,12 +10,15 @@ import 'package:harness/state/agent_switch_handoff.dart';import 'package:harness/state/desk_sync.dart';import 'package:harness/core/dsh_catalog.dart';import 'package:harness/core/models.dart';+import 'package:harness/devices/devices_harness_controller.dart';+import 'package:harness/settings/experimental_features.dart';import 'package:harness/state/app_state.dart';import 'package:harness/state/swarm_search.dart';import 'package:harness/terminal/terminal_binary.dart';import 'package:harness/widgets/engine_identity.dart';import 'support/harness_monitor.dart';+import 'experimental_features_test.dart' show AccountSettings;import 'swarm_screen_test.dart' show mount, terminal;import 'swarm_state_test.dart' show createApp;@@ -67,7 +70,8 @@ class SwitchConnection extends MonitorConnection {'engine': creations.last['engine'],if (launch != null) 'launch': launch,'project': {'name': 'work', 'cwd': '/projects/work'},- if (creations.last['dsh'] != null)+ if (creations.last['dsh'] != null &&+ creations.last['dsh'] != devicesHarnessId)'viewerUrl': 'http://127.0.0.1:4179/',},};@@ -80,6 +84,7 @@ AppNotifier fixture(SwitchConnection connection, {bool viewer = false,bool companion = false,+ String? harnessId,String sourceEngine = 'codex',}) {final app = createApp(connectionForTest: (_) => connection, connected: true);@@ -94,11 +99,13 @@ AppNotifier fixture(terminalAvailable: true,permissionMode: 'ask',project: const AgentProject(name: 'work', cwd: '/projects/work'),- dsh: companion- ? 'autonomous/pair'- : viewer- ? 'test/viewer'- : null,+ dsh:+ harnessId ??+ (companion+ ? 'autonomous/pair'+ : viewer+ ? 'test/viewer'+ : null),viewerUrl: viewer ? 'http://127.0.0.1:4179/' : null,);app.stateOf('m')!.agents = [source, app.stateOf('m')!.agents[1]];@@ -139,6 +146,114 @@ class SwitchDeskApi extends ApiClient {}void main() {+ test('Devices offers every agent while absent from the public catalog', () {+ final connection = SwitchConnection();+ final app = fixture(connection, harnessId: devicesHarnessId);+ addTearDown(app.dispose);+ app.stateOf('m')!.dsh.replace(const []);+ final search = SwarmSearchController(app, []);+ addTearDown(search.dispose);+ search.setQuery('&');+ search.setAgentSelection('m', 'a0');+ expect(app.stateOf('m')!.dsh[devicesHarnessId], isNull);+ expect(search.rows, hasLength(allEngines.length));+ for (final engine in allEngines) {+ search.move(+ search.rows.indexWhere((row) => row.agentEngine == engine.id) -+ search.cursor,+ );+ expect(search.canSelectAgent(engine.id), isTrue, reason: engine.id);+ expect(search.selected!.detail, isNot('Not supported by this harness'));+ expect(search.submit()?.destination.agentEngine, engine.id);+ }+ expect(search.canSelectAgent('terminal'), isFalse);+ expect(+ connection.events,+ isEmpty,+ reason: 'Browsing does not switch agents.',+ );+ });++ test(+ 'Devices still respects explicit compatibility reported by its machine',+ () {+ final connection = SwitchConnection();+ final app = fixture(connection, harnessId: devicesHarnessId);+ addTearDown(app.dispose);+ app.stateOf('m')!.dsh.replace(const [+ DshEntry(id: devicesHarnessId, name: 'Devices', engine: 'codex'),+ ]);+ expect(app.agentSwitchEngines('m', app.stateOf('m')!.agents.first), [+ 'codex',+ ]);+ },+ );++ test('an unknown harness does not inherit Devices compatibility', () async {+ final connection = SwitchConnection();+ final app = fixture(connection, harnessId: 'acme/missing');+ addTearDown(app.dispose);+ app.stateOf('m')!.dsh.replace(const []);+ expect(+ await app.changeAgent('m', 'a0', 'claude'),+ contains('not supported'),+ );+ expect(connection.events, isEmpty);+ });++ for (final engine in allEngines.where((engine) => engine.id != 'codex')) {+ test(+ 'Devices switches to ${engine.id} while retaining its dashboard and split',+ () async {+ final connection = SwitchConnection();+ final app = fixture(connection, harnessId: devicesHarnessId);+ addTearDown(app.dispose);+ app.currentUser = const CurrentUserProfile(+ id: 'a',+ email: '[email protected]',+ );+ app.experimentalFeatures.bind('a', transport: AccountSettings('a'));+ await app.experimentalFeatures.refresh();+ await app.experimentalFeatures.set(+ ExperimentalFeature.devicesTab,+ true,+ );+ app.stateOf('m')!.dsh.replace(const []);+ app.openDevices();+ await app.showDevicesTerminal('m', 'a0');+ final tab = app.activeSwarm;+ final panes = [...tab.panes];+ final sizes = Map.of(tab.paneSizes);+ expect(panes, hasLength(2));+ expect(panes.first.isDevices, isTrue);+ expect(tab.manualLayout!.tiles.first.width, .7);++ expect(await app.changeAgent('m', 'a0', engine.id), isNull);+ expect(connection.events, ['save/stop', 'start']);+ expect(connection.creations.single, containsPair('engine', engine.id));+ expect(+ connection.creations.single,+ containsPair('dsh', devicesHarnessId),+ );+ expect(+ connection.creations.single,+ containsPair('cwd', '/projects/work'),+ );+ expect(+ connection.creations.single,+ containsPair('permissionMode', 'ask'),+ );+ expect(app.activeSwarm, same(tab));+ expect(tab.panes, panes);+ expect(panes.first.isDevices, isTrue);+ expect(panes.first.ownerAgentId, 'manager');+ expect(panes.last.agentId, 'manager');+ expect(tab.paneSizes, sizes);+ expect(app.agentPreference.engineFor(devicesHarnessId), engine.id);+ },+ );+ }+for (final state in ['starting', 'failed']) {test('attaches a $state replacement immediately so startup prompts can be answered',diff --git a/desktop/test/store_experiments_test.dart b/desktop/test/store_experiments_test.dartnew file mode 100644index 000000000..48302c952--- /dev/null+++ b/desktop/test/store_experiments_test.dart@@ -0,0 +1,493 @@+import 'dart:async';+import 'dart:io';+import 'dart:ui' as ui;++import 'package:flutter/material.dart';+import 'package:flutter/rendering.dart';+import 'package:flutter/services.dart';+import 'package:flutter_test/flutter_test.dart';+import 'package:harness/auth/auth_session.dart';+import 'package:harness/core/config.dart';+import 'package:harness/core/dsh_catalog.dart';+import 'package:harness/core/models.dart';+import 'package:harness/daemons/zoo_controller.dart';+import 'package:harness/screens/swarm_screen.dart';+import 'package:harness/settings/experimental_features.dart';+import 'package:harness/shared/theme/app_theme.dart' as grid;+import 'package:harness/state/app_state.dart';+import 'package:harness/state/swarm_search.dart';+import 'package:harness/state/swarm_catalog.dart';+import 'package:harness/store/experimental_harnesses.dart';+import 'package:harness/store/store_controller.dart';+import 'package:harness/store/store_discover.dart';+import 'package:harness/store/store_models.dart';+import 'package:harness/store/store_screen.dart';+import 'package:harness/widgets/open_harness_intent.dart';++import 'experimental_features_test.dart' show AccountSettings;+import 'daemons/zoo_test.dart' show FakeZooTransport;+import 'support/real_fonts.dart';++const _ordinary = DshEntry(+ id: 'autonomous/marp',+ name: 'Marp',+ engine: 'claude',+);+// Even a daemon that advertises the internal records cannot bypass the flags+// or turn a generated companion into a separately installable product.+const _advertised = [+ _ordinary,+ DshEntry(+ id: 'autonomous/devices',+ name: 'Devices',+ engine: 'codex',+ installed: true,+ updateAvailable: true,+ ),+ DshEntry(+ id: 'autonomous/pair',+ name: 'Tim',+ engine: 'codex',+ installed: true,+ updateAvailable: true,+ ),+];++class _App extends AppNotifier {+ _App()+ : super(+ config: AppConfig.dev,+ authSession: AuthSession(),+ configStore: null,+ );+ @override+ Future<void> probeDsh(String machineId, {bool force = false}) async {}+ @override+ Future<void> probeEngines(String machineId, {bool force = false}) async {}+ @override+ Future<String?> installDsh(+ String machineId,+ String id, {+ bool trustUnverified = false,+ }) async =>+ throw StateError('Bundled workspaces must not be installed from Store');+ @override+ Future<String?> updateDsh(+ String machineId,+ String id, {+ bool trustUnverified = false,+ }) async => throw StateError('Bundled workspaces update with Harness');+ @override+ Future<String?> removeDsh(String machineId, String id) async =>+ throw StateError('Bundled workspaces cannot be removed from Store');+}++class _Store implements StoreApi {+ @override+ Future<List<StoreRating>> ratings() async => [];+ @override+ Future<StoreReviews> reviews(String id) async =>+ StoreReviews(rating: StoreRating.none(id), reviews: const [], mine: null);+ @override+ Future<void> deleteReview(String id) async {}+ @override+ Future<StoreReview> putReview(+ String id, {+ required int rating,+ String? title,+ String? body,+ }) => throw UnimplementedError();+}++Future<AccountSettings> _bind(ExperimentalFeaturesStore features) async {+ final server = AccountSettings('account-a');+ features.bind('account-a', transport: server);+ await features.refresh();+ return server;+}++void main() {+ TestWidgetsFlutterBinding.ensureInitialized();+ setUpAll(() async {+ await loadRealFonts();+ await (FontLoader('packages/lucide_icons_flutter/Lucide400')..addFont(+ rootBundle.load(+ 'packages/lucide_icons_flutter/assets/build_font/LucideVariable-w400.ttf',+ ),+ ))+ .load();+ });++ test('each confirmed flag controls its own listing, including advertised records', () async {+ final features = ExperimentalFeaturesStore(pollInterval: Duration.zero);+ addTearDown(features.dispose);+ List<DshEntry> visible() =>+ storeVisibleHarnesses(_advertised, features).toList();+ expect(visible(), [_ordinary]);+ final server = await _bind(features);+ expect(visible(), [_ordinary]);+ for (final harness in ExperimentalStoreHarness.values) {+ final ack = Completer<Map<String, dynamic>>();+ server.writeOverride = () => ack.future;+ final saving = features.set(harness.feature, true);+ expect(visible(), [+ _ordinary,+ ], reason: 'Wait for account acknowledgement');+ server.features[harness.feature.id] = true;+ server.revision++;+ ack.complete(server.snapshot);+ await saving;+ expect(visible(), [_ordinary, harness.entry]);+ server.writeOverride = null;+ await features.set(harness.feature, false);+ expect(visible(), [_ordinary]);+ }+ for (final harness in ExperimentalStoreHarness.values) {+ await features.set(harness.feature, true);+ }+ expect(visible().map((entry) => entry.name), [+ 'Marp',+ 'Devices',+ 'Companions',+ ]);+ await features.set(ExperimentalFeature.devicesTab, false);+ expect(visible().map((entry) => entry.name), ['Marp', 'Companions']);+ features.bind('account-b');+ expect(visible(), [+ _ordinary,+ ], reason: 'Never inherit another account’s flags');+ });++ test(+ 'unavailable experiments and failed saves cannot reveal a listing',+ () async {+ final features = ExperimentalFeaturesStore(pollInterval: Duration.zero);+ addTearDown(features.dispose);+ final server = await _bind(features);+ server.writeOverride = () async => throw StateError('offline');+ await features.set(ExperimentalFeature.devicesTab, true);+ expect(storeVisibleHarnesses(_advertised, features), [_ordinary]);+ server.features[ExperimentalFeature.devicesTab.id] = true;+ server.revision++;+ server.readOverride = () async => {+ ...server.snapshot,+ 'available': {ExperimentalFeature.devicesTab.id: false},+ };+ await features.refresh();+ expect(storeVisibleHarnesses(_advertised, features), [_ordinary]);+ },+ );++ test('an open Store search refreshes on flags and account changes', () async {+ final app = _App();+ addTearDown(app.dispose);+ app.machineStates['m'] = MachineState(+ const Machine(machineId: 'm', authMode: MachineAuthMode.remote),+ )..dsh.replace(_advertised);+ await _bind(app.experimentalFeatures);+ final search = SwarmSearchController(app, [])..setQuery('*');+ addTearDown(search.dispose);+ expect(search.isStoreMode, isTrue);+ expect(search.storeEntries.keys, [_ordinary.id]);+ for (final harness in ExperimentalStoreHarness.values) {+ await app.experimentalFeatures.set(harness.feature, true);+ }+ expect(+ search.storeEntries.keys,+ containsAll(['autonomous/devices', 'autonomous/pair']),+ );+ search.setQuery('* companions');+ expect(search.rows.single.storeId, 'autonomous/pair');+ await app.experimentalFeatures.set(+ ExperimentalFeature.focusBarCreature,+ false,+ );+ expect(+ search.rows.where((row) => row.storeId == 'autonomous/pair'),+ isEmpty,+ );+ expect(search.storeEntries, contains('autonomous/devices'));+ app.experimentalFeatures.bind(null);+ expect(search.storeEntries.keys, [_ordinary.id]);+ });++ Future<_App> mount(+ WidgetTester tester, {+ String? id,+ bool local = true,+ bool enabled = true,+ Size size = const Size(1200, 900),+ Brightness brightness = Brightness.dark,+ double scale = 1,+ GlobalKey? boundary,+ }) async {+ tester.view.physicalSize = size;+ tester.view.devicePixelRatio = 1;+ addTearDown(tester.view.reset);+ final previousBrightness = grid.AppTheme.brightness.value;+ grid.AppTheme.brightness.value = brightness;+ addTearDown(() => grid.AppTheme.brightness.value = previousBrightness);+ final app = _App();+ addTearDown(app.dispose);+ if (local) {+ app.machineStates['m'] =+ MachineState(+ const Machine(+ machineId: 'm',+ name: 'This Mac',+ authMode: MachineAuthMode.remote,+ ),+ )+ ..localOnly = true+ ..dsh.replace(_advertised);+ }+ await _bind(app.experimentalFeatures);+ if (id != null && enabled) {+ await app.experimentalFeatures.set(+ ExperimentalStoreHarness.forId(id)!.feature,+ true,+ );+ }+ app.openStore();+ await tester.pumpWidget(+ MaterialApp(+ theme: grid.buildAppTheme(brightness: brightness),+ builder: (context, child) => MediaQuery(+ data: MediaQuery.of(context)+ .copyWith(textScaler: TextScaler.linear(scale)),+ child: grid.BrightnessScope(child: child!),+ ),+ home: Actions(+ actions: {+ OpenHarnessIntent: CallbackAction<OpenHarnessIntent>(+ onInvoke: (_) => throw StateError(+ 'Use the existing app workspace, not generic creation',+ ),+ ),+ },+ child: RepaintBoundary(+ key: boundary,+ child: Scaffold(+ body: StoreTab(notifier: app, api: _Store(), initialHarness: id),+ ),+ ),+ ),+ ),+ );+ await tester.pumpAndSettle();+ return app;+ }++ testWidgets(+ 'Store listings and an open product page follow live flag changes',+ (tester) async {+ final app = await mount(tester);+ List<String> ids() => tester+ .widget<StoreDiscover>(find.byType(StoreDiscover))+ .entries+ .map((entry) => entry.id)+ .toList();+ expect(ids(), isNot(contains('autonomous/devices')));+ expect(ids(), isNot(contains('autonomous/pair')));+ await app.experimentalFeatures.set(ExperimentalFeature.devicesTab, true);+ await tester.pumpAndSettle();+ expect(ids(), contains('autonomous/devices'));+ expect(ids(), isNot(contains('autonomous/pair')));+ // Open from Store discovery; its canonical product identity is stable.+ final card = find.byKey(const ValueKey('store-card:autonomous/devices'));+ await tester.ensureVisible(card);+ await tester.tap(card);+ await tester.pumpAndSettle();+ expect(find.text('Open'), findsOneWidget);+ final oldOpen = tester+ .widget<FilledButton>(+ find.byKey(const ValueKey('store-primary-action')),+ )+ .onPressed!;+ await app.experimentalFeatures.set(ExperimentalFeature.devicesTab, false);+ // An already captured callback must be harmless even before the next frame.+ oldOpen();+ expect(app.activeSwarm.isStore, isTrue);+ await tester.pumpAndSettle();+ expect(find.text('Open'), findsNothing);+ expect(ids(), isNot(contains('autonomous/devices')));+ await tester.pumpWidget(const SizedBox());+ },+ );++ for (final harness in ExperimentalStoreHarness.values) {+ testWidgets(+ 'a disabled ${harness.entry.name} deep link cannot expose its page',+ (tester) async {+ final app = await mount(tester, id: harness.entry.id, enabled: false);+ expect(find.byType(StoreDiscover), findsOneWidget);+ expect(+ find.byKey(const ValueKey('store-primary-action')),+ findsNothing,+ );+ await openStoreAgent(+ tester.element(find.byType(StoreTab)),+ app,+ harness.entry.id,+ 'm',+ );+ expect(app.activeSwarm.isStore, isTrue);+ expect(app.swarms, hasLength(1));+ await tester.pumpWidget(const SizedBox());+ },+ );+ for (final local in [false, true]) {+ testWidgets(+ '${harness.entry.name} opens and reuses its app workspace (local=$local)',+ (tester) async {+ final app = await mount(tester, id: harness.entry.id, local: local);+ expect(find.text('Open'), findsOneWidget);+ expect(find.text('Get'), findsNothing);+ expect(find.text('Update'), findsNothing);+ expect(find.text('Remove'), findsNothing);+ expect(find.textContaining('Included with Harness'), findsOneWidget);+ final storeTab = app.activeSwarm;+ await tester.tap(find.byKey(const ValueKey('store-primary-action')));+ await tester.pumpAndSettle();+ final workspace = app.activeSwarm;+ expect(+ harness == ExperimentalStoreHarness.devices+ ? workspace.isDevices+ : workspace.isCompanions,+ isTrue,+ );+ expect(workspace.panes, hasLength(2));+ expect(workspace.manualLayout!.tiles.first.width, .7);+ app.selectSwarm(storeTab.id);+ await tester.pumpAndSettle();+ await tester.tap(find.byKey(const ValueKey('store-primary-action')));+ expect(app.activeSwarm, same(workspace));+ expect(app.swarms, hasLength(2));+ expect(tester.takeException(), isNull);+ await tester.pumpWidget(const SizedBox());+ },+ );+ }+ }++ testWidgets(+ 'Store opens Companions with both panes while its collection loads',+ (tester) async {+ tester.view.physicalSize = const Size(1280, 900);+ tester.view.devicePixelRatio = 1;+ addTearDown(tester.view.reset);+ final app = _App()+ ..currentUser = const CurrentUserProfile(+ id: 'account-a',+ email: '[email protected]',+ );+ final projects = SwarmProjectStore();+ final zoo = ZooController();+ final remote = FakeZooTransport()..gate = Completer<void>();+ addTearDown(app.dispose);+ addTearDown(projects.dispose);+ addTearDown(zoo.dispose);+ await _bind(app.experimentalFeatures);+ await app.experimentalFeatures.set(+ ExperimentalFeature.focusBarCreature,+ true,+ );+ app.openStore();+ await tester.pumpWidget(+ MaterialApp(+ theme: grid.buildAppTheme(brightness: Brightness.dark),+ home: SwarmScreen(+ notifier: app,+ nativeTabs: false,+ projectStore: projects,+ zoo: zoo,+ zooTransport: remote,+ daemonClock: tester.binding.clock.now,+ ),+ ),+ );+ await tester.pump(const Duration(milliseconds: 100));+ await openStoreAgent(+ tester.element(find.byType(StoreTab)),+ app,+ 'autonomous/pair',+ '',+ );+ final panes = app.panes.toList();+ expect(+ panes,+ hasLength(2),+ reason: 'Reserve chat before asynchronous collection setup',+ );+ await tester.pump(const Duration(milliseconds: 100));+ expect(find.text('Opening your collection…'), findsOneWidget);+ final chat = find.byKey(const ValueKey('companion-conversation-setup'));+ expect(chat, findsOneWidget);+ final viewerRect = tester.getRect(+ find.byKey(ValueKey('pane-frame:${panes.first.id}')),+ );+ final chatRect = tester.getRect(+ find.byKey(ValueKey('pane-frame:${panes.last.id}')),+ );+ expect(viewerRect.right, lessThan(chatRect.left));+ expect(+ viewerRect.width / (viewerRect.width + chatRect.width),+ closeTo(.7, .01),+ );+ remote.gate!.complete();+ await tester.pump();+ await tester.pump(const Duration(milliseconds: 100));+ expect(zoo.loaded, isTrue);+ expect(app.panes, panes);+ expect(+ chat,+ findsOneWidget,+ reason: 'Unpaired companion retains its chat slot',+ );+ expect(tester.takeException(), isNull);+ await tester.pumpWidget(const SizedBox());+ },+ );++ for (final (label, size, brightness, scale) in [+ ('dark', const Size(1200, 900), Brightness.dark, 1.0),+ ('light-large-text', const Size(800, 760), Brightness.light, 2.0),+ ]) {+ for (final harness in ExperimentalStoreHarness.values) {+ testWidgets('${harness.entry.name} Store page renders at $label', (+ tester,+ ) async {+ final boundary = GlobalKey();+ await mount(+ tester,+ id: harness.entry.id,+ size: size,+ brightness: brightness,+ scale: scale,+ boundary: boundary,+ );+ final open = find.byKey(const ValueKey('store-primary-action'));+ await tester.ensureVisible(open);+ await tester.pumpAndSettle();+ expect(tester.widget<FilledButton>(open).onPressed, isNotNull);+ expect(tester.takeException(), isNull);+ final output =+ Platform.environment['HARNESS_STORE_EXPERIMENT_CAPTURE_DIR'];+ if (output != null) {+ await tester.runAsync(() async {+ final render =+ boundary.currentContext!.findRenderObject()!+ as RenderRepaintBoundary;+ final image = await render.toImage(pixelRatio: 1);+ final data = await image.toByteData(format: ui.ImageByteFormat.png);+ await Directory(output).create(recursive: true);+ await File('$output/${harness.name}-$label.png')+ .writeAsBytes(data!.buffer.asUint8List());+ image.dispose();+ });+ }+ await tester.pumpWidget(const SizedBox());+ });+ }+ }+}diff --git a/docs/research/2026-10-02-experimental-store/companions-dark.png b/docs/research/2026-10-02-experimental-store/companions-dark.pngnew file mode 100644index 000000000..80d974ac8Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/companions-dark.png differdiff --git a/docs/research/2026-10-02-experimental-store/companions-light-large-text.png b/docs/research/2026-10-02-experimental-store/companions-light-large-text.pngnew file mode 100644index 000000000..43219079aBinary files /dev/null and b/docs/research/2026-10-02-experimental-store/companions-light-large-text.png differdiff --git a/docs/research/2026-10-02-experimental-store/devices-dark.png b/docs/research/2026-10-02-experimental-store/devices-dark.pngnew file mode 100644index 000000000..ecce4ac84Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/devices-dark.png differdiff --git a/docs/research/2026-10-02-experimental-store/devices-light-large-text.png b/docs/research/2026-10-02-experimental-store/devices-light-large-text.pngnew file mode 100644index 000000000..665c348b2Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/devices-light-large-text.png differdiff --git a/store/README.md b/store/README.mdindex e1458e535..e71af79bc 100644--- a/store/README.md+++ b/store/README.md@@ -339,6 +339,12 @@ the saved collection's identity is restored, without sending a prompt or replaciLinked developer checkouts and custom forks remain owner-managed. Core resources are versionedbeside the CLI, so a CLI rollback restores its corresponding core package revision as well.+Devices and Companions appear in the desktop Store and its search only while the current account's+**Devices tab** and **Focus-bar creature** experiments, respectively, are enabled. Switching either+off hides its listing immediately. Their **Open** action reuses the app workspace; these bundled+resources have no Store Get, Update or Remove action. They remain absent from the public daemon+catalog, so an account opt-in never publishes them to other users.+Other Store applications, such as Blender, keep explicit updates. The Store shows **Update** when a matching catalog source publishes a differentcommit with changed package content. Built-in catalog entries carry their package folder's Git treerevision, so a change elsewhere in the monorepo does not flag every installed harness. Hover over the