feat(desktop): capture the visible Tableau window

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tableau/mcp-server",
   "description": "Helping agents see and understand data.",
-  "version": "2.68.2",
+  "version": "2.68.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tableau/tableau-mcp.git"

src/desktop/limits/inlineImageCap.test.ts

@@ -0,0 +1,32 @@
+import { buildInlineImageCapFileMessage } from './inlineImageCap.js';
+
+describe('buildInlineImageCapFileMessage', () => {
+  it('keeps the export-image next step and discloses manual cache-file removal by default', () => {
+    const message = buildInlineImageCapFileMessage({
+      label: 'Worksheet',
+      bytes: 9,
+      capBytes: 8,
+      file: '/tmp/worksheet-image.png',
+    });
+
+    expect(message).toContain('worksheet instead of a whole dashboard');
+    expect(message).toContain('pass a filePath');
+    expect(message).toContain('remains until manually removed');
+  });
+
+  it('uses a capture-specific next step without unsupported export parameters', () => {
+    const message = buildInlineImageCapFileMessage({
+      label: 'Window screenshot (1440x900)',
+      bytes: 9,
+      capBytes: 8,
+      file: '/tmp/window-screenshot.png',
+      nextStep:
+        'Open the file to view the full resolution screenshot. This local cache file remains until manually removed.',
+    });
+
+    expect(message).toContain('full resolution screenshot');
+    expect(message).toContain('remains until manually removed');
+    expect(message).not.toContain('filePath');
+    expect(message).not.toContain('worksheet');
+  });
+});

src/desktop/limits/inlineImageCap.ts

@@ -42,17 +42,20 @@ export function buildInlineImageCapFileMessage(params: {
   bytes: number;
   capBytes: number;
   file: string;
+  nextStep?: string;
 }): string {
-  const { label, bytes, capBytes, file } = params;
+  const { label, bytes, capBytes, file, nextStep } = params;
   return [
     `${label} image is ${bytes} bytes, over the ${capBytes}-byte inline cap. Written to a file ` +
       'instead of returned inline to keep large images out of the conversation.',
     '',
     `Image file: ${file}`,
     '',
-    'Open the file to view the image. To get a smaller inline image next time, request a ' +
-      'worksheet instead of a whole dashboard, or pass a filePath to have Tableau write the ' +
-      'image directly to a location of your choosing.',
+    nextStep ??
+      'Open the file to view the image. This local cache file remains until manually removed. ' +
+        'To get a smaller inline image next time, request a worksheet instead of a whole ' +
+        'dashboard, or pass a filePath to have Tableau write the image directly to a location ' +
+        'of your choosing.',
   ].join('\n');
 }