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.

Feature recorded harness sessions in Store discovery (#206)

Deef92974804a56
diff --git a/desktop/assets/store/README.md b/desktop/assets/store/README.md
index ff10dfb9a..bdda1486c 100644
--- a/desktop/assets/store/README.md
+++ b/desktop/assets/store/README.md
@@ -1,15 +1,18 @@
# Store previews
-All Store artwork is bundled, so browsing needs no external image service. Featured
-stories only appear when their tool is present in the live catalog.
+Editorial artwork is bundled. **Featured harnesses** uses the poster and recording from
+each harness's live catalog examples; posters load over HTTPS, with an app-icon fallback
+when unavailable. Videos load only after a click. Features only appear for tools present
+in the local machine's catalog.
## Editorial illustrations
`editorial-*.png` are eleven original illustrations generated with the built-in
imagegen tool. The exact prompts and file mapping are in
[`editorial-prompts.json`](../../tool/store_artwork/editorial-prompts.json).
-Discover uses three features (coding, 3D design, circuits); each discipline uses
-one feature. All catalog rows use app icons. These illustrations depict a craft,
+Discover uses three illustrated features (coding, 3D design, circuits) when the catalog
+has no recorded examples; each discipline uses one feature. Catalog rows use app icons.
+These illustrations depict a craft,
not an app screenshot or a claimed agent result.
## Original example outputs
diff --git a/desktop/design/review/store-featured.png b/desktop/design/review/store-featured.png
new file mode 100644
index 000000000..d6edcf8ec
Binary files /dev/null and b/desktop/design/review/store-featured.png differ
diff --git a/desktop/integration_test/store_recordings_native_test.dart b/desktop/integration_test/store_recordings_native_test.dart
index bddead936..d0f396ef6 100644
--- a/desktop/integration_test/store_recordings_native_test.dart
+++ b/desktop/integration_test/store_recordings_native_test.dart
@@ -15,6 +15,8 @@ import 'package:harness/core/test_run.dart';
import 'package:harness/shared/theme/app_theme.dart' as grid;
import 'package:harness/store/store_demo_dialog.dart';
import 'package:harness/store/store_showcase.dart';
+import 'package:harness/store/store_collections.dart';
+import 'package:harness/store/store_sessions.dart';
// FLUTTER_TEST=1 flutter test -d macos --no-pub \
// --dart-define=STORE_DEMO_CHECKOUT=/absolute/path/to/openharness \
@@ -34,6 +36,74 @@ void main() {
await windowManager.focus();
});
+ testWidgets(
+ 'featured recording plays from its card before opening the harness',
+ (tester) async {
+ debugDefaultTargetPlatformOverride = TargetPlatform.macOS;
+ addTearDown(() => debugDefaultTargetPlatformOverride = null);
+ expect(checkout, isNotEmpty, reason: 'Pass STORE_DEMO_CHECKOUT');
+ final entry = DshEntry.fromJson({
+ ...jsonDecode(
+ await File('$checkout/store/agents/blender/harness.json')
+ .readAsString(),
+ ) as Map<String, dynamic>,
+ ...jsonDecode(
+ await File('$checkout/store/agents/blender/store.json')
+ .readAsString(),
+ ) as Map<String, dynamic>,
+ })!;
+ final opened = <String>[];
+ await tester.pumpWidget(
+ MaterialApp(
+ theme: grid.buildAppTheme(brightness: Brightness.dark),
+ home: Scaffold(
+ body: StoreSessions(
+ sessions: storeRecordedSessions([entry]),
+ onOpen: opened.add,
+ ),
+ ),
+ ),
+ );
+ expect(find.byType(WebViewWidget), findsNothing);
+ await tester.tap(
+ find.byKey(const ValueKey('store-session-watch:autonomous/blender')),
+ );
+ await tester.pump();
+ await _wait(
+ tester,
+ () async => find.byType(WebViewWidget).evaluate().isNotEmpty,
+ );
+ final controller = tester
+ .widget<WebViewWidget>(find.byType(WebViewWidget))
+ .platform
+ .params
+ .controller;
+ await _wait(tester, () async {
+ final state = await _video(controller);
+ return state['ready'] >= 2 && state['width'] > 0 && state['time'] > 0;
+ });
+ final playing = await _video(controller);
+ expect(playing['source'], entry.examples.first.video);
+ expect(playing['paused'], false);
+ expect(playing['error'], isNull);
+ debugPrint('Featured Blender recording decoded: $playing');
+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);
+ await tester.pumpAndSettle();
+ await _wait(
+ tester,
+ () async => (await _video(controller))['present'] == false,
+ );
+ await tester.tap(
+ find.byKey(const ValueKey('store-session-open:autonomous/blender')),
+ );
+ await tester.pumpAndSettle();
+ expect(opened, ['autonomous/blender']);
+ expect(tester.takeException(), isNull);
+ await tester.pumpWidget(const SizedBox());
+ debugDefaultTargetPlatformOverride = null;
+ },
+ );
+
testWidgets('every published recording decodes, plays and releases its media', (
tester,
) async {
diff --git a/desktop/lib/store/store_catalog_history.g.dart b/desktop/lib/store/store_catalog_history.g.dart
index fd97ce71f..8c25eee01 100644
--- a/desktop/lib/store/store_catalog_history.g.dart
+++ b/desktop/lib/store/store_catalog_history.g.dart
@@ -1,5 +1,5 @@
// Generated by desktop/tool/store_catalog_history.mjs.
-// Publication source: c0034c2d7dc072384d57e0562f994e51e483c2ff
+// Publication source: fc545b1e89aabeefcab53fbced235ff86d9d74d2
// A snapshot for this app release; unknown tools are never assigned fake dates.
const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
'autonomous/ableton-ai': (
@@ -12,7 +12,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/autonomous-grid': (
addedAt: '2026-09-18T07:20:25.000Z',
- updatedAt: '2026-09-20T07:04:49.000Z',
+ updatedAt: '2026-09-22T05:21:59.000Z',
),
'autonomous/autonomous-workshop': (
addedAt: '2026-09-17T05:18:32.000Z',
@@ -24,7 +24,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/blender': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/bonsai-mcp': (
addedAt: '2026-09-18T02:52:29.000Z',
@@ -32,7 +32,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/circuitjs': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/comfy-mcp': (
addedAt: '2026-09-18T02:52:29.000Z',
@@ -76,7 +76,11 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/godogen': (
addedAt: '2026-09-17T06:19:35.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
+ ),
+ 'autonomous/harness-monitor': (
+ addedAt: '2026-09-21T11:29:10.000Z',
+ updatedAt: '2026-09-22T05:21:59.000Z',
),
'autonomous/home-assistant': (
addedAt: '2026-09-19T19:26:36.000Z',
@@ -88,7 +92,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/jev-sheets': (
addedAt: '2026-09-19T17:24:55.000Z',
- updatedAt: '2026-09-20T14:36:44.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/juce-agent-toolkit': (
addedAt: '2026-09-18T02:52:29.000Z',
@@ -96,7 +100,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/kicad': (
addedAt: '2026-09-18T08:31:05.000Z',
- updatedAt: '2026-09-18T08:31:05.000Z',
+ updatedAt: '2026-09-21T08:15:21.000Z',
),
'autonomous/lab-bench': (
addedAt: '2026-09-19T16:47:24.000Z',
@@ -104,11 +108,11 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/machine-monitor': (
addedAt: '2026-09-20T23:16:16.000Z',
- updatedAt: '2026-09-20T23:16:16.000Z',
+ updatedAt: '2026-09-22T05:21:59.000Z',
),
'autonomous/manim': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/marimo': (
addedAt: '2026-09-17T05:18:32.000Z',
@@ -124,7 +128,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/mujoco': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/music-studio': (
addedAt: '2026-09-19T16:47:24.000Z',
@@ -152,7 +156,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/rdkit': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/remotion': (
addedAt: '2026-09-17T05:18:32.000Z',
@@ -172,7 +176,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/strudel': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/text-to-cad': (
addedAt: '2026-09-17T05:18:32.000Z',
@@ -180,7 +184,7 @@ const storeCatalogHistory = <String, ({String addedAt, String updatedAt})>{
),
'autonomous/typst': (
addedAt: '2026-09-17T05:18:32.000Z',
- updatedAt: '2026-09-18T03:26:29.000Z',
+ updatedAt: '2026-09-22T08:16:32.000Z',
),
'autonomous/vllm': (
addedAt: '2026-09-20T07:04:49.000Z',
diff --git a/desktop/lib/store/store_collections.dart b/desktop/lib/store/store_collections.dart
index 086fe7221..0b3409943 100644
--- a/desktop/lib/store/store_collections.dart
+++ b/desktop/lib/store/store_collections.dart
@@ -1,7 +1,43 @@
import '../core/dsh_catalog.dart';
import 'store_catalog_history.g.dart';
+import 'store_editorial.dart';
import 'store_models.dart';
+typedef StoreSession = ({DshEntry entry, StoreExample example});
+
+/// One recorded example per available harness. Catalog publications can join
+/// this collection without adding an ID or artwork to the desktop release.
+/// Start with a mix of disciplines; keep every remaining session discoverable.
+List<StoreSession> storeRecordedSessions(Iterable<DshEntry> entries) {
+ final sessions = <StoreSession>[];
+ for (final entry in entries) {
+ if (entry.isEngine || entry.isViewerPackage) continue;
+ final example = entry.examples.where((example) {
+ bool https(String? value) {
+ final uri = value == null ? null : Uri.tryParse(value);
+ return uri?.scheme == 'https' && uri!.host.isNotEmpty;
+ }
+
+ return https(example.image) && https(example.video);
+ }).firstOrNull;
+ if (example != null) sessions.add((entry: entry, example: example));
+ }
+ sessions.sort((a, b) {
+ final order = a.entry.name.toLowerCase().compareTo(
+ b.entry.name.toLowerCase(),
+ );
+ return order != 0 ? order : a.entry.id.compareTo(b.entry.id);
+ });
+ final categories = <String>{};
+ final first = <StoreSession>[], remaining = <StoreSession>[];
+ for (final session in sessions) {
+ (categories.add(storeCategoryFor(session.entry)) ? first : remaining).add(
+ session,
+ );
+ }
+ return [...first, ...remaining];
+}
+
/// Real publication history bundled with this app release. Membership still
/// comes from the machine's live catalog, so unavailable tools never appear.
List<DshEntry> storeRecentlyUpdated(Iterable<DshEntry> entries) {
diff --git a/desktop/lib/store/store_discover.dart b/desktop/lib/store/store_discover.dart
index 9236b1174..5fd5521e9 100644
--- a/desktop/lib/store/store_discover.dart
+++ b/desktop/lib/store/store_discover.dart
@@ -12,9 +12,10 @@ import 'store_explore_widgets.dart';
import 'store_featured_art.dart';
import 'store_listing.dart';
import 'store_models.dart';
+import 'store_sessions.dart';
-/// Three editorial features invite exploration before the icon collections. The catalog itself
-/// uses the same recognizable icons and rows as categories and search.
+/// Recorded sessions lead discovery whenever the live catalog provides them.
+/// Older catalogs still have the editorial invitations and ordinary collections.
class StoreDiscover extends StatelessWidget {
const StoreDiscover({
super.key,
@@ -25,6 +26,7 @@ class StoreDiscover extends StatelessWidget {
required this.onCategory,
required this.onAll,
required this.onEngines,
+ required this.onSessions,
});
final List<DshEntry> entries;
@@ -34,11 +36,13 @@ class StoreDiscover extends StatelessWidget {
final ValueChanged<String> onCategory;
final VoidCallback onAll;
final VoidCallback onEngines;
+ final VoidCallback onSessions;
@override
Widget build(BuildContext context) {
grid.AppTheme.watch(context);
final byId = {for (final entry in entries) entry.id: entry};
+ final sessions = storeRecordedSessions(entries);
// Editorial stories share an art direction and open actual catalog entries.
final features = [
?(byId['codex'] ?? byId['claude']),
@@ -92,7 +96,35 @@ class StoreDiscover extends StatelessWidget {
color: grid.AppPalette.textPrimary,
),
),
- if (features.isNotEmpty) ...[
+ if (sessions.isNotEmpty) ...[
+ const SizedBox(height: 24),
+ StoreExploreHeading(
+ title: 'Featured harnesses',
+ subtitle: 'Watch a real session. Find something you want to make.',
+ action: 'See all ${sessions.length}',
+ onAction: onSessions,
+ ),
+ const SizedBox(height: 20),
+ StoreSessionGrid(
+ sessions: sessions.take(6).toList(),
+ onOpen: onOpen,
+ ),
+ const SizedBox(height: 12),
+ Align(
+ alignment: Alignment.centerLeft,
+ child: TextButton.icon(
+ key: const ValueKey('store-all-sessions'),
+ onPressed: onSessions,
+ style: TextButton.styleFrom(
+ foregroundColor: grid.AppPalette.accentOnSurface,
+ ),
+ icon: const Icon(LucideIcons.play300, size: 15),
+ label: Text(
+ 'Explore all ${sessions.length} featured harnesses',
+ ),
+ ),
+ ),
+ ] else if (features.isNotEmpty) ...[
const SizedBox(height: 24),
LayoutBuilder(
builder: (context, constraints) {
diff --git a/desktop/lib/store/store_editorial.dart b/desktop/lib/store/store_editorial.dart
index ca79a196a..798d7d35a 100644
--- a/desktop/lib/store/store_editorial.dart
+++ b/desktop/lib/store/store_editorial.dart
@@ -257,6 +257,7 @@ bool storeMatches(DshEntry entry, String query) {
storeProjectExamples[entry.id]?.prompt,
storeProjectExamples[entry.id]?.title,
...entry.examples.map((example) => example.prompt),
+ ...entry.examples.map((example) => example.caption),
].join(' ').toLowerCase();
return terms.every(text.contains);
}
diff --git a/desktop/lib/store/store_explore_widgets.dart b/desktop/lib/store/store_explore_widgets.dart
index 7814c8858..b0208fb46 100644
--- a/desktop/lib/store/store_explore_widgets.dart
+++ b/desktop/lib/store/store_explore_widgets.dart
@@ -53,7 +53,13 @@ class StoreExploreHeading extends StatelessWidget {
),
if (onAction != null) ...[
const SizedBox(width: 16),
- TextButton(onPressed: onAction, child: Text(action!)),
+ TextButton(
+ onPressed: onAction,
+ style: TextButton.styleFrom(
+ foregroundColor: grid.AppPalette.accentOnSurface,
+ ),
+ child: Text(action!),
+ ),
],
],
);
diff --git a/desktop/lib/store/store_screen.dart b/desktop/lib/store/store_screen.dart
index 2bae72ba0..9d8c0d314 100644
--- a/desktop/lib/store/store_screen.dart
+++ b/desktop/lib/store/store_screen.dart
@@ -24,6 +24,7 @@ import '../widgets/engine_identity.dart';
import '../widgets/new_agent_dialog.dart';
import '../widgets/open_harness_intent.dart';
import 'store_category.dart';
+import 'store_collections.dart';
import 'store_controller.dart';
import 'store_discover.dart';
import 'store_editorial.dart';
@@ -31,6 +32,7 @@ import 'store_harness_actions.dart';
import 'store_listing.dart';
import 'store_models.dart';
import 'store_search.dart';
+import 'store_sessions.dart';
import 'store_showcase.dart';
import 'store_viewers.dart';
@@ -79,6 +81,10 @@ class _Discover extends _Shelf {
const _Discover();
}
+class _Sessions extends _Shelf {
+ const _Sessions();
+}
+
class _Viewers extends _Shelf {
const _Viewers();
}
@@ -294,7 +300,9 @@ class _StoreTabState extends State<StoreTab> {
final all = _catalog.values.toList()
..sort((a, b) => a.name.toLowerCase().compareTo(b.name.toLowerCase()));
return switch (shelf) {
- _Discover() || _All() => all.where((e) => !e.isViewerPackage).toList(),
+ _Discover() ||
+ _Sessions() ||
+ _All() => all.where((e) => !e.isViewerPackage).toList(),
_Search(:final query) => storeSearch(
all.where((e) => !e.isViewerPackage),
query,
@@ -311,6 +319,7 @@ class _StoreTabState extends State<StoreTab> {
String _shelfKey(_Shelf shelf) => switch (shelf) {
_Discover() => 'discover',
+ _Sessions() => 'sessions',
_All() => 'all',
_Search(:final query) => 'search:$query',
_Category(:final name) => 'category:$name',
@@ -445,6 +454,7 @@ class _StoreTabState extends State<StoreTab> {
shelf: _shelf,
selectedCategory: category,
hasProduct: selected != null,
+ sessionCount: storeRecordedSessions(catalog.values).length,
counts: {
for (final name in _categories)
name: catalog.values
@@ -514,6 +524,13 @@ class _StoreTabState extends State<StoreTab> {
.loaded ??
false,
)
+ : _shelf is _Sessions
+ ? StoreSessions(
+ sessions: storeRecordedSessions(
+ _shelved(const _Sessions()),
+ ),
+ onOpen: _openPage,
+ )
: _shelf is _Discover
? StoreDiscover(
entries: _shelved(const _Discover()),
@@ -531,6 +548,8 @@ class _StoreTabState extends State<StoreTab> {
onCategory: (name) =>
_show(_Category(name)),
onAll: () => _show(const _All()),
+ onSessions: () =>
+ _show(const _Sessions()),
onEngines: () =>
_show(const _Category('Coding')),
)
@@ -575,6 +594,7 @@ class _StoreNav extends StatelessWidget {
required this.categories,
required this.selectedCategory,
required this.hasProduct,
+ required this.sessionCount,
required this.counts,
required this.onSelect,
});
@@ -583,6 +603,7 @@ class _StoreNav extends StatelessWidget {
final List<String> categories;
final String? selectedCategory;
final bool hasProduct;
+ final int sessionCount;
final Map<String, int> counts;
final ValueChanged<_Shelf> onSelect;
@@ -616,6 +637,15 @@ class _StoreNav extends StatelessWidget {
selected: !hasProduct && shelf is _All,
onTap: () => onSelect(const _All()),
),
+ if (sessionCount > 0 || shelf is _Sessions)
+ SidebarItem(
+ key: const ValueKey('store-shelf-sessions'),
+ icon: LucideIcons.play300,
+ label: 'Featured',
+ tooltip: '$sessionCount recorded sessions',
+ selected: !hasProduct && shelf is _Sessions,
+ onTap: () => onSelect(const _Sessions()),
+ ),
const SizedBox(height: 22),
Padding(
padding: const EdgeInsets.fromLTRB(10, 0, 10, 10),
diff --git a/desktop/lib/store/store_sessions.dart b/desktop/lib/store/store_sessions.dart
new file mode 100644
index 000000000..8c20af024
--- /dev/null
+++ b/desktop/lib/store/store_sessions.dart
@@ -0,0 +1,298 @@
+import 'package:flutter/material.dart';
+import 'package:lucide_icons_flutter/lucide_icons.dart';
+
+import '../shared/theme/app_theme.dart' as grid;
+import '../terminal/terminal_text.dart';
+import 'store_collections.dart';
+import 'store_demo_dialog.dart';
+import 'store_editorial.dart';
+import 'store_listing.dart';
+
+/// A permanent way to browse the catalog's recordings, including sessions that
+/// arrive after this desktop release. The same cards lead Discover.
+class StoreSessions extends StatelessWidget {
+ const StoreSessions({
+ super.key,
+ required this.sessions,
+ required this.onOpen,
+ });
+
+ final List<StoreSession> sessions;
+ final ValueChanged<String> onOpen;
+
+ @override
+ Widget build(BuildContext context) {
+ grid.AppTheme.watch(context);
+ TerminalFontScope.watch(context);
+ return LayoutBuilder(
+ builder: (context, box) => SingleChildScrollView(
+ key: const PageStorageKey('store-sessions-scroll'),
+ padding: EdgeInsets.all(box.maxWidth < 680 ? 20 : 36),
+ child: Center(
+ child: ConstrainedBox(
+ constraints: const BoxConstraints(maxWidth: 1440),
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.stretch,
+ children: [
+ Text(
+ 'Featured harnesses',
+ style: grid.AppType.display(
+ color: grid.AppPalette.textPrimary,
+ ),
+ ),
+ const SizedBox(height: 12),
+ Text(
+ sessions.isEmpty
+ ? 'Recorded sessions will appear here when they are available in your catalog.'
+ : '${sessions.length} harnesses to explore. Watch a real session, then try the same prompt.',
+ style: grid.AppType.body(
+ height: 1.5,
+ color: grid.AppPalette.textSecondary,
+ ),
+ ),
+ const SizedBox(height: 24),
+ StoreSessionGrid(sessions: sessions, onOpen: onOpen),
+ ],
+ ),
+ ),
+ ),
+ ),
+ );
+ }
+}
+
+class StoreSessionGrid extends StatelessWidget {
+ const StoreSessionGrid({
+ super.key,
+ required this.sessions,
+ required this.onOpen,
+ });
+
+ final List<StoreSession> sessions;
+ final ValueChanged<String> onOpen;
+
+ @override
+ Widget build(BuildContext context) {
+ return LayoutBuilder(
+ builder: (context, box) {
+ final scale = grid.appTextScaleOf(context);
+ final columns = (box.maxWidth / (300 * scale)).floor().clamp(1, 3);
+ final width = (box.maxWidth - (columns - 1) * 20) / columns;
+ return Wrap(
+ spacing: 20,
+ runSpacing: 20,
+ children: [
+ for (final session in sessions)
+ SizedBox(
+ width: width,
+ child: _SessionCard(
+ key: ValueKey('store-session:${session.entry.id}'),
+ session: session,
+ onOpen: () => onOpen(session.entry.id),
+ ),
+ ),
+ ],
+ );
+ },
+ );
+ }
+}
+
+class _SessionCard extends StatelessWidget {
+ const _SessionCard({super.key, required this.session, required this.onOpen});
+
+ final StoreSession session;
+ final VoidCallback onOpen;
+
+ @override
+ Widget build(BuildContext context) {
+ grid.AppTheme.watch(context);
+ TerminalFontScope.watch(context);
+ final (:entry, :example) = session;
+ final scale = grid.appTextScaleOf(context);
+ final radius = BorderRadius.circular(16);
+ return DecoratedBox(
+ decoration: BoxDecoration(
+ borderRadius: radius,
+ border: Border.all(color: grid.AppPalette.divider),
+ ),
+ child: Material(
+ color: grid.AppPalette.panelBg,
+ borderRadius: radius,
+ clipBehavior: Clip.antiAlias,
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.stretch,
+ children: [
+ Semantics(
+ label: 'Watch ${entry.name} recorded session',
+ button: true,
+ child: AspectRatio(
+ aspectRatio: 16 / 10,
+ child: Stack(
+ fit: StackFit.expand,
+ children: [
+ // Use this recording's own poster, never generic cover art.
+ Image.network(
+ example.image!,
+ fit: BoxFit.contain,
+ excludeFromSemantics: true,
+ frameBuilder: (_, child, frame, _) => frame == null
+ ? _PosterFallback(session: session)
+ : child,
+ errorBuilder: (_, _, _) =>
+ _PosterFallback(session: session, failed: true),
+ ),
+ Positioned(
+ left: 12,
+ bottom: 12,
+ child: ExcludeSemantics(
+ child: DecoratedBox(
+ decoration: BoxDecoration(
+ color: const Color(0xe6111316),
+ borderRadius: BorderRadius.circular(20),
+ ),
+ child: Padding(
+ padding: const EdgeInsets.symmetric(
+ horizontal: 12,
+ vertical: 8,
+ ),
+ child: Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ const Icon(
+ LucideIcons.play300,
+ size: 15,
+ color: Colors.white,
+ ),
+ const SizedBox(width: 8),
+ Text(
+ 'Watch session',
+ style: grid.AppType.monoLabel(
+ color: Colors.white,
+ ),
+ ),
+ ],
+ ),
+ ),
+ ),
+ ),
+ ),
+ Positioned.fill(
+ child: Material(
+ type: MaterialType.transparency,
+ child: InkWell(
+ key: ValueKey('store-session-watch:${entry.id}'),
+ focusColor: grid.AppPalette.accentOnSurface
+ .withValues(alpha: .20),
+ hoverColor: grid.AppPalette.accentOnSurface
+ .withValues(alpha: .08),
+ onTap: () => showStoreDemo(
+ context,
+ entry: entry,
+ example: example,
+ ),
+ ),
+ ),
+ ),
+ ],
+ ),
+ ),
+ ),
+ Padding(
+ padding: const EdgeInsets.fromLTRB(16, 16, 16, 10),
+ child: Column(
+ crossAxisAlignment: CrossAxisAlignment.start,
+ children: [
+ Row(
+ children: [
+ StoreAppIcon(entry: entry, size: 24),
+ const SizedBox(width: 8),
+ Expanded(
+ child: Text(
+ entry.name,
+ style: grid.AppType.label(
+ color: grid.AppPalette.textPrimary,
+ ),
+ ),
+ ),
+ const SizedBox(width: 8),
+ Flexible(
+ child: Text(
+ entry.category ?? storeCategoryFor(entry),
+ textAlign: TextAlign.end,
+ style: grid.AppType.monoMeta(
+ color: grid.AppPalette.textFaint,
+ ),
+ ),
+ ),
+ ],
+ ),
+ const SizedBox(height: 14),
+ SizedBox(
+ height: 60 * scale,
+ child: Text(
+ entry.tagline ??
+ entry.description ??
+ 'See what you can make with ${entry.name}.',
+ maxLines: 3,
+ overflow: TextOverflow.ellipsis,
+ style: grid.AppType.heading(
+ height: 1.3,
+ color: grid.AppPalette.textPrimary,
+ ),
+ ),
+ ),
+ const SizedBox(height: 8),
+ SizedBox(
+ height: 51 * scale,
+ child: Text(
+ example.caption ?? 'A recorded session. Open the harness for the prompt and more examples.',
+ maxLines: 3,
+ overflow: TextOverflow.ellipsis,
+ style: grid.AppType.body(
+ height: 1.3,
+ color: grid.AppPalette.textSecondary,
+ ),
+ ),
+ ),
+ TextButton.icon(
+ key: ValueKey('store-session-open:${entry.id}'),
+ onPressed: onOpen,
+ style: TextButton.styleFrom(
+ foregroundColor: grid.AppPalette.accentOnSurface,
+ ),
+ iconAlignment: IconAlignment.end,
+ icon: const Icon(LucideIcons.arrowRight300, size: 15),
+ label: const Text('Explore harness'),
+ ),
+ ],
+ ),
+ ),
+ ],
+ ),
+ ),
+ );
+ }
+}
+
+class _PosterFallback extends StatelessWidget {
+ const _PosterFallback({required this.session, this.failed = false});
+
+ final StoreSession session;
+ final bool failed;
+
+ @override
+ Widget build(BuildContext context) => Center(
+ child: Column(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ StoreAppIcon(entry: session.entry, size: 48),
+ const SizedBox(height: 12),
+ Text(
+ failed ? 'Preview unavailable' : 'Recorded session',
+ style: grid.AppType.caption(color: grid.AppPalette.textSecondary),
+ ),
+ ],
+ ),
+ );
+}
diff --git a/desktop/test/store_collections_test.dart b/desktop/test/store_collections_test.dart
index 0b20f6b56..6065f84cc 100644
--- a/desktop/test/store_collections_test.dart
+++ b/desktop/test/store_collections_test.dart
@@ -14,6 +14,90 @@ StoreRating _rating(String id, double average, int count) => StoreRating(
);
void main() {
+ test(
+ 'recordings come from live examples, including new community harnesses',
+ () {
+ const recording = StoreExample(
+ prompt: 'Make a playable scene.',
+ image: 'https://example.com/scene.png',
+ video: 'https://example.com/scene.mp4',
+ );
+ final entries = [
+ for (final (id, kind, category, examples) in [
+ (
+ 'community/new-game',
+ 'agent',
+ 'Games',
+ [
+ const StoreExample(prompt: 'An older example.'),
+ recording,
+ recording,
+ ],
+ ),
+ ('community/another-game', 'agent', 'Games', [recording]),
+ ('community/z-music', 'agent', 'Music', [recording]),
+ (
+ 'community/still',
+ 'agent',
+ '3D',
+ [
+ const StoreExample(
+ prompt: 'A picture.',
+ image: 'https://example.com/still.png',
+ ),
+ ],
+ ),
+ (
+ 'community/no-poster',
+ 'agent',
+ '3D',
+ [
+ const StoreExample(
+ prompt: 'A movie.',
+ video: 'https://example.com/movie.mp4',
+ ),
+ ],
+ ),
+ (
+ 'community/insecure',
+ 'agent',
+ '3D',
+ [
+ const StoreExample(
+ prompt: 'A movie.',
+ image: 'https://example.com/still.png',
+ video: 'http://example.com/movie.mp4',
+ ),
+ ],
+ ),
+ ('community/viewer', 'viewer', 'Games', [recording]),
+ ('engine', 'engine', 'Code', [recording]),
+ ])
+ DshEntry(
+ id: id,
+ name: id,
+ engine: 'codex',
+ kind: kind,
+ category: category,
+ examples: examples,
+ ),
+ ];
+ final sessions = storeRecordedSessions(entries);
+ expect(sessions.map((session) => session.entry.id), [
+ 'community/another-game',
+ 'community/z-music',
+ 'community/new-game',
+ ]);
+ expect(sessions.last.example, same(recording));
+ expect(storeRecordedSessions(entries.reversed), sessions);
+ expect(
+ storeRecordedSessions([entries.first]).single.entry,
+ entries.first,
+ );
+ expect(storeRecordedSessions([]), isEmpty);
+ },
+ );
+
test('recent collection uses publication history and live membership', () {
final entries = [
_entry('autonomous/blender'),
@@ -22,8 +106,8 @@ void main() {
_entry('autonomous/cad-viewer', kind: 'viewer'),
];
expect(storeRecentlyUpdated(entries).map((e) => e.id), [
- 'autonomous/machine-monitor',
'autonomous/blender',
+ 'autonomous/machine-monitor',
]);
// A known package must not leak into another machine's smaller catalog.
expect(storeRecentlyUpdated([entries.first]).map((e) => e.id), [
diff --git a/desktop/test/store_discover_test.dart b/desktop/test/store_discover_test.dart
index a97d61c8f..90d27c1a3 100644
--- a/desktop/test/store_discover_test.dart
+++ b/desktop/test/store_discover_test.dart
@@ -19,6 +19,7 @@ import 'package:harness/widgets/agent_picker.dart';
import 'package:harness/widgets/engine_identity.dart';
import 'package:harness/state/app_state.dart';
import 'package:harness/store/store_controller.dart';
+import 'package:harness/store/store_demo_dialog.dart';
import 'package:harness/store/store_cover_art.dart';
import 'package:harness/store/store_explore_widgets.dart';
import 'package:harness/store/store_editorial.dart';
@@ -26,6 +27,7 @@ import 'package:harness/store/store_exploration.dart';
import 'package:harness/store/store_featured_art.dart';
import 'package:harness/store/store_models.dart';
import 'package:harness/store/store_screen.dart';
+import 'package:webview_flutter/webview_flutter.dart';
import 'support/real_fonts.dart';
@@ -88,6 +90,44 @@ List<DshEntry> _listedCatalog() => [
)!,
];
+List<DshEntry> _recordedCatalog() => [
+ for (final item
+ in jsonDecode(File('../store/hands-on.json').readAsStringSync()) as List)
+ DshEntry.fromJson({
+ ...jsonDecode(
+ File('../store/agents/${item['id']}/harness.json').readAsStringSync(),
+ ) as Map<String, dynamic>,
+ ...jsonDecode(
+ File('../store/agents/${item['id']}/store.json').readAsStringSync(),
+ ) as Map<String, dynamic>,
+ })!,
+];
+
+// Seed NetworkImage's cache with the exact published posters for visual review.
+// No replacement art, network connection or production account is needed.
+Future<void> _cacheRecordingPosters(
+ WidgetTester tester,
+ List<DshEntry> entries,
+) async {
+ await tester.runAsync(() async {
+ for (final entry in entries) {
+ final url = entry.examples.first.image!;
+ final path = Uri.parse(url).path.split('/main/').last;
+ final codec = await ui.instantiateImageCodec(
+ await File('../$path').readAsBytes(),
+ );
+ final frame = await codec.getNextFrame();
+ PaintingBinding.instance.imageCache.putIfAbsent(
+ NetworkImage(url),
+ () => OneFrameImageStreamCompleter(
+ Future.value(ImageInfo(image: frame.image)),
+ ),
+ );
+ codec.dispose();
+ }
+ });
+}
+
class _App extends AppNotifier {
_App()
: super(
@@ -99,6 +139,11 @@ class _App extends AppNotifier {
Future<void> probeDsh(String machineId, {bool force = false}) async {}
@override
Future<void> probeEngines(String machineId, {bool force = false}) async {}
+
+ void publishCatalog(List<DshEntry> entries) {
+ localMachineState!.dsh.replace(entries);
+ notifyListeners();
+ }
}
class _Api implements StoreApi {
@@ -507,6 +552,197 @@ void main() {
.load();
});
+ for (final (width, scale, brightness) in [
+ (1440.0, 1.0, Brightness.dark),
+ (1440.0, 1.0, Brightness.light),
+ (760.0, 1.5, Brightness.dark),
+ ]) {
+ testWidgets('recorded discovery fits $width at $scale in ${brightness.name}', (
+ tester,
+ ) async {
+ final entries = _recordedCatalog();
+ await _cacheRecordingPosters(tester, entries);
+ final (_, key) = await _open(
+ tester,
+ entries: entries,
+ width: width,
+ height: 1080,
+ scale: scale,
+ brightness: brightness,
+ );
+ expect(find.text('Featured harnesses'), findsOneWidget);
+ expect(find.text('See all 8'), findsOneWidget);
+ expect(find.byType(StoreFeaturedArt), findsNothing);
+ expect(find.byType(WebViewWidget), findsNothing);
+ for (final entry in entries) {
+ final card = find.byKey(ValueKey('store-session:${entry.id}'));
+ if (card.evaluate().isEmpty) continue;
+ final poster = tester.widget<Image>(
+ find.descendant(
+ of: card,
+ matching: find.byWidgetPredicate(
+ (widget) => widget is Image && widget.image is NetworkImage,
+ ),
+ ),
+ );
+ expect((poster.image as NetworkImage).url, entry.examples.first.image);
+ expect(poster.fit, BoxFit.contain);
+ }
+ await _capture(
+ tester,
+ key,
+ 'featured-${width.toInt()}-${brightness.name}-${scale.toStringAsFixed(1)}',
+ );
+ await tester.tap(find.text('See all 8'));
+ await tester.pumpAndSettle();
+ for (final entry in entries) {
+ expect(
+ find.byKey(ValueKey('store-session:${entry.id}')),
+ findsOneWidget,
+ );
+ expect(find.text(entry.examples.first.caption!), findsOneWidget);
+ }
+ expect(
+ tester
+ .widget<SidebarItem>(
+ find.byKey(const ValueKey('store-shelf-sessions')),
+ )
+ .selected,
+ isTrue,
+ );
+ await _capture(
+ tester,
+ key,
+ 'featured-all-${width.toInt()}-${brightness.name}-${scale.toStringAsFixed(1)}',
+ );
+ expect(tester.takeException(), isNull);
+ });
+ }
+
+ testWidgets('featured recordings play on demand and open the right harness', (
+ tester,
+ ) async {
+ final entries = _recordedCatalog();
+ final (app, _) = await _open(tester, entries: entries);
+ final initialSwarms = app.swarms.length;
+ expect(find.byType(StoreDemoDialog), findsNothing);
+ await tester.tap(
+ find.byKey(const ValueKey('store-session-watch:autonomous/blender')),
+ );
+ await tester.pumpAndSettle();
+ final dialog = tester.widget<StoreDemoDialog>(find.byType(StoreDemoDialog));
+ final example = entries
+ .singleWhere((entry) => entry.id == 'autonomous/blender')
+ .examples
+ .first;
+ expect(dialog.video, example.video);
+ expect(dialog.caption, example.caption);
+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);
+ await tester.pumpAndSettle();
+ expect(find.byType(StoreDemoDialog), findsNothing);
+ await tester.tap(
+ find.byKey(const ValueKey('store-session-open:autonomous/blender')),
+ );
+ await tester.pumpAndSettle();
+ expect(
+ find.byKey(const ValueKey('store-page:autonomous/blender')),
+ findsOneWidget,
+ );
+ expect(find.text('“${example.prompt}”'), findsOneWidget);
+ expect(app.swarms.length, initialSwarms);
+ await tester.tap(find.byKey(const ValueKey('store-back')));
+ await tester.pumpAndSettle();
+ expect(find.text('Featured harnesses'), findsOneWidget);
+ await tester.tap(find.text('See all 8'));
+ await tester.pumpAndSettle();
+ await tester.ensureVisible(
+ find.byKey(const ValueKey('store-session-open:autonomous/rdkit')),
+ );
+ await tester.tap(
+ find.byKey(const ValueKey('store-session-open:autonomous/rdkit')),
+ );
+ await tester.pumpAndSettle();
+ expect(
+ find.byKey(const ValueKey('store-page:autonomous/rdkit')),
+ findsOneWidget,
+ );
+ await tester.tap(find.byKey(const ValueKey('store-back')));
+ await tester.pumpAndSettle();
+ expect(
+ tester
+ .widget<SidebarItem>(
+ find.byKey(const ValueKey('store-shelf-sessions')),
+ )
+ .selected,
+ isTrue,
+ );
+ expect(
+ find.byKey(const ValueKey('store-session:autonomous/rdkit')),
+ findsOneWidget,
+ );
+ expect(tester.takeException(), isNull);
+ });
+
+ testWidgets(
+ 'featured shelf follows catalog publications and removals while open',
+ (tester) async {
+ final (app, _) = await _open(tester, entries: _recordedCatalog());
+ await tester.tap(find.text('See all 8'));
+ await tester.pumpAndSettle();
+ const newcomer = DshEntry(
+ id: 'community/after-release',
+ name: 'After release',
+ engine: 'codex',
+ examples: [
+ StoreExample(
+ prompt: 'Make a new thing.',
+ image: 'https://example.com/new-poster.png',
+ video: 'https://example.com/new-recording.mp4',
+ ),
+ ],
+ );
+ app.publishCatalog([newcomer]);
+ await tester.pumpAndSettle();
+ expect(
+ find.byKey(const ValueKey('store-session:community/after-release')),
+ findsOneWidget,
+ );
+ expect(
+ find.byKey(const ValueKey('store-session:autonomous/blender')),
+ findsNothing,
+ );
+ // Failed remote artwork keeps the recording and detail actions usable.
+ expect(find.text('Preview unavailable'), findsOneWidget);
+ expect(
+ find.byKey(
+ const ValueKey('store-session-watch:community/after-release'),
+ ),
+ findsOneWidget,
+ );
+ await tester.tap(
+ find.byKey(
+ const ValueKey('store-session-open:community/after-release'),
+ ),
+ );
+ await tester.pumpAndSettle();
+ expect(
+ find.byKey(const ValueKey('store-page:community/after-release')),
+ findsOneWidget,
+ );
+ await tester.tap(find.byKey(const ValueKey('store-back')));
+ await tester.pumpAndSettle();
+ app.publishCatalog([]);
+ await tester.pumpAndSettle();
+ expect(
+ find.text(
+ 'Recorded sessions will appear here when they are available in your catalog.',
+ ),
+ findsOneWidget,
+ );
+ expect(tester.takeException(), isNull);
+ },
+ );
+
testWidgets(
'search is ready on arrival and stays at the top while browsing',
(tester) async {
@@ -581,11 +817,15 @@ void main() {
engine: 'codex',
tagline: 'Turn observations into pictures.',
examples: [
- StoreExample(prompt: 'Visualize rainfall over the last decade.'),
+ StoreExample(
+ prompt: 'Visualize rainfall over the last decade.',
+ caption: 'Monsoon seasons in Sri Lanka',
+ ),
],
);
expect(storeMatches(entry, 'rainfall decade'), isTrue);
expect(storeMatches(entry, 'observations'), isTrue);
+ expect(storeMatches(entry, 'monsoon sri lanka'), isTrue);
expect(storeMatches(entry, 'rainfall circuit'), isFalse);
});
diff --git a/desktop/test/store_viewers_test.dart b/desktop/test/store_viewers_test.dart
index f4c1236a5..6e6d9e3be 100644
--- a/desktop/test/store_viewers_test.dart
+++ b/desktop/test/store_viewers_test.dart
@@ -173,6 +173,7 @@ void main() {
await _show(
tester,
StoreDiscover(
+ onSessions: () {},
entries: const [
DshEntry(
id: 'autonomous/strudel',
diff --git a/store/README.md b/store/README.md
index 74712f5d8..10c2f44d5 100644
--- a/store/README.md
+++ b/store/README.md
@@ -154,6 +154,16 @@ whole native pane, and stops when the recording closes. Older clients keep showi
and picture. The eight hands-on recordings reuse their original PNG/MP4 assets in `docs/images/`
rather than the JPEG convention above.
+Recordings also lead the desktop Store's **Discover** page under **Featured harnesses**
+and appear on the **Featured** shelf.
+To join that collection, publish an example with both an HTTPS `image` poster and an HTTPS
+`video`. The first complete recording per harness is used; the card shows the harness's
+`tagline` and the recording's `caption`, with Watch session and Explore harness actions.
+Use the caption to identify the actual result and any demo limitations. The Discover preview
+mixes disciplines and links to the full collection; new catalog recordings join automatically
+on clients with this discovery UI. No per-harness desktop artwork or ID list is needed.
+Example prompts and captions are searchable too.
+
The matching recorded prompts and captions live in `hands-on.json` under `demo`. Run
`node store/tools/hands-on.mjs --sync-store` to place each recording first in its harness's
examples, preserving the others. `--check` verifies the pairs and local assets. Suggested