synabun 1.3.0

package/mcp-server/src/tools/browser.ts

@@ -0,0 +1,107 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+import {
+  browserNavigateSchema, browserNavigateDescription, handleBrowserNavigate,
+  browserGoBackSchema, browserGoBackDescription, handleBrowserGoBack,
+  browserGoForwardSchema, browserGoForwardDescription, handleBrowserGoForward,
+  browserReloadSchema, browserReloadDescription, handleBrowserReload,
+} from './browser-navigate.js';
+
+import {
+  browserClickSchema, browserClickDescription, handleBrowserClick,
+  browserFillSchema, browserFillDescription, handleBrowserFill,
+  browserTypeSchema, browserTypeDescription, handleBrowserType,
+  browserHoverSchema, browserHoverDescription, handleBrowserHover,
+  browserSelectSchema, browserSelectDescription, handleBrowserSelect,
+  browserPressSchema, browserPressDescription, handleBrowserPress,
+  browserScrollSchema, browserScrollDescription, handleBrowserScroll,
+  browserUploadSchema, browserUploadDescription, handleBrowserUpload,
+} from './browser-interact.js';
+
+import {
+  browserSnapshotSchema, browserSnapshotDescription, handleBrowserSnapshot,
+  browserContentSchema, browserContentDescription, handleBrowserContent,
+  browserScreenshotSchema, browserScreenshotDescription, handleBrowserScreenshot,
+  browserExtractTweetsSchema, browserExtractTweetsDescription, handleBrowserExtractTweets,
+  browserExtractFbPostsSchema, browserExtractFbPostsDescription, handleBrowserExtractFbPosts,
+  browserExtractTiktokVideosSchema, browserExtractTiktokVideosDescription, handleBrowserExtractTiktokVideos,
+  browserExtractTiktokSearchSchema, browserExtractTiktokSearchDescription, handleBrowserExtractTiktokSearch,
+  browserExtractTiktokStudioSchema, browserExtractTiktokStudioDescription, handleBrowserExtractTiktokStudio,
+  browserExtractTiktokProfileSchema, browserExtractTiktokProfileDescription, handleBrowserExtractTiktokProfile,
+  browserExtractWaChatsSchema, browserExtractWaChatsDescription, handleBrowserExtractWaChats,
+  browserExtractWaMessagesSchema, browserExtractWaMessagesDescription, handleBrowserExtractWaMessages,
+  browserExtractIgFeedSchema, browserExtractIgFeedDescription, handleBrowserExtractIgFeed,
+  browserExtractIgProfileSchema, browserExtractIgProfileDescription, handleBrowserExtractIgProfile,
+  browserExtractIgPostSchema, browserExtractIgPostDescription, handleBrowserExtractIgPost,
+  browserExtractIgReelsSchema, browserExtractIgReelsDescription, handleBrowserExtractIgReels,
+  browserExtractIgSearchSchema, browserExtractIgSearchDescription, handleBrowserExtractIgSearch,
+  browserExtractLiFeedSchema, browserExtractLiFeedDescription, handleBrowserExtractLiFeed,
+  browserExtractLiProfileSchema, browserExtractLiProfileDescription, handleBrowserExtractLiProfile,
+  browserExtractLiPostSchema, browserExtractLiPostDescription, handleBrowserExtractLiPost,
+  browserExtractLiNotificationsSchema, browserExtractLiNotificationsDescription, handleBrowserExtractLiNotifications,
+  browserExtractLiMessagesSchema, browserExtractLiMessagesDescription, handleBrowserExtractLiMessages,
+  browserExtractLiSearchPeopleSchema, browserExtractLiSearchPeopleDescription, handleBrowserExtractLiSearchPeople,
+  browserExtractLiNetworkSchema, browserExtractLiNetworkDescription, handleBrowserExtractLiNetwork,
+  browserExtractLiJobsSchema, browserExtractLiJobsDescription, handleBrowserExtractLiJobs,
+} from './browser-observe.js';
+
+import {
+  browserEvaluateSchema, browserEvaluateDescription, handleBrowserEvaluate,
+  browserWaitSchema, browserWaitDescription, handleBrowserWait,
+  browserSessionSchema, browserSessionDescription, handleBrowserSession,
+} from './browser-advanced.js';
+
+/**
+ * Register all 39 browser MCP tools on the given server instance.
+ * Browser tools are static (no dynamic schema refresh needed).
+ */
+export function registerBrowserTools(server: McpServer) {
+  // Navigation
+  server.tool('browser_navigate', browserNavigateDescription, browserNavigateSchema, handleBrowserNavigate);
+  server.tool('browser_go_back', browserGoBackDescription, browserGoBackSchema, handleBrowserGoBack);
+  server.tool('browser_go_forward', browserGoForwardDescription, browserGoForwardSchema, handleBrowserGoForward);
+  server.tool('browser_reload', browserReloadDescription, browserReloadSchema, handleBrowserReload);
+
+  // Interaction
+  server.tool('browser_click', browserClickDescription, browserClickSchema, handleBrowserClick);
+  server.tool('browser_fill', browserFillDescription, browserFillSchema, handleBrowserFill);
+  server.tool('browser_type', browserTypeDescription, browserTypeSchema, handleBrowserType);
+  server.tool('browser_hover', browserHoverDescription, browserHoverSchema, handleBrowserHover);
+  server.tool('browser_select', browserSelectDescription, browserSelectSchema, handleBrowserSelect);
+  server.tool('browser_press', browserPressDescription, browserPressSchema, handleBrowserPress);
+  server.tool('browser_scroll', browserScrollDescription, browserScrollSchema, handleBrowserScroll);
+  server.tool('browser_upload', browserUploadDescription, browserUploadSchema, handleBrowserUpload);
+
+  // Observation
+  server.tool('browser_snapshot', browserSnapshotDescription, browserSnapshotSchema, handleBrowserSnapshot);
+  server.tool('browser_content', browserContentDescription, browserContentSchema, handleBrowserContent);
+  server.tool('browser_screenshot', browserScreenshotDescription, browserScreenshotSchema, handleBrowserScreenshot);
+  server.tool('browser_extract_tweets', browserExtractTweetsDescription, browserExtractTweetsSchema, handleBrowserExtractTweets);
+  server.tool('browser_extract_fb_posts', browserExtractFbPostsDescription, browserExtractFbPostsSchema, handleBrowserExtractFbPosts);
+  server.tool('browser_extract_tiktok_videos', browserExtractTiktokVideosDescription, browserExtractTiktokVideosSchema, handleBrowserExtractTiktokVideos);
+  server.tool('browser_extract_tiktok_search', browserExtractTiktokSearchDescription, browserExtractTiktokSearchSchema, handleBrowserExtractTiktokSearch);
+  server.tool('browser_extract_tiktok_studio', browserExtractTiktokStudioDescription, browserExtractTiktokStudioSchema, handleBrowserExtractTiktokStudio);
+  server.tool('browser_extract_tiktok_profile', browserExtractTiktokProfileDescription, browserExtractTiktokProfileSchema, handleBrowserExtractTiktokProfile);
+  server.tool('browser_extract_wa_chats', browserExtractWaChatsDescription, browserExtractWaChatsSchema, handleBrowserExtractWaChats);
+  server.tool('browser_extract_wa_messages', browserExtractWaMessagesDescription, browserExtractWaMessagesSchema, handleBrowserExtractWaMessages);
+  server.tool('browser_extract_ig_feed', browserExtractIgFeedDescription, browserExtractIgFeedSchema, handleBrowserExtractIgFeed);
+  server.tool('browser_extract_ig_profile', browserExtractIgProfileDescription, browserExtractIgProfileSchema, handleBrowserExtractIgProfile);
+  server.tool('browser_extract_ig_post', browserExtractIgPostDescription, browserExtractIgPostSchema, handleBrowserExtractIgPost);
+  server.tool('browser_extract_ig_reels', browserExtractIgReelsDescription, browserExtractIgReelsSchema, handleBrowserExtractIgReels);
+  server.tool('browser_extract_ig_search', browserExtractIgSearchDescription, browserExtractIgSearchSchema, handleBrowserExtractIgSearch);
+
+  // LinkedIn
+  server.tool('browser_extract_li_feed', browserExtractLiFeedDescription, browserExtractLiFeedSchema, handleBrowserExtractLiFeed);
+  server.tool('browser_extract_li_profile', browserExtractLiProfileDescription, browserExtractLiProfileSchema, handleBrowserExtractLiProfile);
+  server.tool('browser_extract_li_post', browserExtractLiPostDescription, browserExtractLiPostSchema, handleBrowserExtractLiPost);
+  server.tool('browser_extract_li_notifications', browserExtractLiNotificationsDescription, browserExtractLiNotificationsSchema, handleBrowserExtractLiNotifications);
+  server.tool('browser_extract_li_messages', browserExtractLiMessagesDescription, browserExtractLiMessagesSchema, handleBrowserExtractLiMessages);
+  server.tool('browser_extract_li_search_people', browserExtractLiSearchPeopleDescription, browserExtractLiSearchPeopleSchema, handleBrowserExtractLiSearchPeople);
+  server.tool('browser_extract_li_network', browserExtractLiNetworkDescription, browserExtractLiNetworkSchema, handleBrowserExtractLiNetwork);
+  server.tool('browser_extract_li_jobs', browserExtractLiJobsDescription, browserExtractLiJobsSchema, handleBrowserExtractLiJobs);
+
+  // Advanced
+  server.tool('browser_evaluate', browserEvaluateDescription, browserEvaluateSchema, handleBrowserEvaluate);
+  server.tool('browser_wait', browserWaitDescription, browserWaitSchema, handleBrowserWait);
+  server.tool('browser_session', browserSessionDescription, browserSessionSchema, handleBrowserSession);
+}

