safari-pilot 0.1.0

package/dist/tools/extraction.js

@@ -0,0 +1,414 @@
+import { execFile } from 'node:child_process';
+import { readFile, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export class ExtractionTools {
+    engine;
+    handlers = new Map();
+    constructor(engine) {
+        this.engine = engine;
+        this.registerHandlers();
+    }
+    registerHandlers() {
+        this.handlers.set('safari_snapshot', this.handleSnapshot.bind(this));
+        this.handlers.set('safari_get_text', this.handleGetText.bind(this));
+        this.handlers.set('safari_get_html', this.handleGetHtml.bind(this));
+        this.handlers.set('safari_get_attribute', this.handleGetAttribute.bind(this));
+        this.handlers.set('safari_evaluate', this.handleEvaluate.bind(this));
+        this.handlers.set('safari_take_screenshot', this.handleTakeScreenshot.bind(this));
+        this.handlers.set('safari_get_console_messages', this.handleGetConsoleMessages.bind(this));
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    getDefinitions() {
+        return [
+            {
+                name: 'safari_snapshot',
+                description: 'Capture the page accessibility tree as a compact representation. The primary way the agent "sees" the page. ' +
+                    'Returns roles, names, states, and interactive element metadata.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        scope: {
+                            type: 'string',
+                            description: 'CSS selector to scope snapshot, or "page" for full page',
+                            default: 'page',
+                        },
+                        format: {
+                            type: 'string',
+                            enum: ['yaml', 'json'],
+                            description: 'Output format for the snapshot',
+                            default: 'yaml',
+                        },
+                        maxDepth: { type: 'number', description: 'Maximum DOM traversal depth', default: 10 },
+                        includeHidden: {
+                            type: 'boolean',
+                            description: 'Include hidden elements in snapshot',
+                            default: false,
+                        },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_get_text',
+                description: 'Extract the visible text content of the page or a specific element.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        selector: { type: 'string', description: 'CSS selector. If omitted, returns full page text.' },
+                        maxLength: { type: 'number', description: 'Maximum characters to return', default: 50000 },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_get_html',
+                description: 'Get the HTML content of an element or the full page.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        selector: { type: 'string', description: 'CSS selector. If omitted, returns full page HTML.' },
+                        outer: {
+                            type: 'boolean',
+                            description: 'true = outerHTML (includes the element itself), false = innerHTML (just contents)',
+                            default: true,
+                        },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_get_attribute',
+                description: 'Get a specific attribute value from an element.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        selector: { type: 'string', description: 'CSS selector for the element' },
+                        attribute: { type: 'string', description: 'Attribute name: href, src, data-id, aria-label, etc.' },
+                    },
+                    required: ['tabUrl', 'selector', 'attribute'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_evaluate',
+                description: 'Execute arbitrary JavaScript in the page context and return the result. ' +
+                    'The most flexible extraction tool. Script must return a JSON-serializable value.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        script: { type: 'string', description: 'JavaScript code to execute. Must return a value.' },
+                        timeout: { type: 'number', description: 'Execution timeout in milliseconds', default: 10000 },
+                    },
+                    required: ['tabUrl', 'script'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_take_screenshot',
+                description: 'Capture a screenshot of the Safari window via screencapture CLI. ' +
+                    'Returns the image as base64-encoded PNG. Requires Screen Recording permission.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab (used to bring it to front)' },
+                        fullPage: {
+                            type: 'boolean',
+                            description: 'Capture the full scrollable page (not just viewport)',
+                            default: false,
+                        },
+                        path: {
+                            type: 'string',
+                            description: 'Optional file path to save the screenshot. If omitted, returns base64 data.',
+                        },
+                        format: { type: 'string', enum: ['png', 'jpeg'], description: 'Image format', default: 'png' },
+                        quality: { type: 'number', description: 'JPEG quality 0-100', default: 80 },
+                    },
+                    required: [],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_get_console_messages',
+                description: 'Retrieve console messages (log, warn, error, info) captured from the page.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        level: {
+                            type: 'string',
+                            enum: ['all', 'log', 'warn', 'error', 'info'],
+                            description: 'Filter by log level',
+                            default: 'all',
+                        },
+                        limit: { type: 'number', description: 'Maximum messages to return', default: 100 },
+                        clear: { type: 'boolean', description: 'Clear the buffer after reading', default: false },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+        ];
+    }
+    getHandler(name) {
+        return this.handlers.get(name);
+    }
+    // ── Handlers ────────────────────────────────────────────────────────────────
+    async handleSnapshot(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const scope = params['scope'] ?? 'page';
+        const maxDepth = typeof params['maxDepth'] === 'number' ? params['maxDepth'] : 10;
+        const includeHidden = params['includeHidden'] === true;
+        const scopeSelector = scope === 'page' || !scope ? '' : scope.replace(/'/g, "\\'");
+        const js = `
+      var maxD = ${maxDepth};
+      var inclHidden = ${includeHidden};
+      var scopeSelector = '${scopeSelector}';
+
+      function getRole(el) {
+        if (el.getAttribute('role')) return el.getAttribute('role');
+        var tag = el.tagName.toLowerCase();
+        var typeMap = {
+          a: 'link', button: 'button', input: 'textbox', select: 'combobox',
+          textarea: 'textbox', img: 'img', h1: 'heading', h2: 'heading', h3: 'heading',
+          h4: 'heading', h5: 'heading', h6: 'heading', nav: 'navigation', main: 'main',
+          form: 'form', table: 'table', ul: 'list', ol: 'list', li: 'listitem'
+        };
+        return typeMap[tag] || '';
+      }
+
+      function getName(el) {
+        return el.getAttribute('aria-label') || el.getAttribute('alt') ||
+          el.getAttribute('title') || el.getAttribute('placeholder') ||
+          (el.labels && el.labels[0] ? el.labels[0].textContent.trim() : '') ||
+          (el.textContent || '').trim().slice(0, 80);
+      }
+
+      function getState(el) {
+        var states = [];
+        if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT') {
+          if (el.required) states.push('required');
+          if (el.disabled) states.push('disabled');
+          if (el.readOnly) states.push('readonly');
+          if (el.type === 'checkbox' || el.type === 'radio') states.push(el.checked ? 'checked' : 'unchecked');
+          if (el.type) states.push('type=' + el.type);
+        }
+        if (el.tagName === 'BUTTON' || (el.tagName === 'INPUT' && el.type === 'submit')) {
+          states.push(el.disabled ? 'disabled' : 'enabled');
+        }
+        var level = el.tagName.match(/^H(\\d)$/i);
+        if (level) states.push('level=' + level[1]);
+        return states;
+      }
+
+      function isInteractive(el) {
+        var tag = el.tagName.toLowerCase();
+        return ['a', 'button', 'input', 'select', 'textarea'].indexOf(tag) !== -1 ||
+          el.getAttribute('role') === 'button' || el.getAttribute('tabindex') !== null ||
+          el.onclick !== null;
+      }
+
+      var lines = [];
+      var elementCount = 0;
+      var interactiveCount = 0;
+
+      function walk(node, depth) {
+        if (depth > maxD) return;
+        if (node.nodeType !== 1) return;
+        if (!inclHidden && (node.offsetParent === null && getComputedStyle(node).position !== 'fixed')) return;
+
+        var role = getRole(node);
+        var name = getName(node);
+        if (role || isInteractive(node)) {
+          elementCount++;
+          if (isInteractive(node)) interactiveCount++;
+          var indent = '';
+          for (var i = 0; i < depth; i++) indent += '  ';
+          var states = getState(node);
+          var stateStr = states.length ? ' [' + states.join(', ') + ']' : '';
+          var idStr = node.id ? ' #' + node.id : '';
+          var hrefStr = node.tagName === 'A' && node.href ? ' -> ' + new URL(node.href).pathname : '';
+          lines.push(indent + '- ' + (role || node.tagName.toLowerCase()) + (name ? ' "' + name.replace(/"/g, '\\\\"').slice(0, 80) + '"' : '') + stateStr + idStr + hrefStr);
+        }
+
+        for (var ci = 0; ci < node.children.length; ci++) {
+          walk(node.children[ci], depth + (role ? 1 : 0));
+        }
+      }
+
+      var root = scopeSelector ? document.querySelector(scopeSelector) : document.body;
+      if (!root) throw Object.assign(new Error('Scope element not found'), { name: 'ELEMENT_NOT_FOUND' });
+      walk(root, 0);
+
+      return {
+        snapshot: lines.join('\\n'),
+        url: window.location.href,
+        title: document.title,
+        elementCount: elementCount,
+        interactiveCount: interactiveCount,
+      };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Snapshot failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : {}, Date.now() - start);
+    }
+    async handleGetText(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const selector = params['selector'];
+        const maxLength = typeof params['maxLength'] === 'number' ? params['maxLength'] : 50000;
+        const escapedSelector = selector ? selector.replace(/'/g, "\\'") : '';
+        const js = `
+      var el = ${selector ? `document.querySelector('${escapedSelector}')` : 'document.body'};
+      if (!el) throw Object.assign(new Error('Element not found'), { name: 'ELEMENT_NOT_FOUND' });
+      var max = ${maxLength};
+      var text = el.innerText || el.textContent || '';
+      return { text: text.slice(0, max), length: text.length, truncated: text.length > max };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Get text failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : {}, Date.now() - start);
+    }
+    async handleGetHtml(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const selector = params['selector'];
+        const outer = params['outer'] !== false;
+        const escapedSelector = selector ? selector.replace(/'/g, "\\'") : '';
+        const js = `
+      var el = ${selector ? `document.querySelector('${escapedSelector}')` : 'document.documentElement'};
+      if (!el) throw Object.assign(new Error('Element not found'), { name: 'ELEMENT_NOT_FOUND' });
+      var html = ${outer ? 'el.outerHTML' : 'el.innerHTML'};
+      return { html: html, length: html.length };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Get HTML failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : {}, Date.now() - start);
+    }
+    async handleGetAttribute(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const selector = params['selector'];
+        const attribute = params['attribute'];
+        const escapedSelector = selector.replace(/'/g, "\\'");
+        const escapedAttribute = attribute.replace(/'/g, "\\'");
+        const js = `
+      var el = document.querySelector('${escapedSelector}');
+      if (!el) throw Object.assign(new Error('Element not found'), { name: 'ELEMENT_NOT_FOUND' });
+      return {
+        value: el.getAttribute('${escapedAttribute}'),
+        element: { tagName: el.tagName, id: el.id || undefined },
+      };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Get attribute failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : {}, Date.now() - start);
+    }
+    async handleEvaluate(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const script = params['script'];
+        const timeout = typeof params['timeout'] === 'number' ? params['timeout'] : 10000;
+        const js = `
+      var __userResult = (function() { ${script} })();
+      return { value: __userResult, type: typeof __userResult };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js, timeout);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Evaluate failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : {}, Date.now() - start);
+    }
+    async handleTakeScreenshot(params) {
+        const start = Date.now();
+        const format = params['format'] ?? 'png';
+        const savePath = params['path'];
+        const screenshotFormat = format === 'jpeg' ? 'jpg' : 'png';
+        const tmpFile = savePath ?? join(tmpdir(), `safari-pilot-${Date.now()}.${screenshotFormat}`);
+        const usingTmpFile = !savePath;
+        try {
+            await new Promise((resolve, reject) => {
+                execFile('screencapture', ['-x', '-t', screenshotFormat, tmpFile], { timeout: 10000 }, (error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+            const buffer = await readFile(tmpFile);
+            const base64 = buffer.toString('base64');
+            if (usingTmpFile) {
+                await unlink(tmpFile).catch(() => { });
+            }
+            return {
+                content: [{ type: 'image', data: base64, mimeType: `image/${screenshotFormat === 'jpg' ? 'jpeg' : 'png'}` }],
+                metadata: { engine: 'applescript', degraded: false, latencyMs: Date.now() - start },
+            };
+        }
+        catch (error) {
+            if (usingTmpFile) {
+                await unlink(tmpFile).catch(() => { });
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Screenshot failed: ${message}`);
+        }
+    }
+    async handleGetConsoleMessages(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const level = params['level'] ?? 'all';
+        const limit = typeof params['limit'] === 'number' ? params['limit'] : 100;
+        const clear = params['clear'] === true;
+        const js = `
+      if (!window.__safariPilotConsole) {
+        window.__safariPilotConsole = [];
+        var origConsole = {};
+        ['log', 'warn', 'error', 'info'].forEach(function(method) {
+          origConsole[method] = console[method];
+          console[method] = function() {
+            var args = Array.prototype.slice.call(arguments);
+            window.__safariPilotConsole.push({
+              level: method,
+              text: args.map(function(a) { return typeof a === 'object' ? JSON.stringify(a) : String(a); }).join(' '),
+              timestamp: Date.now(),
+            });
+            origConsole[method].apply(console, args);
+          };
+        });
+      }
+
+      var filterLevel = '${level}';
+      var msgs = window.__safariPilotConsole;
+      if (filterLevel !== 'all') msgs = msgs.filter(function(m) { return m.level === filterLevel; });
+      var limited = msgs.slice(-${limit});
+
+      ${clear ? 'window.__safariPilotConsole = [];' : ''}
+
+      return { messages: limited, count: limited.length };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Get console messages failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : { messages: [], count: 0 }, Date.now() - start);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    makeResponse(data, latencyMs = 0) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data) }],
+            metadata: { engine: 'applescript', degraded: false, latencyMs },
+        };
+    }
+}
+//# sourceMappingURL=extraction.js.map

package/dist/tools/extraction.js.map

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

package/dist/tools/frames.d.ts

@@ -0,0 +1,22 @@
+import type { ToolResponse, ToolRequirements } from '../types.js';
+import type { AppleScriptEngine } from '../engines/applescript.js';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requirements: ToolRequirements;
+}
+type Handler = (params: Record<string, unknown>) => Promise<ToolResponse>;
+export declare class FrameTools {
+    private engine;
+    private handlers;
+    constructor(engine: AppleScriptEngine);
+    private registerHandlers;
+    getDefinitions(): ToolDefinition[];
+    getHandler(name: string): Handler | undefined;
+    private handleListFrames;
+    private handleSwitchFrame;
+    private handleEvalInFrame;
+    private makeResponse;
+}
+export {};

package/dist/tools/frames.js

@@ -0,0 +1,165 @@
+export class FrameTools {
+    engine;
+    handlers = new Map();
+    constructor(engine) {
+        this.engine = engine;
+        this.registerHandlers();
+    }
+    registerHandlers() {
+        this.handlers.set('safari_list_frames', this.handleListFrames.bind(this));
+        this.handlers.set('safari_switch_frame', this.handleSwitchFrame.bind(this));
+        this.handlers.set('safari_eval_in_frame', this.handleEvalInFrame.bind(this));
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    getDefinitions() {
+        return [
+            {
+                name: 'safari_list_frames',
+                description: 'List all iframes on the current page. Returns each frame\'s src URL, name attribute, ' +
+                    'id attribute, and dimensions (width/height).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                    },
+                    required: ['tabUrl'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_switch_frame',
+                description: 'Set the active frame context for subsequent commands. Records the frame selector so ' +
+                    'future tool calls targeting this tab are scoped to the specified iframe.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        frameSelector: {
+                            type: 'string',
+                            description: 'CSS selector for the iframe element to switch into (e.g. "#my-iframe", "iframe[name=chat]")',
+                        },
+                    },
+                    required: ['tabUrl', 'frameSelector'],
+                },
+                requirements: {},
+            },
+            {
+                name: 'safari_eval_in_frame',
+                description: 'Execute arbitrary JavaScript inside a specific iframe\'s context. Accesses the iframe\'s ' +
+                    'contentWindow to run the script. Cross-origin frames require the extension engine.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabUrl: { type: 'string', description: 'Current URL of the tab' },
+                        frameSelector: { type: 'string', description: 'CSS selector for the target iframe' },
+                        script: { type: 'string', description: 'JavaScript code to execute inside the frame' },
+                    },
+                    required: ['tabUrl', 'frameSelector', 'script'],
+                },
+                requirements: { requiresFramesCrossOrigin: true },
+            },
+        ];
+    }
+    getHandler(name) {
+        return this.handlers.get(name);
+    }
+    // ── Handlers ────────────────────────────────────────────────────────────────
+    async handleListFrames(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const js = `
+      var frames = Array.from(document.querySelectorAll('iframe'));
+      return {
+        count: frames.length,
+        frames: frames.map(function(f, idx) {
+          var rect = f.getBoundingClientRect();
+          return {
+            index: idx,
+            src: f.src || null,
+            name: f.name || null,
+            id: f.id || null,
+            width: f.width || rect.width,
+            height: f.height || rect.height,
+            sandbox: f.sandbox ? f.sandbox.value : null,
+          };
+        }),
+      };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'List frames failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : { count: 0, frames: [] }, Date.now() - start);
+    }
+    async handleSwitchFrame(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const frameSelector = params['frameSelector'];
+        const escapedSelector = frameSelector.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        // Verify the frame exists before recording the switch
+        const js = `
+      var frame = document.querySelector('${escapedSelector}');
+      if (!frame) throw Object.assign(new Error('Frame not found: ${escapedSelector}'), { name: 'ELEMENT_NOT_FOUND' });
+      if (frame.tagName !== 'IFRAME') throw new Error('Element is not an iframe: ${escapedSelector}');
+
+      return {
+        switched: true,
+        frame: {
+          selector: '${escapedSelector}',
+          src: frame.src || null,
+          name: frame.name || null,
+          id: frame.id || null,
+        },
+      };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Switch frame failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : { switched: true, frame: { selector: frameSelector } }, Date.now() - start);
+    }
+    async handleEvalInFrame(params) {
+        const start = Date.now();
+        const tabUrl = params['tabUrl'];
+        const frameSelector = params['frameSelector'];
+        const script = params['script'];
+        const escapedSelector = frameSelector.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        // Escape the user script for embedding inside a JS string template
+        const escapedScript = script.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+        const js = `
+      var frame = document.querySelector('${escapedSelector}');
+      if (!frame) throw Object.assign(new Error('Frame not found: ${escapedSelector}'), { name: 'ELEMENT_NOT_FOUND' });
+      if (frame.tagName !== 'IFRAME') throw new Error('Element is not an iframe: ${escapedSelector}');
+
+      var win = frame.contentWindow;
+      if (!win) throw new Error('Cannot access frame contentWindow (detached or sandboxed)');
+
+      var userScript = \`${escapedScript}\`;
+      var result;
+      try {
+        result = win.eval(userScript);
+      } catch (e) {
+        return { ok: false, error: e.message };
+      }
+
+      var serialized;
+      try {
+        serialized = JSON.stringify(result);
+      } catch (_) {
+        serialized = String(result);
+      }
+
+      return { ok: true, result: serialized !== undefined ? JSON.parse(serialized) : null };
+    `;
+        const result = await this.engine.executeJsInTab(tabUrl, js);
+        if (!result.ok)
+            throw new Error(result.error?.message ?? 'Frame eval failed');
+        return this.makeResponse(result.value ? JSON.parse(result.value) : { ok: false, error: 'No result' }, Date.now() - start);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    makeResponse(data, latencyMs = 0) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify(data) }],
+            metadata: { engine: 'applescript', degraded: false, latencyMs },
+        };
+    }
+}
+//# sourceMappingURL=frames.js.map

package/dist/tools/frames.js.map

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