npm - screenpipe-mcp - Versions diffs - 0.9.0 → 0.10.0 - Mend

screenpipe-mcp 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/index.js CHANGED Viewed

@@ -44,19 +44,6 @@ const ws_1 = require("ws");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-// Helper to get current date in ISO format
-function getCurrentDateInfo() {
-    const now = new Date();
-    return {
-        isoDate: now.toISOString(),
-        localDate: now.toLocaleDateString("en-US", {
-            weekday: "long",
-            year: "numeric",
-            month: "long",
-            day: "numeric",
-        }),
-    };
-}
 // Parse command line arguments
 const args = process.argv.slice(2);
 let port = 3030;
@@ -69,1199 +56,246 @@ const SCREENPIPE_API = `http://localhost:${port}`;
 // Initialize server
 const server = new index_js_1.Server({
     name: "screenpipe",
-    version: "0.8.5",
+    version: "0.9.0",
 }, {
     capabilities: {
         tools: {},
-        prompts: {},
         resources: {},
     },
 });
-// Tool definitions
-const BASE_TOOLS = [
+// ---------------------------------------------------------------------------
+// Tools — minimal descriptions, no behavioral guidance (that belongs in resources)
+// ---------------------------------------------------------------------------
+const TOOLS = [
     {
         name: "search-content",
-        description: "Search screenpipe's recorded content: screen text (accessibility APIs, with OCR fallback), audio transcriptions, and UI elements. " +
-            "Returns timestamped results with app context. " +
-            "Call with no parameters to get recent activity. " +
-            "Use the 'screenpipe://context' resource for current time when building time-based queries.\n\n" +
-            "WHEN TO USE WHICH content_type:\n" +
-            "- For meetings/calls/conversations: content_type='audio', do NOT use q param (transcriptions are noisy, q filters too aggressively)\n" +
-            "- For screen text/reading: content_type='all' or 'accessibility'\n" +
-            "- For time spent/app usage questions: use activity-summary tool instead (this tool returns content, not time stats)\n\n" +
-            "SEARCH STRATEGY: First search with ONLY time params (start_time/end_time) — no q, no app_name, no content_type. " +
-            "This gives ground truth of what's recorded. Scan results to find correct app_name values, then narrow with filters using exact observed values. " +
-            "App names are case-sensitive (e.g. 'Discord' vs 'Discord.exe'). " +
-            "The q param searches captured text, NOT app names. NEVER report 'no data' after one filtered search — verify with unfiltered time-only search first.\n\n" +
-            "DEEP LINKS: When referencing specific moments, create clickable links using IDs from search results:\n" +
-            "- OCR results (PREFERRED): [10:30 AM — Chrome](screenpipe://frame/12345) — use content.frame_id from the result\n" +
-            "- Audio results: [meeting at 3pm](screenpipe://timeline?timestamp=2024-01-15T15:00:00Z) — use exact timestamp from result\n" +
-            "NEVER fabricate frame IDs or timestamps — only use values from actual search results.",
-        annotations: {
-            title: "Search Content",
-            readOnlyHint: true,
-        },
+        description: "Search screen text, audio transcriptions, input events, and memories. " +
+            "Returns timestamped results with app context. Call with no params for recent activity.",
+        annotations: { title: "Search Content", readOnlyHint: true },
         inputSchema: {
             type: "object",
             properties: {
                 q: {
                     type: "string",
-                    description: "Search query (full-text search on captured text). Optional - omit to return all content in time range. IMPORTANT: Do NOT use q for audio/meeting searches — transcriptions are noisy and q filters too aggressively. Only use q when searching for specific text the user saw on screen.",
+                    description: "Full-text search query. Omit to return all content in time range.",
                 },
                 content_type: {
                     type: "string",
-                    enum: ["all", "ocr", "audio", "input", "accessibility"],
-                    description: "Content type filter: 'audio' (transcriptions — use for meetings/calls/conversations), 'accessibility' (accessibility tree text, preferred for screen content), 'ocr' (screen text via OCR, legacy fallback), 'input' (clicks, keystrokes, clipboard, app switches), 'all'. Default: 'all'. For meeting/call queries, ALWAYS use 'audio'.",
+                    enum: ["all", "ocr", "audio", "input", "accessibility", "memory"],
+                    description: "Filter by content type. Default: 'all'.",
                     default: "all",
                 },
-                limit: {
-                    type: "integer",
-                    description: "Max results. Default: 10",
-                    default: 10,
-                },
-                offset: {
-                    type: "integer",
-                    description: "Skip N results for pagination. Default: 0",
-                    default: 0,
-                },
+                limit: { type: "integer", description: "Max results (default 10)", default: 10 },
+                offset: { type: "integer", description: "Pagination offset", default: 0 },
                 start_time: {
                     type: "string",
-                    format: "date-time",
-                    description: "Start time: ISO 8601 UTC (e.g., 2024-01-15T10:00:00Z) or relative (e.g., '16h ago', '2d ago', 'now')",
+                    description: "ISO 8601 UTC or relative (e.g. '2h ago')",
                 },
                 end_time: {
                     type: "string",
-                    format: "date-time",
-                    description: "End time: ISO 8601 UTC (e.g., 2024-01-15T18:00:00Z) or relative (e.g., 'now', '1h ago')",
-                },
-                app_name: {
-                    type: "string",
-                    description: "Filter by app (e.g., 'Google Chrome', 'Slack', 'zoom.us')",
-                },
-                window_name: {
-                    type: "string",
-                    description: "Filter by window title",
-                },
-                min_length: {
-                    type: "integer",
-                    description: "Minimum content length in characters",
-                },
-                max_length: {
-                    type: "integer",
-                    description: "Maximum content length in characters",
+                    description: "ISO 8601 UTC or relative (e.g. 'now')",
                 },
+                app_name: { type: "string", description: "Filter by app name" },
+                window_name: { type: "string", description: "Filter by window title" },
+                min_length: { type: "integer", description: "Min content length" },
+                max_length: { type: "integer", description: "Max content length" },
                 include_frames: {
                     type: "boolean",
-                    description: "Include base64 screenshots (OCR only). Default: false",
+                    description: "Include base64 screenshots (OCR only)",
                     default: false,
                 },
-                speaker_ids: {
-                    type: "string",
-                    description: "Comma-separated speaker IDs to filter audio results (e.g., '1,2,3')",
-                },
-                speaker_name: {
-                    type: "string",
-                    description: "Filter audio by speaker name (case-insensitive partial match)",
-                },
+                speaker_ids: { type: "string", description: "Comma-separated speaker IDs" },
+                speaker_name: { type: "string", description: "Filter audio by speaker name" },
                 max_content_length: {
                     type: "integer",
-                    description: "Truncate each result's text/transcription to this many characters using middle-truncation (keeps first half + last half). Useful for limiting token usage with small-context models.",
+                    description: "Truncate each result via middle-truncation",
                 },
             },
         },
     },
     {
-        name: "export-video",
-        description: "Export a video of screen recordings for a specific time range. " +
-            "Creates an MP4 video from the recorded frames between the start and end times.\n\n" +
-            "IMPORTANT: Use ISO 8601 UTC timestamps (e.g., 2024-01-15T10:00:00Z) or relative times (e.g., '16h ago', 'now')\n\n" +
-            "EXAMPLES:\n" +
-            "- Last 30 minutes: Calculate timestamps from current time\n" +
-            "- Specific meeting: Use the meeting's start and end times in UTC",
-        annotations: {
-            title: "Export Video",
-            destructiveHint: true,
+        name: "list-meetings",
+        description: "List detected meetings (Zoom, Teams, Meet, etc.) with duration, app, and attendees.",
+        annotations: { title: "List Meetings", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                end_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                limit: { type: "integer", description: "Max results (default 20)", default: 20 },
+                offset: { type: "integer", description: "Pagination offset", default: 0 },
+            },
         },
+    },
+    {
+        name: "activity-summary",
+        description: "Lightweight activity overview (~200-500 tokens): app usage with active minutes, audio speakers, recent texts. " +
+            "Use for 'how long on X?', 'which apps?', 'what was I doing?' questions.",
+        annotations: { title: "Activity Summary", readOnlyHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                start_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "Start time: ISO 8601 UTC (e.g., '2024-01-15T10:00:00Z') or relative (e.g., '16h ago', 'now')",
-                },
-                end_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "End time: ISO 8601 UTC (e.g., '2024-01-15T10:30:00Z') or relative (e.g., 'now', '1h ago')",
-                },
-                fps: {
-                    type: "number",
-                    description: "Frames per second for the output video. Lower values (0.5-1.0) create smaller files, higher values (5-10) create smoother playback. Default: 1.0",
-                    default: 1.0,
-                },
+                start_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                end_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                app_name: { type: "string", description: "Optional app name filter" },
             },
             required: ["start_time", "end_time"],
         },
     },
     {
-        name: "list-meetings",
-        description: "List detected meetings with duration, app, and attendees. " +
-            "Returns meetings detected via app focus (Zoom, Meet, Teams) and audio. " +
-            "Only available when screenpipe runs in smart transcription mode.",
-        annotations: {
-            title: "List Meetings",
-            readOnlyHint: true,
-        },
+        name: "search-elements",
+        description: "Search UI elements (buttons, links, text fields) from the accessibility tree. " +
+            "Lighter than search-content for targeted UI lookups.",
+        annotations: { title: "Search Elements", readOnlyHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                start_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "Start filter: ISO 8601 UTC (e.g., 2024-01-15T10:00:00Z) or relative (e.g., '16h ago', 'now')",
-                },
-                end_time: {
+                q: { type: "string", description: "Full-text search on element text" },
+                frame_id: { type: "integer", description: "Filter to specific frame" },
+                source: {
                     type: "string",
-                    format: "date-time",
-                    description: "End filter: ISO 8601 UTC (e.g., 2024-01-15T18:00:00Z) or relative (e.g., 'now', '1h ago')",
-                },
-                limit: {
-                    type: "integer",
-                    description: "Max results. Default: 20",
-                    default: 20,
-                },
-                offset: {
-                    type: "integer",
-                    description: "Skip N results for pagination. Default: 0",
-                    default: 0,
-                },
+                    enum: ["accessibility", "ocr"],
+                    description: "Element source filter",
+                },
+                role: { type: "string", description: "Element role (e.g. AXButton, AXLink)" },
+                start_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                end_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                app_name: { type: "string", description: "Filter by app name" },
+                limit: { type: "integer", description: "Max results (default 50)", default: 50 },
+                offset: { type: "integer", description: "Pagination offset", default: 0 },
             },
         },
     },
     {
-        name: "activity-summary",
-        description: "Get a lightweight compressed activity overview for a time range (~200-500 tokens). " +
-            "Returns app usage (name, frame count, active minutes, first/last seen), recent accessibility texts, and audio speaker summary. " +
-            "Minutes are based on active session time (consecutive frames with gaps < 5min count as active). " +
-            "first_seen/last_seen show the wall-clock span per app.\n\n" +
-            "USE THIS TOOL (not search-content or raw SQL) for:\n" +
-            "- 'how long did I spend on X?' → active_minutes per app\n" +
-            "- 'which apps did I use today?' → app list sorted by active_minutes\n" +
-            "- 'what was I doing?' → broad overview before drilling deeper\n" +
-            "- Any time-spent or app-usage question\n\n" +
-            "WARNING: Do NOT estimate time from raw frame counts or SQL queries — those are inaccurate. " +
-            "This endpoint calculates actual active session time correctly.",
-        annotations: {
-            title: "Activity Summary",
-            readOnlyHint: true,
+        name: "frame-context",
+        description: "Get accessibility text, parsed tree nodes, and URLs for a specific frame ID.",
+        annotations: { title: "Frame Context", readOnlyHint: true },
+        inputSchema: {
+            type: "object",
+            properties: {
+                frame_id: { type: "integer", description: "Frame ID from search results" },
+            },
+            required: ["frame_id"],
         },
+    },
+    {
+        name: "export-video",
+        description: "Export an MP4 video of screen recordings for a time range.",
+        annotations: { title: "Export Video", destructiveHint: true },
         inputSchema: {
             type: "object",
             properties: {
-                start_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "Start of time range: ISO 8601 UTC (e.g., 2024-01-15T10:00:00Z) or relative (e.g., '16h ago', 'now')",
-                },
-                end_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "End of time range: ISO 8601 UTC (e.g., 2024-01-15T18:00:00Z) or relative (e.g., 'now', '1h ago')",
-                },
-                app_name: {
-                    type: "string",
-                    description: "Optional app name filter (e.g., 'Google Chrome', 'VS Code')",
-                },
+                start_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                end_time: { type: "string", description: "ISO 8601 UTC or relative" },
+                fps: { type: "number", description: "Output FPS (default 1.0)", default: 1.0 },
             },
             required: ["start_time", "end_time"],
         },
     },
     {
-        name: "search-elements",
-        description: "Search structured UI elements (accessibility tree nodes and OCR text blocks). " +
-            "Returns ~100-500 bytes per element — much lighter than search-content for targeted lookups. " +
-            "Each element has: id, frame_id, source (accessibility/ocr), role (AXButton, AXStaticText, AXLink, etc.), text, bounds, depth.\n\n" +
-            "Use for: finding specific buttons, links, text fields, or UI components. " +
-            "Prefer this over search-content when you need structural UI detail rather than full screen text.",
-        annotations: {
-            title: "Search Elements",
-            readOnlyHint: true,
-        },
+        name: "update-memory",
+        description: "Create, update, or delete a persistent memory (facts, preferences, decisions). " +
+            "Retrieve memories via search-content with content_type='memory'.",
+        annotations: { title: "Update Memory", destructiveHint: false },
         inputSchema: {
             type: "object",
             properties: {
-                q: {
-                    type: "string",
-                    description: "Full-text search query across element text. Optional.",
-                },
-                frame_id: {
-                    type: "integer",
-                    description: "Filter to elements from a specific frame",
-                },
-                source: {
-                    type: "string",
-                    enum: ["accessibility", "ocr"],
-                    description: "Filter by element source: 'accessibility' (structured tree) or 'ocr' (text blocks)",
-                },
-                role: {
-                    type: "string",
-                    description: "Filter by element role (e.g., 'AXButton', 'AXStaticText', 'AXLink', 'AXTextField', 'line')",
-                },
-                start_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "Start time: ISO 8601 UTC or relative (e.g., '16h ago', 'now')",
-                },
-                end_time: {
-                    type: "string",
-                    format: "date-time",
-                    description: "End time: ISO 8601 UTC or relative (e.g., 'now', '1h ago')",
-                },
-                app_name: {
-                    type: "string",
-                    description: "Filter by app name",
-                },
-                limit: {
-                    type: "integer",
-                    description: "Max results. Default: 50",
-                    default: 50,
-                },
-                offset: {
-                    type: "integer",
-                    description: "Skip N results for pagination. Default: 0",
-                    default: 0,
-                },
+                id: { type: "integer", description: "Memory ID (omit to create new)" },
+                content: { type: "string", description: "Memory text" },
+                tags: { type: "array", items: { type: "string" }, description: "Categorization tags" },
+                importance: { type: "number", description: "0.0-1.0 (default 0.5)" },
+                source_context: { type: "object", description: "Optional source data links" },
+                delete: { type: "boolean", description: "Delete the memory identified by id" },
             },
         },
     },
     {
-        name: "frame-context",
-        description: "Get accessibility text, parsed tree nodes, and extracted URLs for a specific frame. " +
-            "Falls back to OCR data for legacy frames without accessibility data. " +
-            "Use after finding a frame_id from search-content or search-elements to get full structural detail and URLs.",
-        annotations: {
-            title: "Frame Context",
-            readOnlyHint: true,
-        },
+        name: "send-notification",
+        description: "Send a notification to the screenpipe desktop UI with optional action buttons. " +
+            "Actions can re-run pipes with context, call API endpoints, or open deep links.",
+        annotations: { title: "Send Notification", destructiveHint: false },
         inputSchema: {
             type: "object",
             properties: {
-                frame_id: {
-                    type: "integer",
-                    description: "The frame ID to get context for (from search results)",
+                title: { type: "string", description: "Notification title" },
+                body: { type: "string", description: "Notification body (markdown supported)" },
+                pipe_name: { type: "string", description: "Name of the pipe sending this notification" },
+                timeout_secs: { type: "integer", description: "Auto-dismiss seconds (default 20)", default: 20 },
+                actions: {
+                    type: "array",
+                    description: "Up to 5 action buttons",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string", description: "Unique action ID" },
+                            label: { type: "string", description: "Button label" },
+                            type: { type: "string", enum: ["pipe", "api", "deeplink", "dismiss"], description: "Action type" },
+                            pipe: { type: "string", description: "Pipe name to run (type=pipe)" },
+                            context: { type: "object", description: "Context passed to pipe (type=pipe)" },
+                            url: { type: "string", description: "URL for api/deeplink actions" },
+                        },
+                        required: ["id", "label", "type"],
+                    },
                 },
             },
-            required: ["frame_id"],
+            required: ["title", "pipe_name"],
         },
     },
 ];
