gamesteel 0.4.0 → 0.4.1

package/dist/gamesteel.js

@@ -64163,12 +64163,52 @@ function write(file, before2, after, paste) {
     return { kind: "refused", why: `${file} could not be written: ${error2.message}`, text: paste };
   }
 }
-function tomlBody(agent, launch) {
+var CODEX_SCHEMA_BYTES = 131072;
+var CODEX_SETTINGS = [
+  "JAVA_HOME",
+  "ANDROID_HOME",
+  "ANDROID_SDK_ROOT",
+  "BLENDER",
+  "GAMESTEEL_KEY",
+  "GAMESTEEL_SITE",
+  "GAMESTEEL_ANDROID_TEMPLATE",
+  "HTTP_PROXY",
+  "HTTPS_PROXY",
+  "NO_PROXY",
+  "http_proxy",
+  "https_proxy",
+  "no_proxy"
+];
+var isTable = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var OWN_TOML_KEYS = /* @__PURE__ */ new Set([
+  "command",
+  "args",
+  "env",
+  "startup_timeout_sec",
+  "tool_timeout_sec",
+  "default_tools_approval_mode",
+  "tool_input_schema_max_bytes",
+  "omit_tools_from",
+  "env_vars"
+]);
+var tomlKey = (key) => /^[A-Za-z0-9_-]+$/.test(key) ? key : tomlString(key);
+function tomlBody(agent, launch, before2 = {}) {
+  const theirs = Object.entries(isTable(before2["env"]) ? before2["env"] : {}).filter(([name2]) => !name2.startsWith("GAMESTEEL_"));
+  const env = theirs.length === 0 ? launch.env : { ...Object.fromEntries(theirs), ...launch.env };
+  const approval = typeof before2["default_tools_approval_mode"] === "string" ? before2["default_tools_approval_mode"] : "approve";
   return [
     `command = ${tomlString(launch.command)}`,
     `args = [${launch.args.map(tomlString).join(", ")}]`,
-    ...launch.env === void 0 ? [] : [`env = ${tomlValue(launch.env)}`],
-    ...agent.id === "codex" ? [`startup_timeout_sec = ${String(START_SECONDS)}`, `tool_timeout_sec = ${String(CALL_SECONDS)}`] : []
+    ...env === void 0 ? [] : [`env = ${tomlValue(env)}`],
+    ...agent.id === "codex" ? [
+      `startup_timeout_sec = ${String(START_SECONDS)}`,
+      `tool_timeout_sec = ${String(CALL_SECONDS)}`,
+      `default_tools_approval_mode = ${tomlString(approval)}`,
+      `tool_input_schema_max_bytes = ${String(CODEX_SCHEMA_BYTES)}`,
+      'omit_tools_from = ["deferred"]',
+      `env_vars = [${CODEX_SETTINGS.map(tomlString).join(", ")}]`
+    ] : [],
+    ...Object.entries(before2).filter(([key]) => !OWN_TOML_KEYS.has(key)).map(([key, value]) => `${tomlKey(key)} = ${tomlValue(value)}`)
   ];
 }
 function jsonEntry(agent, launch) {
@@ -64356,7 +64396,7 @@ function launchOrNull(agent, env) {
     return null;
   }
 }
-var tomlFor = (agent, form) => tomlBody(agent, form.launch);
+var tomlFor = (agent, form, before2) => tomlBody(agent, form.launch, before2);
 var tomlListFor = (form) => [
   `name = ${tomlString(NAME)}`,
   'transport = "stdio"',
@@ -64420,7 +64460,8 @@ function connectWith(agent, env, print, launch) {
     }
   }
   if (agent.way === "toml") {
-    const body3 = tomlFor(agent, form);
+    const there2 = before2 === null ? void 0 : tomlTable(before2, NAME);
+    const body3 = tomlFor(agent, form, isTable(there2) ? there2 : void 0);
     const paste2 = [`[mcp_servers.${NAME}]`, ...body3].join("\n");
     try {
       return viaFile(file, before2, setTomlServer(withoutOld(agent, env, before2) ?? "", NAME, body3), print, paste2);
@@ -82098,6 +82139,10 @@ function admit(bound, value, at5) {
           return refuse2("unknown-argument", `${at5}.${key}`, raw[key], known2.join(", "), null, `${at5} does not take '${key}'; it takes ${known2.join(", ")}. unknown arguments are refused rather than ignored, because an ignored one is how a call comes to look stronger than it was`);
         }
       }
+      const missing2 = known2.filter((key) => raw[key] === void 0 && bound.required.includes(key));
+      if (missing2.length > 1) {
+        return refuse2("missing-argument", `${at5}.${missing2[0] ?? ""}`, void 0, "required", null, `${at5} needs ${missing2.slice(0, -1).join(", ")} and ${missing2[missing2.length - 1] ?? ""}`);
+      }
       const out2 = {};
       for (const key of known2.sort()) {
         const field2 = bound.fields[key];
@@ -95653,7 +95698,7 @@ var START = [
   "## Read as you go",
   "",
   "- game: the game text. Read it before writing one.",
-  "- scripts, then api: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
+  "- scripts, then api and api-game: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
   "  lives in its scripts.",
   "- drawing: art drawn in code: shapes, gradients, soft light, curves, panels, every option.",
   "- style: craft -- palette, light, texture, depth, UI and type, and the tells that make art look generated.",
@@ -95692,6 +95737,9 @@ var START = [
   "   the title, a menu, a hit, the ending. Words are cheap; pictures cost more, so look on purpose.",
   "6. Polish until it is a game you would show someone.",
   "",
+  "games new and games open answer with the game's link, where the person sees and plays it in the editor: give it to",
+  "the person whenever there is something to see, the first time above all. A look with shaders is drawn there too.",
+  "",
   "## Made for this game, never repeated",
   "",
   "Before a character, a creature, a vehicle, a building, or any song:",
@@ -96028,16 +96076,27 @@ var MODEL = [
 ];
 var SCRIPTS = [
   ...SCRIPTS_PRIMER,
-  "The exact declarations every script is checked against are the api topic."
+  "The exact declarations every script is checked against are the api and api-game topics."
 ];
-function agentApi() {
+function agentApi(part) {
   const own3 = (what, name2) => `/** ${what}: one of the game's own, own:<name>, made for it. */
 type ${name2} = \`own:\${string}\`
 `;
-  return [
-    "// The script API, as the type checker holds scripts to it. A sound and a song are the game's own (own:<name>); the",
-    "// stock names older games still use are left out here.",
-    SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"))
+  const whole3 = SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"));
+  const at5 = whole3.indexOf("\ninterface Game {");
+  if (at5 < 0)
+    throw new Error("the script API has no interface Game to split it at");
+  return part === "objects" ? [
+    "// The script API, part one, as the type checker holds scripts to it: the shared types, tweens and sequences, Thing,",
+    "// sounds, songs and the Mixer, Turns, the UI, spawning, Behaviour, Bot, Check, GameScript, input, rays, the camera",
+    "// and bursts. A sound and a song are the game's own (own:<name>); the stock names older games still use are left",
+    "// out here. this.game, drawing, noise and console are part two, the api-game topic.",
+    whole3.slice(0, at5).trimEnd()
+  ].join("\n") : [
+    "// The script API, part two, as the type checker holds scripts to it: this.game (interface Game), drawing (Draw,",
+    "// its layers, paints and shaders), noise and console. The types it names, Thing, Point and Colour among them, are",
+    "// part one, the api topic.",
+    whole3.slice(at5 + 1)
   ].join("\n");
 }
 var TEAM = [
@@ -96291,18 +96350,19 @@ var GUIDE_TOPICS = [
   { name: "start", about: "how to work, and the bar for a finished game -- read it first", text: () => START.join("\n") },
   { name: "game", about: "the game text: settings, types, bodies, levels and tiles, the camera, rules, controls", text: () => [...quickWay(), ...gameText()].join("\n") },
   { name: "scripts", about: "how scripts run: hooks, state, timers, tweens, screens, sound, with ready-made UI", text: () => SCRIPTS.join("\n") },
-  { name: "api", about: "the script API, exactly as the type checker holds scripts to it", text: () => agentApi() },
+  { name: "api", about: "the script API, part one: Thing, scripts, sound, UI, input", text: () => agentApi("objects") },
+  { name: "api-game", about: "the script API, part two: this.game and drawing", text: () => agentApi("game") },
   { name: "drawing", about: "art drawn in code: layers and units, shapes, gradients, soft light, curves, panels, push and pop, screens that scale", text: () => DRAWING.join("\n") },
-  { name: "shaders", about: "drawing with the graphics card: boxes painted by a shader, shaders over the picture, passes, lists and paintings as inputs", text: () => SHADERS.join("\n") },
+  { name: "shaders", about: "drawing with the graphics card: shaded boxes, shaders over the picture, passes, inputs", text: () => SHADERS.join("\n") },
   { name: "style", about: "craft: palette, light, texture, depth, UI and type, and the tells that make art look generated", text: () => STYLE.join("\n") },
   { name: "feel", about: "screens, transitions, juice, sound and music", text: () => FEEL.join("\n") },
   { name: "sound", about: "designed sound effects and composed music: layers, variants, instruments, loudness, and listening", text: () => SOUND_TOPIC.join("\n") },
   { name: "playtest", about: "playing it yourself with tracks and bots, and looking at it", text: () => playtestGuide().join("\n") },
   { name: "edit", about: "ids, the edit operations, and write_code against edit", text: () => howToEdit().join("\n") },
   { name: "art", about: "art paint: pictures, animations and tilesets painted against the 2D canvas", text: () => ART.join("\n") },
-  { name: "model", about: "art model: 3D art Blender builds from a short script against the kit, when the person asks for 3D", text: () => MODEL.join("\n") },
-  { name: "team", about: "working beside teammates and their agents: the board, taking with parts, claims, notes", text: () => TEAM.join("\n") },
-  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render, which makes them MP4 video", text: () => FILM.join("\n") }
+  { name: "model", about: "art model: 3D art Blender builds from a short script, when the person asks for 3D", text: () => MODEL.join("\n") },
+  { name: "team", about: "working beside teammates and their agents: the board, parts, claims, notes", text: () => TEAM.join("\n") },
+  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render to MP4", text: () => FILM.join("\n") }
 ];
 function guideTopic(name2) {
   return GUIDE_TOPICS.find((topic) => topic.name === name2);
@@ -96398,9 +96458,11 @@ function admitArgs(schema, value, at5) {
         }
       }
       const required2 = Array.isArray(schema["required"]) ? schema["required"] : [];
-      for (const key of required2)
-        if (raw[key] === void 0)
-          return `${at5}.${key} is required`;
+      const missing2 = [...Object.keys(properties), ...required2.filter((key) => !(key in properties))].filter((key) => required2.includes(key) && raw[key] === void 0);
+      if (missing2.length === 1)
+        return `${at5}.${missing2[0] ?? ""} is required`;
+      if (missing2.length > 1)
+        return `${at5} needs ${missing2.slice(0, -1).join(", ")} and ${missing2[missing2.length - 1] ?? ""}`;
       for (const key of known2) {
         const property = properties[key];
         if (raw[key] === void 0 || property === void 0)
@@ -107566,13 +107628,15 @@ function guideAnswer(raw) {
   }
   return { content: [{ type: "text", text: topic.text() }] };
 }
+var NAMED_PEOPLE = 4;
 function teamInstructions(who) {
-  const people = who.people.length === 0 ? "" : ` (${who.people.join(", ")})`;
+  const more2 = who.people.length > NAMED_PEOPLE ? ` and ${String(who.people.length - NAMED_PEOPLE)} more` : "";
+  const people = who.people.length === 0 ? "" : ` (${who.people.slice(0, NAMED_PEOPLE).join(", ")}${more2})`;
   return [
-    `You are ${who.agent}, in the workspace '${who.workspace}'${people}. Others may be working on the same games at the`,
-    "same time. Every answer about a game tells you what your teammates are doing. Before you start something, take it",
-    "on the game's board (team), with the parts it touches. Leave a note when you finish. The guide's team topic has",
-    "the rest."
+    `You are ${who.agent}, in the workspace '${who.workspace}'${people}. Teammates may work on the same games at once:`,
+    "every answer about a game says what they are doing. Before you start something, take it",
+    "on the game's board (team), with the parts it touches, and leave a note when you finish. The guide's team topic",
+    "has the rest."
   ].join("\n");
 }
 function createServer(more2) {
@@ -107700,9 +107764,13 @@ function makesGame(name2, args2, exists) {
   return false;
 }
 function servedTools(options = DEFAULT_SERVE, leaveOut = /* @__PURE__ */ new Set()) {
-  const families = familyListing(underlyingTools(options, leaveOut));
+  const families = familyListing(underlyingTools(options, leaveOut)).map((tool) => ({ ...tool, annotations: marksOf(tool.name) }));
   return options.schemas === "portable" ? families.map((tool) => ({ ...tool, inputSchema: portableSchema(tool.inputSchema) })) : families;
 }
+var READING_FAMILIES = /* @__PURE__ */ new Set(["guide", "read", "search", "library"]);
+function marksOf(name2) {
+  return READING_FAMILIES.has(name2) ? { readOnlyHint: true, idempotentHint: true, openWorldHint: false } : { readOnlyHint: false, openWorldHint: name2 === "app" };
+}
 function underlyingTools(_options, leaveOut) {
   return toolList().filter((tool) => !leaveOut.has(tool.name));
 }
@@ -111801,7 +111869,7 @@ var FONT_FILES = {
 };
 
 // ../design/dist/plans.js
-var line = (text3, withAccounts = false) => ({ text: text3, withAccounts });
+var line = (text3) => ({ text: text3 });
 var PLANS = [
   {
     id: "starter",
@@ -111826,7 +111894,7 @@ var PLANS = [
     extraSeat: 1e3,
     everythingIn: "starter",
     pick: true,
-    includes: [line("An organization with shared games and roles", true)]
+    includes: [line("An organization with shared games and roles")]
   },
   {
     id: "enterprise",
@@ -111836,10 +111904,29 @@ var PLANS = [
     extraSeat: 1e3,
     everythingIn: "pro",
     pick: false,
-    includes: [line("Invoices instead of cards", true), line("Priority support", true)]
+    includes: [line("Invoices instead of cards"), line("Priority support")]
   }
 ];
 
+// ../i18n/dist/index.js
+function chooseLanguage(header2) {
+  const best = { en: { q: 0, at: Infinity }, es: { q: 0, at: Infinity } };
+  for (const [at5, part] of (header2 ?? "").split(",").entries()) {
+    const [tag = "", ...params] = part.trim().split(";");
+    const primary = tag.trim().toLowerCase().split("-")[0] ?? "";
+    if (primary !== "en" && primary !== "es")
+      continue;
+    const qParam = params.map((param) => param.trim()).find((param) => param.startsWith("q="));
+    const q2 = qParam === void 0 ? 1 : Number(qParam.slice(2));
+    if (!Number.isFinite(q2) || q2 <= 0)
+      continue;
+    if (q2 > best[primary].q || q2 === best[primary].q && at5 < best[primary].at)
+      best[primary] = { q: q2, at: at5 };
+  }
+  const { en: en2, es } = best;
+  return es.q > en2.q || es.q > 0 && es.q === en2.q && es.at < en2.at ? "es" : "en";
+}
+
 // ../studio/dist/server/static.js
 function rangeOf(header2, size2) {
   if (header2 === void 0)
@@ -114817,7 +114904,7 @@ function keepSettings(store, doc, slug, prefix, settings) {
 var isObject5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var TARGETS2 = "android-debug, android-release or ios-project";
 var KEY_ROLES = "the upload key is for the workspace's owner and admins";
-var NO_EXPORT = "this workspace's plan does not export, so it builds no apps: the workspace's owner can choose a plan on the Plan page";
+var NO_EXPORT = (plans) => `this workspace's plan does not export, so it builds no apps: the workspace's owner can choose a plan ${plans === void 0 ? "on the Plan page" : `at ${plans}`}`;
 var sizeOf4 = (bytes2) => bytes2 < 1024 * 1024 ? `${String(Math.max(1, Math.round(bytes2 / 1024)))} KB` : `${(bytes2 / (1024 * 1024)).toFixed(1)} MB`;
 function stepNow(job) {
   return (job.steps.find((step2) => step2.state === "running") ?? job.steps.find((step2) => step2.state === "failed") ?? job.steps.at(-1))?.name ?? "";
@@ -115009,7 +115096,7 @@ function hostedAppRoutes(options) {
       }
       if (call.action === "build") {
         if (!await mayExport(req2))
-          throw new AppRefused(402, NO_EXPORT);
+          throw new AppRefused(402, NO_EXPORT(options.plans));
         const job = await builds.build(workspaceId, slug, call.target, source);
         return { text: `${job.target} started (build ${job.id}): ${builds.started}. app status says how it goes.` };
       }
@@ -123019,16 +123106,35 @@ Open it, allow Gamesteel, then ask again.`);
 };
 var EARLY_MS = 6e4;
 var STALE_LOCK_MS = 12e4;
+function browserCommand(platform, address) {
+  return platform === "darwin" ? ["open", [address]] : platform === "win32" ? ["rundll32", ["url.dll,FileProtocolHandler", address]] : ["xdg-open", [address]];
+}
 function openInBrowser(address) {
-  const [command2, ...args2] = process.platform === "darwin" ? ["open", address] : process.platform === "win32" ? ["cmd", "/c", "start", "", address] : ["xdg-open", address];
+  const [command2, args2] = browserCommand(process.platform, address);
   try {
-    const child = spawn4(command2 ?? "open", args2, { stdio: "ignore", detached: true });
+    const child = spawn4(command2, args2, { stdio: "ignore", detached: true });
     child.on("error", () => void 0);
     child.unref();
   } catch {
   }
 }
-var page = (words3) => `<!doctype html><meta charset="utf-8"><title>Gamesteel</title><p style="font:16px system-ui;margin:3em">${words3}</p>`;
+var SAID = {
+  en: {
+    done: "Gamesteel is signed in. Go back to your agent and ask it again, for example: \u201Ctry again\u201D. You can close this tab.",
+    denied: "You did not allow Gamesteel, so your agent cannot use it yet. To sign in, ask your agent again.",
+    stranger: "This sign-in is not the one Gamesteel asked for. Ask your agent again.",
+    failed: "Gamesteel could not finish signing in. Ask your agent again."
+  },
+  es: {
+    done: "Gamesteel inici\xF3 sesi\xF3n. Vuelve a tu agente y p\xEDdeselo de nuevo, por ejemplo: \xABint\xE9ntalo de nuevo\xBB. Puedes cerrar esta pesta\xF1a.",
+    denied: "No le diste permiso a Gamesteel, as\xED que tu agente a\xFAn no puede usarlo. Para iniciar sesi\xF3n, p\xEDdeselo de nuevo a tu agente.",
+    stranger: "Este inicio de sesi\xF3n no es el que pidi\xF3 Gamesteel. P\xEDdeselo de nuevo a tu agente.",
+    failed: "Gamesteel no pudo terminar de iniciar sesi\xF3n. P\xEDdeselo de nuevo a tu agente."
+  }
+};
+var languageOf3 = (req2) => chooseLanguage(req2.headers["accept-language"]);
+var page = (lang, said4) => `<!doctype html><html lang="${lang}"><meta charset="utf-8"><title>Gamesteel</title><p style="font:16px system-ui;margin:3em">${SAID[lang][said4]}</p></html>`;
+var REOPEN_MS = 3e4;
 var SignIn = class {
   constructor(options) {
     this.options = options;
@@ -123040,6 +123146,8 @@ var SignIn = class {
   clock;
   flow = null;
   server = null;
+  /** When the sign-in's page was last opened in the browser. */
+  opened = 0;
   get file() {
     return join33(this.options.home, "credentials.json");
   }
@@ -123078,13 +123186,22 @@ var SignIn = class {
   /** The address the person opens to sign in: the website's own sign-in, opened in their browser once. */
   address() {
     if (this.flow === null) {
-      const flow = this.begin();
-      this.flow = flow;
-      flow.catch(() => {
-        if (this.flow === flow) this.flow = null;
+      const flow2 = this.begin();
+      this.flow = flow2;
+      flow2.catch(() => {
+        if (this.flow === flow2) this.flow = null;
       });
+      return flow2;
     }
-    return this.flow;
+    const flow = this.flow;
+    void flow.then((address) => {
+      if (this.flow === flow && this.clock() - this.opened >= REOPEN_MS) this.open(address);
+    }, () => void 0);
+    return flow;
+  }
+  open(address) {
+    this.opened = this.clock();
+    (this.options.openBrowser ?? openInBrowser)(address);
   }
   /** Ends the sign-in under way: the next one, if the person must sign in again, begins afresh. */
   close() {
@@ -123135,17 +123252,26 @@ var SignIn = class {
         return;
       }
       const code = url.searchParams.get("code");
+      const lang = languageOf3(req2);
+      const error2 = url.searchParams.get("error");
+      if (url.searchParams.get("state") === state && error2 !== null) {
+        const denied = error2 === "access_denied";
+        res.writeHead(denied ? 200 : 502, { "content-type": "text/html; charset=utf-8" }).end(page(lang, denied ? "denied" : "failed"));
+        if (denied) this.opened = 0;
+        else this.close();
+        return;
+      }
       if (url.searchParams.get("state") !== state || code === null) {
-        res.writeHead(400, { "content-type": "text/html" }).end(page("This sign-in is not the one Gamesteel asked for. Ask your agent again."));
+        res.writeHead(400, { "content-type": "text/html; charset=utf-8" }).end(page(lang, "stranger"));
         return;
       }
       void this.form("/oauth/token", { grant_type: "authorization_code", code, redirect_uri: redirectUri, code_verifier: verifier, client_id: clientId, resource }).then(async (answer3) => {
         if (answer3.status !== 200) throw new Error(String(answer3.status));
         await this.keepLocked(clientId, await answer3.json());
-        res.writeHead(200, { "content-type": "text/html" }).end(page("Gamesteel is signed in. You can close this tab and go back to your agent."));
+        res.writeHead(200, { "content-type": "text/html; charset=utf-8" }).end(page(lang, "done"));
         this.close();
       }).catch(() => {
-        res.writeHead(502, { "content-type": "text/html" }).end(page("Gamesteel could not finish signing in. Ask your agent again."));
+        res.writeHead(502, { "content-type": "text/html; charset=utf-8" }).end(page(lang, "failed"));
       });
     });
     this.server = server;
@@ -123164,7 +123290,7 @@ var SignIn = class {
       code_challenge_method: "S256",
       resource
     }).toString()}`;
-    (this.options.openBrowser ?? openInBrowser)(address);
+    this.open(address);
     return address;
   }
   /** A new token, made by one program on the machine at a time: the others find it made. */
@@ -123695,7 +123821,7 @@ async function startProgram(options) {
       models: machineModels(options.models),
       // The plan's rule for an app build is the website's, read here; the key is downloaded only from the App tab.
       apps,
-      appOptions: { mayExport: async () => (await plan()).limits.export, mayKeepKeys: () => false },
+      appOptions: { mayExport: async () => (await plan()).limits.export, mayKeepKeys: () => false, plans: `${settings.site}/editor#plan` },
       // An agent's film render and a look with shaders, drawn by the editors with the game open on the website.
       relays: { renders: remoteRenders(site), looks: remoteLooks(site) }
     });
@@ -123805,7 +123931,9 @@ async function startProgram(options) {
       const listed5 = await site.games();
       const names2 = new Set(listed5.map((game) => game.slug));
       if (makesGame(name2, args2, (one2) => names2.has(one2) || copy.has(one2)) && listed5.length >= now.limits.games) {
-        return refusal3("the free week makes one game; a plan makes more");
+        const slugs = listed5.map((game) => game.slug);
+        const has = slugs.length === 1 ? `${slugs[0] ?? ""}: work on it` : `${slugs.slice(0, -1).join(", ")} and ${slugs.at(-1) ?? ""}: work on one of them`;
+        return refusal3(`the free week makes one game, and this workspace has ${has}, or its owner can choose a plan at ${settings.site}/editor#plan`);
       }
     }
     const named3 = typeof args2["game"] === "string" ? args2["game"] : name2 === "save_game" && typeof args2["name"] === "string" ? args2["name"] : null;
@@ -123840,8 +123968,9 @@ async function startProgram(options) {
     const answered2 = await call();
     const said4 = team2 !== null && slug !== null && here ? await team2.notes(slug, author) : "";
     let answer3 = said4 === "" ? answered2 : { ...answered2, content: [...answered2.content, { type: "text", text: said4 }] };
+    let made2 = [];
     if (!reading) {
-      const made2 = [...gamesHere(copy.root)].filter((one2) => !before2.has(one2));
+      made2 = [...gamesHere(copy.root)].filter((one2) => !before2.has(one2));
       pending.push(...(await uploader.send([...slug === null ? [] : [slug], ...made2])).pending);
       if (slug !== null) moves2.wrote(slug);
     }
@@ -123850,6 +123979,13 @@ async function startProgram(options) {
       if (report !== null) answer3 = { ...answer3, content: [...answer3.content, { type: "text", text: `
 
 ${report}` }] };
+    }
+    const shown3 = (answer3.isError === true ? [] : name2 === "open_game" && slug !== null ? [slug] : made2).filter((one2) => copy.onWebsite(one2));
+    for (const one2 of shown3) {
+      answer3 = { ...answer3, content: [...answer3.content, { type: "text", text: `
+
+Give the person this link to see and play it: ${settings.site}/editor?game=${one2}&workspace=${now.workspaceId}
+` }] };
     }
     if (slug !== null) moves2.settled(slug);
     const recorded = slug === null ? null : moves2.said(slug);
@@ -124299,6 +124435,9 @@ ${lines.join("\n")}` }] } };
     toolNotices.set("playtest", "The Gamesteel program updated itself: playtests started over at the first tick, and their saved moments were forgotten.");
     if (old.tools === null) await old.listing?.catch(() => void 0);
     if (initialized && (old.tools === null || old.tools !== next2.tools)) toClient({ jsonrpc: "2.0", method: "notifications/tools/list_changed" });
+    if (old.tools !== null && old.tools !== next2.tools) {
+      say(`Gamesteel updated itself to ${next2.version}, and its tools changed: if your agent's client does not show the new ones, restart it.`);
+    }
     try {
       options.versions.sweep([next2.version, old.version]);
     } catch (error2) {

package/dist/pkgs/studio/dist/server/playtest-worker.js

@@ -76534,7 +76534,7 @@ var START = [
   "## Read as you go",
   "",
   "- game: the game text. Read it before writing one.",
-  "- scripts, then api: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
+  "- scripts, then api and api-game: how scripts run, and the exact TypeScript they are checked against. Most of a good game",
   "  lives in its scripts.",
   "- drawing: art drawn in code: shapes, gradients, soft light, curves, panels, every option.",
   "- style: craft -- palette, light, texture, depth, UI and type, and the tells that make art look generated.",
@@ -76573,6 +76573,9 @@ var START = [
   "   the title, a menu, a hit, the ending. Words are cheap; pictures cost more, so look on purpose.",
   "6. Polish until it is a game you would show someone.",
   "",
+  "games new and games open answer with the game's link, where the person sees and plays it in the editor: give it to",
+  "the person whenever there is something to see, the first time above all. A look with shaders is drawn there too.",
+  "",
   "## Made for this game, never repeated",
   "",
   "Before a character, a creature, a vehicle, a building, or any song:",
@@ -76909,16 +76912,27 @@ var MODEL = [
 ];
 var SCRIPTS = [
   ...SCRIPTS_PRIMER,
-  "The exact declarations every script is checked against are the api topic."
+  "The exact declarations every script is checked against are the api and api-game topics."
 ];
-function agentApi() {
+function agentApi(part) {
   const own3 = (what, name) => `/** ${what}: one of the game's own, own:<name>, made for it. */
 type ${name} = \`own:\${string}\`
 `;
-  return [
-    "// The script API, as the type checker holds scripts to it. A sound and a song are the game's own (own:<name>); the",
-    "// stock names older games still use are left out here.",
-    SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"))
+  const whole = SCRIPT_API.trimEnd().replace(/(?:\/\*\*[^\n]*\*\/\n)?type SoundName = [^\n]*\n/, () => own3("A sound", "SoundName")).replace(/(?:\/\*\*[^\n]*\*\/\n)?type MusicName = [^\n]*\n/, () => own3("A song", "MusicName"));
+  const at2 = whole.indexOf("\ninterface Game {");
+  if (at2 < 0)
+    throw new Error("the script API has no interface Game to split it at");
+  return part === "objects" ? [
+    "// The script API, part one, as the type checker holds scripts to it: the shared types, tweens and sequences, Thing,",
+    "// sounds, songs and the Mixer, Turns, the UI, spawning, Behaviour, Bot, Check, GameScript, input, rays, the camera",
+    "// and bursts. A sound and a song are the game's own (own:<name>); the stock names older games still use are left",
+    "// out here. this.game, drawing, noise and console are part two, the api-game topic.",
+    whole.slice(0, at2).trimEnd()
+  ].join("\n") : [
+    "// The script API, part two, as the type checker holds scripts to it: this.game (interface Game), drawing (Draw,",
+    "// its layers, paints and shaders), noise and console. The types it names, Thing, Point and Colour among them, are",
+    "// part one, the api topic.",
+    whole.slice(at2 + 1)
   ].join("\n");
 }
 var TEAM = [
@@ -77172,18 +77186,19 @@ var GUIDE_TOPICS = [
   { name: "start", about: "how to work, and the bar for a finished game -- read it first", text: () => START.join("\n") },
   { name: "game", about: "the game text: settings, types, bodies, levels and tiles, the camera, rules, controls", text: () => [...quickWay(), ...gameText()].join("\n") },
   { name: "scripts", about: "how scripts run: hooks, state, timers, tweens, screens, sound, with ready-made UI", text: () => SCRIPTS.join("\n") },
-  { name: "api", about: "the script API, exactly as the type checker holds scripts to it", text: () => agentApi() },
+  { name: "api", about: "the script API, part one: Thing, scripts, sound, UI, input", text: () => agentApi("objects") },
+  { name: "api-game", about: "the script API, part two: this.game and drawing", text: () => agentApi("game") },
   { name: "drawing", about: "art drawn in code: layers and units, shapes, gradients, soft light, curves, panels, push and pop, screens that scale", text: () => DRAWING.join("\n") },
-  { name: "shaders", about: "drawing with the graphics card: boxes painted by a shader, shaders over the picture, passes, lists and paintings as inputs", text: () => SHADERS.join("\n") },
+  { name: "shaders", about: "drawing with the graphics card: shaded boxes, shaders over the picture, passes, inputs", text: () => SHADERS.join("\n") },
   { name: "style", about: "craft: palette, light, texture, depth, UI and type, and the tells that make art look generated", text: () => STYLE.join("\n") },
   { name: "feel", about: "screens, transitions, juice, sound and music", text: () => FEEL.join("\n") },
   { name: "sound", about: "designed sound effects and composed music: layers, variants, instruments, loudness, and listening", text: () => SOUND_TOPIC.join("\n") },
   { name: "playtest", about: "playing it yourself with tracks and bots, and looking at it", text: () => playtestGuide().join("\n") },
   { name: "edit", about: "ids, the edit operations, and write_code against edit", text: () => howToEdit().join("\n") },
   { name: "art", about: "art paint: pictures, animations and tilesets painted against the 2D canvas", text: () => ART.join("\n") },
-  { name: "model", about: "art model: 3D art Blender builds from a short script against the kit, when the person asks for 3D", text: () => MODEL.join("\n") },
-  { name: "team", about: "working beside teammates and their agents: the board, taking with parts, claims, notes", text: () => TEAM.join("\n") },
-  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render, which makes them MP4 video", text: () => FILM.join("\n") }
+  { name: "model", about: "art model: 3D art Blender builds from a short script, when the person asks for 3D", text: () => MODEL.join("\n") },
+  { name: "team", about: "working beside teammates and their agents: the board, parts, claims, notes", text: () => TEAM.join("\n") },
+  { name: "film", about: "films: levels that play themselves, cutscenes, chapters, endFilm, and film render to MP4", text: () => FILM.join("\n") }
 ];
 
 // ../agent/dist/artgen-tools.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gamesteel",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "The Gamesteel program your AI agent starts, and the command that sets it up in Claude Code, Codex, Gemini CLI, Cursor, VS Code and 26 more. The work runs on your machine; the website keeps your games.",
   "keywords": [
     "gamesteel",
@@ -37,18 +37,19 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "esbuild": "0.28.2",
+    "@gamesteel/billing": "0.1.0",
+    "@gamesteel/agent": "0.1.0",
+    "@gamesteel/connect": "0.1.0",
     "@gamesteel/builder": "0.1.0",
-    "@gamesteel/accounts": "0.1.0",
-    "@gamesteel/design": "0.1.0",
     "@gamesteel/cloud": "0.1.0",
-    "@gamesteel/edit": "0.1.0",
     "@gamesteel/core": "0.1.0",
-    "@gamesteel/store": "0.1.0",
-    "@gamesteel/billing": "0.1.0",
-    "@gamesteel/connect": "0.1.0",
+    "@gamesteel/edit": "0.1.0",
+    "@gamesteel/accounts": "0.1.0",
     "@gamesteel/service": "0.1.0",
+    "@gamesteel/i18n": "0.1.0",
     "@gamesteel/studio": "0.1.0",
-    "@gamesteel/agent": "0.1.0",
+    "@gamesteel/store": "0.1.0",
+    "@gamesteel/design": "0.1.0",
     "@gamesteel/model": "0.1.0"
   },
   "scripts": {