@homie-rocks/studio 0.58.16 → 0.58.18

package/CHANGELOG.md

@@ -17,6 +17,16 @@ To bring a studio up to date, tell Claude: "Upgrade my studio to the newest Homi
 `npx -y @homie-rocks/studio@latest upgrade`, which shows what's new since the version your studio pins (from this
 file) and what the upgrade would change, and changes nothing until you agree.
 
+## [0.58.18] - 2026-10-21
+
+**Plugin 0.58.12**
+
+Docs and tool descriptions describe the toolkit as it is today.
+
+### Changed
+
+- Docs and tool descriptions describe the toolkit as it is today. The worker's adapter for a media binding a studio's host provides (`HOMIE_MEDIA`) is `worker/host-media.mjs`; it behaves as before.
+
 ## [0.58.16] - 2026-10-21
 
 **Plugin 0.58.10**
@@ -26,7 +36,7 @@ A failed deploy says what Cloudflare or the host actually refused.
 ### Fixed
 
 - A failed deploy whose Worker uses a queue no longer says the token needs Account > Queues > Edit unless Cloudflare refused a Queues request for authentication. Any other failure, an asset upload for one, now shows Wrangler's own error.
-- When the host refuses a database call during a deploy, the reason it gives (for example "A routine does not publish the live site: the owner does.") now shows after "D1 migrations failed" instead of being cut off by Wrangler's closing lines. The same goes for creating the database and registering the studio's functions.
+- When the host refuses a database call during a deploy, the reason it gives (for example that this deploy may not write to the live database) now shows after "D1 migrations failed" instead of being cut off by Wrangler's closing lines. The same goes for creating the database and registering the studio's functions.
 
 ## [0.58.15] - 2026-10-20
 
@@ -71,7 +81,7 @@ Every browser the toolkit opens can be a cloud browser, and a studio worked on a
 ### Added
 
 - Every command and skill that opens a browser (check, playtest, look, perf, shoot, lab check, port check, crowd load, 3D renders, art captures and video takes) can use a browser in the cloud (in 0.58.11 only check and the playtest script could): with `HOMIE_BROWSER_WS_ENDPOINT` set to a CDP WebSocket address (Cloudflare Browser Run, for example), they connect to it instead of starting Chrome on this computer. A platform target leaves queues and cron triggers to the platform.
-- A host that runs the toolkit away from the person's screen (Homie Managed's studio workspace, a cloud dev box) can name the address of the studio's private preview in `HOMIE_PREVIEW_URL`. For a studio whose studio.json has a preview target (`cloudflare.preview`), the local MCP server's `preview_run` then puts the build there (`deploy --preview`) and gives that address, `check` and `playtest` put the current build there and open it, and `preview_stop` has nothing to stop. Without it, the site runs on this computer as before.
+- A host that runs the toolkit away from the person's screen (a hosted studio workspace or a cloud dev box) can name the address of the studio's private preview in `HOMIE_PREVIEW_URL`. For a studio whose studio.json has a preview target (`cloudflare.preview`), the local MCP server's `preview_run` then puts the build there (`deploy --preview`) and gives that address, `check` and `playtest` put the current build there and open it, and `preview_stop` has nothing to stop. Without it, the site runs on this computer as before.
 
 ## [0.58.11] - 2026-10-19
 
@@ -81,10 +91,10 @@ Host a studio on Workers for Platforms with a private preview, check it with a b
 
 ### Added
 