-// List tools handler
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
-    return { tools: BASE_TOOLS };
+    return { tools: TOOLS };
 });
-// MCP Resources - provide dynamic context data
+// ---------------------------------------------------------------------------
+// Resources — dynamic context only (no duplicated reference docs)
+// ---------------------------------------------------------------------------
 const RESOURCES = [
     {
         uri: "screenpipe://context",
         name: "Current Context",
-        description: "Current date/time and pre-computed timestamps for common time ranges",
+        description: "Current date/time, timezone, and pre-computed timestamps for common time ranges",
         mimeType: "application/json",
     },
-    {
-        uri: "screenpipe://guide",
-        name: "Usage Guide",
-        description: "How to use screenpipe search effectively",
-        mimeType: "text/markdown",
-    },
-    {
-        uri: "ui://search",
-        name: "Search Dashboard",
-        description: "Interactive search UI for exploring screen recordings and audio transcriptions",
-        mimeType: "text/html",
-    },
-    {
-        uri: "screenpipe://pipe-creation-guide",
-        name: "Pipe Creation Guide",
-        description: "How to create screenpipe pipes (scheduled AI automations): format, YAML frontmatter, schedule syntax, API parameters, and example templates",
-        mimeType: "text/markdown",
-    },
-    {
-        uri: "screenpipe://api-reference",
-        name: "REST API Reference",
-        description: "Full screenpipe REST API reference: search, activity-summary, elements, frames, export, retranscribe, raw SQL, connections, speakers (60+ endpoints)",
-        mimeType: "text/markdown",
-    },
-    {
-        uri: "screenpipe://cli-reference",
-        name: "CLI Reference",
-        description: "Screenpipe CLI commands: pipe management (list, enable, run, install, delete) and connection management (Telegram, Slack, Discord, etc.)",
-        mimeType: "text/markdown",
-    },
 ];
