@crowdedkingdoms/crowdyjs 8.22.0 → 10.0.0

package/MIGRATION.md

@@ -1,3 +1,69 @@
+# CrowdyJS v10 — project-first Mod Studio (BREAKING)
+
+This migration is implemented on the feature branch but is **not versioned or
+published yet**.
+
+The session-only live-coding API was removed. There are deliberately no
+compatibility aliases.
+
+Removed exports:
+
+- `mountLiveCodingIDE`
+- `mountLiveCoding`
+- `LiveCodingController`
+- `MountLiveCodingOptions`
+- `PLAYER_CODE_TEMPLATES` / `templateById`
+- the `moduleName` and `draftByDefault` mount options
+- the `@crowdedkingdoms/crowdyjs/live-coding` package subpath
+
+Replace the old mount with a cloud project provider and the new subpath:
+
+```ts
+import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
+
+const studio = await mountModStudio(host, {
+  projectProvider: game.playerCodeProjects,
+  playerCompute: game.playerCompute,
+  playerWallet: identity.playerWallet,
+  appId,
+  gridId,
+  grid,
+  workerUrl: playerCodeGlueWorkerUrl,
+  onHostCall,
+});
+```
+
+Custom UIs instantiate `ModStudioController` directly. Move all source state
+into `ModStudioProjectProvider`: project files are typed
+`{ target: 'SERVER' | 'CLIENT', path, content }`, and full-stack files share one
+revision/save. Module names and pairing preference are project settings.
+Do not stringify source maps in callers; Mod Studio creates `sourceFilesJson`
+only at the existing `playerCompute.deploy` wire boundary.
+
+Action semantics are now explicit:
+
+- **Test draft** saves atomically, compiles, and runs with draft egress rules.
+- **Deploy live** saves and runs the live project.
+- **Stop project** attempts `setEnabled(false)`, client broker shutdown, and
+  polling cleanup, and returns partial failures instead of hiding them.
+
+Full-stack order is CLIENT compile → SERVER compile → `setRequires` (only after
+both succeed) → SERVER enable → exact-version CLIENT artifact hot-swap.
+
+The local Rust worker remains credential-free and server-free. Monaco now uses
+target-prefixed URIs and loads project, personal-library, and common Rust files
+for cross-file completion/hover/symbols/definition. If Monaco/Worker/WASM fails,
+`mountModStudio` keeps a target/file-aware textarea inside the same project UI;
+there is no standalone fallback API.
+
+The Game API project contract is exposed through `PlayerCodeProjectsAPI`.
+Generated operations cover `playerCodeProjects`, `playerCodeProject`,
+`playerCodeProjectCreate`, `playerCodeProjectSave`,
+`playerCodeLibraryFiles`, `playerCodeLibrarySave`,
+`playerCodeCommonFiles`, and `playerCodeProjectImportFile`.
+
+This branch is versioned `10.0.0` for the coordinated major release.
+
 # CrowdyJS v8.10 Notes
 
 ## Added

package/README.md

