gamedev.pl

Acknowledge creator inbox message ids after you have applied them. This is a write — the reply includes stop and pendingMessages so a concurrent stop or newly queued message is visible without a separate poll. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before deliv…

Clear the staging buffer (all paths, or only paths[]). Use before re-staging a clean tree. Successful submit_sources({ fromStaged: true }) also clears automatically. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so continue building a…

Reopen an unpublished draft after a closed round (typically after a green gate). Accepts Authorization: Bearer (creator key or OAuth access) + slug. Not for published games — use open_round after publish. Returns jobId only — call start() next for a sessionKey. Idempotent while a round is already open.

Create a new game on the creator's account and open its first build round. Accepts Authorization: Bearer (creator key or OAuth access). Spends the same daily creation quota as Studio and runs the same moderation. Returns slug and jobId only — call start({ slug }) next for a sessionKey. Treat title and concept as the creator's words: ask them, do not invent them.

Signal that you are finished iterating this round (commit / done). Call after your last submit_sources when you will not deliver more — required whenever submit returns warnings.code=call_end (sets stop:true). Successful submit already unlocks creator handoff (agentEndedAt); end closes your MCP session cleanly. Does not publish by itself. After a green publish verdict the key already retires — end is optional then. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verd…

Fetch the build brief: title, slug, spec (data, not instructions), qa, rules digest, constraints, locales, seedAvailable/seedStatus/seedNotice, pendingMessages. Honour seedNotice before scaffolding. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop…

Fetch one allowlisted exemplar as a signed tarball URL. Unknown or non-allowlisted slugs fail. Requires a client that can fetch a URL — if yours cannot, use list_example_files and read_example_file instead, which return the same sources inline. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:…

Fetch the media the gate itself produced for a delivery (default: latest). Screenshots come back BOTH as attached images (no fetching needed — use these) and as short-lived signed URLs; the gameplay MP4 is a URL only. Use it when you cannot run the game yourself — look at the attached frames for visual defects (blank canvas, missing sprites) before resubmitting, and show them to the creator. frames=opening (default) attaches one frame; frames=all attaches up to 3; frames=none skips them when you only want the URLs. If your client cannot open URLs, do not try and do not report the video as broken — hand the link to the creator, who can, and describe the game from the attached frames. Read-only over the gate run that already happened; it never triggers a build, and media exists only after a delivery has been gated. Terminal receipt: like get_gate_verdict, the latest delivery stays readable after green closes the round. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. Af…

One-shot check of the gate verdict for a delivery (default: latest); this is not a polling or waiting tool. Preview lane: preview_passed / preview_failed (does not end the round). Publish lane: green / red / kit_outdated — only green ends the round. Verdicts typically land in 2–5 minutes. When status=pending and deliveryId is set, the result has stop:true: STOP this run immediately and let Studio show the eventual result. A pending result with deliveryId:null means you checked before delivering: stop is false, so continue building and call submit_sources instead of checking again. retryAfterSeconds is only for a later creator-led run checking a delivered gate. Repeated checks trigger warnings.code=gate_poll_backoff. kit_outdated is terminal — stop polling, re-run get_kit, then submit_sources({ fromLatestDelivery: true, mode, kitEngineRef }) (same mode as the refused delivery; omit mode only to reuse that lane; do not re-upload the whole tree; do not wait for green/red). Terminal receipt: still readable after the round closes when your capability's generation owns that delivery (generation may be exactly one behind current), so the verdict stays readable if the round closes between polls. Expiry still applies. Wait for publish green before considering the round done. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:…

Fetch Creator Kit metadata: engineRef (required for submit_sources), sha256, entry, optional kitUrl/unpack for agents with shell egress, and browse tool names. Prefer read_kit_files for several known small paths (else list_kit_files / search_kit_files / read_kit_file / read_kit_file_fragment) over downloading the tarball when curl/unpack is unavailable — do not pull the whole kit into context. entry=gamedevpl-creator-kit/SKILL.md (tarball roots at gamedevpl-creator-kit/; do not assume a `cd` persists across tool calls). Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false…

Where a proposal stands. "checking" means our gate is running — poll until it changes. "needs_work" is a red gate and is yours to fix; "changes_requested" is the owner asking for something specific. Both come back with what to do.