-// List resources handler
 server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
     return { resources: RESOURCES };
 });
-// Read resource handler
 server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
     const { uri } = request.params;
-    const dateInfo = getCurrentDateInfo();
-    const now = Date.now();
-    switch (uri) {
-        case "screenpipe://context":
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "application/json",
-                        text: JSON.stringify({
-                            current_time: dateInfo.isoDate,
-                            current_date_local: dateInfo.localDate,
-                            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-                            timestamps: {
-                                now: dateInfo.isoDate,
-                                one_hour_ago: new Date(now - 60 * 60 * 1000).toISOString(),
-                                three_hours_ago: new Date(now - 3 * 60 * 60 * 1000).toISOString(),
-                                today_start: `${new Date().toISOString().split("T")[0]}T00:00:00Z`,
-                                yesterday_start: `${new Date(now - 24 * 60 * 60 * 1000).toISOString().split("T")[0]}T00:00:00Z`,
-                                one_week_ago: new Date(now - 7 * 24 * 60 * 60 * 1000).toISOString(),
-                            },
-                            common_apps: ["Google Chrome", "Safari", "Slack", "zoom.us", "Microsoft Teams", "Code", "Terminal"],
-                        }, null, 2),
-                    },
-                ],
-            };
-        case "screenpipe://guide":
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "text/markdown",
-                        text: `# Screenpipe Search Guide
-## Data Modalities
-Screenpipe captures four types of data:
-1. **Accessibility** - Screen text via accessibility APIs (primary, preferred for screen content)
-2. **OCR** - Screen text from screenshots (legacy fallback for apps without accessibility support)
-3. **Audio** - Transcribed speech from microphone/system audio
-4. **Input** - Keyboard input, mouse clicks, app switches, clipboard (macOS)
-## Quick Start
-- **Get recent activity**: Call search-content with no parameters
-- **Search screen text**: \`{"q": "search term", "content_type": "all"}\`
-- **Get keyboard input**: \`{"content_type": "input"}\`
-- **Get audio only**: \`{"content_type": "audio"}\`
-## Common User Requests → Correct Tool Choice
-| User says | Use this tool | Key params |
-|-----------|--------------|------------|
-| "summarize my meeting/call" | search-content | content_type:"audio", NO q param, start_time |
-| "what did they/I say about X" | search-content | content_type:"audio", NO q param (scan results manually) |
-| "how long on X" / "which apps" / "time spent" | activity-summary | start_time, end_time |
-| "what was I doing" | activity-summary | start_time, end_time (then drill into search-content) |
-| "what was I reading/looking at" | search-content | content_type:"all", start_time |
-## Behavior Rules
-- Act immediately on clear requests. NEVER ask "what time range?" or "which content type?" when the intent is obvious.
-- If search returns empty, silently retry with wider time range or fewer filters. Do NOT ask the user what to change.
-- For meetings: ALWAYS use content_type:"audio" and do NOT use the q param. Transcriptions are noisy — q filters too aggressively and misses relevant content.
-## search-content
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| q | Search query | (none - returns all) |
-| content_type | all/ocr/audio/input/accessibility | all |
-| limit | Max results | 10 |
-| start_time | ISO 8601 UTC or relative (e.g. '16h ago') | (no filter) |
-| end_time | ISO 8601 UTC or relative (e.g. 'now') | (no filter) |
-| app_name | Filter by app | (no filter) |
-| include_frames | Include screenshots | false |
-## Search Strategy (MANDATORY)
-1. First search: ONLY use time params (start_time/end_time). No q, no app_name, no content_type. This gives ground truth of what's recorded.
-2. Scan results to find correct app_name values and content patterns.
-3. Only THEN narrow with filters using exact observed values. App names are case-sensitive and may differ from user input (e.g. "Discord" vs "Discord.exe").
-4. The q param searches captured text (accessibility/OCR), NOT app names — an app can be visible without its name in the captured text.
-5. NEVER report "no data found" after one filtered search. Verify with unfiltered time-only search first.
-## Progressive Disclosure (Token-Efficient Strategy)
-1. **Start with activity-summary** (~200 tokens) for broad questions ("what was I doing?")
-2. **Narrow with search-content** (~500-1000 tokens) using filters from step 1
-3. **Drill into search-elements** (~200 tokens each) for structural UI detail (buttons, links)
-4. **Fetch frame-context** for URLs and accessibility tree of specific frames
-5. **Screenshots** (include_frames=true) only when text isn't enough
-## Chat History
-Previous screenpipe chat conversations are stored as individual JSON files in ~/.screenpipe/chats/{conversation-id}.json
-Each file contains: id, title, messages[], createdAt, updatedAt. You can read these files to reference or search previous conversations.
-## Speaker Management
-screenpipe auto-identifies speakers in audio. API endpoints for managing them:
-- \`GET /speakers/unnamed?limit=10\` — list unnamed speakers
-- \`GET /speakers/search?name=John\` — search by name
-- \`POST /speakers/update\` with \`{"id": 5, "name": "John"}\` — rename a speaker
-- \`POST /speakers/merge\` with \`{"speaker_to_keep_id": 1, "speaker_to_merge_id": 2}\` — merge duplicates
-- \`GET /speakers/similar?speaker_id=5\` — find similar speakers for merging
-- \`POST /speakers/reassign\` — reassign audio chunk to different speaker
-## Tips
-1. Read screenpipe://context first to get current timestamps
-2. Use activity-summary before search-content for broad overview questions
-3. Use search-elements instead of search-content for targeted UI lookups (10x lighter)
-4. Use content_type=input for "what did I type?" queries
-5. Use content_type=accessibility for accessibility tree text
-6. For large aggregations (e.g. "what apps did I use today?"), paginate with offset or suggest the user run raw SQL via \`curl -X POST http://localhost:3030/raw_sql\` for efficient GROUP BY queries
-## Deep Links (Clickable References)
-When showing search results to users, create clickable links so they can jump to that exact moment.
-**ALWAYS prefer frame-based links for OCR results** (frame IDs are exact DB keys):
-- \`[10:30 AM — Chrome](screenpipe://frame/12345)\` — use \`content.frame_id\` from OCR results
-**Use timestamp links only for audio results** (which have no frame_id):
-- \`[meeting at 3pm](screenpipe://timeline?timestamp=2024-01-15T15:00:00Z)\` — use exact \`timestamp\` from audio results
-**NEVER fabricate frame IDs or timestamps.** Only use values copied from actual search results.`,
-                    },
-                ],
-            };
-        case "ui://search": {
-            // MCP App UI - Interactive search dashboard
-            const uiHtmlPath = path.join(__dirname, "..", "ui", "search.html");
-            let htmlContent;
-            try {
-                htmlContent = fs.readFileSync(uiHtmlPath, "utf-8");
-            }
-            catch {
-                // Fallback: serve embedded minimal UI if file not found
-                htmlContent = `<!DOCTYPE html>
-<html>
-<head>
-  <style>
-    body { font-family: system-ui; background: #0a0a0a; color: #fff; padding: 20px; }
-    input { width: 100%; padding: 10px; margin-bottom: 10px; background: #1a1a1a; border: 1px solid #333; color: #fff; border-radius: 6px; }
-    button { padding: 10px 20px; background: #fff; color: #000; border: none; border-radius: 6px; cursor: pointer; }
-    #results { margin-top: 20px; }
-    .result { background: #1a1a1a; padding: 12px; margin: 8px 0; border-radius: 8px; border: 1px solid #333; }
-  </style>
-</head>
-<body>
-  <h2>screenpipe search</h2>
-  <input id="q" placeholder="search..." onkeydown="if(event.key==='Enter')search()"/>
-  <button onclick="search()">search</button>
-  <div id="results"></div>
-  <script>
-    function search() {
-      window.parent.postMessage({jsonrpc:'2.0',method:'tools/call',params:{name:'search-content',arguments:{q:document.getElementById('q').value,limit:20}}},'*');
-    }
-    window.addEventListener('message',e=>{
-      if(e.data?.result||e.data?.method==='tool/result'){
-        const r=e.data.result||e.data.params?.result;
-        const d=r?.data||r||[];
-        document.getElementById('results').innerHTML=d.map(x=>'<div class="result"><b>'+((x.type||'')+'</b> '+(x.content?.app_name||'')+': '+(x.content?.text||x.content?.transcription||'').substring(0,200))+'</div>').join('');
-      }
-    });
-  </script>
-</body>
-</html>`;
-            }
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "text/html",
-                        text: htmlContent,
-                    },
-                ],
-            };
-        }
-        case "screenpipe://pipe-creation-guide":
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "text/markdown",
-                        text: `# Screenpipe Pipe Creation Guide
-## What is a pipe?
-A pipe is a scheduled AI agent defined as a single markdown file: \`~/.screenpipe/pipes/{name}/pipe.md\`
-Every N minutes, screenpipe runs a coding agent (like pi or claude-code) with the pipe's prompt.
-The agent can query your screen data, write files, call external APIs, send notifications, etc.
-## pipe.md format
-The file starts with YAML frontmatter on the very first line (no blank lines before it), then the prompt body:
-\`\`\`markdown
----
-schedule: every 30m
-enabled: true
----
-Your prompt instructions here...
-\`\`\`
-### Config fields
-| Field | Values | Description |
-|-------|--------|-------------|
-| \`schedule\` | \`every 30m\`, \`every 1h\`, \`every day at 9am\`, \`every monday at 9am\`, \`manual\`, or cron: \`*/30 * * * *\` | When to run |
-| \`enabled\` | \`true\` / \`false\` | Whether the pipe is active |
-| \`preset\` | AI preset name (e.g. \`Oai\`) | Which AI model to use |
-| \`history\` | \`true\` / \`false\` | Include previous output as context |
-| \`connections\` | list of connection IDs | Required integrations (e.g. \`obsidian\`, \`telegram\`) |
-## Context header
-Before execution, screenpipe prepends a context header to the prompt with:
-- Time range (start/end timestamps based on the schedule interval)
-- Current date and user's timezone
-- Screenpipe API base URL (http://localhost:3030)
-- Output directory
-The AI agent uses this context to query the right time range. No template variables needed in the prompt.
-## Screenpipe search API
-The agent queries screen data via the local REST API:
-\`\`\`
-curl "http://localhost:3030/search?limit=20&content_type=all&start_time=<ISO8601>&end_time=<ISO8601>"
-\`\`\`
-### Query parameters
-| Parameter | Description |
-|-----------|-------------|
-| \`q\` | Text search query (optional — skip for audio, transcriptions are noisy) |
-| \`content_type\` | \`all\`, \`ocr\`, \`audio\`, \`input\`, \`accessibility\` (prefer \`all\` or \`accessibility\`) |
-| \`limit\` | Max results (default 20) |
-| \`offset\` | Pagination offset |
-| \`start_time\` / \`end_time\` | ISO 8601 timestamps or relative (\`1h ago\`, \`now\`) |
-| \`app_name\` | Filter by app (e.g. \`Google Chrome\`, \`Slack\`) |
-| \`window_name\` | Filter by window title |
-| \`browser_url\` | Filter by URL |
-| \`min_length\` / \`max_length\` | Filter by text length |
-| \`speaker_name\` | Filter audio by speaker |
-Other useful endpoints:
-- \`GET /activity-summary?start_time=...&end_time=...\` — lightweight overview (~200 tokens)
-- \`GET /elements?q=...&role=AXButton&start_time=...\` — UI elements
-- \`GET /connections/{id}\` — get integration credentials (telegram, slack, obsidian, etc.)
-- \`POST /raw_sql\` — run SQL queries (always include LIMIT)
-Full API reference: read the \`screenpipe://api-reference\` resource.
-## Installing and running
-After creating the pipe.md file:
-\`\`\`bash
-bunx screenpipe@latest pipe install ~/.screenpipe/pipes/my-pipe
-bunx screenpipe@latest pipe enable my-pipe
-bunx screenpipe@latest pipe run my-pipe   # test immediately
-\`\`\`
-## Example pipes
-### Daily recap (manual trigger)
-\`\`\`markdown
----
-schedule: manual
-enabled: true
----
-Analyze my screen and audio recordings from today (last 16 hours). Use limit=10 per search, max 5 searches total.
-## Summary
-One sentence: what I mainly did today.
-## Accomplishments
-- Top 3 things I finished, with timestamps
-## Key Moments
-- Important things I saw, said, or heard
-## Unfinished Work
-- What I should continue tomorrow
-\`\`\`
-### Obsidian sync (every hour)
-\`\`\`markdown
----
-schedule: every 1h
-enabled: true
-connections:
-  - obsidian
----
-Sync screenpipe activity to Obsidian vault as a daily note.
-1. Get vault path from GET http://localhost:3030/connections/obsidian
-2. Read existing daily note (merge into it)
-3. Query search API in 30-minute chunks with min_length=50
-4. Synthesize activities, extract action items, write note
-\`\`\`
-### Slack standup (every weekday at 9am)
-\`\`\`markdown
----
-schedule: every weekday at 9am
-enabled: true
-connections:
-  - slack
----
-Generate standup update from yesterday's activity and post to Slack.
-1. Query activity-summary for yesterday
-2. Search for key accomplishments and blockers
-3. Format as: Done / Doing / Blocked
-4. POST to Slack webhook from GET http://localhost:3030/connections/slack
-\`\`\`
-## Optimization tips
-- Be specific about expected output format
-- Give step-by-step instructions
-- Add error handling: "if API returns empty, try content_type=accessibility instead of ocr"
-- Add validation: "before writing, verify you have at least 3 entries"
-- Specify exact file paths, API parameters, output structure
-- Keep search limit low (10-20) and use time ranges from the context header
-- Use \`min_length=50\` to skip noisy OCR fragments`,
-                    },
-                ],
-            };
-        case "screenpipe://api-reference":
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "text/markdown",
-                        text: `# Screenpipe REST API Reference
-Local REST API at \`http://localhost:3030\`. Full reference (60+ endpoints): https://docs.screenpi.pe/llms-full.txt
-## Shell
-- **macOS/Linux** → \`bash\`, \`curl\`
-- **Windows** → \`powershell\`, \`curl.exe\` (not the alias)
-## Context Window Protection
-API responses can be large. Always write curl output to a file first (\`curl ... -o /tmp/sp_result.json\`), check size (\`wc -c\`), and if over 5KB read only the first 50-100 lines. Extract what you need with \`jq\`. NEVER dump full large responses into context.
----
-## 1. Search — \`GET /search\`
-\`\`\`bash
-curl "http://localhost:3030/search?q=QUERY&content_type=all&limit=10&start_time=1h%20ago"
-\`\`\`
-### Parameters
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| \`q\` | string | No | Keywords. Do NOT use for audio — transcriptions are noisy. |
-| \`content_type\` | string | No | \`all\` (default), \`ocr\`, \`audio\`, \`input\`, \`accessibility\` |
-| \`limit\` | integer | No | Max 1-20. Default: 10 |
-| \`offset\` | integer | No | Pagination. Default: 0 |
-| \`start_time\` | ISO 8601 or relative | **Yes** | \`2024-01-15T10:00:00Z\` or \`16h ago\`, \`2d ago\`, \`30m ago\` |
-| \`end_time\` | ISO 8601 or relative | No | Defaults to now. \`now\`, \`1h ago\` |
-| \`app_name\` | string | No | e.g. "Google Chrome", "Slack", "zoom.us" |
-| \`window_name\` | string | No | Window title substring |
-| \`speaker_name\` | string | No | Filter audio by speaker (case-insensitive partial) |
-| \`focused\` | boolean | No | Only focused windows |
-### Critical Rules
-1. **ALWAYS include \`start_time\`** — queries without time bounds WILL timeout
-2. **Start with 1-2 hour ranges** — expand only if no results
-3. **Use \`app_name\`** when user mentions a specific app
-4. **"recent"** = 30 min. **"today"** = since midnight. **"yesterday"** = yesterday's range
-### Response Format
-\`\`\`json
-{
-  "data": [
-    {"type": "OCR", "content": {"frame_id": 12345, "text": "...", "timestamp": "...", "app_name": "Chrome"}},
-    {"type": "Audio", "content": {"chunk_id": 678, "transcription": "...", "timestamp": "...", "speaker": {"name": "John"}}},
-    {"type": "UI", "content": {"id": 999, "text": "Clicked Submit", "timestamp": "...", "app_name": "Safari"}}
-  ],
-  "pagination": {"limit": 10, "offset": 0, "total": 42}
-}
-\`\`\`
----
-## 2. Activity Summary — \`GET /activity-summary\`
-\`\`\`bash
-curl "http://localhost:3030/activity-summary?start_time=1h%20ago&end_time=now"
-\`\`\`
-Returns app usage with \`active_minutes\`, first/last seen, recent texts, audio summary. ~200-500 tokens. Best starting point.
----
-## 3. Elements — \`GET /elements\`
-Lightweight FTS search across UI elements (~100-500 bytes each).
-\`\`\`bash
-curl "http://localhost:3030/elements?q=Submit&role=AXButton&start_time=1h%20ago&limit=10"
-\`\`\`
-Parameters: \`q\`, \`frame_id\`, \`source\` (\`accessibility\`|\`ocr\`), \`role\`, \`start_time\`, \`end_time\`, \`app_name\`, \`limit\`, \`offset\`.
-### Frame Context — \`GET /frames/{id}/context\`
-Returns accessibility text, parsed nodes, and extracted URLs for a frame.
-Common roles: \`AXButton\`, \`AXStaticText\`, \`AXLink\`, \`AXTextField\`, \`AXTextArea\`, \`AXMenuItem\`, \`AXCheckBox\`
----
-## 4. Frames — \`GET /frames/{frame_id}\`
-Returns raw PNG screenshot. Never fetch more than 2-3 per query.
----
-## 5. Media Export — \`POST /frames/export\`
-\`\`\`bash
-curl -X POST http://localhost:3030/frames/export \\
-  -H "Content-Type: application/json" \\
-  -d '{"start_time": "5m ago", "end_time": "now", "fps": 1.0}'
-\`\`\`
-FPS guidelines: 5min→1.0, 30min→0.5, 1h→0.2, 2h+→0.1. Max 10,000 frames.
----
-## 6. Retranscribe — \`POST /audio/retranscribe\`
-\`\`\`bash
-curl -X POST http://localhost:3030/audio/retranscribe \\
-  -H "Content-Type: application/json" \\
-  -d '{"start": "1h ago", "end": "now"}'
-\`\`\`
-Optional: \`engine\`, \`vocabulary\` (array of \`{"word": "...", "replacement": "..."}\`), \`prompt\` (topic context).
----
-## 7. Raw SQL — \`POST /raw_sql\`
-\`\`\`bash
-curl -X POST http://localhost:3030/raw_sql \\
-  -H "Content-Type: application/json" \\
-  -d '{"query": "SELECT ... LIMIT 100"}'
-\`\`\`
-Every SELECT needs LIMIT. Always filter by time. Read-only.
-### Schema
-| Table | Key Columns | Time Column |
-|-------|-------------|-------------|
-| \`frames\` | \`app_name\`, \`window_name\`, \`browser_url\`, \`focused\` | \`timestamp\` |
-| \`ocr_text\` | \`text\`, \`app_name\`, \`window_name\` | join via \`frame_id\` |
-| \`elements\` | \`source\`, \`role\`, \`text\` | join via \`frame_id\` |
-| \`audio_transcriptions\` | \`transcription\`, \`device\`, \`speaker_id\`, \`is_input_device\` | \`timestamp\` |
-| \`speakers\` | \`name\`, \`metadata\` | — |
-| \`ui_events\` | \`event_type\`, \`app_name\`, \`window_title\`, \`browser_url\` | \`timestamp\` |
-| \`accessibility\` | \`app_name\`, \`window_name\`, \`text_content\` | \`timestamp\` |
-### Example Queries
-\`\`\`sql
--- Most used apps (last 24h)
-SELECT app_name, COUNT(*) as frames FROM frames
-WHERE timestamp > datetime('now', '-24 hours') AND app_name IS NOT NULL
-GROUP BY app_name ORDER BY frames DESC LIMIT 20
--- Speaker stats
-SELECT COALESCE(NULLIF(s.name, ''), 'Unknown') as speaker, COUNT(*) as segments
-FROM audio_transcriptions at LEFT JOIN speakers s ON at.speaker_id = s.id
-WHERE at.timestamp > datetime('now', '-24 hours')
-GROUP BY at.speaker_id ORDER BY segments DESC LIMIT 20
-\`\`\`
----
-## 8. Connections — \`GET /connections\`
-\`\`\`bash
-curl http://localhost:3030/connections              # List all
-curl http://localhost:3030/connections/telegram      # Get credentials
-\`\`\`
-Services: Telegram (\`bot_token\` + \`chat_id\`), Slack (\`webhook_url\`), Discord (\`webhook_url\`), Todoist (\`api_token\`), Teams (\`webhook_url\`), Email (SMTP config).
----
-## 9. Speakers
-\`\`\`bash
-curl "http://localhost:3030/speakers/search?name=John"
-curl "http://localhost:3030/speakers/unnamed?limit=10"
-curl -X POST http://localhost:3030/speakers/update -H "Content-Type: application/json" -d '{"id": 5, "name": "John"}'
-curl -X POST http://localhost:3030/speakers/merge -H "Content-Type: application/json" -d '{"speaker_to_keep_id": 1, "speaker_to_merge_id": 2}'
-\`\`\`
----
-## 10. Other Endpoints
-\`\`\`bash
-curl http://localhost:3030/health              # Health check
-curl http://localhost:3030/audio/list           # Audio devices
-curl http://localhost:3030/vision/list          # Monitors
-\`\`\`
-## Pipes API
-\`\`\`bash
-curl http://localhost:3030/pipes/list                              # List all pipes
-curl -X POST http://localhost:3030/pipes/enable -d '{"name":"..."}'  # Enable
-curl -X POST http://localhost:3030/pipes/disable -d '{"name":"..."}' # Disable
-curl -X POST http://localhost:3030/pipes/run -d '{"name":"..."}'     # Run once
-curl "http://localhost:3030/pipes/{name}/executions?limit=5"       # Execution history
-\`\`\`
-## Deep Links
-\`\`\`markdown
-[10:30 AM — Chrome](screenpipe://frame/12345)              # OCR results (use frame_id)
-[meeting at 3pm](screenpipe://timeline?timestamp=ISO8601)  # Audio results (use timestamp)
-\`\`\`
-Only use IDs/timestamps from actual search results. Never fabricate.`,
-                    },
-                ],
-            };
-        case "screenpipe://cli-reference":
-            return {
-                contents: [
-                    {
-                        uri,
-                        mimeType: "text/markdown",
-                        text: `# Screenpipe CLI Reference
-Use \`bunx screenpipe@latest\` to run CLI commands (or \`npx screenpipe@latest\`). No separate install needed.
-## Shell
-- **macOS/Linux** → \`bash\`
-- **Windows** → \`powershell\`
----
-## Pipe Management
-Pipes are markdown-based AI automations. Each pipe lives at \`~/.screenpipe/pipes/<name>/pipe.md\`.
-### Commands
-\`\`\`bash
-bunx screenpipe@latest pipe list                    # List all pipes (compact table)
-bunx screenpipe@latest pipe enable <name>           # Enable a pipe
-bunx screenpipe@latest pipe disable <name>          # Disable a pipe
-bunx screenpipe@latest pipe run <name>              # Run once immediately (for testing)
-bunx screenpipe@latest pipe logs <name>             # View execution logs
-bunx screenpipe@latest pipe install <url-or-path>   # Install from GitHub or local path
-bunx screenpipe@latest pipe delete <name>           # Delete a pipe
-bunx screenpipe@latest pipe models list             # View AI model presets
-\`\`\`
-### Creating a Pipe
-Create \`~/.screenpipe/pipes/<name>/pipe.md\` with YAML frontmatter + prompt:
-\`\`\`markdown
----
-schedule: every 30m
-enabled: true
-preset: Oai
----
-Your prompt instructions here. The AI agent executes this on schedule.
-\`\`\`
-**Schedule syntax**: \`every 30m\`, \`every 1h\`, \`every day at 9am\`, \`every monday at 9am\`, \`manual\`, or cron: \`*/30 * * * *\`
-**Config fields**: \`schedule\`, \`enabled\` (bool), \`preset\` (AI preset name), \`history\` (bool — include previous output), \`connections\` (list of required integrations)
-After creating:
-\`\`\`bash
-bunx screenpipe@latest pipe install ~/.screenpipe/pipes/my-pipe
-bunx screenpipe@latest pipe enable my-pipe
-bunx screenpipe@latest pipe run my-pipe   # test immediately
-\`\`\`
-### Editing Config
-Edit frontmatter in the pipe.md file directly, or via API:
-\`\`\`bash
-curl -X POST http://localhost:3030/pipes/<name>/config \\
-  -H "Content-Type: application/json" \\
-  -d '{"config": {"schedule": "every 1h", "enabled": true}}'
-\`\`\`
-### Rules
-1. Use \`pipe list\` (not \`--json\`) — table output is compact
-2. Never dump full pipe JSON — can be 15MB+
-3. Check logs first when debugging: \`pipe logs <name>\`
-4. Use \`pipe run <name>\` to test before waiting for schedule
----
-## Connection Management
-Manage integrations (Telegram, Slack, Discord, Email, Todoist, Teams) from the CLI.
-### Commands
-\`\`\`bash
-bunx screenpipe@latest connection list              # List all connections + status
-bunx screenpipe@latest connection list --json       # JSON output
-bunx screenpipe@latest connection get <id>          # Show saved credentials
-bunx screenpipe@latest connection set <id> key=val  # Save credentials
-bunx screenpipe@latest connection test <id>         # Test a connection
-bunx screenpipe@latest connection remove <id>       # Remove credentials
-\`\`\`
-### Examples
-\`\`\`bash
-# Set up Telegram
-bunx screenpipe@latest connection set telegram bot_token=123456:ABC-DEF chat_id=5776185278
-# Set up Slack webhook
-bunx screenpipe@latest connection set slack webhook_url=https://hooks.slack.com/services/...
-# Verify it works
-bunx screenpipe@latest connection test telegram
-\`\`\`
-Connection IDs: \`telegram\`, \`slack\`, \`discord\`, \`email\`, \`todoist\`, \`teams\`, \`google-calendar\`, \`apple-intelligence\`, \`openclaw\`, \`obsidian\`
-Credentials are stored locally at \`~/.screenpipe/connections.json\`.`,
-                    },
-                ],
-            };
-        default:
-            throw new Error(`Unknown resource: ${uri}`);
-    }
-});
-// MCP Prompts - static interaction templates
-const PROMPTS = [
-    {
-        name: "search-recent",
-        description: "Search recent screen activity",
-        arguments: [
-            { name: "query", description: "Optional search term", required: false },
-            { name: "hours", description: "Hours to look back (default: 1)", required: false },
-        ],
-    },
-    {
-        name: "find-in-app",
-        description: "Find content from a specific application",
-        arguments: [
-            { name: "app", description: "App name (e.g., Chrome, Slack)", required: true },
-            { name: "query", description: "Optional search term", required: false },
-        ],
-    },
-    {
-        name: "meeting-notes",
-        description: "Get audio transcriptions from meetings",
-        arguments: [
-            { name: "hours", description: "Hours to look back (default: 3)", required: false },
-        ],
-    },
-    {
-        name: "create-pipe",
-        description: "Create a new screenpipe pipe (scheduled AI automation)",
-        arguments: [
-            { name: "description", description: "What the pipe should do", required: true },
-            { name: "schedule", description: "Schedule (e.g., 'every 30m', 'every day at 9am', 'manual')", required: false },
-        ],
-    },
-];
-// List prompts handler
-server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => {
-    return { prompts: PROMPTS };
-});
-// Get prompt handler
-server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
-    const { name, arguments: promptArgs } = request.params;
-    const dateInfo = getCurrentDateInfo();
-    const now = Date.now();
-    switch (name) {
-        case "search-recent": {
-            const query = promptArgs?.query || "";
-            const hours = parseInt(promptArgs?.hours || "1", 10);
-            const startTime = new Date(now - hours * 60 * 60 * 1000).toISOString();
-            return {
-                description: `Search recent activity (last ${hours} hour${hours > 1 ? "s" : ""})`,
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: `Search screenpipe for recent activity.
-Current time: ${dateInfo.isoDate}
-Use search-content with:
-${query ? `- q: "${query}"` : "- No query filter (get all content)"}
-- start_time: "${startTime}"
-- limit: 50`,
-                        },
-                    },
-                ],
-            };
-        }
-        case "find-in-app": {
-            const app = promptArgs?.app || "Google Chrome";
-            const query = promptArgs?.query || "";
-            return {
-                description: `Find content from ${app}`,
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: `Search screenpipe for content from ${app}.
-Current time: ${dateInfo.isoDate}
-Use search-content with:
-- app_name: "${app}"
-${query ? `- q: "${query}"` : "- No query filter"}
-- content_type: "all"
-- limit: 50`,
-                        },
-                    },
-                ],
-            };
-        }
-        case "meeting-notes": {
-            const hours = parseInt(promptArgs?.hours || "3", 10);
-            const startTime = new Date(now - hours * 60 * 60 * 1000).toISOString();
-            return {
-                description: `Get meeting transcriptions (last ${hours} hours)`,
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: `Get audio transcriptions from recent meetings.
-Current time: ${dateInfo.isoDate}
-Use search-content with:
-- content_type: "audio"
-- start_time: "${startTime}"
-- limit: 100
-Common meeting apps: zoom.us, Microsoft Teams, Google Meet, Slack`,
-                        },
-                    },
-                ],
-            };
-        }
-        case "create-pipe": {
-            const description = promptArgs?.description || "a useful automation";
-            const schedule = promptArgs?.schedule || "every 30m";
-            return {
-                description: `Create a new screenpipe pipe: ${description}`,
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: `Create a new screenpipe pipe based on this description: "${description}"
-Schedule: ${schedule}
-## How to create a pipe
-A pipe is a TypeScript file that runs on a schedule or manually. It uses the screenpipe API to access screen/audio data and can send notifications, call AI, etc.
-### Pipe structure
-\`\`\`typescript
-const pipe = () => import("https://raw.githubusercontent.com/nichochar/screenpipe/refs/heads/main/pipes/pipe-modules/pipe-core/index.ts");
-async function main() {
-  const sp = await pipe();
-  // Query recent screen/audio data
-  const results = await sp.queryScreenpipe({
-    q: "search term",
-    contentType: "all", // "ocr" | "audio" | "all" | "ui"
-    limit: 50,
-    startTime: new Date(Date.now() - 30 * 60 * 1000).toISOString(),
-    endTime: new Date().toISOString(),
-  });
-  // Send notification
-  await sp.sendDesktopNotification({ title: "Title", body: "Body" });
-  // Call AI (uses user's configured AI provider)
-  const response = await sp.generateText({
-    messages: [{ role: "user", content: "Analyze this data..." }],
-  });
-}
-main();
-\`\`\`
-### Key APIs available in pipes
-- \`queryScreenpipe(params)\` - Search screen text (OCR/UI), audio transcriptions
-- \`sendDesktopNotification({ title, body })\` - System notifications
-- \`generateText({ messages, model? })\` - AI text generation
-- \`generateObject({ messages, schema, model? })\` - AI structured output
-- \`loadPipeConfig()\` - Load pipe configuration
-- \`fetch()\` - HTTP requests to external services
-### pipe.json config
-\`\`\`json
-{
-  "cron": "${schedule === "manual" ? "" : schedule.replace("every ", "*/").replace("m", " * * * *").replace("h", " * * *")}",
-  "is_nextjs": false,
-  "fields": [
-    { "name": "setting_name", "type": "string", "default": "value", "description": "Setting description" }
-  ]
-}
-\`\`\`
-### Important notes
-- Use \`contentType: "ui"\` for accessibility/structured text, \`"ocr"\` for raw screen text
-- Always handle empty results gracefully
-- Use \`startTime\`/\`endTime\` to scope queries
-- Pipes run in Bun runtime with full TypeScript support
-- For scheduled pipes, keep execution fast (< 30s)
-Create the pipe with the necessary files (pipe.ts and pipe.json). Follow the patterns above exactly.`,
+    if (uri === "screenpipe://context") {
+        const now = new Date();
+        const ms = now.getTime();
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        current_time: now.toISOString(),
+                        current_date_local: now.toLocaleDateString("en-US", {
+                            weekday: "long",
+                            year: "numeric",
+                            month: "long",
+                            day: "numeric",
+                        }),
+                        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+                        timestamps: {
+                            now: now.toISOString(),
+                            one_hour_ago: new Date(ms - 60 * 60 * 1000).toISOString(),
+                            three_hours_ago: new Date(ms - 3 * 60 * 60 * 1000).toISOString(),
+                            today_start: `${now.toISOString().split("T")[0]}T00:00:00Z`,
+                            yesterday_start: `${new Date(ms - 24 * 60 * 60 * 1000).toISOString().split("T")[0]}T00:00:00Z`,
+                            one_week_ago: new Date(ms - 7 * 24 * 60 * 60 * 1000).toISOString(),
                         },
-                    },
-                ],
-            };
-        }
-        default:
-            throw new Error(`Unknown prompt: ${name}`);
+                    }, null, 2),
+                },
+            ],
+        };
     }
