@el4cteo/rbx-studio-mcp 0.8.4 → 0.8.6

package/dist/tools/spatial.js

@@ -1,135 +0,0 @@
-import { z } from "zod";
-import { json } from "../lib/format.js";
-import { defineTool } from "../lib/tool.js";
-/** A position, written the way the Properties panel shows one. */
-const position = z
-    .string()
-    .describe('A position, written as the Properties panel shows it: "12, 0, 5".');
-export function registerSpatialTools(context) {
-    const { bridge } = context;
-    defineTool(context, {
-        name: "spatial",
-        title: "Ask what is actually there",
-        description: "Casts a ray, block or sphere through the world, or lists every part " +
-            "inside a volume.\n\n" +
-            "This answers the one question the Explorer cannot: what is physically " +
-            "THERE. A path tells you an instance exists and where its pivot sits. " +
-            "It does not tell you the door frame is clipping into the wall, that " +
-            "the spawn is buried a stud inside the floor, or that nothing stands " +
-            "between the turret and the player. Every one of those is a query " +
-            "against the world, and geometry that is wrong in exactly that way " +
-            "looks completely correct in `inspect`.\n\n" +
-            "`op=\"cast\"` fires a shape and reports the first thing it meets: the " +
-            "part, where on it, the surface normal, the material and the distance. " +
-            "Aim it with `to` (a point to look at) or with `direction` plus " +
-            "`distance`. A miss comes back as `hit: false`, which is a real answer " +
-            "— that is how you confirm a sightline is clear or that there is no " +
-            "ground below.\n\n" +
-            "`op=\"overlap\"` lists what sits inside a volume: a box, a radius, or " +
-            "`region=\"part\"`, which takes an existing part and reports what " +
-            "overlaps it. That last one is the fastest way to find things clipping " +
-            "through each other.\n\n" +
-            "Narrow with `only` or `ignore` — a query over a whole place returns a " +
-            "transcript, not an answer. Set `collisionGroup` when the place uses " +
-            "them: a cast run in the wrong group reports a clear path through a " +
-            "wall the player cannot walk through, and a wrong answer of that shape " +
-            "is indistinguishable from a right one.\n\n" +
-            "`worldModel` points the query at a WorldModel inside a ViewportFrame " +
-            "instead of the Workspace. Those are separate worlds with their own " +
-            "parts and their own collision groups.",
-        readOnly: true,
-        inputSchema: {
-            op: z
-                .enum(["cast", "overlap"])
-                .default("cast")
-                .describe("'cast' fires a ray/block/sphere and reports the first hit; " +
-                "'overlap' lists everything inside a volume."),
-            shape: z
-                .enum(["ray", "block", "sphere"])
-                .optional()
-                .describe("cast only: 'ray' is a line and the usual choice. 'block' and " +
-                "'sphere' sweep a volume along the same path — use them when the " +
-                "thing moving has width, e.g. checking whether a character fits " +
-                "through a gap rather than whether a point does."),
-            from: position.optional().describe("cast only: where the cast starts."),
-            to: position
-                .optional()
-                .describe("cast only: a point to aim at. Use this for sightlines — it saves " +
-                "working out a direction vector, which is where sign errors live."),
-            direction: position
-                .optional()
-                .describe('cast only: which way to go, e.g. "0, -1, 0" for straight down. ' +
-                "Used with `distance`. Ignored when `to` is given."),
-            distance: z
-                .number()
-                .optional()
-                .describe("cast only: how far to travel along `direction`. Defaults to 100."),
-            size: position
-                .optional()
-                .describe('cast shape="block" or overlap region="box": the volume\'s size.'),
-            radius: z
-                .number()
-                .optional()
-                .describe('cast shape="sphere" or overlap region="radius": the radius.'),
-            region: z
-                .enum(["box", "radius", "part"])
-                .optional()
-                .describe("overlap only: 'box' and 'radius' need `at`; 'part' takes `path` " +
-                "and reports what overlaps that part. Defaults to 'box'."),
-            at: position.optional().describe('overlap only: the centre, for region "box" or "radius".'),
-            path: z
-                .string()
-                .optional()
-                .describe('overlap region="part" only: the part to test against.'),
-            only: z
-                .array(z.string())
-                .optional()
-                .describe("Consider ONLY these instances and their descendants. Use it to " +
-                'ask a narrow question — "does anything tagged Door block this".'),
-            ignore: z
-                .array(z.string())
-                .optional()
-                .describe("Skip these instances and their descendants. The usual case: " +
-                "ignore the character doing the looking, which otherwise blocks " +
-                "its own cast at zero distance."),
-            collisionGroup: z
-                .string()
-                .optional()
-                .describe("Run the query as if it came from a part in this collision group. " +
-                "Required for a truthful answer in any place that uses groups."),
-            respectCanCollide: z
-                .boolean()
-                .optional()
-                .describe("Skip parts with CanCollide off. Off by default, matching the " +
-                "engine — leave it off to ask what is there, turn it on to ask " +
-                "what would stop a player."),
-            ignoreWater: z
-                .boolean()
-                .optional()
-                .describe("cast only: pass through terrain water instead of hitting it."),
-            limit: z
-                .number()
-                .int()
-                .min(1)
-                .max(500)
-                .optional()
-                .describe("overlap only: how many parts to list. Defaults to 50."),
-            worldModel: z
-                .string()
-                .optional()
-                .describe("Query this WorldModel instead of the Workspace. Omit for the " +
-                "normal case."),
-            studioId: z.string().optional().describe("Target Studio; omit for the active one."),
-        },
-    }, async (args) => {
-        const { op, studioId, ...rest } = args;
-        const response = await bridge.call(op === "overlap" ? "spatial.overlap" : "spatial.cast", rest, { studioId, timeoutMs: 30_000 });
-        if (op === "cast" && response["hit"] === false) {
-            return json(response, "Nothing was hit. If that is a surprise, the usual causes are a " +
-                "`direction` pointing the wrong way, a `distance` shorter than the " +
-                "gap, or an `only` filter that excludes what you meant to find.");
-        }
-        return json(response);
-    });
-}
-//# sourceMappingURL=spatial.js.map

