Skip to content

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.

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.md
index 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 totals
and breakdowns currently come from Claude, Codex and OpenCode ledgers; other engines show missing
metrics 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.dart
index 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.dart
index 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.dart
index 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.dart
index 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.dart
index 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.dart
new file mode 100644
index 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.dart
index 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.dart
index 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.dart
index 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.dart
new file mode 100644
index 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.png
new file mode 100644
index 000000000..80d974ac8
Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/companions-dark.png differ
diff --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.png
new file mode 100644
index 000000000..43219079a
Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/companions-light-large-text.png differ
diff --git a/docs/research/2026-10-02-experimental-store/devices-dark.png b/docs/research/2026-10-02-experimental-store/devices-dark.png
new file mode 100644
index 000000000..ecce4ac84
Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/devices-dark.png differ
diff --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.png
new file mode 100644
index 000000000..665c348b2
Binary files /dev/null and b/docs/research/2026-10-02-experimental-store/devices-light-large-text.png differ
diff --git a/store/README.md b/store/README.md
index 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 replaci
Linked developer checkouts and custom forks remain owner-managed. Core resources are versioned
beside 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 different
commit with changed package content. Built-in catalog entries carry their package folder's Git tree
revision, so a change elsewhere in the monorepo does not flag every installed harness. Hover over the