@@ -32,10 +32,11 @@ CrowdyJS v4 targets browsers by default and uses native `fetch`, `WebSocket`, `c
 >
 > **Player-code authoring DX:** `playerCompute.setRequires`,
 > `marketplace.trustGridAuthor`, self-authored `gridClientMods` fields, and
-> attachment-keyed client artifact fetches require the 2026-07-22 authoring-DX
-> migration. `mountLiveCodingIDE` lazy-loads Monaco and rust-analyzer LSP support
-> when given an authenticated language-service URL and app-token getter; without
-> them it preserves the dependency-free textarea fallback.
+> version-keyed client artifact fetches require the 2026-07-22 authoring-DX
+> migration. The v9 `mountModStudio` surface is project-first: cloud project
+> revisions, target-scoped files, atomic autosave, and explicit draft/live/stop
+> orchestration. Its Rust language worker receives source plus the committed
+> platform index only—never a credential and never a server connection.
 
 > **v8.10 inventory authority:** generated craft/barter transactions work on
 > existing Model servers. Compute-refereed durable commits require Compute SDK
@@ -64,6 +65,21 @@ accepts explicit sources.) Commit `schema.gql` and `src/generated/graphql.ts`
 together whenever the public GraphQL surface changes; `npm run check:schema`
 detects drift in CI/release work.
 
+The browser authoring index follows the same boundary. `npm run build` validates
+only the committed internal `src/live-coding/assets/browser-authoring-index.json` and its
+generated TypeScript copy; it never discovers or reads a sibling game-api
+checkout. Coordinated maintainers compare an explicitly supplied exporter path:
+
+```bash
+npm run authoring-index:drift -- --source /path/to/browser-authoring-index.json
+# To accept that exact source, then regenerate the committed TypeScript:
+npm run authoring-index:drift -- --source /path/to/browser-authoring-index.json --write
+npm run authoring-index:generate
+```
+
+The drift command rejects a missing `--source`; cross-repository orchestration,
+not standalone package build or tests, owns that comparison.
+
 ## Quick start
 
 ```ts
@@ -124,6 +140,7 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.gameModel` | Abstract game model: containers, properties, functions (incl. model-driven `notify_*` effects), sessions, and **automations / NPCs** (`upsertAutomation`, `runAutomation`, `automationRuns`, `automationStats`, …). |
 | `client.compute` | **Compute Modules** — server-side Rust/WASM logic: author + deploy source (`upsertModule`, `deployVersion`, `waitForCompile`), triggers + policy, synchronous `invoke`, and monitoring (`moduleRuns`, `moduleStats`, `moduleLogs`, `appDiagnostics`). Modules run server-only; see [Compute Modules docs](https://docs.crowdedkingdoms.com/game-api/compute-modules). |
 | `client.playerCompute` | Player-authored SERVER/CLIENT Rust/WASM bound to player-owned grids: deploy source, activate/deactivate, list modules/versions, and delete self-authored modules. |
+| `client.playerCodeProjects` | Cloud project, personal-library, and common-file APIs for Mod Studio: target-scoped files, metadata/module names, pairing preference, optimistic revisions, copy-by-value imports, and atomic metadata/file saves. Generated operations are pinned to the committed merged SDL. |
 | `client.playerModel` | Player-owned flexible model containers and grid-confined automations (`containers`, `createContainer`, `setProperty`, `automations`, `createAutomation`, …). |
 | `client.marketplace` | Player-code store/install/consent flows plus player-authorized grid claims: `claimGridOwnership` preserves the existing-grid policy flow, while `claimGridChunk` atomically creates and owns one chunk under `SELF_CLAIM` and `releaseClaimedGrid` releases an eligible owner-created claim. |
 | `client.udp` | UDP proxy subscriptions + spatial mutations (`sendActorUpdate`, `sendVoxelUpdate`, `sendAudioPacket`, `sendTextPacket`, `sendClientEvent`). |
@@ -131,11 +148,98 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.refreshGameplayToken()` | Safely rotates an active game client's app token: disconnects the old-token UDP proxy, refreshes/stores the token, and opens the new-token proxy while existing realtime handlers resubscribe in place. |
 | `client.world(appId)` | Higher-level helpers for browser games (`actor.join`, `actor.sendState`, `actor.sendText`). |
 
-`PlayerCodeBroker` is the P1 page-side browser security skeleton: it transfers
+`PlayerCodeBroker` transfers
 compiled client artifacts to a platform-owned worker, keeps tokens on the page,
 allow-lists host calls, and locally clamps chunk-targeted effects to the owned
