@el4cteo/rbx-studio-mcp 0.6.1 → 0.6.7

package/dist/lib/liveops.js

@@ -0,0 +1,358 @@
+import { ToolError } from "./errors.js";
+import { call, paged } from "./opencloud.js";
+/**
+ * Operating the published experience, over Open Cloud.
+ *
+ * Everything here acts on the game as it exists on Roblox rather than on the
+ * place someone has open in Studio: its scripts, its servers, its players, its
+ * saved data. That is a different job from building, and the failure modes are
+ * different too — there is no undo stack and the audience is real.
+ *
+ * Two things in here are long-running operations rather than requests. Roblox
+ * answers the Instance calls with an `Operation` to poll, because reaching into
+ * a place file is not instant. `awaitOperation` hides that; nothing else should
+ * have to know.
+ */
+const OPERATION_INTERVAL_MS = 1_000;
+const OPERATION_TIMEOUT_MS = 60_000;
+/**
+ * Polls an Operation to completion and returns its payload.
+ *
+ * The error case is worth naming rather than passing through: a 422 here means
+ * the response exceeded Roblox's 500,000-byte cap, which is a real and
+ * recoverable situation (ask for fewer children, or a smaller script) and reads
+ * as nothing at all in the raw body.
+ */
+async function awaitOperation(credentials, started, scope) {
+    let operation = started;
+    const deadline = Date.now() + OPERATION_TIMEOUT_MS;
+    while (!operation.done) {
+        if (!operation.path) {
+            throw new ToolError("NO_OPERATION", "Roblox did not say where to track this request.");
+        }
+        if (Date.now() >= deadline) {
+            throw new ToolError("TIMEOUT", "Roblox did not finish this request in time.");
+        }
+        await new Promise((done) => setTimeout(done, OPERATION_INTERVAL_MS));
+        operation = await call(credentials, {
+            path: `/cloud/v2/${operation.path}`,
+            scope,
+        });
+    }
+    if (operation.error) {
+        if (operation.error.code === 422) {
+            throw new ToolError("TOO_LARGE", "The response was over Roblox's 500,000-byte limit for this API.", "Ask for a smaller piece: fewer children at a time, or one script rather " +
+                "than a folder.");
+        }
+        throw new ToolError("OPERATION_FAILED", `Roblox refused: ${operation.error.message ?? operation.error.code ?? "no reason given"}`);
+    }
+    return operation.response ?? {};
+}
+/**
+ * The Instance API: scripts in the PUBLISHED place, without Studio.
+ *
+ * Narrower than it first looks, and the narrowness is the important part.
+ * Roblox's `InstanceDetails` covers exactly four classes — Folder, Script,
+ * LocalScript and ModuleScript — so this is not a live DataModel browser. It is
+ * a way to read and edit the code of a published place from outside Studio,
+ * which is why it belongs beside `script_read` and `script_edit` rather than
+ * beside `tree` and `modify`.
+ *
+ * It also acts on the saved place, not on a running server. Editing here
+ * changes what the next server to start will run; it does not change what a
+ * player in a server right now is running. `restartServers` is the other half
+ * of that, and they are meant to be used together.
+ */
+const INSTANCE_SCOPE = "universe.place.instance:read";
+const INSTANCE_WRITE = "universe.place.instance:write";
+function instancePath(universe, place, instance) {
+    return (`/cloud/v2/universes/${encodeURIComponent(universe)}` +
+        `/places/${encodeURIComponent(place)}/instances/${encodeURIComponent(instance)}`);
+}
+/** Flattens one instance into the shape the script tools already speak. */
+function describe(entry) {
+    const engine = entry.engineInstance ?? {};
+    const details = engine.Details ?? {};
+    const className = Object.keys(details)[0] ?? "Instance";
+    const body = details[className] ?? {};
+    return {
+        id: engine.Id,
+        name: engine.Name,
+        className,
+        hasChildren: entry.hasChildren ?? false,
+        ...(body.Source === undefined ? {} : { source: body.Source }),
+        ...(body.Enabled === undefined ? {} : { enabled: body.Enabled }),
+        ...(body.RunContext === undefined ? {} : { runContext: body.RunContext }),
+    };
+}
+export async function liveInstance(credentials, args) {
+    const started = await call(credentials, {
+        path: instancePath(args.universeId, args.placeId, args.instanceId),
+        scope: INSTANCE_SCOPE,
+    });
+    const done = await awaitOperation(credentials, started, INSTANCE_SCOPE);
+    return describe(done);
+}
+export async function liveChildren(credentials, args) {
+    const started = await call(credentials, {
+        path: `${instancePath(args.universeId, args.placeId, args.instanceId)}:listChildren`,
+        query: { maxPageSize: Math.min(args.limit, 100) },
+        scope: INSTANCE_SCOPE,
+    });
+    const done = await awaitOperation(credentials, started, INSTANCE_SCOPE);
+    const items = done["instances"] ?? [];
+    return {
+        parent: args.instanceId,
+        items: items.slice(0, args.limit).map(describe),
+        count: Math.min(items.length, args.limit),
+    };
+}
+/**
+ * Resolves a dot path to a cloud instance id by walking down from the root.
+ *
+ * The Instance API addresses things by GUID, not by name, and offers no search.
+ * So a path everyone already writes -- "ServerScriptService.Systems.Combat" --
+ * costs one listChildren per segment, and each of those is a long-running
+ * operation. Three segments is a few seconds.
+ *
+ * Worth paying rather than making callers hunt for GUIDs: every other tool here
+ * takes a path, and a live read that needed a different kind of address would
+ * be a different tool wearing this one's name.
+ */
+export async function resolveLivePath(credentials, args) {
+    const segments = args.path.split(".").filter((part) => part !== "");
+    if (segments.length === 0) {
+        throw new ToolError("BAD_PARAMS", "A live script path cannot be empty.");
+    }
+    let current = "root";
+    let found = null;
+    for (const segment of segments) {
+        const children = await liveChildren(credentials, {
+            universeId: args.universeId,
+            placeId: args.placeId,
+            instanceId: current,
+            limit: 100,
+        });
+        const items = children["items"];
+        const match = items.find((entry) => entry["name"] === segment);
+        if (!match) {
+            const names = items
+                .slice(0, 12)
+                .map((entry) => String(entry["name"]))
+                .join(", ");
+            throw new ToolError("NOT_FOUND", `The published place has no "${segment}" under ${current === "root" ? "the root" : current}.`, names === ""
+                ? "Nothing is there. Note the Instance API only sees Folders and " +
+                    "scripts, so a path through any other class cannot be walked."
+                : `What is there: ${names}. The Instance API only sees Folders and ` +
+                    "scripts, so a path through a Model or a Part cannot be walked.");
+        }
+        current = String(match["id"]);
+        found = match;
+    }
+    return {
+        id: current,
+        className: String(found?.["className"] ?? "Instance"),
+        name: String(found?.["name"] ?? segments[segments.length - 1]),
+    };
+}
+export async function liveScriptWrite(credentials, args) {
+    // Roblox caps the source at 200,000 bytes AFTER UTF-8 encoding, so the check
+    // is on bytes rather than on characters — a script of emoji or non-Latin
+    // comments is several times longer than its length suggests.
+    const bytes = Buffer.byteLength(args.source, "utf8");
+    if (bytes > 200_000) {
+        throw new ToolError("TOO_LARGE", `That source is ${bytes} bytes; Roblox accepts 200,000 for a cloud script edit.`);
+    }
+    const started = await call(credentials, {
+        method: "PATCH",
+        path: instancePath(args.universeId, args.placeId, args.instanceId),
+        body: {
+            engineInstance: {
+                Details: { [args.className]: { Source: args.source } },
+            },
+        },
+        scope: INSTANCE_WRITE,
+    });
+    const done = await awaitOperation(credentials, started, INSTANCE_WRITE);
+    return {
+        ...describe(done),
+        written: true,
+        bytes,
+        note: "This changed the SAVED place. Servers already running still have the old " +
+            "code — restart them with `assets op=\"publish\" restart:true`, or wait for " +
+            "them to cycle.",
+    };
+}
+/**
+ * Rolls live servers onto the newly published version.
+ *
+ * Publishing alone changes nothing for anyone already playing: they stay on the
+ * server they are on, running the old code, until it empties. This is the step
+ * people forget, which is why it sits on the publish call rather than on its
+ * own.
+ *
+ * `bleedOff` is the humane default and is not the API's. Roblox defaults to
+ * shutting servers down immediately, which teleports players mid-game; bleeding
+ * off stops matchmaking and lets them finish.
+ */
+export async function restartServers(credentials, args) {
+    const bleed = args.bleedOffMinutes ?? 10;
+    await call(credentials, {
+        method: "POST",
+        path: `/cloud/v2/universes/${encodeURIComponent(args.universeId)}:restartServers`,
+        body: {
+            placeIds: args.placeIds,
+            bleedOffServers: bleed > 0,
+            bleedOffDurationMinutes: bleed > 0 ? bleed : undefined,
+        },
+        scope: "universe:write",
+    });
+    return {
+        restarted: true,
+        universeId: args.universeId,
+        bleedOffMinutes: bleed,
+        note: bleed > 0
+            ? `Matchmaking to old servers has stopped; they shut down over the next ${bleed} ` +
+                "minutes so players can finish."
+            : "Servers are shutting down now. Anyone playing is being moved immediately.",
+    };
+}
+/** Sends a MessagingService message to every live server. */
+export async function publishMessage(credentials, args) {
+    await call(credentials, {
+        method: "POST",
+        path: `/cloud/v2/universes/${encodeURIComponent(args.universeId)}:publishMessage`,
+        body: { topic: args.topic, message: args.message },
+        scope: "universe-messaging-service:publish",
+    });
+    return {
+        published: true,
+        topic: args.topic,
+        note: "Delivered only to servers with a SubscribeAsync listener on this exact " +
+            "topic. Nothing reports whether anything was listening, so a silent " +
+            "success does not mean it was received.",
+    };
+}
+/**
+ * Takes a data store snapshot for the whole experience.
+ *
+ * The safety net for every live write. Roblox allows one snapshot per
+ * experience per UTC day, and says in the response whether this call actually
+ * took one — which matters, because a second call on the same day reports
+ * success while doing nothing.
+ */
+export async function snapshotDataStores(credentials, universeId) {
+    const result = await call(credentials, {
+        method: "POST",
+        path: `/cloud/v2/universes/${encodeURIComponent(universeId)}/data-stores:snapshot`,
+        body: {},
+        scope: "universe-datastores.control:snapshot",
+    });
+    return {
+        newSnapshotTaken: result.newSnapshotTaken === true,
+        latestSnapshotTime: result.latestSnapshotTime,
+        note: result.newSnapshotTaken === true
+            ? "Snapshot taken. Safe to make the change."
+            : "NO new snapshot was taken — Roblox allows one per experience per UTC " +
+                `day and one already exists (${result.latestSnapshotTime}). Anything ` +
+                "written since then is NOT covered.",
+    };
+}
+/** Bans or unbans a player, across the experience or one place. */
+export async function setRestriction(credentials, args) {
+    const base = args.placeId
+        ? `/cloud/v2/universes/${encodeURIComponent(args.universeId)}/places/${encodeURIComponent(args.placeId)}`
+        : `/cloud/v2/universes/${encodeURIComponent(args.universeId)}`;
+    const restriction = { active: args.active };
+    if (args.active) {
+        // Omitted duration means permanent, which is the engine's rule and is worth
+        // making the caller state rather than defaulting to.
+        if (args.durationSeconds)
+            restriction["duration"] = `${args.durationSeconds}s`;
+        restriction["displayReason"] = args.displayReason ?? "";
+        restriction["privateReason"] = args.privateReason ?? "";
+        restriction["excludeAltAccounts"] = args.excludeAltAccounts ?? false;
+    }
+    const result = await call(credentials, {
+        method: "PATCH",
+        path: `${base}/user-restrictions/${encodeURIComponent(args.userId)}`,
+        body: { gameJoinRestriction: restriction },
+        scope: "universe.user-restriction:write",
+    });
+    return {
+        userId: args.userId,
+        banned: args.active,
+        scope: args.placeId ? `place ${args.placeId}` : `universe ${args.universeId}`,
+        duration: args.durationSeconds ? `${args.durationSeconds}s` : args.active ? "permanent" : null,
+        restriction: result.gameJoinRestriction,
+    };
+}
+export async function listRestrictions(credentials, args) {
+    const { items } = await paged(credentials, {
+        path: `/cloud/v2/universes/${encodeURIComponent(args.universeId)}/user-restrictions`,
+        scope: "universe.user-restriction:read",
+        field: "userRestrictions",
+        limit: args.limit,
+    });
+    return {
+        items: items.map((entry) => ({
+            user: entry.user?.replace("users/", ""),
+            active: entry.gameJoinRestriction?.active ?? false,
+            duration: entry.gameJoinRestriction?.duration ?? "permanent",
+            reason: entry.gameJoinRestriction?.displayReason,
+            updated: entry.updateTime,
+        })),
+        count: items.length,
+    };
+}
+/** Looks up a user: the id-to-name step almost every other call needs. */
+export async function getUser(credentials, userId) {
+    return call(credentials, {
+        path: `/cloud/v2/users/${encodeURIComponent(userId)}`,
+        scope: "user.advanced:read",
+    });
+}
+/** What a user owns: passes, badges, assets, private servers. */
+export async function getInventory(credentials, args) {
+    const { items } = await paged(credentials, {
+        path: `/cloud/v2/users/${encodeURIComponent(args.userId)}/inventory-items`,
+        query: { filter: args.filter },
+        scope: "user.inventory-item:read",
+        field: "inventoryItems",
+        limit: args.limit,
+    });
+    return { userId: args.userId, items, count: items.length };
+}
+/**
+ * How many uploads are left before Roblox starts refusing them.
+ *
+ * Audio is the one that bites: ten a month unverified. Worth checking before a
+ * batch rather than discovering it on the eleventh.
+ */
+export async function assetQuotas(credentials) {
+    const { items } = await paged(credentials, {
+        path: `/cloud/v2/users/${encodeURIComponent(credentials.creatorId)}/asset-quotas`,
+        scope: "assets:write",
+        field: "assetQuotas",
+        limit: 50,
+    });
+    return {
+        items: items
+            .filter((entry) => entry.quotaType === "RATE_LIMIT_UPLOAD")
+            .map((entry) => {
+            // Roblox sends capacity as a STRING ("2000"). Subtracting from it works
+            // by coercion and would stop working the day they send a number, so it
+            // is converted rather than relied upon.
+            const capacity = entry.capacity === undefined ? undefined : Number(entry.capacity);
+            const used = Number(entry.usage ?? 0);
+            return {
+                assetType: entry.assetType,
+                used,
+                capacity,
+                remaining: capacity === undefined ? undefined : capacity - used,
+                resets: entry.expirationTime,
+            };
+        }),
+    };
+}
+//# sourceMappingURL=liveops.js.map