+    throw new Error(`Unknown resource: ${uri}`);
 });
-// Helper function to make HTTP requests
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
 async function fetchAPI(endpoint, options = {}) {
     const url = `${SCREENPIPE_API}${endpoint}`;
     return fetch(url, {
@@ -1272,7 +306,9 @@ async function fetchAPI(endpoint, options = {}) {
         },
     });
 }
-// Call tool handler
+// ---------------------------------------------------------------------------
+// Tool handlers
+// ---------------------------------------------------------------------------
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     if (!args) {
@@ -1289,9 +325,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     }
                 }
                 const response = await fetchAPI(`/search?${params.toString()}`);
-                if (!response.ok) {
+                if (!response.ok)
                     throw new Error(`HTTP error: ${response.status}`);
-                }
                 const data = await response.json();
                 const results = data.data || [];
                 const pagination = data.pagination || {};
@@ -1300,12 +335,11 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         content: [
                             {
                                 type: "text",
-                                text: "No results found. Try: broader search terms, different content_type, or wider time range.",
+                                text: "No results found. Try: broader terms, different content_type, or wider time range.",
                             },
                         ],
                     };
                 }
-                // Build content array with text and optional images
                 const contentItems = [];
                 const formattedResults = [];
                 const images = [];
@@ -1338,42 +372,173 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                             `${content.timestamp || ""}\n` +
                             `${content.text || ""}`);
                     }