-- A studio can deploy to a Workers for Platforms dispatch namespace: `cloudflare.dispatchNamespace`, `worker`, `d1Id` and `domain` in studio.json name the preprovisioned Worker, and `homie-studio deploy` sends the build there with Wrangler's own `--dispatch-namespace`. `cloudflare.preview` names a second Worker and database, and `homie-studio deploy --preview` sends the same build to it. A platform that hosts studios this way (Homie Managed) enforces the target at its API boundary.
+- A studio can deploy to a Workers for Platforms dispatch namespace: `cloudflare.dispatchNamespace`, `worker`, `d1Id` and `domain` in studio.json name the preprovisioned Worker, and `homie-studio deploy` sends the build there with Wrangler's own `--dispatch-namespace`. `cloudflare.preview` names a second Worker and database, and `homie-studio deploy --preview` sends the same build to it. A platform that deploys studios this way enforces the target at its own API boundary.
 - `homie-studio check` and the playtest script can use a browser in the cloud: with `HOMIE_BROWSER_WS_ENDPOINT` set to a CDP WebSocket address (Cloudflare Browser Run, for example), they connect to it instead of starting Chrome on this computer.
 - `homie-studio drain on|off|status` pauses new room admissions without deploying or closing existing sockets. A move waits for empty rooms and delivered records before freezing the source.
-- Managed media bindings preserve streamed media, range requests and large player saves.
+- A media binding the studio's host provides (`HOMIE_MEDIA`) preserves streamed media, range requests and large player saves.
 - A read-only switch for a studio: `homie-studio read-only on|off|status` (and the local MCP tool `studio_read_only`) freezes the live studio for a few minutes, for a move to another host or maintenance, without losing anything. It sets the Worker secret `STUDIO_READ_ONLY` with the studio's own Cloudflare sign-in, as a new Worker version. While on, changes answer 503 with `Retry-After` and `x-studio-read-only: 1`; pages, games, live rooms and the Stripe webhook keep working, D1 takes no other write, room records wait in each room, scheduled and queued work waits, and `/api/games` reports `readOnly`.
 
 ### Fixed

package/guides/game/SKILL.md

@@ -46,13 +46,13 @@ Cloudflare or physical-phone capacity guarantees.
 ## Start it
 
 - **Look for pieces before writing them.** Games build on each other by sharing parts: a creature from one game,
-  Search by system (touch controls, feedback, sound, scoring, title and results UI, rooms), not only by genre. Add a fitting result with `part_add` before implementing a replacement; import and use it in the game. A starter or npm package is not a catalog search. Record part version, source game/studio, licence and integration in CODEX **Built from**, or the search and concrete gap if nothing fits. In managed studios these same tools work; wait for the committed preview through `build_progress` after adding a part.
-
   a level from another, a bot brain from a third. For each system the game needs (camera, movement, bots, pickups,
   effects, sound, UI, environment), before writing it from scratch:
   - check the `@homie-rocks/*` packages (npm) for the general mechanism: camera, input, audio, effects;
   - run `parts_find` for pieces other studios shared, and bring one in with `part_add`.
 
+  Search by system (touch controls, feedback, sound, scoring, title and results UI, rooms), not only by genre. Add a fitting result with `part_add` before implementing a replacement; import and use it in the game. A starter or npm package is not a catalog search. Record part version, source game/studio, licence and integration in CODEX **Built from**, or the search and concrete gap if nothing fits. In a hosted workspace these same tools work; after `part_add`, wait for the committed preview through `build_progress`.
+
   Record both in the game's CODEX (Built from) and its credits: what came from where, and what you wrote here and
   why. After building a piece another game could use, offer to make it a part (`part_new`) and, only if the person
   asks, to share it (`part_share`). The `parts` skill has the method.

package/lib/mcp-tools.mjs