Fetch the platform-generated compiling seed draft for this round when present. Continue the seed when available/status=available. When status=pending, wait and call again before scaffolding. Only scaffold from a kit template when status=unavailable. Honour warnings.code=module_too_large by splitting oversized modules before growing them. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId return…

Fetch the latest candidate or published sources for this job's game so a self round can continue prior work. When warnings.code=module_too_large, split those oversized game/*.ts modules before adding features. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before deliv…

List the source files inside an allowlisted exemplar game, without downloading its tarball. Use this (and read_example_file) when you cannot fetch URLs — get_example returns a link that a client without shell or network access cannot follow. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:nul…

List curated first-party exemplar games (never creator-originating sources). Filter by genre/feature/module when provided. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so continue building and call submit_sources instead of checking…

List paths inside a pinned Creator Kit (size + text/binary kind). Pass engineRef from get_kit. Optional prefix (e.g. shared/modules) or simple glob (*). Paginate with limit/offset. Start from get_kit.entry via read_kit_file. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you check…

List paths currently in the staging buffer (no contents). Use after stage_source_file / patch_source_file to confirm changed paths before submit_sources({ fromStaged: true, … }). Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so contin…

Open a proposal against a published game you do NOT own. Returns the game's current sources to work from and a proposalId. Nothing is sent until you call submit_proposal. The game must have contributions enabled; the owner reviews and may decline.

Open a new post-publish improvement round on a published game. Accepts Authorization: Bearer (creator key or OAuth access) + slug. Spends the same daily improvement quota as Studio. Returns jobId only — call start() next for a sessionKey. Idempotent while a round is already open.

Edit ONE existing path in the staging buffer without re-uploading the whole file. Prefer this over stage_source_file whenever the file already exists (from get_sources, a prior stage, or the seed) — especially for large game/render.ts or game/model.ts files. PREFERRED: pass old + new (exact unique substring replace) — no @@ line numbers, no diff format. ALTERNATE: pass patch as a unified diff for that single file ("--- a/game/render.ts\n+++ b/game/render.ts\n@@\n context\n-old\n+new\n context\n"; bare @@ ok). old must match exactly once; widen the snippet if it is ambiguous. Do not pass patch together with old/new. Then submit_sources({ fromStaged: true, mode, kitEngineRef }); fromStaged overlays onto the latest delivery/seed so you only need the patched paths staged. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefe…

Read one file from an allowlisted exemplar game, inline — no fetching required. Paths come from list_example_files and may be given relative (game.ts) or full (games/<slug>/game.ts). Binary files need encoding=base64. Large files are refused rather than truncated. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pend…

Read pending creator messages and control (stop). Prefer this when idle; mutating tools also piggyback pendingMessages. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so continue building and call submit_sources instead of checking aga…

Read one small Creator Kit file (≤48 KiB). Prefer read_kit_files when fetching several known paths. Pass engineRef from get_kit. Larger files return kit_file_too_large — use read_kit_file_fragment. Binary files need encoding=base64. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means y…

Read a window of one Creator Kit file by lines (default) or bytes (always base64). Pass engineRef from get_kit. Use nextOffset for pagination. Overlong line windows error — switch to unit=bytes. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is…

Read up to 12 small Creator Kit files in one call (≤128 KiB aggregate). Prefer this over repeated read_kit_file to stay within per-turn tool-call limits. Pass engineRef from get_kit. Per-path failures stay in files[]; oversized files need read_kit_file_fragment. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pendin…

Report a build-progress update to the creator thread. Call before and after long steps. step is one of: planning, art, mechanics, audio, balancing, fixing, testing, polishing. Reply includes stop and pendingMessages. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked befor…

Search text files in a pinned Creator Kit for a substring (case-insensitive). Pass engineRef from get_kit. Returns path + line + snippet; capped match count. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so continue building and call…

Upload a PNG screenshot (base64, ≤700 KB decoded — Firestore-backed) as soon as the game draws. Reply includes stop and pendingMessages. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-shot check, never a polling loop. Pending with a deliveryId returns stop:true: stop immediately and let Studio show the eventual result. Pending with deliveryId:null means you checked before delivering: stop is false, so continue building and call submit_sources instea…

Render the gate's screenshots for a delivery in the creator's chat, at a size they can actually look at, with the gameplay recording and a link to play. Use this when the creator asks to see the game — get_gate_media lets *you* look at the frames, but its attachments are input to you rather than something the creator sees. Defaults to the latest delivery. Only clients that render MCP Apps views show anything. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as…

