@pixerate/editor 0.80.0 → 0.82.0

package/dist/chunk-REOJJIY3.js

@@ -0,0 +1,201 @@
+// src/tools/capture.ts
+function unionCaptureRects(rects) {
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
+  for (const r of rects) {
+    if (!r) continue;
+    minX = Math.min(minX, r.x);
+    minY = Math.min(minY, r.y);
+    maxX = Math.max(maxX, r.x + r.width);
+    maxY = Math.max(maxY, r.y + r.height);
+  }
+  return minX === Infinity ? null : { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+function captureOutputSize(rect, maxEdge, maxScale = 2) {
+  const longest = Math.max(rect.width, rect.height);
+  const scale = Math.min(maxScale, maxEdge / longest);
+  return {
+    width: Math.max(1, Math.round(rect.width * scale)),
+    height: Math.max(1, Math.round(rect.height * scale)),
+    scale
+  };
+}
+function toCapturedImageData(image, fallbackMimeType) {
+  if (typeof image !== "string") return image;
+  if (!image.startsWith("data:")) return { data: image, mimeType: fallbackMimeType };
+  const match = /^data:([^;,]*)(?:;[^,]*)?,(.*)$/s.exec(image);
+  if (!match?.[1] || !match[2]) throw new Error("The surface returned an empty image; rendering may not be available in this environment.");
+  return { data: match[2], mimeType: match[1] };
+}
+var round = (n) => Math.round(n * 100) / 100;
+var roundRect = (r) => ({ x: round(r.x), y: round(r.y), width: round(r.width), height: round(r.height) });
+var pad = (r, p) => ({ x: r.x - p, y: r.y - p, width: r.width + 2 * p, height: r.height + 2 * p });
+function regionsOf(surface) {
+  return [
+    ...surface.viewport ? ["viewport"] : [],
+    "content",
+    ...surface.selection ? ["selection"] : [],
+    ...surface.items ? [surface.items.region] : [],
+    "rect"
+  ];
+}
+function captureInputSchema(surface, options = {}) {
+  const regions = regionsOf(surface);
+  const units = surface.units;
+  const properties = {
+    region: {
+      type: "string",
+      enum: regions,
+      description: `What to capture (default ${regions[0]}): ` + [
+        surface.viewport ? '"viewport" is what is on screen now' : "",
+        '"content" is everything',
+        surface.selection ? '"selection" is the selected items' : "",
+        surface.items ? `"${surface.items.region}" is the ${surface.items.noun}s in "ids"` : "",
+        `"rect" is the area in "rect"`
+      ].filter(Boolean).join(", ") + "."
+    },
+    ...surface.items ? {
+      ids: {
+        type: "array",
+        items: { type: "string" },
+        minItems: 1,
+        description: `With region "${surface.items.region}": ids of the ${surface.items.noun}s to frame${surface.items.source ? ` (from ${surface.items.source})` : ""}.`
+      }
+    } : {},
+    rect: {
+      type: "object",
+      properties: {
+        x: { type: "number", description: `Left edge in ${units}.` },
+        y: { type: "number", description: `Top edge in ${units}.` },
+        width: { type: "number", exclusiveMinimum: 0, description: `Width in ${units}.` },
+        height: { type: "number", exclusiveMinimum: 0, description: `Height in ${units}.` }
+      },
+      required: ["x", "y", "width", "height"],
+      additionalProperties: false,
+      description: `With region "rect": the area to capture, in ${units}.`
+    },
+    padding: {
+      type: "number",
+      minimum: 0,
+      description: `Margin around content, selection${surface.items ? ` and ${surface.items.region}` : ""} regions, in ${units} (default ${options.defaultPadding ?? 16}).`
+    },
+    maxEdge: {
+      type: "integer",
+      minimum: 64,
+      maximum: 4096,
+      description: `Longest side of the image in pixels (default ${options.defaultMaxEdge ?? 1024}). Small regions are not enlarged beyond ${surface.maxScale ?? 2} pixels per unit.`
+    },
+    format: { type: "string", enum: ["png", "jpeg"], description: "Image format (default png; jpeg is smaller for photos)." },
+    quality: { type: "number", minimum: 0.1, maximum: 1, description: "JPEG quality from 0.1 to 1 (default 0.85). Ignored for png." },
+    ...surface.overlays ? { includeOverlays: { type: "boolean", description: `Also draw ${surface.overlays} (default false).` } } : {}
+  };
+  return { type: "object", properties, additionalProperties: false };
+}
+function resolveCaptureRequest(surface, args, options = {}) {
+  const regions = regionsOf(surface);
+  const region = args.region ?? regions[0];
+  if (!regions.includes(region)) throw new Error(`Unknown region "${region}". Use one of: ${regions.join(", ")}.`);
+  if (args.rect !== void 0 && region !== "rect") throw new Error(`"rect" only applies with region "rect"; drop it or set region to "rect".`);
+  if (args.ids !== void 0 && region !== surface.items?.region) {
+    throw new Error(`"ids" only applies with region "${surface.items?.region ?? "items"}"; drop it or change the region.`);
+  }
+  const padding = typeof args.padding === "number" ? args.padding : options.defaultPadding ?? 16;
+  let rect;
+  let ids;
+  if (region === "viewport") {
+    rect = surface.viewport();
+    if (!rect) throw new Error('The view is not on screen (not mounted or zero size). Use region "content" instead.');
+  } else if (region === "content") {
+    const content = surface.content();
+    if (!content) throw new Error("There is nothing to capture: the surface is empty.");
+    rect = pad(content, padding);
+  } else if (region === "selection") {
+    const selection = surface.selection();
+    if (!selection.rect) throw new Error('Nothing is selected. Select something first, or use region "content".');
+    rect = pad(selection.rect, padding);
+    ids = selection.ids;
+  } else if (region === "rect") {
+    if (!args.rect) throw new Error(`Region "rect" needs "rect": {"x", "y", "width", "height"} in ${surface.units}.`);
+    rect = { x: args.rect.x, y: args.rect.y, width: args.rect.width, height: args.rect.height };
+  } else {
+    const items = surface.items;
+    const wanted = Array.isArray(args.ids) ? args.ids : [];
+    if (!wanted.length) throw new Error(`Region "${items.region}" needs "ids": the ${items.noun} ids to frame.`);
+    const found = items.bounds(wanted);
+    if (found.missing.length) {
+      throw new Error(
+        `Unknown ${items.noun} id(s): ${found.missing.join(", ")}.${items.source ? ` Read the current ids with ${items.source}.` : ""}`
+      );
+    }
+    if (!found.rect) throw new Error(`The ${items.noun}s ${wanted.join(", ")} have no size yet; try again once they are drawn.`);
+    rect = pad(found.rect, padding);
+    ids = wanted;
+  }
+  if (!(rect.width > 0) || !(rect.height > 0)) {
+    throw new Error(`The ${region} region is empty (${rect.width} \xD7 ${rect.height} ${surface.units}); capture a larger area.`);
+  }
+  const maxEdge = typeof args.maxEdge === "number" ? args.maxEdge : options.defaultMaxEdge ?? 1024;
+  const size = captureOutputSize(rect, maxEdge, surface.maxScale ?? 2);
+  return {
+    region,
+    rect,
+    ...size,
+    format: args.format === "jpeg" ? "jpeg" : "png",
+    quality: typeof args.quality === "number" ? args.quality : 0.85,
+    includeOverlays: !!surface.overlays && args.includeOverlays === true,
+    ...ids ? { ids } : {}
+  };
+}
+function createCaptureTool(surface, options = {}) {
+  const title = options.title ?? "Capture a screenshot";
+  const subject = options.subject ?? "the view";
+  return {
+    name: options.name ?? "capture_view",
+    title,
+    description: `Takes a screenshot of ${subject} so you can check how it looks, without changing anything. Captures the ${regionsOf(surface).join(", ")} region and returns the image plus the captured rect (in ${surface.units}) and the pixel scale, so a point (px, py) in the image is at (rect.x + px / scale, rect.y + py / scale).` + (surface.overlays ? ` Transient overlays (${surface.overlays}) are left out unless includeOverlays is true.` : ""),
+    inputSchema: captureInputSchema(surface, options),
+    annotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    handler: async (args, context) => {
+      const { ids, ...request } = resolveCaptureRequest(surface, args, options);
+      const mimeType = request.format === "jpeg" ? "image/jpeg" : "image/png";
+      const image = toCapturedImageData(await surface.render({ ...request, signal: context.signal }), mimeType);
+      const rect = roundRect(request.rect);
+      const meta = {
+        region: request.region,
+        rect,
+        units: surface.units,
+        width: request.width,
+        height: request.height,
+        scale: round(request.scale),
+        mimeType: image.mimeType,
+        ...ids ? { ids } : {}
+      };
+      return {
+        content: [
+          { type: "image", data: image.data, mimeType: image.mimeType },
+          {
+            type: "text",
+            text: `Captured ${request.region} at ${request.width}\xD7${request.height} px: x ${rect.x}, y ${rect.y}, ${rect.width}\xD7${rect.height} ${surface.units} (${meta.scale} px per unit).`
+          }
+        ],
+        structuredContent: meta
+      };
+    }
+  };
+}
+function createCaptureToolProvider(surface, options = {}) {
+  return { id: options.id ?? "capture", namespace: options.namespace, tools: [createCaptureTool(surface, options)] };
+}
+
+export {
+  unionCaptureRects,
+  captureOutputSize,
+  toCapturedImageData,
+  captureInputSchema,
+  resolveCaptureRequest,
+  createCaptureTool,
+  createCaptureToolProvider
+};
+//# sourceMappingURL=chunk-REOJJIY3.js.map

package/dist/chunk-REOJJIY3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/capture.ts"],"sourcesContent":["import type { AgentTool, AgentToolProvider, McpToolResult } from './registry.js';\nimport type { JsonSchema } from './schema.js';\n\n/** A rectangle in a surface's own units (canvas units, image pixels, CSS pixels). */\nexport interface CaptureRect {\n\tx: number;\n\ty: number;\n\twidth: number;\n\theight: number;\n}\n\n/**\n * What to capture: what is on screen (`viewport`), everything (`content`), the\n * selection, the bounds of some items by id (the surface's `items.region`,\n * e.g. `nodes`), or an explicit `rect`.\n */\nexport type CaptureRegion = 'viewport' | 'content' | 'selection' | 'rect' | (string & {});\n\nexport type CaptureFormat = 'png' | 'jpeg';\n\n/** What a surface is asked to draw. */\nexport interface CaptureRenderRequest {\n\t/** Region name the agent asked for. */\n\tregion: CaptureRegion;\n\t/** The area to draw, in surface units. */\n\trect: CaptureRect;\n\t/** Output size in pixels. */\n\twidth: number;\n\theight: number;\n\t/** Output pixels per surface unit (`width / rect.width`). */\n\tscale: number;\n\tformat: CaptureFormat;\n\t/** JPEG quality, 0-1. */\n\tquality: number;\n\t/** Draw selection boxes, presence cursors and other transient overlays too. */\n\tincludeOverlays: boolean;\n\tsignal?: AbortSignal;\n}\n\n/** A rendered image: base64 data with its MIME type, or a `data:` URL. */\nexport type CapturedImage = { data: string; mimeType: string } | string;\n\n/**\n * Something an agent can take a screenshot of. Bounds are in the surface's\n * own units; `render` draws a rectangle of it at a given pixel size.\n */\nexport interface CaptureSurface {\n\t/** Name of the coordinate space, used in the tool description and results (e.g. `canvas units`). */\n\tunits: string;\n\t/** What is on screen now. Omit when the surface has no viewport. */\n\tviewport?: () => CaptureRect | null;\n\t/** Bounds of everything, or `null` when the surface is empty. */\n\tcontent: () => CaptureRect | null;\n\t/** Bounds of the selection (`null` when nothing is selected) and the selected ids. */\n\tselection?: () => { rect: CaptureRect | null; ids?: string[] };\n\t/** Capture by item ids, e.g. canvas nodes. */\n\titems?: {\n\t\t/** Region name, e.g. `nodes`. */\n\t\tregion: string;\n\t\t/** Singular noun for messages, e.g. `node`. */\n\t\tnoun: string;\n\t\t/** Where the ids come from, for error messages (e.g. `get_editor_state`). */\n\t\tsource?: string;\n\t\t/** Bounds of the found items and the ids that were not found. */\n\t\tbounds: (ids: string[]) => { rect: CaptureRect | null; missing: string[] };\n\t};\n\t/** Describes the overlays `includeOverlays` adds; omit when the surface has none. */\n\toverlays?: string;\n\t/** Largest output pixels per surface unit (default 2). */\n\tmaxScale?: number;\n\trender: (request: CaptureRenderRequest) => CapturedImage | Promise<CapturedImage>;\n}\n\nexport interface CaptureToolOptions {\n\t/** Tool name (default `capture_view`). */\n\tname?: string;\n\t/** Tool title (default `Capture a screenshot`). */\n\ttitle?: string;\n\t/** What is being captured, for the description (default `the view`). */\n\tsubject?: string;\n\t/** Longest output side when the agent passes no `maxEdge` (default 1024). */\n\tdefaultMaxEdge?: number;\n\t/** Margin around `content`, `selection` and item regions when the agent passes no `padding` (default 16 units). */\n\tdefaultPadding?: number;\n}\n\nexport interface CaptureToolProviderOptions extends CaptureToolOptions {\n\t/** Provider id (unique per registry, default `capture`). */\n\tid?: string;\n\t/** Always prefix tool names with `<namespace>__`. */\n\tnamespace?: string;\n}\n\n/** Bounds of the capture: union of rects, `null` for none. */\nexport function unionCaptureRects(rects: readonly (CaptureRect | null | undefined)[]): CaptureRect | null {\n\tlet minX = Infinity;\n\tlet minY = Infinity;\n\tlet maxX = -Infinity;\n\tlet maxY = -Infinity;\n\tfor (const r of rects) {\n\t\tif (!r) continue;\n\t\tminX = Math.min(minX, r.x);\n\t\tminY = Math.min(minY, r.y);\n\t\tmaxX = Math.max(maxX, r.x + r.width);\n\t\tmaxY = Math.max(maxY, r.y + r.height);\n\t}\n\treturn minX === Infinity ? null : { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n\n/**\n * Output pixel size for `rect`: the longest side at most `maxEdge`, never more\n * than `maxScale` pixels per unit, at least 1 × 1.\n */\nexport function captureOutputSize(rect: CaptureRect, maxEdge: number, maxScale = 2): { width: number; height: number; scale: number } {\n\tconst longest = Math.max(rect.width, rect.height);\n\tconst scale = Math.min(maxScale, maxEdge / longest);\n\treturn {\n\t\twidth: Math.max(1, Math.round(rect.width * scale)),\n\t\theight: Math.max(1, Math.round(rect.height * scale)),\n\t\tscale\n\t};\n}\n\n/** Splits a `data:` URL or plain base64 into base64 data and MIME type. */\nexport function toCapturedImageData(image: CapturedImage, fallbackMimeType: string): { data: string; mimeType: string } {\n\tif (typeof image !== 'string') return image;\n\tif (!image.startsWith('data:')) return { data: image, mimeType: fallbackMimeType };\n\tconst match = /^data:([^;,]*)(?:;[^,]*)?,(.*)$/s.exec(image);\n\tif (!match?.[1] || !match[2]) throw new Error('The surface returned an empty image; rendering may not be available in this environment.');\n\treturn { data: match[2], mimeType: match[1] };\n}\n\nconst round = (n: number) => Math.round(n * 100) / 100;\nconst roundRect = (r: CaptureRect): CaptureRect => ({ x: round(r.x), y: round(r.y), width: round(r.width), height: round(r.height) });\nconst pad = (r: CaptureRect, p: number): CaptureRect => ({ x: r.x - p, y: r.y - p, width: r.width + 2 * p, height: r.height + 2 * p });\n\nfunction regionsOf(surface: CaptureSurface): string[] {\n\treturn [\n\t\t...(surface.viewport ? ['viewport'] : []),\n\t\t'content',\n\t\t...(surface.selection ? ['selection'] : []),\n\t\t...(surface.items ? [surface.items.region] : []),\n\t\t'rect'\n\t];\n}\n\n/** JSON Schema of the capture tool's arguments for a surface (only the options it supports). */\nexport function captureInputSchema(surface: CaptureSurface, options: CaptureToolOptions = {}): JsonSchema & { type: 'object' } {\n\tconst regions = regionsOf(surface);\n\tconst units = surface.units;\n\tconst properties: Record<string, JsonSchema> = {\n\t\tregion: {\n\t\t\ttype: 'string',\n\t\t\tenum: regions,\n\t\t\tdescription:\n\t\t\t\t`What to capture (default ${regions[0]}): ` +\n\t\t\t\t[\n\t\t\t\t\tsurface.viewport ? '\"viewport\" is what is on screen now' : '',\n\t\t\t\t\t'\"content\" is everything',\n\t\t\t\t\tsurface.selection ? '\"selection\" is the selected items' : '',\n\t\t\t\t\tsurface.items ? `\"${surface.items.region}\" is the ${surface.items.noun}s in \"ids\"` : '',\n\t\t\t\t\t`\"rect\" is the area in \"rect\"`\n\t\t\t\t]\n\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t.join(', ') +\n\t\t\t\t'.'\n\t\t},\n\t\t...(surface.items\n\t\t\t? {\n\t\t\t\t\tids: {\n\t\t\t\t\t\ttype: 'array',\n\t\t\t\t\t\titems: { type: 'string' },\n\t\t\t\t\t\tminItems: 1,\n\t\t\t\t\t\tdescription: `With region \"${surface.items.region}\": ids of the ${surface.items.noun}s to frame${surface.items.source ? ` (from ${surface.items.source})` : ''}.`\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: {}),\n\t\trect: {\n\t\t\ttype: 'object',\n\t\t\tproperties: {\n\t\t\t\tx: { type: 'number', description: `Left edge in ${units}.` },\n\t\t\t\ty: { type: 'number', description: `Top edge in ${units}.` },\n\t\t\t\twidth: { type: 'number', exclusiveMinimum: 0, description: `Width in ${units}.` },\n\t\t\t\theight: { type: 'number', exclusiveMinimum: 0, description: `Height in ${units}.` }\n\t\t\t},\n\t\t\trequired: ['x', 'y', 'width', 'height'],\n\t\t\tadditionalProperties: false,\n\t\t\tdescription: `With region \"rect\": the area to capture, in ${units}.`\n\t\t},\n\t\tpadding: {\n\t\t\ttype: 'number',\n\t\t\tminimum: 0,\n\t\t\tdescription: `Margin around content, selection${surface.items ? ` and ${surface.items.region}` : ''} regions, in ${units} (default ${options.defaultPadding ?? 16}).`\n\t\t},\n\t\tmaxEdge: {\n\t\t\ttype: 'integer',\n\t\t\tminimum: 64,\n\t\t\tmaximum: 4096,\n\t\t\tdescription: `Longest side of the image in pixels (default ${options.defaultMaxEdge ?? 1024}). Small regions are not enlarged beyond ${surface.maxScale ?? 2} pixels per unit.`\n\t\t},\n\t\tformat: { type: 'string', enum: ['png', 'jpeg'], description: 'Image format (default png; jpeg is smaller for photos).' },\n\t\tquality: { type: 'number', minimum: 0.1, maximum: 1, description: 'JPEG quality from 0.1 to 1 (default 0.85). Ignored for png.' },\n\t\t...(surface.overlays\n\t\t\t? { includeOverlays: { type: 'boolean', description: `Also draw ${surface.overlays} (default false).` } }\n\t\t\t: {})\n\t};\n\treturn { type: 'object', properties, additionalProperties: false };\n}\n\n/**\n * Works out the rectangle and pixel size for a capture call, checking the\n * arguments against the surface. Throws an error that says how to fix the call.\n */\nexport function resolveCaptureRequest(\n\tsurface: CaptureSurface,\n\targs: Record<string, any>,\n\toptions: CaptureToolOptions = {}\n): Omit<CaptureRenderRequest, 'signal'> & { ids?: string[] } {\n\tconst regions = regionsOf(surface);\n\tconst region: string = args.region ?? regions[0];\n\tif (!regions.includes(region)) throw new Error(`Unknown region \"${region}\". Use one of: ${regions.join(', ')}.`);\n\tif (args.rect !== undefined && region !== 'rect') throw new Error(`\"rect\" only applies with region \"rect\"; drop it or set region to \"rect\".`);\n\tif (args.ids !== undefined && region !== surface.items?.region) {\n\t\tthrow new Error(`\"ids\" only applies with region \"${surface.items?.region ?? 'items'}\"; drop it or change the region.`);\n\t}\n\tconst padding = typeof args.padding === 'number' ? args.padding : (options.defaultPadding ?? 16);\n\tlet rect: CaptureRect | null;\n\tlet ids: string[] | undefined;\n\tif (region === 'viewport') {\n\t\trect = surface.viewport!();\n\t\tif (!rect) throw new Error('The view is not on screen (not mounted or zero size). Use region \"content\" instead.');\n\t} else if (region === 'content') {\n\t\tconst content = surface.content();\n\t\tif (!content) throw new Error('There is nothing to capture: the surface is empty.');\n\t\trect = pad(content, padding);\n\t} else if (region === 'selection') {\n\t\tconst selection = surface.selection!();\n\t\tif (!selection.rect) throw new Error('Nothing is selected. Select something first, or use region \"content\".');\n\t\trect = pad(selection.rect, padding);\n\t\tids = selection.ids;\n\t} else if (region === 'rect') {\n\t\tif (!args.rect) throw new Error(`Region \"rect\" needs \"rect\": {\"x\", \"y\", \"width\", \"height\"} in ${surface.units}.`);\n\t\trect = { x: args.rect.x, y: args.rect.y, width: args.rect.width, height: args.rect.height };\n\t} else {\n\t\tconst items = surface.items!;\n\t\tconst wanted = Array.isArray(args.ids) ? (args.ids as string[]) : [];\n\t\tif (!wanted.length) throw new Error(`Region \"${items.region}\" needs \"ids\": the ${items.noun} ids to frame.`);\n\t\tconst found = items.bounds(wanted);\n\t\tif (found.missing.length) {\n\t\t\tthrow new Error(\n\t\t\t\t`Unknown ${items.noun} id(s): ${found.missing.join(', ')}.${items.source ? ` Read the current ids with ${items.source}.` : ''}`\n\t\t\t);\n\t\t}\n\t\tif (!found.rect) throw new Error(`The ${items.noun}s ${wanted.join(', ')} have no size yet; try again once they are drawn.`);\n\t\trect = pad(found.rect, padding);\n\t\tids = wanted;\n\t}\n\tif (!(rect.width > 0) || !(rect.height > 0)) {\n\t\tthrow new Error(`The ${region} region is empty (${rect.width} × ${rect.height} ${surface.units}); capture a larger area.`);\n\t}\n\tconst maxEdge = typeof args.maxEdge === 'number' ? args.maxEdge : (options.defaultMaxEdge ?? 1024);\n\tconst size = captureOutputSize(rect, maxEdge, surface.maxScale ?? 2);\n\treturn {\n\t\tregion,\n\t\trect,\n\t\t...size,\n\t\tformat: args.format === 'jpeg' ? 'jpeg' : 'png',\n\t\tquality: typeof args.quality === 'number' ? args.quality : 0.85,\n\t\tincludeOverlays: !!surface.overlays && args.includeOverlays === true,\n\t\t...(ids ? { ids } : {})\n\t};\n}\n\n/**\n * The `capture_view` agent tool for a surface: renders a region as an image\n * the model can look at. The result has the image and a text block, and\n * `structuredContent` with the captured `rect` (surface units), the pixel\n * size and `scale`, so a point in the image maps back with\n * `x = rect.x + px / scale`.\n */\nexport function createCaptureTool(surface: CaptureSurface, options: CaptureToolOptions = {}): AgentTool {\n\tconst title = options.title ?? 'Capture a screenshot';\n\tconst subject = options.subject ?? 'the view';\n\treturn {\n\t\tname: options.name ?? 'capture_view',\n\t\ttitle,\n\t\tdescription:\n\t\t\t`Takes a screenshot of ${subject} so you can check how it looks, without changing anything. ` +\n\t\t\t`Captures the ${regionsOf(surface).join(', ')} region and returns the image plus the captured rect (in ${surface.units}) and the pixel scale, ` +\n\t\t\t'so a point (px, py) in the image is at (rect.x + px / scale, rect.y + py / scale).' +\n\t\t\t(surface.overlays ? ` Transient overlays (${surface.overlays}) are left out unless includeOverlays is true.` : ''),\n\t\tinputSchema: captureInputSchema(surface, options),\n\t\tannotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n\t\thandler: async (args, context): Promise<McpToolResult> => {\n\t\t\tconst { ids, ...request } = resolveCaptureRequest(surface, args, options);\n\t\t\tconst mimeType = request.format === 'jpeg' ? 'image/jpeg' : 'image/png';\n\t\t\tconst image = toCapturedImageData(await surface.render({ ...request, signal: context.signal }), mimeType);\n\t\t\tconst rect = roundRect(request.rect);\n\t\t\tconst meta = {\n\t\t\t\tregion: request.region,\n\t\t\t\trect,\n\t\t\t\tunits: surface.units,\n\t\t\t\twidth: request.width,\n\t\t\t\theight: request.height,\n\t\t\t\tscale: round(request.scale),\n\t\t\t\tmimeType: image.mimeType,\n\t\t\t\t...(ids ? { ids } : {})\n\t\t\t};\n\t\t\treturn {\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: 'image', data: image.data, mimeType: image.mimeType },\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\ttext: `Captured ${request.region} at ${request.width}×${request.height} px: x ${rect.x}, y ${rect.y}, ${rect.width}×${rect.height} ${surface.units} (${meta.scale} px per unit).`\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\tstructuredContent: meta\n\t\t\t};\n\t\t}\n\t};\n}\n\n/** A provider with just the `capture_view` tool for a surface. */\nexport function createCaptureToolProvider(surface: CaptureSurface, options: CaptureToolProviderOptions = {}): AgentToolProvider {\n\treturn { id: options.id ?? 'capture', namespace: options.namespace, tools: [createCaptureTool(surface, options)] };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-RJ2BFKEN.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-RJ2BFKEN.js.map

package/dist/chunk-RJ2BFKEN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}