package/mcp-server/src/tools/card-tools.ts

@@ -0,0 +1,193 @@
+import { z } from 'zod';
+import * as ni from '../services/neural-interface.js';
+import { text, image } from './response.js';
+
+// ═══════════════════════════════════════════
+// card_list
+// ═══════════════════════════════════════════
+
+export const cardListSchema = {};
+
+export const cardListDescription =
+  'List all currently open memory cards in the Neural Interface. Returns each card\'s memory UUID, position, size, compact/pin state, content preview, and the current viewport dimensions (width x height). Use this before placing cards to know the available screen size.';
+
+interface CardInfo {
+  memoryId: string;
+  panelId: string;
+  left: string;
+  top: string;
+  width: string;
+  height: string;
+  isCompact: boolean;
+  isPinned: boolean;
+  category?: string;
+  contentPreview?: string;
+}
+
+function describeCard(card: CardInfo, index: number): string {
+  const pos = `at (${card.left || '?'}, ${card.top || '?'})`;
+  const size = card.width ? `${card.width} x ${card.height || 'auto'}` : 'default';
+  const flags = [
+    card.isCompact && 'COMPACT',
+    card.isPinned && 'PINNED',
+  ].filter(Boolean).join(', ');
+  const flagStr = flags ? ` [${flags}]` : '';
+  const cat = card.category ? ` (${card.category})` : '';
+  const preview = card.contentPreview
+    ? `\n   "${card.contentPreview.length > 80 ? card.contentPreview.slice(0, 80) + '...' : card.contentPreview}"`
+    : '';
+
+  return `${index + 1}. [${card.memoryId}] ${pos} ${size}${flagStr}${cat}${preview}`;
+}
+
+export async function handleCardList() {
+  const result = await ni.getCards();
+  if (result.error) {
+    return text(`Failed to read cards: ${result.error}`);
+  }
+
+  const cards = (result.cards || []) as CardInfo[];
+  const viewport = result.viewport as { width: number; height: number } | null;
+
+  if (cards.length === 0) {
+    let emptyText = 'No memory cards are currently open.';
+    if (viewport) emptyText += `\nViewport: ${viewport.width}x${viewport.height}`;
+    return text(emptyText);
+  }
+
+  let msg = `Open cards: ${cards.length}`;
+  if (viewport) msg += ` | Viewport: ${viewport.width}x${viewport.height}`;
+  msg += '\n\n';
+  msg += cards.map((c, i) => describeCard(c, i)).join('\n');
+
+  return text(msg);
+}
+
+
+// ═══════════════════════════════════════════
+// card_open
+// ═══════════════════════════════════════════
+
+export const cardOpenSchema = {
+  memoryId: z.string().describe('UUID of the memory to open as a floating card'),
+  coordMode: z.enum(['px', 'pct']).optional().describe('Coordinate mode. "px" (default) = absolute pixels. "pct" = percentage of viewport (0-100). left:50 top:50 = center of screen.'),
+  left: z.number().optional().describe('X position from left edge. Omit for auto-cascade.'),
+  top: z.number().optional().describe('Y position from top edge. Omit for auto-cascade.'),
+  compact: z.boolean().optional().describe('Open in compact mode (220x120px mini-card). Default: false.'),
+};
+
+export const cardOpenDescription =
+  'Open a memory as a floating card in the Neural Interface. Use card_list first to see viewport size.\n\nCoordinate modes (coordMode): "px" (default) = absolute pixels. "pct" = percentage of viewport (0-100), e.g. left:50 top:50 = center of screen.\n\nIf the card is already open, it is brought to the front. Omit left/top for auto-cascade positioning.';
+
+export async function handleCardOpen(args: { memoryId: string; coordMode?: string; left?: number; top?: number; compact?: boolean }) {
+  const result = await ni.openCard(args.memoryId, {
+    left: args.left,
+    top: args.top,
+    compact: args.compact,
+    coordMode: args.coordMode,
+  });
+  if (result.error) {
+    return text(`Failed to open card: ${result.error}`);
+  }
+
+  const r = result.result as Record<string, unknown> | undefined;
+  const alreadyOpen = r?.alreadyOpen ? ' (was already open, brought to front)' : '';
+  const pos = r ? `at (${r.left}, ${r.top})` : '';
+  return text(`Card opened${alreadyOpen}: ${args.memoryId} ${pos}`);
+}
+
+
+// ═══════════════════════════════════════════
+// card_close
+// ═══════════════════════════════════════════
+
+export const cardCloseSchema = {
+  memoryId: z.string().optional().describe('UUID of the card to close. Omit to close ALL open cards.'),
+};
+
+export const cardCloseDescription =
+  'Close a memory card by its UUID, or close all open cards if no memoryId is provided. Use card_list first to see which cards are open.';
+
+export async function handleCardClose(args: { memoryId?: string }) {
+  const result = await ni.closeCard(args.memoryId);
+  if (result.error) {
+    return text(`Failed to close card: ${result.error}`);
+  }
+
+  if (!args.memoryId) {
+    return text('All cards closed.');
+  }
+  return text(`Card closed: ${args.memoryId}`);
+}
+
+
+// ═══════════════════════════════════════════
+// card_update
+// ═══════════════════════════════════════════
+
+export const cardUpdateSchema = {
+  memoryId: z.string().describe('UUID of the card to update (must be currently open)'),
+  coordMode: z.enum(['px', 'pct']).optional().describe('Coordinate mode for position/size values. "pct" = percentage of viewport.'),
+  left: z.number().optional().describe('New X position'),
+  top: z.number().optional().describe('New Y position'),
+  width: z.number().optional().describe('New width (ignored in compact mode)'),
+  height: z.number().optional().describe('New height (ignored in compact mode)'),
+  compact: z.boolean().optional().describe('true = switch to compact mode (220x120px), false = expand to full size'),
+  pinned: z.boolean().optional().describe('true = pin card (locked position, dimmed, z-index 180), false = unpin'),
+};
+
+export const cardUpdateDescription =
+  'Update an open memory card\'s position, size, compact/expand state, or pin state. Set coordMode to "pct" to use percentage-based positioning. Only specified fields are changed; others remain untouched. Changes appear in real-time.';
+
+export async function handleCardUpdate(args: {
+  memoryId: string;
+  coordMode?: string;
+  left?: number;
+  top?: number;
+  width?: number;
+  height?: number;
+  compact?: boolean;
+  pinned?: boolean;
+}) {
+  const { memoryId, coordMode, ...updates } = args;
+
+  // Check at least one update field provided
+  const hasUpdate = Object.values(updates).some(v => v !== undefined);
+  if (!hasUpdate) {
+    return text('No update fields provided. Specify at least one of: left, top, width, height, compact, pinned.');
+  }
+
+  const result = await ni.updateCard(memoryId, updates, coordMode);
+  if (result.error) {
+    return text(`Failed to update card: ${result.error}`);
+  }
+
+  const r = result.result as Record<string, unknown> | undefined;
+  const parts: string[] = [];
+  if (r) {
+    if (r.left !== undefined) parts.push(`pos: (${r.left}, ${r.top})`);
+    if (r.isCompact !== undefined) parts.push(r.isCompact ? 'compact' : 'expanded');
+    if (r.isPinned !== undefined) parts.push(r.isPinned ? 'pinned' : 'unpinned');
+    if (r.width) parts.push(`size: ${r.width} x ${r.height || 'auto'}`);
+  }
+  return text(`Card updated: ${memoryId}${parts.length ? ' — ' + parts.join(', ') : ''}`);
+}
+
+
+// ═══════════════════════════════════════════
+// card_screenshot
+// ═══════════════════════════════════════════
+
+export const cardScreenshotSchema = {};
+
+export const cardScreenshotDescription =
+  'Take a visual screenshot of the Neural Interface showing all open memory cards in their current positions. Returns a JPEG image. Requires the Neural Interface to be open in a browser.';
+
+export async function handleCardScreenshot() {
+  const result = await ni.cardsScreenshot();
+  if (result.error) {
+    return text(`Screenshot failed: ${result.error}`);
+  }
+
+  return image(result.data as string, 'image/jpeg');
+}

package/mcp-server/src/tools/card.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+import {
+  cardListSchema, cardListDescription, handleCardList,
+  cardOpenSchema, cardOpenDescription, handleCardOpen,
+  cardCloseSchema, cardCloseDescription, handleCardClose,
+  cardUpdateSchema, cardUpdateDescription, handleCardUpdate,
+  cardScreenshotSchema, cardScreenshotDescription, handleCardScreenshot,
+} from './card-tools.js';
+
+/**
+ * Register all 5 card MCP tools on the given server instance.
+ * These tools let Claude list, open, close, move/resize/compact/pin,
+ * and screenshot memory cards in the Neural Interface.
+ */
+export function registerCardTools(server: McpServer) {
+  server.tool('card_list', cardListDescription, cardListSchema, handleCardList);
+  server.tool('card_open', cardOpenDescription, cardOpenSchema, handleCardOpen);
+  server.tool('card_close', cardCloseDescription, cardCloseSchema, handleCardClose);
+  server.tool('card_update', cardUpdateDescription, cardUpdateSchema, handleCardUpdate);
+  server.tool('card_screenshot', cardScreenshotDescription, cardScreenshotSchema, handleCardScreenshot);
+}