+                    else if (result.type === "Memory") {
+                        const tagsStr = content.tags?.length ? ` [${content.tags.join(", ")}]` : "";
+                        const importance = content.importance != null ? ` (importance: ${content.importance})` : "";
+                        formattedResults.push(`[Memory #${content.id}]${tagsStr}${importance}\n` +
+                            `${content.created_at || ""}\n` +
+                            `${content.content || ""}`);
+                    }
                 }
-                // Header with pagination info
                 const header = `Results: ${results.length}/${pagination.total || "?"}` +
-                    (pagination.total > results.length ? ` (use offset=${(pagination.offset || 0) + results.length} for more)` : "");
+                    (pagination.total > results.length
+                        ? ` (use offset=${(pagination.offset || 0) + results.length} for more)`
+                        : "");
                 contentItems.push({
                     type: "text",
                     text: header + "\n\n" + formattedResults.join("\n---\n"),
                 });
-                // Add images if requested
                 for (const img of images) {
                     contentItems.push({ type: "text", text: `\n📷 ${img.context}` });
                     contentItems.push({ type: "image", data: img.data, mimeType: "image/png" });
                 }
                 return { content: contentItems };
             }
-            case "export-video": {
-                const startTime = args.start_time;
-                const endTime = args.end_time;
-                const fps = args.fps || 1.0;
-                // Validate time inputs
-                if (!startTime || !endTime) {
+            case "list-meetings": {
+                const params = new URLSearchParams();
+                for (const [key, value] of Object.entries(args)) {
+                    if (value !== null && value !== undefined) {
+                        params.append(key, String(value));
+                    }
+                }
+                const response = await fetchAPI(`/meetings?${params.toString()}`);
+                if (!response.ok)
+                    throw new Error(`HTTP error: ${response.status}`);
+                const meetings = await response.json();
+                if (!Array.isArray(meetings) || meetings.length === 0) {
+                    return {
+                        content: [{ type: "text", text: "No meetings found in the given time range." }],
+                    };
+                }
+                const formatted = meetings.map((m) => {
+                    const start = m.meeting_start;
+                    const end = m.meeting_end || "ongoing";
+                    const app = m.meeting_app;
+                    const title = m.title ? ` — ${m.title}` : "";
+                    const attendees = m.attendees ? `\nAttendees: ${m.attendees}` : "";
+                    return `[${m.detection_source}] ${app}${title}\n  ${start} → ${end}${attendees}`;
+                });
+                return {
+                    content: [
+                        { type: "text", text: `Meetings: ${meetings.length}\n\n${formatted.join("\n---\n")}` },
+                    ],
+                };
+            }
+            case "activity-summary": {
+                const params = new URLSearchParams();
+                for (const [key, value] of Object.entries(args)) {
+                    if (value !== null && value !== undefined) {
+                        params.append(key, String(value));
+                    }
+                }
+                const response = await fetchAPI(`/activity-summary?${params.toString()}`);
+                if (!response.ok)
+                    throw new Error(`HTTP error: ${response.status}`);
+                const data = await response.json();
+                const appsLines = (data.apps || []).map((a) => {
+                    const timeSpan = a.first_seen && a.last_seen
+                        ? `, ${a.first_seen.slice(11, 16)}–${a.last_seen.slice(11, 16)} UTC`
+                        : "";
+                    return `  ${a.name}: ${a.minutes} min (${a.frame_count} frames${timeSpan})`;
+                });
+                const speakerLines = (data.audio_summary?.speakers || []).map((s) => `  ${s.name}: ${s.segment_count} segments`);
+                const textLines = (data.recent_texts || []).map((t) => `  [${t.app_name}] ${t.text}`);
+                const summary = [
+                    `Activity Summary (${data.time_range?.start} → ${data.time_range?.end})`,
+                    `Total frames: ${data.total_frames}`,
+                    "",
+                    "Apps:",
+                    ...(appsLines.length ? appsLines : ["  (none)"]),
+                    "",
+                    `Audio: ${data.audio_summary?.segment_count || 0} segments`,
+                    ...(speakerLines.length ? speakerLines : []),
+                    "",
+                    "Recent texts:",
+                    ...(textLines.length ? textLines.slice(0, 10) : ["  (none)"]),
+                ].join("\n");
+                return { content: [{ type: "text", text: summary }] };
+            }
+            case "search-elements": {
+                const params = new URLSearchParams();
+                for (const [key, value] of Object.entries(args)) {
+                    if (value !== null && value !== undefined) {
+                        params.append(key, String(value));
+                    }
+                }
+                const response = await fetchAPI(`/elements?${params.toString()}`);
+                if (!response.ok)
+                    throw new Error(`HTTP error: ${response.status}`);
+                const data = await response.json();
+                const elements = data.data || [];
+                const pagination = data.pagination || {};
+                if (elements.length === 0) {
                     return {
                         content: [
                             {
                                 type: "text",
-                                text: "Error: Both start_time and end_time are required in ISO 8601 format (e.g., '2024-01-15T10:00:00Z')",
+                                text: "No elements found. Try: broader search, different role/source, or wider time range.",
                             },
                         ],
                     };
                 }
-                // Step 1: Query the search API to get frame IDs for the time range
+                const formatted = elements.map((e) => {
+                    const boundsStr = e.bounds
+                        ? ` [${e.bounds.left.toFixed(2)},${e.bounds.top.toFixed(2)} ${e.bounds.width.toFixed(2)}x${e.bounds.height.toFixed(2)}]`
+                        : "";
+                    return `[${e.source}] ${e.role} (frame:${e.frame_id}, depth:${e.depth})${boundsStr}\n  ${e.text || "(no text)"}`;
+                });
+                const header = `Elements: ${elements.length}/${pagination.total || "?"}` +
+                    (pagination.total > elements.length
+                        ? ` (use offset=${(pagination.offset || 0) + elements.length} for more)`
+                        : "");
+                return {
+                    content: [{ type: "text", text: header + "\n\n" + formatted.join("\n---\n") }],
+                };
+            }
+            case "frame-context": {
+                const frameId = args.frame_id;
+                if (!frameId) {
+                    return { content: [{ type: "text", text: "Error: frame_id is required" }] };
+                }
+                const response = await fetchAPI(`/frames/${frameId}/context`);
+                if (!response.ok)
+                    throw new Error(`HTTP error: ${response.status}`);
+                const data = await response.json();
+                const lines = [`Frame ${data.frame_id} (source: ${data.text_source})`];
+                if (data.urls?.length) {
+                    lines.push("", "URLs:", ...data.urls.map((u) => `  ${u}`));
+                }
+                if (data.nodes?.length) {
+                    lines.push("", `Nodes: ${data.nodes.length}`);
+                    for (const node of data.nodes.slice(0, 50)) {
+                        const indent = "  ".repeat(Math.min(node.depth, 5));
+                        lines.push(`${indent}[${node.role}] ${node.text}`);
+                    }
+                    if (data.nodes.length > 50) {
+                        lines.push(`  ... and ${data.nodes.length - 50} more nodes`);
+                    }
+                }
+                if (data.text) {
+                    const truncated = data.text.length > 2000 ? data.text.substring(0, 2000) + "..." : data.text;
+                    lines.push("", "Full text:", truncated);
+                }
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            case "export-video": {
+                const startTime = args.start_time;
+                const endTime = args.end_time;
+                const fps = args.fps || 1.0;
+                if (!startTime || !endTime) {
+                    return {
+                        content: [{ type: "text", text: "Error: start_time and end_time are required" }],
+                    };
+                }
+                // Get frame IDs for the time range
                 const searchParams = new URLSearchParams({
                     content_type: "ocr",
                     start_time: startTime,
                     end_time: endTime,
-                    limit: "10000", // Get all frames in range
+                    limit: "10000",
                 });
                 const searchResponse = await fetchAPI(`/search?${searchParams.toString()}`);
                 if (!searchResponse.ok) {
@@ -1386,12 +551,11 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         content: [
                             {
                                 type: "text",
-                                text: `No screen recordings found between ${startTime} and ${endTime}. Make sure screenpipe was recording during this time period.`,
+                                text: `No screen recordings found between ${startTime} and ${endTime}.`,
                             },
                         ],
                     };
                 }
-                // Extract unique frame IDs from OCR results
                 const frameIds = [];
                 const seenIds = new Set();
                 for (const result of results) {
@@ -1405,18 +569,10 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                 }
                 if (frameIds.length === 0) {
                     return {
-                        content: [
-                            {
-                                type: "text",
-                                text: `Found ${results.length} results but no valid frame IDs. The recordings may be audio-only.`,
-                            },
-                        ],
+                        content: [{ type: "text", text: "No valid frame IDs found (audio-only?)." }],
                     };
                 }
-                // Sort frame IDs
                 frameIds.sort((a, b) => a - b);
-                // Step 2: Connect to WebSocket and export video
-                // Send frame_ids in message body to avoid URL length limits
                 const wsUrl = `ws://localhost:${port}/frames/export?fps=${fps}`;
                 const exportResult = await new Promise((resolve) => {
                     const ws = new ws_1.WebSocket(wsUrl);
@@ -1427,9 +583,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                             ws.close();
                             resolve({ success: false, error: "Export timed out after 5 minutes" });
                         }
-                    }, 5 * 60 * 1000); // 5 minute timeout
+                    }, 5 * 60 * 1000);
                     ws.on("open", () => {
-                        // Send frame_ids in message body to avoid URL length limits
                         ws.send(JSON.stringify({ frame_ids: frameIds }));
                     });
                     ws.on("error", (error) => {
@@ -1450,7 +605,6 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         try {
                             const message = JSON.parse(data.toString());
                             if (message.status === "completed" && message.video_data) {
-                                // Save video to temp file
                                 const tempDir = os.tmpdir();
                                 const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
                                 const filename = `screenpipe_export_${timestamp}.mp4`;
@@ -1459,11 +613,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                 resolved = true;
                                 clearTimeout(timeout);
                                 ws.close();
-                                resolve({
-                                    success: true,
-                                    filePath,
-                                    frameCount: frameIds.length,
-                                });
+                                resolve({ success: true, filePath, frameCount: frameIds.length });
                             }
                             else if (message.status === "error") {
                                 resolved = true;
@@ -1471,9 +621,8 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                                 ws.close();
                                 resolve({ success: false, error: message.error || "Export failed" });
                             }
-                            // Ignore "extracting" and "encoding" status updates
                         }
-                        catch (parseError) {
+                        catch {
                             // Ignore parse errors for progress messages
                         }
                     });
@@ -1483,176 +632,94 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         content: [
                             {
                                 type: "text",
-                                text: `Successfully exported video!\n\n` +
-                                    `File: ${exportResult.filePath}\n` +
-                                    `Frames: ${exportResult.frameCount}\n` +
-                                    `Time range: ${startTime} to ${endTime}\n` +
-                                    `FPS: ${fps}`,
+                                text: `Video exported: ${exportResult.filePath}\n` +
+                                    `Frames: ${exportResult.frameCount} | ${startTime} → ${endTime} | ${fps} fps`,
                             },
                         ],
                     };
                 }
                 else {
                     return {
-                        content: [
-                            {
-                                type: "text",
-                                text: `Failed to export video: ${exportResult.error}`,
-                            },
-                        ],
+                        content: [{ type: "text", text: `Export failed: ${exportResult.error}` }],
                     };
                 }
             }