@@ -462,7 +462,7 @@ async function startRun(ctx, root, { kind, game, title, steps }) {
 
 /**
  * WHERE "HERE" IS, FOR A HOST AWAY FROM THE PERSON'S SCREEN. A platform that runs this toolkit for the person in a
- * workspace of its own (Homie Managed's studio workspace, a cloud dev box) has no browser beside it that can open
+ * workspace of its own (a hosted studio workspace or a cloud dev box) has no browser beside it that can open
  * this computer's addresses. It names the address its studio's private preview is reachable at, HOMIE_PREVIEW_URL,
  * and the studio's studio.json names that preview's Workers for Platforms target (cloudflare.preview). Then the
  * studio's site "here" is that preview: preview_run puts the build there (deploy --preview), and check and playtest

package/lib/template-history.json

@@ -4680,6 +4680,48 @@
      }
     }
    }
+  },
+  "0.58.18": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "1dbdf22c03a1e505",
+    "site/src/worker.mjs": "6cc5c6131eaf6fd0"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "af7f2f732505d379",
+     "## Version-matched authoring guides": "f6261a0e5801b96b",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "c10aa0441ea89702",
+     "## Commands (all through the pinned CLI in node_modules)": "c20d90de21cde0c7",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "bb715272fd1a615b",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "1ccfd549d2369a60",
+     "## Selling things (the shop)": "0df5a5fe1833c624",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "b2234d80f6cbe71d",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "8364e05cebefcba4"
+      }
+     }
+    }
+   }
   }
  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.58.16",
+  "version": "0.58.18",
   "description": "A studio for games, music and video on its own Cloudflare: scaffold, multiplayer starters on the netplay contract, a port toolkit that makes existing single-player web games multiplayer, the site Worker with public rooms (Table/Lobby Durable Objects and D1, all on the free Workers plan, no payment method), a site with the hub's sections (Home, Games, Music, Videos, Rooms, Posts with feeds) in the studio's own look, an epic landing page for every game, big songs and videos in the studio's own R2 once it has storage (uploaded, checked by SHA-256, served at the same addresses), deploy, and the homie.rocks directory.",
   "type": "module",
   "license": "Apache-2.0",

package/worker/build-id.mjs

@@ -1,2 +1,2 @@
 // Generated by lib/build-identity.mjs; identifies the bundled runtime sources.
-export const STUDIO_BUILD = Object.freeze({"version":"0.58.16","sha256":"b981661e89026fb01e4ebd4e0cc06a403b0f90a5b22cf07d3425afcf6f99b075"});
+export const STUDIO_BUILD = Object.freeze({"version":"0.58.18","sha256":"333254a4a029de3f655b1689480b580903801f14cc0d9e6ea99f2bac4b9e5c7f"});

package/worker/{managed-media.mjs → host-media.mjs}

@@ -1,4 +1,4 @@
-/** Hydrate the R2-compatible metadata returned by the studio-scoped managed binding.
+/** Hydrate the R2-compatible metadata returned by the studio-scoped media binding its host provides (HOMIE_MEDIA).
  * Streams cross RPC without buffering songs, videos or saves in the Worker heap. */
 function object(value) {
  if(!value)return null;
@@ -9,7 +9,7 @@ function object(value) {
   json:()=>new Response(value.body).json(),
  };
 }
-export function managedMedia(env) {
+export function hostMedia(env) {
  if(!env.HOMIE_MEDIA)return env;
  const binding=env.HOMIE_MEDIA;
  return {...env,MEDIA:{get:async(key,options)=>object(await binding.get(key,options)),head:async key=>object(await binding.head(key)),put:async(key,body,options)=>object(await binding.put(key,body,options)),delete:keys=>binding.delete(keys)}};

package/worker/index.mjs

@@ -1,5 +1,5 @@
 import {drainSince,isAdmission,drainResponse} from './move-drain.mjs';
-import {managedMedia} from './managed-media.mjs';
+import {hostMedia} from './host-media.mjs';
 /** Studio Worker event boundaries and public toolkit exports. */
 import { catalogue } from './catalogue.mjs';
 import {trackBackground,requestDatabase,MUTATION_VERSION} from './request-db.mjs';
@@ -66,7 +66,7 @@ export default {
     await Promise.all([maintenance,analytics]);
   },
   async fetch(request, env, ctx) {
-    env=managedMedia(env);
+    env=hostMedia(env);
     if(isAdmission(request)&&await drainSince(env))return drainResponse();
     const staticPath=new URL(request.url).pathname;
     if(['GET','HEAD'].includes(request.method)&&staticPath==='/_homie/site.js')return finish(await route(request,env,ctx),staticPath);

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.58.16';
+export const STUDIO_VERSION_TAG = '0.58.18';