package/dist/lib/liveops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveops.js","sourceRoot":"","sources":["../../src/lib/liveops.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,MAAM,qBAAqB,GAAG,KAAK,CAAC;AACpC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AASpC;;;;;;;GAOG;AACH,KAAK,UAAU,cAAc,CAC3B,WAAwB,EACxB,OAAkB,EAClB,KAA0C;IAE1C,IAAI,SAAS,GAAG,OAAO,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC;IAEnD,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,SAAS,CAAC,cAAc,EAAE,iDAAiD,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,SAAS,CAAC,SAAS,EAAE,6CAA6C,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACrE,SAAS,GAAG,MAAM,IAAI,CAAY,WAAW,EAAE;YAC7C,IAAI,EAAE,aAAa,SAAS,CAAC,IAAI,EAAE;YACnC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CACjB,WAAW,EACX,iEAAiE,EACjE,0EAA0E;gBACxE,gBAAgB,CACnB,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,kBAAkB,EAClB,mBAAmB,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,cAAc,GAAG,8BAAuC,CAAC;AAC/D,MAAM,cAAc,GAAG,+BAAwC,CAAC;AAEhE,SAAS,YAAY,CAAC,QAAgB,EAAE,KAAa,EAAE,QAAgB;IACrE,OAAO,CACL,uBAAuB,kBAAkB,CAAC,QAAQ,CAAC,EAAE;QACrD,WAAW,kBAAkB,CAAC,KAAK,CAAC,cAAc,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACjF,CAAC;AACJ,CAAC;AAeD,2EAA2E;AAC3E,SAAS,QAAQ,CAAC,KAAoB;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS;QACT,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK;QACvC,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAwB,EACxB,IAAiE;IAEjE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAY,WAAW,EAAE;QACjD,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;QAClE,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,IAAqB,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAwB,EACxB,IAAgF;IAEhF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAY,WAAW,EAAE;QACjD,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,eAAe;QACpF,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE;QACjD,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACxE,MAAM,KAAK,GAAI,IAAI,CAAC,WAAW,CAAiC,IAAI,EAAE,CAAC;IACvE,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/C,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAwB,EACxB,IAA2D;IAE3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,YAAY,EAAE,qCAAqC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,IAAI,KAAK,GAAmC,IAAI,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE;YAC/C,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,OAAO;YACnB,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAmC,CAAC;QAClE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,KAAK;iBAChB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACZ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;iBACrC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,WAAW,EACX,+BAA+B,OAAO,WAAW,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,GAAG,EAC7F,KAAK,KAAK,EAAE;gBACV,CAAC,CAAC,gEAAgE;oBAChE,8DAA8D;gBAChE,CAAC,CAAC,kBAAkB,KAAK,2CAA2C;oBAClE,gEAAgE,CACrE,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC;QACrD,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAwB,EACxB,IAMC;IAED,6EAA6E;IAC7E,yEAAyE;IACzE,6DAA6D;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CACjB,WAAW,EACX,kBAAkB,KAAK,yDAAyD,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAY,WAAW,EAAE;QACjD,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;QAClE,IAAI,EAAE;YACJ,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE;aACvD;SACF;QACD,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACxE,OAAO;QACL,GAAG,QAAQ,CAAC,IAAqB,CAAC;QAClC,OAAO,EAAE,IAAI;QACb,KAAK;QACL,IAAI,EACF,2EAA2E;YAC3E,6EAA6E;YAC7E,gBAAgB;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,IAA2E;IAE3E,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,CAAC,WAAW,EAAE;QACtB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB;QACjF,IAAI,EAAE;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,KAAK,GAAG,CAAC;YAC1B,uBAAuB,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACvD;QACD,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,KAAK;QACtB,IAAI,EACF,KAAK,GAAG,CAAC;YACP,CAAC,CAAC,wEAAwE,KAAK,GAAG;gBAChF,gCAAgC;YAClC,CAAC,CAAC,2EAA2E;KAClF,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,IAA4D;IAE5D,MAAM,IAAI,CAAC,WAAW,EAAE;QACtB,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB;QACjF,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;QAClD,KAAK,EAAE,oCAAoC;KAC5C,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EACF,yEAAyE;YACzE,qEAAqE;YACrE,wCAAwC;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAwB,EACxB,UAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,WAAW,EACX;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,uBAAuB,kBAAkB,CAAC,UAAU,CAAC,uBAAuB;QAClF,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,sCAAsC;KAC9C,CACF,CAAC;IACF,OAAO;QACL,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,KAAK,IAAI;QAClD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,IAAI,EACF,MAAM,CAAC,gBAAgB,KAAK,IAAI;YAC9B,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,uEAAuE;gBACvE,+BAA+B,MAAM,CAAC,kBAAkB,cAAc;gBACtE,oCAAoC;KAC3C,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,IASC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;QACvB,CAAC,CAAC,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QACzG,CAAC,CAAC,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;IAEjE,MAAM,WAAW,GAA4B,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACrE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,4EAA4E;QAC5E,qDAAqD;QACrD,IAAI,IAAI,CAAC,eAAe;YAAE,WAAW,CAAC,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC;QAC/E,WAAW,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;QACxD,WAAW,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;QACxD,WAAW,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,WAAW,EACX;QACE,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,GAAG,IAAI,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QACpE,IAAI,EAAE,EAAE,mBAAmB,EAAE,WAAW,EAAE;QAC1C,KAAK,EAAE,iCAAiC;KACzC,CACF,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE;QAC7E,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;QAC9F,WAAW,EAAE,MAAM,CAAC,mBAAmB;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAwB,EACxB,IAA2C;IAE3C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAI1B,WAAW,EAAE;QACd,IAAI,EAAE,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,oBAAoB;QACpF,KAAK,EAAE,gCAAgC;QACvC,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACvC,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,MAAM,IAAI,KAAK;YAClD,QAAQ,EAAE,KAAK,CAAC,mBAAmB,EAAE,QAAQ,IAAI,WAAW;YAC5D,MAAM,EAAE,KAAK,CAAC,mBAAmB,EAAE,aAAa;YAChD,OAAO,EAAE,KAAK,CAAC,UAAU;SAC1B,CAAC,CAAC;QACH,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,WAAwB,EACxB,MAAc;IAEd,OAAO,IAAI,CAA0B,WAAW,EAAE;QAChD,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,EAAE;QACrD,KAAK,EAAE,oBAAoB;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAwB,EACxB,IAAwD;IAExD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAA0B,WAAW,EAAE;QAClE,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB;QAC1E,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;QAC9B,KAAK,EAAE,0BAA0B;QACjC,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAwB;IAExB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAM1B,WAAW,EAAE;QACd,IAAI,EAAE,mBAAmB,kBAAkB,CAAC,WAAW,CAAC,SAAS,CAAC,eAAe;QACjF,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,EAAE;KACV,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,KAAK;aACT,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,mBAAmB,CAAC;aAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,wEAAwE;YACxE,uEAAuE;YACvE,wCAAwC;YACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtC,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI;gBACJ,QAAQ;gBACR,SAAS,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI;gBAC/D,MAAM,EAAE,KAAK,CAAC,cAAc;aAC7B,CAAC;QACJ,CAAC,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/lib/opencloud.js