-            case "list-meetings": {
-                const params = new URLSearchParams();
-                for (const [key, value] of Object.entries(args)) {
-                    if (value !== null && value !== undefined) {
-                        params.append(key, String(value));
-                    }
+            case "update-memory": {
+                if (args.delete && args.id) {
+                    const response = await fetchAPI(`/memories/${args.id}`, { method: "DELETE" });
+                    if (!response.ok)
+                        throw new Error(`HTTP error: ${response.status}`);
+                    return { content: [{ type: "text", text: `Memory ${args.id} deleted.` }] };
                 }
-                const response = await fetchAPI(`/meetings?${params.toString()}`);
-                if (!response.ok) {
-                    throw new Error(`HTTP error: ${response.status}`);
+                if (args.id) {
+                    const body = {};
+                    if (args.content !== undefined)
+                        body.content = args.content;
+                    if (args.tags !== undefined)
+                        body.tags = args.tags;
+                    if (args.importance !== undefined)
+                        body.importance = args.importance;
+                    if (args.source_context !== undefined)
+                        body.source_context = args.source_context;
+                    const response = await fetchAPI(`/memories/${args.id}`, {
+                        method: "PUT",
+                        body: JSON.stringify(body),
+                    });
+                    if (!response.ok)
+                        throw new Error(`HTTP error: ${response.status}`);
+                    const memory = await response.json();
+                    return {
+                        content: [{ type: "text", text: `Memory ${memory.id} updated: "${memory.content}"` }],
+                    };
                 }
-                const meetings = await response.json();
-                if (!Array.isArray(meetings) || meetings.length === 0) {
+                if (!args.content) {
                     return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "No meetings found. Make sure screenpipe is running in smart transcription mode.",
-                            },
-                        ],
+                        content: [{ type: "text", text: "Error: 'content' is required to create a memory" }],
                     };
                 }
-                const formatted = meetings.map((m) => {
-                    const start = m.meeting_start;
-                    const end = m.meeting_end || "ongoing";
-                    const app = m.meeting_app;
-                    const title = m.title ? ` — ${m.title}` : "";
-                    const attendees = m.attendees ? `\nAttendees: ${m.attendees}` : "";
-                    return `[${m.detection_source}] ${app}${title}\n  ${start} → ${end}${attendees}`;
+                const memoryBody = {
+                    content: args.content,
+                    source: "mcp",
+                    tags: args.tags || [],
+                    importance: args.importance ?? 0.5,
+                };
+                if (args.source_context)
+                    memoryBody.source_context = args.source_context;
+                const memoryResponse = await fetchAPI("/memories", {
+                    method: "POST",
+                    body: JSON.stringify(memoryBody),
                 });
+                if (!memoryResponse.ok)
+                    throw new Error(`HTTP error: ${memoryResponse.status}`);
+                const newMemory = await memoryResponse.json();
                 return {
                     content: [
-                        {
-                            type: "text",
-                            text: `Meetings: ${meetings.length}\n\n${formatted.join("\n---\n")}`,
-                        },
+                        { type: "text", text: `Memory created (id: ${newMemory.id}): "${newMemory.content}"` },
                     ],
                 };
             }
-            case "activity-summary": {
-                const params = new URLSearchParams();
-                for (const [key, value] of Object.entries(args)) {
-                    if (value !== null && value !== undefined) {
-                        params.append(key, String(value));
-                    }
-                }
-                const response = await fetchAPI(`/activity-summary?${params.toString()}`);
-                if (!response.ok) {
-                    throw new Error(`HTTP error: ${response.status}`);
-                }
-                const data = await response.json();
-                // Format apps
-                const appsLines = (data.apps || []).map((a) => {
-                    const timeSpan = a.first_seen && a.last_seen
-                        ? `, ${a.first_seen.slice(11, 16)}–${a.last_seen.slice(11, 16)} UTC`
-                        : "";
-                    return `  ${a.name}: ${a.minutes} min (${a.frame_count} frames${timeSpan})`;
-                });
-                // Format audio
-                const speakerLines = (data.audio_summary?.speakers || []).map((s) => `  ${s.name}: ${s.segment_count} segments`);
-                // Format recent texts
-                const textLines = (data.recent_texts || []).map((t) => `  [${t.app_name}] ${t.text}`);
-                const summary = [
-                    `Activity Summary (${data.time_range?.start} → ${data.time_range?.end})`,
-                    `Total frames: ${data.total_frames}`,
-                    "",
-                    "Apps:",
-                    ...(appsLines.length ? appsLines : ["  (none)"]),
-                    "",
-                    `Audio: ${data.audio_summary?.segment_count || 0} segments`,
-                    ...(speakerLines.length ? speakerLines : []),
-                    "",
-                    "Recent texts:",
-                    ...(textLines.length ? textLines.slice(0, 10) : ["  (none)"]),
-                ].join("\n");
-                return { content: [{ type: "text", text: summary }] };
-            }
-            case "search-elements": {
-                const params = new URLSearchParams();
-                for (const [key, value] of Object.entries(args)) {
-                    if (value !== null && value !== undefined) {
-                        params.append(key, String(value));
-                    }
-                }
-                const response = await fetchAPI(`/elements?${params.toString()}`);
-                if (!response.ok) {
-                    throw new Error(`HTTP error: ${response.status}`);
-                }
-                const data = await response.json();
-                const elements = data.data || [];
-                const pagination = data.pagination || {};
-                if (elements.length === 0) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "No elements found. Try: broader search, different role/source, or wider time range.",
-                            },
-                        ],
-                    };
-                }
-                const formatted = elements.map((e) => {
-                    const boundsStr = e.bounds
-                        ? ` [${e.bounds.left.toFixed(2)},${e.bounds.top.toFixed(2)} ${e.bounds.width.toFixed(2)}x${e.bounds.height.toFixed(2)}]`
-                        : "";
-                    return `[${e.source}] ${e.role} (frame:${e.frame_id}, depth:${e.depth})${boundsStr}\n  ${e.text || "(no text)"}`;
+            case "send-notification": {
+                const notifBody = {
+                    title: args.title,
+                    pipe_name: args.pipe_name,
+                };
+                if (args.body)
+                    notifBody.body = args.body;
+                if (args.timeout_secs)
+                    notifBody.timeout_secs = args.timeout_secs;
+                if (args.actions)
+                    notifBody.actions = args.actions;
+                const notifResponse = await fetchAPI("/notify", {
+                    method: "POST",
+                    body: JSON.stringify(notifBody),
                 });
-                const header = `Elements: ${elements.length}/${pagination.total || "?"}` +
-                    (pagination.total > elements.length
-                        ? ` (use offset=${(pagination.offset || 0) + elements.length} for more)`
-                        : "");
+                if (!notifResponse.ok)
+                    throw new Error(`HTTP error: ${notifResponse.status}`);
+                const notifResult = await notifResponse.json();
                 return {
-                    content: [{ type: "text", text: header + "\n\n" + formatted.join("\n---\n") }],
+                    content: [{ type: "text", text: `Notification sent (id: ${notifResult.id})` }],
                 };
             }
-            case "frame-context": {
-                const frameId = args.frame_id;
-                if (!frameId) {
-                    return {
-                        content: [{ type: "text", text: "Error: frame_id is required" }],
-                    };
-                }
-                const response = await fetchAPI(`/frames/${frameId}/context`);
-                if (!response.ok) {
-                    throw new Error(`HTTP error: ${response.status}`);
-                }
-                const data = await response.json();
-                const lines = [
-                    `Frame ${data.frame_id} (source: ${data.text_source})`,
-                ];
-                if (data.urls?.length) {
-                    lines.push("", "URLs:", ...data.urls.map((u) => `  ${u}`));
-                }
-                if (data.nodes?.length) {
-                    lines.push("", `Nodes: ${data.nodes.length}`);
-                    for (const node of data.nodes.slice(0, 50)) {
-                        const indent = "  ".repeat(Math.min(node.depth, 5));
-                        lines.push(`${indent}[${node.role}] ${node.text}`);
-                    }
-                    if (data.nodes.length > 50) {
-                        lines.push(`  ... and ${data.nodes.length - 50} more nodes`);
-                    }
-                }
-                if (data.text) {
-                    // Truncate to avoid massive outputs
-                    const truncated = data.text.length > 2000 ? data.text.substring(0, 2000) + "..." : data.text;
-                    lines.push("", "Full text:", truncated);
-                }
-                return { content: [{ type: "text", text: lines.join("\n") }] };
-            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
@@ -1660,12 +727,7 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : "Unknown error";
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error executing ${name}: ${errorMessage}`,
-                },
-            ],
+            content: [{ type: "text", text: `Error executing ${name}: ${errorMessage}` }],
         };
     }
 });