@dodi-education/cli 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,11 @@
 # dodi CLI
 
-Let your own AI agent build learning games, companion avatars and accessories
-for your family on [dodi](https://app.dodi.app). Works with any agent that can
-run shell commands (Claude Code, Cursor, Codex, a local model) or speak MCP.
+Let your own AI agent make learning games for your family on
+[dodi](https://app.dodi.app), the way you would in Game Studio: your agent
+describes the game and reviews it, and dodi's own game agent builds it with
+your AI providers (background and preview pictures, a visual check and
+translations included). Works with any agent that can run shell commands
+(Claude Code, Cursor, Codex, a local model) or speak MCP.
 
 Everything the agent uploads is sealed on its machine under your family's
 vault key. The dodi server never sees your games or your kids' details.
@@ -12,23 +15,24 @@ vault key. The dodi server never sees your games or your kids' details.
 Tell your agent:
 
 > Build a learning game for my kid on dodi.app with the dodi CLI (needs Node
-> 20+). Install it with `npm install -g @dodi-education/cli`, run `dodi login` and send
-> me the link it prints so I can allow access, then read `dodi docs` and
-> follow it.
+> 20+). Install it with `npm install -g @dodi-education/cli`, run `dodi login`
+> and send me the link it prints so I can allow access, then read `dodi docs`
+> and follow it: you brief dodi's game agent and review what it builds.
 
 The link opens **Allow access** in the dodi app. Check that the fingerprint
 matches what your agent shows, choose what it may do and for how long, and
-confirm with your password. **Settings > Access** lists every browser, app,
+allow it. **Settings > Access** lists every browser, app,
 robot and agent that can open your family's data; revoke any of them there.
 
 Scopes you can grant:
 
 | Scope | Lets the agent |
 |---|---|
+| `studio` | build with your AI providers: your keys for the game, image and thinking models are handed to the agent's machine (never the voice key), and builds are charged to those accounts |
 | `games` | create and edit your family's games |
 | `games:publish` | submit games to dodi Discover (reviewed before they go live) |
 | `kids:basic` | see your kids' first names and ages |
-| `kids:memory` | read a kid's memory dossier (off by default: the agent's AI provider reads it) |
+| `kids:memory` | read a kid's memory and your notes, so games fit (off by default: the agent's AI provider reads them) |
 | `assets` | create custom companion avatars and accessories |
 | `assets:publish` | share avatars and accessories on dodi Discover |
 
@@ -39,26 +43,28 @@ Access and give it to the agent as `DODI_TOKEN` (or `dodi login --token`).
 
 ```sh
 npm install -g @dodi-education/cli
-dodi login                       # prints the approval link; exit 3 = still pending
-dodi login --resume              # after the parent approved
-dodi docs                        # the workflow; `dodi docs games` before writing a game
-dodi kids                        # who you build for
-dodi games new dino-count        # a working starter game
-dodi games check dino-count      # validator + headless run + screenshots
-dodi games push dino-count       # seal and upload
-dodi games publish dino-count    # optional: dodi Discover
-dodi assets new crown --kind accessory
-dodi assets check crown && dodi assets push crown
-dodi assets publish crown        # optional: share it on dodi Discover
-dodi mcp                         # the same commands as an MCP server (stdio)
+dodi login                         # prints the approval link; exit 3 = still pending
+dodi login --resume                # after the parent approved
+dodi docs                          # the workflow; `dodi docs studio` before your first brief
+dodi kids                          # who you make the game for
+dodi studio new "<brief>"          # plan it with dodi
+dodi studio plan "<answer>"        # until the plan is right
+dodi studio build                  # dodi builds it in the background
+dodi studio wait                   # dodi's reply and screenshots to review (exit 3 = still building)
+dodi studio send "<feedback>"      # a change round, then wait again
+dodi games publish                 # only when the parent asks: dodi Discover (translated, reviewed)
+dodi assets new crown --kind accessory   # custom companion looks (3D, see `dodi docs assets`)
+dodi mcp                           # the same commands as an MCP server (stdio)
 ```
 
 Every command takes `--json`. Exit codes: 0 ok, 1 error, 2 usage, 3 waiting
-for approval, 4 check failed, 5 not connected, 6 missing scope.
+(approval or a running build), 4 check failed, 5 not connected, 6 missing
+scope.
 
-`dodi games check --local` runs the game in Playwright on your machine
-(`npx playwright install chromium`); without it, the dodi screenshot service
-renders it.
+Builds run dodi's own game agent on the agent's machine. Its visual check
+renders the game with Playwright when it is installed
+(`npx playwright install chromium-headless-shell`), otherwise through dodi's
+screenshot service.
 
 ### MCP
 
@@ -84,8 +90,10 @@ pnpm --filter @dodi-education/cli build           # bundles to dist/dodi.js
 NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem" pnpm --filter @dodi-education/cli exec tsx scripts/e2e-local.ts
 ```
 
-`scripts/e2e-local.ts` runs the whole flow (login, approval, kids, games,
-assets, scopes, logout) against a local platform on :3001 and its dev
-database. `E2E_PUBLISH_GAME=1` adds an access-key agent that publishes the
-game to Discover (this sends the operator notification email when the local
-platform has one configured).
+Against a local platform on :3001 and its dev database:
+- `scripts/e2e-local.ts`: login, approval, kids, manual game edits, assets,
+  scopes, access keys, the Access list, logout.
+- `scripts/e2e-studio-local.ts`: the studio flow (plan, build, review, a
+  change round) with a stand-in model (`scripts/stub-anthropic.ts`), so no
+  real AI is called. `E2E_PUBLISH_GAME=1` also publishes (this sends the
+  operator notification email when the local platform has one configured).

package/dist/{chunk-KP4U5Z6H.js → chunk-DOOTVCQI.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   __export
-} from "./chunk-2ZK44UVJ.js";
+} from "./chunk-LMSPDGSC.js";
 
 // ../../node_modules/.pnpm/zod@4.5.4/node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -19224,16 +19224,24 @@ var GameScreenshotServiceSettingsSchema = external_exports.object({
   message: "custom mode requires customUrlEnc",
   path: ["customUrlEnc"]
 });
+var DEFAULT_GAME_SCREENSHOT_SERVICE = {
+  mode: "dodi"
+};
+function parseGameScreenshotServiceSettings(value) {
+  const parsed = GameScreenshotServiceSettingsSchema.safeParse(value);
+  return parsed.success ? parsed.data : DEFAULT_GAME_SCREENSHOT_SERVICE;
+}
 
 export {
   external_exports,
   SuccessCriteriaSchema,
   SUCCESS_SYSTEM_TEMPLATE,
-  GAME_CANVAS_TEMPLATE,
   createBridgeToken,
+  STAGE,
+  GAME_CANVAS_TEMPLATE,
   SCREENSHOT_CONTRACT_VERSION,
   SCREENSHOT_LIMITS,
-  ScreenshotStepSchema,
   DEFAULT_SCREENSHOT_VIEWPORT,
-  ScreenshotResponseSchema
+  ScreenshotResponseSchema,
+  parseGameScreenshotServiceSettings
 };

package/dist/chunk-LMSPDGSC.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __commonJS,
+  __export,
+  __toESM
+};