@@ -0,0 +1,235 @@
+import { loadCredentials } from "./credentials.js";
+import { ToolError } from "./errors.js";
+/**
+ * One HTTP client for every Open Cloud call this server makes.
+ *
+ * Six features now talk to apis.roblox.com — uploads, asset grants, live data
+ * stores, ordered data stores, place publishing and remote Luau. They share an
+ * auth header, a set of failure modes and a pagination scheme, and the failure
+ * modes are the reason this is one file rather than six copies: Roblox answers
+ * a missing scope, a stale IP allowlist and a revoked key with the same 403 and
+ * a body that names none of them. Guessing wrong there costs an hour, so the
+ * guess is made once, here, with the scope that was actually needed in hand.
+ */
+const BASE = "https://apis.roblox.com";
+/**
+ * The credentials, or a ToolError explaining exactly what is missing.
+ *
+ * Thrown rather than returned. Every caller does the same thing with an
+ * incomplete setup — stop and say so — and an early return per call site is how
+ * one of them ends up forgetting.
+ */
+export async function requireCredentials() {
+    const found = await loadCredentials();
+    if (found !== null)
+        return found;
+    throw new ToolError("NO_CREDENTIALS", "No Open Cloud API key is set up, so this cannot run.", "The user sets it once by typing `cloud` in the Studio panel — it walks " +
+        "through creating the key and storing it safely. Never ask them to paste " +
+        "a key into this conversation.");
+}
+/**
+ * The universe id, which every universe-scoped call needs and none can guess.
+ *
+ * Open Cloud is stateless: unlike the engine API it has no idea which game it
+ * is talking about, and the Studio session cannot supply it either — a place
+ * open in Studio knows its placeId but not the universe that contains it.
+ */
+/**
+ * Turns a place id into the universe that contains it.
+ *
+ * Not part of Open Cloud and not in Roblox's OpenAPI document, but it is the
+ * endpoint Studio and every deploy tool uses, it needs no key, and it is the
+ * only way to answer the question at all: a place knows nothing about its own
+ * universe, and every universe-scoped call needs one. Verified against a live
+ * place rather than taken from a forum post.
+ *
+ * Treated as best-effort. If Roblox ever moves it, the caller falls back to
+ * asking the user, which is where they were before.
+ */
+export async function universeForPlace(placeId) {
+    try {
+        const response = await fetch(`${BASE}/universes/v1/places/${encodeURIComponent(placeId)}/universe`);
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return body.universeId === undefined ? null : String(body.universeId);
+    }
+    catch {
+        return null;
+    }
+}
+export async function requireUniverse(explicit) {
+    if (explicit && explicit.trim() !== "")
+        return explicit.trim();
+    const found = await loadCredentials();
+    if (found?.universeId)
+        return found.universeId;
+    /**
+     * Derived from the place rather than demanded from the user.
+     *
+     * Someone who has told the panel which place they are working on has already
+     * said which game they mean; making them go and copy a second id off a web
+     * page to say it again is a papercut with nothing behind it.
+     */
+    if (found?.placeId) {
+        const derived = await universeForPlace(found.placeId);
+        if (derived)
+            return derived;
+    }
+    throw new ToolError("NO_UNIVERSE", "This needs a universe id and none is set.", "Ask the user to run `cloud universe <id>` in the Studio panel. They find " +
+        "it on the Creator Dashboard: hover the game's thumbnail, click the ⋯ " +
+        "button, Copy Universe ID. Or pass `universeId` to this call.");
+}
+export async function requirePlace(explicit) {
+    if (explicit && explicit.trim() !== "")
+        return explicit.trim();
+    const found = await loadCredentials();
+    if (found?.placeId)
+        return found.placeId;
+    throw new ToolError("NO_PLACE", "This needs a place id and none is set.", "Ask the user to run `cloud place <id>` in the Studio panel, or pass " +
+        "`placeId`. `studio_status` reports the placeId of the open place.");
+}
+/** Pulls something readable out of Roblox's several error body shapes. */
+function detailOf(body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (typeof parsed.error === "string")
+            return parsed.error;
+        return (parsed.message ??
+            (typeof parsed.error === "object" ? parsed.error?.message : undefined) ??
+            parsed.errors?.[0]?.message ??
+            body.slice(0, 300));
+    }
+    catch {
+        return body.slice(0, 300);
+    }
+}
+/**
+ * Turns an HTTP failure into an error a reader can act on.
+ *
+ * The 403 branch carries the whole value of this module. Roblox returns it for
+ * a key missing a scope, a key whose IP allowlist no longer matches, and a key
+ * with no access to that particular universe — three different fixes behind one
+ * status and a body that distinguishes none of them. Naming the scope the call
+ * needed turns "Forbidden" into a checklist.
+ */
+function failure(status, body, scope) {
+    const detail = detailOf(body);
+    if (status === 401) {
+        return new ToolError("BAD_KEY", `Roblox rejected the API key (401): ${detail}`, "The key is wrong or was revoked. `cloud test` in the Studio panel " +
+            "re-checks it.");
+    }
+    if (status === 403) {
+        return new ToolError("FORBIDDEN", `Roblox refused the key (403): ${detail}`, `This call needs the \`${scope}\` permission. Three things cause a 403 ` +
+            "and the message names none of them: the key is missing that scope, " +
+            "the key's IP allowlist no longer includes this machine, or the key " +
+            "was not granted access to this experience. Check them in that order " +
+            "on the Creator Dashboard.");
+    }
+    if (status === 404) {
+        return new ToolError("NOT_FOUND", `Roblox has no such thing (404): ${detail}`, "Check the universe id, place id, and any data store or key name — " +
+            "Open Cloud does not create parents implicitly.");
+    }
+    if (status === 429) {
+        return new ToolError("RATE_LIMITED", `Rate limited by Roblox: ${detail}`, "Wait and retry.");
+    }
+    if (status === 400) {
+        return new ToolError("BAD_REQUEST", `Roblox refused the request (400): ${detail}`);
+    }
+    return new ToolError("CLOUD_ERROR", `Roblox returned ${status}: ${detail}`);
+}
+/**
+ * One Open Cloud request.
+ *
+ * Returns parsed JSON, or `{}` for the endpoints that answer 200 with an empty
+ * body — a DELETE among them. A caller that needs the raw text should not be
+ * using this.
+ */
+export async function call(credentials, options) {
+    const url = new URL(options.path, BASE);
+    for (const [key, value] of Object.entries(options.query ?? {})) {
+        if (value !== undefined)
+            url.searchParams.set(key, String(value));
+    }
+    const headers = { "x-api-key": credentials.apiKey };
+    let body;
+    if (options.raw) {
+        headers["Content-Type"] = options.raw.contentType;
+        body = options.raw.bytes;
+    }
+    else if (options.body instanceof FormData) {
+        // Left unset on purpose: fetch adds the multipart boundary, and setting it
+        // by hand produces a body Roblox cannot parse.
+        body = options.body;
+    }
+    else if (options.body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        body = JSON.stringify(options.body);
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? 60_000);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: options.method ?? "GET",
+            headers,
+            body: body,
+            signal: controller.signal,
+        });
+    }
+    catch (cause) {
+        const error = cause;
+        throw new ToolError("CLOUD_UNREACHABLE", error.name === "AbortError"
+            ? "Roblox did not answer in time."
+            : `Could not reach Roblox: ${error.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const text = await response.text();
+    if (!response.ok)
+        throw failure(response.status, text, options.scope);
+    if (text.trim() === "")
+        return {};
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return { raw: text };
+    }
+}
+/**
+ * Walks a paged collection and returns at most `limit` items.
+ *
+ * Open Cloud pages everything and the page size it picks is not the number a
+ * caller asked for, so "the first 20 entries" is a loop, not a request. Capped
+ * rather than exhaustive: a data store can hold millions of keys, and the tool
+ * that asks for a page wants a page.
+ */
+export async function paged(credentials, options) {
+    const items = [];
+    let pageToken = options.query?.["pageToken"];
+    for (;;) {
+        const page = await call(credentials, {
+            ...options,
+            query: {
+                ...options.query,
+                maxPageSize: Math.min(options.limit - items.length, 100),
+                pageToken,
+            },
+        });
+        const batch = page[options.field] ?? [];
+        items.push(...batch);
+        pageToken = page["nextPageToken"];
+        // An empty page with a token still set would spin forever; Roblox does
+        // return that when a filter excludes everything on a page.
+        if (!pageToken || items.length >= options.limit || batch.length === 0) {
+            return {
+                items: items.slice(0, options.limit),
+                nextPageToken: pageToken,
+                truncated: Boolean(pageToken),
+            };
+        }
+    }
+}
+//# sourceMappingURL=opencloud.js.map

package/dist/lib/opencloud.js.map

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