@supersuit/session-player 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.7.0 (2026-10-11)
+
+- A recast spec may state `device` (`iphone` or `macbook`) when the source could not tell where the real session ran. A Remote Control or SDK session reads the same from a Mac and a phone, so the converter leaves `device` unset and Auto drew an iPhone for a session that really ran on a MacBook (Callum's case study). The spec wins over the source; without it the source's device is kept, as before.
+- `@supersuit/session-player/playback` exports `summarize` and `duration`, so a host page can print the measured who-did-what beside the player without importing the converter.
+
 ## 0.6.0 (2026-10-11)
 
 - **Transparent by default** (Gary, 2026-10-11: "render with NO background colour ... so it sits on any site"). Nothing is painted outside the device frame; the frame and the screen keep their own backgrounds. A host that wants one passes `background` (prop or tag attribute) or `?bg=` on the embed URL: any CSS colour, or `theme` for the player's cream. A value that is not a colour is ignored.

package/README.md

@@ -60,7 +60,7 @@ simulator serve album.json            # watch it at http://127.0.0.1:4460/
 | `artifacts[]` | `{ id, kind: file \| link \| other, title, path \| url, turn, at }` |
 | `cuts[]` | `{ turn, what, reason }`: every edit, so nothing is changed silently |
 
-`device` (optional) is where the real session ran: `iphone` or `macbook`. The converter sets `macbook` when the person typed into a terminal (or the desktop app) on a Mac, and leaves it out when it cannot tell (Remote Control and SDK sessions); a scenario without it is shown as an iPhone.
+`device` (optional) is where the real session ran: `iphone` or `macbook`. The converter sets `macbook` when the person typed into a terminal (or the desktop app) on a Mac, and leaves it out when it cannot tell (Remote Control and SDK sessions); a scenario without it is shown as an iPhone. Because unset can mean either, whoever ran the session should state it: `convert --device`, or `device` in a recast spec (0.7.0), which overrides the source.
 
 `intervention` is one of `null`, `redirect`, `correct`, `approve`, `decide`. The converter sets only `redirect`; the rest are set by the person reviewing the draft.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersuit/session-player",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Plays recorded agent sessions (case studies) on a simulated phone or MacBook: a scenario format, a converter from Claude Code transcripts, and a React player anyone can step into.",
   "type": "module",
   "bin": {
@@ -12,7 +12,8 @@
     "./player": "./src/player.mjs",
     "./embed": "./src/embed.mjs",
     "./package.json": "./package.json",
-    "./loader.js": "./src/loader.js"
+    "./loader.js": "./src/loader.js",
+    "./playback": "./src/playback.mjs"
   },
   "files": [
     "bin/",

package/src/recast.mjs

@@ -27,8 +27,14 @@ const where = (sc, obj) => sc.turns.find((t) => t.human === obj || t.steps.some(
 
 import { allImages } from './scenario.mjs';
 
-export function recast(source, { id, title, persona, keep, replace = [], forbid = [], images = {}, close, highlight = {} }) {
+export function recast(source, { id, title, persona, keep, replace = [], forbid = [], images = {}, close, highlight = {}, device }) {
   const sc = structuredClone(source);
+  // Where the real session ran, when the source could not say (0.7.0): a Remote Control or SDK
+  // session reads the same from a Mac and from a phone, so the person who ran it states it here.
+  if (device != null) {
+    if (!['iphone', 'macbook'].includes(device)) throw new Error(`device must be iphone or macbook, got ${JSON.stringify(device)}`);
+    sc.device = device;
+  }
   const cuts = [];
   if (keep) {
     const kept = new Set(keep);