@plitzi/sdk-mcp 0.38.6 → 0.38.8

package/dist/modules/mcp/tools/screenshot.js

@@ -1,127 +0,0 @@
-import { operation } from "./operations/index.js";
-import { defineTool, imageResult } from "./shared/tool.js";
-import { unnamedControls } from "../accessibilityOutline.js";
-import { z } from "zod";
-//#region src/modules/mcp/tools/screenshot.ts
-var VIEWPORTS = {
-	desktop: {
-		label: "desktop",
-		width: 1440,
-		height: 900
-	},
-	mobile: {
-		label: "mobile",
-		width: 390,
-		height: 844
-	}
-};
-var resolveViewports = (choice) => {
-	if (choice === "both") return [VIEWPORTS.desktop, VIEWPORTS.mobile];
-	if (choice === "mobile") return [VIEWPORTS.mobile];
-	return [VIEWPORTS.desktop];
-};
-var screenshotShape = {
-	pageRef: z.string().optional().describe("The page to capture, by name; defaults to the space default page"),
-	operations: z.array(operation).max(100).optional().describe("Unsaved edits to apply before rendering, so you can screenshot a proposed change WITHOUT persisting it (same op vocabulary as plitzi_apply). Omit to capture the current saved state."),
-	viewport: z.enum([
-		"desktop",
-		"mobile",
-		"both"
-	]).optional().describe("Which viewport(s) to capture. \"both\" catches responsive issues (e.g. overflow at one width). Default desktop."),
-	fullPage: z.boolean().optional().describe("Capture the full scrollable page instead of only the visible viewport. Default false."),
-	view: z.enum([
-		"image",
-		"accessibility",
-		"both"
-	]).optional().describe("What to bring back. \"image\" (default) is the picture. \"accessibility\" is the page as a screen reader and a browser agent (Claude in Chrome) read it — its accessibility tree as an outline of roles and names — with every control and picture that has no name listed; text only, far cheaper than an image. \"both\" is both.")
-};
-var VIEWS = {
-	image: ["image"],
-	accessibility: ["accessibility"],
-	both: ["image", "accessibility"]
-};
-/** Each viewport's outline, with what in it has no name — the part an agent acts on. */
-var readingOf = (outlines) => outlines.map(({ label, outline }) => ({
-	viewport: label,
-	outline,
-	unnamed: unnamedControls(outline)
-}));
-var ACCESSIBILITY_HINT = "Every entry in `unnamed` is a control or picture announced by its role alone (\"button\") — nobody using a screen reader, and no browser agent, can tell what it does. Name it — a button: `title` or words inside; a link: `label`; a field: `label` (with `hideLabel` to keep it out of sight); an image: `alt`, or `decorative: true`; an icon that means something alone: `label`. `line` is where it sits in the outline.";
-var screenshotTool = defineTool({
-	name: "plitzi_screenshot",
-	title: "Screenshot",
-	description: "Render a page to a real PNG image so you can SEE the visual result of your edits — overflow, misalignment and broken layout that data alone never reveals. Pass unsaved `operations` to screenshot a proposed change before committing, and viewport \"both\" to compare desktop and mobile. `view: \"accessibility\"` reads the page as a screen reader and a browser agent do instead, and lists every control with no name. Returns the image(s).",
-	inputShape: screenshotShape,
-	access: "read",
-	requires: "screenshot",
-	run: async (input, ctx) => {
-		if (!ctx.preview || ctx.spaceId === void 0) return {
-			error: "PREVIEW_UNAVAILABLE",
-			message: "Visual preview is not enabled on this server.",
-			hint: "Preview needs the SSR render service; it is unavailable in MCP-only mode."
-		};
-		const draft = {
-			spaceId: ctx.spaceId,
-			env: ctx.env,
-			pageRef: input.pageRef,
-			operations: input.operations
-		};
-		const pv = await ctx.preview.render({
-			...draft,
-			includeHtml: !ctx.screenshot
-		});
-		if (!pv.ok) return pv;
-		const viewports = resolveViewports(input.viewport);
-		const view = input.view ?? "image";
-		if (!ctx.screenshot) return {
-			warning: "SCREENSHOT_DISABLED",
-			message: view === "image" ? "The screenshot service is not configured; returning the HTML preview instead." : "No browser is configured, so the accessibility tree cannot be read; returning the HTML preview instead. Its roles and names are in the markup: every button, link and field needs words, every image an `alt`.",
-			pageRef: input.pageRef ?? "default",
-			pagePath: pv.pagePath,
-			stateVersion: pv.stateVersion,
-			html: pv.html
-		};
-		const shot = await ctx.screenshot.capture({
-			pagePath: pv.pagePath,
-			token: pv.token,
-			viewports,
-			fullPage: input.fullPage,
-			views: VIEWS[view]
-		});
-		if (!shot.ok) {
-			const fallback = await ctx.preview.render(draft);
-			return {
-				warning: "SCREENSHOT_UNAVAILABLE",
-				message: `The screenshot service failed (${shot.message}); returning the HTML preview instead.`,
-				hint: "The dedicated browser service is down or unreachable. Inspect the HTML, or retry later.",
-				pageRef: input.pageRef ?? "default",
-				pagePath: pv.pagePath,
-				stateVersion: pv.stateVersion,
-				html: fallback.ok ? fallback.html : ""
-			};
-		}
-		const meta = {
-			pageRef: input.pageRef ?? "default",
-			pagePath: pv.pagePath,
-			stateVersion: pv.stateVersion,
-			viewports: viewports.map((v) => v.label)
-		};
-		const accessibility = view === "image" ? {} : shot.accessibility ? {
-			accessibility: readingOf(shot.accessibility),
-			hint: ACCESSIBILITY_HINT
-		} : {
-			warning: "ACCESSIBILITY_UNSUPPORTED",
-			message: "The browser service answered without the accessibility tree — it predates the accessibility view. The image, if asked for, is still here."
-		};
-		if (view === "accessibility") return {
-			...meta,
-			...accessibility
-		};
-		return imageResult(shot.images, {
-			...meta,
-			...accessibility
-		});
-	}
-});
-//#endregion
-export { screenshotShape, screenshotTool };