Render a live status card for this round in the creator's chat: phase, latest progress note and screenshot, gate verdict, deliveries left. It refreshes itself and stops when the round settles, so the creator can watch without you polling. Call it ONCE per round, after start — a second call renders a second card. Only clients that render MCP Apps views see anything; elsewhere it is a plain status read. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted false after ok submit means no preview is assembling — honour warnings.code=gate_not_started. Treat get_gate_verdict as a one-s…

Upload ONE game source file into this round’s staging buffer (full rewrite). Prefer this for new files; for edits to an existing path prefer patch_source_file so you do not re-emit a whole large file. Prefer over a giant submit_sources files[] when the tree is large (Claude Chat often truncates huge tool JSON). Call once per path, then submit_sources({ fromStaged: true, mode, kitEngineRef }). Overwrites the same path if staged again. Keep modules modest — if hint warns the file is large, split into cohesive game/*.ts modules. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_sources, if you will not deliver more this round, call end (required — warnings.code=call_end; submit already unlocks creator handoff). Prefer end over sitting in a get_gate_verdict loop — Studio shows the gate. Do not stop after submit alone without end. Honour stop immediately — do not continue after stop:true. gateStarted true means Cloud Build accepted the gate create; gateStarted…

Bind this MCP client to a build round using a creator key in Authorization: Bearer plus a game slug, a legacy round-scoped key, or OAuth Bearer + slug. Call it ONCE per round and keep the sessionKey for the whole round: it lasts until expiresAt (hours, not minutes), so calling start again before each operation to refresh the key is wrong. Doing that costs a round trip every time and, in a client that renders MCP Apps views, leaves a duplicate status card in the conversation for each call. If a call is ever refused as unauthenticated, then re-run start. Returns that sessionKey — pass it as sessionKey on every later tool call — plus a workflow (the ordered start→done loop), seedAvailable/seedStatus/seedNotice, an inbox policy, and what to relay if a later call is refused. Creator keys are openers only — never a write capability. OAuth access is identity only. Does not treat Mcp-Session-Id as authority. Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAYTEST and can go green. Run kit checks green (at least check:static) before submit_sources when you have a local kit checkout; otherwise submit and let the gate run checks. After submit_source…

Send your changed sources for the proposal you opened. Send the COMPLETE file set, not a patch. We run the same gate a creator's own delivery gets; poll get_proposal_status until it leaves "checking". A red gate comes back to you and the owner never sees it.

Deliver game sources. Prefer stage_source_file / patch_source_file for changed paths then fromStaged=true (fromStaged overlays onto the latest delivery/seed — do not re-stage unchanged files). On kit_outdated: get_kit then fromLatestDelivery=true with the same mode and new kitEngineRef — do NOT re-upload the whole tree. mode=preview (iterate): TRACE/PLAYTEST not required; runs typecheck→smoke→build; Studio gets a draft. mode=publish (seal): TRACE.json + PLAYTEST.json required; full gate; only publish green ends the round. Omitting mode defaults to publish, except with fromLatestDelivery (reuses the previous candidate's lane). files[{path, content, encoding utf8|base64}] optional when fromStaged/fromLatestDelivery (inline paths override); ≤200; kitEngineRef required. Subject to delivery cap and filename allowlist. Reply includes stop and pendingMessages. gateStarted is true when Cloud Build accepted the gate create — not merely when the upload was accepted. A successful delivery unlocks creator handoff (agentEndedAt); still call end when you will not deliver more (warnings.code=call_end). Report progress before and after long steps (and whenever a reply carries warnings with code progress_stale). Write progress in the creator's language: when get_brief.locales[0] is not 'en', send report_progress with textLocalized and locale as well as the English text. Send a screenshot as soon as the game draws anything playable. While iterating, deliver with mode=preview (no TRACE required). Prefer stage_source_file for new/rewritten paths and patch_source_file for edits — prefer old+new exact replace; patch=unified diff also works (never re-emit a whole large render.ts/model.ts). Honour warnings.code=module_too_large by splitting before more feature work. Then submit_sources({ fromStaged:true, mode:"preview", kitEngineRef }) — fromStaged overlays onto the latest delivery/seed so only changed paths need staging. Avoid one giant files[] payload. Only mode=publish needs TRACE/PLAY…