package/dist/tools/spatial.js.map

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

package/dist/tools/upload.js

@@ -1,294 +0,0 @@
-import { readFile, stat } from "node:fs/promises";
-import { basename, extname, resolve } from "node:path";
-import { z } from "zod";
-import { credentialStatus, loadCredentials } from "../lib/credentials.js";
-import { json, text } from "../lib/format.js";
-import { defineTool } from "../lib/tool.js";
-/**
- * Uploading goes out over Open Cloud rather than through the plugin.
- *
- * Studio's HttpService is not a route to this: a plugin cannot reach
- * apis.roblox.com with a creator API key without shipping that key into the
- * place, and the upload endpoint is multipart, which HttpService cannot build.
- * The server is an ordinary Node process with the file already on disk, so it
- * does the upload itself and hands Studio nothing but the finished asset id.
- */
-const ASSETS_ENDPOINT = "https://apis.roblox.com/assets/v1/assets";
-const OPERATIONS_ENDPOINT = "https://apis.roblox.com/assets/v1/operations";
-/** Open Cloud's own cap, per call. */
-const MAX_BYTES = 20 * 1024 * 1024;
-/**
- * Moderation runs before an asset is usable and it is not instant. Roblox
- * returns an operation to poll rather than the asset, and audio in particular
- * sits in review for a few seconds. Give up well before an agent's own patience
- * runs out, and say what happened rather than reporting a failure.
- */
-const POLL_TIMEOUT_MS = 90_000;
-const POLL_INTERVAL_MS = 2_000;
-/**
- * Extension to (assetType, content type).
- *
- * Roblox validates both, and rejects mismatches with a message that names
- * neither. Derived from the file rather than asked for, because an agent
- * choosing "Model" for a .png is a failure that costs a round trip and a
- * confusing error.
- */
-const KINDS = {
-    ".mp3": { assetType: "Audio", contentType: "audio/mpeg" },
-    ".ogg": { assetType: "Audio", contentType: "audio/ogg" },
-    ".wav": { assetType: "Audio", contentType: "audio/wav" },
-    ".flac": { assetType: "Audio", contentType: "audio/flac" },
-    ".png": { assetType: "Decal", contentType: "image/png" },
-    ".jpg": { assetType: "Decal", contentType: "image/jpeg" },
-    ".jpeg": { assetType: "Decal", contentType: "image/jpeg" },
-    ".bmp": { assetType: "Decal", contentType: "image/bmp" },
-    ".tga": { assetType: "Decal", contentType: "image/tga" },
-    ".fbx": { assetType: "Model", contentType: "model/fbx" },
-    ".gltf": { assetType: "Model", contentType: "model/gltf+json" },
-    ".glb": { assetType: "Model", contentType: "model/gltf-binary" },
-    ".mp4": { assetType: "Video", contentType: "video/mp4" },
-    ".mov": { assetType: "Video", contentType: "video/mov" },
-};
-/**
- * The credentials, or a sentence explaining what is missing.
- *
- * Never taken as a tool argument. A key passed as one would be written into the
- * conversation, sent to the model, and logged by the client — and it is exactly
- * the credential that can publish under the user's name. It comes from the
- * environment or from the panel's `cloud key` command instead, and this file
- * never returns it to a caller.
- */
-async function credentials() {
-    const found = await loadCredentials();
-    if (found !== null)
-        return found;
-    const status = await credentialStatus();
-    if (status.hasKey) {
-        return ("An Open Cloud key is set but there is no creator, so Roblox does not " +
-            "know who the asset belongs to.\n\n" +
-            "Type `cloud user <id>` in the Studio panel — the id is the number in " +
-            "your roblox.com/users/NNN/profile URL — or `cloud group <id>` to upload " +
-            "as a group. Setting ROBLOX_USER_ID in the environment works too.");
-    }
-    return ("No Open Cloud key is set, so nothing can be uploaded.\n\n" +
-        "The quickest way is the Studio panel: type `cloud` there and it walks " +
-        "through it. The line you type is masked in the log and in the history, and " +
-        "the key is stored in a file only you can read — it never reaches this " +
-        "conversation.\n\n" +
-        "It has to be done by the user, not by an agent, because it needs a " +
-        "logged-in browser:\n" +
-        "1. create.roblox.com/dashboard/credentials -> Create API Key\n" +
-        "2. Access Permissions -> add `assets`, with Read and Write\n" +
-        "3. Add your IP, save, copy the key (it is shown once)\n" +
-        "4. In the Studio panel: `cloud key <paste>` then `cloud user <your id>`\n\n" +
-        "Treat the key like a password: it can publish assets under that account.");
-}
-/** Turns Open Cloud's failure shapes into one sentence worth reading. */
-function describeFailure(status, body) {
-    let detail = body.slice(0, 400);
-    try {
-        const parsed = JSON.parse(body);
-        detail = parsed.message ?? parsed.errors?.[0]?.message ?? detail;
-    }
-    catch {
-        // Not JSON — Roblox returns bare HTML for some gateway errors.
-    }
-    if (status === 401 || status === 403) {
-        return (`Roblox rejected the API key (${status}): ${detail}\n\n` +
-            "Check that the key has the `assets` permission with Write, that the " +
-            "creator id matches who the key was made for, and that your current IP " +
-            "is in the key's allowed list — an IP that has changed since the key was " +
-            "made is the most common cause of a 403.");
-    }
-    if (status === 429) {
-        return `Rate limited by Roblox: ${detail}\n\nWait and retry.`;
-    }
-    if (status === 400) {
-        return (`Roblox refused the file (400): ${detail}\n\n` +
-            "Usually the file does not match its extension, or it breaks a limit: " +
-            "audio over 7 minutes, images over 8000x8000.");
-    }
-    return `Roblox returned ${status}: ${detail}`;
-}
-async function poll(operationPath, apiKey) {
-    const id = operationPath.replace(/^operations\//, "");
-    const deadline = Date.now() + POLL_TIMEOUT_MS;
-    for (;;) {
-        const response = await fetch(`${OPERATIONS_ENDPOINT}/${id}`, {
-            headers: { "x-api-key": apiKey },
-        });
-        if (!response.ok) {
-            throw new Error(describeFailure(response.status, await response.text()));
-        }
-        const operation = (await response.json());
-        if (operation.done)
-            return operation;
-        if (Date.now() >= deadline) {
-            throw new Error(`The upload is still processing after ${POLL_TIMEOUT_MS / 1000}s. It has not ` +
-                "failed — moderation can take longer. Check the Development Items tab " +
-                "on the Creator Dashboard in a minute.");
-        }
-        await new Promise((done) => setTimeout(done, POLL_INTERVAL_MS));
-    }
-}
-export function registerUploadTools(context) {
-    const { bridge } = context;
-    defineTool(context, {
-        name: "upload",
-        title: "Upload a file to Roblox as an asset",
-        description: "Uploads a local file — audio, an image, a 3D model or a video — to " +
-            "Roblox and returns the asset id, so it can be used immediately.\n\n" +
-            "This closes the one hole nothing else here covers. Every other tool " +
-            "works with assets that already exist: `assets op=\"search\"` finds " +
-            "published ones, `generate` makes geometry from a prompt. A sound " +
-            "effect or a texture sitting in a folder on disk had to be dragged " +
-            "through Studio's import dialog by hand before anything could reference " +
-            "it. Now it does not.\n\n" +
-            "The asset type is worked out from the extension — .mp3/.ogg/.wav/.flac " +
-            "become Audio, .png/.jpg/.bmp/.tga become a Decal, .fbx/.gltf/.glb " +
-            "become a Model, .mp4/.mov become a Video.\n\n" +
-            "Set `insert` with a parent path to drop the result straight into the " +
-            "place once it is approved: a Decal upload becomes a Decal, a Model " +
-            "becomes the model. Audio is NOT inserted — an audio id belongs in an " +
-            "`AudioPlayer` or a `Sound`, so wire it up with `audio op=\"graph\"` " +
-            "and the id this returns.\n\n" +
-            "Uploads are moderated and the result says the verdict. They also count " +
-            "against a real quota: 10 audio uploads a month, or 100 if the account " +
-            "is ID-verified. Do not upload speculatively, and do not re-upload a " +
-            "file to retry — the first one probably worked.\n\n" +
-            "Needs a Roblox Open Cloud API key. The user sets it once by typing " +
-            "`cloud` in the Studio panel; never ask them to paste a key into this " +
-            "conversation. Call this tool with no arguments to check whether it is " +
-            "already set up.",
-        destructive: false,
-        inputSchema: {
-            file: z
-                .string()
-                .optional()
-                .describe("Path to the file on disk. Omit to check whether the credentials " +
-                "are set up without uploading anything."),
-            name: z
-                .string()
-                .optional()
-                .describe("Display name for the asset. Defaults to the file name. This is " +
-                "public and moderated — a name that breaks the rules fails the " +
-                "whole upload."),
-            description: z.string().optional().describe("Public description. Also moderated."),
-            assetType: z
-                .enum(["Audio", "Decal", "Model", "Video"])
-                .optional()
-                .describe("Override the type derived from the extension. Rarely right — " +
-                "Roblox validates the type against the file's real content."),
-            insert: z
-                .string()
-                .optional()
-                .describe('Where to put the asset in the place once approved, e.g. "Workspace". ' +
-                "Applies to Decal and Model uploads. Omit to only get the id back."),
-            studioId: z.string().optional().describe("Target Studio; omit for the active one."),
-        },
-    }, async (args) => {
-        const credential = await credentials();
-        if (typeof credential === "string")
-            return text(credential);
-        if (!args.file) {
-            return text(`Ready to upload: key set, uploading as ${credential.creatorField} ` +
-                `${credential.creatorId}. Call again with \`file\` pointing at the ` +
-                "file you want uploaded.");
-        }
-        const path = resolve(args.file);
-        let size;
-        try {
-            size = (await stat(path)).size;
-        }
-        catch {
-            return text(`There is no file at ${path}. Give an absolute path, or one relative ` +
-                "to the directory the server was started in.");
-        }
-        if (size === 0)
-            return text(`${path} is empty.`);
-        if (size > MAX_BYTES) {
-            return text(`${path} is ${(size / 1024 / 1024).toFixed(1)}MB. Open Cloud accepts ` +
-                "20MB per upload.");
-        }
-        const extension = extname(path).toLowerCase();
-        const kind = KINDS[extension];
-        if (!kind) {
-            return text(`Roblox does not take ${extension || "files with no extension"} through ` +
-                `Open Cloud. It takes: ${Object.keys(KINDS).join(", ")}.`);
-        }
-        const assetType = args.assetType ?? kind.assetType;
-        const form = new FormData();
-        form.append("request", JSON.stringify({
-            assetType,
-            displayName: args.name ?? basename(path, extension),
-            description: args.description ?? "",
-            creationContext: {
-                creator: { [credential.creatorField]: credential.creatorId },
-            },
-        }));
-        form.append("fileContent", new Blob([new Uint8Array(await readFile(path))], { type: kind.contentType }), basename(path));
-        const started = await fetch(ASSETS_ENDPOINT, {
-            method: "POST",
-            headers: { "x-api-key": credential.apiKey },
-            body: form,
-        });
-        if (!started.ok) {
-            return text(describeFailure(started.status, await started.text()));
-        }
-        const operation = (await started.json());
-        if (!operation.path) {
-            return text("Roblox accepted the upload but did not say where to track it. " +
-                "Check the Development Items tab on the Creator Dashboard.");
-        }
-        const finished = await poll(operation.path, credential.apiKey);
-        if (finished.error || !finished.response?.assetId) {
-            return text(`The upload failed moderation or validation: ` +
-                `${finished.error?.message ?? finished.message ?? "no reason given"}`);
-        }
-        const assetId = finished.response.assetId;
-        const moderation = finished.response.moderationResult?.moderationState ?? "unknown";
-        const result = {
-            assetId,
-            assetType,
-            uri: `rbxassetid://${assetId}`,
-            name: finished.response.displayName,
-            moderation,
-            uploadedAs: `${credential.creatorField} ${credential.creatorId}`,
-            file: path,
-        };
-        // Only inserted once Roblox says it is approved. Inserting a rejected
-        // asset puts an instance in the place that resolves to nothing, which
-        // reads as a bug in this tool rather than as a moderation decision.
-        if (args.insert && moderation === "MODERATION_STATE_APPROVED") {
-            if (assetType === "Audio") {
-                result["inserted"] = false;
-                result["note"] =
-                    "Audio is not inserted on its own — the id goes into an AudioPlayer " +
-                        'or a Sound. Build one with `audio op="graph" asset="' +
-                        `rbxassetid://${assetId}"\`.`;
-            }
-            else if (assetType === "Decal") {
-                const created = await bridge.call("instances.create", {
-                    instances: [
-                        {
-                            className: "Decal",
-                            name: args.name ?? basename(path, extension),
-                            parent: args.insert,
-                            properties: { Texture: { value: `rbxassetid://${assetId}`, type: "ContentId" } },
-                        },
-                    ],
-                }, { studioId: args.studioId, timeoutMs: 30_000 });
-                result["inserted"] = created;
-            }
-            else {
-                const inserted = await bridge.call("assets.insert", { assetId: Number(assetId), parent: args.insert }, { studioId: args.studioId, timeoutMs: 90_000 });
-                result["inserted"] = inserted;
-            }
-        }
-        return json(result, moderation === "MODERATION_STATE_APPROVED"
-            ? `Use it as rbxassetid://${assetId}.`
-            : `Moderation says ${moderation}. The id exists but may not load until ` +
-                "review finishes.");
-    });
-}
-//# sourceMappingURL=upload.js.map

package/dist/tools/upload.js.map

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