-grid before the normal SDK path reaches server authorization. P3 adds the
-platform worker glue/live-coding presentation UI.
+grid before the normal SDK path reaches server authorization. Mod Studio
+hot-swaps only the exact version-keyed artifact returned after a successful
+CLIENT compile.
+
+## Player-code Mod Studio
+
+`mountModStudio` is the project-first SERVER/CLIENT Rust authoring surface. A
+project has one cloud revision, target-scoped files, project metadata, separate
+server/client module names, and a pairing preference. Full-stack edits autosave
+as one optimistic-concurrency write; the UI renders **Saving**, **Saved**,
+**Conflict**, or **Offline**, with retry and conflict-resolution actions.
+
+```ts
+import { mountModStudio } from '@crowdedkingdoms/crowdyjs/mod-studio';
+
+const studio = await mountModStudio(host, {
+  projectProvider: game.playerCodeProjects,
+  playerCompute: game.playerCompute,
+  playerWallet: identity.playerWallet,
+  appId,
+  gridId,
+  grid,
+  workerUrl: playerCodeGlueWorkerUrl,
+  onHostCall,
+});
+
+// Stops editor/runtime polling, the Rust worker, and any client broker owned
+// by this mount. It does not implicitly disable a deliberately live server.
+studio.destroy();
+```
+
+Use `new ModStudioController(options)` for a custom/headless presentation. Its
+public edits are file operations (`addFile`, `renameFile`, `deleteFile`,
+`updateFile`) and project settings—there is no session-only source blob, fixed
+module name, or template JSON API. The deploy conversion to the Game API's
+legacy `sourceFilesJson` input happens only inside the controller's
+`playerCompute.deploy` call.
+
+The built-in UI provides a project switcher/new-project wizard
+(server/client/full-stack), target explorer, personal library/common files,
+tabs, settings, Problems/Build/Logs/Runs/Invoke panels, and explicit **Test
+draft**, **Deploy live**, and **Stop project** actions. Full-stack deployment is
+ordered: save once → compile CLIENT → compile SERVER → set/clear the pairing
+requirement only after both compiles → enable SERVER → hot-swap the exact
+version-keyed CLIENT artifact. Partial compile failures never write a new
+requirement. Stop always attempts both server disable and client/poll cleanup
+and reports each failure.
+
+Monaco uses target-prefixed model URIs (`.../server/Cargo.toml` and
+`.../client/Cargo.toml`) and opens every loaded project/library/common Rust file
+in one bounded local worker workspace. Completion, hover, symbols, and
+definition therefore work across loaded files; lifecycle snippets and hover
+notes distinguish SERVER platform execution from CLIENT broker host calls.
+Local tree-sitter markers are labeled advisory. Platform rustc output is parsed
+separately into authoritative path/line/column markers and remains visible in
+Build.
+
+The Rust worker receives source files and the strict embedded platform index
+only. It receives no credential, opens no socket/fetch path, and never falls
+back to a server language service. If Monaco, Worker, a WASM asset, or a custom
+platform index fails, the same Mod Studio mount keeps project/target tabs and
+uses one file-aware textarea—never a raw JSON blob.
+
+Modern bundlers must preserve module workers and package `.wasm` assets. Custom
+pipelines can pass `languageWorkerFactory` and `editorWorkerFactory`. The
+embedded index remains the byte-identical game export (`schemaVersion: 2`, Rust
+1.97.1, SDK 0.1.5, ABI 0, 725 symbols, content hash
+`3f5f39d4…18ffb`).
+
+### Game API project contract
+
+`PlayerCodeProjectsAPI` implements the transport-neutral
+`ModStudioProjectProvider`; generated GraphQL types remain inside the adapter.
+The committed merged schema and generated operations cover:
+
+- `playerCodeProjects(appId)` / `playerCodeProject(appId, projectId)`
+- `playerCodeProjectCreate(input)`
+- `playerCodeProjectSave(input)` for one atomic metadata/file delta
+- `playerCodeLibraryFiles(appId)` / `playerCodeLibrarySave(input)`
+- `playerCodeCommonFiles(appId)`
+- `playerCodeProjectImportFile(input)` for copy-by-value imports
+
+The adapter maps the API's `PAIRED | INDEPENDENT | SERVER_ONLY | CLIENT_ONLY`
+presentation enum to Mod Studio's runtime-oriented project kind and
+`REQUIRED | OPTIONAL | NONE` setting. A stale expected `revision` arrives as
+`CONFLICT` with `PLAYER_CODE_REVISION_CONFLICT` in the message and becomes a
+`ModStudioRevisionConflictError` with the latest cloud project when that
+follow-up read succeeds.
+
 | `createWorldSession(client, appId, config)` (from `@crowdedkingdoms/crowdyjs/stores`) | World Stores: opt-in, SDK-managed game state — typed codecs (`structCodec` binary DSL), your own actor with a 5 Hz send loop (`session.self`), a remote-actor registry with lanes/history/staleness (`session.actors`), attributed send errors (`session.errors`), a chunk/voxel cache with realtime merge + worldgen write-back (`session.chunks`), channel/direct-message inboxes + a typed event router, host tracking, typed save/avatar state, and a game-model container mirror. Only configured stores exist (compile-time + runtime); unimported stores tree-shake away. |
 | `client.kit(appId)` | Game Kit: ready-made mappings of game concepts onto the game model — `kit.inventory`, `kit.objects` (lockable doors/chests with custom permissions), `kit.npcs`, `kit.plots` (buy/rent land with transactional, replication-enforced grid grants), and the genre layers `kit.economy` (wallets/shops/trades/market), `kit.progression` (xp/skills/achievements/rating), `kit.loot`, `kit.quests`, `kit.combat`, `kit.matches` (session lobbies/turns/scores with notify-to-pull channels), `kit.decks` (hidden hands), `kit.worldsim` (clock/nodes/crops/waves), `kit.social` (parties/guilds/chat over teams+channels), `kit.leaderboards`, `kit.features` (tier gates), and the engine-aware helpers `kit.mobs` (refereed attacks, defs/slots, contact-damage parsing), `kit.pets` (adopt/summon/dismiss/rename), `kit.instances` (private world slices, seeded runs), `kit.director` (encounter runs), `kit.matchmaking` (queues/proposals/rating), `kit.minigames` (invoke-loop wrapper), `kit.economy.orderBook` (escrowed bid/ask market), engine paths on `kit.matches`/`kit.decks`/`kit.leaderboards`, `kit.quests` tutorial sequencing, `kit.engines` (compute capability detection) with `kit/wire` (the engine pose codec, `engineLanes()`, and the 77/90/91/92/93 event parsers) — plus blueprint builders + `kit.deploy(...)` for the admin "load the rules" step. |
 

package/dist/crowdy-client.d.ts

@@ -59,6 +59,7 @@ import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 import { ComputeAPI } from './domains/compute.js';
 import { PlayerComputeAPI } from './domains/playerCompute.js';
+import { PlayerCodeProjectsAPI } from './domains/playerCodeProjects.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -197,6 +198,8 @@ export declare class CrowdyClient {
     readonly compute: ComputeAPI;
     /** Player-authored Rust/WASM bound to player-owned grids. */
     readonly playerCompute: PlayerComputeAPI;
+    /** Cloud source projects consumed by the project-first Mod Studio. */
+    readonly playerCodeProjects: PlayerCodeProjectsAPI;
     /** P4a marketplace (free mode): store, installs, consent, claim flows. */
     readonly marketplace: MarketplaceAPI;
     /** Player wallet, spend caps, hourly usage charges, and player policy (P2). */

package/dist/crowdy-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"crowdy-client.d.ts","sourceRoot":"","sources":["../src/crowdy-client.ts"],"names":[],"mappings":"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"}

package/dist/crowdy-client.js

@@ -58,6 +58,7 @@ import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
 import { ComputeAPI } from './domains/compute.js';
 import { PlayerComputeAPI } from './domains/playerCompute.js';
+import { PlayerCodeProjectsAPI } from './domains/playerCodeProjects.js';
 import { PlayerWalletAPI } from './domains/playerWallet.js';
 import { MarketplaceAPI } from './domains/marketplace.js';
 import { PlayerModelAPI } from './domains/playerModel.js';
@@ -120,6 +121,7 @@ export class CrowdyClient {
         });
         this.compute = new ComputeAPI(this.graphql);
         this.playerCompute = new PlayerComputeAPI(this.graphql);
+        this.playerCodeProjects = new PlayerCodeProjectsAPI(this.graphql);
         this.playerWallet = new PlayerWalletAPI(this.management);
         this.marketplace = new MarketplaceAPI(this.graphql, this.management);
         this.playerModel = new PlayerModelAPI(this.graphql);

package/dist/domains/playerCodeProjects.d.ts

@@ -0,0 +1,25 @@
+import type { GraphQLClient } from '../client.js';
+import { type CreateModStudioProjectInput, type ImportModStudioReferenceFileInput, type ModStudioProject, type ModStudioProjectProvider, type ModStudioProjectScope, type ModStudioProjectSummary, type ModStudioReferenceFile, type SaveModStudioLibraryFileInput, type SaveModStudioProjectInput } from '../mod-studio/models.js';
+/**
+ * Typed Game API adapter for private Mod Studio projects and reusable files.
+ * Mutable projects remain separate from immutable player-compute versions;
+ * only the controller's deploy path converts target files to sourceFilesJson.
+ */
+export declare class PlayerCodeProjectsAPI implements ModStudioProjectProvider {
+    private readonly graphql;
+    private readonly baselines;
+    constructor(graphql: GraphQLClient);
+    listProjects(scope: ModStudioProjectScope): Promise<ModStudioProjectSummary[]>;
+    getProject(input: ModStudioProjectScope & {
+        projectId: string;
+    }): Promise<ModStudioProject>;
+    createProject(input: CreateModStudioProjectInput): Promise<ModStudioProject>;
+    saveProject(input: SaveModStudioProjectInput): Promise<ModStudioProject>;
+    listPersonalLibraryFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    savePersonalLibraryFile(input: SaveModStudioLibraryFileInput): Promise<ModStudioReferenceFile>;
+    listCommonFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    importReferenceFile(input: ImportModStudioReferenceFileInput): Promise<ModStudioProject>;
+    private remember;
+    private request;
+}
+//# sourceMappingURL=playerCodeProjects.d.ts.map

package/dist/domains/playerCodeProjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playerCodeProjects.d.ts","sourceRoot":"","sources":["../../src/domains/playerCodeProjects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQlD,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EAEtC,KAAK,gBAAgB,EAErB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AA0BjC;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,wBAAwB;IAGxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;gBAEpC,OAAO,EAAE,aAAa;IAE7C,YAAY,CAChB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAU/B,UAAU,CACd,KAAK,EAAE,qBAAqB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,gBAAgB,CAAC;IAQtB,aAAa,CACjB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAoBtB,WAAW,CACf,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAwDtB,wBAAwB,CAC5B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAU9B,uBAAuB,CAC3B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,CAAC;IAc5B,eAAe,CACnB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAS9B,mBAAmB,CACvB,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,gBAAgB,CAAC;IAuB5B,OAAO,CAAC,QAAQ;YAKF,OAAO;CAiBtB"}

package/dist/domains/playerCodeProjects.js

@@ -0,0 +1,299 @@
+import { CrowdyGraphQLError, CrowdyHttpError, CrowdyNetworkError, CrowdyTimeoutError, } from '../errors.js';
+import { ModStudioOfflineError, ModStudioRevisionConflictError, normalizeModStudioPath, } from '../mod-studio/models.js';
+import { PlayerCodeCommonFilesDocument, PlayerCodeImportSource, PlayerCodeLibraryFilesDocument, PlayerCodeLibrarySaveDocument, PlayerCodePairingPreference, PlayerCodeProjectCreateDocument, PlayerCodeProjectDocument, PlayerCodeProjectImportFileDocument, PlayerCodeProjectSaveDocument, PlayerCodeProjectsDocument, } from '../generated/graphql.js';
+/**
+ * Typed Game API adapter for private Mod Studio projects and reusable files.
+ * Mutable projects remain separate from immutable player-compute versions;
+ * only the controller's deploy path converts target files to sourceFilesJson.
+ */
+export class PlayerCodeProjectsAPI {
+    constructor(graphql) {
+        this.graphql = graphql;
+        this.baselines = new Map();
+    }
+    async listProjects(scope) {
+        const data = await this.request(PlayerCodeProjectsDocument, {
+            appId: scope.appId,
+            includeArchived: false,
+            limit: 50,
+            offset: 0,
+        });
+        return data.playerCodeProjects.map(fromSummaryDto);
+    }
+    async getProject(input) {
+        const data = await this.request(PlayerCodeProjectDocument, {
+            appId: input.appId,
+            projectId: input.projectId,
+        });
+        return this.remember(fromProjectDto(data.playerCodeProject, input.gridId));
+    }
+    async createProject(input) {
+        const data = await this.request(PlayerCodeProjectCreateDocument, {
+            input: {
+                appId: input.appId,
+                gridId: input.gridId,
+                name: input.metadata.name,
+                description: input.metadata.description ?? null,
+                serverModuleName: input.metadata.serverModuleName ?? null,
+                clientModuleName: input.metadata.clientModuleName ?? null,
+                pairingPreference: toApiPairing(input.kind, input.metadata.pairingPreference),
+                sdkVersion: '0.1.5',
+                abiVersion: 0,
+                initialFiles: input.files.map(toApiFile),
+            },
+        });
+        return this.remember(fromProjectDto(data.playerCodeProjectCreate, input.gridId));
+    }
+    async saveProject(input) {
+        try {
+            const baseline = this.baselines.get(input.projectId) ??
+                (await this.getProject({
+                    appId: input.appId,
+                    gridId: input.gridId,
+                    projectId: input.projectId,
+                }));
+            const delta = projectFileDelta(baseline, input);
+            const data = await this.request(PlayerCodeProjectSaveDocument, {
+                input: {
+                    appId: input.appId,
+                    projectId: input.projectId,
+                    expectedRevision: input.expectedRevisionId,
+                    gridId: input.gridId,
+                    name: input.metadata.name,
+                    description: input.metadata.description ?? null,
+                    serverModuleName: input.metadata.serverModuleName ?? null,
+                    clientModuleName: input.metadata.clientModuleName ?? null,
+                    pairingPreference: toApiPairing(projectKind(input), input.metadata.pairingPreference),
+                    upserts: delta.upserts.map(toApiFile),
+                    deletes: delta.deletes.map(({ target, path }) => ({
+                        target: target,
+                        path,
+                    })),
+                },
+            });
+            return this.remember(fromProjectDto(data.playerCodeProjectSave, input.gridId));
+        }
+        catch (error) {
+            if (error instanceof CrowdyGraphQLError &&
+                error.code === 'CONFLICT' &&
+                error.message.includes('PLAYER_CODE_REVISION_CONFLICT')) {
+                let remoteProject;
+                try {
+                    remoteProject = await this.getProject({
+                        appId: input.appId,
+                        gridId: input.gridId,
+                        projectId: input.projectId,
+                    });
+                }
+                catch {
+                    // The conflict remains actionable if the follow-up read fails.
+                }
+                throw new ModStudioRevisionConflictError(error.message, remoteProject);
+            }
+            throw error;
+        }
+    }
+    async listPersonalLibraryFiles(scope) {
+        const data = await this.request(PlayerCodeLibraryFilesDocument, {
+            appId: scope.appId,
+            includeArchived: false,
+            limit: 100,
+            offset: 0,
+        });
+        return data.playerCodeLibraryFiles.map(fromLibraryDto);
+    }
+    async savePersonalLibraryFile(input) {
+        const data = await this.request(PlayerCodeLibrarySaveDocument, {
+            input: {
+                appId: input.appId,
+                title: input.title,
+                pathHint: normalizeModStudioPath(input.path),
+                target: input.target,
+                tags: input.tags ?? [],
+                content: input.content,
+            },
+        });
+        return fromLibraryDto(data.playerCodeLibrarySave);
+    }
+    async listCommonFiles(scope) {
+        const data = await this.request(PlayerCodeCommonFilesDocument, {
+            appId: scope.appId,
+            limit: 100,
+            offset: 0,
+        });
+        return data.playerCodeCommonFiles.map(fromCommonDto);
+    }
+    async importReferenceFile(input) {
+        const data = await this.request(PlayerCodeProjectImportFileDocument, {
+            input: {
+                appId: input.appId,
+                projectId: input.projectId,
+                expectedProjectRevision: input.expectedRevisionId,
+                source: input.source === 'PERSONAL_LIBRARY'
+                    ? PlayerCodeImportSource.Library
+                    : PlayerCodeImportSource.Common,
+                ...(input.source === 'PERSONAL_LIBRARY'
+                    ? { libraryFileId: input.referenceId }
+                    : { commonVersionId: input.referenceId }),
+                ...(input.destinationPath
+                    ? { destinationPath: normalizeModStudioPath(input.destinationPath) }
+                    : {}),
+            },
+        });
+        return this.remember(fromProjectDto(data.playerCodeProjectImportFile, input.gridId));
+    }
+    remember(project) {
+        this.baselines.set(project.projectId, cloneProject(project));
+        return project;
+    }
+    async request(document, variables) {
+        try {
+            return await this.graphql.request(document, variables);
+        }
+        catch (error) {
+            if (error instanceof CrowdyNetworkError ||
+                error instanceof CrowdyTimeoutError ||
+                (error instanceof CrowdyHttpError && error.status >= 500)) {
+                throw new ModStudioOfflineError(error.message, error);
+            }
+            throw error;
+        }
+    }
+}
+function fromSummaryDto(dto) {
+    return {
+        projectId: dto.projectId,
+        name: dto.name,
+        kind: kindFromApi(dto.pairingPreference),
+        revisionId: String(dto.revision),
+        ...(dto.serverModuleName
+            ? { serverModuleName: dto.serverModuleName }
+            : {}),
+        ...(dto.clientModuleName
+            ? { clientModuleName: dto.clientModuleName }
+            : {}),
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromProjectDto(dto, fallbackGridId) {
+    const files = dto.files.map((file) => ({
+        target: file.target,
+        path: normalizeModStudioPath(file.path),
+        content: file.content,
+    }));
+    return {
+        projectId: dto.projectId,
+        appId: String(dto.appId),
+        gridId: dto.gridId == null ? fallbackGridId : String(dto.gridId),
+        kind: kindFromApi(dto.pairingPreference),
+        metadata: {
+            name: dto.name,
+            ...(dto.description ? { description: dto.description } : {}),
+            ...(dto.serverModuleName
+                ? { serverModuleName: dto.serverModuleName }
+                : {}),
+            ...(dto.clientModuleName
+                ? { clientModuleName: dto.clientModuleName }
+                : {}),
+            pairingPreference: fromApiPairing(dto.pairingPreference),
+        },
+        files,
+        sdkVersion: dto.sdkVersion,
+        abiVersion: dto.abiVersion,
+        revision: {
+            id: String(dto.revision),
+            savedAt: dto.updatedAt,
+        },
+        createdAt: dto.createdAt,
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromLibraryDto(dto) {
+    return {
+        id: dto.libraryFileId,
+        source: 'PERSONAL_LIBRARY',
+        title: dto.title,
+        target: dto.target,
+        path: normalizeModStudioPath(dto.pathHint),
+        content: dto.content,
+        tags: [...dto.tags],
+        updatedAt: dto.updatedAt,
+    };
+}
+function fromCommonDto(dto) {
+    return {
+        id: dto.versionId,
+        source: 'COMMON',
+        title: dto.title,
+        target: dto.target,
+        path: normalizeModStudioPath(dto.path),
+        content: dto.content,
+        tags: [...dto.tags],
+        updatedAt: dto.updatedAt,
+    };
+}
+function kindFromApi(pairing) {
+    if (pairing === PlayerCodePairingPreference.ServerOnly)
+        return 'SERVER';
+    if (pairing === PlayerCodePairingPreference.ClientOnly)
+        return 'CLIENT';
+    return 'FULL_STACK';
+}
+function fromApiPairing(pairing) {
+    if (pairing === PlayerCodePairingPreference.Paired)
+        return 'REQUIRED';
+    if (pairing === PlayerCodePairingPreference.Independent)
+        return 'OPTIONAL';
+    return 'NONE';
+}
+function toApiPairing(kind, pairing) {
+    if (kind === 'SERVER')
+        return PlayerCodePairingPreference.ServerOnly;
+    if (kind === 'CLIENT')
+        return PlayerCodePairingPreference.ClientOnly;
+    return pairing === 'REQUIRED'
+        ? PlayerCodePairingPreference.Paired
+        : PlayerCodePairingPreference.Independent;
+}
+function toApiFile(file) {
+    return {
+        target: file.target,
+        path: normalizeModStudioPath(file.path),
+        content: file.content,
+    };
+}
+function projectKind(input) {
+    const hasServer = input.files.some((file) => file.target === 'SERVER');
+    const hasClient = input.files.some((file) => file.target === 'CLIENT');
+    if (hasServer && hasClient)
+        return 'FULL_STACK';
+    if (hasServer)
+        return 'SERVER';
+    return 'CLIENT';
+}
+function projectFileDelta(baseline, input) {
+    const previous = new Map(baseline.files.map((file) => [
+        `${file.target}:${normalizeModStudioPath(file.path)}`,
+        file,
+    ]));
+    const current = new Map(input.files.map((file) => [
+        `${file.target}:${normalizeModStudioPath(file.path)}`,
+        file,
+    ]));
+    const upserts = input.files.filter((file) => {
+        const before = previous.get(`${file.target}:${normalizeModStudioPath(file.path)}`);
+        return !before || before.content !== file.content;
+    });
+    const deletes = baseline.files
+        .filter((file) => !current.has(`${file.target}:${normalizeModStudioPath(file.path)}`))
+        .map((file) => ({ target: file.target, path: file.path }));
+    return { upserts, deletes };
+}
+function cloneProject(project) {
+    return {
+        ...project,
+        metadata: { ...project.metadata },
+        files: project.files.map((file) => ({ ...file })),
+        revision: { ...project.revision },
+    };
+}

package/dist/domains/playerCompute.d.ts

@@ -77,7 +77,7 @@ export declare class PlayerComputeAPI {
     /**
      * Fetch a client artifact and decode its bytes to an ArrayBuffer plus the
      * broker inputs (content hash for side-load verification, per-dispatch fuel
-     * budget). Convenience over {@link artifact} for the live-coding client
+     * budget). Convenience over {@link artifact} for the Mod Studio CLIENT
      * deploy loop.
      */
     artifactBytes(variables: PlayerComputeArtifactQueryVariables): Promise<{

package/dist/domains/playerCompute.js

@@ -116,7 +116,7 @@ export class PlayerComputeAPI {
     /**
      * Fetch a client artifact and decode its bytes to an ArrayBuffer plus the
      * broker inputs (content hash for side-load verification, per-dispatch fuel
-     * budget). Convenience over {@link artifact} for the live-coding client
+     * budget). Convenience over {@link artifact} for the Mod Studio CLIENT
      * deploy loop.
      */
     async artifactBytes(variables) {